DeepSeek Harness 插件管理器

English

DeepSeek Harness Plugin Manager 是面向 DeepSeek Harness（DSH）及其 Cordis 插件运行时的 Web 插件管理工具。它在 Harness 的“插件”设置页中提供查看、搜索、启用、停用、折叠分组和批量管理能力。

这是社区项目，不是 DeepSeek Harness 官方软件包。

功能

• 查看当前 Cordis Loader 条目与生命周期状态。
• 启用或停用单个插件，不删除其 npm 软件包。
• 展开 Harness 官方工作区分组，批量启停组内可修改条目，或按配置名称操作单个 Loader 条目。
• 把目标状态持久化到当前 profile 的 cordis.patch.yml，重启后仍然生效。
• 保护管理器自身及 Web 管理界面的基础插件，避免意外关闭恢复入口。
• 复用 Harness 现有的受信任 Host 策略，不额外开放服务器端口。
• 提供简体中文和英文界面。

安装

dsh plugin --profile web add dsh-plugin-manager
dsh --profile web

进入“设置 -> 插件 -> 插件列表”。管理器会替代 Harness 原有的只读列表，在保留运行状态信息的同时加入分类、搜索和启停控制。移除软件包使用：

dsh plugin --profile web remove dsh-plugin-manager

本地源码或 tarball 安装：

pnpm install
pnpm run build
pnpm pack
dsh plugin --profile web add ./dsh-plugin-manager-0.1.0.tgz

Git 安装会运行 prepare，pnpm 10 及更高版本要求用户明确授权构建脚本。npm 正式包和 tarball 已包含 lib/，不需要安装时构建权限。

行为与安全

界面中的“停用”表示持久化 disabled: true 并请求 Cordis 停止已配置的插件，不是卸载 npm 依赖。普通叶子插件会在其生命周期允许时于当前进程即时切换；如果状态已经保存、但在期限内没有完成切换，界面会提示需要重启当前 profile，而不会把已保存的变更当作失败。管理器只维护带自身标记的 patch 行，不改写用户已有行；本地条目 id 存在歧义时会拒绝操作。

默认保护管理器自身、API 网关、Web 服务器、客户端运行时、设置外壳、客户端模块加载器、HMR 桥和 Host runner。可在管理器配置中补充部署自己的基础条目：

- id: dsh-plugin-manager
  name: dsh-plugin-manager
  config:
    protectedEntries: [my-auth-provider]
    settleTimeoutMs: 8000

Web API 沿用 Harness 连接层的受信任 Host 判定。能够使用受信任 Web 控制面的访问者也能启停插件，因此不要把 Harness Web 服务暴露给不可信网络。

管理器默认保护自身条目及其 Loader 祖先、根 Include、配置 HMR 服务，以及远程接口、Web 服务、客户端运行时、设置页、模块加载、连接和语言服务。这些条目维持配置刷新和管理页面本身，不能从该页面安全停用。

分类与条目名称

官方和第三方软件包使用同一套开放的功能分组规则。插件可以在 package.json 中声明 dsh.pluginManager.group，不同发布者声明相同组 ID 时会进入同一组。未声明时，任何仓库都可以用 repository.directory 的 packages// 形式提供尽力而为的回退；元数据缺失或不合法时进入“未分组”。组 ID 只允许小写字母、数字、点、下划线和连字符。丰富的 dsh-plugin.json 独立清单与详情页明确留到后续版本设计。

{
  "dsh": {
    "pluginManager": {
      "group": "llm"
    }
  }
}

分组默认收起，展开后直接显示 include、 和 等 Loader 配置名称，不显示导入模块名。组开关只操作可修改条目并跳过受保护基础设施：绿色表示全部启用，黄色表示部分启用。