前言¶
在 DeepSeek Harness (DSH) 的生態中,智能體通過長期記憶來保持上下文一致性。隨着會話積累,記憶數據容易變得碎片化、冗餘或過時。dsh-dream 插件旨在解決這一問題,它復刻了 CC-HAHA 的 autoDream 行爲,專注於後臺記憶整合。與 dsh-memory 負責的“隨手記”不同,dsh-dream 負責定期對近期會話和已有記憶進行去重、更新過時信息、刪除矛盾內容以及修剪索引。
插件定位¶
這是一款獨立的記憶整合插件,由開發者 yihefeikong-rgb 維護。它不修改 dsh-memory 的代碼,而是與它共存,共享同一個存儲目錄。
核心功能¶
- 後臺定時整合:插件默認在積累 5 個會話或距上次整合經過 24 小時後,靜默觸發一次整合流程。冷啓動(首次啓動)時僅記錄時間,不會立即執行。
- 手動觸發:支持通過命令行或工具手動觸發。可發送
/dream命令(支持all或current參數),或在 agent 中調用memory_dream工具。 - 四階段整合流程:通過 Fork 子代理執行定向、收集近期信號、整合、修剪索引四個階段,輸出動作 JSON 並安全落盤。
- 安全機制:支持原子覆蓋與歷史版本快照(保留最近 20 份),使用
.dream-lock文件防止併發衝突,所有寫操作限制在記憶目錄內。
安裝與啓用¶
安裝插件需使用官方命令,安裝或修改配置後必須重啓 DSH 進程。
dsh plugin --profile web add C:\Users\huangxinyang\.dsh\plugins\dsh-dream
配置說明¶
配置可通過 DSH 設置面板(寫入 ~/.dsh/settings.yaml)或編輯 cordis.patch.yml 完成,修改後需重啓生效。
| 選項 | 默認值 | 說明 |
|---|---|---|
enabled |
true | 後臺自動做夢總開關 |
minHours |
24 | 距上次整合最小間隔(小時) |
minSessions |
5 | 距上次整合後最少新會話數 |
triggerMode |
hybrid | hybrid=時間或內容量先到先觸發 / gates=僅固定間隔 / volume=僅按內容量 |
minVolumeChars |
30000 | 內容量觸發閾值(近期待整合會話文本估算字符數) |
scanIntervalMinutes |
10 | 後臺門控檢查間隔(分鐘) |
scopes |
auto | auto=近期活躍項目+通用 / all=全部 / current=當前項目+通用 |
maxDigestChars |
60000 | 近期會話摘要上限(字符) |
maxMemoryChars |
80000 | 記憶正文參考上限(字符) |
maxTokens |
8192 | 子代理整合輸出上限;0=不傳,由宿主/模型決定 |
agentTimeoutMs |
900000 | 做夢子代理總超時(毫秒) |
agentTools |
[] |
做夢子代理可用的只讀工具列表 |
provider / model |
huoshang / deepseek-v4-flash-ga-260731 |
整合推理使用的模型 |
manualOnly |
false | true=只允許手動/工具觸發 |
storageDir |
~/.dsh/memory |
記憶存儲目錄(與 dsh-memory 共享) |
使用方法¶
- 啓動 DSH Web:
dsh web - 手動整合當前範圍:
/dream - 手動整合全部範圍:
/dream all - 手動整合當前項目範圍:
/dream current - Agent 調用:在 agent 側調用
memory_dream工具。
注意事項¶
- 插件獨立運行,不修改
dsh-memory。 - 共享
~/.dsh/memory/目錄,文件格式與MEMORY.md索引兼容。 - 整合推理過程使用火山模型 (huoshang)。
- 生態背景:此插件託管於社區目錄與 GitHub,與 DeepSeek / 幻方無官方從屬關係。
結語¶
dsh-dream 爲 DSH 用戶提供了自動化的記憶管理能力,通過後臺靜默整合和手動觸發的結合,有效維持了記憶庫的整潔與準確。