分层记忆管家 a903067276-rgb/dsh-simple-memory

dsh-simple-memory 🧠

Awesome DSH Plugin

面向 DeepSeek Harness（dsh）web 的简单记忆管家：检索式记忆，存储零代码。不建数据库、不搞向量检索——就是"组织好的 md 文件 + 一个只管入口的薄插件"。正常干活不受打扰，记忆作为外挂文件系统在旁边积累，规则时不时提醒你记一笔。

状态：核心链路已通（0.2.0），真实使用效果待长期测试——测试流程与结果见 docs/全链路验证记录，设计原理见 docs/记忆系统设计说明。

非官方项目：社区成员独立开发维护，非 DeepSeek 官方产品。

截图

记忆按钮（输入框左侧灯泡）：点一下弹出四动作菜单——联想（回顾本轮列候选，等你确认才写）/ 升格（整理暂存池与做梦池，提议去向）/ 查记忆库（列表 + 搜索 + 读全文）/ 做梦（随机组合记忆找跨界洞察）：

记忆按钮的四动作菜单

记忆库浮层（菜单里选「查记忆库」）：就地弹出——项目/全局分组 + 搜索框 + 点开读全文，顶部带三个池子计数（全局 · 暂存池 · 做梦池）；再点灯泡、点 ×、或点界面其他位置都会收起：

记忆库浮层

记忆管理页（设置 → 记忆）：状态总览、记忆根目录配置、平级项目列表 + 全局，点开即读：

记忆管理设置页

功能

| 操作 | 效果 |
| 开会话 | 自动注入三段式记忆索引（当前项目进度正文 + 最近动过 6 条 + 其余分类计数），每会话首轮一次——模型既"想得起"有什么，也看得到项目现状 |
| 点记忆按钮 | 弹出四动作菜单：联想（回顾本轮 → 列值得记的候选 + scope + 理由 → 等你确认才写）/ 升格（整理 staging 与 dreams 两个池子 → 提议去向 → 确认后执行出池）/ 查记忆库（就地浮层：分组列表 + 搜索框 + 点开读全文）/ 做梦（随机组合 3~5 条记忆找跨界洞察，产出进做梦池等确认） |
| 写记忆 | memory-write 工具强制格式（文件名 分类-主题.md、≤2KB、日期首行；scope=项目/全局） |
| 记录节奏（2026-10-01） | 新增记忆不必每轮征求同意（模型自己判断"该记"就直接写）；合并/覆盖已有记忆、归档、staging→common 升格前必问用户；跨项目经验直接追加进 staging |
| 进度自动记录（2026-10-01） | 会话有活动时，插件自动把 progress/<项目>.md 末尾的「（自动记录：…）」行更新成当前时间（零 token、5 分钟节流、只更新已存在的文件）；正式内容仍由模型用 memory-progress 润色 |
| 自动做梦（2026-10-01） | 到期（默认 7 天）由插件自己用便宜模型（默认 deepseek-flash）跑一批，产出只进 dreams.md 的 [自动][待确认]；升格仍要你点头。设置页可关（dreamAutoRun）或换模型（dreamModel） |
| 浏览记忆 | 输入框浮层或设置页内嵌：所有项目平级列表 + 全局 common/，带搜索框，点开即读全文 |
| 做梦池 | dreams.md 暂存梦到的洞察（入场记忆 + 连接 + 建议去向 + 状态）；用户确认后才升格进 common/ 或对应项目——机制同 staging：暂存 → 确认 → 升格 |
| 跨会话检索 | memory_session_search 工具按关键词搜历史会话正文（返回时间 / 工作区 / 标题 / 命中片段）；需先在 profile 打开官方会话全文索引 |
| 初始化 | 设置页一键建目录骨架（common/projects/references/archive/staging）+ git init |
| 改位置 | 设置页改记忆根目录——经官方设置服务写进插件自己的 profile 条目 config，改完即时生效、无需重启（DSH ≥ 0.1.7；老宿主回落改 patch 文件，那条路径仍需重启） |

