前言¶
在 DeepSeek Harness（DSH）里用子智能体委派任务时，模型往往由宿主授权范围决定，主 Agent 在一次会话里也很难统一约束「这次委派必须用哪条模型路由」。原生 subagent、subagent_fork 等入口在固定策略或自选策略下，若不满足校验还可能直接被拒，排查时又缺少「当时策略是什么、响应实际走了哪条路由」的可对照记录。
dsh-subagent-model-policy（发布包名 @lienze/dsh-subagent-model-policy）针对的是当前会话：管理子智能体的模型选择策略、会话内候选模型池、并发与递归上限，并在委派发生后记录创建时的策略与实际响应证据。插件默认关闭；安装本身不会改动主模型、其他会话的模型选择或宿主侧授权。
这是什么¶
- 定位：DSH 插件，分类为模型推理；维护仓库 ChenMuDX/dsh-subagent-model-policy，当前文档版本
0.3.1（MIT）。 - 宿主要求：DeepSeek Harness
>=0.2.2-rc.1，Node>=24.12.0。 - 范围：仅覆盖当前会话内的策略库、模型池、默认内容与会话限制；不做跨会话共享或项目级默认，也不修改宿主授权、主模型或官方 profile。
社区目录页：skillhub.cn 上的插件条目。目录站为社区站点，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
下面按面板与语义归纳已文档化的能力。
三页面板¶
入口在会话标题栏的「子智能体模型选择策略」按钮，或右侧栏同名页签：
- 选择策略：策略开关、新会话默认、策略池与页内编辑。
- 模型池：勾选候选形成会话池、刷新候选、能力卡展示、会话级并发子智能体数量与最大递归深度。
- 执行洞察：本插件记录的真实创建与响应证据。
策略语义¶
- 固定模型：委派只使用选中的模型；不匹配时报错，不静默替换。
- Agent 自选：从会话池候选子集中选择，委派时需显式填写精确
provider/model与选择依据。 - 旧版「跟随父模型」策略只读保留；另存为固定或 Agent 自选时需显式转换。
- 保存已启用策略后，新内容在下一次主 Agent 发起模型调用时生效；仅保存未开启的策略只更新策略库。关闭策略不删库、不改主模型，也不追溯终止已建子智能体。
模型池与限制¶
模型池只列出宿主当前允许的候选；勾选不会扩大授权，插件不管理 API Key。当前启用策略引用的候选受保护，移除会被拒绝。「刷新候选」会按当时宿主授权清理失效引用，启用中的内容仍受保护。并发与递归为会话公共配置，实际委派同时受宿主上限和本会话限制约束。
Agent 工具¶
| 工具 | 作用 |
|---|---|
subagent_policy |
读取策略、模型说明、注入预览与运行回读 |
delegate_with_policy |
创建本地 fresh/fork 子智能体并返回子会话 id；自选模式必须提供精确 provider/model 与一句选择依据 |
策略保存不会自动创建子任务；是否委派仍由任务与 Agent 决定。
原生入口边界¶
原生 subagent、subagent_fork、workflow、spawn_teammate 的本地创建只做准入校验，不代填或改写模型参数。固定/自选模式下，原生入口不能指定目标模型时可能被拒绝，此时应改用 delegate_with_policy。插件不 monkey-patch 官方工具，也不保证外部后端或非本地创建。
证据语义（执行洞察）¶
assistant/message：从子会话后缀的模型消息读取实际响应路由。request/header：仅表示拟请求路由，不能当作实际响应。pending：尚无证据。
执行洞察保留创建时的策略名，不随之后重命名或删除而改写。
安装与启用¶
在 DeepSeek Harness 的插件管理器中安装下列包说明符（勿凭仓库名自行拼接其他安装命令）：
@lienze/dsh-subagent-model-policy@0.3.1
安装后按当前 Harness 方式重载插件与页面；若使用 CLI 管理 profile，按该版本文档把同一说明符加入对应 profile。包 scope 为 @lienze，插件内存储域与命令前缀沿用历史 lez- 前缀，不影响安装与已保存数据。
卸载：在插件管理器中禁用或移除 bundle；会话策略与执行记录保留在宿主 storageDomain，重新启用后可继续读取。不要手改 profile 生成的 package.json、cordis.patch.yml 或 cordis.yml。
典型用法¶
按 README 推荐的顺序即可完成一次完整设置。
-
安装并启用：在左侧「插件」面板安装并启用
@lienze/dsh-subagent-model-policy@0.3.1，重载插件与页面。 -
确认宿主子智能体授权：在宿主「子智能体」配置中确认最大递归深度、并行上限，以及 Agent 可为子智能体选择的模型范围。本插件只在该范围内选择，不会扩大授权。
-
配置模型池与策略：打开「子智能体模型选择策略」面板（面板内策略开关默认关闭）。在「模型池」页勾选候选并保存；在「选择策略」页新建策略——固定模型从会话池单选，Agent 自选从池内勾选子集并填写选择说明——打开开关后保存。需要新会话自动携带同一策略时，设为「新会话默认」。
-
委派与查看证据：委派仍由任务决定。委派后在「执行洞察」查看创建时的策略与实际响应路由。
自选委派且原生入口被拒时，由 Agent 调用 delegate_with_policy，并显式传入 provider/model 与选择依据。
首次常见问题（摘自文档）¶
- 只保存未开启的策略不生效；启用中策略的新内容等到下一次主 Agent 模型调用才生效。
- 模型池缺模型时，先在宿主侧启用该模型。
- 固定模式下模型不匹配会报错；原生入口不能指定模型时用
delegate_with_policy。 - 删除策略前需先关闭当前启用策略或更改「新会话默认」来源。
适用场景与注意¶
适合：在同一 DSH 会话内需要可重复的子智能体模型路由（固定或池内自选）、需要会话级并发/递归上限与执行证据对照的开发者。
注意：
- 插件在当前 DSH 进程权限下运行；安装前应自行查看 源码与 LICENSE。
- 宿主撤销授权后，已绑定子 Agent 的后续请求由宿主拒绝，插件不静默回退。
- README 注明 AC-12 已在真实
desktop完成交互验收（2026-11-09）；深度/存活超限、完整旧数据迁移等场景仍暂缓，勿将当前版本表述为这些边界的全面实测版。
结尾¶
dsh-subagent-model-policy 把子智能体模型选择收敛到会话作用域：策略库、模型池、限制与执行洞察在同一面板完成，并通过 delegate_with_policy 与原生入口边界说明，减少「委派被拒却看不清路由」的排查成本。
