前言¶
在 DeepSeek Harness（DSH）裏做長會話時，右側的輪次導航條能按刻度回看每一輪，但要把「自己當時問了什麼」串起來，往往還得在對話區裏上下翻。內置索引側重輪次刻度與預覽，不單獨列出全部人類提問，也不提供按關鍵詞篩問句的入口。
下面介紹社區插件 dsh-plugin-turn-index（維護者 lizongze，分類：客戶端）。它在不替換原導航的前提下，在索引條底部增加可展開的提問列表，支持搜索、高亮與點擊跳轉，適合在 Web / Desktop 客戶端裏快速定位某一輪的提問。
這是什麼¶
dsh-plugin-turn-index 是 DSH 的 客戶端插件（dsh.client.platform: web），當前版本 1.0.1，許可證 MIT。源碼與說明見 GitHub，社區目錄頁爲 skillhub.cn 插件條目。
一句話定位：給會話右側「輪次導航」索引條追加提問索引——展開全部提問、模糊搜索過濾、高亮命中並點擊跳到對應輪次；原有的刻度、懸浮預覽、當前輪高亮、歷史回補邏輯保持不變。
核心功能¶
資料中明確的能力如下。
- 入口：輪次導航條出現時，索引條底部出現一個
<箭頭；點開展開「提問索引」浮層。 - 列表：每行顯示輪次編號與該輪提問的前幾行；標題後顯示當前列表中的提問數量（一個數字）。
- 搜索：標題與搜索框同一行；輸入關鍵詞即時過濾，匹配位置背景高亮，結果按相關度排序；
Enter跳到第一條匹配，Esc先清空搜索、再按一次收起浮層。 - 跳轉：點擊某一行跳到該輪；浮層內當前輪高亮。目標輪尚未加載進窗口時，會先自動回補歷史再跳轉。
- 佈局：內容少時浮層底部貼索引條、向上延伸；內容超出上方空間後，頂部停在聊天區頂部，直至佔滿窗口底部後纔在浮層內滾動；點浮層外或再點箭頭可收起。
- 範圍：只增強內置索引，不替換索引條本身。
顯示條件：內置輪次導航在會話面板較窄時會被容器查詢隱藏（<= 900px），此時插件也不顯示；拉寬窗口或調整界面縮放後即可看到索引條與箭頭。
原理概要¶
便於判斷是否與自己的 DSH 版本匹配，簡要說明實現依賴（均來自 README）。
- 數據：讀取當前會話的
turnOutline投影（輪次號、turn/start的 seq、提問/回答預覽），未加載進窗口的舊輪次也能列出。 - 註冊：掛到
shell.overlayframe 級浮層槽位，無需改動對話視圖或索引條源碼。 - 定位：通過 DOM 找到帶
button[data-index]刻度的<nav>，測量位置，箭頭固定在索引條底部。 - 跳轉：點擊列表項時驅動索引條刻度按鈕（必要時先滾動索引條以渲染虛擬化刻度），複用官方的
loadThrough、滾動與當前輪激活邏輯。
兼容性說明：依賴 DSH 0.2.x 的 turnOutline 投影與 button[data-index] 輪次刻度 DOM。
安裝與啓用¶
要求 DSH 0.2.x（Web / Desktop 客戶端均適用）。
從本地目錄安裝到某個 profile（示例路徑按 README 原文）：
dsh plugin --profile web add file:D:\path\to\dsh-plugin-turn-index
發佈到 npm 後也可按包名安裝：
dsh plugin --profile web add dsh-plugin-turn-index
或在 Web UI 的「插件」管理裏把該目錄作爲本地包安裝。安裝後刷新頁面。
Desktop 的 desktop profile 由 Electron 託管，CLI 不直接管理；可通過插件管理面板或宿主提供的安裝入口，使用 file:D:\path\to\dsh-plugin-turn-index 裝入該 profile。
卸載示例：
dsh plugin --profile web remove dsh-plugin-turn-index
或在插件管理中移除 dsh-plugin-turn-index。
插件以當前 DSH 進程權限在瀏覽器側運行；安裝前建議瀏覽 lib/client.js 等源碼並確認 MIT 許可證是否符合你的環境要求。
典型用法¶
交互步驟與 README 一致，可按下面順序自測。
- 打開一段有多輪對話的會話，確認右側出現輪次導航條（面板寬度需大於約 900px）。
- 點擊索引條底部的
<箭頭，展開提問列表。 - 在標題行旁的搜索框輸入關鍵詞，觀察過濾與高亮；按
Enter跳到第一條匹配。 - 點擊任意一行，確認跳轉到對應輪次；對尚未加載的舊輪，應先回補再定位。
- 按
Esc清空搜索，或點浮層外 / 再點箭頭收起。
適用場景與注意¶
適合：在長 Harness 會話裏按「問過的原話」檢索並跳輪，而不是僅靠刻度編號回憶內容。
注意：
- 窄屏下內置導航隱藏時插件不會出現，這是與內置行爲一致的限制，不是單獨故障。
- 將來若 DSH 爲索引條提供正式擴展槽位，插件可能改爲槽位接入並去掉部分 DOM 兼容層（README 中的兼容性說明）。
- 社區目錄 skillhub.cn 爲獨立站點，與 DeepSeek / 幻方無官方從屬關係；DSH 生態強調「一切皆插件」，本文事實以倉庫 README 與
package.json爲準。
結尾¶
dsh-plugin-turn-index 在保留官方輪次導航的前提下，用 turnOutline 與 shell.overlay 補上「全部提問 + 搜索 + 跳轉」這一層。需要安裝命令與交互細節時，可直接查閱 GitHub 倉庫 或上述目錄頁。
