TraceLab 是一个基于元宝搜索 SearchPro API 的数字事件调查平台。它把每次真实搜索得到的网页结果落库成证据，把同一事实的不同说法做交叉核查，再把结论写成逐条挂证据编号、带版本管理、能导出 PDF 的调查报告。这篇文章里没有一张摆拍图，所有截图和数据都来自线上环境的真实运行。

线上地址，注册即可创建自己的调查：

一、问题：查到的网页，明天就没了

最近我在网上查东西的时间越来越长，查完能留下的东西却越来越少。二十个浏览器标签页关掉，等于什么都没发生过。更麻烦的是查复杂事件的时候，两个来源说法打架，我根本记不清哪个先出现、哪个是转载、哪个连原始出处都找不到。

所以我决定写个系统把这件事管起来，它叫 TraceLab。写到一半我发现，比搜索更难的是

调查报告这个东西，特点是每一句话都可能被别人拿放大镜看。你写「某公司泄露了 120 万条数据」，读者头一个问题就是，哪来的？这就是我接元宝搜索的出发点，我要的不是「帮我搜一下」，而是一条能留痕、能复核、能写进报告的

普通搜索引擎给不了我想要的两样东西。

，我需要每条结果带标题、链接、来源站点、发布时间和摘要，而不是一个渲染好的页面；

，我要能把「某年某月某日，用某个问题搜到了这些网页」完整存档，隔一个月还能翻出来复算。

SearchPro 恰好把这两样都给全了。它返回的是纯 JSON，Pages 数组里每个元素对应一条真实网页结果，字段规整，可以直接落库。整个 TraceLab 的地基就是它，调查任务、证据档案、冲突核查、报告引用，全部从这条搜索结果流水线上长出来。

平台长这样，调查任务、证据档案、搜索历史、调查报告、系统设置各归各位。

三、手把手开通：从零到一次真实调用

开通流程不复杂。注册腾讯云账号并完成实名认证，进入元宝搜索控制台，选择 SearchPro 版本完成开通，然后在密钥管理里创建一个服务 API Key。整个过程几分钟能走完，Key 只在创建时展示一次，记得当场存好。

在写任何业务代码之前，先拿 curl 发个哀求级别的请求，确认域名、鉴权头、返回结构这三件事。这一步帮我省了后面至少半天的排查时间，因为它让我提前撞上了 SearchPro 的头一个坑。

curl -X POST "https://api.wsa.cloud.tencent.com/SearchPro" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json; charset=UTF-8" \
  -d '{"Query":"某企业数据泄露事件"}'

坑在这里，SearchPro 在业务失败时依然返回 HTTP 200，错误信息藏在响应体的 Response.Error 里。我用一个无效密钥实测，拿到的是：

HTTP 200
{"Response":{"Error":{"Code":"UnauthorizedOperation","Message":"未授权操作。"},
 "RequestId":"0be4e6f6-e55b-47cb-b96a-3fc784f08500"}}

如果你只判断 response.ok 就认为成功，那么「鉴权失败」会被当成「搜索成功但零结果」，用户看到的是「没有搜到内容」，而不是「你的 Key 不对」。这个判断错误在排查时极其误导，所以我的封装里响应校验永远先看 Response.Error 再看 Pages。

成功响应的 Pages 是一个字符串数组，这点也容易踩坑。每个元素本身是一段 JSON 字符串，要再做一次解析才能拿到 title、url、site、passage 这些字段。

Key 绝不能进前端。TraceLab 的做法是在系统设置的元宝搜索页由用户提交 Key，后端用 AES-256-GCM 加密后落库，页面回显永远只给掩码，日志里也只打前几位。这样哪怕数据库整库泄露，拿到的也只是密文。

四、从 API 到平台：把搜索结果变成证据

4.1 任务编排：认证错误绝不重试

一轮调查会拆成多轮搜索任务，每轮带着提炼后的问题去调 SearchPro。网络抖动要重试，这是常识，但我给重试上了两条硬规矩。认证类错误（UnauthorizedOperation、AccessDenied 这类）一次都不重试，直接把任务标失败，因为重试除了刷日志没有任何意义；其余错误走指数退避，连接超时 8 秒，总超时 25 秒，至多重试 2 次，单轮任务的搜索调用总量封顶，防止编排逻辑写出死循环把配额烧穿。

一个调查的搜索任务列表长这样，每轮任务的轮次、状态、结果数量一目了然。

4.2 原始报文快照：可复算的基础

每次调用的原始响应报文我会整份存进数据库，不做任何裁剪。这一步看起来费存储，实际上是整个平台可信度的底座。事后任何时候想复核「这个结论当时依据了哪条结果」，都能从原始报文出发重新解析一遍，而不是相信中间处理过的二手数据。三个案例跑下来，88 条搜索结果的原始报文全部在库。

搜索结果会进入证据档案，每条证据带原文链接、来源站点、发布时间和摘要，并自动做独立来源判断。证据库长这样，来源重复、转载混发这类问题在这里就被拦下来了。

接下来是我个人很喜欢的一步，冲突交叉核查。同一个事实点，如果不同来源的说法对不上，系统会把矛盾标出来，配上各自的证据和发布时间。谁先说的、谁在转载、谁的口径和监管通报对得上，时间线一拉就清楚。

