zeroshot

环境要求

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

安装与启动步骤

1. 1安装 zeroshot CLI

   通过 npm 全局安装官方包，会自动安装经过验证的原生二进制，无需自行编译。

   npm install -g @the-open-engine-company/zeroshot

   复制

2. 2确认版本

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

   zeroshot version

   复制

3. 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. 4注册本地 target

   把刚启动的容器注册为名为 local 的 target，--direct 表示直连本地地址。

   zeroshot target add local --url http://127.0.0.1:8080 --direct

   复制

关键配置

如何确认成功

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

常见问题

注意事项

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