deepseek-harness-desktop

自动更新与配置管理

本应用通过 electron-updater 提供整包自动更新。一次更新会替换整个应用，包括内置的 @deepseek-ai/dsh 运行时。

如果想更快跟上上游，也可以使用内置的设置窗口（顶部菜单 DSH → 设置… 或快捷键 ⌘,）：

• 通用：设置界面主题（默认 / Claude Code）、命令说明汉化、自动更新开关、npm 镜像源预设（支持 npmmirror、官方、腾讯云等）以及自定义 DSH 服务启动端口。

• 版本：直接从 npm 安装并切换到新版官方 @deepseek-ai/dsh，支持开启“自动跟随最新 RC”。

• 插件：可视化查看、安装、卸载 web profile 的第三方插件。

• 打包后的应用会在启动 5 秒后检查更新，之后每 4 小时检查一次；DSH 应用菜单也提供**检查更新…**入口。

• 更新源在构建时写入 app-update.yml。CI 会自动指向本仓库的 GitHub Releases；本地构建则修改 package.json 中 build.publish.owner / build.publish.repo。

• 运行时覆盖：设置 DSH_UPDATE_URL 可切换到 generic 更新源（适合测试或非 GitHub 镜像）；设置 DSH_DISABLE_AUTO_UPDATE=1 可关闭更新。npm registry 默认使用国内镜像 registry.npmmirror.com（用于版本目录和运行时安装），可通过 DSH_NPM_REGISTRY 覆盖或直接在设置面板中修改保存。

发版流程

1. node scripts/check-upstream.mjs — 对比当前固定的 dsh 版本与 npm 最新版。
2. node scripts/bump-dsh.mjs 0.1.0-rc.x — 把所有 @deepseek-ai/dsh* 固定依赖 升到同一版本，重新安装并运行测试。
3. npm run dist:mac:all && npm run smoke:packaged — 验证打包后的应用能启动 并返回 HTTP 200（同时构建 Apple Silicon 与 Intel）。
4. npm run clean:dist — 删除本地构建产物，避免 Spotlight/Finder 索引到第二份应用。
5. 修改 package.json 的 version，推送 vX.Y.Z tag。Release 工作流会构建、 冒烟测试并把 DMG、ZIP、latest-mac.yml 发布到 GitHub Releases；已安装的 应用会提示用户重启完成更新。

check-upstream.yml 工作流每天检查一次：上游在 npm 发布新的 0.1.0-rc.* 版本时，会自动开一个升级 PR。

注意：macOS 自动更新要求应用已签名。当前使用 ad-hoc 签名，适合自用或小范围 分发；公开发布时应切换到 Apple Developer ID 签名并做公证。