zerostack 使用教程
从入门到精通的完整指南
zerostack 简介
zerostack 是一款极简风格的 Rust 编码智能体，专注于提供轻量高效的 AI 辅助编程体验。支持内置系统提示切换、细粒度权限管理、并行 Agent 运行和 Agent 通信协议（ACP）。通过 glob 模式的工具权限控制和死循环检测机制确保安全性。适合追求极致简洁和高效的开发者，是 Claude Code 等工具的轻量替代方案。
详细功能介绍
【工具简介】
zerostack 是一款用 Rust 编写的极简编码智能体，提供轻量、安全、高效的 AI 辅助编程能力。
【核心功能】
①内置提示系统：提供多种预设系统提示，可通过 /prompt 命令运行时切换不同行为模式，也支持自定义提示文件。
②细粒度权限控制：基于 glob 模式的工具权限管理，支持会话级白名单和死循环检测，防止 Agent 失控操作。
③并行 Agent 支持：可在同一仓库上同时运行多个 Agent 实例，每个实例自动使用独立的 git worktree，互不干扰。
④Agent 通信协议（ACP）：支持多个 Agent 之间的通信协作，实现更复杂的任务分工和协调。
⑤极简设计哲学：约 1400 行代码的精简实现，保持功能专注和代码可维护性。
【适用场景】
①轻量级编码辅助：需要快速获得 AI 编程帮助但不想安装庞大工具链的开发者。
②多任务并行开发：需要同时处理多个开发任务，利用并行 Agent 提升效率的场景。
③安全敏感环境：对 AI 工具权限控制有严格要求的企业或团队开发环境。
【快速入门】
①安装 Cargo（Rust 包管理器）和 git 环境。
②通过 cargo install 或下载预编译二进制文件安装 zerostack。
③运行 /prompt autoconfig 命令进行交互式配置。
④开始使用 zerostack 进行 AI 辅助编码。
【优缺点分析】
优点：①Rust 编写，性能优秀且资源占用极低。②权限控制机制完善，安全性设计出色。③支持并行 Agent，适合复杂的多任务开发场景。
缺点：①需要 Rust 环境，对非 Rust 开发者有一定安装门槛。②功能相对精简，可能缺少一些高级特性。③社区规模较小，生态和插件支持有限。
【适合人群】
①Rust 开发者：熟悉 Rust 生态，追求工具链统一和极致性能的程序员。②安全意识强的用户：对 AI 工具权限和安全控制有高要求的技术人员。③极简主义者：偏好轻量工具，不需要复杂功能集的高效能开发者。
1zerostack入门教程：极简Rust编码智能体上手指南
入门10分钟
zerostack是一款极简风格的Rust编码智能体，专注于提供轻量高效的AI辅助编程体验，支持系统提示切换、权限管理和并行Agent运行，是Claude Code等工具的轻量替代方案。
快速开始：
1. 确保已安装Rust工具链，执行 curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh 安装
2. 通过cargo安装zerostack：cargo install zerostack
3. 运行 zerostack config init 生成默认配置文件
4. 在配置文件中设置LLM API密钥和偏好模型
5. 进入项目目录，运行 zerostack 启动交互界面
核心功能演示：
功能一：内置系统提示切换
zerostack内置多套系统提示模板，适用于不同编程场景。在交互界面中输入 /prompt list 查看可用模板，使用 /prompt switch 编码助手 或 /prompt switch 代码审查 快速切换。你也可以创建自定义提示模板，满足团队特定的编码规范需求。
功能二：细粒度权限管理
通过glob模式控制Agent的工具访问权限。在配置文件中设置 allow: [src/**/*.rs] 表示只允许修改src目录下的Rust文件，设置 deny: [**/*.env] 禁止触碰环境变量文件。权限规则支持多层嵌套，确保AI助手不会误删或修改关键文件。
功能三：并行Agent与通信协议
zerostack支持同时运行多个Agent实例处理不同任务。使用 /agent spawn 命令创建新Agent，各Agent之间通过ACP协议通信，可以传递文件引用和任务上下文。例如一个Agent负责编写代码，另一个同时编写测试，两者协同完成开发任务。
实际使用案例：
场景一：Rust项目重构
开发者需要将一个单体Rust项目重构为workspace结构，使用zerostack的并行Agent功能，一个Agent负责拆分模块文件，另一个Agent同步更新Cargo.toml依赖关系，第三个Agent负责运行测试确保重构不破坏现有功能，三个Agent协同工作，效率提升三倍。
场景二：安全编码实践
团队对代码安全性要求高，通过zerostack的权限管理功能，严格限制AI只能修改特定目录的文件，并配置死循环检测机制防止Agent陷入无限递归。每次修改前自动创建git checkpoint，确保任何意外改动都能快速回滚。
常见问题FAQ：
Q1：zerostack和Claude Code相比有什么优势？
A1：zerostack的核心优势是轻量和可控。代码量小意味着启动快、资源占用少，细粒度权限管理和死循环检测提供了更强的安全保障，适合对工具链有严格要求的团队。
Q2：ACP通信协议是什么？
A2：Agent Communication Protocol是zerostack定义的Agent间通信标准，支持传递任务描述、文件路径和执行状态，让多个Agent能像团队成员一样协作分工。
Q3：支持哪些LLM后端？
A3：支持所有兼容OpenAI API格式的后端服务，配置文件中指定endpoint和API Key即可，也可以通过环境变量灵活切换。
小贴士：
1. 先花十分钟配置好权限规则，这是zerostack最大的安全特色，配好后使用起来更放心
2. 善用 /prompt switch 切换不同场景的提示模板，比手动描述需求效率高很多
3. 并行Agent功能适合分解明确的独立任务，对于有强依赖关系的步骤还是建议顺序执行