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；可委托权限包含 cli.compat。
运行环境	Node.js 18 或以上，安装支持 MEOO_TOKEN 的 CLI 接入版本；Agent 具备终端执行能力及 Skill 加载能力。
服务地址	生产环境为 https://meoo.com；联调时使用对应环境地址及该环境签发的凭证。

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

3. 用 AK/SK 签发成员 token

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

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 接入安装包完成安装。将下面的安装包路径替换为实际路径：

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 安装到它实际加载的目录：

meoo skill install --target /path/to/agent/skills/meoo-cli

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

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

将签发接口返回的 access_token 设置为 MEOO_TOKEN，将目标环境地址设置为 MEOO_API_URL。以下以生产环境演示调用顺序：

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：

meoo projects use "<项目 urlId>"
meoo cloud status
meoo sandbox push
meoo deploy

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

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 用于描述操作流程。这样可以按成员身份运行任务，并由接入方统一管理凭证有效期与调用范围。

​1. 两种 Agent 接入方式

​2. 准备接入资源

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

​4. 安装 CLI 和配套 Skill

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

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