告别Agent失忆:agent-beacon如何让Claude Code、Cursor、Codex共享同一份项目记忆

原创2026-10-10 13:38:291,959 阅读

告别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 重新学一遍。

Beacon 项目标语图:跨工具自我改进的 AI Agent 记忆层

🔍 agent-beacon 是什么?怎么工作?

简单来说,Beacon 安装在你的开发机上,横跨所有 Agent 工具做三件事:捕获 → 评估 → 复用。

第 1 步:跨工具捕获会话

Beacon 通过 hooks、插件、OTLP 等标准方式接入 Claude Code、Cursor、Codex、Cline、OpenCode 等 20+ 本地 Agent,以及浏览器聊天、云端 Agent 和 CI 流水线,把每个工具的会话统一成一套基于 OpenTelemetry 的事件模型:提示词、回复、工具调用、命令、文件变更、审批记录、Token 用量,全部进同一份数据流。

agent-beacon 架构图:多类 Agent 工具经统一遥测层汇聚为共享数据

第 2 步:把"值得记的"挑出来

并不是每个会话都有价值。Beacon 的记忆流程是显式评估 + 人工审批的双保险(详见 docs/concepts/cross-harness-memory.mdx):

  1. 用 beacon memory evaluations run 对选中的会话打分(支持 --dry-run 先行预览,不打网络请求);
  2. 只有"任务成功 + 经验分达标"的会话才会进入候选列表;
  3. 你审阅每条候选,确认后才写入项目记忆库(本地 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 Skills 清单

日常用法非常口语化:直接对 Agent 说"把昨天修构建包的会话变成记忆"或"回顾一下 Beacon 记忆候选",对应技能就会被触发,全程由你掌握审批权。

🖥️ 本地 Dashboard:看清你的 Agent 到底做了什么

beacon endpoint dashboard

一行命令打开本地只读面板,跨工具浏览会话时间线、Token 消耗、改过的文件和审批记录,支持按工具、模型、风险等级检索历史事件。

agent-beacon 本地 Dashboard 概览:会话数、Agent 工具、仓库与操作统计

面板还支持 Lenses——针对单条会话的定制视图(如文件 diff、Token 账单、按风险分组的安全审查),甚至可以让你的 Agent 帮你写新 Lens。底层数据始终是本地 JSONL,不依赖任何 UI。

🔒 本地优先,隐私边界清晰

  • 默认一切数据留在本机(~/.beacon/endpoint/logs/runtime.jsonl),不转发任何内容,除非你显式配置转发;
  • 只有 beacon memory evaluations run 这一个命令可能调用外部评估器,且默认干跑、需你确认后才会发请求,发送的是有界且脱敏的会话投影;
  • 记忆按项目隔离:A 仓库的经验不会自动泄漏给 B 仓库;
  • 审批、拒绝、安装技能均为显式 CLI 操作,无钩子静默执行。

写在最后

agent-beacon 解决的正是多工具开发时代最真实的痛点:Agent 的知识不再随会话消失,也不再被锁死在某一个工具里。一次投入,经验复利——这正是它自称"跨工具自我改进记忆层"的含义。

📖 延伸阅读:

登录后查看全文
agent-beacon