桌面启动器 sryimnoob123/dsh-starter

dsh-starter

DeepSeek Harness 的桌面客户端。一个 Electron 壳，把官方 Web 界面装进原生窗口，不重写 DSH 本身。

中文 · English

目录：这是什么 · 为什么选它 · 快速开始 · 功能一览 · 数据目录 · 更新日志 · 开发 · 打包 · 隐私 · 许可证

这是什么

把官方 deepseek-ai/DeepSeek-Harness（@deepseek-ai/dsh，一切皆插件的 agent harness）封装成 Windows 桌面客户端。壳自己拉起本机的 dsh 服务，把官方 Web GUI 渲染进无边框窗口，只负责窗口、托盘、通知、服务生命周期四件事，界面和智能体能力都在 DSH 侧。

为什么选它

| 维度 | 官方 DeepSeek Harness | dsh-starter |
| 安装与启动 | 需自行准备 Node.js，通过命令行启动 | 内置 DSH + Node 运行时，离线安装包双击即用 |
| 插件 | 手动安装、手动排障 | 106 个预装插件随包，首启自动就位；崩溃自动诊断、自动停用（移走可恢复） |
| 桌面体验 | 主要在终端或浏览器中使用 | 原生窗口、系统托盘、任务通知、崩溃自动恢复（指数退避） |
| 配置 | 手动改配置文件 | 皮肤/主题/权限/模型引用随包，首启自动补；API key 自行配置 |
| 维护 | 出问题靠手动排查 | 自愈机制：补丁双挂、坏 YAML、安装回退被挡、渲染崩溃全自动处理，诊断报告一键复制 |

不修改官方 dsh 内核，完整保留插件架构与官方能力；API Key 由你在 DSH 设置里自行配置，壳不落明文。

快速开始

1. 双击安装包（向导式，可选安装目录），秒级装完。
2. 首启自动播种 106 插件 + 配置，DSH 冷启动约 40 秒，走一遍简短向导（模型 + API key）。
3. 之后双击图标即进入窗口。

| 文件 | 说明 | 大小 |
| deepseek-harness-starter-Setup-0.5.0.exe | 安装版（内置 DSH + 106 插件，离线） | ~205 MB |

功能一览

- 无边框窗口 + 自绘标题栏（最小化/最大化/关闭缩托盘），Codex 风格浅色/深色/跟随系统
- 离线安装包：DSH 运行时 + 106 插件全内置，装的时候不跑 npm、不联网
- 插件自救：崩溃自动诊断 → 自动停用问题插件（移走不是删除，一键恢复）→ 重启
- 自动修复：补丁双挂、坏 YAML（自动回退备份）、安装回退目录被真实目录挡住
- 渲染崩溃自愈：黑屏自动重载（2 分钟内 ≤3 次），杀软打断走友好提示
- 热挂载失败检测：服务活着但单插件挂不上 → 自动停用 + 重启服务 + 系统通知
- 诊断报告：每次事件生成三段式报告（问题/状态/处置，已脱敏），复制剪贴板 + 落盘
- 自动更新（点击才下载、确认才安装，GitHub Releases）
- 系统托盘（打开/停止服务/日志/设置/检查更新/帮助/退出）+ 一键「压缩上下文」
- 任务完成/失败通知 + 通知历史 + 卡住看门狗（5 分钟无活动提醒）
- 文件路径菜单 + 拖文件进对话成 @路径 引用
- 首启向导（模型 + API 连接）
- Node.js 自动补齐（无系统 Node 时自动下载）
- Windows 持久终端修复（内置 win-terminal-inspector，首启自动装）
- 仅监听本机（127.0.0.1）

数据目录

| 位置 | 内容 |
| <安装目录>/dsh-home/ | DSH 数据：会话、API Key（凭据存储）、插件配置、皮肤 |
| <安装目录>/dsh/ | DSH 运行时（node_modules） |
| %APPDATA%/deepseek-harness-starter/ | 壳配置、日志、诊断报告、插件隔离备份 |

三样同目录（exe + dsh + dsh-home），卸载即清。

数据保护：从 v0.4.8 起，更新时自动备份 dsh-home（会话/技能/配置/凭据）到临时目录，更新后自动恢复——即使旧版本卸载器删掉安装目录，数据也安全。手动备份/恢复方法见 数据备份与恢复指南（小白版）。

