wigolo search的8个隐藏参数详解search_depth、stealth模式与category分类【免费下载链接】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 编程代理打造的本地优先 Web 搜索工具通过 MCP 提供 search搜索、fetch抓取、crawl爬取与 research调研四大核心能力——无需 API Key、不依赖云端、每次查询 $0 成本。而search工具藏着 8 个不常用的隐藏参数search_depth四档速度、mode: stealth隐身模式、category六大垂直分类就是其中最被低估的三个。本文带你把它们全部用起来。为什么你只用了 wigolo search 10% 的参数大多数人调用 search 时只传一个query。但 docs/tools.md 里列出的完整参数表加上类型定义 SearchInput其实有十几个旋钮。下面挑出最实用的 8 个全部在 skills/wigolo-search/SKILL.md 中有官方用法示例。参数一search_depth — 四档速度按需换速度换深度这是最像变速箱的参数定义见 src/types.ts四个档位档位行为时延目标ultra-fast只查本地缓存不发任何引擎请求≤ 300msfast直连引擎不做抓取/重排/富化≤ 1sbalanced默认档完整流水线多引擎并发 RRF 融合 本地 ML 重排数秒deepbalanced 最大内容富化更慢、更准两个容易踩的坑实现见 src/search/core/core-provider.tsultra-fast未命中缓存不是报错而是提示响应会带一条notice: cache miss, retry with search_depthfast or higher提醒你升档重试而不是默默返回空结果。搜索缓存的 key 会包含search_depth同一 query 用不同档位各存一份缓存互不干扰。 经验法则会话里重复问的问题先用ultra-fast摸缓存再逐步升档赶时间出结果用fast写调研报告用deep。参数二mode — stealth 模式如何绕过反爬mode有三个取值cache/default/stealth默认default。cache只走 HTTP 缓存允许返回过期内容最快最省stealth为 JS 重度页面启动独立的隐身浏览器——独立指纹强化 User-Agent、stealth 启动参数与初始化脚本见 src/fetch/stealth.ts而且走一次性浏览器、用完即弃并受专用并发槽位限制不会拖垮普通抓取池。什么时候用 stealth搜索结果页本身是 SPA 壳子、或搜索引擎返回了反爬质询页时。注意它比default慢要拉起浏览器所以别当默认值只在被拦时升档。参数三category — 六大垂直频道一个参数切换引擎池category可取general、news、code、docs、papers、images。每个类目背后是一整套独立的垂直引擎池源码在 src/search/core/verticals/而不是简单加个过滤条件code/docs针对技术内容调权查框架文档、API 参考时命中率明显更高news配合countrytime_range查时效新闻papers学术论文频道images一等公民类目走 DDG Image零 Key Brave Image 双适配器且自动跳过页面正文抓取url指向来源页而非图片资源省预算general通用兜底垂直频道结果不足 3 条时会自动从 general 池回补避免饿死。⚠️ 官方 Skill 文档特别提醒category: docs务必搭配include_domains否则容易返回泛泛的门户页。{ query: rust async traits, category: docs, include_domains: [doc.rust-lang.org, blog.rust-lang.org], max_results: 5 }还有 5 个提升命中率的隐藏参数④ exact_match — 短语级精确匹配设为true后query 按引号短语语义处理支持该语法的引擎会过滤到包含完整短语的结果编排器还会后置再过滤一遍——titlesnippet 里不含该短语忽略大小写的结果直接丢弃。查报错信息的神器{ query: Cannot read properties of undefined, exact_match: true }⑤ time_range — 时间窗 精确日期边界time_range支持day/week/month/year是精度过滤器没有日期的页面会被保留但降权而非直接丢弃。更严格的场景用 ISO 格式的from_date/to_date卡死区间搭配日期敏感的类目如news效果最好。⑥ include_domains / exclude_domains — 域名白名单与黑名单前者锁定权威来源框架官网、文档站后者屏蔽噪音教程农场、问答站。这两个参数会进入搜索缓存 key且对缓存命中结果也会重新过滤——白名单不会因为命中缓存而被悄悄忽略。⑦ country / language — 地理与语言提示country接受 ISO 3166-1 两位码us、gb、de是建议性提示而非硬性过滤支持地域加权的引擎会据此调权language同理传给引擎做语言偏好。⑧ agent_context — 让排序懂你的任务传一个{ text, recent_urls, intent }对象text是任务上下文recent_urls是代理近期看过的 URL会被去重排除避免重复返回你刚看过的页面intent是一句话任务意图。排名会向你的任务倾斜是AI 代理专用的隐藏杀手锏。8 个参数组合速查表场景推荐组合会话中重复提问search_depth: ultra-fast赶时间出结果search_depth: fast结果页被反爬拦截mode: stealth查框架/API 文档category: docsinclude_domains查时效新闻category: newstime_range: weekcountry查报错信息exact_match: true代理批量调研agent_context带recent_urls去重深度技术调研search_depth: deep 多 query 数组快速上手完整参数表参考 docs/tools.mdCLI 用法见 docs/cli.mdstealth 相关的引擎配置见 docs/configuration.md。search 工具入口在 src/tools/search.ts核心编排逻辑在 src/search/core/orchestrator.ts。把search_depth当变速箱、stealth当应急车道、category当频道开关——三个参数用熟wigolo search 的输出质量会有肉眼可见的提升。【免费下载链接】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），仅供参考