前言¶
DeepSeek Harness (DSH) 的 Web GUI 允許通過插件擴展功能。在開發或使用智能體進行長對話時，快速定位到特定的輪次或回顧上下文是常見需求。biggerboy/dsh-conversation-anchors 插件通過在對話區左側繪製錨點軌，提供類似 Codex 的導航體驗，並支持思考過程的摺疊展示。
核心功能¶
該插件主要解決長會話的定位與閱讀效率問題，包含以下核心能力：
- 錨點軌與懸停預覽：默認 Codex 風格，在對話區左側繪製淺灰短橫線。當前滾動位置的線條更長、更深。鼠標懸停在橫線上時，鄰近線條會按距離縮短形成起伏，並彈出包含問題與回覆摘要的預覽卡片。
- 多風格切換：支持在設置中切換至 DeepSeek（右側）風格，或使用 DSH 官方（右側）風格。切換後，錨點軌會出現在對話區右側或使用官方內置軌道。
- 鍵盤導航：在橫線軌上或聚焦時，支持使用
j/k上下跳轉，Home/End到首尾，實現無鼠標操作。 - 思考過程摺疊：兼容舊版 DSH。當 DSH 官方 Compact 摺疊未啓用時，插件會將每輪迴復中的“思考過程”摺疊爲單行展示，點擊可展開/收起。
- 全會話大綱：DSH 0.1.2-alpha.3+ 版本支持
turnOutline投影，插件可列出全部輪次（含尚未載入的部分），點擊未加載的刻度會按需分頁加載並跳轉。
安裝與啓用¶
安裝前需確保環境滿足要求：Node 版本爲 ^22.19 || >=24，並安裝了 dsh CLI。
1、使用以下命令從 npm registry 安裝（推薦）：
dsh plugin --profile web add @biggerboy123/dsh-conversation-anchors
安裝過程中 pnpm 可能會打印 missing peer 警告，這是良性提示，只要命令退出碼爲 0 即可。
2、重啓 dsh web 服務以加載插件。刷新瀏覽器頁面不會重新拉取插件。
使用方法¶
1、默認模式（Codex 左側）：左側短橫線對應每一輪用戶提問。懸停查看預覽卡片，點擊橫線即可平滑滾動定位到對應消息。
2、切換到 DeepSeek（右側）：打開 設置 → 通用，在「錨點風格」裏選「DeepSeek（右側）」。切換後，錨點軌會出現在右側，槽位高度約 30%。
3、鍵盤操作：使用 Tab 鍵將焦點移動到橫線軌上，然後使用方向鍵或 j/k 鍵快速跳轉。
4、思考過程摺疊：若 DSH 官方 Compact 摺疊已啓用，則由官方負責摺疊；否則插件會將過程敘述收成「思考過程 · N 步」。
技術細節與限制¶
1、平臺限制：僅支持 Web GUI 平臺（platform: "web"），不支持 TUI 或 headless 模式。
2、DOM 注入：由於側邊欄 shell 無對外可註冊的 slot，本插件採用 DOM 級注入的方式實現。
3、歷史加載策略：
- 在 DSH 0.1.2-alpha.3+ 版本且支持 turnOutline 時，插件會合並官方大綱，不再自動後臺拉取歷史，避免拖死標籤頁。
- 在舊版 DSH（無大綱投影）或風格選擇爲官方時，插件會在打開會話後循環 loadOlder()，但最多會在約 4000 條消息（80 頁）處停止，以防止瀏覽器卡頓。
4、版本依賴：推薦 DSH 0.1.2 及以上版本（含 alpha 版本），以獲得全會話大綱支持。
總結¶
該插件通過錨點導航和條件性的思考過程摺疊，爲 DSH Web GUI 提供了增強的閱讀體驗。對於需要頻繁回顧上下文或處理長對話的開發者來說，這能有效降低認知負荷。
