dsh-desktop

DSH Desktop（DeepSeek Harness 桌面版）

一句话介绍：把 dsh web 装成一个正经的 Windows 桌面应用。双击图标就能用，不用开浏览器，不用装 Node，目标机器上什么都不用准备。

做这个项目时想得最多的一件事是：软件得总能装得上、打得开。所有设计都围绕这个来。

它能帮你做什么

• 独立窗口：Electron 窗口直接加载本地的 DSH Web 界面，和浏览器说再见。
• 自带全套环境：安装包里带了独立 Node v24、npm 和完整的 dsh 后端，装完就能跑。
• 数据完全隔离：桌面版用自己的数据目录（DSH_HOME），和你命令行里的 ~/.dsh 互不打扰、互不抢锁。
• 默认保活：点右上角 X 只是缩到系统托盘，真想退出走托盘菜单。开机自启也能在托盘里开关。
• 出问题自己先修：junction 坏了自动重建、profile 出问题自动隔离备份重试、Node 出问题自动修复，实在修不好才弹窗告诉你。
• 鲸鱼娘图标。

更新是怎么运作的（和早期版本不一样，务必看一眼）

一句话：只通知，不偷跑。你不点头，更新不会发生。

具体流程：

1. 程序会定期看一眼有没有新版本（启动后 5 秒第一次，之后每 6 小时一次），只看，不下。
2. 发现新版本，托盘冒个气泡通知你，菜单里显示"有新版本，点击此处确认"。
3. 你点托盘里的版本号那几行，弹窗列出更新内容和上游最近的改动，点"下载并更新"才真正开始下载。
4. 下载完问你要不要立刻重启；选"稍后"就下次启动时自动生效。
5. 版本判断会两头核对：GitHub（deepseek-ai/deepseek-harness 的 master）上有、npm 镜像上也发布了，两边都在的版本才提示。GitHub 比 npm 快的时候（很常见），只提示两边都有的那个，不会让你去下一个根本下不下来的版本。

桌面外壳自己的更新默认是关的。想开的话配环境变量 DSH_SHELL_UPDATE_URL（真实的 https 地址），同样是通知制，确认后才下载。

安装时可以选后端版本

第一次安装会多出一个选择页：

• 随安装包提供的版本（推荐）
• 在线最新版本（首次启动时联网下载）
• 指定的某个版本

覆盖安装和升级不会重复问。选择只在首次启动生效一次，之后一切走上面说的托盘确认流程。

大更新后的插件安全启动

后端真的换了新版本之后，第一次启动会这么走：

1. 先把所有第三方插件注释掉，确认 DSH 本体起得来；
2. 再一个一个放回来试，启动页上能看到进度（"正在逐个检查插件 3/8"）；
3. 有问题的插件保持禁用，启动后弹窗告诉你哪些不兼容；
4. 插件源码和原始配置都完整保留，修好了随时能重新启用。

平时普通启动不走这套流程，不会浪费你的时间。

出问题了怎么办

看桌面上的 DSH-Desktop-日志.txt。启动、更新、插件检查的每一步和所有错误都实时写在里面，程序崩溃前也会先把堆栈写进去。文件超过 10MB 会自动转成 DSH-Desktop-日志-旧.txt，不会无限膨胀。

遇到问题提反馈时，把这个文件一起发过来，基本一眼就能定位。

你的数据安全吗

安全，这几条是硬规矩：

• 会话、配置、凭据都在 %APPDATA%\DSH Desktop\dsh-home\ 里，卸载、升级、覆盖安装都不会动；
• 老版本的会话缓存升级时自动无损迁移（补齐新版本要求的新字段），改之前先备份到 migration-backup-时间戳 目录；
• 启动自愈最坏的情况也只是把 profiles 隔离备份成 profiles.broken-时间戳（保留最近 2 份），不删任何数据。

仓库里有什么

目录/文件	说明
main.js / preload.js / updater-backend.js / diag-log.js / splash.html	Electron 外壳本体（主进程、后端管理、桌面诊断日志）
build/installer.nsh	安装器定制：结束进程、版本选择页
scripts/	安装/打包/运行时准备脚本
assets/	图标等资源

运行期目录（自动创建）：

%APPDATA%\DSH Desktop\
├─ backend\        # 活跃的 Node、npm、dsh 后端 + 更新暂存区
└─ dsh-home\       # 你的数据：profiles、会话、设置、凭据

启动顺序（简单说）

每次启动按固定顺序走，每一步失败都有兜底：把出厂环境铺到用户目录（第一次）→ 应用上次下载好的更新（此时后端还没跑，没有文件占用）→ 检查 Node 版本够不够 → 修一遍插件链接 → 启动后端 → 开窗口。整个过程都写着桌面日志。

开发 / 打包

npm install        # 自动准备 vendor 后端与 Node 运行时
npm start          # 开发模式
npm run dist       # 生成 release\DSH Desktop Setup x.x.x.exe

常见问题

• 安装时提示"无法关闭"：不会的。安装器会先按路径精确结束 DSH 相关进程（绝不误杀你机器上其他的 node），再卸旧装新。
• is not a symlink 报错：启动时自动修复，一般见不到。数据目录和命令行是隔离的，正常不会再撞。
• 更新下了却没生效：重启一次。更新都是重启时应用的；如果还不行，看桌面日志，里面写得很清楚。
• 想固定 Node 主版本：环境变量 DSH_NODE_MAJOR（默认 24）。
• 换镜像：DSH_NPM_REGISTRY、DSH_NODE_DIST_BASE。