# @agentprojectcontext/apx 中文文档

规范地址：https://npmcn.com/package/%40agentprojectcontext/apx/

版本：1\.127\.0
npm 元数据更新时间：2026-10-26T02:43:19.029Z
中文译文更新时间：2026-11-06T03:00:51.222Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agentprojectcontext/apx
原文对照：https://npmcn.com/package/%40agentprojectcontext/apx/?lang=original
项目主页：https://github.com/agentprojectcontext/apx
源码仓库：https://github.com/agentprojectcontext/apx

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：42.8 MB，1769 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22
- 运行依赖：20 个
- 首次发布：2026-05-08T22:24:34.962Z
- 最新版本发布：2026-10-26T02:43:14.904Z
- 近 30 天下载量：6021（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：208（近 12 个月 208 个）

## 中文简介

APX——用于代理项目背景(APC)标准的统一CLI+守护进程.

## 安装

```sh
npm install @agentprojectcontext/apx
```

也可以使用：`pnpm add @agentprojectcontext/apx`、`yarn add @agentprojectcontext/apx`、`bun add @agentprojectcontext/apx`

## README

> \[尖叫声\] **APX v1不再维持. APX v2 替换为:** 一个新的桌面应用程序、一个电话应用程序和一个单行安装 您的服务器, 从零开始重建 。 它带来了你的v1项目,代理和聊天. **[见APX v2](https://agentprojectcontext.github.io/apx/)** • 妇女 `curl -fsSL https://agentprojectcontext.github.io/apx/install.sh | bash`

![APX — Meet your crew](https://npmcn.com/package/%40agentprojectcontext/apx/assets/banner.webp)

### 见你的船员们.

**APX是一个开源代理OS:你自己的AI代理团队,运行在你的机器上.**  
给他们角色,记忆和工具. 和他们说话,让他们一起工作,跟随他们的行为.  
研究,写作,日常计划,业务操作或代码——围绕你的生活和工作建立船员队伍.

[![Visit the APX website](https://img.shields.io/badge/Website-meet_your_crew-3fb950?style=flat-square)](https://agentprojectcontext.github.io/apx/) [![License: MIT](https://img.shields.io/badge/License-MIT-3fb950?style=flat-square)](https://npmcn.com/package/%40agentprojectcontext/apx/LICENSE) [![APX v1 downloads on npm](https://img.shields.io/npm/dm/%40agentprojectcontext%2Fapx?style=flat-square&label=npm&color=3fb950)](https://www.npmjs.com/package/@agentprojectcontext/apx) [![Downloads from GitHub releases](https://img.shields.io/github/downloads/agentprojectcontext/apx/total?style=flat-square&label=Downloads&color=3fb950)](https://github.com/agentprojectcontext/apx/releases) ![APX v1 requires Node.js 22+](https://img.shields.io/badge/Node.js-22%2B-3fb950?style=flat-square&logo=nodedotjs&logoColor=white) [![Join the community](https://img.shields.io/badge/Discord-join-5865F2?style=flat-square&logo=discord&logoColor=white)](https://discord.gg/vxdZuT5WuE)

**[见APX工作情况](https://agentprojectcontext.github.io/apx/)** • 妇女 [安装 v1](https://npmcn.com/package/%40agentprojectcontext/apx/#readme-quick-start) • 妇女 [APX v2 (中文(简体) )](https://agentprojectcontext.github.io/apx/) • 妇女 [西班牙语Name](https://npmcn.com/package/%40agentprojectcontext/apx/README_ES.md) • 妇女 [解析器](https://discord.gg/vxdZuT5WuE)

## 看到你的船员行动

[![Real APX v1 recording: agents working together in a group chat](https://npmcn.com/package/%40agentprojectcontext/apx/assets/demo-group-chat.gif)](https://agentprojectcontext.github.io/apx/)  
真实记录APX v1 运行演示组. [在网站上观看更多记录的工作流程.](https://agentprojectcontext.github.io/apx/)

每个特工都得到一个 **双管** ——它自己的面孔——与角色,记忆,技能和工具相伴. 在谈话中提及其中之一,它可以捡起工作或向另一名代理寻求帮助. 面相让你的船员容易识别;所记录的工作流程显示了它的实际作用.

## 尽你所能

-   **保持一个团队 为你的每一部分的工作.** 研究者,作家,组织者或编码代理:选择您需要的角色,并按项目分组.
-   **给团队工作.** 启动分组聊天, 在任务中提及代理, 并跟踪其回复 。 特工可以互相请求帮助.
-   **把经常性的工作安排在日程上.** 每日的通报会,报告和登机可以作为例行公事运行,而APX则保持运行.
-   **联系来自不同地点的同一批船员.** 使用网络面板, Telegram, WhatsApp 或您的手机; 您的代理人员保留他们的角色并访问他们的工具.
-   **见所出事.** 对话显示代理动作,而面板将聊天,任务,例行和代码会话合并在一起.
-   **带上你的模型和工具.** 连接模型提供商,当地Ollama模型,技能和MCP服务器. 对于编码工作,Claude Code, Codex或其他支持CLI的代表.

APX在你的机器上运行。 连接云模型和服务接收您发送请求所需的数据;本地操作并不意味着每个模型都下线运行.

## 为什么是APX?

尝试APX的原因是 **机组工作流程**:可辨认的代理人,围绕你的项目组织的角色, 在一个地方分享对话、下放的工作、任务和例行工作。 项目可以是企业,是创意 项目、个人工作空间或密码库。 您不需要 Git 寄存器开始使用 APX .

如果您已经使用 OpenClaw 或其他代理应用程序, 本地执行, 标记下的文件和信件集成 单靠自己不是改变的理由。 比较一下经验:APX是否让你的特定团队更容易组织, 合作跟随? [观看真实的工作流程](https://agentprojectcontext.github.io/apx/) 尝试一个任务 这对你很重要.

对于代码项目,代理定义,技能和共享的项目背景可以与寄存器一同出行. 对话、会话、全权证书和私人运行时间记忆都留在外面.

## 快开始

**这个寄存器和这些安装命令用于APX v1. Requireds Node.js 22+ on macOS, Linux 或 Windows.**

```bash
npm install -g @agentprojectcontext/apx
apx setup
```

设置向导帮助您选择一个提供者,一个模型和您的频道,启动APX,并打印您的面板地址. 打开 **[http://localhost:7430 (英语)](http://localhost:7430/)** 在您的浏览器中.

从一个代理和一个真正的任务开始. 随你需要增加专家及例行公事. 云提供商需要自己的访问权限或证书;本地模型需要配置的本地提供商.

更喜欢终点站? 从项目文件夹中 :

```bash
apx init
apx agent list
# Replace <agent> with an agent listed above.
apx exec <agent> "Help me plan the next steps for this project"
apx run <agent> --runtime claude-code "Review this project and suggest improvements"
apx run <agent> --runtime codex "Add tests for the parser"
```

编码命令需要安装和认证选定的外部 CLI .

## 在你的电话上

面板也适合你的电话. `apx panel share` 给您一个网络地址; `apx panel tailscale on` 让你通过尾网到达它。 在您的手机上打开面板并添加到您的家用屏幕上.

还有个本地人 **Android 应用程序**,带有通知,浮动吉祥物和Android Auto:

-   [下载 Android APK](https://github.com/agentprojectcontext/apx/releases/download/android-latest/apx.apk)。 。 。 .
-   或者用USB连接你的电话 然后运行 `apx android install`。 。 。 .
-   [读取安装指南](https://agentprojectcontext.github.io/apx/docs/surfaces/install-android/)。 。 。 .

Android应用从一个文件安装,在Google Play之外. 在iPhone上,使用网页面板. USB 访问在电缆连接时持续; 局域网访问停留在您的网络内; 尾网上的 Tailscale 连接设备 .

## APX v2 替换 v1

**v1不再维持.** APX v2将APX进一步作为您的机组的独立应用程序:从 [其网站](https://agentprojectcontext.github.io/apx/) 或 [`main` 分支](https://github.com/agentprojectcontext/apx)。上面的v1命令安装v1,而不是v2.

![APX V2 dark-mode demo: main agent delegates to Scout, creates an interactive launch widget and opens the source page in the browser panel](https://npmcn.com/package/%40agentprojectcontext/apx/assets/apx-v2-preview.png)  
运行有虚构数据的脚本演示的真V2接口:代理对代理授权,交互式部件和活浏览器页面. [观取取取光相相相.](https://npmcn.com/package/%40agentprojectcontext/apx/assets/apx-v2-preview-light.png)

| 经历 | APX v1 今天 | V2的方向 |
| --- | --- | --- |
| 你的主要经纪人 | 通过面板和渠道联系到一名当地助理 | 在个人和项目工作中与主要代理人和专家合作的中心场所 |
| 对话 | 聊天、分组交谈和代码会话 | 由工程、代理和频道组织的统一收件箱,以及外部编码会话 |
| 在网络上工作 | 通过集成浏览器工具 | 嵌入式桌面浏览器:监视代理导航并接管自己 |
| 工作结束后 | 小组中的代理行动、任务和例行程序 | 围绕当前工作空间进行的对话、授权的工作、工具、文件和应用 |
| 设备 | 网页面板、信件、桌面和Android表面 | 连接到同一核心的桌面和电话客户端,包括您自己的服务器上的主机核心 |

这些是方向和目前的发展经验,而不是每个v1特征已经达到对等的保证.

### V2的操作方式

```mermaid
flowchart TB
    You[You: desktop, phone or messaging] --> Main[Your main agent]
    Main <--> Crew[Specialists and project crews]
    Main --> Core[One APX core]
    Crew --> Core
    Core <--> Tools[Models, skills and connected tools]
    Core <--> Browser[Desktop browser: watch or take over]
    Core <--> Work[Conversations, tasks, routines and apps]
```

一个核心拥有作品和历史;应用程序,电话和消息频道与之相接. 您的主要代理人可以直接工作或委托给专家。 桌面提供浏览器, 在那里你可以看到页面并控制。 这样在设备之间移动时 船员们会在一起.

跟随 [网页](https://agentprojectcontext.github.io/apx/) 财务报告和审定财务报表 [解析器](https://discord.gg/vxdZuT5WuE) v2 进度并发布新闻.

## 文献和社区

-   [网站和记录演示](https://agentprojectcontext.github.io/apx/)
-   [用户文档](https://agentprojectcontext.github.io/apx/docs/)
-   [Discord 社区](https://discord.gg/vxdZuT5WuE)
-   [报告错误或建议改进](https://github.com/agentprojectcontext/apx/issues)

技术参考: v1 频道和编码运行时间

## 消息频道

活动属于APX运行时状态,而非 `.apc/`。信件存储为本地到 APX,在 `~/.apx/`数字 :

JSONL 信件包括 `type` (单位:千美元)`user`, (中文(简体) ), `agent`, (中文(简体) ), `tool`,或 `system`+) 加上 (中文(简体) ) `actor_id`,所以聊天视图 可以区分Telegram用户与APX代理和未来子代理.

A 类 **频道** 是表面的转动。 警犬名单在 `src/core/constants/channels.js`· ; `voice` 是一个 _模式_不是频道.

| 频道 | 它捕捉到的东西 |
| --- | --- |
| `cli` | `apx exec` 编号 : `apx run` 从终端 |
| `telegram` | 电报机器人消息 |
| `api` | 直接守护进程 HTTP 呼叫 |
| `web` | 管理员面板主聊天 |
| `web_sidebar` | 小组的副助理 |
| `web_code` | 面板的编码表面 |
| `code` | `apx code` 会议 |
| `deck` | 平板电脑/电话仪表板 |
| `desktop` | 浮动语音胶囊( 总是语音模式) |
| `routine` | 排定的例行运行 |

## 运行时间

| 运行时间 | 说明 |
| --- | --- |
| `claude-code` | Spawns Claude 代码 CLI 与代理系统迅速注射 |
| `codex` | 通过非交互操作的 OpenAI Codex CLI `codex exec --sandbox workspace-write --skip-git-repo-check` |
| `opencode` | 打开代码 CLI |
| `aider` | 援助者CLI |
| `cursor-agent` | 光标的无头代理 |
| `gemini-cli` | 谷歌双子座CLI |
| `qwen-code` | Quen 代码 CLI |
| `antigravity` | 反重力CLI |

Global APX 技能安装也写有名的助手技能 `codex-cli`, (中文(简体) ), `claude-code`, (中文(简体) ), `opencode-cli`,以及 `openrouter`。它们是有意缩小的,并且只有在下列情况下才能激活: 明确提到工具/提供者.

## APX开始的地方

APX开始作为一种方式 **装甲运兵车-代理项目背景** 实际工作:便携式代理人定义, 技术和项目指导 `AGENTS.md` 财务报告和审定财务报表 `.apc/`它发展成一个应用 自己的船员, 对话,任务,常规,渠道和接口. **APX是您今天使用的产品;APC是其发源地和项目编译基础的一部分.**

您不需要学习使用APX 的协议 。 如果你想要技术背景, 读取 [装甲运兵车规格](https://github.com/agentprojectcontext/agentprojectcontext)。 。 。 .

对于贡献者,从 [一般事务人员(其他职等)](https://npmcn.com/package/%40agentprojectcontext/apx/AGENTS.md). APX v1有本地守护进程,CLI,网络面板和连接外部工具的桥梁. 项目背景可以生活在项目文件夹中;运行时状态生活在 `~/.apx/`,位于仓库外.

## 许可证

[麻省理工学院](https://npmcn.com/package/%40agentprojectcontext/apx/LICENSE)

## 常见问题

### @agentprojectcontext/apx 是什么？

APX——用于代理项目背景\(APC\)标准的统一CLI\+守护进程\.

### 如何安装 @agentprojectcontext/apx？

在项目目录运行 npm install @agentprojectcontext/apx，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 apx、apx-acp、apx-mcp、apx-daemon，可以用 npx apx 直接运行。

### @agentprojectcontext/apx 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/agentprojectcontext\_\_apx 是否存在。

### @agentprojectcontext/apx 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @agentprojectcontext/apx 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @agentprojectcontext/apx 可以商用吗？

@agentprojectcontext/apx 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @agentprojectcontext/apx 的下载量有多少？

根据 npm 官方下载统计，@agentprojectcontext/apx 在 2026/10/05 – 2026/11/03 这 30 天内被下载 6,021 次，日均约 201 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @agentprojectcontext/apx 还在维护吗？

最新版本 1\.127\.0 发布于 2026/10/26（11 天前）；至今共发布 208 个版本，其中过去 12 个月发布了 208 个；首次发布于 2026/05/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。