← Back to home@hjj345

dsh-sm-version-display

用于在侧边栏“设置”按钮上方显示已安装 dsh 版本的 DeepSeek Harness Web 插件。 | DeepSeek Harness Web plugin that displays the installed dsh version above the sidebar Settings button.

Stars
1
Language
JavaScript
Created
Aug 28, 2026
Updated
Aug 29, 2026
Web UI
GitHub repoHomepage

Introduction

DSH 版本检测 | dsh-sm-version-display

中文文档 · English documentation

version DSH node license platform

GitHub：hjj345/dsh-sm-version-display
npm：@hjj345345/dsh-sm-version-display

DSH 版本检测插件图标

最低支持 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.jshost 半区；注入当前 DSH 版本
client/client.jsclient 半区；卡片、更新检测、Toast 和样式
cordis.patch.yml将插件挂载到 DSH profile 层
LICENSEMIT 开源许可证

隐私与网络说明

  • 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。