DeepSeek Harness (DSH) 的生态以插件化为核心，允许用户灵活扩展智能体的能力。dsh-delegation-suite 是一款由 wenheguo2 维护的插件，专注于解决智能体开发中的任务委派问题。它提供了一套基于角色的路由机制，能够自动将任务分配给最合适的模型，并在模型失败时自动切换，同时支持上下文继承、可视化配置以及详细的 Token 与余额监控。
核心功能¶
该插件主要包含以下能力：
- 角色路由 + 失败互备：通过
delegate_ranked工具，系统根据任务角色从路由表中选择模型。如果首选模型失败（如欠费、限流、网络错误），系统会自动尝试列表中的下一个模型，并返回完整的尝试日志。 - Fork 委派：通过设置
fork: true，子代理可以继承当前对话的上下文。这使得子代理能够继续之前的对话、进行追问分析或基于本线程进行审查，同时仍然遵循角色路由规则。 - 模型透明：每个被委派的子代理在名称中会自动带上
[provider/model] 角色 委派的标签。在子代理树中，可以直观地看到每个子代理所使用的具体模型。 - 行内思考强度：在路由表配置中，每行第三列可指定思考强度（off/low/medium/high/max）。这意味着同一个模型可以针对不同角色配置不同的推理深度。
- 可视化编辑：插件内置了 Web GUI（设置 → 预设工作室），允许用户通过表格形式编辑路由表、预设和人格。修改后保存即时生效，无需重启。
- 委派策略提示：内置了精简的策略段，用于引导主代理在合适的时机进行委派，并在委派后汇报所使用的模型。
- 图片转写（视觉委派）：当纯文本模型收到图片时，插件会自动派发一个
vision角色的子代理将图片转写成文字，再由主模型继续处理。在插件设置中可以关闭此功能、指定专用模型或调整超时时间。 - Token 用量统计：自动记录每个 provider/模型的 Token 消耗（本周、本月、年度），并与路由配置联动，数据保存在本地。
- 余额与配额查询：支持自动刷新 DeepSeek、Kimi、GLM、CodeBuddy 等平台的余额和配额（如 Kimi Code 计划用量、GLM Coding Plan 配额）。
安装¶
推荐使用预构建的 tarball 安装，以避免构建授权问题：
dsh plugin --profile web add https://github.com/wenheguo2/dsh-delegation-suite/releases/download/v1.0.0/dsh-delegation-suite-1.0.0.tgz
安装前请检查 profiles/web/cordis.patch.yml 文件。如果其中已存在 delegation-ranker、policy-hint 或 preset-studio 等同名工具或服务行，请先删除这些行，以避免冲突。
基本用法¶
1. 使用委派工具¶
主代理调用 delegate_ranked 工具时，指定任务对应的角色。系统会根据该角色在路由表中的配置，按优先级选择模型启动子代理。
常用角色包括：
* frontend：前端、UI、CSS、TS 开发
* backend：后端逻辑、API、基础设施
* reasoning：复杂分析、推理、架构设计
* review：独立代码审查
* adversary：挑刺、红队测试
* vision：图像理解
* bulk：批量、机械性文件编辑
* analysis：大仓库/文档审查
* general：通用默认
2. 继承上下文¶
若子代理需要基于当前对话继续工作，在调用 delegate_ranked 时添加 fork: true 参数：
{
"role": "review",
"prompt": "请审查上面的代码变更。",
"fork": true
}
3. 配置思考强度¶
在路由表配置中，第三列（effort）可以设置思考强度。例如，让 reasoning 角色使用 max 强度，而 bulk 角色使用 off 强度以提速。
路由配置¶
路由配置文件默认位于 $DSH_HOME/data/dsh-delegation-suite/routes.json（首次运行自动生成）。每行格式为 [provider, model, effort]，列表顺序代表模型优先级。
可以在 Web GUI 的「预设工作室」中可视化编辑此文件，修改后保存即生效。
示例配置：
{
"reasoning": [
["kimi-coding", "k3-256k", "max"],
["zai-coding-cn", "glm-5.3", "max"],
["deepseek-official", "deepseek-v4-flash", "high"]
],
"frontend": [
["deepseek-official", "deepseek-v4-flash", "high"]
]
}
图片转写配置¶
要让纯文本模型能处理图片，需确保路由表中的 vision 角色配置了支持图像输入的模型。
- 在「设置 → 模型」中添加一个支持图像的模型。
- 在「设置 → 预设工作室 → 委派路由」中，给
vision角色添加一行[provider, model]。 - 保存路由表。
若需关闭自动转写或指定专用模型，可在插件设置中调整 transcribeEnabled、transcribeModel 或 transcribeTimeoutMs。
数据统计与余额¶
- Token 统计：进入「设置 → Token 统计」查看。支持按周/月/年查看每个模型/Provider 的消耗情况，支持一键清零。
- 余额查询：进入「设置 → 余额与配额」，系统每 60 秒自动刷新。支持查看 DeepSeek 余额、Kimi Code 计划、GLM Coding Plan、CodeBuddy 积分等。
适用场景与注意¶
该插件适合需要精细控制模型分配、需要多模型并行处理任务或需要监控成本的场景。它以当前 DSH 进程的权限运行，请确保安装前已阅读源码并确认许可证（MIT）。
注意事项：
* 第三方/私有网关可能不完全透传 reasoning_effort 或 thinking 参数，导致思考强度设置无效。
* 部分网关（如腾讯 CodeBuddy）可能忽略 thinking 参数或拒绝 developer role，需根据具体网关行为调整。
结语¶
dsh-delegation-suite 通过可视化的路由配置和自动化的容错机制，降低了 DSH 智能体开发的复杂度。开发者可以更专注于业务逻辑，而将模型选择、上下文继承和成本监控交给插件处理。
