用途:Smart Search 是 Webcmd 的搜索加抓取一站式工作流,适用于需要搜索、调研、查找来源、查询资料、抓取或阅读 URL、比较来源、收集证据的请求。不用于插件清单、插件管理或列出可用扩展。
主要能力与用法:对给定的 HTTP(S) URL 优先直接抓取,命令为 webcmd web fetch --url <url>;仅当结构化错误码为 FETCH_BLOCKED 或 FETCH_REQUIRES_BROWSER 时,才改用 webcmd web fetch-browser --url <url>。无直接 URL 的搜索查询,先抓取搜索引擎结果页,例如 webcmd web fetch --url "https://duckduckgo.com/html/?q=<encoded-query>",也可用 Bing 或 Google;默认先试一个引擎,弱、空、被拦截或缺少可用结果 URL 时再试第二个。从结果页提取 URL 后,再用 webcmd web fetch 抓取目标页作为证据,默认最多三个 URL,广泛比较时最多五个。
适配器回退:仅在抓取优先搜索、目标页抓取和允许的浏览器抓取失败或不足后,才用 webcmd list --tag search -f json 发现搜索适配器,先读 webcmd <site> <command> -h 再执行,默认只运行一个适配器搜索。无已安装命令覆盖时,可用 webcmd plugin search <site-or-capability> -f json,并按序安装插件,每个用户请求最多三个。
限制与信任边界:成本顺序强制为 web fetch、web fetch-browser、搜索适配器最后;不得从技能推断命令参数或维护路由表,不得声称搜索过实际未搜索的来源。只使用已安装命令、其输出和抓取到的一手内容作为证据,保留来源 URL 并报告失败。不自动添加市场,添加市场属于用户信任决策。优先一手来源、官方文档和直接内容,搜索摘要与标题仅用于发现,不作为证据。遇到限流、验证码、登录、地理限制等不要循环重试,同一被拦截命令不重试超过一次。响应末尾需附 Search Summary,列出已执行命令、抓取来源、浏览器回退和缺口或失败。