# @aui\.io/apollo 中文文档

规范地址：https://npmcn.com/package/%40aui.io/apollo/

版本：0\.1\.112
npm 元数据更新时间：2026-11-05T13:45:30.865Z
中文译文更新时间：2026-11-07T04:49:50.259Z
软件包许可：SEE LICENSE IN LICENSE

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

原始 npm 页面：https://www.npmjs.com/package/%40aui.io/apollo
原文对照：https://npmcn.com/package/%40aui.io/apollo/?lang=original
项目主页：https://docs.aui.io/cli/overview
源码仓库：https://bitbucket.org/getstuff/runtime-v2

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

- 包体积（解压后）：27.9 MB，1799 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：12 个
- 首次发布：2026-07-23T16:10:44.192Z
- 最新版本发布：2026-11-05T13:45:30.712Z
- 近 30 天下载量：5400（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：85（近 12 个月 85 个）

## 中文简介

阿波罗 CLI – 作者,测试和操作来自您终端的 Apolo-1 代理(可描述 CLI + 交互式 TUI)

## 安装

```sh
npm install @aui.io/apollo
```

也可以使用：`pnpm add @aui.io/apollo`、`yarn add @aui.io/apollo`、`bun add @aui.io/apollo`

## README

# 阿波罗CLI - `@aui.io/apollo`

**作者,测试,操作阿波罗特工 从您的终端.**

阿波罗CLI是操作控制台 操作控制台的代理 [阿波罗1号](https://www.aui.io/), (中文(简体) ), AUI神经-同义基模型. 一个安装给你两个表面:

-   可脚本命令行接口 - `apollo <command>`,带有 `--json` 模式 脚本和编码代理;
-   全屏终端 UI( 空白) `apollo`),为作者 + 验证 → 测试 → 推回环.

