gamelike-plugin-manage

DSH 插件管理器：入口位于 设置 → 插件管理。提供插件树管理、插件安装、插件分组与插件包导出。本项目可以帮你查看、禁用、启用、卸载、更新 DSH 插件，批量安装第三方插件，打包/迁移插件集合，并在禁用或卸载插件时清理其自带的本地 Agent 预设。

面向用户：本文是安装与使用教程。开发者文档见 DEVELOPER.md。

搜索关键词：DSH 插件管理 · DeepSeek Harness plugin manager · 插件安装 · 插件卸载 · 插件更新 · 插件包 · plugin pack · Agent preset 管理 · 插件分组 · 整组启停 · settings plugins · cordis loader · dsh-plugin · tgz

快速上手

1. 先把本插件安装进 DSH（发布包 .tgz、GitHub 地址或本地目录均可，见下方安装方式）。
2. 打开 设置 → 插件管理。
3. 按页签使用：

三个常用流程

• 安装一个插件：插件安装 → 拖入 .tgz（或填路径/地址）→ 等任务显示成功。
• 暂时停用一个插件：管理插件 → 找到该插件 → 禁用，立即生效；再次点击启用即可恢复。
• 把一组插件搬到另一台机器：插件包 → 创建插件包并勾选成员 → 导出 .tgz → 目标机器 插件安装 拖入该包。

功能

分组

• 分组是引用集合（tag）：一个插件可以同时属于多个分组。
• 分组会显示在「管理插件」列表，可一键「整组启用 / 整组禁用」。
• 分组与期望状态（enabled / disabled / as-is）会随插件包导出，并在安装时恢复。
• 同一插件出现在多个选中分组/多个插件包时，导出端只内嵌一份，导入端按身份去重。

安装到 DSH

任选一种：

1. 插件安装 Tab → 拖拽 .tgz：适合安装已导出的插件包。
2. GitHub 地址：输入 https://github.com/<owner>/<repo>（自动 clone + 构建）。
3. npm 指令：输入 npm install <pkg> 或包名（自动 npm pack 后安装）。
4. 本地目录：输入项目目录（含 package.json 与 lib/；若缺少 lib/ 且勾选「允许执行构建脚本」会尝试构建）。

插件包格式（dsh-plugin-pack@2）

导出的 .tgz 解包结构：

<包名>.tgz
├── package.json      # 声明 dsh.pack.format = dsh-plugin-pack@2
├── manifest.yml      # 分组、期望状态、插件清单（name / path / version / sha256）
└── plugins/<包名>/   # 插件目录本体（不含 node_modules / .git）

导入时：

1. 逐成员校验 sha256（内容被篡改直接拒绝）；
2. 吸收进内容寻址 PluginStore（~/.dsh/plugin-store/<name>/<version>-<hash>），同内容交集复用同一实体；
3. 构建包级装配计划（InstallPlan），逐成员裁决；
4. 通过预检的成员写入 profile bundles（立即装配并持久化），任一成员装配失败则本包整体回滚；
5. 分组恢复到「管理插件」；
6. 按分组期望状态为运行中的插件写入待重启状态（重启后生效）。

兼容性：仍可导入 dsh-plugin-pack@1 旧包（无 version/sha256 声明时不校验内容，按包名判断交集）。

交集裁决规则

开发与 API

构建、架构说明、模块职责与 HTTP API 清单见 DEVELOPER.md。

安全策略

• 安装第三方仓库时，不执行其自带的 install.ps1 / install.sh / git hooks。
• 依赖安装使用 npm install --ignore-scripts（不执行生命周期脚本）。
• 默认拒绝执行构建脚本；仅当用户勾选「允许执行构建脚本」后才运行 npm rebuild / npm run build。
• git clone 使用 --depth 1，失败自动清理残留。

免责声明

• 本项目不是 DeepSeek 官方产品，与 DeepSeek 无隶属或背书关系。
• 本软件按「现状」提供，不附带任何明示或默示的保证，包括但不限于适销性、特定用途适用性与不侵权的保证。
• 插件安装/更新、禁用/启用、卸载、重启 DSH、删除本地 Agent 预设等操作会修改 DSH 配置、进程或本地文件；使用前请确认操作内容，并自行备份重要配置与数据。
• 在适用法律允许的最大范围内，作者不对因使用或无法使用本软件而产生的任何直接、间接、附带、特殊或后果性损失承担责任。
• 使用本软件即表示你已知悉并接受上述风险。

License

MIT