YZz-S/dsh-update-checker

dsh-update-checker

English · 中文

DeepSeek Harness（dsh）Web GUI 的更新检查插件：在会话顶栏显示当前版本号，自动检查 npm 上的最新版本，有新版时提示升级。

DeepSeek Harness（dsh）Web GUI 的更新检查插件：在会话顶栏显示当前版本号，自动检查 npm 上的最新版本，有新版时提示升级。

运行效果

English

中文 · ← 返回 DeepSeekHarnessPlugins

功能特性

- 顶栏版本徽章：注册在会话顶栏操作区（标题旁边），采用增量注册方式——不替换任何内置 UI
- 页面加载时自动检查：挂载时检查一次，无需手动操作
- 三种徽章状态：
- 已是最新 → 显示“已是最新版本”
- 有新版本可用 → 显示“更新至 vX.Y.Z”，右上角带红点
- 检查失败 → 徽章变红并显示“检查失败”
- 对比面板：点击徽章会立即重新检查，并打开一个面板，显示当前版本 / 最新版本 / 更新状态 / 升级说明
- 分步诊断：失败时面板会显示诊断块（当前版本与最新版本检测每一步的具体探测记录），便于快速排查问题

文件

| 文件 | 说明 |
| --- | --- |
| index.js | 已安装的 Host 半部分（dsh.bundle 入口）：注册 /api/dsh-update-checker/check 路由，读取当前版本并查询最新版本 |
| lib/client.js | 已安装的 Client 半部分（dsh.client 模块）：顶栏徽章与对比面板 |
| cordis.patch.yml | Bundle 组合补丁，将插件行插入到 profile 中 |
| package.json | 包元数据（声明 dsh.bundle + dsh.client） |
| host.js / client.js | 动态 cordis_define 用法（与已安装形式互斥） |
| README.md / LICENSE | 文档 / MIT 许可证 |

安装（dsh.bundle）

本仓库同时也是一个可安装的 dsh 插件包（package.json 声明了 dsh.bundle + dsh.client）。安装后重启 dsh，“顶栏版本徽章”会自动生效。

如果作为独立仓库发布（与 awesome-dsh-plugin 相同的收录风格，推荐）：
dsh plugin --profile web add github:/dsh-update-checker

如果作为 DeepSeekHarnessPlugins 仓库的子目录安装：
dsh plugin --profile web add github:/DeepSeekHarnessPlugins#path:dsh-update-checker

更新已安装的插件：重新添加最新提交（或执行 dsh plugin --profile web update dsh-update-checker），然后重启 dsh。

用法（动态 Cordis 插件）

在带有 Cordis 工具的 dsh Web GUI 会话中定义并运行：

1. 调用 cordis_define：将 host.js 内容粘贴为 code.host，将 client.js 内容粘贴为 code.client（plugin.kind: 'new'，idPrefix 为 3–6 个小写字母）
2. 调用 cordis_run 激活，并在 UI 中允许授权
3. 刷新页面，在会话顶栏中查看徽章

注意：动态插件的生命周期与当前 dsh 进程一致。dsh 重启后，你必须重新定义并运行它；如需持久化，请使用上文的“安装（dsh.bundle）”方式。

工作原理

当前版本（已安装形式，按顺序降级）：

1. 读取 process.cwd()/node_modules/@deepseek-ai/dsh/package.json（npx 启动场景）
2. 读取常见的全局安装路径（/usr/local/lib、/opt/homebrew/lib）
3. 通过环境变量（npm_config_cache、LOCALAPPDATA、APPDATA、HOME）扫描 npm 缓存 _npx 目录

最新版本（按顺序降级）：

1. fetch 查询 registry.npmmirror.com
2. 失败时重试 registry.npmjs.org

结果会缓存 60 秒；点击徽章上的“重新检查”会跳过缓存并强制刷新。

隐私

- 网络请求仅发往公共 npm 仓库（npmmirror.com / npmjs.org），且仅在触发检查时发出
- 不收集或上传任何本地数据；本地仅读取 @deepseek-ai/dsh/package.json
- 无遥测、无持久化存储、无文件写入

已知限制

- 当前版本检测依赖于安装位置；失败时，面板诊断块会给出具体原因
- 徽章位于会话顶栏；空白的新会话（没有标题栏）不会显示它
- 它检查的是 DeepSeek Harness（@deepseek-ai/dsh）本身的版本，而不是此插件

发布前检查清单

- [x] 无硬编码密钥 / 令牌 / 密码
- [x] 无个人信息（用户名、机器路径、内部 IP、邮箱）
- [x] 网络端点仅为公共 npm 仓库，并已在本 README 中披露
- [x] 已采用 MIT 许可证，README 完整
- [x] 无遥测 / 无第三方数据收集
- [x] 代码仅使用 dsh 公共接口；所有副作用都挂在插件 Fiber 上，并在停止时清理