更新日志

v0.5.1（2026-08-27）

自救机制修复

- 修复插件被自动停用后反复崩溃重启的问题：停用插件时同步移除依赖引用，不再出现"移走了还按引用找包"的死循环。
- 修复插件市场安装聚合包（如 dsh-web-ui-all）后与内置插件冲突崩溃的问题：检测到重复挂载时自动调整加载顺序，不再误停用插件。
- 服务连续崩溃后停止自动重试并给出引导，不再无限重启空转。

其他

- 增强崩溃诊断：覆盖重复路由、服务依赖缺失、浏览器端插件重复加载等更多崩溃形态，自动处理更准确。

v0.5.0（2026-08-27）

v0.5.0 主要解决插件市场开箱即用问题，并更新内置插件、精简托盘菜单。

插件市场修复

- 修复两个插件市场（dshmarket、webui-market）装不了插件的问题，现在开箱即用。
- 启动时自动按电脑实际盘符修正 store 路径并清理打包机残留记录，修正前自动备份，手动配置过的 store 路径不会被覆盖。

界面修复

- 修复右上角按钮（最小化/最大化/关闭）点了没反应的问题。

内置插件更新

- 增强侧栏（dsh-better-sidebar）0.15.2 → 0.16.1
- 上下文管理（dsh-context）0.25.3 → 0.33.1
- 模型透镜（@liustack/modlens）3.24.0 → 3.25.0
- 插件市场（dshmarket）1.18.0 → 1.31.1

托盘菜单精简

- 移除「查看日志」「修复」「用量统计」「通知」四项，保留打开窗口、重启服务、压缩上下文、备份数据、设置、检查更新、安装更新、帮助、退出。日志和修复仍可通过快捷键（Ctrl+Shift+F / Ctrl+Shift+L）使用。

其他优化

- 修复侧栏自定义项丢失，升级后自动补回。
- 安装提速：种子播种改为同盘瞬时移动，首启更快。
- 安装包瘦身：只保留中英文语言包，安装包约 205 MB。
- 安装包不再携带打包机的绝对路径信息，隐私更干净。

v0.4.8（2026-08-25）

紧急修复（数据保留，跨版本更新兜底）

- 修复从旧版本（0.4.3 及更早）直接更新时数据仍可能丢失的问题。旧版本卸载器会连整个安装目录一起删，而新版本的保留逻辑在旧卸载器执行时还来不及运行。
- 本版本在安装器初始化阶段（卸载旧版本之前）主动备份用户数据（会话记录、API 配置、插件设置、技能文件 dsh-home/skills）到临时目录，更新完成后自动恢复——即使旧卸载器删掉安装目录，数据也安全。
- 额外增加壳侧更新前备份：点击「现在安装」时先把用户数据备份到临时目录，双保险。
- 启动时自动从备份恢复：应用启动检测到用户数据丢失时，自动从临时备份找回，无需手动操作。

其他修复

- 默认配置回滚到官方标准：全新安装不再带自定义模型路由（ollama），避免无凭据报错。
- 插件自救扩展：新增浏览器端插件加载失败（failed to load）的诊断规则，覆盖 dsh-session-log-export 等插件。

v0.4.3（2026-08-24）

插件自救

- 新增崩溃自愈引擎：启动/运行崩溃自动诊断 → 自动停用问题插件（移走不删除，可一键恢复）→ 递归重启。
- 新增自动修复通道：patch 双挂（重复挂载条目）、坏 YAML（自动回退写前备份 + 净化）、安装回退目录被真实目录挡住（移走挡路目录）。
- 新增渲染进程崩溃自愈：黑屏自动重载（2 分钟内 ≤3 次），安全软件/调试器打断特征走友好提示不刷屏。
- 新增热挂载失败检测：服务存活但单插件挂不上 → 自动停用 → 重启服务 → 系统通知。
- 新增诊断报告：每次事件生成三段式报告（问题/状态/处置，已脱敏），复制剪贴板 + 落盘环形保留。

UI 判定区域修复

- 修复界面判定区域（可点击/可拖拽热区）的误判问题，窗口交互更跟手。

更新机制改造

- 更新改为「点击才下载、确认才安装」，不再自动下载占用带宽。
- 新增更新进度窗（发现/下载中/已下载/错误全状态可见），右上角按钮四态（无/可下载/下载中/待安装）结构化同步。
- 修复下载完成通知重复弹出、手动检查无即时反馈、进度窗卡在检查中等问题。

