# boltctl 0.1.6
这是 boltctl 的首个公开稳定版本，提供面向 AI Agent 的统一命令发现、结构化输出、配置与审计协议，并以 Windows、macOS 和 Linux 单文件应用交付 Magento、Ops、SEO 等核心能力。
## 新功能
- 提供 `boltctl plugins`、`<plugin> --describe` 和逐级命令反射，让 Agent 无需预先记忆完整命令树。
- 提供统一的 JSON 成功输出、错误信封、退出码、dry-run、confirm token、trace ID、幂等键和审计记录。
- 内置 Magento、Ops 和 SEO 插件，并支持项目级 `.boltctl/plugins/` drop-in 插件。
- Magento 支持 SSH credential ref、连接配置保存以及常用商品、订单和站点管理命令。
- Ops 支持 Cloudflare、R2、GCP、AWS、Proxmox 和 Magento 站点部署等运维能力。
- SEO 支持 gog Google provider；Keyword 插件提供 Keyword Planner 命令。
- 提供共享 `setting.toml` 默认配置，供多个插件复用站点、SSH 和 Provider 设置。
- 提供 Recipe 的发现、校验、dry-run、执行和跨步骤审计。
- 提供 `boltctl update`、校验下载、原子替换和回滚能力。
- 提供 Linux、macOS 和 Windows 单文件构建及统一的多平台发布流程。
- 网站更新日志由发布说明自动生成，并随正式发布更新公共 Changelog。
## 修复
- 修复 app 插件发现目录与应用根目录耦合的问题。
- 修复无授权构建的授权状态报告。
- 修复发布清单读取时全局输出参数位置错误导致跨平台条目可能丢失的问题。
- 修复多平台发布后 Changelog 未与公开下载索引同步的问题。
- 修复 Windows 构建产生的锁文件和版本变更未稳定纳入发布准备的问题。
## 行为变化
- 最终用户通过三平台单文件应用使用 boltctl，不通过 PyPI 安装。
- 内置一方插件收敛为 Magento、Ops 和 SEO；其他能力可通过项目级 drop-in 插件扩展。
- 命令发现统一使用 `boltctl plugins` 与 `<plugin> --describe`，不再提供重复的旧发现命令面。
- R2 下载资源使用 `cli/` 产品命名空间：公开索引为 `cli/latest.json`，版本产物位于 `cli/releases/0.1.6/`，更新日志为 `cli/changelog.json`。
- 正式发布分为 `--prepare` 和 `--publish` 两个阶段，发布前必须先完成版本更新、Changelog 生成、完整测试以及 Git 提交推送。
## 升级说明
- 这是首个公开版本，无需从旧的公开版本迁移。
- 下载适合当前平台的单文件应用并加入 `PATH` 后，可运行 `boltctl plugins` 查看可用能力。
- 后续版本可直接运行 `boltctl update`；旧测试版本仍可通过兼容清单发现新版。
- 自定义插件应放入项目 `.boltctl/plugins/`，其依赖安装到插件自己的 `.deps/`。
## 已知问题
- macOS 与 Windows 的自更新和回滚流程仍需在更多真实环境持续回归。
- 多台构建主机并发更新 `cli/latest.json` 时尚未使用 ETag 条件写。
← 返回 CLI 更新日志 下载此版本
稳定版本