前言¶
在 DeepSeek Harness（DSH）里启用子智能体（Subagent）后，你可以在官方 Subagent 设置里授权一组 provider/model 路由，主智能体还能通过 list_subagent_models 发现这些选项。但授权列表里通常只有提供商和模型名，没有「什么时候该选哪一个」的说明；对 pi-ai 等来源，模型目录里也不带描述。主智能体在委派任务时，往往只能对着一串路由 ID 猜。
社区插件 dsh-subagent-model-notes（维护者 097794，分类：工作流）补的是这一层：在官方 Subagent 设置页旁边增加 Subagent model notes 页面，为每个可授权模型写一条可编辑说明，并在组装系统提示词时，把当前 Session 实际可选路由对应的说明，注入到委派方智能体的 system prompt 里（紧接在 subagent 工具指引之后），方便按你的规划选子模型。
这是什么¶
dsh-subagent-model-notes 是 DSH 的 profile bundle 插件（版本 0.1.0，MIT 许可证）。它不改动官方 Subagent 白名单，也不调用模型或改路由；说明只是给主智能体的指引，真正的允许列表仍由 @deepseek-ai/dsh-tool-subagent 与 Subagent 设置 enforce。
- 目录页：https://www.skillhub.cn/plugins/097794/dsh-subagent-model-notes
- 源码：https://github.com/097794/dsh-subagent-model-notes
核心功能¶
下面介绍插件在资料中明确描述的能力。
-
设置页：在 Settings → Plugins → Built-in plugin settings 中，位于官方 Subagent 条目下方，出现 Subagent model notes（
order: 11）。页面通过ctx.configForms读写 volatile 配置项notes，并拉取 live 模型目录与subagent-model-selection-settings白名单，列表与当前 Session 可选范围对齐。 -
逐模型备注：每个可能被选的模型对应一行可编辑 note，保存后写入 bundle 配置。
-
System prompt 注入：Host 侧监听
system-prompt/assemblewaterfall；读取 Session 投影subagentModelSelectionPolicy（无 policy 则插件不做任何事）。只保留 policy 里出现的路由所对应的 note，在描述含list_subagent_models的工具指引段之后插入subagent-model-notes段；段内interpolate: false，note 原文进 prompt，{{...}}不会破坏模板。 -
行状态标记（设置页 UI）：
| 标记 | 含义 |
|---|---|
| Authorized | 路由在当前 Subagent 白名单内，note 会进入 agent 的 system prompt。 |
| Not authorized for subagents | note 已保存，但未授权前不生效。 |
| Not in the current catalog | 模型暂不可用，note 仍保留。 |
- 纯逻辑可测：路由过滤与段落拼装主要在
lib/prompt.js，无 DSH 依赖，可用 Node 单测验证。
安装与启用¶
需要带插件系统的 DSH 构建（dsh.bundle + client modules），例如 README 写明在 DSH 0.2.1-rc.2 desktop 上开发与验证。package.json 中 engines.dsh 为 >=0.2.1-rc.1 <0.3.0-0，Node >=22.19.0。
资料中的安装步骤不是 dsh plugin add github:...，而是本地目录安装：
- 将本仓库目录 clone 或复制到稳定路径（用户自行获取源码；本文不展开 clone 命令）。
- 任选一种方式安装为 profile bundle：
- Plugins 页 → Add plugin → local directory → 选中该文件夹；或
- 插件管理工具：对应该文件夹的绝对路径调用install_bundle。 - 本地目录安装是链接而非复制，请保留该文件夹位置。
Bundle 会新增一行 subagent-model-notes，含 volatile 的 notes 配置与浏览器编辑页。
典型用法¶
- 打开 Settings → Plugins → Built-in plugin settings，在 Subagent 下方进入 Subagent model notes：
Settings → Plugins → Built-in plugin settings → Subagent model notes
-
为已在 Subagent 设置里授权的每个模型填写 note，例如：cheap and fast — boilerplate and low-risk tasks。
-
保存。主智能体下一步组装 system prompt 时才会带上 note；且只包含「已授权且写了 note」的路由。
前提：当前 Session 启用了 subagent model selection；未启用时 Host 半段不会注入内容。
适用场景与注意¶
适合谁：已经在 DSH 里配置 Subagent 模型白名单、又希望主智能体在委派时能看到「人工写的选型说明」的工作流用户。
兼容性：插件依赖 system-prompt/assemble、plugins.item、volatile Config、subagentModelSelectionPolicy 等面向插件的 API；README 说明这些在 0.2.1-rc.2 上较稳定，但不是公开兼容性承诺，升级 DSH 后可能需要跟进社区版。若 preset 在 waterfall 之后折叠为带 complete persona 的配置（例如 minimal），notes 段会被去掉——与其他 system-prompt/assemble 插件共用的 harness 约束。
权限与安全：插件以当前 DSH 进程权限运行；安装前请阅读源码与 MIT 许可证，确认 bundle 行为符合你的环境策略。社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系，本文仅作插件事实介绍。
开发自测（维护者侧）：
node --test test/prompt.test.mjs
结尾¶
dsh-subagent-model-notes 在官方 Subagent 路由之上增加「逐模型说明 + system prompt 注入」，不替代白名单 enforcement。若你正在用 DSH 做子智能体委派，又缺一层可编辑的选型上下文，可以从目录页或 GitHub 获取 bundle，按 README 做本地目录安装后，在 Subagent model notes 里维护 note 即可。
