sryimnoob123/dsh-starter

dsh-starter

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

中文 · English

License: MIT

中文

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

这是什么

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

为什么选它

| 维度 | 官方 DeepSeek Harness | dsh-starter |
| --- | --- | --- |
| 安装与启动 | 需自行准备 Node.js，通过 CLI 启动 | 内置 DSH + Node 运行时，离线安装包双击即用 |
| 插件 | 手动安装、手动排障 | 106 个预装插件随包，首启自动就位；崩溃自动诊断、自动停用（移走可恢复） |
| 桌面体验 | 主要在终端或浏览器中使用 | 原生窗口、系统托盘、任务通知、崩溃自动恢复（指数退避） |
| 配置 | 手动改配置文件 | 皮肤/主题/权限/模型引用随包，首启自动补；API key 自行配置 |
| 维护 | 出问题靠手动排查 | 自愈机制：patch 双挂、坏 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、不联网
- 插件自救：崩溃自动诊断 → 自动停用问题插件（移走不是删除，一键恢复）→ 重启
- 自动修复：patch 双挂、坏 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/。

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

这是什么

一个为 DeepSeek Harness 打造的轻量 Electron 外壳。它会启动自己的本地 dsh 服务，并在无边框窗口中渲染官方 Web GUI。该外壳只负责四件事：窗口、托盘、通知、服务生命周期。其余一切都在 DSH 侧。

为什么

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

快速开始

1. 运行安装程序（向导式，选择你的目录）——数秒内完成。
2. 首次启动会预置 106 个插件 + 设置，启动 DSH（约 40 秒），然后是一个简短的向导，用于配置你的模型和 API 密钥。
3. 完成——双击图标即可进入。

功能特性

- 离线安装程序：内置 DSH 运行时 + 106 个插件，安装时无需 npm
- 自愈：崩溃诊断 → 自动隔离问题插件（移动而非删除，一键恢复）→ 重启
- 自动修复：重复的插件条目、损坏的 YAML（备份恢复）、被阻止的回退目录
- 渲染进程崩溃自动重载（每 2 分钟最多 3 次）、杀毒软件断点提示
- 热挂载失败检测 → 自动隔离 + 重启
- 每次事件生成诊断报告（已脱敏，剪贴板 + 磁盘）
- 自动更新（点击下载，确认后安装）
- 托盘菜单、一键“压缩上下文”、通知、5 分钟卡顿看门狗
- 文件路径菜单 + 拖拽到 @path、首次运行向导、Node 自动配置
- Windows 持久终端修复（内置 win-terminal-inspector）
- 仅限本地主机（127.0.0.1）

数据布局

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

更新日志

v0.4.3（2026-08-24）

自愈

- 崩溃诊断引擎：自动诊断启动/运行时崩溃 → 自动禁用问题插件（移动而非删除，一键恢复）→ 递归重启。
- 自动修复通道：重复的插件条目、损坏的 YAML（备份恢复 + 清理）、被阻止的安装回退目录（移至一旁）。
- 渲染进程崩溃自愈：自动重载（每 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 打包。

开发

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

打包

- scripts/prepare-seed.mjs 构建种子（build/dsh-home-seed/）：106 插件 Web 配置 + 非敏感设置，已做隐私清理。
- build/electron-builder.yml：NSIS 7z 载荷 + 用于 DSH 运行时和种子的 extraFiles；用于内置插件的 asarUnpack；oneClick: false 以便选择安装目录。
- 两阶段首次运行种子注入（配置 → 服务就绪后设置），使设置得以保留；最终布局 = exe + dsh/ + dsh-home/，与之前版本相同。
- 隐私门禁：安装包在发布前会进行扫描——任何凭据/会话/密钥标记都会阻止构建。

隐私

- 仅绑定到 127.0.0.1；绝不对外提供服务。
- 你的 API 密钥存放在 DSH 自己的凭据存储中；shell 绝不会写入、收集或上传它。
- 发布安装包会自动进行隐私扫描。

许可证

MIT。独立社区项目，与 DeepSeek 无关联。鲸鱼图标为 DeepSeek 资产，仅用于标识上游项目。

致谢

- dsh-win-terminal-inspector（MIT，© 2026 clearkurt）——未经修改随附打包，以修复 DSH 缺失的 Windows 终端检查器。源代码、许可证和来源保留在 vendor/win-terminal-inspector/ 中。