内置插件加入

- 新增壳内置插件：插件市场（dshmarket）、启动守卫（dsh-boot-guard）、撤销保存点（dsh-undo-savepoint）、诊断工具（@moonquake2004/dsh-doctor），随壳打包、零 npm 依赖。
- 预装随包插件：用量统计（dsh-usage-stats）、增强侧栏（dsh-better-sidebar）、上下文管理（dsh-context）、插件查找（dsh-find-plugin）、模型透镜（@liustack/modlens）、市场插件（@sanqi-normal/dsh-webui-market-plugin）。

DSH 内核更新

- 内置 DeepSeek Harness 内核升级至 0.1.1-rc.2，随包离线分发。

全局提示词功能插件化

- 全局/项目级 AGENTS.md、persona/身份注入、运行时上下文开关整体迁入独立插件 @dsh-desktop/plugin-global-prompt，随壳内置，与独立发布版互不干扰。

开发

pnpm install
pnpm test # 跑测试（488 个）
pnpm typecheck
pnpm build # 编译 TypeScript + 拷贝资源
pnpm start # 开发运行
pnpm prepare:dsh # 预下载 DSH 到 vendor/dsh（安装包用）
pnpm dist # 打 Windows 安装包（内置 DSH + 种子，离线）

打包

- scripts/prepare-seed.mjs 构建种子（build/dsh-home-seed/）：106 插件 web profile + 非敏感设置，净化剔除隐私（凭据/会话/日志）。
- build/electron-builder.yml：NSIS 7z 压缩载荷 + extraFiles 带 DSH 与种子；asarUnpack 解包内置插件（asar 只读 FS 复制会 ENOENT）；oneClick: false 可选安装目录。
- 首启播种两阶段：spawn 前种 profile，service-ready 后补设置（防 DSH 覆盖）→ 清理种子残留。终态目录 = exe + dsh/ + dsh-home/ 三件套，与历史版本一致。
- 隐私门禁：打包后扫描安装包，出现凭据/会话/key 特征即拒发（发布红线）。

隐私

- 仅监听本机 127.0.0.1，不对外提供服务。
- API 密钥存在 DSH 自己的凭据存储（DSH_HOME）里，壳不落明文、不收集、不上传。
- 安装包发布前经隐私反证扫描，保证不含任何私人文件。

许可证

MIT。独立社区项目，与 DeepSeek 无隶属关系。应用图标为 DeepSeek 官方鲸鱼，仅用于标识上游项目，版权归 DeepSeek。

致谢

- dsh-win-terminal-inspector（MIT，© 2026 clearkurt），内置以修复 DSH 缺失的 Windows 终端检查器，原样使用、未做修改。源码、许可与溯源均保留在 vendor/win-terminal-inspector/。

目录：这是什么 · 为什么 · 快速开始 · 功能 · 数据布局 · 更新日志 · 开发 · 打包 · 隐私 · 许可

这是什么

一个轻量 Electron 外壳，套在 DeepSeek Harness 外面。它自己启动本地 dsh 服务，把官方 Web GUI 渲染进无边框窗口。外壳只管四件事：窗口、托盘、通知、服务生命周期。其余全在 DSH 那边。

为什么

| | 官方 DSH | dsh-starter |
| 安装 | 手动装 Node + 命令行 | 离线安装包，DSH 已内置，几秒装完，带进度条 |
| 插件 | 手动安装与调试 | 随包附带 106 个插件，崩溃后自愈 |
| 桌面 | 终端 / 浏览器 | 原生窗口、托盘、通知、自动恢复 |
| 配置 | 手动 | 首次启动写入非敏感设置 |
| 升级 | 手动 | 配置损坏自愈，一键生成诊断报告 |

快速开始

1. 运行安装程序（向导式，自己选目录）——几秒装完。
2. 首次启动写入 106 个插件 + 设置，拉起 DSH（约 40 秒），然后弹出简短向导，填模型和 API key。
3. 搞定——双击图标就能进。

功能