安装

DSH 0.1.7 及以后：
dsh plugin --profile web add "github:a903067276-rgb/dsh-simple-memory#main"
DSH 0.1.5 及更早（本版需要 0.1.7+）：
dsh plugin --profile web add "github:a903067276-rgb/dsh-simple-memory#v0.3.8"

装完重启 dsh web，设置 → 记忆 → 初始化记忆仓库。
手动兜底安装：见 docs/install.md。

用法

- 记忆按钮（输入框左侧灯泡）——点一下弹出四动作菜单（指令自包含，不依赖 AGENTS.md）：
- 联想：回顾本轮对话 → 列出值得记的内容（决策/踩坑/新约定/偏好）并标明 scope（项目/全局）+ 理由 → 等你确认后才写 → 贴产出物 → commit。
- 升格：读 staging.md（升格暂存池）与 dreams.md（做梦池）→ 逐条判断去向（升格进 common/ 或对应项目；重复/已被替代的建议弃用）→ 提议给你确认 → 确认后执行升格并出池。
- 查记忆库：就地弹出浏览浮层（项目/全局分组 + 搜索框 + 点开读全文），不占用对话轮次。
- 做梦：从全库随机抽 3~5 条记忆做跨界组合，找共性模式 / 矛盾过时 / 迁移机会 / 空白 → 最多产出 2~3 条洞察 → 写入做梦池（含建议去向，状态「待确认」）。
- 设置 → 记忆——状态总览（全局条数 · 暂存池 · 做梦池）、记忆根目录配置、一键初始化仓库、内嵌浏览（所有项目平级 + 全局，点开即读）。

平台支持

| 平台 | 状态 |
| macOS | ✅ 开发环境 |
| Linux | ⚠️ 预期可用（纯文件操作），未实测 |
| Windows | ⚠️ 预期可用（纯文件操作），未实测 |

环境要求

- DSH web（≥ 0.1.0-rc.6）
- 版本兼容（尽力兼容——设置卡片用双字段 key+id 注册，同满足 rc.6（id 契约）与 rc.7+（key 契约）；已在本地实测 rc.6/rc.8/0.1.1-rc.2/0.1.5-rc.1，不保证每个 DSH 版本）：
- DSH 0.1.0-rc.6 及以上（含 0.1.1-rc.1/rc.2）：装 main（默认）。
- DSH 0.1.5-rc.1：加载实测通过（插件已进客户端 bundle、host 半加载、设置分区渲染）；记忆读写走自有 /api/dsh-simple-memory 路由，不依赖 0.1.5 变更过的契约。UI 交互未逐项肉眼复测。
- 保守回退（升级前的最后版本）：DSH 0.1.0-rc.7/rc.8 → v0.2.5（dsh plugin add github:a903067276-rgb/dsh-simple-memory#v0.2.5）；DSH 0.1.0-rc.6 → 冻结 rc6-compat（不再维护）。
- git CLI（可选：没有 git，记忆目录就是普通文件夹）
- ✅ DSH 0.1.7 及以后——装本版（v0.7.1）：它声明了 peerDependencies: {"@deepseek-ai/dsh": "^0.1.7-rc.1 || ^0.2.0-rc.1"}，宿主不匹配会明确拒绝加载并说明原因，不再静默出错。配置迁到 0.1.7 的插件 Config（.volatile() 字段可即时生效），改完不用重启。
- ✅ DSH 0.2.0-rc.1——已验证兼容：peer 范围同时覆盖两条线（^0.1.7-rc.1 || ^0.2.0-rc.1），@deepseek-ai/dsh-tools 的 peer 也追加了 || ^0.2.0-rc.1；dsh.compatibility.dshReleases 矩阵新增 "0.2.0-rc.1": "compatible"——已在 0.2.0-rc.1 真机 + 影子实例验证。0.2 起宿主对 profile bundle 做 peer 门禁，范围不覆盖当前运行时会整个跳过加载，靠这个范围插件才会被加载。
- ⚠️ DSH 0.1.5 及更早——请装上一版 tag v0.3.8：那条线保持原行为，不含任何 0.1.7 专用 API。
- ⛔ 旧版本插件（≤ v0.3.8）在 0.1.7 上不受支持——每个会话的首轮直接失败（会话格式 V4 拒收旧的注入消息 source），设置也会失效。插件要跟宿主一起升。
- 维护策略：本插件将持续跟随 DSH 最新版本演进；对旧版 DSH 的兼容仅是尽力而为、不保证长期有效。

