APX v2 智能体团队

在你自己的机器上托管一支 AI 团队:一个总智能体负责接收消息与分派,多个项目智能体按角色协作。

Star 数
★ 35
最近更新
今天
License
MIT
主语言
TypeScript

30 秒速览

可在哪里用
通用 · 跨平台ChatGPT · Codex · Claude Code · Claude.ai · OpenAI API · Claude API
开始前需要
Node.js 运行时(核心守护进程与 CLI)pnpm(从源码构建)Electron 桌面应用(macOS/Windows/Linux,可选)v2 发布中的 Android APK(可选)Shell / 命令行网络访问本地文件系统MCP Server
典型场景
独立开发者想用 WhatsApp 或 Telegram 随时给一个总智能体下指令,让它把调研交给项目里的另一个智能体并在浏览器中打开来源页面。
主要局限
安装包尚未签名,macOS 与 Windows 需要额外的手动放行步骤,对受管控环境不友好。
官网
apxagent.app ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-20最新版本 v2.16.0(2026-11-20)

这个 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 完成服务器与设备的配对。

  1. 独立开发者想用 WhatsApp 或 Telegram 随时给一个总智能体下指令,让它把调研交给项目里的另一个智能体并在浏览器中打开来源页面。
  2. 小团队在一台 VPS 或家庭服务器上部署 APX,通过 Tailscale 暴露给成员,每个人用桌面端和 Android 应用配对接入各自的项目团队。
  3. 需要按周固定产出报告的人,用定时例程让智能体在无人值守时执行,只在有内容可汇报时主动发消息。
  4. 同时使用 Claude Code 与 Codex 的工程师,把两者的会话放在同一面板旁,和 APX 的聊天、任务一起管理。
  5. 需要本地模型或 OpenAI 兼容 API 的用户,自带模型接入,避免绑定单一供应商。
  6. 想把图表、清单等小工具沉淀下来的用户,让智能体现场构建小部件并固定到看板,供后续复用。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • curl -fsSL https://apxagent.app/install.sh | bash
  • irm 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 | bash
irm 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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
51/ 100 五分制 2.6 / 5
本评测基于 2026年11月10日 的源码;此后该项目发布了 10 个正式版本,尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 14/29
可靠稳定 8/14
适用触发 10/18
规范维护 9/18
有效结果 7/13
证据核验 3/8
查看各维度的扣分理由
信任安全14 / 29 · 2.4/5

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。

可靠稳定8 / 14 · 2.9/5

AGENTS.md 的“一种做法”原则、单一 runTurn()/threads.send 契约、协议方法注册表与测试支撑文件(transport.test-support 校验方法名与参数 schema)显示内部一致性较好,给 2。依赖可用性仅见 engines node>=24.11 与 [email protected],无锁文件或依赖清单证据,给 1。失败信息方面 apx-mcp 提供“工具不出现”的分步排查、apx status 的 code_sha 校验,给 2。

适用触发10 / 18 · 2.8/5

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。

规范维护9 / 18 · 2.5/5

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。

有效结果7 / 13 · 2.7/5

输出可用性:CLI 命令、技能与协议方法给出具体可执行形态,给 2。边际价值:多代理团队、消息渠道、浏览器驱动与 Claude Code/Codex 集成有明确差异化,给 2。成本收益:README 声称提示词最小(8.2k tokens)并引用 rules/PROMPT_SIZE.md,但该文件未在包内,且安装脚本、接管 v1 命令等成本未量化,给 1。

证据核验3 / 8 · 1.9/5

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。
  • 发布者身份未经验证,无签名或来源证明;性能与下载量声明无法在包内核对。
  • 依赖安全与锁文件策略在样本中无证据,生产使用前应自行审计依赖。
证据充分度:低 评估于 2026年11月10日 审查版本 87992399af85 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/apx.svg?lang=zh)](https://followagents.com/zh/agents/apx)
<a href="https://followagents.com/zh/agents/apx"><img src="https://followagents.com/badge/apx.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. v2.16.0 APX 2.16.0
    发布说明摘录
    Full Changelog: https://github.com/agentprojectcontext/apx/compare/v2.15.3...v2.16.0
    在 GitHub 查看 ↗
  2. v2.15.3 APX 2.15.3
    发布说明摘录
    Full Changelog: https://github.com/agentprojectcontext/apx/compare/v2.15.2...v2.15.3
    在 GitHub 查看 ↗
  3. v2.15.2 APX 2.15.2
    发布说明摘录
    Full Changelog: https://github.com/agentprojectcontext/apx/compare/v2.15.1...v2.15.2
    在 GitHub 查看 ↗

常见问题

APX v2 智能体团队 用哪个端口?
本页安装说明里用的是 7440 端口(例如 http://localhost:7440)。如果项目支持修改端口,方法以 README 为准。
APX v2 智能体团队 官网是什么?
APX v2 智能体团队 的 GitHub 仓库填写的官网是 https://apxagent.app/。这个链接由仓库作者设置;源码在 GitHub(agentprojectcontext/apx)。
APX v2 智能体团队 支持 Windows 吗?
支持。本页安装说明里有 Windows 的安装命令:irm https://apxagent.app/install.ps1 | iex。
APX v2 智能体团队 开源吗?
开源。源码在 GitHub(agentprojectcontext/apx),许可证是 MIT。
APX v2 智能体团队 安全吗?
FollowAgents 的 FARS 评审(2026年11月10日)给 APX v2 智能体团队 的“信任与安全”打了 14/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
APX v2 智能体团队 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-20,在最近 30 天内。最新版本是 v2.16.0(2026-11-20)。
APX v2 智能体团队 是谁开发的?
APX v2 智能体团队 由 GitHub 账号 agentprojectcontext 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

所属宿主生态

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念