前言¶
DeepSeek Harness 的生態以「一切皆插件」爲核心理念。在處理長對話時，開發者往往難以快速定位到特定的輪次或當前閱讀進度。dsh-conversation-minimap 是一個客戶端插件，由 bilbillm 維護。它爲 DeepSeek Harness 添加了類似 Codex 的對話列表麪包導航，通過可視化的標記幫助定位具體輪次。
核心功能¶
該插件通過註冊一個佈局中立的入口，在對話頭部提供導航輔助。主要功能包括：
- 可視化標記：每個引擎擁有的輪次對應一個標記，當前閱讀的輪次會被高亮強調。
- 交互預覽：鼠標懸停或鍵盤聚焦時，會彈出一個緊湊的預覽卡片；點擊、回車或空格鍵可滾動到該輪次。
- 信息展示：預覽卡片顯示用戶請求摘要、助手最新結果摘要、運行狀態（running, completed, failed, stopped）以及
ui-deliverables生成的文件路徑。 - 佈局適配：寬列顯示左側軌道，每個輪次有一個可視標記和可訪問按鈕；短歷史在軌道中心保持緊湊；長曆史隨可用高度逐漸展開；窄列使用緊湊頭部工具。
- 無侵入性：不替換對話主體，不改變寬度，不依賴 CSS-module 哈希，不抓取渲染後的文本。
安裝與啓用¶
需要構建源碼並添加到獨立的 Harness Web 配置文件中：
pnpm install
pnpm run build
cd C:\Users\lumoren\Documents\GitHub\deepseek-harness
pnpm dsh plugin --profile web add C:\Users\lumoren\Documents\GitHub\dsh-conversation-minimap
pnpm dsh web
使用示例¶
- 寬對話列：左側會出現軌道，每個輪次有一個可視標記和可訪問按鈕。
- 短歷史：標記在軌道中心保持緊湊的固定間距。
- 長曆史：標記隨可用高度逐漸展開。
- 預覽交互：聚焦或懸停顯示基於主題令牌的玻璃態預覽卡片，包含請求和結果文本及狀態。
- 禁用：若需在特定子樹中禁用，可在 HTML 標籤上添加
data-dsh-conversation-minimap="off"。
兼容性與注意¶
- 版本要求：目標爲 Harness 語義化對話合約
0.1.0-rc.5和0.1.0-rc.6。 - 主題支持：支持 light、dark、angelina-light 和 angelina-dark 主題，顏色取自
--dsw-alias-*令牌。 - 運動偏好：獨立於
dsh-motion，可通過data-dsh-motion="off"退出動畫；實時監聽prefers-reduced-motion。 - 性能：不使用輪詢、定時器或永久動畫幀，僅使用作用域在活動對話滾動區域的
MutationObserver。 - 許可證：MIT 許可證。
結語¶
該插件通過 Codex 風格的導航增強了 DeepSeek Harness 的長對話可讀性，適合需要在複雜對話流中快速定位的開發者。
