hotpot-labs/dsh-version-plugin

dsh-version-plugin

一个 DSH（DeepSeek Harness）Web 模式插件：在设置弹窗的「通用设置」底部展示当前 DSH 版本，并提供检查更新、更新到最新版本的按钮。

预览

安装

从 npm 安装（推荐）

已发布的 npm 包包含预构建的浏览器端产物，无需本地构建权限：

dsh plugin --profile web add dsh-version-plugin

从 GitHub 安装

也可以直接从 git 仓库安装源码。prepare 脚本会在安装后自动构建浏览器端产物：

dsh plugin --profile web add github:hotpot-labs/dsh-version-plugin

pnpm ≥10 默认禁止 git 依赖执行构建脚本。首次 add 失败后，需要在对应 profile 的 pnpm-workspace.yaml 中授权本包构建，然后重新执行上面的 add 命令：

allowBuilds:
dsh-version-plugin: true

授权 allowBuilds 意味着允许该包源码在你的机器上安装时执行构建脚本。建议锁定到具体 commit：github:hotpot-labs/dsh-version-plugin#。

本地安装

在包含本插件的目录中，把它作为本地 bundle 安装进 profile：

dsh plugin --profile web add ./dsh-version-plugin

使用

安装完成后以 web 模式启动：

dsh --profile web web

打开设置弹窗 → 通用设置，即可在最底部看到「DSH 版本」行：

- 检查更新：查询 npm registry 上 @deepseek-ai/dsh 的最新版本。
- 更新到最新版本：执行 npm install -g @deepseek-ai/dsh@latest 并展示命令输出。

功能特性

- 在 host 侧读取已安装 @deepseek-ai/dsh 的 package.json 获取当前版本。
- 在 dsh web 模式的设置弹窗 → 通用设置 → 最底部增加「DSH 版本」行。
- 一键查询 npm registry 上 @deepseek-ai/dsh 的最新版本。
- 一键执行全局更新命令，并在界面上如实展示命令输出。

开发

工作原理

- host 侧（src/index.ts）读取已安装 @deepseek-ai/dsh 的 package.json 获取当前版本，并通过 ctx.connection.rpc.handle('/dsh-version', ...) 暴露三个 RPC 端点：getInstalledVersion、getLatestVersion、updateToLatest。
- 浏览器侧（src/client.tsx）在设置弹窗的通用设置底部渲染「DSH 版本」行，通过 RPC channel 调用 host 侧端点完成查询与更新。

目录结构

dsh-version-plugin/
├── package.json          # 插件元数据、dsh.client/dsh.bundle 声明
├── cordis.patch.yml      # 注册插件层
├── src/index.ts          # Host 侧入口：版本读取 + /dsh-version RPC channel
├── src/client.tsx        # 浏览器侧源码：通用设置行
├── lib/                  # 构建产物（gitignore）
│   ├── index.js
│   └── client.js
├── scripts/build.mjs     # 构建脚本
├── tests/safety.mjs      # 结构与导出校验
└── tsconfig.json         # TypeScript 配置

构建与测试

npm install
npm run build       # 生成产物到 lib/
npm run typecheck   # 类型检查
npm test            # 结构与导出校验
npm pack --dry-run  # 确认 tarball 只包含 lib/ + patch + README

常见问题

问：点「更新到最新版本」后 workspace 里的 dsh 没有变化？

「更新到最新版本」使用全局安装命令 npm install -g @deepseek-ai/dsh@latest。如果当前 dsh 是通过 pnpm workspace 或本地源码运行，该命令只会更新全局 npm 包，不会改动 workspace 源码；界面会如实返回 npm 的输出。

问：从 GitHub 安装时报错或缺少构建产物？

pnpm ≥10 默认禁止 git 依赖执行构建脚本。在对应 profile 的 pnpm-workspace.yaml 中为本包授权 allowBuilds 后重新安装（见「安装 → 从 GitHub 安装」）。

问：更新完成后界面显示的版本没有变？

重启 web 进程并刷新页面，再点一次「检查更新」确认。