持久记忆库 boomzikazita/dsh-memory

dsh-memory

为 DeepSeek Harness（dsh）打造的持久记忆系统。以 dsh 插件形式提供多路召回、确认制写入、加密密钥库、会话转录和维护工具。

记忆系统插件：RRF 多路召回 / 确认制写入 / Fernet 加密库 / 会话转录 / 维护工具。

功能

- RRF 五路召回 (five-way RRF recall) — 把 L1 规则（MEMORY.md / USER.md）、L2 会话 FTS5、L3 语义（可选 Honcho/MCP）、L4 wiki、L5 时间窗口这几路证据融合成一份排序后的证据账本，每条都带信任标签。
- 确认制写入 (confirm-before-write) — 任何东西都不会直接改动你的记忆：memory_suggest 把提案排进队列，memory_confirm / memory_reject 决定是否采纳。预算检查、敏感模式扫描和自动 trigger: 标签共同把关，决定什么能进 L1。
- Fernet 加密库 (encrypted vault) — 密钥存放在 Fernet 认证的加密存储里（VAULT.md.enc）；明文只以 → vault:<ref> 引用的形式出现。
- 会话转录 (session transcription) — 增量把 dsh 会话日志索引进 FTS5 存储，并提取纠错信号用于技能蒸馏。
- 维护工具 (maintenance) — 健康检查、git 备份、命中审计，以及资产去重检查。

工具

| 工具 | 说明 |
| memory_recall | 五路 RRF 召回，带来源标签和信任等级；date= 用于时间窗口查询，deep=true 用于更深召回 |
| memory_graph | 实体图遍历（人工整理的关系边 + 自动生成的共现边） |
| memory_suggest | 把一条记忆写入提案排进队列（track：memory / user / skill；lifecycle：rule / stable / situational / record） |
| memory_confirm | 采纳待处理提案，写入 MEMORY.md / USER.md / skill |
| memory_reject | 拒绝待处理提案 |
| memory_vault_get | 读取一条加密库条目 |
| memory_vault_set | 写入一条加密库条目 |
| memory_harvest | 把 dsh 会话日志转录进 L2 FTS5 索引，并提取纠错信号 |
| memory_health | 每层一行的健康报告（L1 预算、加密库可解密性、L2 索引、图新鲜度、待处理队列） |
| memory_backup | 对记忆目录执行 git commit + push |
| memory_notify | 推送消息到飞书/Lark 会话（需要凭据，见下文） |
| check_assets | 创建新脚本/技能/插件/自动化之前做去重检查 |

安装

dsh plugin --profile web add github:boomzikazita/dsh-memory

插件会自动注册自己的工具和钩子（primer 召回注入、写入守卫、回合结束转录）。scripts/ 下的 Python 脚本由 Node 宿主按需执行。

配置

bundle 补丁（cordis.patch.yml）以默认值挂载插件；可按配置档覆盖，例如：

- insert:
- id: dsh-memory
name: 'dsh-memory'
config:
memoryDir: '~/.dsh/memories'
scriptsDir: '~/.dsh/plugins/dsh-memory/scripts'
wikiRoot: '~/wiki' # env DSH_WIKI_ROOT also works
guardBlock: false
primerBudget: 800
primerTopK: 3

关键路径（都可覆盖）：

| 配置项 | 默认值 | 说明 |
| memoryDir | ~/.dsh/memories | L1 文件、FTS5 索引、vault、outbox |
| scriptsDir | 插件 scripts/ 目录 | Python 辅助脚本 |
| wikiRoot / DSH_WIKI_ROOT | ~/wiki | L4 通道使用的 Obsidian/wiki 根目录（raw/、_meta/、entities/ 都在它下面） |

依赖

- Node 侧：@deepseek-ai/dsh-tools 和 @deepseek-ai/dsh-llm（声明为 peer dependencies，>=0.1.0-rc.6）。
- Python 侧（可选，用于 recall/graph/vault/harvest 功能）：Python 3 加标准库；SQLite 3。vault 还需要 cryptography（Fernet）。没装 Python 时，工具会优雅降级并给出错误信息。
- 飞书/Lark 推送（memory_notify / scripts/feishu_push.py）：设置 LARK_APP_ID / LARK_APP_SECRET（环境变量或 ~/.env），可选设置 LARK_DEFAULT_CHAT 指定默认会话目标。
- L3 语义召回（可选）：把 DSH_HONCHO_MCP_URL / DSH_HONCHO_MCP_TOKEN 指向暴露 honcho_search 的 MCP 端点。不设置 → 静默跳过 L3。

许可证

MIT —— 见 LICENSE。Copyright (c) 2026 boomzikazita。