项目记忆（Project Memory）

为编码代理提供持久、基于证据的记忆系统。

Project Memory 为每个编码代理提供一个单一、可信的仓库知识库——让代理不再重复学习相同的事实，也不再生成相互冲突的"记忆"文件。

发现 → 验证 → 分类 → 提炼 → 重建 → 单一可信来源

代码告诉代理 有什么。Project Memory 帮助它们记住 为什么——并整理所有已经尝试记录这些知识的零散文件。

🇬🇧 English

目录

• 为什么重要
• 快速开始
• 支持平台
• DeepSeek Harness（DSH）插件
• 使用方法
• 功能说明
• 技能清单
• 知识架构
• 测试
• 开源协议

为什么重要

在没有统一记忆的情况下，每个代理（以及每款 AI 工具）都会重新发现架构、重新尝试已被拒绝的方案，并写出略有不同的结论。最终你会得到多个互相矛盾的"可信来源"。

有了 Project Memory，这些知识会被发现、与实际代码交叉验证，并重建为一份可信赖的单一记忆，供后续代理从同一个可信位置加载。

快速开始

一键通用安装（极速推荐）

支持 Linux、macOS 与 Windows，优先自动配置 DeepSeek Harness (DSH)：

Linux / macOS / WSL：

curl -fsSL https://raw.githubusercontent.com/LoveDoLove/Project-Memory-Agent/main/install.sh | bash

Windows (PowerShell)：

irm https://raw.githubusercontent.com/LoveDoLove/Project-Memory-Agent/main/install.ps1 | iex

一键脚本将自动执行：

1. 自动识别 DeepSeek Harness (DSH)，将 @lovedolove/dsh-project-memory 插件挂载到当前活动的 DSH Profile 中。
2. 安装全局 ema 命令行工具到环境变量 PATH（~/.local/bin/ema 或 %USERPROFILE%\.local\bin\ema.cmd）。
3. 将 8 项核心工程记忆技能镜像到 ~/.agents/skills/，并同步支持 Claude Code 及 OpenCode。
4. 在 DeepSeek Harness 中即刻激活 /ema 与 /project-memory 斜杠指令。

在 DeepSeek Harness 中使用（原生零配置极速安装）

参考 DeepSeek 官方标准（如 dsh-univer-office），只需一行 DSH 原生包管理命令，即可直接装完全部功能：

# 添加到当前激活的 DSH Profile（如 'web'）
dsh plugin --profile web add @lovedolove/dsh-project-memory

该命令将自动：

1. 注入系统原生打包技能（System Bundled Skills）：通过 ctx.skills.registerProvider 注册 BUNDLED_SKILL_RANK 级原生技能源，所有 8 项技能直接进入 Harness 核心技能表，无需向用户目录拷贝任何文件。
2. 注册原生斜杠指令：激活 /ema 与 /project-memory 对话框交互。
3. 注入 MCP 工具链：挂载 ema_recall、ema_distill、ema_add 等 6 项标准工具。
4. 激活向量引擎：离线 384-d 向量与 sqlite-vec RRF 混合检索即刻就绪。

安装完成后，在任意 DSH 对话窗口中直接输入：

/ema

或

/project-memory

代理将自动执行记忆检索、事实核验与经验沉淀编排。

支持平台

| 目标 | 主要场景 | 技能位置 | 触发方式 | |:----:|:--------:|----------|:--------:| | DeepSeek Harness (DSH) | 主推平台 | DSH 技能注册表 / 插件 | /ema, /project-memory | | 命令行终端 (CLI) | 图谱 UI 与自动提炼 | 独立 Node.js 客户端 | ema ui, ema ingest, ema recall | | Claude Code | 兼容支持 | ~/.claude/skills/ | @project-memory | | OpenCode | 兼容支持 | ~/.config/opencode/skills/ | @project-memory | | Codex | 兼容支持 | ~/.agents/skills/ | @project-memory |

DeepSeek Harness（DSH）原生插件

本项目原生作为 DSH bundle 插件（@lovedolove/dsh-project-memory）发布，直接将全部 8 个 Project Memory 技能作为原生系统打包技能（System Bundled Skills）挂载到任意 DSH 配置文件中。插件还会在 codebase-memory-mcp 可用时注册 cbm_* 工具，注入首次初始化提示，并注册 /project-memory 与 /ema 斜杠命令。

安装

# 交互式 —— 显示适用于你配置文件的命令
.\install.ps1 -Target dsh

# 指定目标配置文件
.\install.ps1 -Target dsh -DshProfile web

