前言¶
DeepSeek Harness (DSH) Web Composer 採用「一切皆插件」的架構。在開發與調試智能體時，開發者需要清晰地感知模型當前的推理狀態與工具調用情況。dsh-thinkbar 插件填補了這一視覺反饋的空白，爲 DSH 的 Web Composer 提供了一套非侵入式的狀態指示方案。
插件定位¶
dsh-thinkbar 是由維護者 tower1229 開發的動態推理等待可視化指示器。它通過 Web UI 插件的形式，在模型思考窗口填充動態的熱力色板，並在工具執行時疊加獨立的工具活動視圖，完全在客戶端運行。
核心功能¶
該插件提供以下核心能力：
- 熱力色板 (Thermal Iron Scale Palette): 在推理過程中，指示器會呈現從初始藍（0秒）過渡到紅（約6.7秒）、橙（約13.3秒）直至發光金（20秒）的平滑漸變。
- 零侵入門戶適配 (Zero-Intrusion Portal Adapter): 通過 DSH 的公共生命週期接口
conversation.input.right注入，無需修改 DSH 內部代碼或生成自定義的模型標籤字符串。 - 模型兼容的每步狀態機 (Model-Compatible Per-Step State Machine): 插件能獨立追蹤每個步驟的推理狀態，並在檢測到工具調用時切換至工具活動模式。
- 可見工具活動 (Visible Tool Activity): 在工具執行期間，顯示紫青色的掃描動畫並暫時疊加當前正在運行的工具名稱。
- 流體排空動畫 (Fluid Drain Animation): 推理或工具執行結束後，指示器會在 240ms 內平滑消退。
- 無障礙支持 (Accessibility Ready): 自動檢測並尊重系統的
prefers-reduced-motion設置。 - 100% 客戶端私有 (100% Client-Side & Private): 零後端修改、零遙測、零外部網絡流量。
安裝與啓用¶
請確保你的環境滿足前置要求後再執行以下步驟。
前置要求¶
- DeepSeek Harness: 版本
0.1.2-alpha.4（僅支持此版本，早期構建不兼容）。 - Node.js:
^22.19.0或>=24.0.0。 - pnpm: 版本
>= 9.0。
安裝步驟¶
- 通過 npm 註冊表安裝：
pnpm dsh plugin --profile web add dsh-thinkbar
- 若需測試本地構建的 tarball：
pnpm dsh plugin --profile web add ./dsh-thinkbar-<version>.tgz
- 重啓 Web Profile 以加載插件：
pnpm dsh web
- 驗證插件是否正確加載：
pnpm dsh --profile web --dump-config
檢查輸出中是否包含 `dsh-thinkbar` 行。
典型用法¶
安裝並重啓 Profile 後，插件會自動生效。
- 當模型開始推理時，模型選擇器區域會出現熱力色板填充，顏色隨時間推移發生變化。
- 當模型調用工具時，色板停止，並切換爲紫青色的工具活動視圖。
- 推理結束或工具調用完成後，視圖會在 240ms 內平滑消退。
適用場景與注意¶
- 適用場景: 需要 Web Composer 實時反饋模型內部狀態（思考進度、工具執行）的開發者與調試人員。
- 注意: 插件完全運行在客戶端，不會將數據發送至外部服務，但需要依賴 DSH 的特定版本（0.1.2-alpha.4）提供的公共接口。安裝前請檢查源碼與許可證（MIT）。
總結¶
dsh-thinkbar 爲 DeepSeek Harness Web Composer 提供了直觀、流暢且私有的狀態可視化能力。通過非侵入式的適配與精確的狀態機控制，它讓開發者能更清晰地觀察智能體的運行邏輯。
- 目錄頁: https://www.skillhub.cn/plugins/tower1229/dsh-thinkbar
- 源碼倉庫: https://github.com/tower1229/dsh-thinkbar
