前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。在构建复杂的智能体协作流程时，用户、主 Agent 和外部 AI 之间的交互往往缺乏标准化的协议，导致状态难以追踪和流程难以固化。dsh-web-relay 插件旨在解决这一协作断层，将三方交互固化为可执行的协议。
插件定位¶
- 名称：
victormshan/dsh-web-relay - 维护者：victormshan
- 核心价值：把「用户 / 主 agent / 外部 AI」的协作固化为可执行协议，并接入 Claude Code 混合审核链与无介入续跑。
核心功能¶
该插件实现了以下核心能力：
- 三方协作协议 v2.0：定义用户定调、外部 AI 规划（含机器可读 steps）、主 agent 执行、五级审核及收口发布的完整流程。
- Step List 状态机：管理
pending/executing/review/approved/rejected状态，支持 DAG 依赖门控、原子打回及重结构。 - 五级审核链：提供从
external到manual的多级审核通道，全程记录reviewedBy。 - 混合架构：通过
D:\cc-tasks（Linux:~/cc-tasks）派发任务给 Claude Code，失败时自动降级回三方链。 - alternatives 裁决：支持多方案打分择优，记录
step.decision及轨迹。 - 无介入续跑：通过
sessionId注入与心跳时间驱动（15min），配合 watchdog 实现自愈托管。 - 能力持久化：提供
lessons、registry、skills等跨会话可检索的能力体系。
安装与启用¶
本包未发布到 npm，安装必须使用 Git 源。
# 安装插件
dsh plugin --profile web add git+https://github.com/victormshan/dsh-web-relay.git
安装后，请重启 DSH Web 服务以加载插件。
自检与验证¶
安装完成后，建议进行自检以确认环境配置正确。
- 运行自检脚本：
node <profile>/node_modules/dsh-apiproxy-shim/test/selftest.mjs
- 检查插件状态：
curl.exe -s "http://127.0.0.1:3080/dsh-web-relay/status?token=<TOKEN>"
关注返回结果中的 `apiProxyAvailable` 字段。
注意事项¶
- 安装即运行：安装第三方插件即运行第三方代码。在安装前，请务必 review 源码及许可证。
- 安全护栏：
review:false不能解除安全护栏。主 agent 的危险命令拦截和越界文件策略为运行时最高硬约束。 - apiProxy 硬注入：
apiProxy服务为硬注入依赖。 - 兼容性限制：4.9.2 及更早版本与 0.1.5+（新线）不兼容。新线已移除
apiProxy服务，若不安装随包的shim，插件将停在pending并导致宿主启动断言失败。
总结¶
dsh-web-relay 通过协议化和状态机机制，解决了 DSH 生态中三方协作的标准化问题。它提供了从规划、执行到审核的全链路支持，适合需要严格流程控制和审计能力的场景。相关文档与源码请查阅其 GitHub 仓库。
