$ npm install --global @createitv/agc-cli && agc version让每一次发布沿着 同一条红线前进。
用一套 Go 命令发现、预演并调用 AppGallery Connect API,为开发者、CI 和 Coding Agent 提供稳定 JSON。
$ agc auth check --pretty
{
"data": {
"name": "production",
"mode": "service-account",
"active": true
},
"affordances": {
"next": "agc publishing endpoints"
}
}已解析项目 Profile · 默认 dry-run
安装 agc CLI
用系统包管理器安装。
Windows、macOS 和 Linux CI 可通过同一条 NPM 命令无人值守安装。开发电脑仍可使用 Homebrew 或 Scoop 原生包。
$ brew tap createitv/tap && brew install agc-cli && agc versionPS> if (!(Get-Command scoop -ErrorAction SilentlyContinue)) { Set-ExecutionPolicy RemoteSigned -Scope CurrentUser -Force; irm get.scoop.sh | iex }; scoop bucket add createitv https://github.com/Createitv/scoop-bucket; scoop install agc-cli; agc versionAgent Skills
让 Coding Agent 真正理解 AppGallery Connect 工作流。
6 个可移植 Skills 参考 asc-cli 的任务分层方式设计。可以全部安装,也可以只选择一个工作流;每个 Skill 都支持查看源码、直接下载和通过 GitHub 参与完善。
提交一个 Skill$ agc skills install --agent codex --globalagc-cli-usage通用命令发现、dry-run 预演、授权执行和远程结果验证。
agc skills install --name agc-cli-usage --agent codex --globalagc-auth凭据 Profile、whoami、OAuth 团队查询和权限诊断。
agc skills install --name agc-auth --agent codex --globalagc-publishing应用资料、软件包、提交审核、分阶段发布和发布状态验证。
agc skills install --name agc-publishing --agent codex --globalagc-testing测试版本、群组、测试用户、邀请链接、反馈和版本转正。
agc skills install --name agc-testing --agent codex --globalagc-reports分发、安装、付费、留存和鸿蒙元服务报表导出。
agc skills install --name agc-reports --agent codex --globalagc-cicd跨平台固定版本安装、受保护凭据、dry-run 门禁和 CI 验证。
agc skills install --name agc-cicd --agent codex --global发布轨道
上下文向前流动,密钥留在本地。
每个阶段只完成一件事。凭据保存在本机,项目上下文可以安全共享,写入类 API 必须显式确认。
鉴权
PS256 / OAuth
PROFILE
项目自动绑定
软件包
上传与状态
发布
确认后调用
Profile 自动绑定
每个项目只选择一次,临时切换时再覆盖。
在 .agc/project.json 中绑定 production。命令会按固定优先级解析,也可以用 --profile staging 完成一次性切换。
- 1命令行显式覆盖
--profile staging - 2项目默认 Profile
.agc/project.json - 3全局激活账户
~/.agc/credentials.json
{
"appId": "123456789",
"projectId": "987654321",
"packageName": "com.example.app",
"profile": "production"
}接口注册表
先发现 API,再编写请求。
每个条目都包含 method、path、参数位置、CLI 命令、REST 路由和 dry-run 调用方式。
当前家族 / hosting
云托管
网站站点、环境、签名上传和版本归档发布。
agc hosting endpoints --output tableagc hosting status --pretty/api/v1/hosting全部接口 16
展开接口查看已登记参数与命令;完整协议、响应字段及权限以官方文档为准。
POST创建版本create-version/api/cloudhosting/web/v1/version/create
此接口用于创建云托管站点版本,已归档版本可作为新版本的基线版本。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
Authorization | header | 否 | string | 认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。 |
productId | header | 是 | string | 项目ID,获取方法参考查询开发者账号ID及项目ID。 |
requestid | header | 是 | string | 自定义的请求字符串,必须唯一标识此请求。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
service | header | 是 | string | API业务标识。固定值:hosting。 |
siteId | body | 是 | string | 云托管版本所在的站点ID。 可根据站点名称查询站点ID,获取方法参考查询站点信息。 |
baseVersion | body | 否 | string | 基线版本号,基于该版本创建新的版本。 仅支持版本状态为“FINALIZED”的版本作为基线版本。 |
请求体: siteId,baseVersion
查看接口定义
agc hosting create-version --pretty
本地 REST 定义地址
/api/v1/hosting/endpoints/create-version
调用预演(先填写所需参数)
agc hosting create-version --invoke --dry-run=true --body body.json查看接口参考文档 ↗
POST修改版本文件列表modify-files/api/cloudhosting/web/v1/version/modifyFilelist
此接口用于对基线版本需要删除的文件做版本修改,标记需要删除文件的绝对路径,在归档版本时处理文件。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
Authorization | header | 否 | string | 认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。 |
productId | header | 是 | string | 项目ID,获取方法参考查询开发者账号ID及项目ID。 |
requestid | header | 是 | string | 自定义的请求字符串,必须唯一标识此请求。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
service | header | 是 | string | API业务标识。固定值:hosting。 |
siteId | body | 是 | string | 云托管站点版本所在的站点ID。 可根据站点名称查询站点ID,获取方法参考查询站点信息。 |
version | body | 是 | string | 当前版本的版本号(仅支持版本状态为“CREATED”的版本)。 |
deleteFiles | body | 是 | array | 需要删除的文件列表(文件的绝对路径),一次最多删除1000个。 |
请求体: siteId,version,deleteFiles
查看接口定义
agc hosting modify-files --pretty
本地 REST 定义地址
/api/v1/hosting/endpoints/modify-files
调用预演(先填写所需参数)
agc hosting modify-files --invoke --dry-run=true --body body.json查看接口参考文档 ↗
POST获取版本压缩包上传地址upload-url/api/cloudhosting/web/v1/version/populateFiles
此接口用于获取增量版本文件压缩包或全量版本文件压缩包的上传地址等信息,并完成增量版本包上传。您可以多次获取上传地址,以最后一次获取为最终增量版本。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
Authorization | header | 否 | string | 认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。 |
productId | header | 是 | string | 项目ID,获取方法参考查询开发者账号ID及项目ID。 |
requestid | header | 是 | string | 自定义的请求字符串,必须唯一标识此请求。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
service | header | 是 | string | API业务标识。固定值:hosting。 |
siteId | body | 是 | string | 云托管版本所在的站点ID。 可根据站点名称查询站点ID,获取方法参考查询站点信息。 |
version | body | 是 | string | 当前版本的版本号(只支持“CREATED”状态版本) |
materialInfos | body | 是 | array | zip增量包参数信息。 |
请求体: siteId,version,materialInfos
查看接口定义
agc hosting upload-url --pretty
本地 REST 定义地址
/api/v1/hosting/endpoints/upload-url
调用预演(先填写所需参数)
agc hosting upload-url --invoke --dry-run=true --body body.json查看接口参考文档 ↗
PUT上传版本压缩包upload-version{uploadUrl}
通过获取上传地址的响应请求地址、请求方法、请求头信息,上传版本压缩包至云托管。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
Authorization | header | 是 | string | 校验信息,对应获取版本压缩包上传地址接口返回的headers参数中的Authorization。 |
x-amz-content-sha256 | header | 是 | string | 文件对象内容的SHA256哈希值,对应获取版本压缩包上传地址接口返回的headers参数中的x-amz-content-sha256。 |
x-amz-client-request-id | header | 是 | string | 文件上传的唯一标识,对应获取版本压缩包上传地址接口返回的headers参数中的x-amz-client-request-id。 |
x-amz-date | header | 是 | string | 文件上传地址生成的时间,对应获取版本压缩包上传地址接口返回的headers参数中的x-amz-date。 |
Host | header | 是 | string | 上传服务器地址,对应获取版本压缩包上传地址接口返回的headers参数中的Host。 |
Content-Type | header | 是 | string | 对象内容的类型,对应获取版本压缩包上传地址接口返回的headers参数中的Content-Type。 |
uploadUrl | path | 是 | string | — |
file | file | 是 | string | — |
请求体: file
查看接口定义
agc hosting upload-version --pretty
本地 REST 定义地址
/api/v1/hosting/endpoints/upload-version
调用预演(先填写所需参数)
agc hosting upload-version --invoke --dry-run=true --body body.json查看接口参考文档 ↗
POST归档版本archive-version/api/cloudhosting/web/v1/version/merge
版本包上传完成后,此接口用于对新版本进行归档。如果上传的是增量版本包,云托管对基线版本和增量版本包进行合并,归档为完整的新版本文件包。归档版本是异步操作,从开始到完成,版本的状态从“MERGING”变为“FINALIZED”。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
Authorization | header | 否 | string | 认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。 |
productId | header | 是 | string | 项目ID,获取方法参考查询开发者账号ID及项目ID。 |
requestid | header | 是 | string | 自定义的请求字符串,必须唯一标识此请求。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
service | header | 是 | string | API业务标识。固定值:hosting。 |
siteId | body | 是 | string | 云托管版本所在站点ID。 可根据站点名称查询站点ID,获取方法参考查询站点信息。 |
version | body | 是 | string | 当前版本的版本号(只支持“CREATED”状态)。 |
请求体: siteId,version
查看接口定义
agc hosting archive-version --pretty
本地 REST 定义地址
/api/v1/hosting/endpoints/archive-version
调用预演(先填写所需参数)
agc hosting archive-version --invoke --dry-run=true --body body.json查看接口参考文档 ↗
POST发布版本release-version/api/cloudhosting/web/v1/version/release
此接口用于发布新版本。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
Authorization | header | 否 | string | 认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。 |
productId | header | 是 | string | 项目ID,获取方法参考查询开发者账号ID及项目ID。 |
requestid | header | 是 | string | 自定义的请求字符串,必须唯一标识此请求。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
service | header | 是 | string | API业务标识。固定值:hosting。 |
siteId | body | 是 | string | 云托管版本所在站点ID。 可根据站点名称查询站点ID,获取方法参考查询站点信息。 |
version | body | 是 | string | 当前版本的版本号。 |
environment | body | 是 | integer | 发布环境类型。 0:生产 1:沙箱 |
请求体: siteId,version,environment
查看接口定义
agc hosting release-version --pretty
本地 REST 定义地址
/api/v1/hosting/endpoints/release-version
调用预演(先填写所需参数)
agc hosting release-version --invoke --dry-run=true --body body.json查看接口参考文档 ↗
POST查询版本列表list-versions/api/cloudhosting/web/v1/version/query
此接口用于查询云托管站点下的版本列表。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
Authorization | header | 否 | string | 认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。 |
productId | header | 是 | string | 项目ID,获取方法参考查询开发者账号ID及项目ID。 |
requestid | header | 是 | string | 自定义的请求字符串,必须唯一标识此请求。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
service | header | 是 | string | API业务标识。固定值:hosting。 |
siteId | body | 否 | string | 云托管版本所在站点ID。 |
tenantId | body | 否 | string | 租户ID,与项目ID一致。 |
version | body | 否 | string | 版本ID。 |
versionStatus | body | 否 | string | 版本状态,参考版本状态码。 |
请求体: siteId,tenantId,version,versionStatus
查看接口定义
agc hosting list-versions --pretty
本地 REST 定义地址
/api/v1/hosting/endpoints/list-versions
调用预演(先填写所需参数)
agc hosting list-versions --invoke --dry-run=true --body body.json查看接口参考文档 ↗
POST查询归档版本文件list-version-files/api/cloudhosting/web/v1/version/queryFiles
此接口用于查询已归档版本的归档文件信息,为创建和修改版本提供基线版本内容的查询。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
Authorization | header | 否 | string | 认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。 |
productId | header | 是 | string | 项目ID,获取方法参考查询开发者账号ID及项目ID。 |
requestid | header | 是 | string | 自定义的请求字符串,必须唯一标识此请求。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
service | header | 是 | string | API业务标识。固定值:hosting。 |
siteId | body | 是 | string | 云托管版本所在站点ID。 |
version | body | 是 | string | 站点版本ID。 |
pageInfo | body | 是 | object | 分页模型。 |
请求体: siteId,version,pageInfo
查看接口定义
agc hosting list-version-files --pretty
本地 REST 定义地址
/api/v1/hosting/endpoints/list-version-files
调用预演(先填写所需参数)
agc hosting list-version-files --invoke --dry-run=true --body body.json查看接口参考文档 ↗
DELETE删除版本delete-version/api/cloudhosting/web/v1/version/{versionId}
此接口用于删除站点下非“上线”状态的版本。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
Authorization | header | 否 | string | 认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。 |
productId | header | 是 | string | 项目ID,获取方法参考查询开发者账号ID及项目ID。 |
requestid | header | 是 | string | 自定义的请求字符串,必须唯一标识此请求。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
service | header | 是 | string | API业务标识。固定值:hosting。 |
versionId | path | 是 | string | 站点版本ID。 |
查看接口定义
agc hosting delete-version --pretty
本地 REST 定义地址
/api/v1/hosting/endpoints/delete-version
调用预演(先填写所需参数)
agc hosting delete-version --invoke --dry-run=true查看接口参考文档 ↗
POST创建站点环境create-environment/api/cloudhosting/web/v1/site/environment/create
此接口用于创建站点环境。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
Authorization | header | 否 | string | 认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。 |
productId | header | 是 | string | 项目ID,获取方法参考查询开发者账号ID及项目ID。 |
requestid | header | 是 | string | 自定义的请求字符串,必须唯一标识此请求。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
service | header | 是 | string | API业务标识。固定值:hosting。 |
siteId | body | 是 | string | 站点ID。 |
environmentId | body | 是 | string | 环境ID。 |
请求体: siteId,environmentId
查看接口定义
agc hosting create-environment --pretty
本地 REST 定义地址
/api/v1/hosting/endpoints/create-environment
调用预演(先填写所需参数)
agc hosting create-environment --invoke --dry-run=true --body body.json查看接口参考文档 ↗
POST查询站点环境list-environments/api/cloudhosting/web/v1/site/environment/query
此接口用于查询站点环境。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
Authorization | header | 否 | string | 认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。 |
productId | header | 是 | string | 项目ID,获取方法参考查询开发者账号ID及项目ID。 |
requestid | header | 是 | string | 自定义的请求字符串,必须唯一标识此请求。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
service | header | 是 | string | API业务标识。固定值:hosting。 |
siteId | body | 是 | string | 站点ID。 |
environmentId | body | 否 | string | 环境ID。 |
请求体: siteId,environmentId
查看接口定义
agc hosting list-environments --pretty
本地 REST 定义地址
/api/v1/hosting/endpoints/list-environments
调用预演(先填写所需参数)
agc hosting list-environments --invoke --dry-run=true --body body.json查看接口参考文档 ↗
POST删除站点环境delete-environment/api/cloudhosting/web/v1/site/environment/delete
此接口用于删除站点环境。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
Authorization | header | 否 | string | 认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。 |
productId | header | 是 | string | 项目ID,获取方法参考查询开发者账号ID及项目ID。 |
requestid | header | 是 | string | 自定义的请求字符串,必须唯一标识此请求。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
service | header | 是 | string | API业务标识。固定值:hosting。 |
siteId | body | 是 | string | 站点ID。 |
environmentId | body | 是 | string | 环境ID。 |
请求体: siteId,environmentId
查看接口定义
agc hosting delete-environment --pretty
本地 REST 定义地址
/api/v1/hosting/endpoints/delete-environment
调用预演(先填写所需参数)
agc hosting delete-environment --invoke --dry-run=true --body body.json查看接口参考文档 ↗
POST创建站点create-site/api/cloudhosting/web/v1/site/create
此接口用于创建泛域名站点。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
Authorization | header | 否 | string | 认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。 |
productId | header | 是 | string | 项目ID,获取方法参考查询开发者账号ID及项目ID。 |
requestid | header | 是 | string | 自定义的请求字符串,必须唯一标识此请求。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
service | header | 是 | string | API业务标识。固定值:hosting。 |
siteName | body | 是 | string | 站点名。 |
description | body | 否 | string | 站点描述信息。 |
请求体: siteName,description
查看接口定义
agc hosting create-site --pretty
本地 REST 定义地址
/api/v1/hosting/endpoints/create-site
调用预演(先填写所需参数)
agc hosting create-site --invoke --dry-run=true --body body.json查看接口参考文档 ↗
POST查询站点list-sites/api/cloudhosting/web/v1/site/query
此接口用于通过站点部分信息查询站点其他信息,例如通过站点名称查询站点ID。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
Authorization | header | 否 | string | 认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。 |
productId | header | 是 | string | 项目ID,获取方法参考查询开发者账号ID及项目ID。 |
requestid | header | 是 | string | 自定义的请求字符串,必须唯一标识此请求。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
service | header | 是 | string | API业务标识。固定值:hosting。 |
site | body | 是 | object | 站点信息。 |
pageInfo | body | 否 | object | 分页模型。 |
请求体: site,pageInfo
查看接口定义
agc hosting list-sites --pretty
本地 REST 定义地址
/api/v1/hosting/endpoints/list-sites
调用预演(先填写所需参数)
agc hosting list-sites --invoke --dry-run=true --body body.json查看接口参考文档 ↗
POST更新站点update-site/api/cloudhosting/web/v1/site/modify
此接口用于更新站点描述信息及控制是否开启简洁链接。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
Authorization | header | 否 | string | 认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。 |
productId | header | 是 | string | 项目ID,获取方法参考查询开发者账号ID及项目ID。 |
requestid | header | 是 | string | 自定义的请求字符串,必须唯一标识此请求。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
service | header | 是 | string | API业务标识。固定值:hosting。 |
siteId | body | 是 | string | 站点信息。 |
description | body | 否 | string | 描述信息内容,匹配中文、空格、下划线、中划线、点、英文字母及数字。 |
cleanSuffix | body | 否 | integer | 简洁链接: 0-关闭。 1-开启。 |
请求体: siteId,description,cleanSuffix
查看接口定义
agc hosting update-site --pretty
本地 REST 定义地址
/api/v1/hosting/endpoints/update-site
调用预演(先填写所需参数)
agc hosting update-site --invoke --dry-run=true --body body.json查看接口参考文档 ↗
DELETE删除站点delete-site/api/cloudhosting/web/v1/site/{siteId}
此接口用于删除站点。
开发者调用华为 API
| 参数 | 位置 | 必填 | 类型 | 说明 |
|---|---|---|---|---|
Authorization | header | 否 | string | 认证鉴权信息。 认证方式:Bearer token。 格式:“Authorization: Bearer ${access_token}”。 access_token为获取Token中获取的access_token。 |
productId | header | 是 | string | 项目ID,获取方法参考查询开发者账号ID及项目ID。 |
requestid | header | 是 | string | 自定义的请求字符串,必须唯一标识此请求。 |
client_id | header | 否 | string | 客户端ID,获取方法参考创建API客户端。 |
service | header | 是 | string | API业务标识。固定值:hosting。 |
siteId | path | 是 | string | 站点信息。 |
查看接口定义
agc hosting delete-site --pretty
本地 REST 定义地址
/api/v1/hosting/endpoints/delete-site
调用预演(先填写所需参数)
agc hosting delete-site --invoke --dry-run=true查看接口参考文档 ↗
agc-cli 是什么,适合谁使用?
agc-cli 是 Createitv 开源的华为 AppGallery Connect 命令行工具,安装后的命令名是 agc。它面向鸿蒙和华为应用开发者,将接口发现、凭据 Profile、请求预演与 API 调用组织成可复用命令,适合需要维护应用资料、测试用户、商品和报表的个人开发者与团队。
项目与使用指南: GitHub · 使用指南 · Issues
GEO · AEO · LLMO
面向 AI Agent 的可读取文档
这些公开文件提供项目事实、任务选择、安全边界、Skills 和完整接口契约。Coding Agent 可以直接读取,无需执行 JavaScript、登录或猜测页面结构。
常见问题
agc-cli 是华为官方工具吗?
不是。agc-cli 是 Createitv 维护的独立开源项目,使用 MIT 许可证。它基于华为 AppGallery Connect API 参考文档组织接口,不代表华为官方产品或官方支持服务。
如何在 macOS、Windows 和 Linux 安装 agc-cli?
已安装 Node.js 18+ 时,三个系统都可运行 npm install --global @createitv/agc-cli。macOS 也可使用 Homebrew,Windows 也可使用 Scoop。安装后运行 agc version 检查版本。
agc-cli 免费吗,需要付费账号吗?
agc-cli 使用 MIT 许可证,可免费使用和修改。调用华为 API 需要自己的 AppGallery Connect 账号、凭据和相应权限;华为平台服务的费用和限制以华为说明为准。浏览官网接口和使用 CLI 查看接口定义无需登录。
如何开始第一次应用信息查询?
先用 agc auth login --service-account-file ~/.agc/service-account.json --name production 保存凭据,再用 agc init --app-id YOUR_APP_ID --default-profile production 绑定项目。运行 agc publishing app-info-query --invoke --query appId=YOUR_APP_ID --query lang=zh-CN 预演请求,确认后增加 --dry-run=false 发送请求。接口要求 client_id 时显式补上请求头。
156 个接口是否都完成了生产验证?
156 表示注册表中的接口条目数量,分属 13 个 API 家族,不代表每个接口都已完成生产验证。注册表展示已登记参数和调用入口;完整请求、响应、权限与业务前置条件以每个接口链接的参考文档为准。
默认 dry-run 会修改我的应用吗?
不会。带 --invoke 的接口命令默认构建并预览请求,不发送远程请求。真实调用需显式设置 --dry-run=false;调用前应检查目标应用、所选凭据和参数。
可以把 agc-cli 用在脚本或 AI Agent 中吗?
可以。默认 JSON 输出适合脚本处理,agc capabilities 和 agc endpoints 提供能力发现;agc web-server 提供本地 REST 接口,agc openapi 导出接口契约。命令模板帮助导航,但不能替代业务状态检查或审核判断。
如何安装 agc-cli 的 Codex 或 Claude Agent Skills?
先安装 agc-cli,再运行 agc skills list 查看 6 个任务型 Skills。使用 agc skills install --agent codex --global 安装全部 Skills,或增加 --name agc-publishing 只安装发布 Skill。也可以从官网直接下载对应的 SKILL.md。
项目 Profile 会自动填入所有接口参数吗?
项目配置可以绑定默认凭据 Profile,临时切换时使用 --profile。应用 ID、语言、请求头和请求体等接口参数仍需按接口要求显式提供。不要将 Service Account 私钥或凭据文件提交到 Git。
按 API 家族浏览完整参考
内容更新:
快速开始
三条命令,建立可检查的项目工作区。
请将占位符替换为 AppGallery Connect 的真实值。第二条命令会让该项目自动选择对应 Profile。
保存凭据 Profile
推荐使用 Service Account。密钥会以受限权限保存在 ~/.agc/credentials.json。
$ agc auth login --service-account-file ~/.agc/service-account.json --name production绑定当前项目
保存项目资料与默认凭据 Profile;调用接口时仍按要求填写应用 ID 等参数。
$ agc init --app-id <app-id> --project-id <project-id> --package-name com.example.app --default-profile production调用前先检查
接口命令默认 dry-run。确认 method 与 URL 后,再明确执行真实请求。
$ agc publishing app-info-query --invoke --query appId=<app-id> --dry-run=false本地命令中心
浏览器看到的,就是 CLI 使用的同一份注册表。
需要实时能力数据时启动本地 REST 服务;未启动时,官网仍会作为完整参考界面工作。
agc web-server --addr :8421/api/v1/capabilities家族与下一步操作/api/v1/endpoints全部接口条目/api/v1/openapi.json机器可读契约/api/v1/:family/endpoints/:id/invoke默认 dry-run