dsh-plugin-dashboard
DSH 第三方插件版本仪表板：Web Settings 标签页，列出已安装插件及其当前版本和最新版本（来自 npm registry 或 git tags/HEAD），支持一键升级。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-plugin-dashboard@0.1.10Plugin Dashboard 以 dsh-plugin-dashboard 发布，当前版本为 0.1.10。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
DSH 插件管理面板，嵌入 dsh Web 设置：Settings → Plugins 新增「插件管理」tab，列出当前 profile 安装的第三方插件、各自已装版本与最新版本（npm registry 或 GitHub tags/HEAD），支持一键升级与卸载。
package.json（dependencies + dsh.profile.bundles）、node_modules/*/package.json（已装版本）、pnpm-lock.yaml（github 安装解析到的 40 位 commit）。fetch，零子进程）——npm 包查询 registry 的 /<pkg>/latest（dist-tag latest，尊重 npm_config_registry）；github 安装（github:user/repo）查 GitHub REST API /tags + /commits/HEAD，取最高 semver tag（无 tag 用 HEAD）；支持 GITHUB_TOKEN 环境变量提额；远端 4xx/不可达 → 该条目降级为「未知」并显示原因，不影响其它条目。package.json（.dshbak-*）、改写 specifier（npm 保 range 风格 ^/~；git 包 pin 到 #<tag> 或 #<commit>）、经 ctx.subprocess 跑 dsh 原生命令 dsh plugin --profile <name> add <pkg>@<版本>（bounded collect 输出），失败自动回滚。dsh plugin add；单个失败不回滚已完成的更新，结果逐条回报，完成后重启 dsh 生效。options.name 归属、带文件 id）向 profile 的 cordis.patch.yml 追加 disabled: true 的 id-targeted 补丁（patchReload: live 的 profile 即时热生效，startup 重启后生效）——不动 dsh.profile.bundles/dependencies，包保持安装、dsh plugin reconcile 不会复读它；启用则整块移除（写入前备份 .dshbak-*）。core 包拒绝禁用。dependencies（ctx.subprocess 跑 dsh plugin --profile <name> remove <pkg>）与 dsh.profile.bundles 中一并移除；core 包（@deepseek-ai/*、@deepseek-harness-tui/*）拒绝卸载；未知包报错；同样带备份与失败回滚。pnpm install 失败恢复原文件。作为 profile bundle 挂载。dsh plugin add 只是在 profile 目录跑 pnpm——运行中直接执行即可，无需先停止 dsh；装完重启 dsh 生效。
cd ~/.dsh/profiles/<你的 profile> # 例如 web
dsh plugin --profile <你的 profile> add dsh-plugin-dashboard
从 npm 安装，lib/ 已随包发布，装完即可用，无需本地构建。dsh plugin add 会自动把包名加进 profile 的 dsh.profile.bundles；手动编辑时形如：
{
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-browser-tool", "dsh-plugin-dashboard"]
}
}
}
重启 dsh，Web 设置 → Plugins 出现「插件管理」tab。验证：
dsh --profile <你的 profile> --dump-config | grep dsh-plugin-dashboard
exports "."）：cordis 插件，注入 dsh 原生的 webServer + subprocess 服务——ctx.webServer.register 挂 prefix 路由 /plugins/dsh-plugin-dashboard/api（/list、/upgrade、/upgrade-all、/uninstall），零裸 child_process：命令执行全部经 ctx.subprocess.spawn（树级终止、bounded collect），版本查询用 node 运行时自带 fetch（dsh 的 node，无额外进程）。dsh 进程的 cwd 就是 profile 目录，所有读写都针对它。exports "./client"）：esbuild 打包成 window.__ModuleLoader__.load({ id, factory }) lazy-CJS factory（脚本 scripts/build-client.mjs）。ModuleLoader 契约有三个硬约束：factory 只接收 require 且必须 return module.exports（<script> 环境无 module/exports，需在 factory 体内自声明 var module = { exports: {} }; var exports = module.exports;）；entry 导出需 treeShaking: false 防止 export const inject 被内联删除；模块必须真实 export const inject（声明服务注入，运行时经此拿 ctx.slots）。组件用 React.createElement 手写（零 JSX）；react 及 @deepseek-ai/* 全部 external，从平台模块表解析；dsh.client.inject 元数据同时提供给 shell 的注入装配。fetch 同源 /plugins/dsh-plugin-dashboard/api/*——走 ctx.webServer 路由，不依赖 typert Remote 装配（那条路需要进 dsh 主仓库 api/remotes 静态登记）。| 环境变量 | 说明 |
|---|---|
DSH_PLUGIN_DASHBOARD_PROFILE_DIR | 覆盖 profile 目录（默认 process.cwd()，即 dsh 运行的 profile） |
DSH_PROFILES_ROOT | 仅供测试/独立调试时指定 profiles 根 |
dependencies 条目走 pnpm remove（改 deps + lockfile + node_modules），随后从 dsh.profile.bundles 剔除同名挂载；仅挂载而未声明依赖的条目（如某些 host 包）只剔除 bundles。卸载/升级完成后都需要重启 dsh 生效，UI 会提示。latest 为基准；本地 npm 配的 registry（如镜像）即查询源。@deepseek-ai/*、@deepseek-harness-tui/* 不可卸载（防止拆掉 dsh-base 这类地基）；tab 上也不显示卸载按钮。npm run build # tsc（node 面）→ lib/ + esbuild（浏览器面）→ lib/client.cjs
npm run check # tsc --noEmit
bun test # 32 项：semver/profile/upgrade + host 插件路由全链路（fake webServer + pnpm shim）
npm run smoke # fixture 路由全链路 + client.cjs 形态 + 真实 web profile（容错）
依赖安装注意：@deepseek-ai/* 类型包均声明为 devDependencies（peer 冲突时统一对齐到同一 rc 版本，见 package.json）；esbuild 的 postinstall 被 npm 11 拦截时手动 node node_modules/esbuild/install.js。
dsh 自带「Plugin list」（ui-settings-plugin-inventory，Loader 树只读清单）与「Plugin configuration」（ui-settings-plugins，settings namespace 配置编辑器）两个 tab；本面板补的是第三方包维度：版本对比、升级、卸载——三者互补，本包不改动它们。
MIT © 画野 (mtaech)