> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meoo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI 开放集成接入

使用 Meoo 提供的 **Skill + CLI**，可以让你的 Agent 直接调用秒悟的项目开发、云服务、源码同步和发布能力。将配套 Skill 和 CLI 配置到 Agent 运行环境后，接入方只需签发临时 token 并注入 **MEOO\_TOKEN**，Agent 即可按 Skill 指引使用。

**接入流程：安装 Meoo Skill + CLI → 用团队 AK/SK 签发临时 token → 注入 MEOO\_TOKEN → Agent 执行任务。**

## 1. 两种 Agent 接入方式

你可以直接使用 Meoo 提供的 Skill + CLI，也可以基于**云服务 OpenAPI 和项目导入 API**自行封装 Agent 工具。两种方式的接入工作如下：

| 对比项        | 使用 Meoo Skill + CLI                                         | 基于 OpenAPI 自行封装                                           |
| :--------- | :---------------------------------------------------------- | :-------------------------------------------------------- |
| Meoo 提供什么  | 配套 Skill、CLI、项目模板和操作命令，供 Agent 直接使用。                        | 云服务 OpenAPI 和项目导入 API，供接入方构建自己的工具。                        |
| 接入方做什么     | 安装配套 Skill 和 CLI，为 Agent 签发临时 token，并通过 MEOO\_TOKEN 注入运行环境。 | 将 API 封装为 Agent 工具，定义工具参数和结果处理，自行生成项目结构并组织调用流程。           |
| Agent 如何使用 | 读取我们提供的 Skill，按指引选择 CLI 命令并执行任务。                            | 读取接入方提供的工具说明和流程指引，调用接入方封装的工具。                             |
| 项目如何组织     | Agent 使用 CLI 项目模板，按配套 Skill 的指引组织代码、使用云服务并完成同步和发布。          | 接入方自行生成符合运行要求的项目结构，通过云服务 OpenAPI 配置相关能力，并通过项目导入 API 接入项目。 |
| 适合的接入诉求    | 快速让已有 Agent 使用秒悟能力，复用我们提供的工具与操作指引。                          | 自行设计 Agent 工具、项目结构和开发流程，按需组合底层 API 能力。                    |

例如，让 Agent 开发并发布一个使用云服务的应用：采用 Skill + CLI 时，Agent 按我们提供的指引初始化项目、调用云服务命令、同步代码并发布；采用 API 自行封装时，接入方准备相应的 Agent 工具、生成项目结构，并组织云服务和项目导入 API 的调用。

本文介绍 Skill + CLI 的接入步骤：由接入方使用团队 AK/SK 签发成员临时 token，Agent 通过 MEOO\_TOKEN 使用平台能力。云服务 OpenAPI 与项目导入 API 的细节可查阅「API Reference」和「项目导入、构建与发布」。

## 2. 准备接入资源

