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（无介入续跑注入）

权限与安全说明

• 审核链审计：每次 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 同）。

文档索引

文档	内容
THREE-PARTY-WALKTHROUGH.md	一次完整三方协作回合走查（七回合：定调→规划→执行→审核→循环→收口→发布，真实案例）
AGENT-CAPABILITY-COMPARISON.md	能力对比：本体系 vs Claude Code（差距/超越/实现多样性，Claude 自述 + 外部 AI 评审）
CC-HYBRID.md	混合架构（cc 派发/降级/验收协议 v1.0/协议化 §6）
OPS-RESTART-RESUME.md	宿主托管与重启续跑 SOP（含无介入续跑实证 §6）
INSTALL-NEW-ENV.md	新环境三步安装（插件/能力包/环境件 + 装后清单）
LINUX-PORT.md	WSL/Linux 移植（兼容矩阵/platform-ops 适配/限制）
capabilities/registry.yaml	能力索引 17 条（verification 自动校验）
main-agent-lessons.json	37 条事故复盘（跨会话避坑）
main-agent-runbook-v0.1.md	主 agent 执行手册（纪律 §2.7 重启/续跑/回合闭环）
dsh-web-relay-说明书.md	完整说明书（面板/协议/操作）

版本历史

版本	协议	内容
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）。