zeroshot

让 AI 改完代码后，有独立验证官把关，减少翻车。

zeroshot 是一个面向软件变更的独立执行器-验证器编排框架，用 JavaScript 实现。它解决的是 AI 编程代理在自动修改代码时缺乏可靠验证、容易引入错误的问题。核心能力是将变更过程拆分为执行（executor）和验证（verifier）两个独立角色，通过编排循环让 AI 代理（如 Claude、Codex）在生成修改后，由验证器独立检查结果，确保变更正确性。项目提供 CLI 工具，支持 agent 循环和自主代理工作流，帮助开发者在自动化代码修改中建立质量关卡，减少人工审查负担。其设计强调模块化和可扩展性，适合集成到现有 CI/CD 或开发工具链中。

开源 unknown 编程开发

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1876

维护状态活跃

是否开源是

定价模式 unknown

项目数据

分类编程开发

开发团队the-open-engine

所属国家

官网地址https://the-open-engine.github.io/zeroshot

GitHubhttps://github.com/the-open-engine/zeroshot

定价模式unknown

价格说明官网存在但未明确展示定价信息，需进一步确认。

访问状态

是否开源是

开源协议MIT

主要语言Rust

技术栈/模型agent-loops,agent-orchestration,agentic-workflow,ai-agent,ai-agents,autonomous-agents,claude,cli,codex,coding-assistant,developer-tools,gemini,loop-engineering,meta-harness,multi-agent,vibecoding

GitHub 星标★ 1876

30天Star增速

HF 下载量

上线时间2025-12-25 00:00:00

最近更新2026-09-23 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：命令行工具 4 步

环境要求

Node.js 与 npm 环境（用于全局安装 CLI）
支持平台：Linux x64/arm64、macOS x64/arm64、Windows x64
自托管方案需要 Docker 环境

安装与启动步骤

1安装 zeroshot CLI

通过 npm 全局安装官方包，会自动安装经过验证的原生二进制，无需自行编译。
```
npm install -g @the-open-engine-company/zeroshot
```
2确认版本

执行 version 子命令，能正常输出版本号即说明二进制已就绪。
```
zeroshot version
```

3启动自托管 target

用官方镜像在后台启动 target 容器，端口仅绑定本机 127.0.0.1，并挂载数据卷保存状态。

docker run --rm --detach --name zeroshot-target 
  -p 127.0.0.1:8080:8080 
  -v zeroshot-data:/var/lib/zeroshot 
  ghcr.io/the-open-engine/zeroshot-target:latest

4注册本地 target

把刚启动的容器注册为名为 local 的 target，--direct 表示直连本地地址。
```
zeroshot target add local --url http://127.0.0.1:8080 --direct
```

关键配置

配置项	必填	说明	示例
`--url`	是	target 服务地址，指向自托管容器的监听地址	`http://127.0.0.1:8080`
`-p`	是	端口映射，默认只绑定本机回环地址	`127.0.0.1:8080:8080`
`-v`	否	数据卷，用于保存持久化状态	`zeroshot-data:/var/lib/zeroshot`

如何确认成功

运行 zeroshot version 能输出版本号；target 添加成功后可确认 local target 已连上 http://127.0.0.1:8080。

常见问题

Q：npm 安装会编译源码吗？

A：不会。npm 包直接安装经过验证的原生二进制，覆盖 Linux x64/arm64、macOS x64/arm64 和 Windows x64；原生归档与校验和也随 vX.Y.Z Release 发布。

Q：可以和旧版 Node.js 运行时混用吗？

A：不可以。README 明确说明 Zeroshot v8 是硬接口切换，旧的 Node.js 运行时已退役，请改用原生 zeroshot 可执行文件。

Q：容器里的状态会丢吗？

A：不会，只要保留 -v zeroshot-data:/var/lib/zeroshot 数据卷即可持久保存；但 --rm 会让容器删除后不易复用，需要长期运行可去掉该参数。

Q：想做网络隔离或 HTTPS 怎么办？

A：README 指向 docker/zeroshot-target/README.md 的 target 镜像指南，其中覆盖持久存储、网络隔离、镜像构建和 HTTPS 配置。

注意事项

Docker target 镜像已内置原生引擎，以及固定版本的 Codex 与 Claude harness CLI。
端口默认只绑定 127.0.0.1，仅本机可访问，需外部访问时再自行调整。
仅在自托管场景才需要执行 Docker 相关步骤，单纯使用 CLI 时只需 npm 全局安装两步。

核心亮点

执行与验证分离，能有效拦截 AI 生成代码中的错误，提升变更可靠性
基于 JavaScript，生态丰富，易于集成到现有 Node.js 工具链
支持多种 AI 代理（Claude、Codex），灵活适配不同编程场景

不足之处

项目较新，文档和社区支持尚待完善
依赖外部 AI 服务，可能增加使用成本和延迟

适用场景

在 CI/CD 流程中自动验证 AI 生成的代码变更
辅助开发者审查 AI 编程助手的大规模重构
构建自主代理时，确保多步骤修改的最终结果正确

替代项目

Aider、OpenHands、AutoGPT

项目介绍

zeroshot 是智能体领域的开源项目，由 the-open-engine 开发，2025 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（1,876）位列前 30%，在智能体分类中处于中上游。

近 42 天，它的 GitHub 星标从 1,700 增加到 1,876，净增 176。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-23。官网存在但未明确展示定价信息，需进一步确认。从国内网络环境看，可直接访问。

它主要面向的使用场景是：在CI/CD流程中自动验证AI生成的代码变更。同类可对比的替代方案包括 Aider、OpenHands、AutoGPT。

上一篇：portable-hermes-agent

下一篇：agor