heyiwe1 / dsh-multi-agent-preset

Tri-Model Agent Preset（三模协同）

为 DeepSeek Harness 量身定制的多 agent 协同 preset——方向师定方向、架构师设计方案、执行者落地实现，配以可交互的三模工具栏与一键启动，把"决策 → 设计 → 执行 → 独立复审 → 终审"的完整协同链路变成开箱即用的能力。

✨ 特性一览

• 三角色协同：方向师（目标/优先级/验收，不可代行）+ 架构师（方案设计）+ 执行者（落地实现）；角色热插拔——改 tri-model-config.json 即换模型，角色不绑定模型。
• 完整审阅链：独立复审 → 方向师终审，两级闸门防漏报；应急代行模式、决策门禁、长对话复核、权限与沙箱处理链一应俱全（见 TRI-MODEL-PROTOCOL.md）。
• 可交互按钮：tri-model-ui 在 DSH 对话工具栏提供 ●三模协同 / ⚙设置 / 映射摘要，overlay 设置面板 7 项配置（模型/角色/合并/审阅/澄清/冒泡/安全），实时读写配置文件，4 个后端路由（get-state/set-config/reset-config/build-command）。
• 一键启动：start-dsh.* 拉起 DSH web 服务并自动打开网页（服务端+网页端合一）。
• 随包文档齐全：协议总则、发布说明、核对清单、上传教程、按钮交付文档，开箱可读。

🚀 快速开始

# 1. 复制 preset（或按 README「安装」节手动放）
#    - 用 DSH agentPresets.copy(from, id) 复制到用户根
# 2. 放配置：config/tri-model-config.json → 你的工作区，按需改 roles
# 3. 挂载校验：standingKeyFor('<id>') 应返回 OK
# 4. 新建会话选该 preset，确认工具列表
# 5.（可选）安装按钮 tri-model-ui + 一键启动 start-dsh

🔴 安装后第一件事：读 TRI-MODEL-PROTOCOL.md（协议总则，入口必读）——三角色定义（方向师不可代行）、应急代行边界、顶层决策规则、流程铁律、经验教训。

版本：2026-08-15（发布物 = preset + 按钮组件 + 一键启动 + 协议文件） 状态：#3 MCP 互通、#5 权限意图 真落地（实证）；#1 expected_output 真落地（前会话 config 生效）；#2 能力路由 / #4 变更租约 / #6 备选韧性 为设计草案（enabled=false，未接线，真实需求时按需启用）；并发编排规范见 concurrency-guide.md（先规范后实战） 配套：tri-model-config.json（热插拔配置）+ workflow-template.md（编排模板）+ TRI-MODEL-PROTOCOL.md（协议总则）

目录

README.md                                # 本文件：安装/启动/按钮/风险
RELEASE-NOTES.md                         # 发布说明（版本/包含/已知限制/兼容性）
RELEASE-CHECKLIST.md                     # 发布核对清单
UPLOAD-GUIDE.md                          # GitHub 上传教程（建仓/推送）
TRI-MODEL-PROTOCOL.md                    # 协议总则（副本，canonical 在工作区根）
tri-model-agent-preset/
├── agent.cordis.yml                    # preset 组合（可复制到 .agent-presets/）
├── preset.yml                          # 元数据（name/description）
├── start-dsh.cmd / start-dsh.mjs       # 一键启动：DSH web 服务 + 自动打开网页（服务端+网页端合一）
├── skills/tri-model-coordination/      # 协同协议技能（SKILL.md）
└── config/
    ├── tri-model-config.json           # 热插拔配置（角色/计费/能力路由/变更租约/权限意图）
    ├── workflow-template.md            # 编排脚本模板
    └── TRI-MODEL-PROTOCOL.md           # 协议总则副本（copied from canonical）
tri-model-ui/                           # 三模按钮组件（客户端插件包，见下文"安装三模按钮"）
├── package.json / lib/                 # 按钮包（dock 工具栏 + overlay 设置面板 + 4 路由）
└── TRI-MODEL-UI-MILESTONE.md           # 按钮里程碑交付文档（功能规格/验收记录/复现方法）

