dsh-pluginmgmt
DSH 插件管理器：粘贴 GitHub 链接，校验后一键安装，并对已装插件做更新 / 删除 / 启停全生命周期管理，支持后台自动更新。
Overview
image
解决什么问题：DeepSeek Harness 的插件默认只能通过 dsh plugin --profile web add <包> 命令行安装。dsh-pluginmgmt 在 Web GUI 里加了一个「插件管理」设置页，让你：
- 粘贴 GitHub 仓库链接 → 自动校验（是不是 dsh 插件、bundle 还是纯 cordis、monorepo 子目录）→ 一键安装；
- 对已装插件做更新 / 删除 / 启用停用；
- 可选的后台自动更新：定时检查所有已装插件（npm 源 + git 源）是否有新版本并更新，全部完成后左下角浮动窗口提示重启。
适合谁：所有 DSH 用户。核心价值有两块——安装更省事（粘贴 GitHub 链接即可，不用记 dsh plugin 命令）和管理更省心（更新 / 删除 / 启停 / 查更新 / 自动更新都在一个图形界面里完成，不用手改 profile 配置）。尤其适合不想记命令、需要集中管理多个插件的人。
Tools
| 工具 | 说明 |
|---|
plugin_install | 从 GitHub 链接安装插件（先校验 bundle / 纯 cordis，再 pnpm 安装） |
plugin_list | 列出 web profile 已装插件（bundle / 纯 cordis / npm，含运行态） |
plugin_remove | 卸载插件（pnpm rm + 层栈 reconcile + 清理 cordis insert） |
plugin_update | 更新插件（git 源对比最新 commit 重装；npm 源 pnpm up --latest） |
plugin_check_updates | 检查插件是否有新版本（npm 源 + git 源） |
plugin_auto_update | 立即检查并自动更新所有可更新插件 |
plugin_set_auto_update | 开启/关闭后台自动更新 |
Compatibility
- 依赖官方 SDK：
@deepseek-ai/* ^0.1.0-rc.6（由 profile 闭包注入，插件 dependencies 声明为空）。
- 验证环境：dsh
0.1.0-rc.6（npm 发行版）、Node 22。
- 最后验证日期：2026-08-16。
Install / Uninstall
安装（方式一：npm）
dsh plugin --profile web add dsh-pluginmgmt
安装（方式二：GitHub）
dsh plugin --profile web add "github:zebbkira/dsh-pluginmgmt#<ref>"
装完重启 dsh web 生效（bundle 层栈在 boot 合成）。
升级
推荐在设置页「插件管理」里点「更新」按钮（内部用 pnpm up --latest）。命令行等价：
dsh plugin --profile web add dsh-pluginmgmt@latest
注意：dsh plugin --profile web update <名>（即 pnpm up）对精确锁定的版本号（如 0.1.0）不会升级，需用上面带 @latest 或 pnpm up --latest 的形式。
禁用 / 启用
设置页「插件管理」里点「禁用」，或手改 ~/.dsh/profiles/web/cordis.patch.yml 中 - id: ui-dsh-pluginmgmt 的 disabled: true/false。
彻底移除
dsh plugin --profile web remove dsh-pluginmgmt
Quick start
零配置可用：
- 安装并重启：
dsh plugin --profile web add dsh-pluginmgmt → 重启 dsh web。
- 打开设置 → 「插件管理」。
- 粘贴
https://github.com/omdsh-dev/dsh-annotation → 点「校验」→ 看到「bundle · commit …」结论 → 点「安装」。
- 已装列表里出现该插件，可更新 / 删除 / 启停。
可复现示例：第 3 步换成任意 dsh 插件仓库链接即可（例如 https://github.com/zebbkira/dsh-skills-mcp-manager）。
Configuration
配置存 ~/.dsh/dsh-pluginmgmt.json（权限 0600）：
| 配置项 | 默认值 | 说明 |
|---|
settings.autoUpdate | false | 是否后台自动更新 |
settings.autoUpdateIntervalMin | 30 | 自动更新检查间隔（分钟） |
- 环境变量：
DSH_HOME（默认 ~/.dsh）。
- 敏感项：登记簿只存来源 URL / ref / 类型，不存任何凭据（无 GitHub token）。
Permissions & data
- 文件读写：
~/.dsh/profiles/web/package.json（依赖 + bundle 层栈）、~/.dsh/profiles/web/cordis.patch.yml（insert 行 + 启停）、~/.dsh/dsh-pluginmgmt.json（登记簿 + 设置）。安装 / 更新 / 删除时调用 pnpm，由 pnpm 写 node_modules 与锁文件。
- 网络：
git ls-remote 与 raw.githubusercontent.com（校验）、npm registry / codeload.github.com（经 pnpm 安装）。
- 凭据：插件自身不收集、不存储凭据；复用系统已有的 git / npm 凭据。
- 用户数据：不收集、不上传任何用户数据。
Troubleshooting
- 常见错误：
不是 dsh 插件 → 仓库 package.json 既无 dsh.bundle 也无 cordis 入口（main / exports）。pnpm 阻止了构建脚本 → 按提示把该依赖加入 profile pnpm-workspace.yaml 的 allowBuilds 后重试。- 装完没生效 → bundle 需重启 dsh web（层栈 boot 合成）。
- 日志：dsh web 的 boot 日志（
plugin tree failed to load、loader: load plugin …）。
- 回滚：
dsh plugin --profile web remove dsh-pluginmgmt；已装 git 源插件可重新安装旧 ref 回滚。
Development
pnpm install
pnpm run build # tsdown + wrap-client，产物在 lib/
pnpm test # vitest
pnpm run gates # 机械门禁 + 自测
贡献：fork → 改 → 门禁 + 测试通过 → PR。
License & security
- 许可证：MIT（见 LICENSE）。
- 安全问题请私下报告（不要在公开 issue 里贴），可通过 GitHub 私信 / 邮箱联系维护者。