许可证

MIT

中文

English · ← 返回 DeepSeekHarnessPlugins

DeepSeek Harness（dsh）Web GUI 的更新检查插件：在会话顶栏显示当前版本号，自动检查 npm 上的最新版本，有新版时提示升级。

功能

- 顶栏版本徽章：注册在会话顶栏动作区（标题旁），加法式注册，不替换任何自带 UI
- 页面加载自动检查：挂载即检查一次，无需手动操作
- 三种徽章状态：
- 已是最新 → 显示「已经是最新版本」
- 有新版本 → 显示「更新到 vX.Y.Z」并在右上角亮红点
- 检查失败 → 徽章变红显示「检查失败」
- 对比面板：点击徽章立即重新检查并弹出面板，显示当前版本 / 最新版本 / 更新状态 / 升级指引
- 逐级诊断：检查失败时面板展示诊断块（当前版本与最新版本每一步探测的具体记录），便于快速定位

文件说明

| 文件 | 说明 |
| --- | --- |
| index.js | 安装版 Host 半边（dsh.bundle 入口）：注册 /api/dsh-update-checker/check 路由，读当前版本 + 查最新版本 |
| lib/client.js | 安装版 Client 半边（dsh.client 模块）：顶栏徽章与对比面板 |
| cordis.patch.yml | bundle 组合补丁，把插件行插入 profile |
| package.json | 包元信息（声明 dsh.bundle + dsh.client） |
| host.js / client.js | 动态 cordis_define 用法（与安装版二选一） |
| README.md / LICENSE | 说明文档 / MIT 许可证 |

安装（dsh.bundle）

本仓库同时是可安装的 dsh 插件包（package.json 声明 dsh.bundle + dsh.client）。安装后重启 dsh，「顶栏版本徽章」自动生效。

若插件发布为独立仓库（与 awesome-dsh-plugin 收录方式一致，推荐）：bash
dsh plugin --profile web add github:/dsh-update-checker

若作为 DeepSeekHarnessPlugins 仓库的子目录安装：
dsh plugin --profile web add github:/DeepSeekHarnessPlugins#path:dsh-update-checker

更新已安装的插件：重新 add 最新提交（或 dsh plugin --profile web update dsh-update-checker）后重启 dsh。

使用方法（动态 Cordis 插件）

在 dsh Web GUI 的会话中，用 Cordis 工具定义并运行：

1. 调用 cordis_define：code.host 粘贴 host.js 的内容，code.client 粘贴 client.js 的内容（plugin.kind: 'new'，idPrefix 取 3–6 个小写字母）
2. 调用 cordis_run 激活，在界面上允许授权
3. 刷新页面即可在会话顶栏看到徽章

注意：动态插件的生命周期与当前 dsh 进程相同。重启 dsh 后需重新定义运行；如需常驻，请使用上方「安装（dsh.bundle）」方式。

工作原理

当前版本（安装版，按顺序降级）：

1. 读取 process.cwd()/node_modules/@deepseek-ai/dsh/package.json（npx 启动场景）
2. 读取常见全局安装路径（/usr/local/lib、/opt/homebrew/lib）
3. 按环境变量（npm_config_cache、LOCALAPPDATA、APPDATA、HOME）扫描 npm 缓存 _npx 目录

最新版本（按顺序降级）：

1. fetch 查询 registry.npmmirror.com
2. 失败再试 registry.npmjs.org

结果带 60 秒缓存；点击徽章的「重新检查」会跳过缓存强制刷新。

隐私说明

- 网络请求仅指向公开 npm registry（npmmirror.com / npmjs.org），且仅在检查触发时发出
- 不采集、不上传任何本地数据；本地仅读取 @deepseek-ai/dsh/package.json
- 无遥测、无持久化存储、无文件写入

已知限制

- 当前版本探测依赖安装位置，探测失败时面板诊断块会给出具体原因
- 徽章位于会话顶栏；空白新会话（无标题栏）不显示
- 检查的是 DeepSeek Harness（@deepseek-ai/dsh）自身的版本，不是本插件版本

开源前检查

- [x] 无硬编码密钥 / Token / 密码
- [x] 无个人信息（用户名、机器路径、内部 IP、邮箱）
- [x] 网络端点仅公开 npm registry，已在 README 披露
- [x] MIT 许可证齐全，README 完整
- [x] 无遥测 / 无第三方数据收集
- [x] 代码仅使用 dsh 公开接口，副作用全部挂在插件 Fiber 上，停止即清理

License

MIT

English · 中文