暗色模式用 DSH 自带，本项目不提供自定义黑主题。

安装

1. 复制 preset（三选一）：
   • 用 DSH 原生 agentPresets.copy(from, id) 复制到用户根（推荐，自动校验 id、免权限问题）；
   • 或手动把 agent.cordis.yml + preset.yml + skills/ 放进 ${DSH_HOME:-~/.dsh}/.agent-presets/<id>/；
2. 放配置：把 config/tri-model-config.json 放到你的工作区（默认 <工作区>/tri-model-config.json），并按需改 roles 指向你的模型；
3. 放模板：config/workflow-template.md 放同一工作区，供 workflow 编排参考；
4. 挂载校验：standingKeyFor('<id>') 应返回 OK；然后新建会话选该 preset，确认工具列表。

启用

• 新对话选 preset "三模协同"，加载 tri-model-coordination skill；
• 直接给任务，编排层（父 agent）按 tri-model-config.json 路由方向/架构/执行。

一键启动（服务端 + 网页端合一）

双击 start-dsh.cmd（Windows）或运行 node start-dsh.mjs（跨平台）：

1. 若网页已运行 → 直接打开 http://127.0.0.1:3080；
2. 否则后台启动 dsh --profile web（新窗口，最小化），轮询就绪后自动打开网页；
3. 要求：dsh 在 PATH 中；start-dsh.mjs 另支持设 DSH_BIN 指向 node_modules\.bin\dsh.cmd（start-dsh.cmd 仅走 PATH），curl 可用（Win10 自带）。

安装三模按钮（下载者）

为什么按钮不装在 preset 里：DSH 的 preset 是 agent 平面（宿主进程内），浏览器 UI 只能由宿主组合里的 dsh.client 行提供——所以按钮必须以独立客户端插件包 + 一行 patch 的形式分发。这是 2026-08-15 实测确认的架构事实（原"preset client 组件"设想在本架构中不存在）。

patch 行配置

在部署的 profiles/web/cordis.patch.yml 末尾追加：

- insert:
    - id: tri-model-ui
      name: tri-model-ui
      config:
        configPath: tri-model-config.json
        resetBaseline: tri-model-agent-preset/config/tri-model-config.json

其中：

• configPath（可选）：配置文件相对工作区的路径；缺失时读 DSH_TRI_MODEL_CONFIG 环境变量，再缺失用默认工作区 tri-model-config.json。
• resetBaseline（可选）：重置基线文件路径；缺失时读 DSH_TRI_MODEL_RESET_BASELINE 环境变量，再缺失用发布仓内 tri-model-agent-preset/config/tri-model-config.json。

安装步骤

1. 把 tri-model-ui/ 复制进部署的 profiles\node_modules\（或 pnpm add ./tri-model-ui）；要求 Node ≥ 20.17（严格 exports 需要 package.json exports 含 "." 主入口；随包已带，勿手工删改）。
2. 编辑部署的 profiles/web/cordis.patch.yml，按上述 patch 行配置追加。
3. 重启 DSH web → 对话工具栏左侧 dock 区出现"● 三模协同"按钮（显示角色分工）+ 右侧⚙设置按钮。
4. 点击⚙打开设置面板（shell.overlay），包含 7 项：
   • 1. 模型成本（每模型选 cheap/low/medium/high/per-call）
   • 2. 角色分配（方向师/架构师/执行者 各选一个模型）
   • 3. 合并模式（启用后选择 none/architecture+execution/direction+architecture/direction+architecture+execution）
   • 4. 审阅（选 none/low/medium/high）
   • 5. 澄清（启用/禁用）
   • 6. 冒泡（启用/禁用）
   • 7. 安全（git 快照 启用/禁用）
   • 生成命令：点击"生成"输出 tri-model 命令行，可复制到终端执行。
