前言¶

DeepSeek Harness (DSH) 採用插件化架構。在進行多輪對話或涉及分支/子會話時，快速定位特定提問往往需要手動滾動查找。dsh-chat-index 是一個 DSH Web 插件，通過可視化的提問索引和鏈面板，解決這一導航痛點。

核心功能¶

右側提問窄條¶

在會話右側會出現一個窄條，每個提問對應一個圓點。圓點按真實提問時間間隔分佈，頂部爲最早提問，底部爲最近提問。
* 點擊圓點：聊天區滾動定位並短暫高亮對應提問。
* 按住拖動：快速滑動聊天記錄，拖動時右側浮出該提問的摘要小窗。

鏈面板¶

點擊會話標題行右側的 ≡ 開關，或窄條底部的 ⇱，可展開鏈面板。面板展示每個節點的摘要和時間。
* 分支/子會話：以子樹視圖掛載在主會話下。點擊節點可跳轉，需先切換到對應會話再定位高亮。
* 收起：點擊 ✕ 收起面板。

空會話處理¶

空會話不顯示右側窄條，但鏈面板始終可用，面板顯示“還沒有提問”。

技術實現¶

• 數據源：基於當前會話實時快照 + 持久歷史 (session.history)，切換會話時自動重建。
• 純前端：插件爲純前端實現，宿主僅保留最小 loader 入口。

安裝與啓用¶

通過 DSH 官方插件通道安裝：

dsh plugin --profile web add dsh-chat-index

安裝完成後刷新頁面即可生效。

使用步驟¶

1、打開任意會話，右側出現窄條（有提問時）。
2、點擊圓點或按住拖動，跳到對應提問並高亮。
3、點擊標題行右側 ≡（或窄條底部 ⇱）展開鏈面板，點擊節點跳轉，✕ 收起。
4、會話內的開關狀態各自記憶，刷新頁面後默認收起。

注意事項¶

• 安裝方式：手動安裝與官方安裝通道二選一，避免雙重掛載。
• 環境要求：需配置 NPM_TOKEN 才能自動發佈。

總結¶

dsh-chat-index 爲 DSH Web 提供了可視化的會話導航能力，特別是針對分支會話的子樹展示，能顯著提升長對話的查閱效率。