Beacon
为 AI 编码代理提供可自我改进的跨 harness 记忆层，让会话中积累的经验在工具之间持续复用。
- Star 数
- ★ 3.3k
- 最近更新
- 今天
- License
- MIT
- 主语言
- Go
- FA 评分
- 58/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 兼容但需适配Codex · Claude CodeChatGPT · Claude.ai · OpenAI API · Claude API（部分支持）
- 费用
- 有免费版，另有付费云服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 同时使用 Claude Code、Cursor、Codex 的开发者，希望在一次会话里解决过的问题不必在另一个工具里从头再学。
- 不适合
- 需要完全离线、拒绝任何账号交互的团队（默认安装向导会引导登录 beacon.sh）
- 只使用单一 harness 且不需要跨工具复用经验的开发者
- 想直接得到托管记忆服务、不想自行安装 endpoint 的用户
- 源码审查
- 58/100 · 缺口较多
这个 Agent 能做什么，适合哪些场景？
Beacon 是 Asymptote Labs 开源（MIT）的代理记忆层，面向 Claude Code、Cursor、Codex、OpenCode、Cline 等 20 多个 harness。它通过 OTLP、hooks、插件与轮询等方式在本地捕获会话历史，并归一化为基于 OpenTelemetry 的统一事件模型，涵盖提示词、回复、工具调用、命令、文件活动、审批、MCP 交互与 token 用量。捕获结果默认写入本地 JSONL（~/.beacon/endpoint/logs/runtime.jsonl），可用 beacon traces 或只读的本地 dashboard 浏览；经过评估与人工审核的工作流、纠错和调试模式会沉淀为知识，供后续代理通过 MCP 或 Agent Skills 检索。它也支持把同一份归一化数据转发到 Splunk、Datadog、Elastic、Microsoft Sentinel、S3、GCS 等已有基础设施，或选择 Beacon Cloud 托管转发。整体是本地优先、可移植、不锁定单一 harness 的设计。
Beacon 在代理实际运行的位置采集数据：本地 harness 走 OTLP、hooks 或轮询，浏览器聊天通过 Chromium/Firefox 扩展送入本地 OTLP，云端代理通过沙箱 hooks 写入 GCS/S3，CI 使用 beacon ci exec 启动临时本地收集器，SDK 侧通过 @asymptote/sdk 与 OpenLLMetry 采集模型调用 span。采集到的会话被归一成统一事件模型后写入 JSONL，并可选择转发到 SIEM、日志聚合或对象存储目标。beacon traces 打开终端浏览器查看事件时间线、token 用量与保留内容；beacon endpoint dashboard 提供只读本地 Web 视图，并支持以沙箱 HTML 运行的 lens（如变更 diff、token 账单、按风险分组的安全审查、审批时间线）。记忆侧提供 Beacon Skills 与 beacon mcp connect 注册的 beacon-managed MCP server，让 Claude Code、Codex CLI、Cursor、VS Code、Gemini CLI、OpenCode 等代理检索共享知识；本地 beacon mcp serve 则完全不触网。
- 同时使用 Claude Code、Cursor、Codex 的开发者，希望在一次会话里解决过的问题不必在另一个工具里从头再学。
- 安全工程师需要把编码代理的提示词、工具调用和审批记录统一送进 Splunk 或 Microsoft Sentinel 做审计。
- 平台团队要为 CI 中的代理任务留下可检索的执行轨迹，用
beacon ci exec生成临时收集器即可。 - 团队希望把反复给的纠错与仓库约定沉淀成 Agent Skills，供后续代理自动召回。
- 个人开发者想用本地只读 dashboard 复盘各 harness 到底做了什么、花了多少 token。
如何安装或部署这个 Agent？
macOS 使用 Homebrew：
brew update
brew trust asymptote-labs/tap
brew tap asymptote-labs/tap
brew install beacon
beacon endpoint installLinux 可执行官方安装脚本（会校验 checksums.txt 并用 apt-get/dnf 安装）：
curl -fsSL https://github.com/asymptote-labs/agent-beacon/releases/latest/download/install.sh | bashWindows 下载 x64 MSI 后安装：
msiexec /i BeaconEndpointAgent-<version>-x64.msi也可以让编码代理按提示自动安装：
Read https://beacon.sh/start.md then set me up on Beacon如何使用这个 Agent？
安装后在终端初始化端点并确认转发目标（向导会预选 Beacon Cloud，也可显式选择 Local 只保留在本机）：
beacon endpoint install像平常一样打开 Claude Code、Cursor、Codex 等 harness 工作，Beacon 会在后台持续采集。之后查看轨迹与 token 用量：
beacon traces或打开只读本地 dashboard：
beacon endpoint dashboard需要让代理检索共享记忆时，注册托管 MCP server（各 harness 首次连接走 OAuth，不落盘 token）：
beacon mcp connect安装或卸载 Beacon Skills：
beacon skills install
beacon skills uninstall查看当前登录账号，或断开端点：
beacon whoami
beacon endpoint disconnect这个 Agent 有哪些优点和局限？
- 跨 20 多个 harness 统一采集，并有明确的支持矩阵（Claude Code、Cursor、Codex、OpenCode、Cline、Gemini CLI 等）。
- 默认本地 JSONL 加只读本地 dashboard，数据路径可审计，且不依赖 UI。
- 归一化为 OpenTelemetry 事件模型，可直接接入 Splunk、Sentinel、Wazuh、S3、GCS 等现有设施。
- 记忆通过 MCP 与 Agent Skills 两条路径复用，且
beacon mcp serve完全本地运行。
- 不同 harness 的采集能力并不对齐，表格中多项为“–”或“~”（如 Cursor 无 token、VS Code 部分字段缺失）。
- 交互式安装会引导登录 beacon.sh，并默认预选 Beacon Cloud 转发，需要用户主动选择 Local 才能确保数据不出本机。
- 托管转发依赖 Beacon Cloud 账号，SIEM 接入需要自备 ingest token 或数据采集规则。
- lens 以沙箱 HTML 运行，但官方说明沙箱无法完全阻止浏览器外发数据，只能安装自己信任的 lens。
这个 Agent 与同类方案有什么区别？
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Beacon 当前 | 58 · 缺口较多 | 命令行工具免费版 + 付费版 | ★ 3.3k | 今天 | Go | Codex · Claude Code |
| AI 开发工具 Zoomcamp：AI 原生软件工程 | 32 · 缺口较多 | 网页应用免费 | ★ 1.7k | 10 天前 | Python | — |
| PRO-LONG | 57 · 缺口较多 | 命令行工具免费 | ★ 465 | 2 天前 | Python | Codex · Claude Code |
| AI DevKit | 48 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.7k | 1 天前 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
文档对数据流、默认本地 JSONL、可选转发、卸载与保留标志、受限日志访问等描述相当透明，故 data_flow_transparency 给 3；但安装默认会写入多个 harness 的配置、安装 hooks 与 skills，并预选 Beacon Cloud 转发，属于较广的权限与外部副作用，least_privilege 与 external_effects 仅 1；确认流程有明确确认屏与 Local 退出选项，但默认预选云端，user_confirmation 给 2；敏感数据处理有脱敏、截断、0600 密钥文件等说明，但浏览器扩展默认 full 保留完整提示与响应，sensitive_data_handling 给 2；依赖安全仅见 checksums 与 attestation 提及，未见依赖清单或漏洞治理，dependency_security 给 1；卸载与 --keep-logs/--keep-config 提供回滚路径，rollback 给 2；来源归属仅 README 与 LICENSE 署名 Asymptote Labs，发布者未经验证，source_attribution 给 1。
文档内部对安装、卸载、转发、会话同步的描述大体一致，self_consistency 给 2；但依赖可用性方面仅见 Homebrew tap、发布归档与 checksums，未提供锁定依赖或离线可用性证据，dependency_availability 给 1；失败信息在 sandbox 文档中区分 PASS/FAIL/INCONCLUSIVE 与 WARN，failure_messages 给 2。
README 覆盖 20+ harness、浏览器、云代理、CI 与 SDK，场景覆盖广，audience_and_scenarios 给 3；能力边界有部分说明（如 macOS 无法沙箱测试、hook 无法写入时仅警告），但整体边界仍偏宣传，capability_boundaries 给 2；触发精度方面 hooks/OTLP/poll 多路径并存，未见精确触发条件与去重说明，trigger_precision 给 1；环境适配覆盖 macOS/Linux/Windows 与 systemd/launchd，但 ARM 与 macOS 沙箱覆盖缺失，environment_fit 给 2。
安装说明非常详尽（Homebrew、deb/rpm、MSI、手动归档、校验和），install_notes 给 3；信息架构有 docs 目录与 README 导航，但部分链接指向 docs.beacon.sh 与 docs.asymptotelabs.ai 两个域名，information_architecture 给 2；命名稳定性方面 beacon-vector 与 vector 的命名说明清晰，但产品名与域名不一致，naming_stability 给 2；示例与 FAQ 有命令示例但缺少集中 FAQ，examples_and_faq 给 2；已知限制在 sandbox 文档中列出，known_limitations 给 2；LICENSE 为完整 MIT，license 给 3；版本化仅见 badge 与 beacon version 示例，无 CHANGELOG，versioning_changelog 给 1；维护责任仅见 SECURITY.md 联系邮箱与 Discord，发布者未验证，maintenance_responsibility 给 1。
输出为本地 JSONL 与仪表盘，可直接检查，output_usability 给 2；跨 harness 记忆与复用有明确价值主张，但缺少量化证据，marginal_value 给 2；成本方面需安装服务、写入多 harness 配置并可能上传 30 天历史，成本与收益权衡说明不足，cost_benefit 给 1。
README 的多数能力声明指向外部文档而非仓库内可核验文件，claim_traceability 给 1；仓库内文件（README、SECURITY、docs）之间部分互相印证，但缺少测试或代码佐证，cross_source_corroboration 给 1；文档中事实与推断（如“self-improving”）混排，fact_inference_separation 给 1。
- 安装默认会写入多个 harness 配置并安装 hooks/skills，且向导预选 Beacon Cloud 转发，可能上传最近 30 天会话历史；请先确认 Local 选项与确认屏内容。
- 浏览器扩展默认 full 保留完整提示与响应文本，敏感数据可能落入本地日志，需手动调整保留设置。
- 发布者身份未经验证，文档链接分散在 beacon.sh 与 asymptotelabs.ai 两个域名，来源归属与维护责任需谨慎对待。
- 依赖安全仅见校验和与 attestation 提及，未见依赖清单或漏洞治理证据，静态审查无法确认供应链安全。
- 本评估为静态源码审查，未执行任何安装或运行，能力声明与测试质量均未独立验证。
常见问题
Beacon 会默认把我的会话发到云端吗？
beacon endpoint disconnect。它支持哪些编码代理？
需要付费吗？
如何在 CI 中采集代理执行轨迹？
beacon ci exec 启动一个临时本地收集器，CI 任务产生的会话、提示词、工具调用、命令与文件活动都会被记录。