前言¶
在 DeepSeek Harness（DSH）裏跑長對話時，助手回覆往往帶多級 Markdown 標題，正文一滾就很難找回「剛纔那段講的是什麼」。靠瀏覽器自帶目錄、手動翻 DOM，或者事後複製全文再整理，都跟不上流式生成。
dsh-outline 是面向 DSH Web GUI 的客戶端插件：在會話頁右側掛一棵即時大綱樹，把用戶問題與回覆裏的 H1–H6 標題串起來，流式輸出時同步更新，點節點即可定位正文。交互形態移植自維護者 urzeye 的 Ophel 瀏覽器擴展，按 DSH 官方插件約定打包發佈。
這是什麼¶
dsh-outline（GitHub：urzeye/dsh-outline）由 urzeye 維護，當前 npm 版本爲 0.1.6，MIT 許可證。分類爲客戶端插件，在 SkillHub 目錄頁可見：urzeye/dsh-outline。
它解決的核心問題是：長會話裏缺少一個與內容同步、可點擊跳轉的結構化導航，而不是事後靜態目錄。
核心功能¶
即時大綱¶
大綱由會話事件流構建：用戶問題作爲一級節點，助手回覆中的 Markdown 標題掛在其下，不抓取 DOM。流式生成時隨 token 即時更新；刷新、重連、歷史分頁由 DSH runtime 自動重建。
點擊節點會滾動定位到正文對應位置，並高亮當前閱讀位置。
層級與視圖¶
- 層級滑塊控制展開深度（0–6 檔），節點可單獨展開/收起，支持一鍵展開/收起全部
- 關鍵詞搜索（帶匹配計數）、按會話收藏、「只看收藏」模式
- 一鍵複製大綱、回到頂部/底部
面板形態¶
面板以 shell.overlay 浮層呈現：右緣觸發條懸停可預覽，可固定常駐，可拖拽移動，不擠壓聊天區。
主題與國際化¶
跟隨 DSH 主題變量與明暗模式；界面文案中英文隨 DSH 語言切換。
環境要求¶
- 已安裝 DeepSeek Harness Web GUI
- Node.js ≥ 22.13（僅本地開發與構建時需要）
安裝與啓用¶
安裝命令通過 dsh plugin 轉發給 profile 目錄內的 pnpm。安裝後需重啓 dsh web 生效——插件的 host 部分在 DSH 啓動時加載。
從 npm 安裝（推薦）¶
dsh plugin --profile web add dsh-outline@latest
已經裝過時請帶 @latest：裸包名會沿用 lockfile 裏的舊版本，不會自動升級。
從 tarball 安裝¶
可自行 pnpm pack，或從 GitHub Releases 下載：
dsh plugin --profile web add ./dsh-outline-0.1.6.tgz
本地路徑安裝（開發調試）¶
cd /path/to/dsh-outline
pnpm install
pnpm build
dsh plugin --profile web remove dsh-outline # 若先前裝過 npm 版，先卸掉
dsh plugin --profile web add /path/to/dsh-outline
第一次安裝（以及任何 host 半變更）後需重啓 dsh web。打開任意會話頁，懸停右緣大綱觸發條，確認面板出現。
卸載¶
dsh plugin --profile web remove dsh-outline
典型用法¶
- 啓動
dsh web，打開任意會話頁。 - 鼠標懸停會話頁右緣的大綱觸發條，預覽大綱面板。
- 點擊觸發條或面板右上角的固定按鈕，將面板固定常駐；拖動標題欄可移動面板位置（拖動即固定）。
- 面板內：點擊節點跳轉正文；頂部滑塊調整展開層級；節點行內提供展開/收起與收藏按鈕；支持關鍵詞搜索。
適用場景與注意¶
適合誰
- 經常在 DSH Web GUI 裏跑長對話、技術文檔式回覆的開發者
- 需要在流式生成過程中隨時回看章節結構、快速跳轉的用戶
使用注意
- 命令必須帶
--profile web，否則加不到 Web GUI 那套 profile。 - 面板不出現：查看
dsh web終端是否有插件加載報錯；確認裝的是預期版本（本地路徑而非 npm 舊版）。 - README 提示：若以瀏覽器方式使用 DeepSeek Harness，維護者建議優先體驗 Ophel，功能更全面、體驗更流暢；
dsh-outline面向 DSH 插件生態內的集成場景。 - 插件以當前
dsh進程權限運行，安裝前應檢查源碼與 MIT 許可證，確認來源爲 urzeye/dsh-outline。
SkillHub 爲獨立社區目錄，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-outline 把「用戶問題 + Markdown 標題」收成一棵即時大綱，掛在 DSH 會話頁右側，流式更新、點擊定位，適合長對話場景下的結構導航。
