wigolo init完全指南：--agents、--wizard、--no-warmup参数怎么选

wigolo init完全指南--agents、--wizard、--no-warmup参数怎么选【免费下载链接】wigoloThe go-to web for your AI coding agent — local-first search, fetch, crawl research over MCP. No API keys, no cloud, $0/query. Public beta.项目地址: https://gitcode.com/GitHub_Trending/wi/wigolowigolo 是一款面向 AI 编程 Agent 的本地优先网页搜索 MCP 服务器——搜索、抓取、爬取、深度调研全部在本地完成无需 API Key每次查询成本 $0。一条wigolo init命令即可完成整套安装但--agents、--wizard、--no-warmup三个参数各有侧重本文用最短篇幅讲清楚每个参数怎么选帮你在 5 分钟内把 Claude Code、Cursor 等工具接入 wigolo。wigolo init 到底做了什么默认情况下wigolo init执行的是完整的无人值守安装检测系统环境Node.js 20 必需Python/Docker 可选下载浏览器引擎约 0.5–1 GB与本地嵌入/重排模型约 250 MB逐个组件校验并打印一份分组件报告——哪个组件没装好会直接写出来不会藏着等到第一次使用时才爆持久化配置打印诊断摘要关键设计组件下载失败不会让 init 报错退出它会把该组件标记为延迟加载首次使用时自动重试。非零退出码只保留给真正致命的失败如请求接入的 Agent 注册失败。npx wigolo init三种运行模式默认无人值守、--interactive 与 --wizardwigolo init有三种模式默认就是无人值守——不弹任何提问可安全放进脚本和 CI模式触发方式特点无人值守默认不加参数零交互适合脚本、CI、批量部署纯文本问答--interactive终端内逐项选择 Agent、回答引导问题图形向导--wizard富交互 TUI 向导步骤可视化可中途调整甚至卸载--wizard 向导模式什么时候选第一次使用、想直观看到每一步在配置什么时选npx wigolo init --wizard。它会接管终端进入图形化流程选择要接入的 Agent、配置可选的搜索后端与 LLM 端点完成后直接落地到设置界面。两个注意点必须在真实终端里运行。在 CI 或非交互 shell 中加--wizard/--interactive会直接报错退出而不是静默降级提示你改用无人值守模式独立二进制包中 TUI 不可用此时会提示并自动回退到纯文本流程装好之后你的 Agent 就拥有了 wigolo 的 10 个工具search、fetch、crawl、cache、extract、find_similar、research、agent、diff、watch直接问它需要联网的问题即可--agents 参数怎么选一键接入 9 种 AI 编码工具--agents接收逗号分隔的 Agent id 列表init 会自动为它们写好 MCP 服务配置并在宿主支持时写入全局指令与技能包工具idClaude Codeclaude-codeCursorcursorVS CodevscodeGemini CLIgemini-cliZedzedWindsurfwindsurfCodexcodexOpenCodeopencodeAntigravityantigravity# 只接一个 npx wigolo init --agentsclaude-code # 一次接入多个 npx wigolo init --agentsclaude-code,cursor省略--agents也是合法选择此时只安装引擎本体提示你把自己的 MCP 客户端指向npx wigolo mcp。如果你的工具不在上表里比如 Cline就走这条手动路线技能包仍可单独安装。选错的代价很低传入不支持的 id 会当场报Unknown agent id(s)并列出自愈可用的合法值不会静默跳过。--no-warmup 什么时候用跳过约 1 GB 的下载默认的完整安装会先把浏览器引擎和本地模型全部下载下来。如果网络慢、带宽受限或下载源在你的区域不稳定你只用搜索能力短期内不会碰需要浏览器渲染的抓取就加上--no-warmupnpx wigolo init --no-warmup --agentscodex它跳过所有下载每个组件改为首次使用时懒加载并提示你之后可用wigolo warmup --all预缓存。下载本身支持断点续传跑两次 init 会自动接着上次继续。一句话总结三者的关系--agents决定接给谁--wizard决定怎么装交互与否--no-warmup决定下载什么时候发生。三者可自由组合例如npx wigolo init --agentsclaude-code --no-warmup。参数速查表参数作用适用场景无参数默认无人值守完整安装日常安装、脚本、CI--agentsid,...一键接入指定 Agent逗号多选让特定 AI 工具用上 wigolo--wizard富交互图形向导 TUI首次安装、喜欢可视化引导--interactive纯文本问答流程终端内轻量交互--no-warmup跳过全部下载首次使用时懒加载网络受限 / 按需下载--json标准输出机器可读 JSON 摘要自动化脚本--providername指定 LLM 提供方anthropic / openai / gemini / ollama启用 research、agent 等本地 LLM 能力--searchbackend选择搜索后端 core / searxng / hybrid进阶调优--skip-verify跳过安装后的验证步骤追求速度的自动化⚠️ 关于 LLM Key无论哪种模式密钥只从环境变量WIGOLO_LLM_API_KEY读取永远不接受命令行传参——避免泄漏到 shell 历史和进程列表。常见坑与排查CI 里加了--wizard报错退出这是故意的——交互模式要求真实终端去掉参数即恢复无人值守。组件报告显示failed但命令退出码是 0正常行为。手动wigolo warmup --all可补下载组件也会在首次使用时自动重试。下载特别慢模型与浏览器下载是主要耗时支持断点续传浏览器引擎 CDN 被限速时可预先设置PLAYWRIGHT_DOWNLOAD_HOST镜像变量。装完怎么体检npx wigolo doctor查看各组件状态npx wigolo doctor --fix修复已知问题npx wigolo verify做端到端能力冒烟测试。装完之后第一次搜索在接好的 Agent 里直接提问即可也可以在终端做一次性调用npx wigolo search css container queries --limit2延伸阅读快速上手docs/getting-started.md完整 CLI 参数参考docs/cli.md安装渠道与 Agent 自动接入矩阵docs/installation.mdinit 命令实现src/cli/init.ts参数解析逻辑src/cli/tui/flags.ts掌握谁用、怎么装、何时下载这三问wigolo init的所有组合就都不成问题了——无 Key、无云、零查询成本让你的 AI 编码 Agent 从第一分钟起就拥有本地网页搜索能力。【免费下载链接】wigoloThe go-to web for your AI coding agent — local-first search, fetch, crawl research over MCP. No API keys, no cloud, $0/query. Public beta.项目地址: https://gitcode.com/GitHub_Trending/wi/wigolo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考