在 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 展示路由信息，解決了調試子代理配置時需要切換窗口或查看網絡請求的問題。它不干擾業務邏輯，僅提供可視化的輔助信息。
