dsh-free-subagents：为 DeepSeek Harness 子代理挑选免费模型的 DSH plugin

它是做什么的？

Free Subagents 是 DeepSeek Harness（DSH）的免费子代理路由插件，为主代理之外的普通子代理和 Agent Teams 挑选已接入的免费额度模型，主代理自身仍使用你选定的模型。它解决的是子任务调用付费模型、额度耗尽后请求直接失败的问题：插件按任务偏好、实测响应时间与可靠性选择路由，配额失败时在输出开始前切换到另一条已批准的路由。由 boldandigital 维护，采用 MIT 协议，语言为 JavaScript。

核心功能

• 免费模型池路由：仅支持 OpenRouter 的 :free 模型、Google 与 NVIDIA，未批准的付费模型不会被当作兜底替换。
• 任务偏好分级：可为 General、Coding、Research、Reasoning、Quick 分别设置 Low、Medium、High 偏好强度，对应路由器排序所用的 0–10 分值。
• 按路由控制推理强度：选择器只列出模型在 DSH 注册表中声明的等级，未声明所选等级的模型会被跳过而不是被调用，避免不支持的等级打断子请求。
• 配额失败自动换路：额度耗尽的路线会被停放并在重启后保持停放，冷却状态在多个进程间共享。
• 隐私友好的路由账本：只记录模型标识、冷却、近似计数与耗时，不含提示词与密钥，默认保存在本地数据目录。

怎么使用这个插件？

先在 DSH 常规的 Models 设置里接入提供方，然后在 Settings → Free Subagents 或 Plugins → Free Subagents 页面选择提供方与模型、确认其免费额度后添加并保存。新安装的插件池默认为空，空池或全部禁用的池会阻止子请求，因此需要先至少添加一条路由。之后子代理通过公开的 agent API 选择 free-auto/auto 即可走免费路由；保存只对后续调用生效，进行中的调用沿用启动时的设置，草稿仅存在于页面本地，离开前需保存。

报错怎么排查？

子请求被阻止时，先检查免费模型池是否为空或所有路由都被禁用，添加并启用至少一条路由即可恢复。若某条路由被跳过，通常是该模型未声明所选的推理等级，改用已声明的等级或选择 Provider default。若保存被拒绝，说明存在冲突编辑，重新加载已保存的设置后再改。额度耗尽的路线会保持停放，需等待冷却结束或调整全局尝试与冷却上限。