byted-acep-api

火山云手机 Skill

当用户要求查看或操作已配置测试业务下的火山云手机资源时，使用这个 skill。

运行约束

• 不要静态配置 DC。应根据用户请求或当前资源可用性选择 DC。
• 先通过 list-products 查业务 ID，再在每条命令里显式传入 product_id。
• 创建和订购资源时必须显式选择业务资源类型：云盘存储使用 100，本地存储使用 200。
• 更新实例镜像或规格时，优先先关机；涉及强制更新时，提醒用户确认可能带来的影响。
• 后付费实例资源组只支持复购。在订购后付费资源前，先确认该业务已经在火山云手机控制台下过单，并且能查到 OrderId。
• 截图优先使用直连方式 get-presigned-edge-url --api-type TakeScreenshot。
• batch-screen-shot 作为回退方式使用；当业务已配置截图存储且用户明确需要该链路时再用。
• 除非用户明确要求，否则不要输出签名 URL。
• 查询已安装应用时优先使用 get-pod-app-list；仅在确有需要时才回退到 Android pm list packages。
• 除非用户明确要求，否则不要输出 access key、secret key、Authorization header 或完整签名 URL。
• 创建、删除、开关机、重启、重置、安装/卸载、文件传输、应用启动/关闭，以及 Android 命令执行都属于有状态变更操作。除非用户明确要求执行该操作，否则先确认。

命令入口

以下示例默认在当前 skill 包目录下执行：

python3 scripts/vephone_cli.py <command> [args]

这个 skill 已内置 scripts/vephone_cli.py 和 scripts/core/，可以直接运行，不依赖仓库根目录下的实现。

命令以显式 flags 的形式暴露常用参数。除 list-products 等少数查询命令外，大多数业务命令都把 product_id 作为第一个位置参数；查看某个命令支持哪些过滤条件时，直接用 python3 scripts/vephone_cli.py <command> -h。如果认证配置不在默认位置，可以用 --config /path/to/config.json 指定配置文件路径；这个全局参数放在子命令前后都可以。

如果现有命令还没有覆盖到目标 OpenAPI Action，可以使用通用命令：

python3 scripts/vephone_cli.py action-call ListOperableProduct --json-body --param Count=10 --param CloudphoneProductType=5
python3 scripts/vephone_cli.py action-call GetProductResource --product-id <product_id>
python3 scripts/vephone_cli.py action-call SetProxy --json-body --params-json '{"ProductId":"<product_id>","PodIdList":["pod-1"],"ProxyStatus":1,"ProxyConfig":{"version":"v2","type":"socks5","address":"203.0.113.52","port":"12345"}}'

action-call 的 --param 使用 Key=Value 形式，Value 会优先按 JSON 解析，失败时按字符串处理，所以可以直接传 true、123、[1,2]、{"k":"v"}。注意在常见 shell 中如果不对 Key=Value 做引用/转义，形如 --param Foo={"k":"v"} 的双引号可能会被 shell 吞掉，导致程序实际收到 Foo={k:v} 并触发 JSON 解析失败；当 Value 含双引号、空格或复杂 JSON 时，请用单引号包裹整个 Key=Value（如 --param 'Foo={"k":"v"}' / --param 'PodIdList=["pod-1"]'），或优先使用 --params-json（如 --params-json '{"Foo":{"k":"v"}}'）。若希望强制按字符串传入 true/123 等，请使用 JSON 字符串形式：--param Name='"123"'。需要批量传参时用 --params-json；如果同时传了同名键，--param 会覆盖 --params-json。默认按 query string 调用，带 --json-body 时改为 JSON body。