前言¶
DeepSeek Harness (DSH) 的设计理念是「一切皆插件」。dsh-prime-orchestrator 旨在解决在 DSH 代理内部编排 Prime Agent 会话的需求。它将一个 DSH 代理转变为一个委托引擎，提供了从主机端到模型端的全套接口，使智能体能够管理目标、监控会话、协调子代理并控制队列。
插件概览¶
该插件由 mrme000m 维护，遵循 MIT 许可证。它作为一个单一的安装包，将 Prime Agent 的核心能力集成到 DSH 生态中，包括主机引擎、模型端工具、Web UI 集成以及一个完整的编排代理预设。
核心能力¶
主机引擎¶
插件在主机端提供以下核心组件：
* 共享委托表：用于管理跨会话的委托状态。
* 上下文接口：提供 ctx.prime 上下文对象。
* 通信层：包含协议-7 守护进程套接字客户端和 /prime JSON API。
* 配置命名空间：提供 prime-orchestrator 设置命名空间。
模型端接口¶
模型通过 prime_agent 工具与编排层交互，支持以下操作：
* 会话管理：委托、监控、引导、协调、管理目标、心跳和记录。
* 子代理控制：读取记录、检查和管理递归子代理。
* 会话控制：在会话中途切换模型、控制队列和递归深度、分叉分支以及导出记录。
Web UI 集成¶
插件为 DSH Web 界面增加了以下功能：
* Prime 舰队列：位于 Web GUI 右侧（可在侧边栏底部切换），显示实时委托/会话/事件流。
* 设置区域：Settings → Prime Orchestration 区域，用于配置引擎参数。
* 待处理问题横幅：浏览器端的 shell.overlay 组件。
代理预设与工具¶
- 代理预设：
prime-orchestrator，派生自standard，包含完整的编码能力和编排接口。 - Cloudflare Workers AI 工具：提供
cf_ai_run（运行模型）和cf_ai_models（列出模型）工具。
安装与启用¶
前置条件¶
在安装前，请确保以下工具已安装在系统 PATH 中：
* dsh CLI：@deepseek-ai/dsh
* prime-agent CLI：pip install prime-agent
安装命令¶
通过 npm 安装插件：
dsh plugin --profile web add dsh-prime-orchestrator
启用与使用¶
安装完成后，可以在 Web 界面中创建一个会话，并选择 prime-orchestrator 预设。或者，也可以通过 Settings → Agent presets 将其设置为默认代理。
插件会在启动时将预设文件具象化到 $DSH_HOME/.agent-presets/prime-orchestrator/ 目录。
兼容性与注意事项¶
版本兼容性¶
该插件仅兼容以下 DSH 版本：
* 0.1.0-rc.7
* 0.1.1-rc.2
* 0.1.1-rc.2 (npm latest)
对于 0.1.2-alpha 版本，由于客户端插件 API 变更，目前不兼容。
布局限制¶
DSH 的默认布局只有三列 Shell。dsh-prime-orchestrator 需要通过插件自带的 layout-override.js 逻辑来添加第四个名为 prime 的 Shell 列。这是通过重写引导 manifest 中的入口 URL 实现的，不会修改主机文件系统中的任何文件。
二进制输出处理¶
通过该插件调用 Cloudflare Workers AI 等接口产生的二进制输出（如图像、音频），会被写入文件而非原始字节流。例如，cf_ai_run 的二进制结果会保存为 <model-slug>-<timestamp>.<ext> 文件，并返回文件路径供模型引用。
卸载¶
卸载插件会自动恢复 DSH 的默认三列 Shell 布局。
