前言¶
在 DSH「一切皆插件」的生態裏，社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係。這裏介紹的 dsh-turn-index 是面向 DeepSeek Harness Web GUI 的第三方插件。
如果你經常在 Web GUI 中處理長會話，會發現聊天流越來越長，想快速回到某一輪用戶提問並不方便。dsh-turn-index 解決的問題比較具體：在 Web GUI 右側增加一條輪次索引，把每一輪用戶提問列出來，點擊條目即可跳轉到對應位置。
這是什麼¶
dsh-turn-index 是一個對話輪次索引插件，用於 DeepSeek Harness Web GUI。
它由 Simon314620 維護，採用 MIT 許可證。插件無配置項，安裝後在右側邊欄顯示索引；每條索引對應一輪用戶提問，點擊後定位到聊天流中的對應消息行。
核心功能¶
逐輪索引¶
索引欄按輪次列出用戶提問。每條索引對應一輪用戶提問的開場消息。
如果某一輪內部穿插了補充提問，這些補充提問會以 ↳ 縮進顯示，不打斷輪次編號。
點擊跳轉¶
點擊索引條目後，插件會定位聊天流中對應的消息行，執行平滑滾動，並對目標位置做閃爍高亮。
閱讀聯動¶
滾動閱讀聊天流時，索引欄會同步高亮當前輪次。
如果索引欄處於展開狀態，列表也會自動跟隨當前閱讀位置，讓當前輪次保持在可見範圍內。
歷史分頁¶
當會話歷史窗口還沒有加載完時，索引欄頂部會出現「加載更早的輪次」。
點擊後繼續向前加載更早的輪次。索引只覆蓋當前已加載的歷史窗口，不是一次性加載全部歷史。
軌跡視圖兜底¶
如果你當前停留在軌跡視圖，而不是普通對話視圖，點擊索引條目時會給出提示，並支持一鍵切回對話。
避讓右側詳情面板¶
當右側工具詳情面板打開時，索引欄會自動左移避讓，避免遮擋詳情內容。
響應式¶
插件會跟隨視口寬度調整：
- 視口
≤1024px時，自動收成44px窄條。 1280px以下，面板收窄。- 面板高度貼合聊天流區域。
雙語文案¶
插件通過 harness 的 locale 服務提供中文 / English 文案，跟隨界面語言。
安裝與啓用¶
在 web profile 下安裝插件：
dsh plugin --profile web add dsh-turn-index
安裝完成後，重啓 dsh web，然後刷新頁面。
刷新後可以在 Web GUI 右側看到索引欄。
移除插件：
dsh plugin --profile web remove dsh-turn-index
移除後重啓 dsh web，並硬刷新頁面（Ctrl+Shift+R）。
典型用法¶
1、安裝後打開一段較長會話，右側索引欄會列出當前已加載窗口中的用戶提問輪次。
2、點擊某一條索引，聊天流平滑滾動到對應輪次，並閃爍高亮。
3、手動滾動聊天流時，側邊欄會同步高亮當前輪次。
4、如果當前歷史窗口還沒加載完，點擊頂部「加載更早的輪次」繼續向前加載。
5、如果當前停在軌跡視圖，點擊索引會提示並支持一鍵切回對話。
適用場景與注意¶
適合需要頻繁回查用戶提問、整理長會話、覆盤多輪交互的 DSH Web GUI 使用者。
使用前提需要注意：插件會以當前 dsh 進程權限運行。安裝前建議檢查源碼與 MIT 許可證。
數據與權限¶
根據已覈實資料：
- 宿主側零運行時邏輯，不讀寫文件系統、不發起網絡請求、不訪問憑據。
- 會話數據只讀，僅用於渲染輪次索引，不上傳、不外發。
- 面板偏好僅存於瀏覽器
localStorage。 - 無遙測、無埋點、無第三方腳本。
兼容性¶
- 支持版本：
DSH 0.1.0-rc.6（webprofile，mainline）。 - 最後驗證：2026-08-14 · Windows 11 · Node 24 · pnpm 11。
react爲可選 peer：^18.0.0 || ^19.0.0。
限制¶
- 索引只覆蓋當前已加載的歷史窗口，更早的輪次需要通過「加載更早」逐頁加載。
- 跳轉依賴 harness 聊天流的 DOM 契約；harness 大版本升級若改動這些屬性，插件可能需要適配。
安全問題¶
安全問題通過 GitHub Issues 聯繫維護者私下報告，避免公開披露。
鏈接¶
- GitHub：https://github.com/Simon314620/dsh-turn-index
- 目錄頁：已覈實資料未提供可覈驗 URL，可按插件名
dsh-turn-index在社區目錄中查找。
