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、timer 和 tool-web 等 Loader 配置名称，不显示导入模块名。组开关只操作可修改条目并跳过受保护基础设施：绿色表示全部启用，黄色表示部分启用。

开发与路线图

pnpm install
pnpm run typecheck
pnpm test
pnpm run build
pnpm run pack:check

发布

推送 vX.Y.Z 标签后，.github/workflows/publish.yml 会执行发布。工作流先校验标签与 package.json 中的版本一致，再运行测试、类型检查和构建，最后通过 GitHub OIDC 与 npm 可信发布完成发布，不保存长期 NPM_TOKEN。

使用工作流前，需要在 npm 软件包的可信发布者设置中填写：GitHub 所有者 hrhgit、仓库 deepseek-harness-plugin-manager、工作流文件名 publish.yml，环境留空，允许的操作只勾选 npm publish。npm 只在已存在的软件包设置中提供此入口，因此首次 0.1.0 发布仍需使用一个有权发布此包、且启用“绕过双重身份验证”的细粒度访问令牌。首次发布后应立即配置可信发布并撤销该引导令牌。

后续每次发布只需更新并提交版本，然后推送提交及标签：

npm version patch
git push origin main --follow-tags

后续计划包括 npm 插件安装、删除和升级，展示真实 dsh.bundle 来源与兼容性，从 npm、GitHub 或专用索引发现社区插件，以及导入导出插件集合。

建议 GitHub Topics：deepseek-harness、dsh、cordis、plugin-manager、plugin-management、web-ui、deepseek、typescript。

许可证

MIT