Skip to content

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

Describe the desktop app package and its installer

Fei2411c04c5bd55cb2
diff --git a/app/README.md b/app/README.md
index 613a7481..f206ee35 100644
--- a/app/README.md
+++ b/app/README.md
@@ -48,6 +48,20 @@ node scripts/shot.mjs <tmp>/shot.png 20
Never point `DS_BOT_HOME` at `~/.dsh` or at the data of an app that you use.
+## Package
+
+[electron-builder](https://www.electron.build/) packages the app with the settings in `electron-builder.yml`. Build on the platform that you package for: the native modules (`node-pty`, `sharp`, `koffi`) are taken from `node_modules` as npm installed them, not rebuilt.
+
+```sh
+npm run pack # the app without an installer: dist-pack/win-unpacked/ (Windows), dist-pack/mac*/ (macOS)
+npm run dist # the installer: dist-pack/DeepSeek-Bot-<version>-win-x64.exe (Windows), a .dmg (macOS)
+npm run check-packed # starts the packaged app on throwaway folders with the mock model, chats once, closes it
+```
+
+`check-packed` takes another executable as its first argument, and a file for a screenshot of the window as its second.
+
+The Windows installer installs for the current user only, without administrator rights, by default into `%LOCALAPPDATA%\Programs\DeepSeek Bot` (`build/installer.nsh` skips the page that asks for all users or only for the current one). The uninstaller removes the program and keeps the data location and the app's own data. CI builds the Windows installer on every pull request, checks the packaged app, then installs it, checks the installed app and uninstalls it.
+
## Layout
| File | What it does |
@@ -61,6 +75,8 @@ Never point `DS_BOT_HOME` at `~/.dsh` or at the data of an app that you use.
| `src/web.mjs` | The window's files, the launch-token cookie exchange and the request forwarding |
| `ui/` | The window: React, built with Vite (`vite.config.js`) into `ui/dist`. It draws the plugin's own Bot views from `../ds-bot/src/client/` (sidebar, chat rows, docks, dialogs and their stylesheets) and puts its own Markdown in place of DSH's. It uses ds-bot's `api/bot` channel and its live feed `api/bot/feed` |
| `assets/` | The app icon: `icon.svg`, `icon.png` (1024 px) and `icon.ico` (Windows, 16 to 256 px). `npm run icon` (`scripts/icon.mjs`) draws them again from the Main Bot's whale in `../ds-bot` |
+| `electron-builder.yml`, `build/` | The package and the installer: app identity, files, icons, the Windows installer and the macOS disk image |
+| `scripts/check-packed.mjs` | `npm run check-packed`: the check of a packaged app |
The Host installs plugins with the app's own pnpm (`node_modules/pnpm`).
diff --git a/docs/plans/2026-10-16-desktop-app.md b/docs/plans/2026-10-16-desktop-app.md
index 9d2533d7..042e02c9 100644
--- a/docs/plans/2026-10-16-desktop-app.md
+++ b/docs/plans/2026-10-16-desktop-app.md
@@ -58,8 +58,11 @@
### 安装和更新
-- Windows(x64):安装向导,可以改程序位置,装完可以直接运行;自动更新,下载后校验 sha512。
+- 应用标识(appId)是 `io.github.fei2411.deepseekbot`,以后不改:Windows 靠它认出这个应用和它的更新,macOS 用它当应用标识。
+- Windows(x64):安装向导,可以改程序位置,装完可以直接运行。只给当前用户安装:不问「为所有用户还是只为我」,不要管理员权限,默认装在 `%LOCALAPPDATA%\Programs\DeepSeek Bot`。卸载不删数据位置。
+- Windows 自动更新:后台下载,校验 sha512,下载完在窗口里提示重启以更新;不重启的话,下次退出时装上。
- macOS(Apple 芯片和 Intel):dmg;不能自动更新,有新版时提示下载。
+- 安装包带着锁定的 DSH 装上的全部文件,不按 profile 删减。
- 不签名。
## 不做什么
@@ -78,10 +81,10 @@
## 已知限制
-- 窗口里还没有:群聊的历史消息、工具卡片和审批、首次启动和导入、DeepSeek 账号登录、每个 Bot 的浏览器、更新和安装包。侧栏每一行的最新一句只显示打开窗口以后的新消息。插件版里打开 DSH 自己界面的入口(连接插件、管理模型、Harness 设置,「+」里的添加文件和引用对话)窗口里也没有。模型和密钥目前用环境变量,或数据位置里的 `.env`、`.credentials.yaml` 设置。
+- 窗口里还没有:群聊的历史消息、工具卡片和审批、首次启动和导入、DeepSeek 账号登录、每个 Bot 的浏览器、更新。侧栏每一行的最新一句只显示打开窗口以后的新消息。插件版里打开 DSH 自己界面的入口(连接插件、管理模型、Harness 设置,「+」里的添加文件和引用对话)窗口里也没有。模型和密钥目前用环境变量,或数据位置里的 `.env`、`.credentials.yaml` 设置。
- 不签名:Windows 第一次运行会弹出 SmartScreen 警告,macOS 要在系统设置里手动放行。
- 会话里记着工作文件夹的完整路径,不能改。所以导入和搬工作文件夹都要换段。
-- 安装的 `@deepseek-ai/dsh` 包带着 DSH 的网页前端,所以安装包里仍有这些文件,只是不加载。
+- 安装的 `@deepseek-ai/dsh` 包带着 DSH 的网页前端、Office 套件和语音包,所以安装包里仍有这些文件,只是不加载。
## 变更