DSH Plugin Manager

English | 简体中文

@zaogaogwc/dsh-plugin-manager 是面向 DeepSeek Harness（DSH）Web GUI 的 Mod 风格插件管理器。它把分散的来源包、Loader 实例和 Agent 预设整理为可理解、可预览、可撤销的管理界面。

入口：设置 → 插件 → 插件管理。

本项目管理“是否启用”，不会把“禁用”伪装成“卸载”。插件文件与 npm 依赖不会因禁用而删除。

为什么需要它

当 Web profile 安装多个插件包后，用户通常会遇到三个问题：不知道某个插件来自哪个包、不清楚它当前由 Loader 还是 Cordis 管理，以及为了某项任务临时切换一组插件时容易改错配置。

本管理器使用三级视图解决这些问题：

1. 方案或来源包：官方/用户 Agent 预设与已安装来源包在同一级展示。
2. 功能分类：按文件、终端、规划、Web、设置等用途分组。
3. 插件实例：展示实际 Loader 条目、配置状态、Cordis FiberState 和诊断信息。

例如，example-package/plugin-a 与 example-package/plugin-b 会明确显示为 example-package 的包内成员，而不是两个来源不明的独立插件。

主要能力

插件浏览与来源归属

• 从当前 profile 的 bundle 清单和 bundle patch 还原真实安装来源。
• 展开来源包后查看包信息、功能分类、插件实例和当前状态。
• 官方目录元数据随包发布，不收录用户安装的第三方包信息。
• 第三方说明保留作者原文；AI 分类结果只保存在本机浏览器中。

安全启停

• 单个插件、分类和整包都可以启用或禁用。
• 所有批量操作必须先进入变更预览，再由用户确认。
• 原子写入 ~/.dsh/cordis.patch.yml 的专属 managed 段。
• 保留最近 20 次变更历史，可撤销上一次管理器操作。
• “恢复全部默认状态”只清除本管理器托管的禁用项。
• managed 修复会清理重复或失效条目，同时保留其他工具和用户手写配置。

遵循 Harness 生命周期

管理器不会直接篡改运行中的 Cordis Fiber。确认启停后，它只更新补丁文件，由 DSH 官方 plugin-include watcher 和 Loader 执行热重载。

flowchart LR
  UI[插件管理界面] --> Preview[变更预览]
  Preview --> Confirm[用户确认]
  Confirm --> Patch[原子更新 cordis.patch.yml]
  Patch --> Watcher[官方 include watcher]
  Watcher --> Loader[Loader 生命周期]
  Loader --> Cordis[Cordis FiberState]
  Cordis --> UI