运行时发现
先列出当前插件，再用 --describe 逐级读取真实命令和参数，不要求 Agent 预先背完整文档。
boltctl plugins
boltctl ops net tls --describe Agent-first CLI · 当前稳定版 0.1.6
让 AI Agent
可靠地调用真实系统。
boltctl 把复杂服务收敛成一个可发现、可预演、可确认、可审计的命令入口。 人不必记住完整命令树，Agent 会在运行时读取能力，再按协议安全执行。
Linux / macOS / Windows 单文件二进制 3 个内置插件
# 先读取当前运行时真正可用的插件
$ boltctl plugins
magento
21 areas
ops
20 areas
seo
19 areas
# 再反射目标命令的真实参数
$ boltctl ops net tls --describe
"command": "boltctl ops net tls"
"argument": "target"
"flags": ["--days", "--servername", "--timeout"]
Agent 已获得准确命令，不需要猜参数
Agent-first 协议
命令会执行，Agent 还要知道下一步
boltctl 不只是把 API 包成命令。它为发现、预演、确认、失败恢复和审计建立统一约定，让不同 Agent 都能稳定理解结果。
结构化输入与输出
成功结果输出单份 JSON；失败进入统一错误信封，并配合 0–10 的标准退出码告诉 Agent 下一步。
stdout → result JSON
stderr → error envelope写操作先预演
所有写命令支持 dry-run。高风险动作先签发确认令牌，只有再次明确确认才真正执行。
--dry-run
--confirm-token <token>幂等与全链路审计
写操作可带幂等键防止重复提交，并用 trace ID 串起多步任务和哈希链审计记录。
--idempotency-key <uuid>
--trace-id <uuid>配置与凭证引用
共享站点事实、插件 Profile 和本地凭证引用彼此分离，敏感值无需写进命令或配置正文。
boltctl profile validate ops
boltctl ops doctorRecipe 多步流程
把高频步骤保存为项目或用户 Recipe，先校验、再 dry-run，执行时自动共享 trace ID。
boltctl recipe validate <name>
boltctl recipe run <name> --dry-run内置能力已收敛
二进制只带 3 个一方插件
默认安装保持边界清晰：Magento、Ops、SEO 随单文件二进制交付并受统一授权控制。其他业务能力不再打包进核心。
运行时验证结果
`boltctl plugins` 返回 plugin_count = 3，且 failures 为空。
01
Magento
电商后台与站点管理
通过 REST API 和远程 bin/magento 管理商品、分类、CMS 页面、促销、订单、翻译，以及缓存、索引、Cron、维护和部署。
商品与分类订单与促销CMS 与翻译缓存、索引与部署
boltctl magento product list --sku-contains "camera" 查看插件详情 02
Ops
多云基础设施与站点运维
覆盖网络、SSH、日志、证书、通知、备份、部署与站点生命周期，并连接 Cloudflare、GCP、AWS 和 Proxmox。
网络与 TLSSSH、日志与同步云资源与防火墙备份、部署与调度
boltctl ops net tls example.com --days 30 查看插件详情 03
SEO
技术 SEO、内容与 AI 搜索
审计页面技术信号、内容、图片、Hreflang、Schema.org、站点地图与 GEO，并可接入 Google、DataForSEO 和 Firecrawl。
页面与站点审计Schema 与 Sitemap内容、图片与 GEOGoogle 与第三方数据
boltctl seo page audit https://example.com 查看插件详情 按项目扩展
其他能力按需放进项目，
不继续膨胀核心二进制
自定义或社区插件放在项目的 `.boltctl/plugins/`。boltctl 会从当前目录向上寻找最近的项目插件，只解析索引；真正调用哪个插件时才导入哪个。
# 项目级 drop-in
<project>/.boltctl/plugins/<name>/
# 发现与反射
boltctl plugins
boltctl <name> --describe
已从内置降级、可按需扩展的方向
Ads
project drop-in
Brand
project drop-in
Catalog
project drop-in
Content
project drop-in
Keyword
project drop-in
Social
project drop-in
WordPress
project drop-in
Odoo
project drop-in
Shopify
project drop-in
项目插件不等于“全部预装”
它们不会随普通授权版二进制分发，也不会自动联网安装依赖。团队可以把需要的插件和项目一起版本管理。