1. 确认 Node 版本——需要 Node ≥ 20。官方推荐 LTS 版本：Node 20 / 22 / 24，用其他版本可能遇到原生模块编译错误。
2. 预留磁盘空间——约 1.5 GB。这不是程序体积，而是「本地大脑」：一个完整的浏览器引擎，加上排序模型和向量化模型——这些正是云服务在你背后替你做、然后按次收费的部分。
3. 确认平台——macOS、Linux、Windows 均支持。Linux 用户如果浏览器起不来，后面 FAQ 有对应解法。
4. （可选）准备一个免费 LLM Key——核心工具全部免 Key；只有 research 和 agent 这两个「写综述」的工具需要一个 LLM 来产出成品答案。不想配也能用，它会把证据和简报交回给你的 Agent 自己组织。

装好之后，你的 Agent 会获得下面这些工具。它们共用一个入口，覆盖了「上网办事」的完整链路：

wigolo 最值得说的不是「能搜」，而是它交回来的每一条结果都是可核查的证据：原文逐字摘录、精确锚定到源文件的字节位置、带可引用的 citation ID，还有一个 Agent 自己能检视的分数拆解。

{
  "results": [{
    "title": "Logical replication - PostgreSQL docs",
    "url": "https://www.postgresql.org/docs/current/logical-replication.html",
    "excerpt": "Logical replication is a method of replicating data objects…",
    "citation_id": "src-1",
    "source_span": { "start": 1042, "end": 1305 },   // 字节级溯源
    "evidence_score": { "final": 0.86, "semantic": 0.91,
                        "lexical": 0.78, "engine_consensus": 3 }
  }],
  "citations": [{ "id": "src-1", "url": "…" }],
  "freshness_signal": { "published": "2026-05-12", "confidence": "high" }
}

更重要的是它不粉饰失败：弱结果会被 wigolo 自己的评分器标记为 junk，失败的引擎会如实报告，缓存过期会被打上标签。遇到读不了的防爬页面，你拿到的是一个明确标注 blocked_by_challenge 的失败，而不是把验证页空壳当内容返回。

1. 命令行自测——执行 wigolo search "你的问题" --json，能返回带 evidence_score 的结果数组，说明搜索链路正常。
2. 抓取一个真实网页——wigolo fetch <url>，看是否返回干净的 Markdown。拿一个 SPA 站点试，能观察到分层升级的效果。
3. 在 Agent 里问一个实时问题——重启你的 Claude Code / Cursor，问一个只有联网才知道答案的问题。能正确引用来源，说明 MCP 已接通。
4. 确认体检全绿——npx wigolo doctor 无待修项。

四项通过，说明你的 Agent 已经具备完整的本地联网能力。想彻底卸载也很干净：npx wigolo config --uninstall --yes。

单个 Node 进程通过 stdio 说 MCP（JSON-RPC），所有重活都在本地、按需懒加载，所以零 Key 安装不会为你没用到的部分付出成本。两条设计原则值得单独一提：

• 能用代码解决的，不交给模型——规范化、排名融合、去重、Schema 匹配这些确定性工作全部不走 LLM；模型只负责需要做判断的部分，且每次请求都有用量上限。由 LLM 填充的字段还会回查原文，源文里没有就置空。
• 靠信号驱动升级，不靠猜域名——抓取层级是否升级到真实浏览器，取决于可观测信号（SPA 特征、挑战页、内容过薄），并按域名持续学习；某个站点不再需要时也会「忘掉」。想看它学到了什么，wigolo tune list 会全部列出来。