用途:初始化、部署、配置并分享 Bounded 应用。策略编写属于 bounded-backend,客户端代码与应用用户认证属于 bounded-frontend。
默认流程(新项目或常规发布,参见 docs/quickstart.md):
bounded init bounded deploy --create --name my-app
bounded init 会复用已保存的网页会话或打开托管浏览器登录;它写入公开的 bounded.json(含 "sourcePush": true,使部署同步项目源码)和 policy.json,凭据不得放入这两个文件。
主要能力与文档路由:首次设置、常规部署、发布站点、单项目多 app ID 见 docs/quickstart.md;账户登录、会话刷新、无头 OTP、账户切换见 docs/accounts.md;托管网页前端、预览、私有/公开访问见 frontend-hosting.md;多环境策略见 docs/environments.md;提示驱动构建见 docs/cli-reference.md;源码同步见 docs/source-sync.md;移植既有应用见 docs/porting-an-existing-app.md;第三方 API 发现与申请用 bounded services search/describe/request/status;oApp 上线前检查用 bounded oapp preflight;自定义域名与短链见 docs/domains.md;分享与访问问题见 docs/access-playbook.md;删除应用用 apps delete(需浏览器确认,仅所有者);本地签名密钥、CI key 认证等高级内容见 docs/key-and-account-safety.md,正常入门时不加载。
故障处理:deploy_in_progress 等仅在存在 recoveryCommand 时按原样重跑该命令并让 CLI 轮询;无 recoveryCommand 的错误视为终止。onchain_creation_pending 等(409)应重跑同一 bounded deploy,绝不重跑 --create 或新建应用;onchain_creation_owner_conflict 需升级人工审查。不确定时先运行只读的 bounded deploy status --json(含 freshDeploySafe 判定);部署前可用 bounded deploy preflight --json 查看信用余额与是否可能被接纳。402 deploy_credit_insufficient 用 bounded billing status 与 bounded billing topup --credits <n>。域名待激活可重跑 bounded domains list --app-id <id> --env <environment> --json。403 或 401/403 先用 bounded whoami 与 bounded access --app-id <id>。429 project_daily_limit_exceeded 表示免费账户 24 小时创建上限 20 个应用,删除不释放额度。
发布规则:先读 bounded.json;其指向的 policy.json 才是部署内容;生成脚本需与已提交文件 diff;不符预期则更新或删除脚本,不得部署其输出。bounded deploy 会校验并编译策略,无效即拒绝。发布关键部署后用 bounded apps inspect --app-id <id> --json 确认生效策略与运行时发布;托管 URL 以站点回执或域名列表为准,不得臆造主机名。用 bounded share <email-or-wallet> --role admin|developer|viewer|billing 分享控制面访问。切勿提交凭据、网页会话、刷新令牌或供应商密钥。
限制:以上为资料中明确的行为与命令;未提供的功能、收费细节、平台支持范围暂未提供。