dsh-web-relay
DeepSeek Harness (dsh) 三方协作协议插件 —— 把「用户 / 主 agent / 外部 AI」的协作固化为可执行协议，并接入 Claude Code 混合审核链与无介入续跑。
English intro: a protocol-driven collaboration layer for DeepSeek Harness — three-party coordination (user / main agent / external AI), a machine-readable Step List state machine, a five-tier review chain (external → web-gemini → claude-code → dialog → manual), alternatives adjudication, cross-restart resume with heartbeat, and a capability-persistence system.
功能简介与能力矩阵
| 能力 | 说明 |
|---|
| 三方协作协议 v2.0 | 用户定调 → 外部 AI 规划（json:agent-action + 机器可读 steps）→ 主 agent 带证据执行 → 五级通道审核 → 收口发布 |
| Step List 状态机 | pending/executing/review/approved/rejected + DAG 依赖门控 + importance 分工 + 原子打回 + restructure + AutoIteration 版间门 |
| 五级审核链 | external(Gemini) → web-gemini → claude-code(本地 Claude Code) → dialog → manual；reviewedBy 全程审计；Swarm 双角色盲审可叠加 |
| 混合架构 | 经 D:\cc-tasks（Linux: ~/cc-tasks）派发 Claude Code（implement/review/understand），失败自动降级回三方链 |
| alternatives 裁决 | 多方案打分择优 → step.decision + 轨迹（6 段模板） |
| 无介入续跑 | 重启事件驱动（sessionId 注入）+ 心跳时间驱动（15min）双保险，watchdog 自愈托管（Windows 计划任务 / Linux systemd） |
| 能力持久化 | lessons 37 / registry 17 / skills 3 / runbook——跨会话可检索，裸会话 skill 加载 |
| 协议版本 | v1.5→v2.0 全量（面板可选），外部 AI 每次调用注入协议语境 |
安装
插件（dsh web profile）
# 从 Git 源（推荐，本仓库即源）
dsh plugin --profile web add git+https://github.com/victormshan/dsh-web-relay.git
# 或发布 npm 后
dsh plugin --profile web add dsh-web-relay
# 离线：复制 lib/bin/package/cordis.patch.yml 到 profile node_modules + cordis.patch.yml 追加插件行（或 scripts/install-new-env.ps1/.sh）
安装后重启 dsh web（Host half 启动加载；仅改 client.js 走浏览器 HMR 热更）。
能力包（主 agent 语境能力：docs/skills/lessons）
# 解压 dist/dsh-relay-capability-pack-<ver>.tar.gz → docs/skills/scripts 参照 + skills 同步 ~/.dsh/skills
# 或一键：scripts/install-new-env.ps1 -CapabilityPack dist/….tar.gz（Windows）/ install-new-env.sh -c …（Linux）
宿主托管与 env（可选但推荐）
- watchdog：Windows 计划任务 / Linux systemd（scripts/install-new-env.* 自动注册）
- env：
DSH_RELAY_REPO（装配指针）/ DSH_CC_TASKS_ROOT（cc 派发目录）/ GEMINI_API_KEY（Linux 写 ~/.dsh/env，Windows 注册表）/ DSH_SESSION_ID（无介入续跑注入）
兼容的 dsh 版本
单一事实来源：docs/COMPATIBILITY.md（升级 dsh 前先看这里）。
| 本插件版本 | 可用 dsh 版本 | 依赖 |
|---|
| 4.9.7（新线兼容版） | 0.1.0-rc.7 线 与 0.1.5+（新线） | rc.7：宿主自带 apiProxy；新线：需随包 shim/dsh-apiproxy-shim。两者均需 webServer / fs / sandboxPolicy / agentDefaultModel |
| 4.9.2（dsh 升级前的最后一版） | 0.1.0-rc.7 线 | 硬依赖 apiProxy 服务（rc.7 由 @deepseek-ai/dsh-host-apiproxy 提供） |
⚠ 4.9.2 及更早版本与 0.1.5+（新线）不兼容：新线已移除 apiProxy 服务，dsh-web-relay / dsh-side-window 会停在 pending (waiting for service: apiProxy)，使 dsh web 以
Error: dsh: 2 entries did not activate 启动失败（2026-09-13 实测）。两条出路：① 装随包 shim（见 shim/README.md）；② 应急在 profile 的 cordis.patch.yml 里注释掉这两行 insert 停用插件（宿主可起，/dsh-web-relay/* 返回 404）。
自检：curl.exe -s "http://127.0.0.1:3080/dsh-web-relay/status?token=<TOKEN>" → 看 apiProxyAvailable。
权限与安全说明
- 审核链审计：每次 approved/rejected 记录
reviewedBy / providerLabel / fallbackReason / channel（frontmatter + steps notes），全程可溯源。
- 命令护栏：主 agent 危险命令拦截、越界文件策略为运行时最高硬约束（协议 v1.8.1）；
review:false 不能解除安全护栏。
- 混合架构边界：Claude Code 经
acceptEdits + allowedTools(Read,Write,Bash) 白名单执行，acceptEdits ≠ 免批命令（权限分离）；runner 失败检测 + 主 agent 降级链兜底。
- 沙盒：complete 触发 L1/L2 影子门禁（源码语法预检 / worktree 隔离校验）。
- 安装第三方插件即运行第三方代码——review 源码后再装（社区 disclaimer 同）。
文档索引
版本历史
| 版本 | 协议 | 内容 |
|---|
| 4.9.7 | v2.0 | dsh 版本线兼容声明 + 新线适配：dsh.compat 元数据（rc.7 原生 / 0.1.5+ 需 shim）、随包 shim/dsh-apiproxy-shim（apiProxy → sessionController.prompt 桥接）、docs/COMPATIBILITY.md 兼容矩阵与自检、test/compat-metadata.test.js 回归；shim v0.2.0 修复：直连服务须自补 typert gateway 的尾参 signal（修面板「唤醒主 Agent」报 throwIfAborted），含 test/apiproxy-shim.test.js 回归；watchdog bridgeRestartTimes 回归修复；lesson 057–059 |
| 4.9.2 | v2.0 | 混合架构前端入口（claude-code 面板选项）、心跳双保险、无介入续跑实证、新环境可迁移（files/dist/INSTALL）、WSL/Linux 移植（platform-ops/install.sh）、能力对比与走查文档 |
| 4.9.1 | v2.0 | tailClip 审核上下文修复、kill-host 工具化、skill §5 重启/续跑纪律、lessons 035/036/037 |
| 4.9.0 | v2.0 | 协议演进四方向：claude-code 降级链 + alternatives 裁决 + 并发审核批（外部 AI 排位 C→A→B→D） |
| 4.8.0 | v1.9 | 能力持久化 4 条建议（skills frontmatter/装配 env/能力包导出/SKILL 导引） |
| … | | （更早见 git 历史） |
贡献与社区
- 本插件收录于 awesome-dsh-plugin（
data/plugins/victormshan__dsh-web-relay.yml）、dsh-market、dsh-find-plugin。
- 问题/建议：本仓库 Issues（或 awesome-dsh-plugin 插件页 Discussions 评论区）。
- 开发：协议/审核/混合架构演进按本仓库 docs 体系（先读 THREE-PARTY-WALKTHROUGH + CC-HYBRID + runbook §2.7）。
