前言¶

本地 CLI 智能体（如 DeepSeek Harness、Claude Code、Codex）默认是无状态的。每次会话结束时，用户偏好、项目约定、踩过的坑等上下文信息都会丢失。evo 旨在为这类智能体提供一种跨会话的记忆机制，使其能够记住并利用之前对话中的信息。

这是什么¶

evo 是一个提供商中立的记忆服务，旨在为 AI 编程智能体提供持久化、跨会话的记忆能力。它通过“回忆 + 反思”的循环机制，让智能体在思考前获取相关知识，在回答后沉淀结构化记忆。该项目由 TIZ36 维护，当前处于 Alpha 阶段。

核心功能¶

evo 提供了以下核心能力：

• 结构化记忆：每条记忆包含范围、类型、标签和来源，支持精细化管理。
• 一等技能：将程序化 SOP（标准作业程序）和吸取的教训作为独立技能管理，区别于普通的事实性记忆。
• 批量蒸馏：将对话内容批量转化为结构化记忆项，提升记忆质量。
• 本地优先：默认使用 SQLite 存储数据，依赖 Node.js 的 node:sqlite 模块，数据不出本地（除非调用反思模型）。
• 工作区导入：支持自动导入现有的 CLAUDE.md、AGENTS.md 等文档作为初始记忆。
• 多平台适配：通过适配器支持 DeepSeek Harness、Claude Code 和 Codex。

安装与启用¶

在 DeepSeek Harness 环境下，请使用官方提供的安装脚本。执行以下命令：

./install_evo_dsps.sh

安装完成后，插件将在 DSH 进程中以插件形式运行。

典型用法¶

evo 的核心工作流包含两个阶段：

1. 回忆：在模型进行思考或生成回答之前，evo 会从数据库中检索相关记忆，并将其注入到智能体的上下文中。
2. 反思：在模型回答成功后，evo 会将本次对话的要点提炼为结构化记忆项并保存。

适用场景与注意¶

• 版本状态：当前版本为 Alpha (0.3.x)，API 可能存在变动，不建议用于生产环境的关键流程。
• 召回机制：目前使用确定性的 SQLite 过滤和排名，不依赖向量嵌入，适合对精确匹配要求较高的场景。
• 记忆合并：自动合并通常在慢速路径运行（最少间隔 24 小时或 72 小时收敛，或重放缓冲区较大时）。如需手动触发，可通过 consolidate() 函数或 Web 面板执行。
• 环境要求：需要 Node.js 22 及以上版本，且 node:sqlite 在当前 Node 版本中仍标记为实验性特性。
• 项目性质：这是一个个人开源项目，仓库中严禁出现公司身份和敏感信息。

短结尾¶

evo 通过结构化的记忆管理，解决了本地智能体状态丢失的问题，使其能够像经验丰富的同事一样在会话间保持连贯性。更多细节可参考项目目录页与 GitHub 仓库。