实证一下，这是案例一里自动识别出的冲突视图。

4.4 一条容易被忽略的防线：SSRF

平台允许用户接入自定义模型服务，这就意味着后端要拿用户填的 URL 去发请求。这里有个经典漏洞叫 SSRF，攻击者填一个内网地址，让服务器替他去摸内网。我的防护做了两层，先查 URL 主机名本身，再在 DNS 解析之后查真实 IP，回环、私网、链路本地、保留地址段全部拒绝。只查第一层是挡不住 DNS 重绑定攻击的，这一手是我看安全文章时学到后立刻补上的。

搜索和证据都齐了，报告是最终的交付物，也是我认为整个项目里最难写好的部分。报告编辑器长这样，左边章节目录，中间正文，右边是数据面板。

我定了一条铁律，正文里所有关于事实的表述，必须挂一个证据编号，形如 EV-2026-000001。这个编号对应证据库里的唯一一条记录，存着标题、原始链接、来源名、发布时间和摘要。

这套机制逼着我处理了很多以前会糊弄过去的角落。比如某个编号在证据库里找不到了怎么办，省事的做法是渲染成一个链接，反正点了是 404。但我不这么想，一个指向不存在证据的链接，比一个明晃晃标红的编号危险多了，前者是骗，后者是坦白。所以解析失败的编号在页面和 PDF 里都是红色虚线下划线，明示断链。再比如正文里手打的链接，我的规则是只有出现在当前报告证据库里的网址才能变成可点击链接，其他全部退化成纯文本。听起来苛刻，但报告这种东西，宁可苛刻。

报告要导出 PDF，我选了让 Chromium 自己打印的方案。这里有个天坑，目录页码。CSS 的 target-counter() Chromium 压根不支持，网上教程的解法多是手填页码，那不如不做。

我的解法是渲染两遍。头一遍量出每个章节的实际高度，折算成页数，第二遍把算好的页码写进目录再打印。这样印出来的页码和实体页逐条对得上，案例一的报告 24 页 14 个章节，我自己逐条核对过。这里还埋过一个 bug，头一版量高度时封面没被测到，因为封面是 div 而其他章节是 section，选择器漏了它，整个目录的页码集体偏一。这种 bug 相当阴险，PDF 照样能生成，你不逐页核对根本发现不了。

报告有版本管理，规则是三条。自动保存永远不产生版本，不然打个水回来版本列表多五个「保存」；正式保存先比对内容签名，内容没变不建版本；也是最容易被漏掉的一条，已发布的报告，任何改动都必须先回落草稿并立刻生成新版本。

第三条是我在自测时抓到的。重新生成某个章节、调整章节顺序，这两个操作走的代码路径和普通编辑不一样，它们会改内容但忘了走「发布版冻结」的检查。也就是说一份已经盖了章的报告，用这两个功能动一动，正文变了，版本号纹丝不动。后来我把检查抽成守卫函数，三个入口全挂上，谁改已发布的报告谁触发升版加审计记录。原来的发布版本永远留在库里，随时翻得回去。

六、实测：三个真实调查跑一遍

讲了这么多机制，直接看实测。我起了三个独立的真实调查，从元宝搜索到证据到冲突核查到报告发布到 PDF 导出全链路跑完，没有一步模拟数据。

以案例一为例，调查总览页可以看到该事件当前的全貌，分析页则把时间线和实体关系铺开，方便交叉印证。

库里现在的家底是，120 条搜索结果、42 条证据、61 项冲突记录、6 份报告共 16 个版本，全部来自真实调用，审计日志记录着每一次关键操作。

三个诚实的声明。元宝搜索没搜到的内容进不了证据链，所以报告覆盖度受搜索能力上限约束；证据摘要是模型对网页的提炼，我保留了原始报文随时可以回溯核对，但提炼本身可能有偏差；冲突核查给出的是「这些说法不一致」的事实，最终判断仍然要人来下，平台不做仲裁。

七、总结：把「看过」变成「可复核」

这个项目让我体会很深的一点是，做工具和做玩具的分界线，藏在「敢不敢让别人拿放大镜看」这件事里。搜索谁都能接，报告谁都能拼，但每句话可追溯、页码真实、版本不可篡改，这三件事每一件都在跟人性里的懒惰作对。元宝搜索把真实的网页结果交到我手上，TraceLab 负责不让这份信任在中间环节漏掉。

https://docs.qq.com/doc/DWE54SHRMdkVnRXNK

【元宝搜索开发者征文大赛】我做了一个数字事件调查工作台：让元宝搜索从找资料变成找证据

先锋会员

TraceLab是基于元宝搜索SearchProAPI的数字事件调查平台，自动落库搜索结果、交叉核查冲突证据并生成带编号、可追溯的PDF报告。平台覆盖任务编排、证据管理、SSRF防护与版本控制，全部功能经真实调查验证，支持线上注册体验。

让每一个 Agent，都跑在云上

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

【元宝搜索开发者征文大赛】我做了一个数字事件调查工作台：让元宝搜索从找资料变成找证据

【元宝搜索开发者征文大赛】我做了一个数字事件调查工作台：让元宝搜索从找资料变成找证据

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