dsh-delegation-suite

DeepSeek Harness 智能委派套件：按任务角色给子代理分配最强模型、失败自动互备切换、每个子代理可独立设置思考强度、名字里直接看到用的什么模型——全部可视化配置，不用改文件。

能力一览

能力	说明
角色路由 + 失败互备	delegate_ranked 工具按任务类型从路由表选最强模型；遇到欠费、限流、鉴权失败、传输错误、跑崩，自动换下一个模型继续，并返回完整尝试日志
fork 委派	fork: true 让子代理继承当前对话上下文（追问分析、基于本线程的 review），同时仍然按角色路由模型——不再绑死会话模型
模型透明	每个委派的子代理名字自动带 [provider/model] 角色 委派 标签，子代理树里一眼看清谁在用哪个模型（见下图）
行内思考强度	路由表每行第三列直接配置思考强度（off/low/medium/high/max，留空不指定）——同一个模型在不同角色可以用不同强度
可视化编辑	设置 → 预设工作室：路由表每行 provider/模型/强度三列输入框，↑↓ 调优先级、✕ 删除、＋添加、保存即生效（无需重启）；还能编辑自定义预设的名称/描述/人格
委派策略提示	内置精简策略段，引导主 agent 在合适时机委派、委派后汇报所用模型
图片转写（视觉委派）	纯文本模型收到图片时，自动派 vision 角色子代理把图片完整转写成文字再继续（走路由表 vision 行 + 失败互备）；在插件设置里可关、可指定专用转写模型、可调超时
Token 用量统计	自动记录每个 provider/模型 的 token 消耗（本周/本月/年度），与路由联动——路由表分配了哪些模型、各烧了多少一目了然；数据存本地
余额与配额（plan 用量）	账户余额、各 plan 用量/配额尽力查询：DeepSeek 余额、Kimi Code 计划用量（5小时/周/月/年窗口）、GLM Coding Plan 配额、CodeBuddy 积分（OAuth 登录）、MiMo 本地统计；每 60 秒自动刷新

设计特点

• 失败自动换下一个模型：路由表里列了多个候选，第一个不行（欠费、限流、报错）就自动换第二个，不用你盯着。 — 就像找装修队：第一个师傅说干不了，马上换下一个，不会傻等。
• 委派的孩子记得前面的对话：需要接着当前上下文干活的子代理（追问分析、回顾本线程），也能按角色路由到合适的模型。 — 就像让"老熟人"接手续聊，他记得前面聊到哪，而且还按活儿类型派给最合适的人。
• 路由表可视化编辑：设置页里一张表格，每行选 provider、模型、强度，上下拖动调优先级，增删改存，保存立即生效。 — 就像填表格选人干活，不用碰任何配置文件。
• 同一个模型可以分角色定强度：比如同一个模型干编码用最高强度、干杂活用中等强度。 — 就像同一个师傅：干精细活时慢慢做，干粗活用点心就行，省力气也省时间。
• 子代理名字带模型标签：每个委派的子代理直接显示 [provider/model] 角色 委派，谁在用什么模型一眼看清。 — 就像每个干活的小工都挂着名牌：谁在干、用的什么机器，扫一眼就知道。
• 鼓励主 agent 多把活儿分出去：内置策略提示引导主 agent 优先把独立任务包委派给子代理（而不是自己全干），委派后还自动汇报用了哪个模型。 — 就像主事的养成习惯：能分给合适小工的活就分下去，自己专心盯大局，干完还有人跟你汇报。
• 安装开箱即用：纯 JavaScript、无构建步骤，git 安装不用额外构建授权；也提供预打包 tarball。 — 就像装个软件点"下一步"就行，不用敲命令、不用给额外权限。
• 纯文本模型也能"看"图：主模型看不了图时，自动派一个能看图的子代理把图片内容转成文字，再接着干活。 — 就像你眼神不好，身边有个"看图员"把图里的字和内容念给你听。
• 用量自动记账：每个模型用了多少 token（输入/输出/缓存/推理）自动记录，按周/月/会话查看。 — 就像每个小工干了多少活都有记账本，月底一翻就知道谁干得多、钱花在哪。

截图

委派路由编辑器（设置 → 预设工作室）——每行 = 角色下的模型优先级，第三列是思考强度，保存后即时生效：

子代理树模型透明——每个委派的子代理带 [provider/model] 角色 委派 标签，状态、token 消耗、耗时一目了然：

工具使用指南

概述

委派（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 角色子代理独立审核（自动用不同模型）

多步编排：与 DSH 原生能力配合

…