前言¶
DeepSeek Harness（DSH）通过 Cordis 插件扩展 Web 界面与 Host 能力。日常用 @deepseek-ai/dsh 时，版本往往分散在终端里的 npm、全局安装目录和仍在内存里跑的老进程之间；装完新版若不重启，页面表现和磁盘上的包很容易对不上。社区插件 dsh-update-center（GitHub：Yara2090/dsh-update-center）在 Web 设置面板增加「更新与版本」页，把当前版本、注册表新版本、一键安装、插件完整性自检与修复，以及停止服务收进同一处。
这是什么¶
dsh-update-center 由维护者 Yara2090 发布，在 SkillHub 目录中归类为客户端插件。它是 DSH Cordis 的 Host + Client 双半边实现：纯 JavaScript、ESM、无构建步骤、无运行时依赖；浏览器半边只从宿主模块表引入 react。
一句话定位：给 DeepSeek Harness Web GUI 提供「Updates & Version」设置页——读取本机 @deepseek-ai/dsh 版本、按可选通道查询 npm 注册表、将新版本装到同一全局前缀，并对插件自身做完整性检查与可安全执行的一键修复。
核心功能¶
版本与更新¶
- 同时展示「已安装」与「最新」版本，可在稳定版 / 预览版通道间切换。
- 支持「立即检查」「立即更新」；默认约每 6 小时自动检测新版本（可在页面上改频率与开关）。
- 装到磁盘但未重启时，页面会并列「已安装」与「运行中」版本，避免误以为已生效。
- 定位不到安装版本或注册表未返回所选标签时，显示明确状态或错误，而不是误报「已是最新」；本机跑预发布版且注册表
latest更旧时，判定为「无更新」（不自动降级）。
安装进度¶
一键更新走全局安装命令；进度条为不确定态（npm 不提供总量），页面展示真实信号：已用时长、已取包数，以及在 npm 场景下基于缓存目录统计的下载字节与速率；长时间无输出时会说明 npm 在管道模式下可能静默，而不是假装正常。
完整性检查与一键修复¶
进入页面时会自动跑一次只读自检，共 10 项，覆盖插件文件、清单、源码依赖、浏览器半边、profile 注册与 node_modules 链接、偏好 JSON、DSH 主目录可写、Node ≥ 20、能否定位全局 @deepseek-ai/dsh。其中 profile 注册、链接、偏好文件、主目录等项支持「一键修复」：修复前写同名 .bak 备份，只补缺失、不删用户已有内容。
自动检测与自动安装¶
页面上可开关自动检测，频率可选 1 / 6 / 12 / 24 小时；自动安装默认关闭，开启时会有风险提示。
运行控制¶
提供「停止 Harness」（需两次确认）。页面说明：关闭浏览器标签不会停止服务。停止动作调用 <DSH_HOME> 下安装器放置的 stop-deepseek-harness.ps1，与桌面快捷方式行为一致；安装进行中会拒绝停止（HTTP 409）。
安全边界¶
会改写全局 npm 包的路由仅接受回环地址，非回环请求返回 403。
安装与启用¶
前提：Node ≥ 20，且已安装 DeepSeek Harness。插件当前资料中的包版本为 1.6.4，许可证 MIT。
方式一：手动加入 web profile¶
先把插件目录放到本机路径（例如 C:\dsh\dsh-update-center），再执行：
dsh plugin --profile web add "file:C:\dsh\dsh-update-center"
接着编辑 ~/.dsh/profiles/web/package.json，在 dsh.profile.bundles 中增加一行：
"@local/dsh-update-center"
dsh plugin add 只装依赖，不会自动写入 bundle 列表；缺少这一步时，设置里不会出现「更新与版本」。最后重启 Harness，打开 设置 → 更新与版本（导航顺序在「模型」之后、「插件」之前）。
方式二：在 Harness 对话中安装¶
在 Harness 对话框发送：
把 https://github.com/Yara2090/dsh-update-center 装成插件
由 DSH 完成克隆、装依赖并写入 profile 的 bundle 列表；按提示重启一次即可。
常见问题¶
| 现象 | 处理 |
|---|---|
| 设置里找不到「更新与版本」 | 检查 dsh.profile.bundles 是否包含 @local/dsh-update-center |
| 卡片报错 | 使用「一键修复」；无法自动修的部分会给出说明 |
| 远程机器浏览器打不开相关能力 | 写磁盘与敏感路由仅对本机回环开放 |
提示找不到 dsh |
先执行 npm i -g @deepseek-ai/dsh |
典型用法¶
- 安装并写入 bundle 后重启，进入 设置 → 更新与版本。
- 在「版本信息」卡片选择更新通道，点「立即检查」确认最新版；需要时点「立即更新」，观察安装卡片中的命令、实时输出与进度信号。
- 更新完成后若「运行中」仍为旧版，按页面提示重启 Harness 后再确认。
- 若页面异常或插件未加载，在「完整性检查」中查看 10 项结果，必要时点「一键修复」。
- 在「自动检测」中按需开启周期检测；仅在理解风险后开启自动安装。
- 需要停服务时，在「运行控制」中两次确认「停止 Harness」，并按浮层提示关闭标签页（浏览器可能需手动
Ctrl+W）。
偏好写入 <DSH_HOME>/dsh-update-center.json（通道、自动检测、自动安装、频率等）。
卸载¶
- 从
~/.dsh/profiles/web/package.json的dsh.profile.bundles删除"@local/dsh-update-center"。 - 执行
dsh plugin --profile web remove @local/dsh-update-center。 - 重启 Harness。
<DSH_HOME>/dsh-update-center.json 可保留或删除。插件不改 Harness 核心文件；若使用过「一键修复」，可能动过 profile 清单、链接与偏好文件，且留有 .bak 备份。
适用场景与注意¶
适合在本机长期使用 DSH、希望用 Web 界面统一查看版本、更新 @deepseek-ai/dsh、排查 web profile 插件链接与 bundle 注册问题的开发者。
插件 Host 半边以当前 DSH 进程权限运行，一键更新会执行全局包管理器安装；安装前应阅读 GitHub 仓库 源码与 MIT 许可证，并在可信环境使用。SkillHub 上的 目录页 为社区收录，与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，本文介绍的是社区维护的客户端插件（仓库星标数在目录线索中为 0，以各站点实时显示为准）。
结尾¶
dsh-update-center 把 DSH 的版本信息、注册表检测、全局安装、插件自检修复和服务停止集中到设置页「更新与版本」，减少在终端与桌面快捷方式之间来回切换。进一步了解与提交问题见 GitHub：Yara2090/dsh-update-center，插件索引见 SkillHub 目录页。
