从安装到部署：Zeroshot CLI工具完整使用教程

从安装到部署Zeroshot CLI工具完整使用教程【免费下载链接】zeroshotYour autonomous engineering team in a CLI. The agent loop produces senior-level code that you can actually trust in prod because of non-negotiable feedback from independent reviewers. Supports Claude Code, OpenAI Codex, OpenCode, and Gemini CLI with trivial setup.项目地址: https://gitcode.com/gh_mirrors/ze/zeroshot你是否曾经希望拥有一个自动化工程团队能够编写出经过独立验证的生产级代码Zeroshot正是这样一个革命性的多智能体协调引擎它通过执行器-验证器循环机制让AI编码智能体写出你真正可以信任的代码。本教程将带你从零开始全面掌握这款强大的命令行工具。什么是ZeroshotZeroshot是一个开源的多智能体编排引擎专为自主软件工程而设计。它的核心创新在于执行器-验证器分离一个智能体负责编写代码另一个完全独立的验证器负责检查代码质量而验证器从未见过代码是如何编写的。这种机制确保了代码质量的可信度因为验证器无法批准自己的推理过程。核心工作原理Zeroshot的工作流程遵循一个严谨的循环任务接收→ 从GitHub Issue、Markdown文件或直接文本描述接收任务智能体分类→ 根据任务复杂度和类型选择合适的执行器代码实现→ 在隔离的工作空间中编写代码独立验证→ 验证器检查代码质量并给出反馈循环迭代→ 直到代码通过验证或明确无法完成快速安装指南 系统要求Node.js ≥ 18 版本至少一个支持的AI编码智能体CLI支持Linux和macOS系统安装步骤首先安装Zeroshot CLI工具npm install -g the-open-engine/zeroshot然后安装至少一个AI编码智能体CLI# Claude Code (推荐) npm install -g anthropic-ai/claude-code # 或 OpenAI Codex npm install -g openai/codex # 或 Google Gemini CLI npm install -g google/gemini-cli # 或 OpenCode # 参考 opencode.ai 安装说明验证安装安装完成后运行以下命令验证安装是否成功zeroshot --version zeroshot providers你应该能看到Zeroshot的版本信息和已安装的提供程序列表。基础使用教程 启动你的第一个任务Zeroshot支持多种任务输入方式# 处理GitHub Issue zeroshot run 123 # 处理Markdown规范文件 zeroshot run feature.md # 直接输入任务描述 zeroshot run 为API添加限流功能滑动窗口算法按IP限制返回429状态码实时监控任务进度任务启动后你可以使用以下命令监控执行状态# 查看所有正在运行的任务 zeroshot list # 查看特定任务的详细状态 zeroshot status 任务ID # 实时查看任务日志 zeroshot logs 任务ID -f # 导出完整对话记录 zeroshot export 任务ID任务管理命令Zeroshot提供了完整的任务管理功能# 优雅停止任务 zeroshot stop 任务ID # 强制终止任务 zeroshot kill 任务ID # 恢复已停止的任务 zeroshot resume 任务ID [可选提示]高级配置与优化 ⚙️提供程序配置Zeroshot支持多种AI编码智能体你可以灵活配置# 查看所有可用的提供程序 zeroshot providers # 设置默认提供程序 zeroshot providers set-default codex # 为特定任务指定提供程序 zeroshot run 123 --provider gemini # 配置提供程序设置 zeroshot providers setup claude模型级别配置Zeroshot使用提供程序无关的模型级别系统level1: 最经济/最快速level2: 默认级别level3: 能力最强你可以在设置文件中配置级别映射{ providerSettings: { codex: { minLevel: level1, maxLevel: level3, defaultLevel: level2, levelOverrides: { level1: { model: codex-model-main, reasoningEffort: low }, level3: { model: codex-model-main, reasoningEffort: xhigh } } } } }隔离模式详解 工作树隔离模式工作树模式提供轻量级的Git分支隔离适用于PR工作流zeroshot run 123 --worktree特点创建独立的Git工作树与原仓库完全隔离设置时间小于1秒适合快速隔离开发Docker容器隔离模式Docker模式提供完全隔离的容器环境适合高风险实验和并行运行zeroshot run 123 --dockerDocker凭证挂载配置Zeroshot会自动挂载必要的凭证目录默认包括gh、git和ssh# 配置Docker挂载 zeroshot settings set dockerMounts [gh,git,ssh,aws] # 自定义挂载 zeroshot run 123 --docker --mount ~/.aws:/root/.aws:ro # 禁用所有挂载 zeroshot run 123 --docker --no-mountsPR和自动合并模式Zeroshot支持完整的PR工作流# 创建工作树并打开PR zeroshot run 123 --pr # 指定PR基础分支 zeroshot run 123 --pr --pr-base dev # 自动合并模式工作树PR自动合并 zeroshot run 123 --ship项目集成最佳实践 ️与现有开发流程集成Zeroshot可以无缝集成到你的现有开发工作流中Issue驱动开发直接从GitHub Issue开始任务代码审查集成通过PR模式自动创建代码审查CI/CD流水线将Zeroshot任务作为CI/CD的一部分任务范围管理Zeroshot最适合具有明确验收标准的任务任务类型适合程度原因添加速率限制功能✅ 非常适合需求明确验收标准清晰重构JWT认证✅ 非常适合有明确的最终状态定义修复登录Bug✅ 非常适合成功标准可衡量让应用更快❌ 不适合需要先探索和定义指标改进代码库❌ 不适合缺乏明确的验收标准环境变量配置通过环境变量可以灵活控制Zeroshot行为# 设置默认提供程序 export ZEROSHOT_PROVIDERcodex # 配置SQLite日志模式适用于网络文件系统 export ZEROSHOT_SQLITE_JOURNAL_MODEDELETE # 设置忙碌超时时间 export ZEROSHOT_SQLITE_BUSY_TIMEOUT_MS5000故障排除与调试 常见问题解决问题1任务卡住或响应缓慢# 检查任务状态 zeroshot status 任务ID # 查看详细日志 zeroshot logs 任务ID -f # 如果需要强制终止任务 zeroshot kill 任务ID问题2提供程序连接失败# 验证提供程序安装 zeroshot providers # 重新配置提供程序 zeroshot providers setup 提供程序名称问题3Docker容器启动失败# 检查Docker服务状态 docker ps # 验证凭证挂载配置 zeroshot settings get dockerMounts日志分析与调试Zeroshot的所有操作都记录在SQLite数据库中# 查看集群数据库位置 ls ~/.zeroshot/*.db # 使用SQLite工具分析日志 sqlite3 ~/.zeroshot/集群ID.db SELECT * FROM messages LIMIT 10;高级功能探索 命令证明系统Zeroshot的命令证明功能允许你在不同智能体之间复用昂贵的精确命令# 创建命令证明 zeroshot cmdproof check 任务ID质量门控机制在--pr和--ship模式下Zeroshot实施严格的质量门控自动测试验证所有更改必须通过现有测试代码规范检查符合项目编码标准功能完整性验证满足所有需求规格持久化与恢复Zeroshot的状态持久化到SQLite数据库确保任务在系统重启后可以继续# 查看所有可恢复的任务 zeroshot list --json | jq .[] | select(.status stopped) # 恢复特定任务 zeroshot resume 任务ID性能优化技巧 ⚡资源管理建议并发任务限制避免同时运行过多任务工作空间清理定期清理完成的集群日志轮转管理SQLite数据库大小网络优化配置对于使用网络文件系统如NFS、EFS的环境# 优化SQLite性能 export ZEROSHOT_SQLITE_JOURNAL_MODETRUNCATE export ZEROSHOT_SQLITE_WAL_AUTOCHECKPOINT_PAGES1000内存使用优化# 监控内存使用 ps aux | grep zeroshot # 清理旧集群数据 rm -rf ~/.zeroshot/*.db安全最佳实践 凭证管理Zeroshot不存储任何API密钥所有认证都通过底层CLI处理最小权限原则只为必要操作提供凭证环境变量加密敏感信息使用环境变量传递定期轮换密钥定期更新AI提供程序API密钥代码安全审查虽然Zeroshot提供验证机制但仍建议人工代码审查重要变更仍需人工检查安全扫描集成集成静态代码分析工具权限最小化在隔离环境中运行高风险任务实际应用案例 案例1API限流功能实现zeroshot run 为用户服务添加乐观锁和自动重试机制更新用户时 使用指数退避算法最多重试3次合并非冲突字段更改 并提供详细的冲突信息。处理ABA问题版本A-B-A。案例2数据库迁移脚本zeroshot run 创建数据库迁移脚本添加用户活动日志表 包含用户ID、活动类型、时间戳、IP地址字段 建立适当的索引并更新数据访问层。案例3性能优化任务zeroshot run 优化产品列表API响应时间分析现有查询 添加合适的数据库索引实现缓存层 确保响应时间从500ms降低到100ms以下。总结与展望 Zeroshot代表了自主软件工程的新范式。通过将代码编写与代码验证分离它解决了传统AI编码工具最大的信任问题。无论你是个人开发者还是团队负责人Zeroshot都能显著提高代码质量和开发效率。关键优势总结可信验证独立的验证器确保代码质量灵活隔离多种隔离模式适应不同场景无缝集成与现有开发工具链完美结合持久可靠状态持久化任务可恢复多智能体支持兼容主流AI编码工具随着AI技术的不断发展Zeroshot这样的工具将成为软件开发流程中不可或缺的一部分。开始使用Zeroshot体验自主软件工程的未来记住编写代码的智能体不应该也是判断代码是否正确的智能体。让Zeroshot为你提供真正可信的生产级代码【免费下载链接】zeroshotYour autonomous engineering team in a CLI. The agent loop produces senior-level code that you can actually trust in prod because of non-negotiable feedback from independent reviewers. Supports Claude Code, OpenAI Codex, OpenCode, and Gemini CLI with trivial setup.项目地址: https://gitcode.com/gh_mirrors/ze/zeroshot创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考