告别Agent失忆:agent-beacon如何让Claude Code、Cursor、Codex共享同一份项目记忆
告别Agent失忆:agent-beacon如何让Claude Code、Cursor、Codex共享同一份项目记忆
如果你同时使用 Claude Code、Cursor、Codex 等 AI 编程工具,大概率被"Agent 失忆"折磨过:上周刚调好的构建流程,换个工具又要从头试错。agent-beacon(简称 Beacon)是一个开源的跨工具 AI Agent 记忆层,它能自动捕获你在各个编程 Agent 里的会话历史,把有效的经验提炼成"项目记忆",让 Claude Code 学到的教训,Cursor 和 Codex 也能直接用上。
🧠 为什么 AI Agent 总会"失忆"?
大多数 AI 编程助手的记忆是会话级的:
- 关掉终端,会话记录就沉入各自工具的私有日志;
- 换一个工具(比如从 Cursor 换到 Codex),之前的调试路径、踩坑记录全部清零;
- 你纠正过三次的"先跑构建再跑测试",第四个 Agent 依旧会踩同样的坑。
结果是:同一个问题被不同工具反复从零学习,Token 和时间都在重复消耗。Beacon 的出发点很直白——一个 Agent 已经解决过的问题,不应该让另一个 Agent 重新学一遍。
🔍 agent-beacon 是什么?怎么工作?
简单来说,Beacon 安装在你的开发机上,横跨所有 Agent 工具做三件事:捕获 → 评估 → 复用。
第 1 步:跨工具捕获会话
Beacon 通过 hooks、插件、OTLP 等标准方式接入 Claude Code、Cursor、Codex、Cline、OpenCode 等 20+ 本地 Agent,以及浏览器聊天、云端 Agent 和 CI 流水线,把每个工具的会话统一成一套基于 OpenTelemetry 的事件模型:提示词、回复、工具调用、命令、文件变更、审批记录、Token 用量,全部进同一份数据流。
第 2 步:把"值得记的"挑出来
并不是每个会话都有价值。Beacon 的记忆流程是显式评估 + 人工审批的双保险(详见 docs/concepts/cross-harness-memory.mdx):
- 用
beacon memory evaluations run对选中的会话打分(支持--dry-run先行预览,不打网络请求); - 只有"任务成功 + 经验分达标"的会话才会进入候选列表;
- 你审阅每条候选,确认后才写入项目记忆库(本地
memory.db),可以随手补充标题、适用场景和标签。
整个过程没有静默写入:审批、拒绝、安装技能每一步都需要你明确确认。
第 3 步:让其他 Agent 直接取用
审批通过的记忆有两条取用通道,这就是"跨工具共享"的关键:
- MCP 通道:
beacon mcp serve提供search_memory、get_memory等只读工具,任何支持 MCP 的 Agent 都能检索; - Agent Skills 通道:
beacon memory skills install把记忆写成标准技能文件(如.agents/skills/<slug>/SKILL.md),任何支持 Agent Skills 的工具都能自动加载。
也就是说:Cursor 会话里提炼出的调试经验,可以变成 Codex 下次开工前自动读取的项目知识。
📦 三步快速上手
# 1. 安装(macOS 示例,Linux/Windows 见 quickstart 文档)
brew trust asymptote-labs/tap
brew install asymptote-labs/tap/beacon
# 2. 配置你要接入的 Agent
beacon endpoint install --harness claude,codex,cursor
# 3. 正常用你的 Agent,然后查看会话历史
beacon traces
安装向导还会把 Beacon 的记忆技能装到 ~/.agents/skills 与 ~/.claude/skills,之后各工具即可自动调用。完整入门步骤见 docs/get-started/quickstart.mdx。
🤖 内置 3 个记忆技能:让 Agent 自己"想起"和"记住"
Beacon 附带了一组开箱即用的 Agent Skills(源码在 agent-skills/skills/,各工具安装矩阵见 agent-skills/README.md):
| 技能 | 作用 | 网络调用 |
|---|---|---|
| beacon-memory-recall | 开工前自动召回与当前任务相关的项目记忆 | 无 |
| beacon-memory-distill | 把指定会话提炼为经验:先干跑、经你同意再评估、按源会话起草教训、由你审批 | 仅评估一步且需你同意 |
| beacon-memory-promote | 把已审批的记忆安装为项目级技能 | 无 |
日常用法非常口语化:直接对 Agent 说"把昨天修构建包的会话变成记忆"或"回顾一下 Beacon 记忆候选",对应技能就会被触发,全程由你掌握审批权。
🖥️ 本地 Dashboard:看清你的 Agent 到底做了什么
beacon endpoint dashboard
一行命令打开本地只读面板,跨工具浏览会话时间线、Token 消耗、改过的文件和审批记录,支持按工具、模型、风险等级检索历史事件。
面板还支持 Lenses——针对单条会话的定制视图(如文件 diff、Token 账单、按风险分组的安全审查),甚至可以让你的 Agent 帮你写新 Lens。底层数据始终是本地 JSONL,不依赖任何 UI。
🔒 本地优先,隐私边界清晰
- 默认一切数据留在本机(
~/.beacon/endpoint/logs/runtime.jsonl),不转发任何内容,除非你显式配置转发; - 只有
beacon memory evaluations run这一个命令可能调用外部评估器,且默认干跑、需你确认后才会发请求,发送的是有界且脱敏的会话投影; - 记忆按项目隔离:A 仓库的经验不会自动泄漏给 B 仓库;
- 审批、拒绝、安装技能均为显式 CLI 操作,无钩子静默执行。
写在最后
agent-beacon 解决的正是多工具开发时代最真实的痛点:Agent 的知识不再随会话消失,也不再被锁死在某一个工具里。一次投入,经验复利——这正是它自称"跨工具自我改进记忆层"的含义。
📖 延伸阅读:
- 跨工具记忆完整流程:docs/concepts/cross-harness-memory.mdx
beacon memory命令全览:docs/cli/memory.mdx- Beacon Skills 设计与安装:docs/concepts/beacon-skills.mdx