用途:通过 xAPI CLI(xapi-to 为同一可执行文件)在 xAPI 托管的 Cloudflare Workers for Platforms 上部署、运维和验证应用,适用于 Workers 项目及预览/生产环境。使用前先运行 xapi workers --help 确认版本;若已安装版本缺少这些命令,应停止并报告版本不匹配,不要改用 Wrangler 直接部署。Wrangler deploy --dry-run --outfile 仅可作为本地框架打包步骤,产物仍须经 xAPI 发布。
主要能力:识别控制面主机、Worker ID 与预览/生产环境;认证优先级为 XAPI_KEY、XAPI_API_KEY、~/.xapi/config.json,密钥需 workers:read 及变更时的 workers:write。生产 API 主机为 api.xapi.to,测试用 XAPI_API_HOST=api.test.xapi.to。支持 workers inspect、capabilities、plan、push、promote、rollback、pull、d1 migrations plan/apply、billing usage 等。
使用方式:已链接项目先执行 workers inspect [worker-id] --env <environment> 与 workers capabilities;新项目用 capabilities 和 plan。D1 迁移须显式执行 workers d1 migrations plan 与 apply,普通发布不读取或执行 D1 SQL。导出 D1/R2 数据需 workers:data:read 权限。
限制:Worker 代码保持全局,defaultResourceLocation 与 placementMode 不迁移已有数据。部署在 CLI 运行处构建并上传不可变产物。生命周期操作退出码 0 或 ACCEPTED 仅表示收到回执,不代表完成。计费观测总量不是发票。缺失事实暂未提供。