工作原理

检索式记忆：文件即存储，插件只管入口。完整设计见 docs/记忆系统设计说明。

- 存储（零代码）：记忆统一收在记忆根 ~/Documents/DSH/memory/（设置页可改）： memory/ ├── common/ 全局经验（活跃区，跨项目复用） ├── projects/<项目名>/ 项目经验（首次写入自动建目录） ├── references/ 冷区：参考资料（命中搜索才读） ├── archive/ 冷区：被遗忘移出的旧记忆 ├── staging.md 升格暂存池（跨项目复用候选） └── .git/ 整个记忆根一个 git 仓库——回滚保障

项目记忆不落项目目录（.gitignore 掉 memory/ 会挡住 grep）——收在共享根，发布隔离天然成立、检索全局覆盖。

- 索引注入（想得起，三段式）：每会话首步（agent/pre-step）注入——① 当前项目进度正文（progress/<项目>.md，让接续时看到真实现状而不是滞后状态；超 14 天标"已滞后"，时间给到分钟/小时）；② 最近动过的 6 条记忆（标题 + 首行结论，跨项目 + 全局按 mtime，让"最近踩过的坑"自动浮现）；③ 其余只给分类计数 + 检索入口（要哪条用 memory_search 检索，不通读）。docs/ 保留文件名——它在记忆根之外，检索覆盖不到。实测注入约 2536 字符 / 2024 token（cl100k 口径，DeepSeek 中文分词约 1450~1700），且不随记忆条数增长。冷区（references/、archive/）不注入，命中搜索才读。

- 写入工具（记得住）：memory-write 强制格式（文件名 分类-主题.md、首行日期、≤2KB、分类开放自造：踩坑/流程/决策/偏好/背景起步）；scope 二选一（项目/全局）。写工作区外自动弹审批（= 写入前确认）。

- 记忆按钮（四动作菜单）：输入框左侧灯泡，点击弹出——联想（回顾对话 → 逐条提议并标 scope（项目/全局）+ 理由 → 等确认 → memory-write 写入 → 贴产出物 → commit）/ 升格（整理 staging + dreams 两个池子 → 提议去向 → 确认后执行出池）/ 查记忆库（就地浮层：分组列表 + 搜索 + 读全文）/ 做梦（随机抽 3~5 条记忆跨界组合 → 最多 2~3 条洞察 → 写入做梦池待确认）。

- 设置页可改（v0.7.0）：记忆根目录之外，自动提交开关、定期做梦的间隔与条数也在设置卡片里改，保存走 profile 条目 config（volatile → 即时生效、不用重启）。
- 设置页（管理+浏览）：状态行（活跃条数 · staging 条数 · 做梦池条数）、记忆根目录配置、一键初始化骨架（含 staging.md / dreams.md 模板）、内嵌浏览（所有项目平级 + 全局，点开即读）。

- 检索（找得到）：不建索引文件，agent 的 grep 直接搜整个记忆根（所有项目 + 全局 + 冷区），先活跃后冷区。

