dsh-Mnemosyne

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

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

版本状态

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

• 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 严格隔离。

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.3-alpha.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 数据迁移。

设计与实现细节见：

• 文档索引
• DSH Agent 安装、更新与卸载 Runbook
• v0.2.0 零操作 OKF 记忆闭环实施计划
• v0.2 MVP 收口设计与验收结果
• dsh-Mnemosyne 总体设计
• 本地观察期监控与评估规范
• 版本路线图

许可证

本项目采用 MIT License。