在使用 DeepSeek Harness (DSH) Web GUI 處理長對話時，面對大量文本，快速定位已加載的輪次、查看摘要以及回溯歷史內容需要頻繁滾動頁面。dsh-ui-turn-rail 是一個爲 DSH Web GUI 設計的插件，它在對話滾動區域旁添加了一個常駐的進度指示條，幫助用戶直觀地管理對話進度。
插件簡介¶
該插件由 HenryHwong 維護，屬於 DSH 插件生態中的客戶端組件。它通過在會話快照中讀取數據，在瀏覽器端進行推導，將對話的輪次進度以點的形式展示在界面上。
核心功能¶
- 常駐進度條：進度條固定在對話滾動區域旁，即使對話內容很長，進度條也會保持可見，不會隨頁面滾動消失。
- 點與佔位符：每個已加載的對話輪次對應一個實心點。對於尚未加載的輪次（問題不在當前窗口內），顯示虛線佔位符。AI 的回覆和推理過程不計入已加載的提問點。
- 摘要預覽：鼠標懸停在點上時，會顯示該輪次第一個問題的單行摘要。無論是用戶輸入還是 AI 選項選擇，都會生成摘要。
- 深度歷史加載：點擊未加載的虛線佔位符，插件會自動分頁加載所有舊批次，直到目標輪次的問題出現在窗口中，然後自動跳轉到該問題所在的行。
- 點擊跳轉：點擊已加載的實心點，直接滾動對話記錄到該輪次的問題位置。
- 可滾動窗口：進度條顯示約十個點，內部支持滾動。當讀者移動閱讀位置時，當前輪次的點會自動跟隨進入視野。
安裝與啓用¶
安裝該插件需要兩個步驟：通過 DSH 插件管理器安裝插件包，以及應用主機 instrumentation（源碼級補丁）。
1. 安裝插件¶
在命令行中執行以下命令將插件添加到 Web 配置文件中：
dsh plugin --profile web add @huanghanheng/dsh-ui-turn-rail
2. 應用主機 Instrumentation¶
該插件需要在 DSH 的 Web 客戶端中註冊一個只讀插槽。由於這涉及源碼層面的修改，dsh plugin 命令無法自動完成。需要在 DSH 的代碼檢出目錄中應用補丁，然後重新構建。
執行以下腳本應用補丁並構建：
scripts/apply-instrumentation.sh /path/to/harness-checkout
(cd /path/to/harness-checkout && pnpm run build)
3. 手動安裝支持¶
如果需要手動安裝，也可以直接使用 npm/pnpm 安裝包，並在 profile 的 package.json 中聲明 bundle。安裝完成後，仍需執行上述步驟 2 以應用 instrumentation 並構建。
安全與權限¶
該插件設計爲純展示組件：
* 無網絡請求：不向服務器發送任何請求，不寫入會話日誌，不觸碰憑據。
* 無新權限：僅爲主聊天視圖添加了一個只讀插槽，不引入新的 RPC 或權限。
* 本地計算：所有數據推導（輪次順序、節點映射、摘要）均在客戶端的 ChatSnapshot 上運行，插件自身不持有會話狀態。
生態背景¶
DeepSeek Harness 遵循「一切皆插件」的理念。該插件目錄位於社區託管平臺（SkillHub），與 DeepSeek 官方無直接隸屬關係，僅供技術社區參考。
總結¶
dsh-ui-turn-rail 通過在 Web GUI 中引入可視化的進度條，解決了長對話中的導航難題。它提供了懸停查看摘要、一鍵加載歷史以及點擊跳轉等功能，所有操作均在本地進行，不會影響模型請求或緩存。對於需要頻繁處理長上下文對話的開發者而言，這是一個實用的輔助工具。