- 离线安装包：内置 DSH 运行时 + 106 个插件，安装时不碰 npm
- 自愈：崩溃诊断 → 自动隔离出问题的插件（移走，一键还原）→ 重启
- 自动修复：重复的插件条目、损坏的 YAML（还原备份）、被拦截的 fallback 目录
- 渲染进程崩溃自动重载（2 分钟内最多 3 次），杀毒软件断点提示
- 热挂载失败检测 → 自动隔离 + 重启
- 每次故障生成诊断报告（已脱敏，可复制到剪贴板，也可落盘）
- 自动更新（点击下载，确认后安装）
- 托盘菜单、一键「压缩上下文」、通知、5 分钟卡死看门狗
- 文件路径菜单 + 拖拽生成 @path，首次运行向导，Node 自动准备
- Windows 持久终端修复（内置 win-terminal-inspector）
- 只监听本机（127.0.0.1）

数据布局

| 位置 | 内容 |
| <install>/dsh-home/ | DSH 数据：会话、凭据、插件配置、主题 |
| <install>/dsh/ | DSH 运行时 |
| %APPDATA%/deepseek-harness-starter/ | 外壳配置、日志、诊断报告、救援备份 |

更新日志

v0.4.3（2026-08-24）

自愈

- 崩溃诊断引擎：自动诊断启动 / 运行时崩溃 → 自动禁用出问题的插件（移走而非删除，一键还原）→ 递归重启。
- 自动修复通道：重复的插件条目、损坏的 YAML（还原备份 + 清洗）、被拦截的安装 fallback 目录（移到一边）。
- 渲染进程崩溃自愈：自动重载（2 分钟内最多 3 次）；安全软件 / 调试器断点会给出友好提示，而不是陷入重载循环。
- 热挂载失败检测：服务还活着，但插件挂载失败 → 自动禁用 → 重启服务 → 通知。
- 每次故障生成诊断报告（问题/状态/操作，已脱敏）—— 支持剪贴板 + 环形缓冲落盘。

UI 点击区域修复

- 修复可点击/可拖拽热区误判；窗口交互更跟手。

更新机制重做

- 更新改为「点击下载，确认安装」—— 不再偷偷占用带宽。
- 更新进度窗口（发现/下载中/已下载/出错）+ 右上角按钮四态同步。
- 修复下载完成通知重复、手动检查无反馈、进度窗口卡在「检查中」的问题。

新增内置插件

- 新增随 shell 打包的插件：插件市场（dshmarket）、启动守卫、撤销存档点、doctor —— 零 npm 依赖。
- 预装种子插件：用量统计、更好的侧边栏、上下文管理器、插件查找器、modlens、webui 市场插件。

DSH 核心更新

- 内置 DeepSeek Harness 核心更新到 0.1.1-rc.2（随安装包离线分发）。

全局提示词改为插件

- 全局/项目 AGENTS.md、人格/身份注入、运行时上下文开关，全部移入独立插件 @dsh-desktop/plugin-global-prompt，随 shell 打包。

Development

pnpm install
pnpm test # 488 tests
pnpm typecheck
pnpm build
pnpm start
pnpm prepare:dsh
pnpm dist # Windows installer (bundled DSH + seed)

Packaging

- scripts/prepare-seed.mjs 构建种子（build/dsh-home-seed/）：106 插件 web 配置档 + 非敏感设置，已做隐私清洗。
- build/electron-builder.yml：NSIS 7z 载荷 + extraFiles 放 DSH 运行时和种子；asarUnpack 放内置插件；oneClick: false 让你选安装目录。
- 首次运行分两阶段播种（先配置档 → 服务就绪后再写设置），设置因此能保留；最终目录结构 = exe + dsh/ + dsh-home/，与之前版本一致。
- 隐私闸门：发布前扫描安装包 —— 只要出现任何凭据/会话/密钥标记就阻断构建。

Privacy

- 只绑定 127.0.0.1；绝不对外提供服务。
- 你的 API key 存在 DSH 自己的凭据库里；shell 从不写入、收集或上传它。
- 发布安装包会自动做隐私扫描。

License

MIT。独立社区项目，与 DeepSeek 无隶属关系。鲸鱼图标是 DeepSeek 的素材，仅用于标识上游项目。

Acknowledgments

- dsh-win-terminal-inspector（MIT，© 2026 clearkurt）—— 原样打包，用来补上 DSH 缺失的 Windows 终端检查器。源码、许可证和来源都保留在 vendor/win-terminal-inspector/。