Skip to content

A team of long-lived bots for DeepSeek Harness, with main bots, bot-to-bot messages and group chats.

Add the design note for the desktop app

Fei2411ff5e21348f18
diff --git a/docs/plans/2026-10-16-desktop-app.md b/docs/plans/2026-10-16-desktop-app.md
new file mode 100644
index 00000000..92570d9e
--- /dev/null
+++ b/docs/plans/2026-10-16-desktop-app.md
@@ -0,0 +1,73 @@
+# 桌面应用
+
+- 日期:2026-10-16
+- 相关:[愿景](../vision.zh.md)「两种形态」、[DSH 让步总账](2026-10-13-dsh-concessions.md)
+
+## 为什么
+
+插件版跑在用户自己的 DSH 里,界面结构、全局配置和 DSH 版本都由 DSH 决定,很多地方只能让步(见让步总账)。用户的 DSH 一更新,Bot 也可能被打坏。桌面应用让 DS Bot 自己掌握 profile、数据、界面和 DSH 版本,一打开就是 Bot 团队。
+
+取舍:
+
+- **引擎用 DSH,不另写 Agent 运行时。** Bot 的回合、工具、模型、会话、MCP、技能照旧走 DSH,和插件版一样。
+- **界面自己写,不建在 DSH 的网页前端上。** DSH 网页前端启动时要激活全部界面插件,一个插件出错整页停住;它的模块格式和页面结构由 DSH 决定,还在变。Bot 界面要能按页面加载,一个插件出错只影响它自己。代价是 DSH 插件里管界面的那部分不能原样装进来,要小改。
+
+## 已定的行为
+
+### 结构
+
+| 部分 | 做什么 |
+|---|---|
+| 壳 | Electron 主进程。只开一个实例;窗口用 `dsh-app://app` 加载页面,把请求转发给引擎;管引擎进程的启动和退出 |
+| 引擎 | 子进程,用 Electron 自带的 Node 运行。通过 `@deepseek-ai/dsh/profile-boot` 的 `runProfile()` 启动 profile `ds-bot`,只监听 `127.0.0.1` 上系统分配的端口。环境变量 `DS_BOT_APP=1` 告诉 ds-bot 它跑在桌面应用里 |
+| 界面 | DS Bot 自己写的网页(React + Vite),只通过 ds-bot 的 `/api/bot` 和 DSH 的 HTTP 接口读写数据 |
+
+- 插件版和桌面应用用同一份 `ds-bot`,插件版不变。
+- 安装包和 `ds-bot` 用同一个版本号。
+
+### DSH 版本
+
+- 安装包锁定一个 DSH 版本,只跟 DSH 的 rc 版本,不跟 alpha 版本。现在是 0.2.0-rc.2。
+- DSH 的修复和新功能,跟着 DeepSeek Bot 的新版本一起到用户手里。
+
+### 数据
+
+- 数据位置就是桌面应用的 `DSH_HOME`,默认 `~/.ds-bot`。profile、会话、团队数据、模型设置和密钥都在这里。
+- 壳自己的数据(窗口、浏览器存储)放在系统给应用的目录里。
+- 桌面应用不写用户 DSH 的 `~/.dsh`,导入时只读。
+
+### 首次启动和导入
+
+- 首次启动分别选数据位置和 Bot 工作文件夹,以后能在设置里改。
+- 发现用户 DSH 里已有团队时,问要不要导入。导入复制 Bot、群、记忆、会话、附件、模型设置和密钥,旧位置一个字节都不改。导入以后两个团队各走各的,不同步。
+- 导入后,每个 Bot 和群在下一个回合前换到新的一段(新工作文件夹),旧段只当历史读,照常能看、能搜。以后搬工作文件夹也一样。
+- 用户 DSH 写的会话格式比锁定版新时,停下来请用户先更新 DeepSeek Bot。
+
+### 插件
+
+- DSH 插件的引擎部分(工具、模型、MCP、技能、搜索等)原样安装、原样运行。安装用应用自带的 pnpm。
+- 界面插件的写法照 Cordis:插件提供和使用服务、声明依赖、每个注册都能撤销、界面靠插槽组合。
+- 和 DSH 重叠的位置,用 DSH 的插槽名和数据:先做工具卡片(`tool.call.toolview`)、全局弹层(`shell.overlay`)和设置(`settings.section`、`settings.general.item`)。DSH 的界面插件换打包方式、接上这些插槽就能迁过来。
+- 界面插件按页面加载。一个插件出错,只有它那一块显示错误,其他部分照常。
+
+### 安装和更新
+
+- Windows(x64):安装向导,可以改程序位置,装完可以直接运行;自动更新,下载后校验 sha512。
+- macOS(Apple 芯片和 Intel):dmg;不能自动更新,有新版时提示下载。
+- 不签名。
+
+## 不做什么
+
+- 不 fork DSH,不给 DSH 打补丁。
+- 不把 DSH 的网页前端当作 Bot 界面的底层,也不原样加载 DSH 的界面插件。
+- 不做 npm 安装的桌面应用,也不做在 DSH Desktop 里一键安装。
+- 桌面应用里没有 DSH 的 Agent 模式。
+- 第一版不带 Office 技能。
+
+## 已知限制
+
+- 目前窗口里显示的是 DSH 的网页界面和 ds-bot 插件的界面。自己的界面、首次启动和导入、DeepSeek 账号登录、每个 Bot 的浏览器、更新和安装包还没有。
+- 不签名:Windows 第一次运行会弹出 SmartScreen 警告,macOS 要在系统设置里手动放行。
+- 会话里记着工作文件夹的完整路径,不能改。所以导入和搬工作文件夹都要换段。
+
+## 变更
diff --git a/docs/plans/README.md b/docs/plans/README.md
index db9fe9d9..4e1e4494 100644
--- a/docs/plans/README.md
+++ b/docs/plans/README.md
@@ -43,4 +43,5 @@
| [上下文与记忆](2026-10-09-context-and-memory.md) | 对话分段、上下文管家(压缩还是换段)、交接包、`read_own_chat`;记忆的存放、格式、权限、整理和冻结 |
| [Bot 运行配置](2026-10-10-bot-runtime.md) | Agent 预设、每个 Bot 的模型和思考强度、工作文件夹、能力(MCP、技能、能力包) |
| [长消息](2026-10-16-long-messages.md) | state.json 只存开头;超过 2 万字的 Bot 消息转成 DSH 文件;成员和界面怎么读全文 |
+| [桌面应用](2026-10-16-desktop-app.md) | 壳、引擎和自己的界面怎么分;锁定的 DSH 版本、独立的数据位置、首次启动和导入、插件怎么兼容 DSH、安装和更新 |
| [Bot 之间派活](2026-10-16-bot-handoffs.md) | Bot 看得到对方的状态;没读的消息合成一条;派活树:下面的活交回后才往上交,不许发给在等结果的 Bot;不设总量和链长上限 |