前言¶

在 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

核心功能¶

下面介绍插件在资料中明确描述的能力。

1. 设置页：在 Settings → Plugins → Built-in plugin settings 中，位于官方 Subagent 条目下方，出现 Subagent model notes（order: 11）。页面通过 ctx.configForms 读写 volatile 配置项 notes，并拉取 live 模型目录与 subagent-model-selection-settings 白名单，列表与当前 Session 可选范围对齐。

2. 逐模型备注：每个可能被选的模型对应一行可编辑 note，保存后写入 bundle 配置。

3. System prompt 注入：Host 侧监听 system-prompt/assemble waterfall；读取 Session 投影 subagentModelSelectionPolicy（无 policy 则插件不做任何事）。只保留 policy 里出现的路由所对应的 note，在描述含 list_subagent_models 的工具指引段之后插入 subagent-model-notes 段；段内 interpolate: false，note 原文进 prompt，{{...}} 不会破坏模板。

4. 行状态标记（设置页 UI）：

5. 纯逻辑可测：路由过滤与段落拼装主要在 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:...，而是本地目录安装：

1. 将本仓库目录 clone 或复制到稳定路径（用户自行获取源码；本文不展开 clone 命令）。
2. 任选一种方式安装为 profile bundle：
   - Plugins 页 → Add plugin → local directory → 选中该文件夹；或
   - 插件管理工具：对应该文件夹的绝对路径调用 install_bundle。
3. 本地目录安装是链接而非复制，请保留该文件夹位置。

Bundle 会新增一行 subagent-model-notes，含 volatile 的 notes 配置与浏览器编辑页。

典型用法¶

1. 打开 Settings → Plugins → Built-in plugin settings，在 Subagent 下方进入 Subagent model notes：

Settings → Plugins → Built-in plugin settings → Subagent model notes

2. 为已在 Subagent 设置里授权的每个模型填写 note，例如：cheap and fast — boilerplate and low-risk tasks。

3. 保存。主智能体下一步组装 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 即可。

• 目录页：https://www.skillhub.cn/plugins/097794/dsh-subagent-model-notes
• GitHub：https://github.com/097794/dsh-subagent-model-notes