前言¶
DeepSeek Harness (DSH) 的 Web 界面內置了回合計時器，位於對話底部，但存在 15 秒延遲，且測量的是整個回合的總時長。在執行長時間工具調用（如 bash）時，難以區分該步驟是剛剛啓動還是已經卡頓許久。dsh-step-clock 插件針對這一場景，在 Web GUI 的輸入框上方提供實時的步驟級計時器。
插件簡介¶
名稱：wste47/dsh-step-clock（包名：@climber47/dsh-step-clock）
維護者：climber47
定位：DSH Web GUI 的 Live per-step elapsed clock。
核心功能¶
該插件在 DSH Web 界面的 Composer Dock（輸入框上方的 Dock 區域）顯示計時條，包含以下能力：
1. 實時耗時顯示：顯示當前正在執行步驟的經過時間。
2. 狀態與工具信息：顯示工具名稱、步驟編號以及當前狀態（如“正在執行”、“模型正在思考”等）。
3. 緊湊時鐘：右側顯示緊湊的 m:ss 格式時鐘。
4. 併發支持：支持多個工具並行運行時的計時。
5. 思考步驟適配：專門處理 Thinking 步驟的計時錨點。
6. 已結束步驟保留：步驟完成後，計時條會保留在屏幕上直到下一次步驟啓動，便於查看耗時較長的步驟。
7. 動態注入：通過創建 Tagged <style> 元素動態注入樣式表。
安裝與啓用¶
確保你的 DSH 版本滿足要求（dsh >=0.1.5-rc.1），在終端執行以下命令安裝插件：
dsh plugin --profile web add @climber47/dsh-step-clock
安裝完成後，重啓 dsh web 服務。在下次運行步驟時，計時條將出現在輸入框上方。
典型用法¶
插件會根據當前狀態顯示不同的文本描述。以下爲可能的顯示示例：
- 運行中：
● 正在執行 bash，已運行 1 分 12 秒 第 12 步 [bash] 1:12 - 已結束：
● 上一步（第 12 步）已完成，用時 3 分 45 秒 3:45 - 空閒：
● 空閒，等待下一步
適用場景與注意事項¶
該插件適合需要精確監控每個步驟執行耗時的 DSH 使用者。它不依賴輪詢，而是直接讀取 DSH 引擎提供的 Facts（引擎事實）。
注意事項：
1. 版本要求：需要 DSH 版本 >=0.1.5-rc.1，且宿主環境提供 React 18。
2. 無主機行爲：插件的 Host half（lib/index.js）是空的，僅通過 Bundle 機制註冊。
3. 數據源：僅讀取引擎的 Chat timeline snapshot 和 Live running-call list，不自行輪詢數據。
總結¶
dsh-step-clock 通過在 Web 界面提供實時的步驟級計時，解決了內置回合計時器延遲和粒度不足的問題。對於需要觀察長耗時步驟或調試執行流程的開發者，這是一個實用的輔助工具。
