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

让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/wigolowigolo 是一个本地优先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 一并接上 MCPnpx wigolo init --agentsclaude-code,cursor装完随时用npx wigolo doctor体检各组件。search、fetch、crawl、extract、cache、find-similar 这 6 个核心工具完全免 Key即可用配置细节见 docs/installation.md 与 docs/configuration.md。技巧 1cache-first——先查缓存再上网 wigolo 抓过的每一个页面都存进本地知识缓存~/.wigolo/二次读取0ms 网络耗时、免费、且已是干净 markdown。所以正确姿势永远是先调cache工具用关键词探测本地命中就直接用未命中miss 成本为零再走search/fetch。反模式是跳过缓存直接搜索——重复抓取会白白浪费 5~15 秒。完整规则写在 skills/wigolo/rules/cache-first.md。技巧 2读证据不读结论——学会看 evidence 与 citationwigolo 返回的是可审计的结构化证据每条结果带 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 和时间的最大原因场景选它没有 URL要发现信息search已有 URL要干净 markdownfetch一个站点的多页如文档站crawl检查内容是否已在本地cache要表格 / JSON-LD / 键值对extract有篇好文章想要同类find_similar多来源综述型报告research自然语言任务 结构化取数agent对比两个版本的页面diff持续监控页面变化watch一句话口诀单页用 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 setupinclude_domains: [nextjs.org, authjs.dev]能直接过滤掉教程噪音。技能文件里这条被标注为ALWAYS永远要做。技巧 6fetch 用 section 参数只读一个标题长页面里只需要某一节时section: Parameters只返回该标题下的内容比抓整页便宜得多——这是 fetch 技能里明确标注的最省技巧。技巧 7force_refresh 只给会变的内容新闻、changelog、状态页才需要force_refresh: true绕过缓存日常查询默认走缓存才是省钱的姿势。默认开启它等于自己废掉缓存。技巧 8先 crawl 预热缓存cache 与 find_similar 才会变强对文档站优先strategy: sitemap比 BFS 更快更完整并永远加上include_patterns白名单防止爬进导航和页脚。爬完的所有页面带 embeddings 入库之后cache关键词/语义检索、find_similar相关页发现都能命中本地。缓存冷时find_similar会返回cold_start提示——把它原样告诉用户即可。技巧 9research 选对深度按 brief 结构写报告三档深度quick~15s快速事实核查、standard~40s默认、comprehensive~80s深度对比。无 MCP sampling 时输出带brief用key_findings写摘要sections.overview.cross_references是被 ≥2 个来源交叉印证的结论最可靠先引用sections.gaps是覆盖不足的子问题如实写成局限性别默默丢掉。注意research内部已检查缓存无需提前探测。技巧 10extract 用 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: summarywatch注册懒执行监控任务变化时可选 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创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考