deepseek-harness-mimo-memory

DeepSeek Harness - MiMoCode 工作区自动记忆插件 (MiMo Memory)

基于 MiMoCode 记忆架构 构建的 DeepSeek Harness 跨会话长期工作区持久记忆插件。

实现开局 0 工具调用自动预注入、后台异步蒸馏与沉淀 (Dreaming)、跨会话任务断点续接 (Checkpoints) 以及 显式结构化落盘工具 (update_project_memory)。

---

运行机制与核心架构

插件采用 MiMoCode 原版四层分级记忆与异步调度模型：

┌─────────────────────────────────────────────────────────────┐
│  Layer 1: 核心事实与架构契约 (MEMORY.md)                      │
│  - 跨会话全局持久生效，按标准三段式结构化维护                 │
│  - 开局 0 工具调用自动拼装注入 System Prompt 头部             │
├─────────────────────────────────────────────────────────────┤
│  Layer 2: 工作区任务检查点 (checkpoint.md)                    │
│  - 记录最近工作区目标、任务阶段与活跃状态                      │
│  - 会话新建或重置时自动带出断点背景                           │
├─────────────────────────────────────────────────────────────┤
│  Layer 3: 后台异步蒸馏沉淀 (Dreaming & Distilling)            │
│  - 监听 Agent 空闲状态 (idle)，在后台提取已验证结论与用户约定 │
│  - 纯异步执行，不占用对话上下文 Token，不增加对话响应延迟     │
├─────────────────────────────────────────────────────────────┤
│  Layer 4: 主动落盘工具 (update_project_memory)                │
│  - 供模型或用户显式调用，按 Markdown 章节精准追加或替换内容   │
└─────────────────────────────────────────────────────────────┘

---

插件是怎么运行的

1. 工作区路径映射与隔离 (projectKey)

插件对每个工作区目录（cwd）进行跨平台无冲突编码（如 C:\Agent code\deepseek 映射为 --C-Agent~0020code-deepseek--），将记忆统一隔离存储在 ~/.dsh/memory/<project-slug>/ 目录下，不同项目互不串扰。

2. 开局 0 工具调用自动预注入

在会话启动组装系统提示词时（ctx.systemPrompt.context），插件会自动读取对应工作区的 MEMORY.md 与 checkpoint.md，并在上下文最前部注入：

# 📌 当前工作区持久记忆 (Project Memory)
【以下内容由 dsh-mimo-memory 自动注入，跨会话全局持久生效，你已具备这些背景知识，无需调工具查看】：
...

模型开局第一轮即直接掌握项目的硬件配置、架构选型与开发约定，无需先耗费 1~2 轮对话去执行 view_file 或 grep 检索历史文档。

3. 后台 Dreaming 自动蒸馏

当单次对话交互结束、Agent 状态转为 idle 时，插件自动启动后台分析：

• 扫描最近交互，识别用户明确给出的规则偏好（如“统一使用 TypeScript”、“记住这个配置”）与已验证的技术结论（如“Bug 根因是...”）；
• 自动更新 checkpoint.md 与 MEMORY.md，实现静默记忆生长。

4. 主动更新工具 (update_project_memory)

插件向 Agent 注册了主动记忆管理工具：

• section：指定写入的章节（如 架构与技术选型、关键约定与环境规范、已验证结论与踩坑记录）；
• content：沉淀的具体事实或规则；
• action：append（追加，自动去重）或 replace（覆盖）。

---

安装与配置

方式一：在本地 Profile 中引入（推荐）

1. 将本仓库 clone 到本地，例如 C:/plugins/deepseek-harness-mimo-memory。
2. 打开你的 Web profile 配置文件（~/.dsh/profiles/web/package.json 或 C:\Users\<用户名>\.dsh\profiles\web\package.json）。
3. 在 dependencies 与 dsh.profile.bundles 中添加插件：

{
  "dependencies": {
    "dsh-mimo-memory": "file:C:/plugins/deepseek-harness-mimo-memory"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@deepseek-ai/dsh-web-app",
        "dsh-mimo-memory"
      ]
    }
  }
}

4. 进入 profile 目录执行安装并启动：

cd ~/.dsh/profiles/web
pnpm install
dsh --profile web

---

方式二：直接从 GitHub 引用

在 profile 的 package.json 中配置：

{
  "dependencies": {
    "dsh-mimo-memory": "github:Rainpomelo/deepseek-harness-mimo-memory"
  }
}

---

参数配置项

配置项	类型	默认值	说明
memoryRoot	string	~/.dsh/memory	全局持久记忆存储根目录
maxChars	number	12000	单工作区开局注入最大字符数（防止超出上下文）
autoDream	boolean	true	是否启用 Agent 空闲时的后台自动蒸馏沉淀

---

记忆文件存储结构示例

~/.dsh/memory/
├── --C-Agent~0020code-deepseek--/
│   ├── MEMORY.md          # 长期核心规则与技术沉淀
│   └── checkpoint.md      # 最近任务断点与阶段检查点
└── --C-Users-workspace-projectA--/
    ├── MEMORY.md
    └── checkpoint.md

---

开源协议

MIT License