Wizard 实战:一行命令安装的自进化 AI Agent,Rust 原生支持多模型融合与 MCP 生态
AI Agent 工具越来越多,但大部分都有一个共同的问题:安装复杂,依赖多,换个模型就要重新配置一遍。如果你只是想在终端里有一个能随时调用的 AI 助手,可以做代码审查、文件操作、网页抓取,甚至并行执行多任务,那么 Wizard 可能是目前最简单的选择——一行命令安装,一个 Rust 二进制文件搞定全部功能。
快速安装
Wizard 的安装方式可能是目前所有 AI Agent 中最为简洁的:
curl -fsSL https://raw.githubusercontent.com/teddytennant/wizard/main/install.sh | bash
安装后直接运行 wizard 即可进入交互式终端界面。首次运行时会引导你选择模型提供商:
- Local:自动检测硬件配置,下载适配的 Qwen 3 GGUF 量化模型,自动启动
llama-server,无需任何 API Key - 云端:支持 OpenAI、Anthropic、xAI、OpenRouter、Cloudflare Workers AI 等 OpenAI 兼容端点
- Ollama:直接复用已有 Ollama 安装
选择后即可开始对话。所有配置和技能文件存储在 ~/.wizard/ 目录下,纯 TOML 格式,可以直接编辑。
核心功能实战
1. 多模型无缝切换
Wizard 最实用的特性之一是在运行时动态切换模型,无需重启:
/model # 查看当前模型 /provider # 切换到其他提供商 /effort high # 设置高推理强度(xAI Grok 4、OpenAI o-series 等支持)
API Key 以环境变量或 ~/.wizard/credentials.toml 文件(权限 0600)形式管理,不会出现在配置文件中。这意味着你可以在同一个对话中先使用本地模型做简单任务,需要复杂推理时一键切换到 Claude 或 GPT。
2. 模型融合(Fusion)——让多个模型互相审查
Wizard 的 /fusion 功能是目前同类工具中较少见的:它运行多个模型组成辩论小组,让各模型互相审查对方的回答,最后由一个合成器生成最终结果。
/fusion # 开启/关闭融合模式 /fusion config # 选择参与面板的模型
工作流程:
- 面板咨询阶段:多个模型独立回答用户问题,并以纯文本形式互相审阅(不调用工具)
- 合成阶段:合成器接收原始请求和工具权限,参考面板的答案生成最终结果
融合模式的独特之处在于,合成器是唯一的工具调用者,避免了多个模型冲突调用工具的问题。实测中,融合后的回答质量通常超过面板中最强的单一模型。
3. 自扩展(Self-extension)——让 Agent 自己长出新能力
Wizard 支持两种级别的自扩展,灵感来自 Pi(Node/TS 原地热更新)和 Hermes Agent(skill + MCP 模式):
Tier 1:运行时扩展(默认,无需重编译)
/evolve add a skill for writing conventional commit messages
Wizard 自动创建 ~/.wizard/skills/conventional-commits/SKILL.md,通过 /reload 立即生效。支持四种扩展通道:
- Skills:Markdown 格式的行为指南或领域知识,注入到系统提示词中
- MCP 服务器:stdio 或 HTTP 协议的 MCP 服务器,自动注册到工具列表中
- 脚本工具:Python、Shell 等脚本,包装为工具
- 子代理:独立的 subagent,用于审查、研究、测试等特定任务
Tier 2:深度扩展(需编译)
/evolve --deep "add a new tool for analyzing SQL query performance"
当变更需要修改核心代码时,Wizard 自动执行 cargo build 并通过冒烟测试后才生效,原始二进制保留用于回滚。
4. 人格模式:Genie 与 Sovereign
Wizard 提供两种操作模式,覆盖从日常协作到自主运行的完整场景:
Genie 模式(默认)
wizard --mode genie
互动式终端界面(Ratatui),直接执行所有操作,无需每次确认。适合日常代码开发、文件操作等协作场景。
wizard > Review src/auth.rs for security issues > Fix the issues you found
Sovereign 模式
wizard --mode sovereign -p "implement rate limiting on all API routes"
自主运行模式,无需人工干预持续工作直到任务完成。可以通过 --continuous 参数进入永久运行模式,自动压缩上下文并自我修复。
5. 基准测试(Bench)——用真实任务评估模型
wizard bench 是一个内置的轨迹录制和回放基准测试系统:
wizard bench # 启动基准测试
工作流:
- 录制:Wizard 在自主运行时自动记录每次 Agent 动作轨迹到
.wizard/trajectories.jsonl - 用例标记:将有价值的轨迹标记为测试用例,附带验证命令
- 回放测试:在不同模型或构建版本上回放测试用例,输出通过率
这意味着你可以用自己真实的编码任务来衡量”这个新模型真的更好吗?”,而不是依赖别人的排行榜。
6. Telegram 网关——从手机操控 Agent
export WIZARD_TELEGRAM_TOKEN=*** wizard --gateway
每一条 Telegram 消息在项目目录中触发一次自主 Agent 操作,回复自动发送回聊天。支持白名单 allowed_chat_ids 限制访问。
7. Fleet——并行任务执行
wizard fleet run -n 3 -p "raise test coverage of the parser and document the public API" wizard fleet status # 查看任务进度
Fleet 将一个大任务分解为多个子任务,在独立的 git worktree 中并行执行,最后合并回主分支。每个子任务由独立的 Wizard 进程在各自的分支上运行。
安全考量
Wizard 有一个明确的威胁模型:
- 单二进制安全:Rust 编译,无解释器注入入口,无 GC 运行时
- 每次安装的自扩展负载不同:不存在统一的工具攻击面
- 无沙箱:工具以当前用户权限执行,推荐在容器/VM 中运行自主模式
- 凭证管理:API Key 存储在
credentials.toml(0600),不混入配置文件中
总结
Wizard 是一个设计精巧的 AI Agent:它用 Rust 的编译安全和单二进制分发解决了传统 Agent 的复杂依赖问题,用自扩展机制保持了灵活性,用模型融合实现了高于单一模型的质量。如果你一直在找一款既能本地运行、又能随时切换云端模型、还能自主执行复杂任务的终端 Agent,Wizard 值得一试。
- GitHub: https://github.com/teddytennant/wizard
- 许可证: MIT
- 安装:
curl -fsSL https://raw.githubusercontent.com/teddytennant/wizard/main/install.sh | bash