@hjj345345/dsh-sm-version-display

Sm Version Display

DeepSeek Harness Web 插件，包含 DSH 版本卡片、设置页面、npm 检查和安全更新指南。

目标 Profile

插件会安装到这里；不确定时保持 web。

npx -y @deepseek-ai/dsh plugin --profile web add @hjj345345/dsh-sm-version-display@1.2.27

兼容性与来源证明

Sm Version Display 以 @hjj345345/dsh-sm-version-display 发布，当前版本为 1.2.27。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。

DSH 兼容范围: *
运行环境: web
发布来源: npm
Registry 更新时间: 2026/11/5

版本

1.2.27stable

2026/11/1

1.2.26stable

2026/10/23

1.2.25stable

2026/10/21

查看其余 29 个版本收起版本

1.2.24stable

2026/9/30

1.2.23stable

2026/9/30

1.2.22stable

2026/9/30

1.2.21stable

2026/9/29

1.2.20stable

2026/9/27

1.2.19stable

2026/9/26

1.2.18stable

2026/9/26

1.2.17stable

2026/9/26

1.2.16stable

2026/9/26

1.2.15stable

2026/9/25

1.2.14stable

2026/9/25

1.2.13stable

2026/9/25

1.2.12stable

2026/9/24

1.2.11stable

2026/9/24

1.2.10stable

2026/9/15

README

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

中文文档 · English documentation

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

DSH 版本检测插件图标

最低支持 DSH 版本：v0.2.0-rc.1（含）；兼容声明显式包含 DSH v0.2.1-rc.2。当前插件版本：v1.2.27。

简介

@hjj345345/dsh-sm-version-display 是一个面向 DeepSeek Harness（DSH）Web 界面的客户端 + host 双半区插件。它在侧边栏「设置」按钮上方显示当前已安装的 DSH 版本，并检测 npm registry 与官方 GitHub Release 的新版本。

从 v1.1.0 开始，插件同时在 DSH 设置中新增“DSH版本检测”一级页面（排序 22，位于参考插件下方）。页面复刻参考插件的卡片式设计，提供插件开关、通用设置、关于插件和安装命令；支持简体中文、English、繁體中文三种语言。检测结果会在 DSH 进程期间缓存，设置弹窗重新打开后仍可查看。检测到更新时，用户可以先查看风险并确认后由插件执行精确版本命令，也可以打开手动更新步骤逐条执行。

这里有三个名称需要区分：

npm 包名：@hjj345345/dsh-sm-version-display
DSH 运行时插件 ID：dsh-sm-version-display
GitHub 仓库：hjj345/dsh-sm-version-display

插件版本 v1.2.27 表示本插件版本；卡片中显示的是运行时读取到的 DSH 版本，两者不是同一个版本号。

功能特性

版本卡片：在侧边栏底部「设置」按钮上方显示圆角版本卡片，并独占一行。
运行时读取：host 半区在渲染页面时读取已安装的 @deepseek-ai/dsh 版本，DSH 升级并重启后自动跟随。
安全回退：host 版本暂时不可用时显示“版本未知”，不会猜测或伪造固定版本。
更新检测：页面加载、每 30 分钟以及窗口重新回到前台时检查 npm 和 GitHub Release；结果在 DSH 进程内缓存。
GitHub 限流回退：GitHub API 受限时自动改用官方 Releases Atom Feed；npm 检测不受影响。
版本类型：GitHub 版本区分预发布 Alpha、测试版 Beta、公测版 RC 和正式版 Release。
语义化比较：内置轻量版本比较逻辑，支持 Alpha、Beta、RC、正式版和多位数字版本号比较。
手动刷新：卡片内提供刷新按钮，检查期间显示加载状态，完成后显示 DSH 原生 Toast。
DSH 设置页：在 DSH 设置中注册“DSH版本检测”，位于参考插件 sm-context-piano（排序 21）下方，使用默认齿轮图标（排序 22）。
设置卡片：包含插件名称、副标题、开关、通用设置、关于插件和安装命令，整体复刻参考插件的设计。
三语设置：支持简体中文、English、繁體中文，默认简体中文，并持久化语言选择。
展开式检测：在设置页按钮下方并排显示 npm 与 GitHub 版本、类型、发布时间、Release 链接、当前安装方式和插件管理方式。
双路径更新：更新前必须确认风险；支持 host 后台自动执行，或打开完整命令和步骤手动更新。
更新输出：自动更新时显示执行命令、实时输出、成功/失败状态和重启要求。
备份选择：更新确认时默认备份，也可明确跳过；跳过后本次更新不提供备份回滚。可选择 DSH 所在电脑上的保存目录，并记住上次位置。
备份管理：统一查看默认及已登记自定义目录中的完整、失败和中断备份，显示实际文件大小合计，支持刷新、扫描指定目录及确认后批量删除；不会跟随备份内链接删除外部文件。
失败恢复：备份失败后显示停止时间、原因和已复制大小，可重新备份并重试；只有完整且校验通过的对应备份才能回滚。
安全一键更新：仅执行 host 内固定的精确版本命令；请求仅限本机回环地址，GitHub 源码版本无对应 npm 包时仅提供手动构建步骤。
响应式布局：侧边栏折叠为窄栏时显示圆形版本图标，文本空间不足时自动换行。
主题适配：使用 DSH 设计系统变量，跟随浅色和深色主题。
悬停提示：卡片和窄栏图标会显示插件英文名 dsh-sm-version-display 及当前版本。

实际效果截图 / Screenshots

备份目录选择器浏览的是 DSH 服务所在电脑，不是远程浏览器所在设备。备份列表不扫描整台电脑；此前默认目录中的不完整备份也会列出，自定义目录可通过指定目录扫描补充。大小为备份普通文件的逻辑大小合计，不包含链接目标，也不等同于文件系统实际分配空间。删除备份不可撤销；删除当前任务对应的完整备份后，该任务将无法回滚。正在使用的备份不允许删除。

侧边栏版本卡片：

侧边栏窄栏悬停提示：

设置页总览：

双源版本检测结果：

更新确认弹窗：

更新执行记录、关于插件与安装命令：

示例状态：

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 与 GitHub 结果会在按钮下方展开显示，并在本次 DSH 进程期间保留。只有用户点击“收起检测结果”后才会折叠；重新启动 DSH 后状态重置。

更新命令始终区分 npm 和 npx；如果本机是 pnpm 全局安装，还会优先显示 pnpm 命令：

# npm 全局安装
npm install --global @deepseek-ai/dsh@<version>

# npx 临时执行指定版本
npx --yes @deepseek-ai/dsh@<version> web

# pnpm 全局安装
pnpm add --global @deepseek-ai/dsh@<version>

npx 没有需要替换的全局安装；GitHub Release 如果没有对应 npm 包，则需要按照弹窗中的 clone、checkout、pnpm install、build 和启动步骤手动执行。任何更新完成后都需要重启 DSH Web 服务。

自动更新会先显示来源、目标版本、版本类型和风险，用户确认后先备份并预检。如果检测到全局安装或 profile 中有旧版本固定依赖，页面会给出停机后的精确修复命令；命令完成后仍须重启 DSH，并在插件页面执行验证，才会标记更新成功。Alpha、Beta、RC 版本可能包含破坏性变更；切换版本前建议备份 .dsh 配置和 profile 数据。回退时请使用明确的旧版本号，例如 @deepseek-ai/dsh@0.1.1-rc.2。

