dsh-plugin-manager-lite

dsh-plugin-manager-lite

管理 DeepSeek Harness Web 中除官方插件外的第三方插件的静态 bundle 插件。

在设置页「插件 → 第三方插件」提供：列表 / 启用 / 停用 / 卸载 / 检查更新。停用状态持久化到 ~/.dsh/cordis.patch.yml，重启 DSH 后仍保持。

当前版本 v0.1.0（见 npm 与 GitHub Release）；已发布至 npm。

功能

• 列表第三方插件：只显示非官方（非 @deepseek-ai/*）插件，读取 package.json 展示真实名称、版本、作者、描述，标注「本地安装 / npm」
• 启用 / 停用：切换插件运行状态；停用状态持久化到 ~/.dsh/cordis.patch.yml，重启后保持
• 卸载：运行时停用 + 从 profile 配置移除（dependencies / bundles）
• 检查更新：查询 npm registry，对比当前版本与最新版本
• 一键安装/升级：对 npm 安装的第三方插件，更新 profile 依赖版本并在 profile 目录执行 pnpm add <pkg>@^latest 完成安装，装完后重启 DSH 生效；本地 file: 安装的插件不开放此按钮
• /tppm/debug：排错端点，报告列表数据源各环节实际值

要求

• DeepSeek Harness（dsh）0.1.0-rc.7+（developer preview，字段可能变化）
• Node.js >=18
• Peer dependency：@deepseek-ai/cordis ^4.0.1

安装

推荐用 dsh plugin 命令（等价于在 profile 下执行 pnpm add）：

# 从 npm
dsh plugin --profile web add dsh-plugin-manager-lite

# 从 GitHub
dsh plugin --profile web add github:ShanHaiFish/dsh-plugin-manager-lite

# 本地目录（开发期）
dsh plugin --profile web add /path/to/dsh-plugin-manager-lite

或在 ~/.dsh/profiles/web/package.json 手动加入依赖与 dsh.profile.bundles，然后重启 DSH。

注意：Host 从 ~/.dsh/profiles/web/node_modules/<包名>/ 解析并服务本插件。 开发期修改本仓库源码后，必须把改动同步到该副本再重启 DSH 才生效 （dsh plugin add 会执行同步；手动拷贝请见「开发」）。

使用

重启 DSH 后，打开浏览器进入 Web GUI → 设置 → 插件 → 第三方插件：

• 点「刷新」重新拉取插件列表；
• 运行中的插件可「停用」；已停用的插件可「启用」；
• 每个插件可「检查更新」「卸载」。

停用 / 启用结果通过 alert 提示，操作成功会刷新列表反映真实状态。

目录结构

dsh-plugin-manager-lite/
├── package.json          # 包名 = 金三角事实源（name / patch name / client load id）
├── cordis.patch.yml      # 把本包插入 profile 层栈（层 id: tppm）
├── lib/
│   └── index.js          # Host 半区（ESM）：webServer 同源 JSON 路由 /tppm/*
├── client/
│   └── client.js         # Client 半区（浏览器 bundle）：设置页选项卡 UI
├── src/                  # 动态形态源码（参考，不参与安装加载）
├── CONTRIBUTING.md
├── SECURITY.md
├── CODE_OF_CONDUCT.md
└── LICENSE               # MIT

Host 路由

Client 半区通过同源 fetch 调用 Host 半区（/tppm/*），区别于动态形态的 host.call：

方法	说明
POST /tppm/listThirdPartyPlugins	列出第三方插件（含已停用）
POST /tppm/listAllPlugins	列举所有插件（含官方，调试用）
POST /tppm/enablePlugin	启用插件（热启用 + 持久化）
POST /tppm/disablePlugin	停用插件（热停用 + 持久化）
POST /tppm/uninstallPlugin	卸载插件
POST /tppm/checkForUpdates	检查更新
POST /tppm/installUpdate	一键安装/升级到 npm 最新版本
POST /tppm/diagnose	loader entry 诊断
POST /tppm/debug	列表数据源诊断

开发

# 语法检查
npm run check

开发期同步到 profile：Host 实际加载 ~/.dsh/profiles/web/node_modules/dsh-plugin-manager-lite/。 每次改动本仓库后，同步相关文件到该副本再重启：

$dst = "$HOME\.dsh\profiles\web\node_modules\dsh-plugin-manager-lite"
Copy-Item package.json, cordis.patch.yml, lib\index.js, client\client.js -Destination $dst -Force

或直接重新 dsh plugin --profile web add /path/to/dsh-plugin-manager-lite。

贡献

欢迎提交 Issue 与 Pull Request。请先阅读 CONTRIBUTING.md。 安全相关请按 SECURITY.md 处理。

许可证

MIT © ShanHaiFish。