victormshan/dsh-web-relay

dsh-web-relay

DeepSeek Harness（dsh）三方协作协议插件 —— 把「用户 / 主 agent / 外部 AI」的协作固化为可执行协议，并接入 Claude Code 混合审核链与无介入续跑。

Awesome DSH Plugin

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-.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=" → 看 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 同）。

文档索引

| 文档 | 内容 |
|---|---|
| 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 适配/限制）|
| COMPATIBILITY.md | 可用 dsh 版本兼容矩阵（升级 dsh 前必读：apiProxy 硬注入约束 / 新线不兼容症状 / 自检命令）|
| shim/README.md | 新线（dsh 0.1.5+）适配 shim：apiProxy → sessionController.prompt 桥接，安装与自检 |
| 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.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）。