工作原理

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 本机检查路由（host 缓存 npm 与 GitHub Release）
     └─ POST 本机更新路由（仅固定精确版本命令）
        比较当前版本和两个来源的版本

发布包中的关键文件：

文件	作用
`lib/index.js`	host 半区；注入当前 DSH 版本
`client/client.js`	client 半区；卡片、更新检测、Toast 和样式
`cordis.patch.yml`	将插件挂载到 DSH profile 层
`LICENSE`	MIT 开源许可证

隐私与网络说明

host 半区只读取本机已安装的 DSH 包清单中的版本字段和安装路径类型，不向浏览器暴露绝对路径。
host 半区查询 npm Registry 与 GitHub Releases，并在 DSH 进程内缓存结果；GitHub API 限流时回退到官方 Releases Atom Feed；更新请求携带 host 注入的页面级 token。
更新路由只接受本机回环请求和匹配 token，命令和参数在 host 内固定，不接受浏览器传入任意命令。
请求不携带 DSH 登录凭据、会话内容或用户文件，插件也不会读取聊天内容。
npm registry 请求失败时保留当前版本显示，并在手动检查时显示通用错误提示。
仓库和 npm 包均排除 .env、.npmrc、令牌、密钥、证书、日志、依赖目录及本地 DSH 数据。

兼容性

项目	要求
DSH	`>= v0.2.0-rc.1`，并显式支持 `v0.2.1-rc.2`
Node.js	`>= 20`（host 运行环境）
平台	DSH Web
插件版本	`v1.2.27`

插件使用 DSH 官方扩展点：dsh.client、sidebar.footer.action、settings.section、webserver/index-inject 和 ctx.slots.inject/register。启用状态与语言保存在 DSH profile 配置中；升级时会把仍留在浏览器本地的旧设置迁移到 profile，已有 profile 设置优先保留。

插件市场从 npm 包顶层 engines.dsh 读取宿主兼容声明。现有兼容范围予以保留，并显式加入 >=0.2.1-rc.2，因此 DSH v0.2.1-rc.2 已纳入支持声明。

开发与本地验证

本插件使用与 DSH 客户端插件一致的手写 bundle 格式：window.__ModuleLoader__.load({ id, factory })，不需要额外编译器或运行时依赖。

在项目根目录执行：

npm run check
npm run build

npm run build 会执行 host/client 语法检查、版本比较自测、设置页/更新链路契约检查、包完整性检查和 README 检查。

更新日志

v1.2.27 - 2026-11-01

修复 pnpm 将版本查询结果返回为单元素数组时被误判的问题；严格校验注册表输出，拒绝多值、空值、非字符串和无效 JSON，并补充对应回归测试。
新增一键更新时选择具体 npm 版本：加载可升级版本列表，标注推荐与弃用版本，前后端共同校验所选目标版本；正式版、预发布版和 npm 不支持的桌面安装方式保留各自适用行为。
完善重启后自动验证：更新成功但需要重启时继续轮询验证，验证完成后自动收敛任务状态；精简更新看板，优先显示需要用户处理的信息，并提供重启/停机状态摘要。
同步更新版本比较、备份路由、更新终端和 UI 回归测试，覆盖 pnpm 数组结果、非法注册表响应、指定版本更新及重启验证路径。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.27，发布日期为 2026-11-01。

v1.2.26 - 2026-10-23

修复 DSH 设置菜单含快捷键提示文本或禁用项时的导航匹配，并补充对应测试覆盖。
同步插件包、客户端关于页面、发布契约及双语文档版本到 v1.2.26。

v1.2.25 - 2026-10-21

更新 DSH 0.2.1-rc.2 开发基线：同步 settings、Remote Settings、客户端模块、UI 组件及 schemastery 依赖，并重新生成 pnpm 锁文件。
修复 DSH 设置导航：精确匹配本地化设置项，过滤快捷键提示文本和禁用项；支持已打开的菜单，并避免在其他对话框打开时误触发导航。
新增设置导航测试，覆盖不同语言菜单标签、快捷键提示、菜单已打开、设置弹窗已存在及导航项缺失等路径；同步更新 DSH 0.2 契约测试。
双语文档明确声明兼容 DSH v0.2.1-rc.2，并同步顶部徽标与兼容性表格。
修复 GitHub Actions 发布测试依赖冲突，将路由测试所需的 schemastery 版本对齐到 3.18.5。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.25，发布日期为 2026-10-21。

v1.2.24 - 2026-09-30

修复 GitHub Actions 的 pnpm 环境配置，确保发布工作流能够稳定安装依赖并执行构建、测试和发布步骤。
修复更新终端测试的 Linux 模拟环境，覆盖独立更新终端、PowerShell 命令、任务恢复和输出日志场景。
将双语文档当前最低 DSH 支持版本统一为 v0.2.0-rc.1，同步顶部徽标、兼容性表格和发布契约校验。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.24，发布日期为 2026-09-30。

v1.2.23 - 2026-09-30

重构独立更新终端与任务恢复：新增 lib/update-runtime.mjs，将 PowerShell 控制台执行、输出采集和更新任务恢复拆分为可复用运行时。
完善停机更新流程：支持独立控制台持续输出命令与进度，增强自动继续、离线修复、重启后任务恢复和桌面安装器处理。
更新客户端确认弹窗、更新看板及三语文案，统一停机更新、自动继续、安装器下载和恢复动作的交互。
新增独立更新终端和任务恢复测试，扩展备份路由、UI 与发布契约校验，并将新增运行时脚本纳入 npm 发布白名单。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.23，发布日期为 2026-09-30。

v1.2.22 - 2026-09-30

完善 DSH 停机更新：新增 PowerShell 更新控制台，持续输出当前命令、步骤和进度，便于跟踪安装、依赖修复及离线恢复过程。
增强更新 Worker 的停机与自动继续逻辑：支持 PowerShell 控制台输出、桌面安装器分支、下载/启动安装器及重启后的继续处理，并保留失败后的离线修复路径。
统一 DSH 更新确认弹窗样式与动作文案，补充桌面安装、自动继续、停机更新和重新启动相关三语文案。
更新 UI 自测、发布契约和 npm 包白名单，确保 PowerShell 控制台脚本、更新流程和新增路径持续受校验覆盖。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.22，发布日期为 2026-09-30。

v1.2.21 - 2026-09-29

适配 DSH 0.2.0-rc.1 开发依赖：补充 dsh-api-remotes、settings controller、客户端模块、UI sidebar/primitives/slots 等 0.2.0 RC 依赖，并更新 npm peerDependencies 与最低 DSH 引擎声明。
将 @deepseek-ai/dsh-api-remotes 纳入客户端注入，使 Remote Settings 与 DSH 0.2 客户端依赖链保持一致。
新增 pnpm 锁文件与 DSH 0.2 集成契约测试，校验设置配置接口、Remote Settings describe/update、volatile 字段、UI primitives 导出和 sidebar footer slot。
扩展发布契约检查，确保 DSH 0.2 依赖版本、锁文件内容、客户端注入和 npm 元数据不会回退。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.21，发布日期为 2026-09-29。

v1.2.20 - 2026-09-27

