项目记忆库 cuteG41cute/dsh-memory-db

🧠 dsh-memory-db

为 DeepSeek Harness 打造的项目级记忆数据库插件：自动沉淀每个项目的问答对话，并在每轮对话前智能检索注入相关历史记忆，让 AI 助手真正「记得」你的项目。

✨ 核心特性

- 🔄 静态常驻：普通插件形态（组合加载），随 DSH 启动自动运行，重启不丢、无需批准
- 🧭 分类器智能复用：启动判定前先查持久层——已存在分类子代理则沿用最近的一个（保留其判定上下文）、清理多余，不重复创建；关闭记忆库时自动释放全部分类子代理
- 🛡️ 分类器防误用：分类子代理禁止调用任何工具（toolFilter: { allow: [] }）并声明「仅做判定、不执行任务」；插件每轮体检——若发现它被当作普通子代理使用（会话中出现工具调用痕迹）或已不可用，立即弃用并重建，保证判定器始终「纯净」
- 🔒 主会话专属：记忆系统仅在主会话生效——子代理会话（origin='subagent' / delegationDepth>0）不跑分类器、不注入记忆、不入库、不显示工作流提示
- 📁 按项目独立记忆库：每个项目一个独立数据库（.dsh/memory-db/memory.json），互不干扰；支持项目级独立开关与全局默认值
- 📝 自动收集问答：自动配对用户的提问与模型回答，记录发生时间、所属会话标题及标题演变历史（初始标题 → 于某时变更为新标题）
- 🧭 三态智能分类器：每轮提问先由常驻子代理（B 通道）或主模型内联（A 通道）判断意图——
- recall（回忆需求）→ 强制标准注入
- continue（话题延续）→ 零注入，缓存全连续
- shift（话题转向）→ 单次任务轻量注入（5%）/ 常规话题标准注入（40%）
- 🔑 关键词直接检索：分类器提炼关键词 → 库内直接匹配 → 按时间近到远排序，精准命中
- 📊 上下文预算化注入：注入上限 min(40% × 窗口, 可用)，轻量 min(5% × 窗口, 可用)；历史 + 记忆 ≤ 60% 窗口；仅在注入回合触发动态历史压缩，连续对话零损耗
- ♻️ 缓存友好：字节级相同的注入自动去重复用，尾部追加不破坏前缀缓存命中
- 🛡️ 防污染：注入的记忆、网页搜索正文自动排除，不进入记忆库（避免重复记忆）；网址链接保留
- 🧪 数据正确性保护：① 注入时排除当前会话自己的历史（本会话内容已在上下文里，不重复喂）；② 问答配对按 turn 严格归属，且后台子代理完成通知之后的回复不会覆盖已收集的真实答案（避免「问题与答案错配、真实答案丢失」）；③ 分类通道默认 inline —— 不创建子代理，因而不产生 runtime 完成通知、不会额外唤醒主会话（通知唤醒的额外模型回合比判定本身更贵）
- 🌐 管理网页：http://127.0.0.1:3080/memory-db-admin —— 检索 / 筛选 / 增删 / 批量导入导出 / 一键去重 / 会话标题演变面板，一站管理所有项目

🏗️ 工作原理

用户提问 │ ▼ ┌───────────────────────────────────────────────┐ │ agent/pre-step 钩子 │ │ ① 三态分类器（B 常驻子代理 / A 内联降级） │ │ ├─ recall ──► 强制标准注入（关键词检索） │ │ ├─ continue ─► 不注入（前缀缓存全命中） │ │ └─ shift ──► single=轻量注入 / normal=标准注入│ │ ② 检索命中 → 记忆资料构造（原文近因优先 + 摘要收敛） │ │ ③ 预算控制 → 动态历史压缩（仅注入回合） │ │ ④ 注入「历史记忆参考」消息 → 模型结合记忆作答 │ └───────────────────────────────────────────────┘ │ ▼ 回合结束 → turn/end 事件 → 问答对自动入库

