前言¶
DeepSeek Harness（DSH）的核心理念是「一切皆插件」，這允許用戶在 web profile 中通過擴展功能來增強界面。在調試或與智能體交互時，快速訪問特定輪次生成的文件和導航歷史記錄通常需要手動複製粘貼或滾動。dsh-turn-tools 作爲一個 DSH web 插件，通過爲每輪對話添加文件按鈕和圓點導航欄來解決這個問題。
插件介紹¶
dsh-turn-tools 是一個由 hu669293657 維護的插件，採用 MIT 許可證。它主要解決兩個具體痛點：文件訪問和對話導航。
核心功能¶
該插件在 DSH web 界面中增加了兩個工具：
-
每輪產出文件按鈕
當智能體輪次產生輸出文件時，在該輪末尾渲染一個按鈕。點擊按鈕通過系統默認應用程序打開文件（通過 harness 的host.openPathAPI）。 -
輪次導航圓點欄
聊天區右側的浮動圓點欄，每輪對話一個圓點。點擊圓點將滾動跳轉到對應輪次。
安裝與啓用¶
安裝可以通過 dsh plugin add 命令完成（使用 npm 包或 git URL），或者按照以下步驟手動安裝：
- Copy this repo into
$DSH_HOME/profiles/web/node_modules/dsh-turn-tools/. - Append the contents of
cordis.patch.ymlto$DSH_HOME/profiles/web/cordis.patch.yml. - Restart dsh.
典型用法¶
- 重啓 DSH：安裝後必須重啓 dsh；目前不支持熱加載。
- 查看文件：當某輪對話生成輸出文件時，按鈕會出現在該輪的末尾。點擊這些按鈕會使用操作系統默認應用程序打開文件。
- 導航歷史：點擊右側圓點欄中的圓點會將視圖滾動到特定的對話輪次。
適用場景與注意¶
- 渲染限制：產出文件按鈕僅在智能體輪次實際生成輸出文件時才渲染。
- 調試：如果按鈕或圓點沒有出現，請檢查瀏覽器控制台中的
window.__DSH_BOOT__.entries。條目dsh-turn-tools應處於活動狀態，且不應顯示“waiting for services”。 - 實現機制：插件通過
slots服務註冊兩個插槽：conversation.chat.turnTail（讀取turn.data.get('deliverables')）和shell.overlay（使用MutationObserver掃描[data-dsh-turn-anchor]元素）。
結語¶
此插件簡化了 DSH web 界面中的文件訪問和歷史導航。源代碼託管在 GitHub 上，許可證爲 MIT。通過目錄鏈接可找到更多插件。
