跨 Claude Code、Codex 与 Cursor 复用经验：Beacon 如何把 Agent 会话变成可审查记忆
如果你在 Claude Code 里排查过一次复杂故障，换到 Codex 或 Cursor 后却还得重新解释项目约定、失败尝试和有效修复路径，就会发现：Agent 的“记忆”往往被锁在各自的会话记录里。Asymptote Labs 的开源项目 Beacon，尝试把多个编码 Agent 的会话历史统一采集，再将可复用的工作经验整理成可审核的知识，供后续 Agent 使用。
这不是让模型无限记住所有对话。它更像一条知识整理流水线：先保存发生过什么，再从中提炼候选经验，经过人工确认后，才把经验暴露给未来的工作流。这个区别很重要——未经筛选的旧上下文可能过时，甚至把一次性的 workaround 误当成长期规则。
Beacon 解决的是什么问题
项目 README 将 Beacon 定位为跨 harness 的 Agent 记忆层。它支持 Claude Code、Cursor、Codex、OpenCode 等多种运行环境，并宣称覆盖 20 多种 harness。不同工具产生的会话事件被归一化为基于 OpenTelemetry 的事件模型，涵盖提示与响应、工具调用、命令、文件活动、审批、MCP 交互和 token 使用等信息。
因此它提供两种相互关联、但用途不同的能力：一是回看具体会话轨迹，回答“Agent 做了什么”；二是把工作流、纠错经验、调试路径和仓库约定整理为可复用知识，回答“下次可以怎么做”。后者可经由 MCP 或 Agent Skills 提供给后续 Agent，也能按仓库或项目限定作用范围。
这里的关键不是“跨工具同步聊天记录”，而是将原始轨迹与经过整理的知识分开。会话记录保留证据，提炼出的经验则需要审核；项目自己的说明文件仍然适合记录明确、稳定的约定，不必把每条知识都交给自动归纳。
从本地安装开始
README 给出的 macOS 安装流程使用 Homebrew：
brew update brew trust asymptote-labs/tap brew tap asymptote-labs/tap brew install beacon beacon endpoint install
Linux 用户可从 GitHub Releases 安装脚本获取对应架构的 .deb 或 .rpm。上游说明安装器会校验发布包与 checksums.txt，但校验和只能发现文件损坏或替换，不能独立证明发布者身份；对供应链要求较高的环境，应按项目说明另行核验构建来源证明，或先检查脚本后再运行。
配置向导会让用户选择数据目的地。Beacon 文档明确区分本地与云端：登录本身不等于开启转发，选择并确认托管云端选项才会开始向对应目的地转发；选择 Local 则将数据留在本机。README 还指出，可以断开连接。团队部署前应先检查确认界面、采集范围、保留策略和组织政策，尤其是会话中可能出现的代码、提示词和工具输出。
安装并连接后，可用以下命令检查轨迹与本地仪表盘：
beacon traces beacon endpoint dashboard
beacon traces 提供终端浏览方式；项目也提供 JSONL 事件流作为直接检查入口。仪表盘是只读视图，便于按会话回看事件。若只需要在本地开发机积累轨迹，可使用本地目的地，而不是默认将数据送往托管服务。
让经验可复用，但保留人工把关
适合提炼的内容通常具有重复价值：某个仓库必须先运行的测试、经验证的迁移步骤、某类故障最终有效的排查路径，或 Agent 反复容易忽略的项目约定。单次尝试的完整上下文仍留在 trace 中；整理后的知识则应尽量简洁、限定范围，并说明适用条件。
Beacon 的 README 描述了“捕获会话—评估结果—提取知识—审核批准—后续复用”的循环。审核步骤不是装饰：旧经验可能因依赖升级、代码重构或漏洞修复而失效。把知识限定到具体仓库，能减少其他项目误用；定期复查带版本条件的 workaround，也比无条件积累“记忆”稳妥。
项目还能通过 MCP 接入支持的 harness。README 给出的云端连接命令是：
beacon mcp connect
它会为支持的客户端注册托管 MCP 服务，客户端首次连接时进行 OAuth；本地 MCP 服务则可通过 beacon mcp serve 启动，项目说明它与托管连接不同，不会触碰网络。实际启用前应确认当前 Agent 的配置变更，以及本机数据目的地是否符合预期。
适合谁，哪些边界要先看清
如果你经常在多个编码 Agent 间切换，或希望团队把重复踩坑变成可复用的项目知识，Beacon 值得试用。其 MIT 许可证、开放的 JSONL 数据和跨 harness 设计，降低了被单一 Agent 厂商锁定的风险。另一方面，采集会话历史会带来隐私与治理责任；本地优先不代表无需审查，云端选项更需要明确数据边界与授权。
Beacon 也不应取代代码审查、测试、项目文档或安全审计。它能帮助人和 Agent 找回发生过的过程，并组织候选经验，但知识是否正确、是否仍适用，仍需要维护者判断。把“发生过”当作证据，把“值得记住”当作待审核结论，才是使用这类 Agent 记忆工具的安全起点。
相关链接