Atomic Agent – 本地优先的 AI 代理
在你的设备上本地运行控制循环和所有状态，驱动浏览器、编辑文件、执行经批准的命令，并支持长期上下文记忆的 AI 代理。
证据显示有审批门控（shell、文件写入、HTTP等）、隐私与出口说明、匿名分析默认开启但可关闭、状态文件本地存储。扣分：敏感数据处理不完整（.env secrets 继承给技能和shell）、依赖安全未提供审计或锁定、回滚机制仅提及更新提示重启、来源归属未验证发布者。
自洽性：README与package.json描述一致，功能列表与代码结构相符。依赖可用性：Node>=25.7要求较高，可能限制环境；未提供依赖锁定文件。失败消息：有故障分类和错误处理说明，但未提供具体示例。
受众明确（开发者、本地模型用户），场景多样（TUI、CLI、HTTP、sidecar、Telegram）。能力边界清晰（工具列表、审批门控）。触发精度：命令和配置明确。环境适配：支持多平台，但Linux依赖外部工具，浏览器未捆绑。
信息架构清晰（README结构完整）。安装说明详细（curl、PowerShell）。命名稳定性：API和命令仍在变动，提示pin版本。示例和FAQ：有示例命令和配置，但无FAQ。已知限制：有开发者预览说明和平台限制。许可证：MIT。版本变更日志：未提供CHANGELOG，但版本号存在。维护责任：未明确维护者，发布者未验证。
输出可用性：提供多种使用方式，输出格式明确。边际价值：本地优先、无API费用、可检查状态，有独特价值。成本效益：本地模型降低API成本，但需要硬件和配置。
声明可追溯：GAIA基准有文档和原始数据链接，但未提供完整复现步骤。跨来源佐证：仅单一来源，未独立验证。事实与推断分离：README区分了事实和推断，但部分声明（如性能提升）缺乏独立验证。
- 发布者未验证，身份未知。
- 敏感数据处理不完整：.env secrets 可能被技能和shell命令继承，需谨慎。
- 依赖安全未提供审计或锁定，建议检查依赖漏洞。
- API和命令仍在变动，生产使用需固定版本。
- 匿名分析默认开启，需注意隐私。
这个 Agent 能做什么，适合哪些场景？
Atomic Agent 是一个本地优先的 AI 代理，核心控制循环和状态存储都在用户自己的机器上运行，而非托管服务。它通过 playwright-core 驱动浏览器，支持文件读写编辑、执行 shell 命令、文档文本抽取、Git 只读操作，并具有记忆、任务调度、技能、MCP 和 Telegram 远程控制等能力。代理循环基于 llama.cpp，默认使用本地量化模型，通过 TurboQuant 优化获得更高吞吐量。所有会话、记忆、任务、追踪等状态以普通文件和 SQLite 数据库形式存储在本地磁盘上，且提供审批门控、追加式追踪和提示漂移回放等安全与可观测性特性。它可以通过 CLI、TUI、HTTP 服务或嵌入为 Tauri sidecar 使用，并支持从 Hermes 或 OpenClaw 导入。
Atomic Agent 执行一个推理与工具调用的循环：它通过 llama-server 调用本地模型，模型返回一个 JSON 数组的工具调用，核心执行器并行运行只读调用，对危险操作进行审批门控，然后将结果压缩并循环直到完成。具体功能包括：使用 playwright-core 进行浏览器自动化（导航、点击、输入、搜索、标签页管理、滚动、读取 ARIA 快照）、Web 搜索（支持 Exa、DuckDuckGo、Brave、SearXNG）、HTTP 请求（带 SSRF 防护）、文件读写编辑、shell 命令执行（需要审批）、本地 PDF/DOCX 等文档文本抽取、Git 只读操作（status, log, diff, show, blame）、记忆（配置文件事实、笔记、链接、课程、程序）与投票、任务调度（cron、webhooks）、技能（Markdown 剧本，如 Docker、GitHub、Notion），以及 MCP 客户端集成。它还提供 Telegram 单用户远程控制，支持配对、审批按钮和可选的任务报告。
- 在本地开发环境中，开发者使用 Atomic Agent 通过 TUI 或 CLI 管理浏览器自动化、文件操作和 shell 命令，同时保持代码和本地数据私密。
- 希望从 Hermes 或 OpenClaw 迁移的用户，可以使用 /import 命令一键导入会话、cron 任务和提供商密钥。
- 需要长期运行多步骤任务的用户，通过记忆和任务调度功能，使代理跨会话记住上下文并安排后续操作。
- 在离线和隐私敏感的环境（如医院、金融）中，使用本地量化模型运行代理，避免将数据发送到外部 API。
- 构建桌面应用的开发者，通过 Tauri sidecar 或 OpenAI 兼容的 HTTP API 嵌入该代理到自己的应用中。
- 需要远程控制个人代理的用户，通过 Telegram 机器人进行配对、审批和执行任务。
这个 Agent 有哪些优点和局限？
- 本地优先，控制循环和状态在本地，无每 token 费用，隐私可控。
- 针对本地小模型优化，采用 TurboQuant KV-cache 和 speculative decoding，性能优于通用方案（GAIA L1 达 69.8%）。
- 提供丰富的工具表面，包括浏览器、文件、shell、文档、Git、记忆、任务、技能和 MCP。
- 安全和可观测性完善，具备审批门控、追加式追踪、提示漂移回放、失败分类和防停滞守卫。
- 支持多种使用方式：CLI、TUI、HTTP 服务、Tauri sidecar 和 Telegram 远程控制。
- 仍处于开发者预览阶段，API、命令、配置和行为可能变化，需要固定版本。
- 需要配置 llama-server 和浏览器，无捆绑浏览器，外部 llama-server 需手动启动（或使用托管模式）。
- 默认开启匿名使用分析和崩溃报告，需手动关闭。
- 仅支持 Linux x64 的托管本地模型，其他平台（如 arm64）需要外部 llama-server。
- 需要 Node.js >= 25.7，版本要求较高，可能限制了旧系统。
如何安装或部署这个 Agent？
Atomic Agent 提供一键安装脚本。在 macOS/Linux 上运行：chmod +x install.sh && curl -fsSL https://atomicagent.io/install | sh。在 Windows PowerShell 上运行：irm https://atomicagent.io/install.ps1 | iex。安装完成后会下载发布压缩包、验证校验和，并安装 CLI 及支持资源（grammars、原生预编译和捆绑的 ripgrep）。需要 Node.js >= 25.7（开发时），运行时需要可用的 llama-server（可由 CLI 管理或外部提供）、Chromium 系列浏览器（Chrome、Edge 等）和 git。
如何使用这个 Agent？
安装后，在终端运行 atomic-agent tui 启动交互式控制台，或使用 atomic-agent run --cwd /path/to/work 运行简单会话。可以通过 CLI 管理模型：atomic-agent models update、atomic-agent models pull qwen-3.5-4b、atomic-agent models use qwen-3.5-4b。若使用外部 llama-server，可设置环境变量 ATOMIC_AGENT_LLAMA_URL=http://127.0.0.1:8080 并启动服务器。对于本地 HTTP 服务，运行 atomic-agent serve --host 127.0.0.1 --port 8787 --cwd /path/to/work --api-key $ATOMIC_AGENT_API_KEY。作为 Tauri sidecar 嵌入时，通过 stdio 发送 newline-delimited JSON 请求。Telegram 远程控制需要在 config.json 中启用，并设置 TELEGRAM_BOT_TOKEN。
这个 Agent 与同类方案有什么区别？
与 Hermes 相比，在 GAIA Level 1 基准上，Atomic Agent 使用相同的本地模型获得 69.8% 的准确率，而 Hermes 为 58.5%，且平均每任务时间更短（约 217 秒对 351 秒）。