dsh-Mnemosyne

September 14, 2026 · View on GitHub

面向 DeepSeek Harness 的零操作 OKF 长期记忆插件。

dsh-Mnemosyne 会在普通对话中自动回忆和沉淀项目经验。安装后，用户只需正常使用 DSH，不需要学习或调用任何记忆工具。

版本状态

当前发布架构：默认 Runtime 为 V3（Map-first + Recall/Consolidation Subagent）。安装插件后无需参数或隐藏配置即可使用；V2 仅保留为内部兼容 fallback，不是生产默认路径。当前包版本以 package.json 为准。

  • v0.2.9：修复 Mnemosyne 状态节点影响 DSH 消息分支按钮的问题；状态数据仍保留在插件内部，但不再插入可见 Chat Node 树。

  • v0.2.7：适配 DSH 0.1.5-rc.1 的显式父子 Agent 所有权、双参数 setup 回调与 Session V3 模型消息历史。

  • v0.2.6：新增父任务、Recall 与 Consolidation 的模型 Token 用量归因诊断，区分未缓存输入和缓存读取，并计入失败/重试调用。

  • v0.2.5：修复整理状态节点与内置 turn-tail 的渲染位置冲突，确保状态显示在回答之后。

  • v0.1.0：技术预览，验证了 DSH 插件装配、存储、Generation 与工具式记忆流程；不代表当前产品体验。

  • v0.2.0：Zero-operation OKF Memory MVP（MVP Complete）。用户只需正常对话，记忆的读取、组织与沉淀均由插件自动完成。

  • v0.2.9：历史本地验收记录，其修复已纳入当前 npm 发布版；详见 验收记录。

v0.2.0 已闭环五项 MVP 能力：

  • 自动记：正常 turn 结束后自动判断并沉淀可复用的项目经验；
  • 自动组织：将新记忆组织进最多三层的 OKF Catalog；
  • 自动找：新 Session 由模型沿 OKF 分类逐层找到相关记忆；
  • 按需读：严格按 Title → Summary → Content 渐进披露；
  • 可靠隔离：记忆跨 Session 和进程重启持久存在，不同 Project 严格隔离。

后续路线保持为 Memory Governance → Pattern Layer → Plugin Evolution。Governance Foundation 的 Slice 1–6 已完成并通过手工 Smoke Test；这不等于完整的 v0.3 Memory Governance 已完成。后续仍按 Recall 可用性治理 → 去重/合并 → Revision/Supersede/Conflict → 过时治理 → Catalog 治理 逐步开放。治理过程不物理删除 Memory，不对不确定冲突自动选边，将模型建议与状态变更分离，并保证操作可审计、可回滚、Catalog 调整不改变 Memory 身份且可增量执行。v0.4 与 v0.5+ 分别基于治理后的可信 Memory 构建 Pattern 和 Plugin Evolution。

v0.2.0 的工作方式

用户正常提出问题
  → 当前 Agent 使用自己的模型阅读 OKF 分类 Title
  → 按需展开分类 Summary
  → 按需展开 Memory Title
  → 最多查看 5 条 Summary
  → 最多确认 3 条完整 Content
  → 已确认记忆作为可重放的 plugin recall 消息进入主模型请求
  → 主模型完成任务
  → turn 正常结束后自动判断是否形成新经验
  → create / skip / noop
  → 新经验写入项目级 OKF Memory，并发布新 Catalog 与 Generation

渐进式披露严格遵循 Title → Summary → Content。模型负责语义理解与选择，插件不通过关键词、tags、别名或向量分数替模型判断相关性。

安装

要求：

  • Node.js >=22.19.0
  • DeepSeek Harness / DSH 公开 SDK 基线 0.1.5-rc.2（当前适配目标；历史验收环境见 Runbook）
dsh plugin add @cziyi/dsh-mnemosyne

插件默认启用。安装或升级后，请新建 DSH 会话，或重启承载现有会话的 DSH Web 进程，使新的插件装配进入 Agent 生命周期。

可选配置只有：

enabled: true
# projectRoot: /absolute/project/path  # Session 没有 cwd 时的可选回退

日常使用

不需要任何特殊命令：

  1. 在项目中正常向 DSH 提出任务；
  2. 有相关历史经验时，插件会在主模型执行前自动逐层回忆；
  3. 没有相关记忆时，主任务直接继续；
  4. 任务正常完成后，插件自动判断是否值得沉淀；
  5. 没有新知识时不会创建记忆。

v0.2.0 不注册 mnemosyne_status、mnemosyne_search、mnemosyne_open、mnemosyne_remember 等会话工具。未来的用户记忆管理入口将由 Web 管理器提供。

OKF Memory

每条新记忆都是独立、不可变的 OKF Memory，包含：

  • title：第一层快速判断；
  • summary：第二层简洁总结；
  • content：完整的结构化 Markdown 经验；
  • related_memory_refs：相关记忆引用。

新踩坑会创建一条关联的新记忆，不会改写旧记忆。所有 v0.2 记忆直接属于 Project Scope，可供同一项目的新会话使用。

项目数据位于：

<project>/.dsh-mnemosyne/
├── v2/
│   ├── memories/
│   ├── catalogs/
│   ├── generations/
│   └── CURRENT
└── debug/
    └── runtime.jsonl

v0.1.0 的旧 Fact 数据会保留在磁盘，但 v0.2.0 不读取、不迁移，也不会编译进新版 Generation。

开发者诊断

.dsh-mnemosyne/debug/runtime.jsonl 记录脱敏结构化事件，可用于判断：

  • Recall 是否启动以及每层披露/选择数量；
  • 为什么没有召回；
  • Consolidation 是 created、skip、noop 还是失败；
  • Catalog 与 Generation 是否成功发布。

日志不会进入模型上下文或 OKF，不保存用户全文、完整 Memory Content、Prompt、模型原始输出、隐藏思考、凭据或绝对路径。

当前边界

v0.2.0 聚焦项目级长期记忆闭环，不包含：

  • Session 短期记忆、手动晋升或遗忘；
  • Evidence、Revision、健康度、治理和成功计数；
  • Web 管理、自进化、向量数据库；
  • v0.1.0 数据迁移。

设计与实现细节见：

许可证

本项目采用 MIT License。