用途:面向开放网络的通用知识检索通道,用于查找供应商文档、标准或官方指南,产品与方法对比及基准,技术新闻、发布说明与近期状态;既可单独搜索,也可作为 /tome:research 会话的一个渠道(中等深度下由 planner 调度 tome:web-searcher,查询前先做正向对照 RFC 2119,使其静默结果可计入覆盖结论)。不适用于代码实现(用 Skill(tome:code-search))、社区观点(用 Skill(tome:discourse))、学术文献(用 Skill(tome:papers))。
来源优先级:配置后优先使用 You.com MCP 服务器(you-search 工具),否则回退内置 WebSearch 工具。You.com MCP 为可选项,缺失时不会导致会话失败。
可选配置:免费无密钥配置执行 claude mcp add you --transport http https://api.you.com/mcp?profile=free;认证端点(更高限速,需 you.com 的 YDC_API_KEY)执行 claude mcp add you --transport http https://api.you.com/mcp
--header "Authorization: Bearer $YDC_API_KEY"。仅认证端点需要密钥。
工作流:用 tome.channels.web.expand_web_queries() 构建查询;若配置了 MCP 则经 you-search 执行,否则用 WebSearch;用 parse_you_mcp_result() 或 parse_websearch_result() 解析;经 rank_web_findings() 排序;返回 Finding 对象。
失败处理与退出条件:MCP 出错或不可达时改用 WebSearch 并在查询日志记录回退,报告显示降级而非正常;两条路径均失败时明确报告,不返回编造或空结果。每项查询至少通过其一执行一次;结果解析为含标题、URL、相关性分数的 Finding 并标记 channel="web",按分数降序返回;使用回退时如实上报;无结果时明确报告而非静默返回空列表。