- 跨会话检索（问得到"上次聊过什么"）：memory_session_search 调官方会话全文索引（session-query-sqlite），返回命中会话的时间 / 工作区 / 标题 / 命中片段。
- 前置：profile 的 cordis.patch.yml 把 session-query-sqlite 的 openAt 覆盖为 first-search（建议同时配持久 path），重启 dsh 生效；索引没开时工具返回可操作提示，不算错误。
- 已知限制（2026-09-10 实测）：官方索引建库是全量扫描历史会话，任何一条读不动的老日志都会让检索整体失败（session-search persistence observation failed: …）。实测本机 150 条会话里 27 条 v0 老格式日志会触发（多为 subagent/descriptor … uses unsupported descriptor version 2，另有手工修过的 chunk provenance）；把这些日志移出 sessions 目录后检索恢复正常。验证记录：docs/验证记录-2026-09-10-session_search.md。

- 升格（跨项目复用）：项目经验看着可复用 → 入 staging.md（低摩擦，不逼当场决策）；池子非空提醒（索引尾部 + 写入工具提示）→ 用户点头 → 提炼入 common/ 或对应项目 → 出池删条目。

- 定期自动做梦（2026-09-26 新增）：dreamEveryDays（默认 7 天）到期时，插件在当次会话的首步注入里点名：本轮做 dreamBatch（默认 2）个梦。产出照旧写进 dreams.md、条目带 [自动][待确认] 便于和手动梦区分。不在后台偷偷发 LLM 请求（也就不在你没看着的时候花钱），只在有会话时提醒；上次触发时间记在 <记忆根>/.dream-state.json。
- 做梦（随机组合找洞察）：从全库纯随机抽 3~5 条记忆做跨界组合，找共性模式 / 矛盾过时 / 迁移机会 / 空白；产出写 dreams.md（含建议去向 + 状态「待确认」），用户确认后才升格——与 staging 同一套下游动作（暂存 → 确认 → 升格）。联想策略（2026-09-13）：抽样保持纯随机，但优先从「零碎经验」（踩坑 / 未消化的原始记录）下手，成熟决策之间硬凑的连接要克制；产出的结论必须是入场记忆原文里都没明说的，只是复述原文不算洞察——抠不出真东西就直说"这次没梦到"，池子留空。

- 池子计数统一规则（2026-09-13 定）：索引尾部提示与设置页的池子计数只算待处理条目——dreams.md 里标了 [已弃]/[已采纳] 的行、以及任何非 - 日期 格式的留痕都不计入；漏标状态的条目照常计入（宁可多提示，绝不漏提示）。留痕推荐写成 （已弃：…） 这类非条目格式。

- 遗忘（上下文保鲜）：过期的活跃记忆移入 archive/（软删除：还在硬盘，只退出索引）。上下文永远清爽，硬盘永远完整。

- 自动提交（2026-09-26 起由插件自己做）：memory-write / memory-progress 写入成功后，插件在记忆根里自动 git add -A && git commit（信息 mem: <操作> <对象>）。此前这条只写在四动作的提示词里（"顺手 commit"），模型一忘就攒着——现在不依赖模型自觉。想关：profile patch 里给条目加 autoCommit: false。
- 提交状态看得见（v0.6.1）：工具结果里直接写「（已自动提交）」或「（⚠ 自动提交失败：原因）」。背后是一处真坑——官方 shell 的 result() 对非零退出不抛错，只回一个带 exitCode 的对象，不看退出码就会"提交失败却报成功"（v0.6.0 就是这样在桌面端静默失败的）。
- 自检路由（v0.6.1，只读）：GET /api/dsh-simple-memory/selftest 会跑 git --version / rev-parse --is-inside-work-tree / status --porcelain / commit --dry-run，并各跑「不带会话策略」与「带会话策略」两组，返回真实 exitCode / stdout / stderr——排查"到底哪一步不行"用。
- 回滚：有了自动提交，写错一个 git checkout 回来即可。

注意事项

- 记忆 git 仓库仅本地，不推远端
- 写记忆在工作区外会弹审批（= 写入前确认，符合记忆规范）
- 四动作指令（联想 / 升格 / 做梦）均自包含，不依赖全局 AGENTS.md；AGENTS.md 里的判断标准仅作参考

许可证

MIT