优化侧栏版本入口布局：修复版本胶囊、刷新按钮和折叠栏图标的置顶顺序与宽度适配，避免窄侧栏中被挤压、裁剪或溢出。
优化刷新按钮样式：统一控件高度、主题颜色、禁用状态和本地化文本宽度，适配中文、英文及繁体中文界面。
刷新后支持同步当前语言并直达 DSH 插件设置页，折叠栏图标点击行为与设置导航保持一致。
移除旧的侧栏弹层实现，改用更轻量的胶囊与刷新控件交互，并同步更新 UI 自测和 CSS 契约断言。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.20，发布日期为 2026-09-27。

v1.2.19 - 2026-09-26

重构侧栏版本入口：底部槽位改为紧凑状态胶囊（状态点 + 版本号）与独立刷新圆钮，内容短小天然自适应任何侧栏宽度，彻底解决窄侧栏下版本卡片溢出、刷新按钮被裁的问题。
点击胶囊或折叠栏图标弹出 body portal 全屏面板，展示版本、检测状态、npm/GitHub 结果与刷新按钮，宽度与侧栏布局链解耦。
弹层与座位样式全量使用 DSH 主题变量并补充暗色覆盖，明亮/暗色模式均正确渲染；支持 Esc、遮罩点击、关闭按钮三种关闭方式及 prefers-reduced-motion。
三处 Tooltip 方位改为 side:"top"：气泡显示在锚点上方并按视口 12px 边距钳制、放不下自动翻转，修复胶囊位于侧栏底部时悬浮提示越出视口底沿的问题。
测试同步覆盖座位结构、弹层开关、宽/窄两分支行为与 Tooltip 方位断言。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.19，发布日期为 2026-09-26。

v1.2.18 - 2026-09-26

修复侧栏版本卡片宽度自适应：槽位适配规则全部加 !important 并改为 flex:1 1 0% + width/max-width:100% + min-width:0，卡片宽度严格跟随 DSH 侧栏伸缩，不再被新版运行时样式覆盖撑开而溢出。
仓库状态行独立成行（.dvd_sourceText display:block），文本在卡片内自动多行换行、不溢出。
两处 Tooltip 加 portal:true，气泡挂到 body 按视口定位，不再被侧栏裁剪或错位。
测试补齐 portal 与加固 CSS 断言；浏览器复现验证 315px/200px 侧栏下卡片均贴合宽度、文本换行无溢出。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.18，发布日期为 2026-09-26。

v1.2.17 - 2026-09-26

