DSH 版本检测 | dsh-sm-version-display
中文文档 · English documentation
GitHub：hjj345/dsh-sm-version-display
npm：@hjj345345/dsh-sm-version-display
最低支持 DSH 版本：
v0.1.0-rc.6（含）。当前插件版本：v1.1.1。
简介
@hjj345345/dsh-sm-version-display 是一个面向 DeepSeek Harness（DSH）Web 界面的客户端 + host 双半区插件。它在侧边栏「设置」按钮上方显示当前已安装的 DSH 版本，并从 npm registry 检查是否有新版本。
从 v1.1.0 开始，插件同时在 DSH 设置中新增“DSH版本检测”一级页面（排序 22，位于参考插件下方）。页面复刻参考插件的卡片式设计，提供插件开关、通用设置、关于插件和安装命令；支持简体中文、English、繁體中文三种语言。点击“检测DSH版本”后，页面会展开显示本地版本、npm 最新版本、当前 DSH 安装方式和插件管理方式，并针对 npm、npx、pnpm 分别给出更新命令；npm/pnpm 全局安装方式还支持受本机安全限制保护的一键更新。
这里有三个名称需要区分：
- npm 包名：
@hjj345345/dsh-sm-version-display - DSH 运行时插件 ID：
dsh-sm-version-display - GitHub 仓库：
hjj345/dsh-sm-version-display
插件版本 v1.1.1 表示本插件版本；卡片中显示的是运行时读取到的 DSH 版本，两者不是同一个版本号。
功能特性
- 版本卡片：在侧边栏底部「设置」按钮上方显示圆角版本卡片，并独占一行。
- 运行时读取：host 半区在渲染页面时读取已安装的
@deepseek-ai/dsh版本，DSH 升级并重启后自动跟随。 - 安全回退：host 版本暂时不可用时显示“版本未知”，不会猜测或伪造固定版本。
- 更新检测：页面加载、每 30 分钟以及窗口重新回到前台时检查 DSH 最新版本；前台检查带 5 分钟节流。
- 语义化比较：内置轻量版本比较逻辑，支持 RC、beta、正式版和多位数字版本号比较。
- 手动刷新：卡片内提供刷新按钮，检查期间显示加载状态，完成后显示 DSH 原生 Toast。
- DSH 设置页：在 DSH 设置中注册“DSH版本检测”，位于参考插件
sm-context-piano（排序21）下方，使用默认齿轮图标（排序22）。 - 设置卡片：包含插件名称、副标题、开关、通用设置、关于插件和安装命令，整体复刻参考插件的设计。
- 三语设置：支持简体中文、English、繁體中文，默认简体中文，并持久化语言选择。
- 展开式检测：在设置页按钮下方展开显示本地 DSH 版本、npm 最新版本、当前安装方式和插件管理方式。
- 更新指引：检测到新版本时提供一键更新和更新命令说明，明确区分 npm、npx，并显示当前 pnpm 方式。
- 安全一键更新：npm/pnpm 全局安装方式由 host 执行固定命令；请求仅限本机回环地址，完成后需要重启 DSH。
- 响应式布局：侧边栏折叠为窄栏时显示圆形版本图标，文本空间不足时自动换行。
- 主题适配：使用 DSH 设计系统变量，跟随浅色和深色主题。
- 悬停提示：卡片和窄栏图标会显示插件英文名
dsh-sm-version-display及当前版本。
示例状态：
vX.Y.Z（最新版）
vX.Y.Z（有更新：vA.B.C）
安装与卸载
从 npm 安装（推荐）
在安装了 DSH 的机器上执行：
dsh plugin --profile web add @hjj345345/dsh-sm-version-display
安装完成后重启 DSH Web 服务或重新打开 Web 界面：
dsh web
卸载：
dsh plugin --profile web remove @hjj345345/dsh-sm-version-display
本地开发链接
本地开发时可以使用 link: 指向插件目录。下面的路径只是示例，请替换为实际路径，不要把个人电脑路径写入 README、源码或 npm 包：
dsh plugin --profile web add link:C:/path/to/dsh-sm-version-display
本地链接仅用于开发调试；正式使用应切换回 npm 包安装。
设置页与版本更新
打开 DSH 设置并选择 DSH版本检测。点击“检测DSH版本”后，结果会在按钮下方展开显示，不使用结果弹窗。检测到新版本时可使用“一键更新”，或打开“更新命令”查看完整步骤。
更新命令始终区分 npm 和 npx；如果本机是 pnpm 全局安装，还会优先显示 pnpm 命令：
# npm 全局安装
npm install --global @deepseek-ai/dsh@latest
# npx 临时执行最新版本
npx --yes @deepseek-ai/dsh@latest web
# pnpm 全局安装
pnpm add --global @deepseek-ai/dsh@latest
npx 没有需要替换的全局安装，下一次使用最新 npx 命令启动即可。任何更新完成后都需要重启 DSH Web 服务。
工作原理
DSH host process
lib/index.js
└─ 监听 webserver/index-inject
读取已安装 @deepseek-ai/dsh/package.json 的 version
注入 globalThis["__DSH_VERSION__"]、__DSH_INSTALL_INFO__ 和页面级更新 token
│
▼
DSH Web browser
client/client.js
├─ 注册 sidebar.footer.action 版本卡片和 settings.section 设置页
├─ 读取 window.__DSH_VERSION__ 并渲染版本卡片
├─ GET https://registry.npmjs.org/@deepseek-ai/dsh/latest
└─ POST 本机更新路由（仅固定 npm/pnpm 命令）
比较当前版本和 npm 最新版本
发布包中的关键文件：
| 文件 | 作用 |
|---|---|
lib/index.js |
host 半区；注入当前 DSH 版本 |
client/client.js |
client 半区；卡片、更新检测、Toast 和样式 |
cordis.patch.yml |
将插件挂载到 DSH profile 层 |
LICENSE |
MIT 开源许可证 |
隐私与网络说明
- host 半区只读取本机已安装的 DSH 包清单中的版本字段和安装路径类型，不向浏览器暴露绝对路径。
- client 半区只向
https://registry.npmjs.org/@deepseek-ai/dsh/latest发起版本查询；更新请求携带 host 注入的页面级 token。 - 更新路由只接受本机回环请求和匹配 token，命令和参数在 host 内固定，不接受浏览器传入任意命令。
- 请求不携带 DSH 登录凭据、会话内容或用户文件，插件也不会读取聊天内容。
- npm registry 请求失败时保留当前版本显示，并在手动检查时显示通用错误提示。
- 仓库和 npm 包均排除
.env、.npmrc、令牌、密钥、证书、日志、依赖目录及本地 DSH 数据。
兼容性
| 项目 | 要求 |
|---|---|
| DSH | >= v0.1.0-rc.6 |
| Node.js | >= 20（host 运行环境） |
| 平台 | DSH Web |
| 插件版本 | v1.1.1 |
插件使用 DSH 官方扩展点：dsh.client、sidebar.footer.action、settings.section、webserver/index-inject、ctx.slots.inject/register 和 ctx.settingsScope。如果 DSH 后续发生不兼容的扩展点变更，需要相应适配。
开发与本地验证
本插件使用与 DSH 客户端插件一致的手写 bundle 格式：window.__ModuleLoader__.load({ id, factory })，不需要额外编译器或运行时依赖。
在项目根目录执行：
npm run check
npm run build
npm run build 会执行 host/client 语法检查、版本比较自测、设置页/更新链路契约检查、包完整性检查和 README 检查。
更新日志
v1.1.1 - 2026-08-29
- 新增黑白描边版插件 Logo，并应用到双语 README 和设置页顶部。
- 设置页图标沿用参考项目的桌面端 54px 展示尺寸，使用内联 PNG 保证 npm 安装后可用。
v1.1.0 - 2026-08-29
- 新增 DSH 设置中的“DSH版本检测”一级导航，使用默认齿轮图标。
- 新增复刻参考项目的插件设置卡片和三语语言设置。
- 新增展开式版本检测结果、npm/npx/pnpm 更新区分和安全一键更新路由。
- 统一所有用户可见插件版本为
v1.1.0。
v1.0.1 - 2026-08-29
- 修复 scoped npm 包的 DSH bundle 导入名，保持运行时插件 ID 不变。
v1.0.0 - 2026-08-28
- 首次发布 DSH Web 版本显示插件。
- 支持运行时读取 DSH 版本、npm registry 更新检查、手动刷新和 Toast 提示。
- 支持侧边栏响应式布局、浅色/深色主题以及中英文界面。
- 增加版本比较、超时控制和版本不可用时的安全回退。
作者
作者：Jack·Huang
邮箱：jack698698@gmail.com
License
本项目以 MIT License 发布。Copyright © 2026 Jack·Huang。
No comments yet. Be the first to write one.