前言¶

DeepSeek Harness（DSH）採用「一切皆插件」的架構，通過插件系統擴展能力。在長對話中，Markdown 標題散佈在大量回閤中，快速定位特定章節或跳轉會話變得困難。dsh-quick-toc 插件提取 AI 回覆中的 Markdown 標題（H1–H6），生成可導航的大綱面板，按對話回合分組、覆蓋整段會話，支持搜索、高亮與平滑跳轉。

核心功能¶

按回合分組
每條用戶消息及其後續 AI 回覆爲一組。組頭顯示回合時間與首行預覽，點擊組頭跳轉到該回合模型回答的開頭。

覆蓋整段會話
未加載進對話窗口的回合也在列表裏，顯示「未加載」標記與預覽。點擊該條目會將對應的回合加載進窗口並跳轉過去。

失敗回合報錯
對於請求超時或上游報錯等沒有回覆的回合，面板會顯示 請求失敗 與報錯原文，點擊可跳轉到對話中的報錯位置。

中英雙語界面
界面語言可設爲跟隨宿主、中文或 English。中文時間戳用 昨天 / 前天，英文時間戳用 yesterday 或 YY-MM-DD HH:MM。

插件配置卡片
在「設置 → 插件 → 插件配置」中展開「對話大綱」卡片。可調整語言、默認停靠邊緣、顯示的標題層級、收起把手的位置、模糊搜索、懸停預覽與診斷開關。改過的字段標「已自定義」並可單獨重置。

標題行副標題
每行標題下方顯示該節正文的第一句，同名標題一眼可辨。

懸停預覽
鼠標懸停標題行時，顯示該節開頭、回合時間與層級路徑。

標題/全文搜索
提供標題與全文兩種搜索範圍。結果列表點擊定位並高亮，支持 n/N 回車逐處跳轉，Esc 關閉。

容錯匹配
搜索支持大小寫、全角半角、連續空白的自動匹配。開啓「模糊」開關可放寬到關鍵字中間夾字。

對話內高亮
命中的關鍵字在對話中高亮，當前命中的條目單獨標亮。

組頭吸頂
滾動大綱時，當前回合的組頭固定在面板頂部。

層級篩選
標題欄的圓形層級按鈕彈出 H1–H6 開關，可任意組合顯示。

閱讀位置自動跟隨
滾動對話時，正在閱讀的回合會以藍框標出，大綱自動跟隨。

平滑跳轉
點擊標題跳轉至對話中該標題的位置。滾動動畫交給瀏覽器，若瀏覽器直接執行瞬移，插件會自己逐幀繪製。

回到底部按鈕
列表右下角提供浮動按鈕，點擊一步回到最新條目。不在底部時顯示，到底後消失。

可停靠、可縮放
拖動頂部橫條移動面板，點擊 ◀ / ▶ 切換左右停靠。拖動邊緣調整寬高（最窄 120px）。面板內容支持 50%–200% 的縮放（滑塊按 5% 一檔），面板本身尺寸不變。

分頁加載
默認顯示最近的若干組，向上滾動既展開索引也加載更早的對話。

邊界提示
滾動到最早或最新再繼續滾動時，面板底部會短暫提示。

Markdown 感知
標題中的行內標記會被剝離。圍欄代碼塊裏的 # 行不算標題。

深色/淺色主題適配
面板自動適配深色/淺色主題，僅在對話視圖顯示。

安裝與啓用¶

通過 DSH CLI 安裝：

dsh plugin --profile web add dsh-quick-toc

安裝後重啓 DSH 並打開 Web UI。面板默認收起，點擊對話區邊緣的把手即可展開。

使用示例¶

• 跳轉：點擊大綱標題或組頭跳轉至對應位置。帶「未加載」標記的條目會先加載回合再跳轉。失敗回合點擊報錯行跳到對應位置。
• 搜索：放大鏡打開搜索框，輸入後點結果定位並高亮，回車逐處跳，Esc 關閉。
• 篩選：點擊標題欄的圓形層級按鈕彈出 H1–H6 開關，選擇顯示的層級。
• 調整面板：拖動面板邊緣調整大小或切換左右停靠。
• 加載歷史：在大綱中向上滾動，既展開索引也加載更早的對話。
• 回到最新：翻遠了之後，點擊右下角浮動按鈕回到最新一條。
• 調整設置：在設置中展開「對話大綱」卡片調整參數。

注意事項¶

• DSH 版本要求：插件要求 DSH 版本 >= 0.1.5-rc.1。
• 宿主依賴：依賴宿主的 turnOutline 投影與會話跳轉加載器。
• 兼容性降級：
  • 若宿主缺少 turnOutline 投影，僅顯示已加載回合。
  • 若宿主缺少跳轉加載器，未加載條目僅展示不跳轉。
• 診斷日誌：面板掛載時默認不打印日誌，需在設置中開啓「在控制台打印診斷日誌」。
• 主題生效範圍：主題僅對對話視圖生效。

總結¶

dsh-quick-toc 爲 DSH 用戶提供了從雜亂對話中提取結構化導航的能力，解決了長會話中的定位痛點。通過安裝與上述配置，開發者可以快速在長對話中找到所需內容。更多細節與源碼可參考 GitHub 倉庫 或 社區目錄。