Mneme · dsh-memory

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

范式一句话：

记忆不是数据库，而是一个编译器：唯一持久化的是 DSH 事件日志（经验源码），记忆是从经验编译出来的、带溯源与证据条件的可执行上下文。

这是研究纲领与工程纪律，不是已完成的产品：v0.1 交付 keyless 确定性内核；LLM 抽取、隐式语义冲突消解、图/向量索引、检索策略共同演化见 docs/design.md §9。

Mneme 不另起向量库、图谱或第三存储系统，而是把 DSH 自己的机制编译成记忆：

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

详细设计见 docs/design.md。

编译 pass

session/event ─lower→ MIR ─solve→ 版本/证据/活性
                                │
        ledger Session ◀─write──┴─optimize→ 遮蔽/整合/遗忘
                                │
        index-replay ─候选发现──┴─emit-context → 模型上下文 (form:'recall')
                                └─emit-tool / emit-skill → 工具 / 技能

包	角色
@dsh-memory/ir	Service Definition：MIR、ctx.memory、纯 fold、ledger 会话
@dsh-memory/index-replay	Provider：sessionQuery 检索后端（字面扫描兜底）
@dsh-memory/lower	前端 pass：session/event → MIR
@dsh-memory/solve	版本消解 + 证据条件 + 激活衰减
@dsh-memory/optimize	TTL 遗忘 + 连续段整合 + 预算
@dsh-memory/emit-context	后端：session-start 快照 + pre-step 召回
@dsh-memory/emit-tool	后端：memory_remember/recall/list/forget/trace
@dsh-memory/emit-skill	后端：policy 节点 → ctx.skills

快速启用

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