修复 DSH 0.1.7 侧栏版本卡片图标崩溃：版本卡片与 toast 图标改用新版 dsh-client-ui-primitives 导出的 *Regular 组件；旧 *Outline16/*Outline14 图标已不再导出，引用 undefined 会触发 React #130，导致整个 sidebar.footer.action 插槽渲染崩溃。
Tooltip 提示按新版组件签名改为纯文本字符串。
handleRefresh 返回检测 promise，便于测试等待刷新完成。
测试补齐 VersionCard 真实渲染断言（宽卡片、tooltip、刷新按钮状态、旧图标名绝迹），并修正按钮节点匹配与 hook 状态复位。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.17，发布日期为 2026-09-26。

v1.2.16 - 2026-09-26

修复 DSH 0.1.7 设置接口兼容：设置页由 host 注册配置模式，客户端改用 DSH Remote Settings API 读取和更新 profile 配置。
新增旧设置迁移：将浏览器本地保存的启用状态与语言迁移到 DSH profile；仅补齐 profile 中尚不存在的字段，保留已有 profile 设置，迁移成功后再清理旧浏览器数据。
将 npm 包声明的最低 DSH 版本更新为 >=0.1.7-rc.1，并同步双语文档的适配说明。
补充设置迁移自测，并更新 UI、路由和发布契约测试，覆盖 profile 写入、旧数据迁移及新设置接口。
修复 DSH 0.1.7 设置字段未标记为可编辑、重启验证后的更新看板残留，并同步开发接口到 schemastery 3.18.4。
修正 Remote Settings 返回值解包、显式注入 remote.settings，并监听外部设置变更。

v1.2.13 - 2026-09-25

完善一键更新停机恢复：识别需要关闭 DSH 才能完成的依赖安装/修复，将操作步骤和命令展示给用户，并在重启后重新验证目标版本及 Web profile。
改进升级状态恢复与成功判定：设置页重新打开后可恢复并继续跟踪进行中的任务；只有安装及 profile 验证通过后才确认成功，重启待验证任务提供重新验证入口。
明确插件市场兼容性：在 npm 包元数据中声明最低 DSH 版本 >=0.1.7-rc.1，并在双语兼容性说明中解释该要求。
补充停机更新、重启验证及依赖修复相关三语文案和 Worker、路由、界面契约测试。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.13，发布日期为 2026-09-25。

v1.2.12 - 2026-09-24

新增 npm Trusted Publishing 工作流：支持推送 v* 标签或从 master 手动触发发布；发布前校验标签/输入版本与 package.json 一致，并自动执行构建、测试和 npm 发布。
修复备份目录路径校验在不同平台上的兼容问题，并补齐对应测试；Trusted Publishing 流程也安装路由测试所需的 host peer 依赖，确保 CI 测试可运行。
修复自动备份删除期间的超时与列表竞态：删除操作未完成时延后定时刷新，避免旧请求恢复已删除记录；删除完成后更新列表并正确显示结果。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.12，发布日期为 2026-09-24。

v1.2.11 - 2026-09-24

完善 DSH 一键升级备份管理：支持默认备份、明确跳过备份、指定 DSH 主机目录，并记住最近使用的备份目录；目录浏览限定在 DSH 主机，不扫描远程浏览器设备，也不跟随符号链接。
新增并优化备份管理卡片：展示默认或自定义目录中的完整、失败和中断备份，显示文件数量与逻辑大小，支持刷新、目录扫描及确认后删除；正在使用、不完整或路径已变化的备份会受到保护。
增强失败恢复：展示备份失败原因、停止时间和已复制大小，支持重试备份；只有完整、校验通过且与当前升级任务匹配的备份才允许回滚，并保留回滚恢复副本。
优化升级看板、备份目录选择器和三语文案，补充备份管理器、路由、界面及发布契约自测，覆盖目录安全校验、manifest、进度、删除保护和恢复链路。
更新插件包、客户端关于页面和双语文档的版本标识为 v1.2.11，发布日期为 2026-09-24。

v1.2.10 - 2026-09-15

修复升级状态文件并发写入失败：host 与升级 Worker 使用带进程号和随机标识的独立临时文件，避免多个进程共享 .tmp 文件互相覆盖。
增强 Windows 原子替换可靠性：状态文件重命名遇到 EPERM、EACCES 或 EBUSY 时按有限次数重试，并在成功或失败后清理临时文件。
消除 Worker 启动后的重复状态写入，避免 host 在记录 Worker PID 时覆盖 Worker 已写入的最新升级状态。
补充发布契约校验：覆盖 host/Worker 的状态写入重试常量、SharedArrayBuffer 等待机制，并禁止旧共享临时文件名回归。
更新插件包、客户端关于页面和双语文档的版本标识为 v1.2.10，发布日期为 2026-09-15。

v1.2.9 - 2026-09-15

优化 DSH 升级备份进度与心跳看板：实时展示备份扫描/复制进度、当前步骤、目标版本、命令及已处理文件数量，升级过程更容易定位和跟踪。
增强 Worker 心跳机制：记录最近活动时间，超过 10 分钟没有进度时标记为心跳超时，并提供继续等待、自动修复或一键回滚选项，避免误判长时间任务状态。
完善升级修复流程：增加 Web profile 修复步骤，处理 profile、配置导出、端口占用和 DSH 仍在运行等常见失败场景，并提供手动修复命令与提示。
强化更新动作交互：新增更新执行看板、目标版本和无命令输出状态，失败操作按钮支持等待、自动修复和回滚，并在动作切换期间正确停止或恢复 Worker。
扩展三语文案与发布契约校验，覆盖心跳超时、进度看板、profile 修复、更新动作和升级 Worker 相关内容。
更新插件包、客户端关于页面和双语文档的版本标识为 v1.2.9，发布日期为 2026-09-15。

v1.2.8 - 2026-09-14

完善 DSH 一键升级安全流程：新增独立升级 Worker，按备份、目标版本预检、全局依赖树修复、安装目标版本和安装结果/profile 校验分步执行，避免长时间升级任务阻塞主进程。
增加可恢复环境备份：升级前备份全局 DSH 目录与 DSH profile 数据，生成包含版本、路径、文件数和字节数的 manifest，并限制目录遍历不跟随符号链接。
增强失败处理：升级 Worker 持久化步骤、输出、警告和状态；任务异常中断会标记为失败，备份完成后提供自动修复与一键回滚，回滚后再次校验恢复的 DSH 版本并保留恢复副本。
增强客户端更新交互：显示备份路径、备份文件数、步骤状态和 peer dependency 警告；失败时支持自动修复或一键回滚，并轮询新的更新动作任务状态。
将 lib/update-worker.mjs 纳入 npm 发布白名单，并补充 Worker 自测、虚拟存储目录解析、客户端更新动作和发布文件契约校验。
更新插件包、客户端关于页面和双语文档的版本标识为 v1.2.8，发布日期为 2026-09-14。

v1.2.7 - 2026-09-07

移除全局 pnpm 不支持的 --virtual-store-dir 参数。
当检测到旧版全局虚拟存储布局时，先串行执行 pnpm install --global --force 重建全局依赖树，再执行普通 DSH 更新命令。

v1.2.6 - 2026-09-07

修复 PNPM .modules.yaml 为单行 JSON 时无法读取 virtualStoreDir 的问题，确保一键更新会沿用现有全局虚拟存储目录。
增加 JSON 格式和旧版行式格式的解析自测，避免更新命令再次回退为未带目录参数的旧命令。

v1.2.5 - 2026-09-07

修复 PNPM 全局更新的虚拟存储目录兼容性：从已解析的 DSH 包路径向上查找 .modules.yaml，读取并校验 virtualStoreDir，在可用时将其传入更新命令，避免 PNPM 依赖树位置不一致导致更新失败。
增强命令路径处理：兼容 .modules.yaml 中的引号格式、Windows 绝对路径和最多 10 层父目录查找；对包含空格、& 或引号的参数进行安全转义，保证 Windows cmd.exe 执行文本正确。
补充发布契约校验：覆盖虚拟存储目录解析、--virtual-store-dir 参数和现有客户端注入契约，防止 PNPM 更新兼容修复回退。
更新插件包、客户端关于页面和双语文档的版本标识为 v1.2.5，发布日期为 2026-09-07。

v1.2.4 - 2026-09-03

修复 DSH 新旧客户端模块加载兼容性：将 dsh.client.inject 中的过时 @deepseek-ai/dsh-client-runtime 替换为 @deepseek-ai/dsh-client-modules，保留语言、设置页、插槽和 UI 原语模块注入。
强化发布契约校验：明确要求 @deepseek-ai/dsh-client-modules 存在，并禁止已过时的 @deepseek-ai/dsh-client-runtime 残留，避免客户端加载入口回退。
更新插件包、客户端关于页面和双语文档的版本标识为 v1.2.4，发布日期为 2026-09-03。

v1.2.3 - 2026-09-03

补充双语 README 的实际效果截图，覆盖侧边栏版本卡片、侧边栏窄栏悬停提示、设置页总览、npm/GitHub 双源版本检测结果、更新确认弹窗，以及更新执行记录、关于插件和安装命令。
将 images/Screenshot/ 纳入 npm 发布白名单，确保发布包包含 README 所引用的 6 张截图资源。
同步发布契约校验：纳入截图目录的发布文件清单，更新当前插件版本与发布日期校验，避免文档、包元数据和实际发布内容不一致。
更新插件包、客户端关于页面和双语文档的版本标识为 v1.2.3，发布日期为 2026-09-03。

v1.2.2 - 2026-09-02

修复新版 DSH 设置服务兼容性：移除对 settingsNamespace 辅助函数的直接导入，改用设置命名空间字符串注册插件设置，兼容新增的 @deepseek-ai/dsh-settings 版本。
扩展 peerDependencies 版本范围：支持 @deepseek-ai/dsh-settings 的 0.1.2-alpha.2、0.1.2-alpha.4，以及 @deepseek-ai/schemastery 的 3.18.2，同时保留既有兼容版本。
更新发布契约校验：验证新的字符串命名空间注册方式，确保 DSH 设置兼容修复不会在后续改动中回退。
同步插件包、客户端关于页面和双语文档的版本标识为 v1.2.2，发布日期为 2026-09-02。

v1.2.1 - 2026-09-02

修复 GitHub 版本检测的限流容错：GitHub API 请求失败时自动尝试 Releases Atom Feed，并统一 API 与 Feed 返回的版本、类型、标签、发布日期、Release 链接和 npm 可用性信息。
增强 GitHub 检测状态展示：能够区分 API、备用 Feed、限流和暂时不可用状态；侧边栏版本卡片、Tooltip、检测结果卡片和更新提示会同步显示 npm/GitHub 来源与状态。
优化 Release 链接：无论数据来自 GitHub API 还是 Atom Feed，均规范为官方 Release 页面，并提供多语言“一键直达/Click to open”入口。
完善三语文案：补齐简体中文、英文和繁体中文的稳定渠道 latest、更新来源、检测通道、Feed 状态、限流提示和 Release 直达文案；语言下拉项统一保持 语言/Language。
补充发布契约校验：覆盖 GitHub Feed 回退、限流错误、检测通道、Feed 文案、Release 直达文案及三语多语言键，确保新链路不会被后续改动破坏。
更新插件包、客户端关于页面和双语文档的版本标识为 v1.2.1，发布日期为 2026-09-02。

v1.2.0 - 2026-09-01

重构双源版本检测：同时查询 npm Registry 与官方 GitHub Releases，显示当前版本、最新版本、发布类型、发布日期、Release 标签、链接及 npm 可用性。
增强版本识别与比较：支持 Alpha、Beta、RC、正式版及多位数字版本，并区分最新、可更新、当前版本更高和检测失败等状态。
完善检测时机与缓存：页面加载时检测，每 30 分钟自动刷新，窗口回到前台时按间隔刷新；结果由 DSH 进程缓存，避免重复请求。
更新设置页结果展示：新增可展开的 npm/GitHub 双卡片，展示当前安装方式和插件管理器，并提供稳定渠道 latest 的清晰中文、英文和繁体中文文案。
增加安全更新流程：更新前明确展示来源、目标版本、发布类型和风险，只有经过确认的固定版本命令才会执行。
增强主机端更新保护：更新接口限制为回环地址、合法来源和页面级令牌，校验目标是否过期，避免重复任务，并记录命令输出、完成状态、失败原因和重启提示。
覆盖多种更新方式：npm 与 pnpm 支持主机端一键更新，npx 提供临时执行命令；没有对应 npm 包的 GitHub 版本自动回退到 clone、checkout、安装、构建和启动步骤。
同步插件包、关于页面及双语文档的版本标识为 v1.2.0，发布日期为 2026-09-01，并补充对应的构建与多语言契约校验。

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

版本

1.2.27stable

2026/11/1

1.2.26stable

2026/10/23

1.2.25stable

2026/10/21

查看其余 29 个版本收起版本

1.2.24stable

2026/9/30

1.2.23stable

2026/9/30

1.2.22stable

2026/9/30

1.2.21stable

2026/9/29

1.2.20stable

2026/9/27

1.2.19stable

2026/9/26

1.2.18stable

2026/9/26

1.2.17stable

2026/9/26

1.2.16stable

2026/9/26

1.2.15stable

2026/9/25

1.2.14stable

2026/9/25

1.2.13stable

2026/9/25

1.2.12stable

2026/9/24

1.2.11stable

2026/9/24

1.2.10stable

2026/9/15

README

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

中文文档 · English documentation

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

DSH 版本检测插件图标

最低支持 DSH 版本：v0.2.0-rc.1（含）；兼容声明显式包含 DSH v0.2.1-rc.2。当前插件版本：v1.2.27。

简介

这里有三个名称需要区分：

npm 包名：@hjj345345/dsh-sm-version-display
DSH 运行时插件 ID：dsh-sm-version-display
GitHub 仓库：hjj345/dsh-sm-version-display

插件版本 v1.2.27 表示本插件版本；卡片中显示的是运行时读取到的 DSH 版本，两者不是同一个版本号。

功能特性

版本卡片：在侧边栏底部「设置」按钮上方显示圆角版本卡片，并独占一行。
运行时读取：host 半区在渲染页面时读取已安装的 @deepseek-ai/dsh 版本，DSH 升级并重启后自动跟随。
安全回退：host 版本暂时不可用时显示“版本未知”，不会猜测或伪造固定版本。
更新检测：页面加载、每 30 分钟以及窗口重新回到前台时检查 npm 和 GitHub Release；结果在 DSH 进程内缓存。
GitHub 限流回退：GitHub API 受限时自动改用官方 Releases Atom Feed；npm 检测不受影响。
版本类型：GitHub 版本区分预发布 Alpha、测试版 Beta、公测版 RC 和正式版 Release。
语义化比较：内置轻量版本比较逻辑，支持 Alpha、Beta、RC、正式版和多位数字版本号比较。
手动刷新：卡片内提供刷新按钮，检查期间显示加载状态，完成后显示 DSH 原生 Toast。
DSH 设置页：在 DSH 设置中注册“DSH版本检测”，位于参考插件 sm-context-piano（排序 21）下方，使用默认齿轮图标（排序 22）。
设置卡片：包含插件名称、副标题、开关、通用设置、关于插件和安装命令，整体复刻参考插件的设计。
三语设置：支持简体中文、English、繁體中文，默认简体中文，并持久化语言选择。
展开式检测：在设置页按钮下方并排显示 npm 与 GitHub 版本、类型、发布时间、Release 链接、当前安装方式和插件管理方式。
双路径更新：更新前必须确认风险；支持 host 后台自动执行，或打开完整命令和步骤手动更新。
更新输出：自动更新时显示执行命令、实时输出、成功/失败状态和重启要求。
备份选择：更新确认时默认备份，也可明确跳过；跳过后本次更新不提供备份回滚。可选择 DSH 所在电脑上的保存目录，并记住上次位置。
备份管理：统一查看默认及已登记自定义目录中的完整、失败和中断备份，显示实际文件大小合计，支持刷新、扫描指定目录及确认后批量删除；不会跟随备份内链接删除外部文件。
失败恢复：备份失败后显示停止时间、原因和已复制大小，可重新备份并重试；只有完整且校验通过的对应备份才能回滚。
安全一键更新：仅执行 host 内固定的精确版本命令；请求仅限本机回环地址，GitHub 源码版本无对应 npm 包时仅提供手动构建步骤。
响应式布局：侧边栏折叠为窄栏时显示圆形版本图标，文本空间不足时自动换行。
主题适配：使用 DSH 设计系统变量，跟随浅色和深色主题。
悬停提示：卡片和窄栏图标会显示插件英文名 dsh-sm-version-display 及当前版本。

实际效果截图 / Screenshots

侧边栏版本卡片：

侧边栏窄栏悬停提示：

设置页总览：

双源版本检测结果：

更新确认弹窗：

更新执行记录、关于插件与安装命令：

示例状态：

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 包安装。

设置页与版本更新

更新命令始终区分 npm 和 npx；如果本机是 pnpm 全局安装，还会优先显示 pnpm 命令：

# npm 全局安装
npm install --global @deepseek-ai/dsh@<version>

# npx 临时执行指定版本
npx --yes @deepseek-ai/dsh@<version> web

# pnpm 全局安装
pnpm add --global @deepseek-ai/dsh@<version>

工作原理

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 本机检查路由（host 缓存 npm 与 GitHub Release）
     └─ POST 本机更新路由（仅固定精确版本命令）
        比较当前版本和两个来源的版本

发布包中的关键文件：

文件	作用
`lib/index.js`	host 半区；注入当前 DSH 版本
`client/client.js`	client 半区；卡片、更新检测、Toast 和样式
`cordis.patch.yml`	将插件挂载到 DSH profile 层
`LICENSE`	MIT 开源许可证

隐私与网络说明

host 半区只读取本机已安装的 DSH 包清单中的版本字段和安装路径类型，不向浏览器暴露绝对路径。
host 半区查询 npm Registry 与 GitHub Releases，并在 DSH 进程内缓存结果；GitHub API 限流时回退到官方 Releases Atom Feed；更新请求携带 host 注入的页面级 token。
更新路由只接受本机回环请求和匹配 token，命令和参数在 host 内固定，不接受浏览器传入任意命令。
请求不携带 DSH 登录凭据、会话内容或用户文件，插件也不会读取聊天内容。
npm registry 请求失败时保留当前版本显示，并在手动检查时显示通用错误提示。
仓库和 npm 包均排除 .env、.npmrc、令牌、密钥、证书、日志、依赖目录及本地 DSH 数据。

兼容性

项目	要求
DSH	`>= v0.2.0-rc.1`，并显式支持 `v0.2.1-rc.2`
Node.js	`>= 20`（host 运行环境）
平台	DSH Web
插件版本	`v1.2.27`

插件市场从 npm 包顶层 engines.dsh 读取宿主兼容声明。现有兼容范围予以保留，并显式加入 >=0.2.1-rc.2，因此 DSH v0.2.1-rc.2 已纳入支持声明。

开发与本地验证

本插件使用与 DSH 客户端插件一致的手写 bundle 格式：window.__ModuleLoader__.load({ id, factory })，不需要额外编译器或运行时依赖。

在项目根目录执行：

npm run check
npm run build

npm run build 会执行 host/client 语法检查、版本比较自测、设置页/更新链路契约检查、包完整性检查和 README 检查。

更新日志

v1.2.27 - 2026-11-01

修复 pnpm 将版本查询结果返回为单元素数组时被误判的问题；严格校验注册表输出，拒绝多值、空值、非字符串和无效 JSON，并补充对应回归测试。
新增一键更新时选择具体 npm 版本：加载可升级版本列表，标注推荐与弃用版本，前后端共同校验所选目标版本；正式版、预发布版和 npm 不支持的桌面安装方式保留各自适用行为。
完善重启后自动验证：更新成功但需要重启时继续轮询验证，验证完成后自动收敛任务状态；精简更新看板，优先显示需要用户处理的信息，并提供重启/停机状态摘要。
同步更新版本比较、备份路由、更新终端和 UI 回归测试，覆盖 pnpm 数组结果、非法注册表响应、指定版本更新及重启验证路径。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.27，发布日期为 2026-11-01。

v1.2.26 - 2026-10-23

修复 DSH 设置菜单含快捷键提示文本或禁用项时的导航匹配，并补充对应测试覆盖。
同步插件包、客户端关于页面、发布契约及双语文档版本到 v1.2.26。

v1.2.25 - 2026-10-21

更新 DSH 0.2.1-rc.2 开发基线：同步 settings、Remote Settings、客户端模块、UI 组件及 schemastery 依赖，并重新生成 pnpm 锁文件。
修复 DSH 设置导航：精确匹配本地化设置项，过滤快捷键提示文本和禁用项；支持已打开的菜单，并避免在其他对话框打开时误触发导航。
新增设置导航测试，覆盖不同语言菜单标签、快捷键提示、菜单已打开、设置弹窗已存在及导航项缺失等路径；同步更新 DSH 0.2 契约测试。
双语文档明确声明兼容 DSH v0.2.1-rc.2，并同步顶部徽标与兼容性表格。
修复 GitHub Actions 发布测试依赖冲突，将路由测试所需的 schemastery 版本对齐到 3.18.5。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.25，发布日期为 2026-10-21。

v1.2.24 - 2026-09-30

修复 GitHub Actions 的 pnpm 环境配置，确保发布工作流能够稳定安装依赖并执行构建、测试和发布步骤。
修复更新终端测试的 Linux 模拟环境，覆盖独立更新终端、PowerShell 命令、任务恢复和输出日志场景。
将双语文档当前最低 DSH 支持版本统一为 v0.2.0-rc.1，同步顶部徽标、兼容性表格和发布契约校验。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.24，发布日期为 2026-09-30。

v1.2.23 - 2026-09-30

重构独立更新终端与任务恢复：新增 lib/update-runtime.mjs，将 PowerShell 控制台执行、输出采集和更新任务恢复拆分为可复用运行时。
完善停机更新流程：支持独立控制台持续输出命令与进度，增强自动继续、离线修复、重启后任务恢复和桌面安装器处理。
更新客户端确认弹窗、更新看板及三语文案，统一停机更新、自动继续、安装器下载和恢复动作的交互。
新增独立更新终端和任务恢复测试，扩展备份路由、UI 与发布契约校验，并将新增运行时脚本纳入 npm 发布白名单。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.23，发布日期为 2026-09-30。

v1.2.22 - 2026-09-30

完善 DSH 停机更新：新增 PowerShell 更新控制台，持续输出当前命令、步骤和进度，便于跟踪安装、依赖修复及离线恢复过程。
增强更新 Worker 的停机与自动继续逻辑：支持 PowerShell 控制台输出、桌面安装器分支、下载/启动安装器及重启后的继续处理，并保留失败后的离线修复路径。
统一 DSH 更新确认弹窗样式与动作文案，补充桌面安装、自动继续、停机更新和重新启动相关三语文案。
更新 UI 自测、发布契约和 npm 包白名单，确保 PowerShell 控制台脚本、更新流程和新增路径持续受校验覆盖。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.22，发布日期为 2026-09-30。

v1.2.21 - 2026-09-29

适配 DSH 0.2.0-rc.1 开发依赖：补充 dsh-api-remotes、settings controller、客户端模块、UI sidebar/primitives/slots 等 0.2.0 RC 依赖，并更新 npm peerDependencies 与最低 DSH 引擎声明。
将 @deepseek-ai/dsh-api-remotes 纳入客户端注入，使 Remote Settings 与 DSH 0.2 客户端依赖链保持一致。
新增 pnpm 锁文件与 DSH 0.2 集成契约测试，校验设置配置接口、Remote Settings describe/update、volatile 字段、UI primitives 导出和 sidebar footer slot。
扩展发布契约检查，确保 DSH 0.2 依赖版本、锁文件内容、客户端注入和 npm 元数据不会回退。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.21，发布日期为 2026-09-29。

v1.2.20 - 2026-09-27

优化侧栏版本入口布局：修复版本胶囊、刷新按钮和折叠栏图标的置顶顺序与宽度适配，避免窄侧栏中被挤压、裁剪或溢出。
优化刷新按钮样式：统一控件高度、主题颜色、禁用状态和本地化文本宽度，适配中文、英文及繁体中文界面。
刷新后支持同步当前语言并直达 DSH 插件设置页，折叠栏图标点击行为与设置导航保持一致。
移除旧的侧栏弹层实现，改用更轻量的胶囊与刷新控件交互，并同步更新 UI 自测和 CSS 契约断言。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.20，发布日期为 2026-09-27。

v1.2.19 - 2026-09-26

重构侧栏版本入口：底部槽位改为紧凑状态胶囊（状态点 + 版本号）与独立刷新圆钮，内容短小天然自适应任何侧栏宽度，彻底解决窄侧栏下版本卡片溢出、刷新按钮被裁的问题。
点击胶囊或折叠栏图标弹出 body portal 全屏面板，展示版本、检测状态、npm/GitHub 结果与刷新按钮，宽度与侧栏布局链解耦。
弹层与座位样式全量使用 DSH 主题变量并补充暗色覆盖，明亮/暗色模式均正确渲染；支持 Esc、遮罩点击、关闭按钮三种关闭方式及 prefers-reduced-motion。
三处 Tooltip 方位改为 side:"top"：气泡显示在锚点上方并按视口 12px 边距钳制、放不下自动翻转，修复胶囊位于侧栏底部时悬浮提示越出视口底沿的问题。
测试同步覆盖座位结构、弹层开关、宽/窄两分支行为与 Tooltip 方位断言。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.19，发布日期为 2026-09-26。

v1.2.18 - 2026-09-26

修复侧栏版本卡片宽度自适应：槽位适配规则全部加 !important 并改为 flex:1 1 0% + width/max-width:100% + min-width:0，卡片宽度严格跟随 DSH 侧栏伸缩，不再被新版运行时样式覆盖撑开而溢出。
仓库状态行独立成行（.dvd_sourceText display:block），文本在卡片内自动多行换行、不溢出。
两处 Tooltip 加 portal:true，气泡挂到 body 按视口定位，不再被侧栏裁剪或错位。
测试补齐 portal 与加固 CSS 断言；浏览器复现验证 315px/200px 侧栏下卡片均贴合宽度、文本换行无溢出。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.18，发布日期为 2026-09-26。

v1.2.17 - 2026-09-26

修复 DSH 0.1.7 侧栏版本卡片图标崩溃：版本卡片与 toast 图标改用新版 dsh-client-ui-primitives 导出的 *Regular 组件；旧 *Outline16/*Outline14 图标已不再导出，引用 undefined 会触发 React #130，导致整个 sidebar.footer.action 插槽渲染崩溃。
Tooltip 提示按新版组件签名改为纯文本字符串。
handleRefresh 返回检测 promise，便于测试等待刷新完成。
测试补齐 VersionCard 真实渲染断言（宽卡片、tooltip、刷新按钮状态、旧图标名绝迹），并修正按钮节点匹配与 hook 状态复位。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.17，发布日期为 2026-09-26。

v1.2.16 - 2026-09-26

修复 DSH 0.1.7 设置接口兼容：设置页由 host 注册配置模式，客户端改用 DSH Remote Settings API 读取和更新 profile 配置。
新增旧设置迁移：将浏览器本地保存的启用状态与语言迁移到 DSH profile；仅补齐 profile 中尚不存在的字段，保留已有 profile 设置，迁移成功后再清理旧浏览器数据。
将 npm 包声明的最低 DSH 版本更新为 >=0.1.7-rc.1，并同步双语文档的适配说明。
补充设置迁移自测，并更新 UI、路由和发布契约测试，覆盖 profile 写入、旧数据迁移及新设置接口。
修复 DSH 0.1.7 设置字段未标记为可编辑、重启验证后的更新看板残留，并同步开发接口到 schemastery 3.18.4。
修正 Remote Settings 返回值解包、显式注入 remote.settings，并监听外部设置变更。

v1.2.13 - 2026-09-25

完善一键更新停机恢复：识别需要关闭 DSH 才能完成的依赖安装/修复，将操作步骤和命令展示给用户，并在重启后重新验证目标版本及 Web profile。
改进升级状态恢复与成功判定：设置页重新打开后可恢复并继续跟踪进行中的任务；只有安装及 profile 验证通过后才确认成功，重启待验证任务提供重新验证入口。
明确插件市场兼容性：在 npm 包元数据中声明最低 DSH 版本 >=0.1.7-rc.1，并在双语兼容性说明中解释该要求。
补充停机更新、重启验证及依赖修复相关三语文案和 Worker、路由、界面契约测试。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.13，发布日期为 2026-09-25。

v1.2.12 - 2026-09-24

新增 npm Trusted Publishing 工作流：支持推送 v* 标签或从 master 手动触发发布；发布前校验标签/输入版本与 package.json 一致，并自动执行构建、测试和 npm 发布。
修复备份目录路径校验在不同平台上的兼容问题，并补齐对应测试；Trusted Publishing 流程也安装路由测试所需的 host peer 依赖，确保 CI 测试可运行。
修复自动备份删除期间的超时与列表竞态：删除操作未完成时延后定时刷新，避免旧请求恢复已删除记录；删除完成后更新列表并正确显示结果。
更新插件包、客户端关于页面、发布契约和双语文档的版本标识为 v1.2.12，发布日期为 2026-09-24。

v1.2.11 - 2026-09-24

完善 DSH 一键升级备份管理：支持默认备份、明确跳过备份、指定 DSH 主机目录，并记住最近使用的备份目录；目录浏览限定在 DSH 主机，不扫描远程浏览器设备，也不跟随符号链接。
新增并优化备份管理卡片：展示默认或自定义目录中的完整、失败和中断备份，显示文件数量与逻辑大小，支持刷新、目录扫描及确认后删除；正在使用、不完整或路径已变化的备份会受到保护。
增强失败恢复：展示备份失败原因、停止时间和已复制大小，支持重试备份；只有完整、校验通过且与当前升级任务匹配的备份才允许回滚，并保留回滚恢复副本。
优化升级看板、备份目录选择器和三语文案，补充备份管理器、路由、界面及发布契约自测，覆盖目录安全校验、manifest、进度、删除保护和恢复链路。
更新插件包、客户端关于页面和双语文档的版本标识为 v1.2.11，发布日期为 2026-09-24。

v1.2.10 - 2026-09-15

修复升级状态文件并发写入失败：host 与升级 Worker 使用带进程号和随机标识的独立临时文件，避免多个进程共享 .tmp 文件互相覆盖。
增强 Windows 原子替换可靠性：状态文件重命名遇到 EPERM、EACCES 或 EBUSY 时按有限次数重试，并在成功或失败后清理临时文件。
消除 Worker 启动后的重复状态写入，避免 host 在记录 Worker PID 时覆盖 Worker 已写入的最新升级状态。
补充发布契约校验：覆盖 host/Worker 的状态写入重试常量、SharedArrayBuffer 等待机制，并禁止旧共享临时文件名回归。
更新插件包、客户端关于页面和双语文档的版本标识为 v1.2.10，发布日期为 2026-09-15。

v1.2.9 - 2026-09-15

优化 DSH 升级备份进度与心跳看板：实时展示备份扫描/复制进度、当前步骤、目标版本、命令及已处理文件数量，升级过程更容易定位和跟踪。
增强 Worker 心跳机制：记录最近活动时间，超过 10 分钟没有进度时标记为心跳超时，并提供继续等待、自动修复或一键回滚选项，避免误判长时间任务状态。
完善升级修复流程：增加 Web profile 修复步骤，处理 profile、配置导出、端口占用和 DSH 仍在运行等常见失败场景，并提供手动修复命令与提示。
强化更新动作交互：新增更新执行看板、目标版本和无命令输出状态，失败操作按钮支持等待、自动修复和回滚，并在动作切换期间正确停止或恢复 Worker。
扩展三语文案与发布契约校验，覆盖心跳超时、进度看板、profile 修复、更新动作和升级 Worker 相关内容。
更新插件包、客户端关于页面和双语文档的版本标识为 v1.2.9，发布日期为 2026-09-15。

v1.2.8 - 2026-09-14

完善 DSH 一键升级安全流程：新增独立升级 Worker，按备份、目标版本预检、全局依赖树修复、安装目标版本和安装结果/profile 校验分步执行，避免长时间升级任务阻塞主进程。
增加可恢复环境备份：升级前备份全局 DSH 目录与 DSH profile 数据，生成包含版本、路径、文件数和字节数的 manifest，并限制目录遍历不跟随符号链接。
增强失败处理：升级 Worker 持久化步骤、输出、警告和状态；任务异常中断会标记为失败，备份完成后提供自动修复与一键回滚，回滚后再次校验恢复的 DSH 版本并保留恢复副本。
增强客户端更新交互：显示备份路径、备份文件数、步骤状态和 peer dependency 警告；失败时支持自动修复或一键回滚，并轮询新的更新动作任务状态。
将 lib/update-worker.mjs 纳入 npm 发布白名单，并补充 Worker 自测、虚拟存储目录解析、客户端更新动作和发布文件契约校验。
更新插件包、客户端关于页面和双语文档的版本标识为 v1.2.8，发布日期为 2026-09-14。

v1.2.7 - 2026-09-07

移除全局 pnpm 不支持的 --virtual-store-dir 参数。
当检测到旧版全局虚拟存储布局时，先串行执行 pnpm install --global --force 重建全局依赖树，再执行普通 DSH 更新命令。

v1.2.6 - 2026-09-07

修复 PNPM .modules.yaml 为单行 JSON 时无法读取 virtualStoreDir 的问题，确保一键更新会沿用现有全局虚拟存储目录。
增加 JSON 格式和旧版行式格式的解析自测，避免更新命令再次回退为未带目录参数的旧命令。

v1.2.5 - 2026-09-07

修复 PNPM 全局更新的虚拟存储目录兼容性：从已解析的 DSH 包路径向上查找 .modules.yaml，读取并校验 virtualStoreDir，在可用时将其传入更新命令，避免 PNPM 依赖树位置不一致导致更新失败。
增强命令路径处理：兼容 .modules.yaml 中的引号格式、Windows 绝对路径和最多 10 层父目录查找；对包含空格、& 或引号的参数进行安全转义，保证 Windows cmd.exe 执行文本正确。
补充发布契约校验：覆盖虚拟存储目录解析、--virtual-store-dir 参数和现有客户端注入契约，防止 PNPM 更新兼容修复回退。
更新插件包、客户端关于页面和双语文档的版本标识为 v1.2.5，发布日期为 2026-09-07。

v1.2.4 - 2026-09-03

修复 DSH 新旧客户端模块加载兼容性：将 dsh.client.inject 中的过时 @deepseek-ai/dsh-client-runtime 替换为 @deepseek-ai/dsh-client-modules，保留语言、设置页、插槽和 UI 原语模块注入。
强化发布契约校验：明确要求 @deepseek-ai/dsh-client-modules 存在，并禁止已过时的 @deepseek-ai/dsh-client-runtime 残留，避免客户端加载入口回退。
更新插件包、客户端关于页面和双语文档的版本标识为 v1.2.4，发布日期为 2026-09-03。

v1.2.3 - 2026-09-03

补充双语 README 的实际效果截图，覆盖侧边栏版本卡片、侧边栏窄栏悬停提示、设置页总览、npm/GitHub 双源版本检测结果、更新确认弹窗，以及更新执行记录、关于插件和安装命令。
将 images/Screenshot/ 纳入 npm 发布白名单，确保发布包包含 README 所引用的 6 张截图资源。
同步发布契约校验：纳入截图目录的发布文件清单，更新当前插件版本与发布日期校验，避免文档、包元数据和实际发布内容不一致。
更新插件包、客户端关于页面和双语文档的版本标识为 v1.2.3，发布日期为 2026-09-03。

v1.2.2 - 2026-09-02

修复新版 DSH 设置服务兼容性：移除对 settingsNamespace 辅助函数的直接导入，改用设置命名空间字符串注册插件设置，兼容新增的 @deepseek-ai/dsh-settings 版本。
扩展 peerDependencies 版本范围：支持 @deepseek-ai/dsh-settings 的 0.1.2-alpha.2、0.1.2-alpha.4，以及 @deepseek-ai/schemastery 的 3.18.2，同时保留既有兼容版本。
更新发布契约校验：验证新的字符串命名空间注册方式，确保 DSH 设置兼容修复不会在后续改动中回退。
同步插件包、客户端关于页面和双语文档的版本标识为 v1.2.2，发布日期为 2026-09-02。

v1.2.1 - 2026-09-02

修复 GitHub 版本检测的限流容错：GitHub API 请求失败时自动尝试 Releases Atom Feed，并统一 API 与 Feed 返回的版本、类型、标签、发布日期、Release 链接和 npm 可用性信息。
增强 GitHub 检测状态展示：能够区分 API、备用 Feed、限流和暂时不可用状态；侧边栏版本卡片、Tooltip、检测结果卡片和更新提示会同步显示 npm/GitHub 来源与状态。
优化 Release 链接：无论数据来自 GitHub API 还是 Atom Feed，均规范为官方 Release 页面，并提供多语言“一键直达/Click to open”入口。
完善三语文案：补齐简体中文、英文和繁体中文的稳定渠道 latest、更新来源、检测通道、Feed 状态、限流提示和 Release 直达文案；语言下拉项统一保持 语言/Language。
补充发布契约校验：覆盖 GitHub Feed 回退、限流错误、检测通道、Feed 文案、Release 直达文案及三语多语言键，确保新链路不会被后续改动破坏。
更新插件包、客户端关于页面和双语文档的版本标识为 v1.2.1，发布日期为 2026-09-02。

v1.2.0 - 2026-09-01

重构双源版本检测：同时查询 npm Registry 与官方 GitHub Releases，显示当前版本、最新版本、发布类型、发布日期、Release 标签、链接及 npm 可用性。
增强版本识别与比较：支持 Alpha、Beta、RC、正式版及多位数字版本，并区分最新、可更新、当前版本更高和检测失败等状态。
完善检测时机与缓存：页面加载时检测，每 30 分钟自动刷新，窗口回到前台时按间隔刷新；结果由 DSH 进程缓存，避免重复请求。
更新设置页结果展示：新增可展开的 npm/GitHub 双卡片，展示当前安装方式和插件管理器，并提供稳定渠道 latest 的清晰中文、英文和繁体中文文案。
增加安全更新流程：更新前明确展示来源、目标版本、发布类型和风险，只有经过确认的固定版本命令才会执行。
增强主机端更新保护：更新接口限制为回环地址、合法来源和页面级令牌，校验目标是否过期，避免重复任务，并记录命令输出、完成状态、失败原因和重启提示。
覆盖多种更新方式：npm 与 pnpm 支持主机端一键更新，npx 提供临时执行命令；没有对应 npm 包的 GitHub 版本自动回退到 clone、checkout、安装、构建和启动步骤。
同步插件包、关于页面及双语文档的版本标识为 v1.2.0，发布日期为 2026-09-01，并补充对应的构建与多语言契约校验。

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

Sm Version Display

兼容性与来源证明

版本

相关插件

Sm Version Display

README

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

简介

功能特性

实际效果截图 / Screenshots

安装与卸载

从 npm 安装（推荐）

本地开发链接

设置页与版本更新

工作原理

隐私与网络说明

兼容性

开发与本地验证

更新日志

v1.2.27 - 2026-11-01

v1.2.26 - 2026-10-23

v1.2.25 - 2026-10-21

v1.2.24 - 2026-09-30

v1.2.23 - 2026-09-30

v1.2.22 - 2026-09-30

v1.2.21 - 2026-09-29

v1.2.20 - 2026-09-27

v1.2.19 - 2026-09-26

v1.2.18 - 2026-09-26

v1.2.17 - 2026-09-26

v1.2.16 - 2026-09-26

v1.2.13 - 2026-09-25

v1.2.12 - 2026-09-24

v1.2.11 - 2026-09-24

v1.2.10 - 2026-09-15

v1.2.9 - 2026-09-15

v1.2.8 - 2026-09-14

v1.2.7 - 2026-09-07

v1.2.6 - 2026-09-07

v1.2.5 - 2026-09-07

v1.2.4 - 2026-09-03

v1.2.3 - 2026-09-03

v1.2.2 - 2026-09-02

v1.2.1 - 2026-09-02

v1.2.0 - 2026-09-01

v1.1.1 - 2026-08-29

v1.1.0 - 2026-08-29

v1.0.1 - 2026-08-29

v1.0.0 - 2026-08-28

作者

License

兼容性与来源证明

版本

相关插件

相关插件

相关插件

README

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

简介

功能特性

实际效果截图 / Screenshots

安装与卸载

从 npm 安装（推荐）

本地开发链接

设置页与版本更新

工作原理

隐私与网络说明

兼容性

开发与本地验证

更新日志

v1.2.27 - 2026-11-01

v1.2.26 - 2026-10-23

v1.2.25 - 2026-10-21

v1.2.24 - 2026-09-30

v1.2.23 - 2026-09-30

v1.2.22 - 2026-09-30

v1.2.21 - 2026-09-29

v1.2.20 - 2026-09-27

v1.2.19 - 2026-09-26

v1.2.18 - 2026-09-26