🧩 DSH 版本兼容

插件适配 dsh 0.1.x 与 0.2.x，靠运行时能力检测自动选择实现，不需要按版本装不同包：

| 依赖点 | 0.1.x | 0.2.x（0.1.7-rc.2 起） | 本插件做法 |
| 开关存储 | settings.register() / settings.get() | 已移除（改为插件 static Config + 组合条目 id + volatile 字段） | 检测到方法存在就用 settings；否则自动降级到 ~/.dsh/dsh-memory-db-switches.json |
| 会话事件 | session.events（Map） | 已移除，改为 session.snapshotEvents() | 统一封装 sessionEvents()，两版都能取 |
| 客户端通道 | webServer 路由 + fetch | 同 | 不变 |
| 工具注册 | ctx.tools.register | 同 | 不变 |

取舍说明：0.2.x 上不会出现在「设置 → 插件」的表单里（那需要声明 static Config 并走 volatile 写入契约）；但所有开关入口照常可用——会话头部芯片、管理网页、memory_admin 工具。

🚀 使用

安装（静态常驻版，开机自启）

插件以普通插件（静态组合插件）形态运行，随 DSH 进程启动自动加载，重启不丢、无需批准：

1. 安装包体：将 static/ 目录内容复制到 DSH profile 的 node_modules：示例:web profile
Copy-Item static\package.json $env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-memory-db\
Copy-Item static\lib\* $env:USERPROFILE\.dsh\profiles\web\node_modules\dsh-memory-db\lib\

2. 注册组合行：在 ~/.dsh/profiles/web/cordis.patch.yml 追加：
- insert:
- id: dsh-memory-db
name: 'dsh-memory-db'

3. 重启 DSH（组合变更需重启生效），刷新浏览器页面。

从 v0.1.0 动态版升级：首次启动自动迁移旧开关状态（storageDomain memory_db 域 / 项目 config.json → settings.yaml），现有项目开关与记忆数据不丢失。

开启记忆库

- 会话顶部点击「记忆库」胶囊按钮切换当前项目
- 设置 → 通用配置全局默认开关
- 或调用 memory_admin 工具：enable / disable / status

模型侧工具

- memory_search：按关键词直接搜索历史问答（问题、回答、时间、会话标题与演变历史）
- memory_admin：开关管理与状态查看（含生效窗口、预算、分类通道、统计）

管理网页

浏览器打开 http://127.0.0.1:3080/memory-db-admin

- 模糊检索、按项目 / 时间筛选、分页浏览
- 手动添加 / 成对删除 / 批量导入（兼容导出格式）
- 按筛选条件导出 JSON
- 一键去重（问题+回答完全相同）
- 会话标题变更历史面板

📁 项目结构

dsh-memory-db/
├── static/ # 静态常驻版（推荐，开机自启） │ ├── package.json # npm 包声明（dsh.client 客户端注入） │ └── lib/ │ ├── index.js # Host: Service 类（收集/分类器/注入/API/管理网页） │ └── client.js # Client bundle（头部开关/记忆管理/设置项） ├── plugin/ # 动态版源码（原型/历史参考） │ ├── host.js │ └── client.js ├── cordis/ # 动态插件构建脚本（开发用） ├── docs/ │ ├── 上下文优化改进方案.md # 设计文档（预算 / 分类器 / 缓存策略） │ └── 实现与排查经验.md # 开发者文档：API 契约坑、通知污染机制、排查手册 └── README.md

🗺️ 路线图

- [x] 项目级记忆库 + 自动收集 + 关键词搜索
- [x] 三态分类器（recall / continue / shift）+ 双通道（子代理 / 内联）
- [x] 上下文预算化注入 + 动态历史压缩 + 缓存去重
- [x] 管理网页 + 会话标题演变
- [x] 普通插件化，开机自启（静态常驻版 v0.2.0）
- [ ] 记忆条目标注 / 手动修正
- [ ] 跨项目记忆共享（可选）

📄 License

MIT