Wizard 用于生成交互式 Bash 向导,逐步引导人类完成只有本人才能执行的手动流程,适合配置基础设施、设置凭证或 CI 等手工繁琐、每次向 AI 重复解释也繁琐的场景。
主要能力:官方说明将其描述为一个 Bash 脚本,会打开每个 URL,明确说明点击和复制什么,捕获取值,写入应在的位置(.env、GitHub secrets),每个阶段确认,并显示剩余阶段数。底层基于 template.sh,已解决分阶段进度、确认关卡、跨平台打开 URL(含 WSL)、隐藏密钥输入、幂等 .env upsert、gh secret/gh variable 写入和结尾摘要。使用方只需界定流程并编写各阶段。
使用方式(据资料整理):先界定流程,读取仓库中的 .env、README、docker-compose、框架配置和 .github/workflows 等,列出每个阶段及其产出值并向用户确认;再为每个阶段写出具体操作路径,不清楚的 UI 或命令应询问,不要凭空编造;然后复制 template.sh 到目标路径,按依赖顺序为每步编写一个阶段,使用库辅助函数 stage、say/step、open_url、ask/ask_secret、write_env、set_secret/set_var、pause/confirm,并设置 TOTAL_STAGES;最后用 bash -n 检查,可用时运行 shellcheck,chmod +x,不要自己端到端运行(会打开浏览器并阻塞于人工输入),改为静态检查。
限制与其他事实:向导默认是临时的,为一次运行而建,除非用户希望可重复的仓库内安装路径,否则完成后删除;marker 以上的库在各向导中相同,不应手动编辑。更多实现细节以资料为准,未提供的收费、价格、平台信息暂未提供。