| 准备项         | 用途与配置                                                                                                       |
| :---------- | :---------------------------------------------------------------------------------------------------------- |
| 开放团队与 AK/SK | 在开放版管理后台创建团队 API 凭证，由接入方服务端保存 AK/SK 并完成请求签名。                                                                |
| 成员身份        | 联调时可使用团队 Owner；面向业务用户时，建立业务用户与虚拟成员 member\_id 的映射。                                                          |
| 凭证权限        | 团队 AK/SK 配置 team.member.token.issue；查询成员时配置 [team.member.read](http://team.member.read)；可委托权限包含 cli.compat。 |
| 运行环境        | Node.js 18 或以上，安装支持 MEOO\_TOKEN 的 CLI 接入版本；Agent 具备终端执行能力及 Skill 加载能力。                                      |
| 服务地址        | 生产环境为 [https://meoo.com；联调时使用对应环境地址及该环境签发的凭证。](https://meoo.com；联调时使用对应环境地址及该环境签发的凭证。)                      |

团队开通、AK/SK 获取、成员管理及签名规则，参见同一文档目录中的「团队系统集成」。

## 3. 用 AK/SK 签发成员 token

在接入方服务端，按团队 AK/SK 的 HMAC 签名协议调用成员 token 接口：

```text theme={null}
POST /open/v1/team/members/{member_id}/tokens
Content-Type: application/json

{
  "scopes": ["cli.compat"],
  "expires_in": 900
}
```

member\_id 选择本次任务对应的团队成员。expires\_in 为有效期秒数，按任务时长设置，并满足团队凭证允许的有效期范围。签发请求使用团队 AK/SK 完成签名。

从响应中取得 access\_token 和 expires\_in。接入方记录到期时间，将 access\_token 作为后续 CLI 调用使用的成员 token。CLI 以该成员身份执行操作，项目访问范围由成员所属团队、角色和资源权限共同确定。

## 4. 安装 CLI 和配套 Skill

在 Agent 或 CI 的运行环境中，使用平台提供的 CLI 接入安装包完成安装。将下面的安装包路径替换为实际路径：

```text theme={null}
npm install -g "/path/to/meoo-cli.tgz"
meoo --version
meoo skill install
```

meoo-cli Skill 随 CLI 安装包提供。meoo skill install 会检测 Claude Code、Cursor、Trae、CodeBuddy、Qoder 的已有配置目录。自有 Agent 可将 Skill 安装到它实际加载的目录：

```text theme={null}
meoo skill install --target /path/to/agent/skills/meoo-cli
```

目标目录为 meoo-cli Skill 文件夹本身，包含 [SKILL.md](http://SKILL.md) 和 references/。将该目录配置到 Agent 的 Skill 加载路径；升级 CLI 后再次执行安装命令，同步配套指引。

## 5. 注入 token，让 Agent 执行命令

将签发接口返回的 access\_token 设置为 **MEOO\_TOKEN**，将目标环境地址设置为 **MEOO\_API\_URL**。以下以生产环境演示调用顺序：

```text theme={null}
export MEOO_TOKEN="<access_token>"
export MEOO_API_URL="https://meoo.com"

meoo --json whoami
meoo --json projects list
```

实际接入时，由接入方服务端、Secret 管理或任务调度器将变量注入 Agent 的命令执行进程。Agent 启动的 CLI 子进程继承这些变量。多个业务用户并发运行时，按任务分别传入各自成员的 token。

完成身份和项目查询后，可以让 Agent 按 Skill 执行具体任务。例如：

使用 meoo-cli Skill，查看当前可访问的项目。选择我指定的项目，将本地修改同步到项目沙箱，并反馈执行结果。运行环境已配置 MEOO\_TOKEN 和 MEOO\_API\_URL。

以下为项目操作示例，在本地应用目录中使用实际项目 urlId：

```text theme={null}
meoo projects use "<项目 urlId>"
meoo cloud status
meoo sandbox push
meoo deploy
```

上面的命令依次选择项目、查看云服务状态、同步本地源码和构建发布。接入方根据任务选择相应步骤。Agent 可使用 --json 获取结构化结果，并将操作状态、错误信息及产出反馈给用户。

CI 已完成静态构建时，可使用构建产物执行发布：

```text theme={null}
meoo --json deploy --project "<项目 urlId>" --skip-build --skip-push --force
```

该命令使用已有构建产物直接发布到目标项目。执行前完成构建并核对项目；--force 用于自动化任务中的确认步骤。

## 6. 在任务运行中管理 token

| 任务阶段       | 接入方处理                                                                |
| :--------- | :------------------------------------------------------------------- |
| 任务启动       | 根据业务用户确定 member\_id，签发或复用有效 token，并注入执行进程。                           |
| token 临近到期 | 使用团队 AK/SK 为同一成员重新签发 token，后续 CLI 调用使用新值；运行中的 Agent 通过执行器更新后续子进程的环境。 |
| 身份或权限错误    | 检查目标环境、token 到期时间、cli.compat 权限、成员状态及目标项目权限，修正后重新调用。                 |
| 任务完成       | 回收任务环境中的 token，保留任务结果及经过脱敏的操作记录。                                     |

AK/SK 由接入方服务端或密钥管理系统保存；成员 token 通过任务环境传递；Skill 用于描述操作流程。这样可以按成员身份运行任务，并由接入方统一管理凭证有效期与调用范围。