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 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