在 DeepSeek Harness 的开发调试中，子代理的调用链路（provider、model、reasoning effort）往往分散在请求头或网络面板中，查看不便。此插件旨在将这部分路由信息直接映射到 UI 界面上，便于在交互过程中快速确认当前会话的配置状态。
插件简介¶
alaxrpg/dsh-subagent-route-badges 是一个独立插件，用于在已打开子代理会话的 Header actions 区展示 provider / model · 思考 effort 徽章。
这是一个纯展示插件，不拦截、不改写模型请求。它通过投影机制，利用 projectionValues 和已进入会话事件的数据，在 UI 层面提供辅助信息。
核心功能¶
1. 路由徽章展示¶
插件会在子代理会话的 Header actions 区注册一个席位（ID 为 dsh-subagent-route-badges-action），展示以下信息：
* Provider / Model：子代理调用的提供商与模型。
* Reasoning Effort：思考强度，显示为“思考 默认”或“思考 未指定”。
2. 数据来源与回滚¶
- 权威来源：最新
request/header的data.header.config。 - Effort 判定：通过
header.adapterDefaults.reasoningEffort === true判断，为true时显示“思考 默认”，否则为“思考 未指定”。 - 回滚机制：
assistant/message.source仅用于回滚 provider/model，绝不会清除已确定的 effort 值。
3. 实现方式¶
- 纯 additive：插件只以唯一 ID 注册到
conversation.session.header.actions（list 型槽位），不复制、不 shadow 官方 UI 组件，不竞争 single 型槽位。 - 占位处理：如果投影缺失，会显示“路由未知”占位符，便于确认插件接管状态。
4. 隐私与数据¶
- 插件仅读取已进入会话事件与
projectionValues中的字段。 - 不读取文件、凭据或消息正文，也不上传数据。
安装与启用¶
请确保你的 DeepSeek Harness 版本满足以下要求：
DSH >=0.1.1-rc.2
安装、更新和卸载操作请直接通过插件市场进行。安装完成后，按照市场提示重启 DSH 即可生效。
典型用法¶
-
查看徽章
打开对应的子代理会话，在 Header 的 actions 区即可看到provider / model · 思考 effort的徽章显示。长文本会被省略，但完整值保留在title与aria-label中。 -
检查配置
若需查看具体配置，可在开发工具中检查最新request/header的data.header.config。 -
检查 Effort
检查header.adapterDefaults.reasoningEffort === true的状态，确认是否显示为“思考 默认”。
注意事项¶
- 插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。
- 插件仅在会话已进入时生效，目录弹窗行内不做展示。
- 兼容性要求：
@deepseek-ai/dsh-client-runtime>=0.1.1-rc.2，@deepseek-ai/dsh-client-ui-conversation>=0.1.1-rc.2。
总结¶
dsh-subagent-route-badges 通过在 Header 展示路由信息，解决了调试子代理配置时需要切换窗口或查看网络请求的问题。它不干扰业务逻辑，仅提供可视化的辅助信息。