安装脚本会打印插件添加命令，请手动执行：

dsh plugin --profile web add @lovedolove/dsh-project-memory

使用

一键命令（推荐）

安装后，在任何 DSH 会话中可直接使用一键命令：

/project-memory

自动检测仓库的 Project Memory 状态并执行相应工作流——无需选择 Agent、无需挑选技能、无需指定模式参数。

可选 --trace 参数可启用检索追踪，用于调试：

/project-memory --trace

高级：直接调度编排器代理

如需完全控制，可将编排器作为子代理调度：

use_agent(agent: "project-memory", prompt: "compound my last task")

插件内部说明： npm 包使用单行 Cordis patch 加载运行时胶水（dsh/plugin.mjs），由其在运行时直接以系统打包技能规范注册 8 项技能、注册 /project-memory 与 /ema 斜杠命令，并在没有 AGENTS.md 时注入首次初始化提示。

使用方法

斜杠命令（仅 DSH）

/project-memory

详见 DSH 插件 章节了解完整安装和使用说明。

代理预设（全平台）

在任何支持的代理中直接调用编排器：

@project-memory

它会发现现有知识、检查仓库、对照真实代码验证声明，并报告哪些内容需要保留、修改、合并或删除——覆盖所有来源工具，而不仅是自身生成的文件。

典型任务： 审计本仓库、为新仓库构建记忆、合并冲突的 AGENTS.md / CLAUDE.md、任务完成后提炼经验教训。

功能说明

| 能力 | 说明 | |---|---| | [D] 发现（Discover） | 盘点所有已有知识来源及其来源追溯 | | [V] 验证（Verify） | 声明与代码、测试、配置、CI、Git 交叉验证，从不假设当前有效 | | [C] 分类（Classify） | 每条声明只有一个主要类型；冲突由证据而非文件新旧决定 | | [Co] 提炼（Compound） | 沉淀持久化的解决方案和经验教训，而非堆砌更多文档 | | [Cl] 清理（Clean） | 删除过期知识，不区分来源 | | [S] 单一真相（Single Truth） | 每个概念只有一个主归属，其他引用它 | | [L] 精简（Lean） | 积极去重——没有规则出现在两个地方 | | [A] 自审（Self-Audit） | 质量基线（Memory Health）+ 自审指令，防止记忆漂移 |

技能清单

八项专项技能，而非一个庞杂的大提示词：

| 技能 | 职责 | |---|---| | knowledge-discovery | 盘点所有已有知识来源，含来源追溯 | | repository-audit | 收集仓库证据（代码、测试、CI、Git） | | knowledge-classification | 对声明分类并解决跨来源冲突 | | knowledge-compounding | 将经验提炼为可复用的解决方案与经验教训 | | memory-architecture | 设计层次结构、导航与渐进式加载 | | obsolete-knowledge | 处理过期、废弃或已被替代的知识 | | memory-edit | 应用经审批的文档变更 | | memory-verification | 最终一致性与质量门禁 |

编排器按需渐进加载技能——你极少需要直接调用单个技能。编排器还可委托给 codebase-memory（只读代码图）和 cavecrew-builder（有界编辑）。每个规则在代理和技能之间只有一个权威归属，技能间相互引用而非重复，确保指导不会出现分歧。

知识架构

AGENTS.md 是唯一的入口点，其余内容均通过引用关联，不做重复。

AGENTS.md
   +-- docs/architecture.md      -> 系统设计、DSH 插件内部细节
   +-- docs/solutions/           -> 已诊断的修复模式
   +-- docs/lessons/             -> 可复用的工程原则
   +-- skills/<name>/SKILL.md    -> 详细技能指令
   +-- templates/                -> 文档模板

领域（domain）是一种模式，不是强制脚手架——只为存放已验证的知识创建。

模板

模板为新知识文档提供起点：

• templates/TEMPLATE.md —— 双轨模式的解决方案文档（Bug + Knowledge）
• templates/CONCEPTS.md —— 项目词汇表，含积累/播种/变异说明
• templates/SOLUTIONS.md —— 解决方案索引模板
• templates/schema.yaml —— 统一的元数据前缀规范

参考文件

详细指导位于各技能的参考目录中：

• skills/knowledge-compounding/references/ —— 接地验证、持久性基准、质量约束、会话历史、自动记忆

测试

Invoke-Pester ./install.tests.ps1

12 项测试覆盖各安装目标、无重复加载规则，以及确保 8 个技能、其清单与两份代理文件保持一致的防护机制。

开源协议

MIT —— 详见 LICENSE。