APX v2 智能体团队
在你自己的机器上托管一支 AI 团队:一个总智能体负责接收消息与分派,多个项目智能体按角色协作。
- Star 数
- ★ 35
- 最近更新
- 今天
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 51/100 · 缺口较多
30 秒速览
- 可在哪里用
- 通用 · 跨平台ChatGPT · Codex · Claude Code · Claude.ai · OpenAI API · Claude API
- 开始前需要
- 典型场景
- 独立开发者想用 WhatsApp 或 Telegram 随时给一个总智能体下指令,让它把调研交给项目里的另一个智能体并在浏览器中打开来源页面。
- 主要局限
- 安装包尚未签名,macOS 与 Windows 需要额外的手动放行步骤,对受管控环境不友好。
- 官网
- apxagent.app ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-20最新版本 v2.16.0(2026-11-20)
- 源码审查
- 51/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
APX v2 是一个开源的本地优先 AI 智能体平台,以守护进程 apps/core 持有全部状态,对外提供 HTTP + WebSocket 协议(约 260 个类型化方法),并通过 packages/protocol 这个唯一契约被各端消费。用户侧有一个「超级智能体」,可在应用内、桌面端、Android 应用以及 Telegram、WhatsApp、Discord、Slack、iMessage 上应答,并在需要时把任务委派给项目内的其他智能体。每个项目可配置一支有角色、领域和自有笔记的「团队」,配合任务看板、承诺、定时例程让代理自主执行并汇报。桌面端 apps/desktop 基于 Electron,内嵌一个智能体可驱动的真实浏览器;在 macOS 与 Windows 上还可选择开放本机应用操作,但密码与支付被排除在外。模型侧支持 ChatGPT 方案、Claude、Gemini、OpenAI 兼容 API 及本地模型,Claude Code 与 Codex 会话与聊天并列显示。安装路径涵盖桌面安装包、终端脚本(数据在 ~/.apx/v2)以及服务器无头部署加 Tailscale/LAN 暴露与配对。
核心是 runTurn() 这条唯一的智能体回合执行路径,配合唯一的上下文构建器生成发给模型的提示词,目前每次调用约 8.2k tokens;MCP 工具通过 mcp_search 按需发现而非逐条塞入提示词。智能体间的通信统一为「会话调用会话」,用户与智能体的所有通道统一走 threads.send,并按智能体、会话或渠道调整参数。一次对话的存储是 thread + run + steps 三件套。智能体可读写项目笔记、在任务板上领取并推进任务、运行定时例程、调用浏览器标签页访问网页、在获得许可时操作本机应用,还能按需生成图表或清单类小部件并固定到面板。产物可导出/导入为 .apxart 文件,并可由你自建的 APX 提供分享链接。命令行 apx 只讲协议,不直接接触状态;apx desktop 安装并打开桌面应用,apx open 打开 Web 面板,apx setup --headless --expose tailscale 与 apx pair 完成服务器与设备的配对。
- 独立开发者想用 WhatsApp 或 Telegram 随时给一个总智能体下指令,让它把调研交给项目里的另一个智能体并在浏览器中打开来源页面。
- 小团队在一台 VPS 或家庭服务器上部署 APX,通过 Tailscale 暴露给成员,每个人用桌面端和 Android 应用配对接入各自的项目团队。
- 需要按周固定产出报告的人,用定时例程让智能体在无人值守时执行,只在有内容可汇报时主动发消息。
- 同时使用 Claude Code 与 Codex 的工程师,把两者的会话放在同一面板旁,和 APX 的聊天、任务一起管理。
- 需要本地模型或 OpenAI 兼容 API 的用户,自带模型接入,避免绑定单一供应商。
- 想把图表、清单等小工具沉淀下来的用户,让智能体现场构建小部件并固定到看板,供后续复用。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
curl -fsSL https://apxagent.app/install.sh | bashirm https://apxagent.app/install.ps1 | iex
- 端口
7440- 配置文件
~/.apx/v2- 安装说明涉及
- Windows · macOS · Linux
如何安装或部署这个 Agent?
桌面应用(macOS、Windows、Linux):从官网或最新的 v2 release 下载安装包,按安装指南完成系统要求的一次额外确认(当前安装包尚未签名)。
终端安装(自动识别系统,无需 root,数据位于 ~/.apx/v2):
curl -fsSL https://apxagent.app/install.sh | bashirm https://apxagent.app/install.ps1 | iex服务器(VPS、homelab、无显示器)在管道后追加 --server(PowerShell 用 -Server),随后执行无头初始化与配对:
bash -s -- --server
apx setup --headless --expose tailscale
apx pair从源码构建需要 Node.js 与 pnpm:
pnpm install
pnpm app # 在 127.0.0.1:7440 启动 core 并打开桌面应用
pnpm preflight # 隐私与 schema 检查、lint、类型检查、测试如何使用这个 Agent?
首次运行后按安装程序引导选择服务器或客户端模式,再接入模型(ChatGPT 方案、Claude、Gemini、OpenAI 兼容 API 或本地模型)。日常操作有三种入口:桌面应用内的收件箱与聊天、Web 面板(apx open)、手机应用(v2 release 中的 APX-<version>-android.apk,用桌面端展示的配对码接入)。
在终端里也可直接使用 CLI(源码检出时可通过别名调用):
apx desktop # 安装并打开桌面应用
apx open # 打开 Web 面板alias apx="node $PWD/apps/terminal/src/main.ts"为项目建立团队时,为每个智能体设定角色、领域与笔记,把任务放进任务板并指定负责人和期限;需要无人值守时配置定时例程。若要让智能体操作本机应用,需在设置中显式开启,密码与支付不在其可操作范围内。
这个 Agent 有哪些优点和局限?
- 架构经过彻底重写,每个能力只有一条实现路径:
runTurn()、threads.send、单一上下文构建器与 thread+run+steps 存储,降低了排查与扩展成本。 - 提示词体积有明确预算与测试约束,实测每次调用约 8.2k tokens,明显低于其列出的对比对象;MCP 工具用
mcp_search按需发现,有利于缓存命中。 - 模型供应商不受限,可接 ChatGPT 方案、Claude、Gemini、OpenAI 兼容 API 或本地模型,并并列使用 Claude Code 与 Codex 会话。
- 覆盖桌面、Web、Android 与多个即时通讯渠道,且可通过 Tailscale 或 LAN 把自建服务器暴露给配对的设备。
- 提供从 v1 到 v2 的迁移路径,v2 接管
apx命令并导入 v1 的项目、智能体、技能、聊天与渠道。
- 安装包尚未签名,macOS 与 Windows 需要额外的手动放行步骤,对受管控环境不友好。
- 桌面端、服务端与手机端各自独立,服务端无头部署需要自行处理 Tailscale/LAN 暴露与设备配对,配置面较大。
- 部分能力仍处于「基础设施已就位」而非完成品阶段:
.apxart导入导出不等于市场,自建服务访问不等于云端账号登录。 - APX Enterprise 版本范围、许可与定价尚未公布,长期路线存在不确定性。
- 运行在本地不等于全部离线:所连接的云端模型与服务仍会收到每次请求所需的内容。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| APX v2 智能体团队 当前 | 51 · 缺口较多 | — | ★ 35 | 今天 | TypeScript | ChatGPT · Codex · Claude Code · Claude.ai · OpenAI API · Claude API |
| NextClaw | 61 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 264 | 1 天前 | TypeScript | Codex · Claude Code |
| somora | 58 · 缺口较多 | 命令行工具免费 | ★ 35 | 4 天前 | TypeScript | ChatGPT · Codex · Claude Code |
| Brigade | 53 · 缺口较多 | 自托管服务免费版 + 付费版 | ★ 16 | 今天 | TypeScript | ChatGPT · Codex · Claude Code · Claude.ai |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
AGENTS.md 规则 7(默认仅回环、非回环需 APX_TOKEN)、规则 8(副作用方法需幂等键)、规则 10(强动作需确认、浏览器不代填密码/支付、临时同意不升级为全局授权)、规则 11(secret:// 引用)以及 apx-mcp 的 scope 令牌与 apx-extensions 的默认关闭/严格 schema 都体现了最小权限与确认机制,故 least_privilege/user_confirmation 给 2。数据流方面 README 明确说明云端模型会收到请求所需内容、本地运行不等于离线,属诚实披露但无逐项数据流清单,给 2。敏感数据处理有 secret:// 与不写入 .apc 的规则,但未见密钥存储实现细节,给 2。依赖安全仅见 devDependencies 与 pnpm 版本,无审计/锁定策略证据,给 1。外部效应(安装脚本 curl|bash、接管 v1 的 apx 命令、停止 v1 daemon)有说明但无回滚路径,external_effects 与 rollback 各给 1。来源归属有 MIT 与仓库链接,但发布者身份未验证、无签名,给 1。
AGENTS.md 的“一种做法”原则、单一 runTurn()/threads.send 契约、协议方法注册表与测试支撑文件(transport.test-support 校验方法名与参数 schema)显示内部一致性较好,给 2。依赖可用性仅见 engines node>=24.11 与 [email protected],无锁文件或依赖清单证据,给 1。失败信息方面 apx-mcp 提供“工具不出现”的分步排查、apx status 的 code_sha 校验,给 2。
README 与技能覆盖桌面、服务器、手机、消息渠道、Claude Code/Codex 等多种场景,audience_and_scenarios 给 2。能力边界有“Works today / Foundations / Roadmap”三栏与“Foundations 不是完成的服务”的明确说明,capability_boundaries 给 2。触发精度方面 apc-context 的 description 要求“ALWAYS activate”并强制迁移提示,触发条件过宽且带强制行为,给 1。环境适配有 macOS/Windows/Linux、无 root、~/.apx/v2 等说明,给 2。
AGENTS.md 提供术语表、仓库地图与编号规则,信息架构清晰,给 2。安装说明覆盖桌面、终端、服务器、手机,install_notes 给 2。命名稳定(core/terminal/protocol 等术语固定),给 2。示例与 FAQ 有部分命令示例但无集中 FAQ,给 1。已知限制仅“应用未签名”“Foundations 未完成”等零散说明,给 1。LICENSE 为完整 MIT,给 2。版本化有 v1/v2 分支与 release 徽章,但无 CHANGELOG,给 1。维护责任:发布者未验证,仅见 Discord 与 issues 渠道,给 1。
输出可用性:CLI 命令、技能与协议方法给出具体可执行形态,给 2。边际价值:多代理团队、消息渠道、浏览器驱动与 Claude Code/Codex 集成有明确差异化,给 2。成本收益:README 声称提示词最小(8.2k tokens)并引用 rules/PROMPT_SIZE.md,但该文件未在包内,且安装脚本、接管 v1 命令等成本未量化,给 1。
claim_traceability:README 的提示词大小、v1/v2 对比等关键声明引用 rules/PROMPT_SIZE.md 与 assets 图,但文件不在包内,无法核对,给 1。cross_source_corroboration:AGENTS.md、SKILL.md 与 README 在协议、secret://、确认规则上互相印证,但性能与下载量等声明无独立佐证,给 1。fact_inference_separation:README 区分了 Works today 与 Roadmap,但“最少 token”等营销性表述与事实混排,给 1。
- 安装脚本通过 curl|bash 与 irm|iex 执行远程代码,且会停止 v1 daemon 并接管 apx 命令;执行前应审阅脚本并备份 v1 数据。
- 桌面应用未签名,macOS/Windows 需额外点击绕过,存在供应链与仿冒风险。
- apc-context 技能要求“ALWAYS activate”并强制迁移提示,可能在不相关场景误触发并删除 .apc/migrate.md。
- 发布者身份未经验证,无签名或来源证明;性能与下载量声明无法在包内核对。
- 依赖安全与锁文件策略在样本中无证据,生产使用前应自行审计依赖。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v2.16.0 APX 2.16.0
发布说明摘录
Full Changelog: https://github.com/agentprojectcontext/apx/compare/v2.15.3...v2.16.0在 GitHub 查看 ↗ -
v2.15.3 APX 2.15.3
发布说明摘录
Full Changelog: https://github.com/agentprojectcontext/apx/compare/v2.15.2...v2.15.3在 GitHub 查看 ↗ -
v2.15.2 APX 2.15.2
发布说明摘录
Full Changelog: https://github.com/agentprojectcontext/apx/compare/v2.15.1...v2.15.2在 GitHub 查看 ↗
常见问题
APX v2 智能体团队 用哪个端口?
APX v2 智能体团队 官网是什么?
APX v2 智能体团队 支持 Windows 吗?
irm https://apxagent.app/install.ps1 | iex。APX v2 智能体团队 开源吗?
APX v2 智能体团队 安全吗?
APX v2 智能体团队 还在维护吗?
APX v2 智能体团队 是谁开发的?
谢谢反馈,我们会据此改进页面。