一个特工的程序是 **键入了 YAML 代码库** 您在本地端的检出中保留, 在您的编辑中编辑 具有计划支持的 IDE, 验证, 测试实时运行时间, 并按新程序推回 各个版本。 同一代理商可进入 [游戏场](https://apollo.aui.io/)。 。 。 .

完整文档 : **[文献:aui.io/cli](https://docs.aui.io/cli/overview)**

* * *

## 所需资源

| 所需经费 | 需要时间 |
| --- | --- |
| AUI 账户 — 您使用的登录 [游戏场](https://apollo.aui.io/) | 所有的东西 |
| 节点.js 20或更新 | 所有的东西 |
| [阿宝](https://bun.sh/) (可选) | 仅限交互式 TUI |

不需要安装 npm 登录 。 "TUI"是建立在 [打开TUI](https://opentui.com/) 在Bun上运行:当从节点发射时, `apollo` 透明地重新执行TUI 下级 `bun` 从你的 `PATH`; 没有 Bun ,它会打印 安装导和 CLI 仍然完全可以使用.

## 安装

```bash
npm install -g @aui.io/apollo
apollo --version
apollo doctor          # checks Node/Bun, the install, your terminal and connectivity
```

稍后升级为:

```bash
apollo upgrade            # install the latest version from npm
apollo upgrade --check    # show the available version only
```

## 快开始

```bash
# 1. Sign in — opens the browser flow in the Playground
apollo login

# 2. Create a new agent, or import one you already have
apollo agent create "Returns Assistant"      # or: apollo agent import <agent-id>
cd <the printed checkout directory>          # defaults to ~/apollo/<profile>/<env>/<name>-<id>

# 3. Edit the program under bundle/src/
#    program.yaml · vocabulary.yaml · situations.yaml · sources.yaml ·
#    derivations.yaml · connections.yaml · capabilities/ · policies/

# 4. Validate — deterministic, with every finding located in a file
apollo validate

# 5. Talk to it against the live runtime WITHOUT deploying, and read the trace
apollo chat "I want to return an order" --local . --trace

# 6. Push the change, then make that SAVE the one customers get, when it is ready
apollo push -m "Describe the change"
apollo branch list
apollo branch live <tag>          # `v3.7` ships exactly that save; `v3` ships its newest
```

`apollo status` 总是告诉你你站在哪里 什么样的情况 组织 计划, 代理机和版本已激活, 并锁定退出的运行时间 .

## CLI的看法

上下文为 **职位**: 最近的一个 `.apollorc` 从当前目录上走 选择您正在工作的代理, 因此 `cd` 输入一个退出,每个命令都适用 给那个探员.

| 层 | 这是什么 | 图标 |
| --- | --- | --- |
| **简介** | 命名的证书槽( A)`default`, (中文(简体) ), `work`, (...) (中文(简体) ) | `profile current / list / use` |
| **组织** | 您的会议范围是 | `org list / use` |
| **项目** | 代理容器 | `project list / use / create` |
| **探员** | 您编辑和测试的程序 | `agent list / create / import / use / unlink` |
| **离职** | 本地目录中包含一个代理 : `.apollorc` + 键 `bundle/src/` | `agent create / import` |
| **版本** | 程序贴上标签的快照:草稿 已公布 存档(出版旧版本为回滚) | `branch list / get / use / create / publish / archive`, (中文(简体) ), `pull` 编号 : `push` |
| **运行时间** | 引擎制造的检查结果被固定在 | `runtime list / show / use` |

## 图标

```text
status      [--check]                          active context (+ service connectivity)
doctor      [--offline]                        diagnose the setup; exit 2 on problems
upgrade     [version] [--check] [--force]      upgrade from npm
login       [--sso | --email <e> [--otp <c>] | --token <jwt>]
logout
profile     current | list | use <name>
org         list | use <id>
project     list | use <id> | create <name>
agent       list | create <name> [--dir <path>] [--template <id>]
            | import [agent-id] [--tag <tag>] [--dir <path>] [--skills <targets>] [--force]
            | use <target> | path | unlink
runtime     list | show | use [version]
validate    [directory]                        validate the local program (exit 2 on errors)
diff        [--remote]                         compare local files with the last baseline
pull        [--tag] [--dir] [--force] [--skills cursor,claude,opencode] [--no-skills] [--no-schemas]
push        -m <message> [--dry-run]           validate and push local changes as a new version
version     list | get <tag> | use <tag> | create [--from <tag> | --template <id>] [--label] [--notes]
            | publish <tag> | archive <tag>
chat        [text…] [--thread <id>] [--local <dir>] [--var k=v] [--trace]
thread      create | list | get <id> | messages <id> | trace <id>
regress     [--scenarios <ids>] [--explain] [--follow] [--status] [--cancel] [--pull]
evaluate    [directory] [guidelines] [--simulations <n>] [--min-turns] [--max-turns] [--seed] [--follow]
advise      <question> [--fresh] [--model] [--max-usd]
build       <instruction> [-m] [--version-tag] [--publish] [--model] [--max-usd]
mockdb      provision [--wire] | status | describe | export | keys | wire | clone --from <id> | reset [--scope data|all] --force | delete --force
            | collections create | update | list | truncate | delete · seed (--rows | --file) [--mode] · rows list | patch | delete
            | endpoint create | list | get | update | delete · execute --slug <s> [--session] [--body] · session get | reset · rotate mgmt | runtime
            | identities get | set · guide
vault       set <NAME> | list | get <NAME> | rm <NAME> --force
kb          list | status <name> | create <name> | add <hub> <files…> | add-url <hub> <urls…>
            | check | export [name] | delete <name> --force | connections | resync <hub>
report      <title> [--kind] [--confidence] [--summary] [--tried …] [--command] [--dry-run] [--no-session]
shell-init                                     print the shell hook (see below)
```

运行 `apollo <command> --help` 用于您已安装的版本中的活式旗帜列表 指令表面对照CLI本身进行验证,所以 `--help` 总是权威.

### 全球旗帜( 在子命令前)

`--json` (脚本的稳定信封)- `--quiet` • 妇女 `--verbose` (外诊断, 包括每个API请求一条直播线)- `--no-input` • 妇女 `--yes` • 妇女 `--profile <name>` • 妇女 `--project <id>` • 妇女 `--org <id>` • 妇女 `--runtime-version <version>` • 妇女 `--timeout <ms>`

JSON 模式总是发出 `{"success":true,"data":…}` 或者说 `{"success":false,"error":{"code","message","suggestion"}}`。 。 。 . 退出代码 : `0` 成功 · `1` 运行时间/ API 失败 `2` 验证失败 ^ `3` auth/ 配置失败 .

## 认证

```bash
apollo login                               # browser sign-in via the Playground (default)
apollo login --email you@example.com       # email one-time code, then prompts for it
apollo login --token "$ACCESS_TOKEN"       # store a pre-issued access token
apollo whoami                              # who this session acts as, checked with identity
apollo logout
```

全权证书按 **配置文件** 内 `~/.apollo/credentials.json` (模式) `0600`) (中文(简体) ). 使用配置文件并存多个账户( U)`apollo profile use work`,或 `--profile work` 一个命令.

**CI和自动化:** 设定 `APOLLO_TOKEN` 在环境中运行 `--json --no-input`没有提示,每个结果都是机器可读信封. 一个 `APOLLO_TOKEN` 运行从不触及已保存的登录: 过期的符号失败 `AUTH_ERROR` 而不是向存储在磁盘上的人刷新.

## 与编码代理合作

CLI的设计是由编码剂和人类一样驱动. `apollo agent import` 编号 : `apollo pull` 安装作者 **技术包** 还有一个 `AGENTS.md` 输入 离职( e)`--skills cursor,claude,opencode` 选择目标; `--no-skills` 跳过他们, cursor、 Claude Code 和 OpenCode 等工具可以编写、验证、测试和推动 代理结束结束. `apollo advise "<question>"` 询问服务器侧作者顾问 您的离职,和 `apollo build "<instruction>"` 运行一个大楼 翻过被推进的代理.

## 一分钟之内的TUI

裸体 `apollo` 在 TTY 上发射终端 UI(`apollo tui` 编号 : `--tui` 强制; 任何 子命令, `--json`, (中文(简体) ), `--no-input` 或非TTY总是运行CLI; `APOLLO_TUI=0` 保持一个 赤裸的TTY在CLI上。 两种主要模式—— **作者** (验证,diff,推,拉,版本, 资源、假设情景) **说话** (与运行的代理交谈).

| 投入 | 行动 |
| --- | --- |
| `Ctrl+1` 编号 : `Ctrl+2` (或 `Tab`(中文(简体) ) | 作者/ 说话 |
| `Ctrl+K` | 动作调色板——每个操作,其CLI等同 |
| `Ctrl+G` | 上下文切换器 — profile / 代理 / project / org |
| `Ctrl+J` | 活动抽屉——操作,再试,输出,活的API-请求尾巴 |
| `Esc` | 关闭重叠/ 取消 |

在作者中,单字母运行为快动作(`v` 验证 · `d` iff `p` 推动.. `l` 拖动.. `r` 版本 · `m` \* 资源 `s` 情况 `o` 在 IDE 中打开,并免费 文本是给作者后端的副驾驶指示。 在"谈"中,作曲家会发出 所有的一切 代理逐字记录.

## 测试代理

| 莱恩 | 命令 | 证明什么 |
| --- | --- | --- |
| 谈话 | `apollo chat "…" --trace` (单位:千美元)`--local .` 发送工作树而不是被驱动的版本) | 转一圈,有象征意义 **追踪** - 答复背后的推理记录 |
| 脚本回归 | `apollo regress --follow` | 每一个情景 `bundle/build/scenarios.yaml`,说如书面, 作为真正的谈话 |
| 模拟呼叫者 | `apollo evaluate "<guidelines>" --follow` | jev 解答案件的问题, LLM 法官对判决的评分 |
| 线索 | `apollo thread list / messages <id> / trace <id>` | 检查任何事后的对话 |

## 数据您的代理读取

-   **模拟数据库** —— 说 `apollo mockdb …` 提供可种子的每剂模拟数据库 并用已宣布的终点来构建和测试现实数据,然后才进行真实的 后端存在 . `apollo mockdb guide` 将完整的方式写入您的离职.
-   **知识中心** —— 说 `apollo kb …` 创建中枢、上传文档或刮去 URL 他们,检查程序 `hub:` 推前的参考文献。 作为枢纽的连接器 (Notion, Collection, Google Drive,.)同步, `kb connections` 显示其同步过程 财务报告和审定财务报表 `kb resync <hub>` 现在运行一个.
-   **秘诀** —— 说 `apollo vault set <NAME>` 按名称存储连接证书; 程序 参考它们(`token_env`, (中文(简体) ), `${NAME}`(单位:千美元) `bundle/src/connections.yaml` 永不携带 一个值.

## 诊断

```bash
apollo doctor             # diagnose the setup end to end; exit 2 on problems
apollo status --check     # context + per-service reachability/auth
apollo --verbose <cmd>    # stream each API call live to stderr
```

`apollo doctor` 检查运行时间(Node/Bun),安装来源, shell 集成, `APOLLO_*` 覆盖 正在使用的代理 终端能力 证书权限, 符号过期, 当前检出, 和服务可达性 —— 只读, 有固定 随附每个发现。 在报告问题时分享其产出.

`apollo report "<the fault>"` 文件错误不是程序的错误——引擎 cLI违反合约 失败 —— 您的登录 。 它附加了检出,引擎构建,CLI版本 并且,在一个编码代理下,会话命令, 清除秘密(无论你是什么) 类型d); `--dry-run` 准确显示将发送什么。 CLI 也自行存档崩溃和 背景中的服务器出错 . `APOLLO_REPORTS=0` 全部关掉.

`--verbose` 溪流一 **已编辑** 每个 API 请求的行数( 自动/ 托肯/ 密钥/ 秘密值) 从未出现过) stderr——一个没有得到答复的请求说为什么(拒绝连接,a 超时, 一个不信任的证书; TUI 显示同一流的活性 抽屉.

## 在公司代理的背后

把代理设置在卷曲的方式。 CLI和TUI提出的每一项要求 更新检查,然后通过:

```bash
export HTTPS_PROXY=http://proxy.example.com:8080       # user:password@ before the host if it needs a login
export NO_PROXY=localhost,127.0.0.1                     # hosts that skip it; .example.com covers subdomains
export NODE_EXTRA_CA_CERTS=/path/to/corporate-ca.pem    # only if the proxy inspects HTTPS
apollo doctor                                           # shows the proxy in use and what each service answers
```

小写表( E)`https_proxy`, (中文(简体) ), `http_proxy`, (中文(简体) ), `no_proxy`)工作也,当两者同时获胜 已经设定。 只有 HTTP( S) 代理被支持—— 一个空 `host:port` 读作 `http://host:port`,以及任何其他计划`socks5://`,.)因姓名而不是姓名而被拒绝 默然而去.

## 文件和环境变量

```text
~/.apollo/
  config.json          # profile, default projects
  credentials.json     # tokens (mode 0600 — the only secret-bearing file)
  checkouts.json       # known-checkouts registry
  baselines/…          # sync hashes for diff/push

<checkout>/.apollorc   # org / project / agent / version_tag binding
<checkout>/bundle/src/ # the editable program source
```

| 变量 | 效果 |
| --- | --- |
| `APOLLO_PROFILE` | 要使用的证书配置文件 |
| `APOLLO_TOKEN` | cI 访问令牌( 不需要存储会话) |
| `APOLLO_ORG_ID`, (中文(简体) ), `APOLLO_PROJECT_ID` | 覆盖活动的组织/项目 |
| `APOLLO_RUNTIME_VERSION` | 覆盖停机时间 |
| `APOLLO_TIMEOUT_MS` | 请求超时 |
| `APOLLO_TUI` | `0` 保持一个裸露的TTY在CLI上 |
| `APOLLO_REPORTS` | `0` 关闭发布报告—— `apollo report` 和CLI的自己 |
| `HTTPS_PROXY`, (中文(简体) ), `HTTP_PROXY` | 通过此代理机发送请求( s)`http://[user:password@]host:port`(中文(简体) ) |
| `NO_PROXY` | 跳过代理服务器的主机( r)`localhost,.internal.example.com`(中文(简体) ) |
| `NODE_EXTRA_CA_CERTS` | 要信任的 CA 证书( PEM), 用于检查 HTTPS 的代理 |

完整表格,包括每个服务的 URL 覆盖,在 [配置参考](https://docs.aui.io/cli/configuration)。 。 。 .

## 壳牌集成

邮站台阶提供一个小贝壳钩(或自己加入) `eval "$(apollo shell-init)"`: 它让 `apollo agent use / import / create` 放下枪 shell 直接输入出账目录 .

## 文件和支助

-   [CLI 概况](https://docs.aui.io/cli/overview) • 妇女 [安装](https://docs.aui.io/cli/installation) • 妇女 [图标](https://docs.aui.io/cli/commands) • 妇女 [配置](https://docs.aui.io/cli/configuration) • 妇女 [工作流量](https://docs.aui.io/cli/workflows)
-   [阿波罗一号文档](https://docs.aui.io/) ——程序模型,Message API,代理构建器API和SDK
-   [游戏场](https://apollo.aui.io/) ——浏览器中相同的代理
-   问题:运行 `apollo doctor`,则 [联系AUI](https://www.aui.io/contact-us) 及其产出

## 使用条件

使用此软件包,以及它所称的阿波罗API,均受以下规范: **[AUI API 和开发者成套服务条款](https://www.aui.io/api-and-developer-package-terms-of-service/)**。 。 。 . 通过安装或使用 `@aui.io/apollo` 你同意这些条件.

AUI (英语). 版权所有.

## 常见问题

### @aui\.io/apollo 是什么？

阿波罗 CLI – 作者,测试和操作来自您终端的 Apolo-1 代理\(可描述 CLI \+ 交互式 TUI\)

### 如何安装 @aui\.io/apollo？

在项目目录运行 npm install @aui\.io/apollo，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 apollo，可以用 npx apollo 直接运行。

### @aui\.io/apollo 支持 TypeScript 吗？

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

### @aui\.io/apollo 支持 ESM 还是 CommonJS？

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

### @aui\.io/apollo 需要什么版本的 Node\.js？

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

### @aui\.io/apollo 可以商用吗？

@aui\.io/apollo 使用 SEE LICENSE IN LICENSE 许可。许可条款写在包内的独立文件中，请阅读该文件确认可否商用。以上为概括，不构成法律意见，请以许可原文为准。

### @aui\.io/apollo 的下载量有多少？

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

### @aui\.io/apollo 还在维护吗？

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