一个独属于你的终端编码智能体。

English | 中文

Zero 是一个用于本地终端的 AI 编码智能体。它可以检查仓库、编辑文件、运行命令、使用浏览器/终端辅助工具，并在你选择模型和权限级别的同时保持持久的本地会话。 ```bash zero zero exec "修复 ./pkg 中失败的测试" zero exec --output-format stream-json < turns.jsonl ``` ## 合作伙伴


Twigpine	Xiaomi MiMo	Novita AI	Concentrate	Exa

GMI Cloud	Vercel

## 为什么选择 Zero - **使用你想要的模型。** 支持 OpenAI、Anthropic、Gemini、Groq、OpenRouter、DeepSeek、Mistral、xAI、Qwen、Kimi、GitHub Models、Ollama、LM Studio、Atomic Chat，或任何 OpenAI/Anthropic 兼容端点。 - **保持控制权。** 文件写入、Shell 命令、网络访问和工作区外写入都经过 Zero 的权限和沙箱策略。 - **在终端中工作。** TUI 具有模型/提供商选择器、图片输入、斜杠命令、实时计划/工具渲染、回滚滚动、主题以及恢复/分叉支持。 - **无 TUI 也能工作。** `zero exec` 可脚本化，支持文本/JSON/stream-JSON I/O、隔离的工作树、规范优先运行，以及用于 CI 的有意义的退出码。 - **保持上下文本地化。** 会话存储在磁盘上，可搜索、可恢复，且 Zero 不会作为遥测数据上传。 - **可扩展。** 使用 MCP 服务器、技能、插件、钩子和来自同一 CLI 的专业子智能体。 ## 安装 ### npm ```bash npm install -g @twigpine/zero zero ``` npm 包是一个小型包装器，其平台构建（Linux 和 macOS 的 x64/arm64、Windows 的 x64，包含浏览器/终端控制辅助工具）作为可选依赖直接从 npm registry 安装——没有安装脚本，也不会从 npm 之外下载任何内容。Bun、pnpm 和 yarn 的行为完全一致，无需任何信任或批准步骤。跳过可选依赖的安装（`--omit=optional`）也能工作：只要二进制文件缺失，包装器就会从对应的 GitHub Release 下载。Windows on ARM 通过模拟运行 x64 构建。详见 [docs/NPM_PACKAGING.md](docs/NPM_PACKAGING.md)。之前通过 `@gitlawb/zero` 安装过 Zero？从 0.10.0 起，npm 包已迁移到 `@twigpine/zero`，旧包名不再发布新版本。两个包都提供 `zero` 命令，所以请先退出正在运行的 `zero`，再卸载旧包： ```bash npm uninstall -g @gitlawb/zero npm install -g @twigpine/zero ``` 配置、会话和登录信息都会保留，它们存放在包之外。Bun、pnpm 和 yarn 的命令见 [docs/INSTALL.md](docs/INSTALL.md#moving-from-gitlawbzero)。 ### 安装脚本 Linux/macOS： ```bash curl -fsSL https://raw.githubusercontent.com/Twigpine/zero/main/scripts/install.sh | bash ``` Windows PowerShell： ```powershell irm https://raw.githubusercontent.com/Twigpine/zero/main/scripts/install.ps1 | iex ``` ### 从源码构建源码构建需要 Go 1.26.10+。 ```bash git clone https://github.com/Twigpine/zero.git cd zero go run ./cmd/zero ``` 发布安装器和 npm 包需要已发布的 GitHub Release 资源。如果你在首次公开发布之前进行测试，请从源码构建： ```bash go build -o zero ./cmd/zero ``` 在 Linux 上，原生沙箱需要 Bubblewrap。主程序 `zero` 在找不到 `zero-linux-sandbox` 时会以自身作为辅助进程重新执行。同目录或 PATH 上的独立 helper 仍优先： ```bash go build -o zero-linux-sandbox ./cmd/zero-linux-sandbox # 可选 go build -o zero-seccomp ./cmd/zero-seccomp # 可选的兼容性包装器 ``` 将 `zero` 放在 `PATH` 上（`~/.local/bin` 是一个好的默认选择）。macOS 不需要额外的辅助二进制文件。Windows 源码构建可以使用主 `zero.exe` 作为沙箱辅助程序；发布包仍然附带独立的 Windows 辅助可执行文件。更多安装细节：[docs/INSTALL.md](docs/INSTALL.md)。 ## 首次运行启动 TUI： ```bash zero ``` 设置向导帮助你选择提供商和模型。你也可以从命令行配置提供商： ```bash zero setup zero providers list zero models list zero doctor ``` 对于 API 提供商，在设置之前设置匹配的环境变量或在向导中输入密钥： ```bash export OPENAI_API_KEY=sk-... export ANTHROPIC_API_KEY=... export GEMINI_API_KEY=... export LONGCAT_API_KEY=... export GMI_API_KEY=... export CONCENTRATE_API_KEY=... ``` 要直接配置美团 LongCat（LongCat-2.0），运行： ```bash zero providers setup longcat --set-active ``` 要直接配置 GMI Cloud，运行： ```bash zero providers setup gmicloud --set-active ``` 要直接配置 Concentrate，运行： ```bash zero providers setup concentrate --set-active ``` 对于本地模型，运行 Ollama、LM Studio 或 [Atomic Chat](https://atomic.chat) 桌面应用，然后使用 `zero setup` 或 `zero providers detect`。使用 Atomic Chat 时，请先加载模型并启用本地 OpenAI 兼容 API（默认地址为 `http://127.0.0.1:1337/v1`），再选择 `atomic-chat-local`。检测生成的添加命令会包含已加载的模型 ID；如果未发现可用的 ID，请加载模型后重试。对于需要特定 Shell 转义的模型 ID，请使用交互式设置。 ## 日常使用 ### 交互式 TUI ```bash zero ``` 常用控制： | 控制 | 操作 | |---|---| | `Enter` | 发送提示 | | `/` | 打开斜杠命令建议 | | `Shift+Tab` | 切换权限模式 | | `Ctrl+B` | 显示/隐藏侧边栏 | | `Ctrl+C` | 取消或退出 | 常用斜杠命令： | 命令 | 用途 | |---|---| | `/model`、`/provider` | 切换活动模型/提供商 | | `/spec`、`/plan` | 在构建之前起草和审查计划 | | `/image` | 为视觉模型附加图片 | | `/resume`、`/rewind` | 继续或回滚本地会话 | | `/new` | 原地开始一个新会话（之前的会话仍保留在磁盘上） | | `/compact`、`/context` | 管理上下文使用 | | `/permissions`、`/tools` | 检查可用工具和策略 | | `/add-dir` | 为此会话授予额外的写入目录 | | `/theme`、`/doctor`、`/config` | 调整外观和检查设置 | ### 无头 `exec` 模式 ```bash zero exec "解释 internal/agent/loop.go" zero exec --model claude-sonnet-4.5 "重构配置加载器" zero exec --use-spec "为 API 客户端添加速率限制" zero exec --worktree "在隔离的工作树中尝试迁移" zero exec --resume zero exec --fork "尝试另一种方法" ``` 编程使用： ```bash zero exec --input-format stream-json --output-format stream-json < turns.jsonl ``` Stream-JSON 协议文档在 [docs/STREAM_JSON_PROTOCOL.md](docs/STREAM_JSON_PROTOCOL.md)。 ## 安全模型 Zero 旨在使副作用可见。 - 工作区读取默认允许。 - 文件写入限制在工作区内，除非你授予其他目录。 - Shell 命令、网络访问、破坏性命令和提权操作需要权限授权。 - `--add-dir ` 和 `/add-dir ` 授予额外的写入根目录，而不会给智能体整个文件系统。 - 不安全/自主模式是显式选择加入。 - 在 Zero 控制的界面上，密钥会从工具输出和日志中被脱敏。示例： ```bash zero --add-dir ../docs-site zero exec --add-dir ../shared "更新两个仓库" ``` 沙箱行为可以通过以下方式检查： ```bash zero sandbox policy zero sandbox grants list ``` ## Web 和本地控制 Zero 包含本地文件/搜索/编辑/Shell 工具、用于公共 URL 的 `web_fetch`，以及用于额外工具的 MCP 支持。对于本地开发服务器，使用 Shell 命令（如通过 `exec_command` 的 `curl`），这样正常的沙箱和权限策略就会生效。长时间运行的命令保持附加到后台终端会话，可以从 TUI 中列出或停止。 npm 包还包含本地浏览器/终端工具使用的浏览器和终端辅助包。源码构建可以在它们位于 `PATH` 上或在 Zero 的本地控制设置中配置时使用相同的辅助工具。 ## 常用命令 ```text zero 交互式 TUI zero exec 一次性或脚本化智能体运行 zero setup 首次运行提供商设置 zero auth 支持提供商的 OAuth/登录辅助 zero models 模型注册表和能力 zero providers 提供商配置和检测 zero doctor 设置、密钥和连接检查 zero context 上下文预算报告 zero repo-map 确定性仓库映射 zero repo-info 本地仓库摘要 zero search | find 搜索本地会话历史 zero sessions 检查、恢复、分叉、回滚和清理会话 zero spec 管理规范模式草稿 zero specialist 管理专业子智能体 zero skills 管理 Markdown 指令技能 zero plugins 管理插件 zero hooks 管理生命周期钩子 zero mcp 管理 MCP 服务器和工具 zero serve --mcp 通过 MCP stdio 暴露 Zero 工具 zero sandbox 检查沙箱策略和授权 zero worktrees 准备隔离的 Git 工作树 zero verify 检测和运行本地验证检查 zero changes 检查和提交本地 Git 变更 zero usage Token 使用量和估算成本 zero cron 定时智能体任务 zero update --check 检查更新版本 zero upgrade 下载、验证并安装最新版本 ``` ## 外观和无障碍 | 控制 | 效果 | |---|---| | `NO_COLOR=<任意值>` | 禁用颜色输出 | | `ZERO_THEME=<名称>` | 选择启动主题（`auto`、`dark`、`light`，或颜色主题如 `dracula`、`nord`、`gruvbox`、`tokyo-night`、`catppuccin`、`one-dark`、`solarized-dark`、`rose-pine`、`everforest`、`neon`、`solarized-light`、`dune`） | | `--theme <名称>` | 从 CLI 选择 TUI 主题（相同名称） | | `/theme` | 在 TUI 中打开主题选择器（实时预览；`/theme <名称>` 直接切换） | | `ZERO_NO_FADE=1` | 禁用流式淡入动画 | 含义不仅仅依赖于颜色；差异、权限和状态也使用文本或标记符号。 ## 开发 ```bash go test ./... go run ./cmd/zero-release build go run ./cmd/zero-release smoke go run ./cmd/zero-perf-bench ``` 交叉编译示例： ```bash go run ./cmd/zero-release build --goos linux --goarch amd64 go run ./cmd/zero-release build --goos windows --goarch amd64 --output dist/zero.exe ``` ## 文档 - [安装](docs/INSTALL.md) - [更新流程](docs/UPDATE.md) - [主题](docs/THEMES.md) - [Stream-JSON 协议](docs/STREAM_JSON_PROTOCOL.md) - [专家](docs/SPECIALISTS.md) - [GitHub Action](docs/GITHUB_ACTION.md) - [基准测试](docs/BENCHMARK.md) - [性能](docs/PERFORMANCE.md) - [智能体评估](docs/AGENT_EVALS.md) ## 社区实时交流在 [Discord 服务器](https://discord.gg/CaQDS6wdFn) 进行。提问、安装帮助、想法和分享都在 [GitHub Discussions](https://github.com/Twigpine/zero/discussions)： | 分类 | 用途 | |---|---| | [Q&A](https://github.com/Twigpine/zero/discussions/categories/q-a) | 安装帮助、提供商/模型配置、"如何做"类问题 | | [Ideas](https://github.com/Twigpine/zero/discussions/categories/ideas) | 功能提议和 PR 之前的设计讨论 | | [Show and tell](https://github.com/Twigpine/zero/discussions/categories/show-and-tell) | 你的技能、插件、MCP 配置、主题和工作流 | | [Announcements](https://github.com/Twigpine/zero/discussions/categories/announcements) | 维护者发布的版本和项目动态 | ## 贡献欢迎贡献。阅读 [CONTRIBUTING.md](CONTRIBUTING.md)，运行相关测试，然后提交一个聚焦的拉取请求。安全报告应遵循 [SECURITY.md](SECURITY.md)。 ## 许可证 Zero 基于 [MIT 许可证](LICENSE) 发布。