安装

Zagens 提供 Windows x64 桌面安装包（本站下载页）、跨平台 zagens-tui 终端 UI，以及 CLI（GitHub Releases / crates.io）。三者共用 Kernel V3 引擎。当前文档对齐产品线 v0.8.9（桌面含 Browser、Diff Git、工具证据复合工具等；见快速开始）。

完整图文步骤见官网 安装指引 页面；下文为摘要。

桌面安装（Windows）

当前构建尚未代码签名，Windows 可能弹出 SmartScreen 警告。

1. 在下载页下载 .exe 或 .zip。
2. 推荐 zip： 右键 → 属性 → 解除锁定 → 解压 → 运行安装器。
3. 若 SmartScreen 出现，选择更多信息 → 仍要运行（详见常见问题）。
4. （代码模式） 首次启动后完成侧栏 沙箱 向导 — 见 Windows 沙箱。

CLI 安装（无图形界面）

无头 CLI zagens 与桌面共用 runtime，适合脚本、CI 或无 GUI 服务器。支持 Windows / macOS / Linux。

crates.io（需 Rust）：

cargo install zagens-cli --bin zagens --locked
zagens --version

GitHub Release 预编译包：

从 didclawapp-ai/zagens Releases 下载对应平台二进制（Windows：zagens-x86_64-pc-windows-msvc.exe），加入 PATH。

配置：

zagens doctor
# 编辑 ~/.zagens/config.toml（参考产品仓 config.example.toml）

Windows 代码工作流建议随后运行 zagens sandbox setup。

完整命令说明见 Headless CLI 文档。

终端 TUI（zagens-tui）

全屏三栏 Agent UI — 与桌面共用 Kernel V3 与 SQLite 会话，适合 macOS / Linux 或偏好终端的用户。

GitHub Release 预编译包：

从 Releases 下载 zagens-tui（与 zagens CLI 同页），加入 PATH 后直接运行：

zagens-tui
zagens-tui --fresh

完整说明：终端 TUI · Kernel V3

校验下载（可选）

从下载页复制 SHA-256，在 PowerShell 中对比：

Get-FileHash .\Zagens_*_x64-setup.exe -Algorithm SHA256

系统要求

• Windows 10 1903+ 或 Windows 11（x64）— 桌面安装包
• WebView2 — 缺失时安装器自动安装（需联网）
• 内置 runtime sidecar — 无需单独安装 Python
• CLI：zagens doctor 会检查其余依赖