前言¶
在 DeepSeek Harness（DSH）裏跑長對話，幾十輪之後想回到「第 17 輪那個提問」，通常只能不停往上翻，在代碼塊和思考過程裏逐段找。Harness 原生會話視圖沒有按提問維度的快速索引，翻找成本隨輪次線性上升。
dsh-milestone 是社區維護的客戶端插件，在會話視圖右側掛一條圓點時間線：一個提問一個圓點，懸停看內容與元信息，點擊即跳轉。下面介紹它的定位、功能、安裝方式與使用注意。
這是什麼¶
dsh-milestone 由 SnowCrescenter-tech 維護，分類爲客戶端插件，通過 Harness 官方 slot 機制掛載，不修改 harness 源碼。當前 npm 版本爲 0.6.6，許可證 MIT。
一句話定位：像 Git 提交圖一樣，一眼定位每一次提問，一鍵跳轉到會話內任意位置。
核心功能¶
圓點時間線¶
每個用戶提問對應一個圓點，等距排列、不隨對話長度變形，顏色由淺入深標出先後。點擊圓點平滑跳轉到對應消息；懸停顯示消息預覽與元信息（時間、輪次、用時、TTFT、tok/s、模型、token 用量等）。滾輪可在里程碑條上直接滑動選點，視口內最近的提問會亮起白環。
全部提問列表¶
一鍵打開面板，按序號、輪次、預覽一次看全，點擊任意一條直接跳轉。打開時會自動加載整個會話的歷史，不必手動翻頁——對藏在最早期的消息，比在小圓點上逐個找快得多。
站內搜索與跨會話搜索¶
站內搜索框過濾圓點，匹配的是完整消息內容（不是 80 字摘要），即時顯示命中數 N/M。Enter 跳到下一個匹配，Esc 一鍵清空。
跨會話搜索調用 harness 原生索引，可搜索所有會話的消息內容，點擊命中結果直接打開對應會話（結果片段 ≤240 字符，最多 20 條）。
收藏書籤與深鏈接¶
懸停圓點點星收藏，刷新後仍在（按會話持久化到 localStorage）。頂部「★」一鍵只看收藏。跳轉時 URL 自動帶上 #msg= 錨點，刷新或分享後仍回到同一條消息。
效率輔助¶
- 鍵盤導航：
↑↓移動 ·Enter跳轉 ·Home/End首尾。 - turn 分組摺疊：長輪次折成一條，彙總圓點帶 ×N 徽標。
- 複製與 fork：一鍵複製提問全文，或從此處分支。
- 聚焦模式：淡化 / 摺疊思考與工具調用，強度可調。
- 個性化：強調色、圓點大小、距側邊距離、左右位置即調即存；中文 / English 一鍵切換。
安裝與啓用¶
要求 Node.js >= 24（harness 官方要求）。插件聲明的支持線爲 @deepseek-ai/dsh 0.1.1-rc.2。
從 npm 安裝（推薦）：
dsh plugin --profile demo add dsh-milestone
或從 GitHub 源碼安裝：
dsh plugin --profile demo add "github:SnowCrescenter-tech/dsh-milestone#main"
啓動 Web UI：
npx @deepseek-ai/dsh web # → http://127.0.0.1:3080
打開一個至少包含 2 條提問的多輪對話，會話視圖右側即出現里程碑條。
典型用法¶
- 快速回看某輪提問：在右側圓點時間線上懸停，看預覽與元信息卡片，點擊跳轉。
- 瀏覽整段會話結構：打開「全部提問」面板，按序號掃一遍，點任意條目直達。
- 在當前會話內搜關鍵詞：打開站內搜索，輸入關鍵詞，用
Enter在命中項間跳轉。 - 跨會話找回舊討論：用跨會話搜索，從命中結果打開目標會話。
- 標記重要提問：懸停圓點點星收藏，之後用頂部「★」篩選。
- 分享定位：跳轉後 URL 帶
#msg=錨點，複製鏈接即可讓他人直達同一條消息。
工作原理¶
插件採用雙半邊結構（空 node half + 掛載在 shell.overlay slot 的 client half），零侵入現有 UI：
shell.overlay (root scope)
└─ milestone.rail (session scope, 自聲明子槽)
└─ useSession 讀取會話快照 → 圓點列表 + 懸停 + 跳轉
數據源來自 harness 原生會話快照（消息列表、turn 元數據、分頁與運行狀態），跳轉以消息錨點做 DOM 定位，scrollIntoView 平滑滾動。書籤與工具欄偏好經 store.persist 按會話寫入 localStorage。
適用場景與注意¶
適合誰：在 DSH 裏經常跑多輪、長對話的開發者——調試智能體、反覆改 prompt、對比不同輪次輸出時，需要按提問維度快速定位。
已知限制（摘自官方 README）：
- 站內搜索只覆蓋當前已加載的消息窗口（初始 50 條）；更早歷史需先點頂部「···」加載後才能被搜到。「全部提問」列表不受此限。
- TTFT / tok/s 依賴 turn 位置數據，窗口外或未完成的 turn 不顯示。
- 書籤按會話隔離，不跨會話共享。
- fork 從選中消息所在輪次開始分支，不會自動打開子會話。
- 深鏈接目標若早於已加載窗口，會先自動加載更早歷史再定位；極端深的歷史可能定位失敗。
安全提示：插件以當前 dsh 進程權限運行，安裝前應檢查 GitHub 源碼 與 MIT 許可證，確認符合你的使用環境。SkillHub 社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-milestone 把長對話的「導航地圖」掛在會話右側：圓點時間線、全部提問列表、站內與跨會話搜索、書籤深鏈接，裝完即用。若你在 Harness 裏經常翻找某輪提問，可以按上面的命令裝上試一輪。
