前言¶
DeepSeek Harness Web（npx @deepseek-ai/dsh web）在處理長對話時，用戶往往需要頻繁滾動才能定位上下文或理解會話走向。dsh-conversation-outline 插件在 DSH-better-sidebar 側邊欄註冊了一個「對話大綱」標籤，將當前會話按輪次結構化展示，併爲每一輪生成 LLM 標題，支持一鍵跳轉。
插件簡介¶
- 名稱：
dsh-conversation-outline - 維護者：YesSanSan
- 定位：靜態 DSH Web 插件
- 許可證：MIT
- 核心價值：提供會話結構概覽與快速導航，減少滾動操作。
核心功能¶
-
按輪次結構化大綱
插件將當前會話按輪次分組，展示用戶消息、助手回覆、工具調用（連續調用自動合併爲可摺疊分組）、壓縮檢查點及錯誤行。 -
一鍵跳轉
點擊大綱中的任意條目，自動加載歷史並滾動到聊天視圖或軌跡視圖的對應行。 -
LLM 一句話標題
利用 Host 的llm.stream接口生成標題（不創建 subagent），按內容指紋緩存，分支會話前綴相同即可複用。 -
標題生成完全並行
已結束輪次即時生成，即使 Agent 仍在處理後續輪次；僅當前進行中的輪次等待本輪結束。 -
可配置
標題模型、推理等級、併發數、單次超時、失敗重試、禁用開關均在齒輪設置中持久化。 -
窄面板自動收縮
面板寬度 ≤360px 時，行內類型標籤自動從文字收縮爲圖標（懸停顯示文字），與軌跡視圖行爲一致。
安裝與啓用¶
直接安裝到 web profile，無需手動 clone：
npx @deepseek-ai/dsh plugin --profile web add github:YesSanSan/dsh-conversation-outline#main
重啓 DSH：
npx @deepseek-ai/dsh web
打開 better-sidebar 的 + 菜單，選擇「對話大綱」。
配置項¶
配置持久化到 better-sidebar pluginSettings['conversation-outline']。
| 鍵 | 默認 | 範圍 | 含義 |
|---|---|---|---|
model |
'' |
— | 標題模型；空 = 跟隨主會話模型 |
reasoningEffort |
'' |
off / low / medium / high / max | 推理等級；空 = 跟隨會話 |
maxConcurrency |
3 |
1–8 | 客戶端併發生成標題的 worker 數 |
timeoutSeconds |
60 |
5–300 | 單次嘗試超時；對整個嘗試生效 |
maxRetries |
2 |
0–5 | 失敗重試次數（退避 0.8s 起，封頂 5s） |
disabled |
false |
— | 完全禁用標題生成 |
權限與數據¶
- 會話日誌：Host 通過
ctx.sessionQuery（readSession/listEvents）只讀當前會話日誌構建大綱，不回寫。 - LLM 調用：標題生成只把當前輪可見文本（用戶 + 助手塊，去掉工具調用，截斷）發送到配置的模型路由。
- 瀏覽器存儲：標題緩存於
localStorage（dsh-conversation-outline-titles:v1）。 - 網絡訪問：除配置的模型 provider 外無其他網絡訪問。
注意事項¶
- 依賴版本：插件依賴
dsh-better-sidebarv0.12.0+（需要settings.render與pluginSettings支持）。npm 上的dsh-better-sidebar可能仍是 0.11.0，v0.12.0 功能需從源碼構建後鏈接到 profile。 - 進程重啓：安裝或更新後需完整重啓
npx @deepseek-ai/dsh web才能生效。 - 安全反饋：安全問題請通過 Issues 私密反饋，或先郵件聯繫作者，再公開披露。
生態位置¶
- GitHub：https://github.com/YesSanSan/dsh-conversation-outline
- 生態目錄：https://www.skillhub.cn/plugins/YesSanSan/dsh-conversation-outline
