前言¶
DeepSeek Harness（DSH）开发者常面临多环境管理的难题：官方运行时、团队定制运行时、开发 Fork 以及不同 Agent Preset 往往混杂在一起，导致配置文件和会话数据难以区分，容易产生环境混淆。dsh-control-plane 是为此设计的本地优先开发者控制平面。
这是什么¶
这是一个由 Harzva 维护的插件，旨在为 DSH 提供一个稳定的核心，用于组合、检查和管理多个运行时、配置、会话和知识引用。它并不替代 DSH 本身，而是提供一个控制平面核心和一个版本化的 DSH Bundle，可以在 DSH 内部呈现这个控制平面。
核心功能¶
下面介绍该插件的主要能力：
- 多运行时注册与管理：支持注册官方、定制、开发和自定义 DSH 运行时。
- 安全检查：可以在不复制私有配置的情况下检查 Profile 和 Preset 引用。
- 运行时操作：通过允许列表的适配器，对运行时进行启动、停止和健康检查。
- 会话关联：将 Sessions 连接到计划、工件和知识引用。
- 集成面板：提供加法式的 DSH Host/Client 集成面板。
- Web 可视化：在 DSH Web 中显示只读的 Runtime Catalog、Session Board、Plan Panel、Artifact Board 和 Knowledge Reference 投影。
- 场景适配器：使用和扩展可替换的场景适配器，包括一个 interview-learning 示例。
- 发布前验证：在发布前，使用隔离的 DSH Profile 验证发布版本。
架构与集成¶
当前该插件的开发目标是 DSH 0.1.0-rc.8。根包提供一个 dsh.bundle 补丁层、一个严格的 ./typert Host 清单和一个预置的 ./client Bundle。内部源模块被组合成这个可安装的包，确保 tarball 不依赖同级的 file: 包。Web 面板使用加法式设置插槽和本地失败边界。
需要明确的是：
* Web 面板是只读投影。
* 运行时启动/停止和健康检查的行为保留在源 Runtime Manager API 中。
* Stage 4 桥接仅解析有界元数据和不可变引用，它不读取或上传文档内容。
开发与构建¶
该仓库已完成 Stage 7，发布了第一个公共版本 v0.1.0。如果你需要构建或验证候选版本，可以使用以下命令：
pnpm install --frozen-lockfile
pnpm run build:dsh
pnpm run check
pnpm run pack:dsh
pnpm run verify:release-candidate
安全与内容¶
这是一个公开仓库，包含了公共模式、适配器、示例、测试和文档。它不包含凭据、原始聊天、真实会话、私有知识、私有机器路径或生产 DSH 配置。
- 机器本地值应放在被忽略的
agentworkos.local.toml中。 - 公共示例使用占位符和合成标识符。
注意事项¶
- 环境限制：开发人员应使用隔离的 DSH Profile 进行运行时检查，不要将此目录或本地配置的 Profile 安装到生产工作区中。
- 提交状态：目前提交到
awesome-dsh-plugin是下一个阶段，尚未声明已被合并或接受。
结尾¶
dsh-control-plane 为 DSH 开发者提供了一种在本地管理多环境、多配置的解耦方案，通过只读投影和隔离验证，降低了环境管理的复杂度和风险。
