Zaogaogwc/dsh-plugin-manager

安装

- 普通启停通常由 watcher 热重载，不需要管理器自行操作 Fiber。
- 已经运行的 Agent 会话保持创建时的能力代际。
- 新建 Agent 预设只影响之后创建的会话。
- npm 包更新涉及 Host 与 Client 代码一致性，完成后明确要求重启 DSH。

### 状态与诊断

界面区分配置、Loader、Cordis 和管理器推导状态，不把不同层级混为一谈。

| 字段 | 含义 |
| --- | --- |
| `availability` | `live`、`configured`、`disposed` 或预设中的 `declared` |
| `configState` | Loader 配置层的 `enabled` 或 `disabled` |
| `fiberState` | Cordis 的 `pending`、`loading`、`active`、`failed`、`disposed`、`unloading` 或 `absent` |
| `status` | 界面主状态，包括运行中、已禁用、未运行和需要重启 |
| `issue` | 依赖缺失、加载失败等独立诊断信息 |

“需要重启”是管理器根据更新状态推导的提示，不会冒充 Cordis 原生状态。

### Mod 启停方案

可以将当前 Web profile 的第三方插件启停状态保存为具名方案，例如“写作”“开发”“极简”。

- 方案只记录启停状态，不复制或删除插件文件。
- 应用方案前仍然显示变更预览。
- 多个方案彼此独立，可更新、应用和删除。
- 损坏的方案存储会停止写入，避免覆盖原数据。

### Agent 预设生成

Agent 预设与 Mod 启停方案是两种不同对象：

| 对象 | 控制范围 | 生效时间 | 存储 |
| --- | --- | --- | --- |
| Mod 启停方案 | 当前 Web profile 的第三方宿主插件 | watcher/Loader 应用补丁后 | 管理器本地状态目录 |
| Agent 预设 | 新 Agent 会话可使用的能力组合 | 此后创建的新会话 | DSH Agent 预设目录 |

创建新预设时，可以选择任意官方预设或用户预设作为基础。差量合并会保留来源预设的专有工具、配置、注释和管理器暂不认识的条目。

### AI 辅助筛选

输入自然语言需求后，AI 可以为第三方插件生成分类或启停建议：

- AI 只返回候选方案，不直接执行。
- 用户必须进入变更预览并再次确认。
- 官方工具分类由随包目录提供，不交给 AI 改写。
- 不会把本机第三方插件信息写入发布包源码。
- AI 服务不可用时，基础浏览、手动启停和方案管理仍可使用。

### 官方工具双语简介

随包提供的官方工具简介包含中文和英文，并订阅 DSH 官方 locale 服务。切换 DSH 语言后，官方简介同步切换；第三方简介保持作者原文，不自动翻译。

### npm 来源包更新

对于从 npm registry 安装的第三方来源包，管理器可以：

1. 使用当前 profile 的 registry 查询最新版本。
2. 显示已安装版本与目标版本。
3. 再次确认后调用 DSH 官方插件更新命令。
4. 更新前备份 profile 依赖清单、锁文件和 managed 状态。
5. 验证安装版本；失败时自动回滚。
6. 若整包原本全部禁用，更新新增的子插件也继续保持禁用。
7. 更新成功后标记“需要重启”，直到新 DSH 进程接管。

本地链接、Git、URL、压缩包、npm 别名和官方包不会误走 registry 一键更新。

## 安全边界

- 官方宿主组件和管理器自身不可在本界面禁用。
- 禁用不会卸载、删除或改写第三方包文件。
- 所有会写文件、调用 AI 或执行更新的 API 都要求 loopback 请求。
- 从 LAN 地址访问 Web UI 时，这些敏感 API 会返回 `403`。
- 更新可能执行目标 npm 包允许的安装脚本，确认框会明确提示风险。
- 管理器只拥有补丁和自身状态文件，不接管 Cordis/Loader 生命周期所有权。

## 环境要求

- Node.js `^22.19.0` 或 `>=24.0.0`
- DeepSeek Harness Web profile
- 与 `package.json` 中 peer dependencies 兼容的 DSH/Cordis 版本
- 构建源码时需要 pnpm 和 tsdown

## 安装

### 从 npm 安装

发布到 npm 后执行：

把 Zaogaogwc/dsh-plugin-manager 加入你的 DSH 配置（web profile）即可启用。