dsh-delegation-suite

工具使用指南

概述

委派（Delegation）允许主代理将复杂的、可并行的或需要特定专业能力的任务，分派给不同模型和角色的「子代理」执行。子代理根据「角色」和路由配置，自动选择最合适的模型完成工作。

基于角色的委派

主代理在 delegate_ranked 工具调用中指定一个「角色」，系统按该角色在路由表中定义的模型优先级列表，自动选择最强模型启动子代理；首选模型失败则按列表顺序换下一个。

角色定义：

角色	适用场景
frontend	前端、UI、CSS、TS 开发
backend	后端逻辑、API、基础设施
reasoning	复杂分析、推理、架构设计
review	独立代码审查（与编码者不同模型）
adversary	挑刺、红队测试
vision	图像理解
bulk	批量、机械性文件编辑
analysis	大仓库/文档审查
general	通用默认

路由配置（routes.json）

• 文件位置：$DSH_HOME/data/dsh-delegation-suite/routes.json（首次运行自动生成默认表）
• 格式：每个角色一个列表，每行 [provider, model, effort]（第三列可选：off/low/medium/high/max，留空不指定）；列表顺序 = 模型优先级（从上到下递减）
• 生效：Web GUI「预设工作室」可视化编辑或直接改 JSON，修改后即时生效，无需重启

{
  "frontend": [
    ["kimi-coding", "k3-256k", "max"],
    ["zai-coding-cn", "glm-5.3", "max"],
    ["deepseek-official", "deepseek-v4-flash", "high"]
  ],
  "backend": [
    ["zai-coding-cn", "glm-5.3", "max"],
    ["deepseek-official", "deepseek-v4-flash", "high"]
  ]
}

子代理执行与监控

子代理面板实时显示所有已启动子代理：状态（运行中/已完成）、[provider/model] 角色 委派 标签、token 消耗、耗时、任务摘要。

最佳实践

1. 匹配角色：按任务性质（编码/审查/分析/批量修改）选对角色，确保调用最合适的模型
2. 配置优先级：把最强最稳的模型放对应角色列表顶部
3. 思考强度分级：深度推理任务（reasoning）用 max；简单机械任务（bulk）用 off 或留空提速
4. 监控状态：用子代理面板盯进度和消耗，及时发现异常（耗时过长/报错）
5. 独立审查：重要代码改动完成后，用 review 角色子代理独立审核（自动用不同模型）

路由配置（routes.json）

• 文件位置：$DSH_HOME/data/dsh-delegation-suite/routes.json（首次运行自动生成默认表）
• 格式：每个角色一个列表，每行 [provider, model, effort]（第三列可选：off/low/medium/high/max，留空不指定）；列表顺序 = 模型优先级（从上到下递减）
• 生效：Web GUI「预设工作室」可视化编辑或直接改 JSON，修改后即时生效，无需重启

{
  "frontend": [
    ["kimi-coding", "k3-256k", "max"],
    ["zai-coding-cn", "glm-5.3", "max"],
    ["deepseek-official", "deepseek-v4-flash", "high"]
  ],
  "backend": [
    ["zai-coding-cn", "glm-5.3", "max"],
    ["deepseek-official", "deepseek-v4-flash", "high"]
  ]
}