前言¶
在 DeepSeek Harness（DSH）裏讀長回覆時，模型輸出往往帶多級 Markdown 標題，但 Web 與 Desktop 界面默認缺少「當前這一輪（Turn）內部」的章節索引。要在某一段落之間跳轉，通常只能手動滾動或依賴外層的 Turn 導航，對閱讀與復盤都不夠順手。
@addozhang/dsh-turn-toc 是面向 DSH Web 與 Desktop GUI 的客戶端插件，在消息列右側的 gutter 裏渲染與內置 TurnNavigator 相近的無框刻度條，懸停可展開爲多級標題大綱，並支持滾動跟蹤與一鍵跳轉。下面介紹它的定位、能力與安裝方式。
這是什麼¶
- 名稱：
@addozhang/dsh-turn-toc（npm 包名；倉庫addozhang/dsh-turn-toc） - 維護者：addozhang
- 分類：客戶端（
dsh.client注入 Web 端 UI） - 一句話：Turn section outline (TOC) plugin for the DeepSeek Harness Web & Desktop GUI——爲當前正在閱讀的 Turn 提供可交互的多級標題大綱。
- 許可證：MIT（見倉庫
LICENSE） - 當前版本（package.json）：0.1.1
- DSH 兼容（engines.dsh）：
>=0.2.0-rc.1 <0.3.0
插件掛在居中消息列外側的右側 gutter，與外層 TurnNavigator 並列，平時不遮擋正文。
核心功能¶
以下能力均來自項目 README 的功能說明。
靜止態：無框刻度條¶
在消息列旁按標題層級（H1–H6）渲染 subtle 的橫向刻度條，視覺風格與 DSH 內置 TurnNavigator 一致，不蓋住文字，也不與外層 Turn 導航衝突。
雙重滾動跟蹤（Turn + 標題）¶
自動識別視口閱讀線所在的 Turn，並在滾動時高亮當前章節（H1–H6）。
懸停展開與固定¶
指針懸停時平滑展開爲半透明 MenuSurface 大綱卡片；提供 pin 開關，需要時可保持大綱常開。
一鍵跳轉到章節¶
點擊大綱中的標題行，或在不展開的情況下直接點擊刻度條，即可平滑滾動到對應章節，並帶有短暫高亮反饋。
快速切換 Turn¶
大綱頭部提供按鈕：跳轉到當前 Turn 頂部（Turn N）、上一條 Turn（↑）、下一條 Turn（↓）。
響應式自動隱藏¶
僅當對話容器寬度 >= 1280px 且右側 gutter >= 176px、有足夠空間向右側展開且不與消息列或外層 TurnNavigator 重疊時，才顯示該組件。
安裝與啓用¶
插件通過 DSH 的 web profile 安裝；安裝後需重啓正在運行的 dsh profile 或 DeepSeek Harness Desktop 應用，以便瀏覽器 roster 加載客戶端 bundle。
從 npm 安裝¶
dsh plugin --profile web add @addozhang/dsh-turn-toc
從 GitHub 安裝¶
dsh plugin --profile web add github:addozhang/dsh-turn-toc
開發本插件時要求 Node >=22.19.0（見 package.json engines.node）；作爲使用者只需滿足 DSH 與上述 profile 要求即可。
典型用法¶
README 未單獨列出配置文件或 CLI 子命令；啓用插件後，在寬度足夠的 Web/Desktop 界面中打開含 Markdown 標題的長 Turn 即可使用：
- 在右側 gutter 查看按層級縮進的刻度條，確認當前閱讀位置。
- 將指針移到 gutter 上，展開大綱；需要常駐時可打開 pin。
- 點擊某一標題或刻度，跳轉到該節；用頭部按鈕在當前 Turn 內回到頂部，或切換到相鄰 Turn。
倉庫 docs/demo.gif 展示了懸停展開與一鍵跳轉的效果（見 GitHub README）。
適用場景與注意¶
適合誰：經常在 DSH Web 或 Desktop 裏閱讀帶 H1–H6 結構的長回覆、需要在單 Turn 內快速定位章節的開發者或日常用戶；寬屏佈局（滿足上述最小寬度）下體驗最完整。
生態說明：DSH 採用「一切皆插件」的擴展方式；社區目錄站點（如 SkillHub 上的插件頁）與 DeepSeek、幻方無官方從屬關係，本文不以「官方應用商店」表述。
安全與權限：客戶端插件隨當前 DSH 進程在瀏覽器環境中運行，安裝前建議閱讀倉庫源碼與 MIT 許可證，確認符合你的環境與合規要求。
結尾¶
dsh-turn-toc 把 Turn 內的 Markdown 標題變成可跟蹤、可跳轉的側邊大綱，並與 DSH 既有 Turn 導航風格對齊。需要安裝或 issue 時可訪問：
- 社區目錄頁：https://www.skillhub.cn/plugins/addozhang/dsh-turn-toc
- GitHub：https://github.com/addozhang/dsh-turn-toc
