dsh-dreams
Manifest validDreaming memory for DeepSeek Harness: idle passes replay transcripts into quoted notes and a small always-injected brief
dsh-dreams:DeepSeek Harness 的「做梦」记忆
English | 中文
仿照 Anthropic 的 dreaming 机制、并吸收了 OpenAI「Dreaming V3」与 Zep/Mem0 的工程取舍: 模型空闲时回放会话原文,把经验压成一份很小的简报和一批带引文的笔记; 简报注入每个会话,笔记只在需要时检索,任何一条结论都能翻回原文。
设计全文(原则、取舍、数据结构、验收)见 DESIGN.md。
三层,各付各的成本
STATE.md 简报 ~0.6-2 KB 每轮注入 每次 pass 整篇重写
notes/*.md 断言 1-3 KB 检索时读取 有逐字引文才写得进来
session log 原文 原始 检索/回读 只读,永不修改
- 注入层只放能改变下一步动作的东西:关于用户的稳定偏好、在做的事、还生效的决定、陷阱、未结线索。参考型知识一律只检索。
- 简报的每条 bullet 必须以
→ slug指向一条已验证(带引文)且未作废的笔记。指针悬空就重建或清空, 所以简报永远不可能凭空断言。 - 引文必须能在该事件里逐字找到(归一化后),否则整个操作被丢弃。一次什么都不写 pass 是成功,不是失败。
六个工具
| 工具 | 用途 |
|---|---|
dream | 跑一轮整理:回放 → 提议 → 校验 → 落盘 → 重写简报。focus 收窄、force 重跑、dry_run 只看不改 |
dream_recall | 先搜笔记(带引文);笔记没命中时回退到原始会话日志 |
dream_evidence | 按 session#seq 打开事件窗口,核对一条记忆的出处 |
dream_remember | 当场写一条笔记,标记为未验证(下一轮用原文坐实后才进简报);type: profile 存用户偏好 |
dream_forget | 软删除到 trash;purge 连历史一起删 |
dream_restore | 列出版本、回滚到上一版 |
面板
左侧栏月牙图标 → 「做梦」页:
- 当前简报 + 简报预算条;笔记列表(类型/可信度/未验证/已作废标记、点开看引文);主题页
- 「运行记录」:最近 10 轮 pass,标注自动/手动触发,无新内容也留痕;逐轮变更与被拒原因、注入字节与估算 token
- 自动做梦:选「不自动(仅手动)」或「每天定时」——时间点可加多个(如 03:00、15:00),保存即生效,无需重启
- 做梦模型:从 DSH 已配置的 provider/model 里选,或跟随 agent 默认模型
- 累计花费与峰谷时段展示
记忆库
默认 %DSH_HOME%/storages/dsh-dreaming/(macOS/Linux 为 ~/.dsh/storages/dsh-dreaming/):
bank/STATE.md 注入层(每轮重写,别手改)
bank/INDEX.md 目录(不注入,给人看/给检索做种子)
bank/notes/<slug>.md 笔记:front matter + 正文 + 末尾 <!-- evidence --> 块
bank/wiki/<slug>.md 主题页,用 [[slug]] 互链
bank/history/<slug>/<ts>.md 每次写入前的旧版本(每 slug 保留 20 份)
bank/trash/<slug>.<ts>.md 软删除
dreams/<id>.json 每轮报告:会话、token、拒绝原因、简报结果
state.json 每会话水位线、lastDreamed、累计计数、面板设置的节奏与模型
笔记是普通 markdown,手改安全:下一轮会重新校验简报,没引文的笔记会降级、移出注入层。
从 v1 升级时自动迁移(按 tags 猜出 type,旧 sources 变成"有出处但无引文",因此先不进简报,等下一轮坐实)。
安装
在插件市场搜 "dsh-dreams" 或「做梦」一键安装,或手动:
- 插件 → 添加插件 → 本地目录 → 指向本仓库根目录(先 clone 到一个固定路径;安装是链接,不是复制,装后不要移动)。
- 或:
dsh plugin --profile <profile> add https://github.com/hehuifeng/dsh-dreams - 重启一次 DSH。依赖
@deepseek-ai/dsh-session-query-sqlite(默认启用)。 - 验证:出现
dream等六个工具,左侧栏出现月牙面板。默认只手动做梦;没有新内容的一轮不调模型、零花费。
隐私
所有记忆都以纯 markdown 存在本机 ~/.dsh/storages/dsh-dreaming/,不上传任何数据;模型调用只走你 DSH 里已配置的 provider。
配置
写在 profile 的 cordis.patch.yml 里本插件那一行(全部字段可选,面板里的「自动做梦」「做梦模型」设置优先于这里):
- id: dsh-dreams
config:
auto: daily # false(只手动)| true(事件驱动)| 'timer'(间隔定时)| 'daily'(每天定点)
dailyTimes: ['03:00'] # auto: 'daily' 的触发时间点,可多个
autoOffPeakOnly: true # 自动 pass 只在空闲时段跑(价格减半)
catchupOnlyWithNew: true # 没有新内容就不起 pass(挂着不花钱的关键)
maxDeferMinutes: 180 # 但最多推迟这么久,避免记忆过期太久
holidays: [] # 中国法定节假日 YYYY-MM-DD,用于判定空闲时段
debounceSeconds: 60 # 事件触发后等多久再跑,合并连续触发
intervalMinutes: 30 # 仅 auto: 'timer' 用
minIntervalMinutes: 10 # 两次自动 pass 的最小间隔(节流)
maxSessions: 6 # 单轮重放上限(新会话优先)
maxPassChars: 70000 # 单轮 transcript 总预算,超了少放几个会话
minSessions: 2 # 没有新事件时,补课几个最久没整理的
catchupCooldownHours: 6 # 同一个老会话多久内不重复补课
maxTranscriptChars: 24000 # 每会话 transcript 预算(头 35% + 尾 65%)
briefBytes: 2400 # 注入层硬上限(约 800 汉字 / 500 tokens)
maxOps: 16
maxNotes: 300
keepHistory: 20
maxTokens: 8000 # 要给推理留额度,否则答案会被截断
temperature: 0.2
provider: '' # 留空跟随 agent 默认模型
model: ''
reasoningEffort: '' # 留空自动挑该模型最低档位
root: ''
自动到什么程度
| 环节 | 是否自动 | 说明 |
|---|---|---|
| 注入简报 | 始终自动 | 每个会话、每个模型步都由系统提示拼进去;STATE.md 为空时不注册,零成本 |
| 整理(做梦) | 默认手动 | dream 工具 / 面板按钮 |
| ↳ 每天定点 | auto: 'daily' | 每天 dailyTimes 里的每个时间点跑一轮;面板可改、可加多个时间点 |
| ↳ 事件驱动 | auto: true | agent 转入 idle、以及新会话打开时,防抖 60s 后跑一轮;minIntervalMinutes 节流 |
| ↳ 间隔定时 | auto: 'timer' | 每 intervalMinutes 跑一轮 |
自动模式下没有新内容时不会调用模型:先比水位线,没新事件直接返回 nothing-new(会在「运行记录」里留一条,花费为零)。
挂着不动 = 0 账单。 daily 模式是进程内定时器:到点看一眼有没有新东西,没有就不看模型;DSH 没在跑则该时间点跳过,不补跑。
出问题时会怎样:连续失败会指数退避(20 分钟起,最长 6 小时),并且从第 2 次失败开始, 警告会直接写进简报注入每个会话——也就是说 agent 自己会看到"记忆可能已过期",可以当场重试或告诉你, 不需要你去翻日志。面板上同时有红色横幅。失败不会改水位线,所以下一轮会把同一批内容重做一遍。
重启后:简报、笔记、水位线、欠账(pendingSince)、失败计数、面板设置的节奏与模型选择全部在磁盘上;
正在跑的那一轮下次重做,不会写半截。
经济性:钱花在哪,以及怎么省
DeepSeek 官方价(deepseek-flash,元 / 百万 tokens,官方价格页):
| 缓存命中 | 缓存未命中 | 输出 | |
|---|---|---|---|
| 空闲时段 | 0.02 | 1 | 4 |
| 高峰时段 | 0.04 | 2 | 8 |
(用其它 provider 时面板上的花费为按此价表的估算,仅供参考。)
峰谷规则:北京时间周一至周五 09:00–12:00、14:00–18:00 为高峰(不含法定节假日);其余全部时间、 含周末与节假日全天,都是空闲,价格减半。(2025 年那套 00:30–08:30 错峰优惠已取消,不是现行规则。)
缓存规则:默认开启,按前缀完整匹配命中;只有请求末尾、公共前缀、固定 token 间隔处会落盘成 "缓存前缀单元"。结论只有一条:prompt 必须是"稳定前缀 + 追加可变尾巴",任何靠前的改动会让后面全部失效。
所以省钱的顺序是:
| 杠杆 | 做法 | 实测效果 |
|---|---|---|
| 1. 增量重放 | 已消费过的会话从水位线之后开始,只带 12 条重叠和最初那句请求 | 进行中的长会话 1775 个事件只送 48 个 |
| 2. 稳定前缀 | 顺序改成 system → 笔记 → 待审笔记 → 简报 → transcript → task,越易变越靠后 | 重试时 99% 命中(28 672 命中 / 178 未命中) |
| 3. 输出预算 | 操作数、正文、简报都封顶;reasoningEffort: low;截断时用 salvageJson 抢救完整操作 | 一次截断的 pass 仍写入了 5 条操作,而不是全部丢弃 |
| 4. 时段 | 自动 pass 只在空闲时段跑,最多推迟 180 分钟 | 价格直接减半 |
| 5. 总重放预算 | maxPassChars: 70000,超过就少放几个会话 | prompt 从 175 KB 降到 95 KB |
实测账单(deepseek-flash,全部空闲时段):
| 改之前 | 改之后 | |
|---|---|---|
| 单轮 prompt | 175 KB / 6 会话 | 95 KB / 3 会话 |
| 输入 | 25 707 未命中,命中 3% | 178 未命中,命中 99%(重试) |
| 单轮费用 | ≈ ¥0.047 | ≈ ¥0.021 |
绝对值本来就只有几分钱;真正值得优化的是"不要为没有新内容的会话付费"和"不要在长会话上重复付历史"。 面板上现在直接显示累计花费和时段。
已知限制
- 记忆是 profile 级的,不按 workspace 隔离;笔记带 workspace 标签,但简报是全局一份。
- 没有向量检索:< 300 条用关键词 + 标签 + 时间衰减,够用且可解释。
- 两个 Harness 实例同时写是 last-writer-wins(历史会保留两份),没有加锁。
- 一次 pass 只做一遍合成,没有 verifier 二遍;机器校验靠"引文逐字 + 简报指针"。
daily定时是进程内定时器,DSH 不在跑的时间点会被跳过、不补跑。
许可
Comments
Loading…
Similar plugins
by CuteSamurai24
Small file memory for DeepSeek Harness. The model writes markdown, the host injects it.
★ 0
MIT
JavaScript
Aug 18, 2026
dsh plugin --profile web add dsh-md-memoryby haitang1
Codex-like persistent memory for DeepSeek Harness: auto-injected memory summary, raw memory tools, and per-session rollout summaries distilled into a bounded global memory file.
★ 3
MIT
JavaScript
Nov 19, 2026
dsh plugin --profile web add @dsh-external/dsh-memoryby tluoluo
Persistent memory for DeepSeek Harness: per-conversation notes, selective injection, project memory, semantic Vault search + automatic retrieval.
★ 4
↓ 168/wk
MIT
TypeScript
Aug 16, 2026
dsh plugin --profile web add dsh-persistby guyuefangyuanl
Cross-session persistent memory for the DeepSeek Harness: a model-facing memory tool, an always-on index section, and a bundled maintenance skill.
★ 3
↓ 1.5k/wk
MIT
JavaScript
Aug 21, 2026
dsh plugin --profile web add dsh-memoryby HaydenSmith1121
Session-end memory for DeepSeek Harness: distils each turn into durable notes and recalls them per workspace
★ 0
MIT
JavaScript
Sep 18, 2026
dsh plugin --profile web add dsh-memoryby chenkezhen480
Semantic long-term memory for DeepSeek Harness: embedding-based retrieval over a persistent cross-session memory store, with model-facing tools, proactive per-question recall, automatic conversation summarization, and auto-selected embedding provider (apiKey present → API, otherwise local).
★ 0
Apache-2.0
TypeScript
Aug 17, 2026
dsh plugin --profile web add dsh-plugin-semantic-memory