5. 点击"● 三模协同"按钮在输入框填入启动文本；点击"保存"、"重置"分别保存配置或恢复到基线。

配置说明（tri-model-config.json）

节	作用	关键项
roles	角色→模型映射	direction/architecture/execution
models	每模型计费档位	cheap/low/medium/high/per-call
billingPolicy	重试/探测/预算	per-call 0 重试绝不探测
expectedOutput	机械校验契约	advisory 只记录不阻断
review	审阅强度	none/low/medium/high
capabilityRouting	能力路由(#2) ⚠️草案	角色能力画像/任务域/MCP 工具域；enabled=false 未接线
changeManagement	变更租约/仲裁(#4) ⚠️草案	变更域/租约/仲裁优先级；enabled=false 未接线
permissionIntents	权限意图(#5) ✅实证	角色↔permissionPresets 映射；perm_inspect 实测对齐
modelResilience	备选韧性(#6) ⚠️草案	升级链/触发/难度路由；enabled=false 未接线
clarify/bounce	人机交互	启动澄清 / NEED_USER 冒泡
safety/escalation	安全/超时	git 快照/.trash/分层空闲超时

风险与注意

1. 三模协议是会话级，不是全局插件：新建会话必须选 tri-model preset 才会启用三角色协同（方向师/架构师/执行者）；全局按钮（tri-model-ui）≠ 已启用三模协议——未选 preset 的会话点击按钮，AI 没有三角色 persona/协议上下文。此时按钮会引导读取工作区的 TRI-MODEL-PROTOCOL.md 与 tri-model-config.json；若两者都不可用，AI 会报告缺失而非自行模拟三模流程。正确用法：新会话选 tri-model preset（或明确说"用三模协同"），再配合按钮使用。
2. MCP 互通默认禁用：agent.cordis.yml 的 mcp-fs 行 disabled:true——npx 下载即执行会触发 Windows Defender/卡巴斯基启发式报毒（实测 Trojan:Win32/PowhidSubExec.B）。启用请删 disabled: true 并改用本地 vendored server（零下载），否则发布用户可能被杀软拦截。
3. 角色模型与计费可换（热插拔）：direction 当前是 gpt-5.4（high，按 token，非 per-call）；换模型改 roles 即可。计费以 config.models 实际配置为准——"per-call 模型只可做方向/终审"仅适用于配置为 per-call 的模型（如 gemini 系列），不代表方向角色必然 per-call（详见 TRI-MODEL-PROTOCOL.md 计费事实优先级）。
4. 运行验证：MCP 的运行时工具调用证据需在宿主侧/用户终端执行（沙箱内 spawn 受限 EPERM），preset 仅保证组合可挂载。
5. 不信任整个目录：如遇杀软，只按文件级指纹（SHA256/integrity）添加信任，勿整目录加白。
6. EN（English notice）：This project has only been tested in a Chinese-language environment, and the agent prompts / UI copy are in Chinese. If you encounter issues in a non-Chinese locale, please open a GitHub Issue with a detailed reproduction — we will respond and fix. Non-Chinese speakers are welcome to report problems via Issues even if you cannot describe them in Chinese.

演进

• 发布形态：当前为"可复制 agent preset + 独立按钮组件"（最小可行）；后续可 npm 包化（@deepseek-ai/dsh-* 风格 + peerDependencies + README）。
• 按钮缺陷已修复（2026-08-15）：旧按钮是动态插件（不随包分发、重启即丢）；现以 tri-model-ui 客户端包随发布分发，装 patch 行 + 重启后常驻。
• 发布前必须：先跑真实项目验证（本包正处验证中），再 push；一键启动需在 Windows 上实测两路径（已运行 / 未运行→启动→就绪→开页）。
• 按钮为可交互工具栏：conversation.input.dock 的 ●三模协同 / ⚙设置 / 映射摘要 + shell.overlay 设置面板（7 项），配置实时读写 tri-model-config.json（详见"安装三模按钮"节）。

License

MIT（跟随 DSH 生态约定；具体以发布时声明为准）。