M-24rjgc / dsh-memory

Mneme · dsh-memory

Mneme（Μνήμη，记忆女神）是一个完完全全建立在 DeepSeek Harness（DSH）之上的记忆系统。

范式一句话：

记忆不是数据库，而是一个编译器：唯一持久化的是 DSH 事件日志（经验源码），记忆是由可组合编译 pass 从 (经验日志, 时空坐标, 任务) 编译出来的、带溯源与证据条件的可执行上下文。

规划中的每一层都已实现，没有“未来工作”占位：事件源、投影、版本/证据分析、LLM 抽取与整合（opt-in）、向量/图候选索引、上下文重建、反馈回路、分层分配、链接演化、结构化技能生成。LLM 相关 pass 需要 provider/model 配置；未配置时保持 keyless 确定性路径。

• 记忆账本本身是一个 DSH Session（事件溯源、可持久化、可检索、可 fork、可压缩）；
• 记忆操作是账本里的 user/message 表面事件，机器载荷放在 merge-extensible 的 kind: 'memory' source 中；
• 遗忘、整合与 versionKey/函数谓词冲突遮蔽都用 DSH 原生 surfaceOp: replace；旧修订永存，memory_trace 可追溯；
• 召回 = replay/vector/graph 候选发现 → 版本/证据检查 → 命中内容/片段/原文 reinstatement → 以 DSH 预置的 form: 'recall' 呈现；
• 语义/程序/前瞻/情景/元记忆是同一 IR 上不同编译 pass；
• 程序记忆经 emit-skill 编译为结构化 SKILL.md，注册进 ctx.skills。

详细设计见 docs/design.md。

编译 pass

包	角色
@dsh-memory/ir	Service Definition：MIR、ctx.memory、纯 fold、ledger 会话、索引器注册、分层分配
@dsh-memory/index-replay	FTS/字面检索 + 原文窗口 reinstatement
@dsh-memory/index-vector	向量候选索引（确定性向量，可选远程 embedding）
@dsh-memory/index-graph	事实图谱候选索引（PPR 式扩散）
@dsh-memory/lower	确定性 lowering：session/event → MIR
@dsh-memory/extract	RecMem 复发门控的 LLM claim 抽取
@dsh-memory/solve	版本消解 + 证据条件 + 函数谓词冲突
@dsh-memory/optimize	TTL 遗忘 + 最低激活整合 + 预算硬限
@dsh-memory/consolidate	CLS 式重放总结（LLM，确定性回退）
@dsh-memory/layers	MemGPT 式 working/state/archive 分层
@dsh-memory/links	A-MEM 式共享 subject 链接演化
@dsh-memory/fdo	CoEvo 式 recall/confirm 强化回路
@dsh-memory/projections	ctx.sessionProjections 增量投影与 checkpoint 缓存
@dsh-memory/emit-context	session-start 分层快照 + pre-step 召回
@dsh-memory/emit-tool	memory_remember/recall/list/forget/trace/confirm
@dsh-memory/emit-skill	policy 节点 → 结构化 SKILL.md → ctx.skills

快速启用

dsh web --patch "$PWD/examples/dsh-memory.cordis.yml"

LLM pass 通过环境变量启用：

MNEME_EXTRACT_PROVIDER=... MNEME_EXTRACT_MODEL=... \
MNEME_CONSOLIDATE_PROVIDER=... MNEME_CONSOLIDATE_MODEL=... \
MNEME_EMBED_ENDPOINT=... MNEME_EMBED_API_KEY=... MNEME_EMBED_MODEL=... \
dsh web --patch "$PWD/examples/dsh-memory.cordis.yml"

开发集成：本仓库要求与 DeepSeek Harness checkout 并排放置（dsh-repo 为同级目录）。pnpm-workspace.yaml 会把 DSH 的 vendor/* 与 packages/*/* 纳入同一 workspace，因此 workspace:^ 依赖、tsconfig project references 和测试 alias 都解析到 DSH 源码。

# 在 dsh-memory 同级准备 DSH 源码：
# git clone --depth 1 https://github.com/deepseek-ai/deepseek-harness.git dsh-repo
cd dsh-memory
pnpm install
pnpm run typecheck
pnpm test

发布到 npm 时由 pnpm 将 workspace:^ 协议转换为实际版本号。

许可

MIT