# boltctl 0.1.7
此版本重点完善从环境预检、一站一 Profile、基础设施部署到 Magento 前台验收的一键建站流程，同时加固站点生命周期、确认令牌和资源销毁安全；License 现在只服务于可选 AI 能力，不再影响插件发现和普通命令执行。
## 新功能
- 新增由 Agent 直接编排的一键建站流程，覆盖域名准备、GCP/Cloudflare/SSH 阻断式预检、站点初始化、bootstrap、深度验收和审计核对。
- 新增站点级 Ops Profile：`site init --create-profile` 会创建同名共享 site profile 与 Ops profile，后续命令可按站点隔离配置。
- 新增 `ops site preflight`，集中检查 GCP service-account、项目与区域、VPC/subnet、防火墙、配额、Cloudflare zone，以及本地 SSH/SCP 环境。
- 新增 boltctl 专用 Ed25519 SSH 身份 `~/.ssh/id_boltctl_cli`，并提供安全的密钥检查与生成流程。
- Magento 建站新增 `app_connected` 收尾阶段与独立的 `site connect` 重试入口，可创建并验证 Integration、保存本地 credential ref，并清理 Cloudflare 缓存。
- 新增 `ops site verify` 深度交付验收，检查生命周期、DNS/HTTPS、容量、容器、Magento REST/GraphQL、索引、cron、默认图片和首页内容区块。
- 新增 `magento readiness`，独立报告商店信息、邮件、税务、支付、配送等开店准备状态。
- Magento 商品命令新增关联商品管理能力，并完善商品发布工作流与 Agent 操作指引。
- Site JSON 升级为 schema v2，新增 VM、SSH Profile 和 DNS 记录的资源所有权账本，以及带原始文件备份的 `ops site migrate` 显式迁移命令。
## 修复
- 修复只读命令可能创建配置、缓存、状态或审计目录的问题，并增加 Windows 只读行为回归测试。
- 修复 Windows 错误依赖本地 rsync 的问题；Windows 部署只要求系统 OpenSSH Client 提供的 `ssh.exe` 和 `scp.exe`。
- 修复 confirm token 未绑定完整业务参数、可重复消费的问题；同时修复 Windows 文本模式写入令牌密钥可能改变随机字节的问题。
- 修复站点名、域名、证书策略和持久化路径校验不足，以及站点状态非原子写入和并发修改冲突的问题。
- 修复站点销毁可能按名称误删既有 VM、SSH Profile 或 DNS 记录，以及部分回滚失败仍返回成功的问题。
- 修复修改站点 compute、network、domain 或 deploy 配置后，下游生命周期状态未自动失效的问题。
- 修复 Cloudflare strict SSL 设置失败可能被忽略、DNS 多记录歧义未阻断，以及 verify 未覆盖 alias 域名和缓存响应头的问题。
- 修复已安装 Magento 重跑部署时未完整执行应用部署与 PWA 重建的问题，并完善默认 Logo、Hero、Trust Badges、Tech Highlight 和 Testimonials 的交付内容与验收。
- 修复模板归档不可复现、切换发布版本时残留旧构建产物，以及 Changelog 验证请求识别不完整的问题。
- 修复结构化协议输出在部分 Windows 终端不能稳定使用 UTF-8 的问题。
## 行为变化
- License 不再参与插件发现、加载或执行；普通 Magento、Ops、SEO 及 drop-in 插件命令在未激活、已激活或授权过期时行为一致。License 激活仅用于获取可选托管 AI 凭证，并改为账号级状态。
- 三平台构建不再区分 license/no-license 二进制，默认产物即可运行全部非 AI 命令。
- L2/L3 confirm token 现在与 action、profile 和业务输入绑定且只能消费一次；修改参数、重复执行或复用旧 token 都必须重新 dry-run。
- 旧 Site schema v1 不会由普通写命令静默升级；必须显式运行 `ops site migrate`，迁移前会逐字节备份原 JSON。
- v1 中无法证明归属的 VM、SSH 和 DNS 资源在迁移后标记为 unknown，`site destroy` 会保留它们而不是推测所有权。
- `site set` 不再允许直接编辑 lifecycle state；修改配置会让对应步骤及其下游自动失效。
- 存在共享 site、Ops/Magento Profile 或 credential 关联时，`site rename` 会拒绝直接重命名，避免制造跨插件断链。
- `site init` 和 `site adopt` 不再静默选择 provider 或 mode；一键建站 Agent 仅在两者都未配置时显式采用 GCP/Magento fallback。
- `site bootstrap`、`connect` 和 `destroy --apply` 的 dry-run 遇到阻断计划时不再签发不可执行的 confirm token。
## 升级说明
- 运行 `boltctl update` 更新到 0.1.7；升级后用 `boltctl version` 确认版本。
- 以前使用过 `ops site` 的用户应逐个运行 `boltctl ops site doctor <site>`。若报告 schema v1，先执行 `boltctl ops --dry-run site migrate <site>`，确认后再执行 `boltctl ops --reason "升级站点状态格式" site migrate <site>`，最后重跑 doctor。
- 迁移备份位于 `~/.boltctl/config/ops/sites/backups/`；未知所有权资源不会被自动接管或删除，需要人工核验后再决定后续处理。
- 升级前生成但尚未使用的 confirm token 应丢弃，并使用完全相同的业务参数重新执行 dry-run 获取新 token。
- 新建站点前先运行 `ops site preflight`。Windows 用户应确认 PATH 中存在 `ssh.exe` 和 `scp.exe`；专用 SSH 公私钥只存在一半、损坏或不匹配时，命令会停止且不会覆盖文件。
## 已知问题
- `ops site preflight` 当前对 GCP + Cloudflare 提供完整阻断式检查，AWS 与 Proxmox 的同等深度预检尚未补齐。
- macOS 与 Windows 的自更新和回滚仍需在更多真实终端环境持续回归。
- 多台构建主机并发发布时，公共 release manifest 仍未使用 ETag 条件写入。
← 返回 CLI 更新日志 下载此版本
稳定版本