dsh-plugin-help

dsh-plugin-help

DSH 已安装插件操作说明汇总：右下角一个常驻「📖」小按钮，随时一键查看所有已安装（非核心）插件的操作说明。

功能

• 点右下角「📖」按钮 → 弹出汇总面板，默认全部展开每个插件的完整 README。
• 面板顶部：全部收起/展开 切换、「刷新」重新拉取、「关闭」收起；点遮罩也可收起。
• 每个插件条目带蓝底白字圆圈序号（仿对话框发送按钮样式），显示中文标题（中文 README 优先，包名小字跟随）、版本、描述。
• 每个条目带**「更新」按钮**：一键执行 dsh plugin --profile web update <name> 更新该插件到最新版本，就地显示结果（更新后需重启 dsh web 生效）。
• 汇总只包含非核心插件（排除 @deepseek-ai/ 系统包与 cordis: 内置条目），避免核心包刷屏。

端点

方法	路径	说明
GET	/plugins/dsh-plugin-help/summary	{ plugins: [{ name, version, description, zhTitle, readme, error? }], generatedAt }
POST	/plugins/dsh-plugin-help/update	body { name }，执行 dsh plugin update，返回 { ok, code, output }

仅接受环回地址（127.0.0.1 / localhost）的同源请求；update 端点对包名做白名单校验，防止命令注入。

安装

dsh plugin --profile web add link:D:/dsh-plugin-help

或将本目录链接到 profile 的 node_modules 并在 cordis.patch.yml 插入一行：

- insert:
    - id: dsh-plugin-help
      name: dsh-plugin-help

重启 DSH 后生效；修改 lib/client.js（浏览器端）只需强制刷新页面，修改 lib/index.js（服务端）需重启。

服务端 update 端点默认调用 D:\DeepSeek Harness\node_modules\@deepseek-ai\dsh\lib\bin.js（部署事实），可用环境变量 DSH_PLUGIN_HELP_DSH_BIN 覆盖；profile 名可用 DSH_PLUGIN_HELP_PROFILE 覆盖（默认 web）。

开发

pnpm install
pnpm run build   # tsc → lib/

浏览器端 lib/client.js 手写维护（无打包器），语法校验：node --check lib/client.js。

License

MIT