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.mdnew file mode 100644index 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.mdindex 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;不设总量和链长上限 |