企业官网建设流程全解析

让Agent用好wigolo的11个技巧：cache-first、证据阅读与工具选择

【免费下载链接】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

wigolo 是一个本地优先（local-first）的 AI Agent 网络工具 MCP 服务器：它给 Claude Code、Cursor、Codex 等编码 Agent 提供 search 搜索、fetch 抓取、crawl 爬取、cache 缓存、research 研究等 10 个网络工具，无需 API Key、不经过云端、每次查询 $0。装好很容易，让 Agent 真正用好它才是关键。本文从项目自带的 11 条 Agent 技能（skills）中提炼出 11 个实战技巧，覆盖 cache-first 工作流、证据阅读与工具选择，帮你的 Agent 又快又省地查网。

一步接好 wigolo：快速安装与 Agent 接线

一条命令完成本地引擎安装，并把日常 Agent 一并接上 MCP：

npx wigolo init --agents=claude-code,cursor

装完随时用npx wigolo doctor体检各组件。search、fetch、crawl、extract、cache、find-similar 这 6 个核心工具完全免 Key即可用，配置细节见 docs/installation.md 与 docs/configuration.md。

技巧 1：cache-first——先查缓存，再上网 🐇

wigolo 抓过的每一个页面都存进本地知识缓存（~/.wigolo/），二次读取0ms 网络耗时、免费、且已是干净 markdown。所以正确姿势永远是：

1. 先调cache工具用关键词探测本地；
2. 命中就直接用；未命中（miss 成本为零）再走search/fetch。

反模式是跳过缓存直接搜索——重复抓取会白白浪费 5~15 秒。完整规则写在 skills/wigolo/rules/cache-first.md。

技巧 2：读证据，不读"结论"——学会看 evidence 与 citation

wigolo 返回的是可审计的结构化证据：每条结果带 ML 重排分数evidence_score、逐字摘录excerpt、字节级来源位置source_span和可引用的citation_id。让 Agent 这样用：

• 先读按分数排好序的evidence[]摘录；
• 跨来源归并重叠主题，回答时用[N]引用citations里映射的 URL；
• 看到brand_collision_warning、freshness_signal这类字段时，提醒 Agent 它正站在什么样的证据上。

写作模板见 skills/wigolo/rules/synthesis.md，字段契约见 docs/tools.md。

技巧 3：按"场景路由表"选工具，别滥用重炮

10 个工具各司其职，选错工具是浪费 token 和时间的最大原因：

一句话口诀：单页用 fetch，多页用 crawl，报告用 research，取数用 agent——别拿research查单个 URL（见 skills/wigolo/SKILL.md 的升级路径）。

技巧 4：搜索用"关键词数组"，别发自然语言问句

"how do I debounce in React hooks"永远输给"react useDebounce hook custom"。更优做法是一次传 3~5 个关键词变体的数组，wigolo 会并行查询并自动去重——比 N 次单独调用更宽、更省。参数细节见 skills/wigolo-search/SKILL.md。

技巧 5：文档类查询，务必锁定 include_domains

查框架/库文档时，include_domains是硬过滤器：query: "authentication setup"+include_domains: ["nextjs.org", "authjs.dev"]，能直接过滤掉教程噪音。技能文件里这条被标注为ALWAYS（永远要做）。

技巧 6：fetch 用 section 参数，只读一个标题

长页面里只需要某一节时，section: "Parameters"只返回该标题下的内容，比抓整页便宜得多——这是 fetch 技能里明确标注的"最省"技巧。

技巧 7：force_refresh 只给"会变的内容"

新闻、changelog、状态页才需要force_refresh: true绕过缓存；日常查询默认走缓存才是省钱的姿势。默认开启它等于自己废掉缓存。

技巧 8：先 crawl 预热缓存，cache 与 find_similar 才会变强

对文档站优先strategy: "sitemap"（比 BFS 更快更完整），并永远加上include_patterns白名单防止爬进导航和页脚。爬完的所有页面带 embeddings 入库，之后cache关键词/语义检索、find_similar相关页发现都能命中本地。缓存冷时find_similar会返回cold_start提示——把它原样告诉用户即可。

技巧 9：research 选对深度，按 brief 结构写报告

三档深度：quick（~15s，快速事实核查）、standard（~40s，默认）、comprehensive（~80s，深度对比）。无 MCP sampling 时，输出带brief：

• 用key_findings写摘要；
• sections.overview.cross_references是被 ≥2 个来源交叉印证的结论，最可靠，先引用；
• sections.gaps是覆盖不足的子问题，如实写成"局限性"，别默默丢掉。

注意research内部已检查缓存，无需提前探测。

技巧 10：extract 用 structured 模式，一次拿全结构化数据

要表格、定义列表、JSON-LD、图表提示、键值对时，mode: "structured"一次调用全拿，优于链式多次 extract。指定字段时用mode: "schema"+ 带properties的 JSON Schema——LLM 填的值会逐条对照原文校验，幻觉值直接返回 null，不瞎猜。

技巧 11：用 steps 复盘 agent，用 diff / watch 跟踪变化

agent每次运行都返回steps数组（plan → search → fetch → extract，带耗时），结果弱时先读它定位是哪一步出了问题。页面变化方面：

• diff：同一个 URL 两侧，即"当前线上 vs 上次缓存"的漂移检测；只要数量统计就用output: "summary"；
• watch：注册懒执行监控任务，变化时可选 SSRF 防护的 webhook 通知；
• 批量巡检多个缓存 URL 的变化，用cache的check_changes: true。

结语：$0/query 的真正含义

Agent 是"爆发式提问"的——一次任务几十次查询。把 11 个技巧用对，配合 docs/tools.md 的完整参数表，你的 Agent 就能在本地缓存上复问无数遍、在证据上引用每一句话、在正确的工具上花每一毫秒。技能目录可通过wigolo skills add|list|remove管理，更多示例见 examples/README.md。

【免费下载链接】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