工作可从中断处继续
Prompt、工具结果、计划、重试和子 Agent 报告都属于持久会话状态。 进程重启后可以从已记录的工作继续。
Goal 与工作状态
Zuno持久工作，明确边界
一个本地 Rust 编程 Agent。目标、工具结果、重试和委派状态都能在进程重启后继续使用。
Skip to content
安装
sh
curl -fsSL https://raw.githubusercontent.com/sunerpy/zuno/main/scripts/install.sh | shpowershell
irm https://raw.githubusercontent.com/sunerpy/zuno/main/scripts/install.ps1 | iex如需从源码构建并安装当前 Git revision：
sh
cargo install --git https://github.com/sunerpy/zuno zuno --lockedripgrep 14 或更新版本只是 glob 与 grep 工具的后端，不是 Zuno 启动或核心运行 依赖。bubblewrap 0.8.0 或更新版本也只用于 Linux 上受约束的 read-only 与 workspace-write Shell。显式 danger-full-access、符合条件且受信的 workspace-write run-unconfined 降级，以及对每个 Agent 生效的受信 sandbox.backend: native 选择，都走原生执行。macOS 与 Windows 当前没有 受约束后端。安装器会使用 SHA256SUMS 校验所选 release 的归档。
开始运行
配置 Provider 后，先验证配置与模型目录：
sh
zuno debug config
zuno models myopenai --verbose在具备可用约束后端的 Linux 上，再用只读的 plan Agent 验证完整模型与工具链路：
sh
zuno run --agent plan "概述这个仓库的架构"macOS、Windows，或没有约束后端的受信 Linux 宿主，应按 快速开始显式选择原生执行路径。需要交付改动时：
sh
zuno run "为 users 接口增加分页并运行测试"直接运行 zuno 会打开终端应用。Provider 配置、凭据和沙箱检查见 快速开始。
查找文档
| 需求 | 页面 |
|---|---|
| 理解执行模型 | Zuno 是什么 |
| 查找负责某项行为的 crate | 项目结构与执行流 |
| 配置 Provider | Provider 与凭据 |
| 查询配置项 | 配置项参考 |
| 启用或切换 History 与 Notes | History 与 Notes 连续性配置 |
| 选择 Agent | Agent |
| 开发 Agent 或扩展 | Agent 与扩展开发 |
| 配置 Shell 权限 | 权限与沙箱 |
| 在编辑器中使用 | 编辑器与 ACP |
| 通过 HTTP 驱动 Zuno | HTTP API 与 OpenAPI |
| 复核 Memory、Experience 与学习得到的 Skill | Memory 与学习 |
| 查询命令 | CLI 参考 |
| 理解发布产物 | 发布流水线 |
| 排查故障 | 常见问题 |
| 查找公共能力的权威页面 | 文档覆盖地图 |
中文文档范围
中文页面与代码位于同一仓库并随行为更新。配置、项目结构、HTTP API、Memory 与学习均有 中英文入口；尚未翻译的穷举协议或设计记录会明确链接到英文权威来源。