在複雜的工程對話中,開發者頻繁在多個會話或外部窗口間切換。切回時往往需要重新梳理思路。dsh-session-recap 旨在解決這一問題,它在後臺追蹤頁面可見性與空閒狀態,當達到設定閾值時自動提煉任務核心,並在重新切回時通過結構化卡片輔助召回。
插件定位¶
這是一個面向 DeepSeek Harness (DSH) Web 的長程任務會話智能回顧擴展,由開發者 DDDFXYqiming 維護,採用 MIT 許可證開源。
核心功能¶
- 多端會話感知:通過心跳機制精準聚合追蹤瀏覽器的 active 與 away 狀態。僅在當前會話失焦且滿足 idleMs(默認 3 分鐘)與 minTurns(默認 3 輪)閾值時觸發,避免無效開銷。
- 零侵入持久化:回顧內容以獨立 Sidecar 文件形式存儲於
~/.dsh/plugin-data/dsh-session-recap/,不佔用主模型上下文 Token。 - 動態內容契約:自動剔除沉餘的工具日誌,以最近用戶指令爲錨點提取壓縮摘要。
- 安全邊界:內置專有 API 路由防護,嚴格校驗 Loopback 本地迴環、精確 Host 匹配與 Same-Origin 來源,防範 DNS Rebinding 等風險。
- 雙模支持:Web 界面以卡片形式優雅呈現,支持一鍵隱藏;Headless 模式支持通過
/recap終端指令直接回傳純文本。
安裝與啓用¶
通過 DSH 插件系統安裝,執行以下命令:
dsh plugin --profile web add github:DDDFXYqiming/dsh-session-recap
安裝後重啓 Web Profile 並刷新瀏覽器即可生效。
典型用法¶
- Web 模式:切回會話時,輸入框上方會即時呈現結構化回顧卡片,方便快速召回思路。
- Headless 模式:在無界面配置下,可使用
/recap終端指令直接獲取純文本回顧。
配置指南¶
插件支持在對應 Profile 的 cordis.patch.yml 中自定義規則。默認配置如下:
- id: dsh-session-recap
config:
enabled: true
hostCommand: false
idleMs: 180000
minTurns: 3
recentMessages: 80
maxChars: 400
maxInputChars: 24000
maxOutputTokens: 2048
timeoutMs: 30000
provider: ''
model: ''
適用場景與注意¶
該插件適合需要在長時間對話或頻繁切換窗口場景下保持上下文連貫的開發者。使用前需確認當前 dsh 進程權限,並建議檢查源碼與許可證(MIT)。
總結¶
dsh-session-recap 通過後臺靜默追蹤與智能摘要,爲 DSH Web 提供了輕量級的記憶輔助,有效緩解了長程任務中的上下文斷層問題。
生態目錄:dsh-session-recap
GitHub 倉庫:DDDFXYqiming/dsh-session-recap