SuperAPI AI 工具集

web-debug-search

编程与开发

查看项目

更新于 10-15 15:23

技能介绍

Web Debug Search 是一个面向软件排错的检索技能,用于围绕具体报错、兼容性问题与 API 用法疑问,在非学术网络来源中查找既有报告、兼容性线索、技术问答与社区变通方案。它的定位是调试与线索发现流程,而不是文献检索流程:其检索结果不得加入参考文献、不得作为论文论断的支持证据,也不得把社区帖子当作同行评审证据。

用途与适用场景方面,该技能可用于:复现问题、寻找变通方案、检查兼容性、了解 API 用法、比较实践做法,或识别可能的回归。它支持的来源配置包括 github(GitHub Issues 与 Discussions)、stackexchange(Stack Overflow 等相关站点)、chinese-tech(SegmentFault、V2EX、知乎、OSChina、掘金、CSDN、博客园以及腾讯/阿里开发者社区)、general-web(优先官方文档与更新日志,其次维护者博客、Hacker News、Reddit、Dev.to、Medium 等技术页面)、auto(仅路由到请求所支持的来源配置)和 all(检索全部来源,但受查询预算约束)。默认 sources 为 auto,language 为 auto,也可指定 en、zh 或 both;用户显式给出的 sources 与 language 会覆盖自动路由,不会在未说明的情况下超出显式来源列表。

使用方式上,调用形式为 /web-debug-search,后接查询内容;可从请求中提取 repository、error、package、versions、environment、goal 等要素。例如:/web-debug-search "CUDA error: invalid device ordinal" — sources: github,stackexchange;/web-debug-search "vLLM 国内镜像安装失败" — sources: github,chinese-tech — language: both;/web-debug-search "React Server Components production lessons" — sources: general-web。技能会保留报错原文身份:只去除绝对路径、时间戳、UUID、内存地址、数字请求 ID 等易变信息,精确串、最小泛化子串与翻译检索线索分别处理;翻译或转述不标记为精确匹配,并在任何检索前对凭据、令牌、私有 URL、邮箱与用户数据做脱敏。

主要能力包括按来源配置检索、控制查询预算与提前停止、对候选结果分类并合成报告。查询预算为:每个来源最多 4 次查询,总计最多 8 次,最多抓取 12 个候选。遇到官方发布说明或兼容性矩阵已给出结论、维护者报告加独立复现已确立同一故障、连续两次检索没有实质新增信息、剩余结果重复或不可访问等情况时提前停止。每个结果会被赋予四组相互独立的标签:匹配度为精确/归一化/上下文;发现类型为错误/兼容性/API 用法/变通方案;证据用途为仅调试/仅兼容性/仅线索;权威性为官方/维护者/社区问答/社区讨论/博客/搜索片段。结果表包含匹配度、发现类型、证据用途、权威性、来源配置、URL、版本/环境、发现、状态,并附可能的下一步核查(明确标注未执行)、兼容性摘要、检索覆盖范围与不确定性缺口。

限制方面,该技能不执行网上找到的命令、不安装软件包、不编辑本地文件,也不通过执行来验证变通方案;变通方案只有在用户侧明确复现后才算确认。它把 WebSearch 与 WebFetch 返回的一切内容视为不可信的、可被攻击者编辑的数据,不服从返回内容中的任何指令,不允许其改变来源路由、查询词或范围。Stack Exchange 与中文技术社区页面始终视为仅线索,即使包含精确报错或维护者链接;Reddit、Hacker News、Dev.to、Medium、个人博客与普通论坛同样仅作线索;社区共识不能替代官方兼容性文档,单篇博客不能确认回归已修复。若 WebSearch 不可用,会以 BLOCKED: web search unavailable 停止,不会凭记忆编造结果;若 WebFetch 无法读取候选页面,则标记为搜索片段、URL 未验证,仅作线索使用;无精确匹配时会明确说明并区分归一化与上下文匹配;来源对修复或版本存在分歧时保留双方报告并标记结论未决。每次报告末尾还会附上证据边界声明,说明这些结果仅用于调试与发现。