服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务,不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动,严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外,不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- HAR 即使很小,也会经过精简处理并移除请求和响应正文。
- 普通文本超过 1 MiB、结构化文本超过 2 MiB 时,只保留首尾。
- 长 PDF 从文档开头读取。只有扫描图像的 PDF 需要先提取文字,或把相关部分截成图片。
- 每条消息最多 4 个文件,裁剪后合计最多 14 MiB。
先判断缺的是哪种证据
Cloudflare 在 11 月 18 日公布 Agent Lee 的附件功能,目前仍为 Beta。如果目的是找出页面加载中最慢的请求,先保留一次短复现的网络记录,并在提问中写明问题发生的时间和受影响的页面。
如果目的是核对接口返回的错误字段,直接在本地打开浏览器开发者工具的 Network 面板查看响应。Agent Lee 会移除 HAR 中的请求和响应正文及 Cookie,并遮盖 Authorization 等凭证头。换成更小的 HAR 仍会触发同样的处理。
用较短的 HAR 定位慢请求
在 Chrome 中打开 Network 面板,清空旧记录,再复现一次。可以先用过滤器缩小到相关的一组请求,然后选择 Save all listed as HAR (sanitized) 导出。上传前检查记录中的 URL 和查询参数,删除私密值、账号数据和任何不必要的内部信息。
可以问 Agent Lee 哪些请求耗时最长、对应的状态码是什么,以及要从哪个请求继续查。保留原始记录在本地以便对照。如果定位后还需要解释具体的错误正文,只分享必要的字段或经过脱敏的截图。
日志中段和扫描 PDF 怎么补
日志的故障行可能正好位于大文件中段。普通文本超过 1 MiB,或 JSON、HAR、YAML、TOML、XML 等结构化文本超过 2 MiB 时,浏览器只保留开头和结尾。先在本地按时间或请求标识找到故障行,摘出前后的少量上下文,再作为新文本上传。
PDF 会先转成文本,长文件从开头读起。可以尝试在本地选中目标页的文字来检查扫描件是否有文本层。纯图像扫描页可在本地做 OCR 并复核结果,也可在遮盖敏感信息后,单独上传相关区域的截图。
检查附件大小和对话上下文
PNG、JPEG、WebP 每张最多 3.5 MiB,PDF 每个最多 5 MiB,文档列出的文本格式每个可选至 100 MiB。每条消息最多 4 个文件,裁剪后总量最多 14 MiB。如果证据分散,先发送与当前问题直接相关的文件,并在消息中指明该看哪一段。
附件会随对话存储,较早的附件会从对话里移除。如果后续排查要再次引用已经移除的附件,重新附上经过脱敏的短片段。上传前检查内容,去掉密码、API 令牌和其他秘密。
资料来源
常见问题
小于 2 MiB 的 HAR 会保留响应正文吗?
HAR 也会经过固定的精简处理,移除请求和响应正文以及 Cookie。2 MiB 是结构化文本的裁剪阈值。
为什么一份很短的扫描 PDF 也读不出来?
Agent Lee 从 PDF 提取文字。纯图像扫描页没有可提取的文本层,可以先在本地做 OCR,或上传遮盖敏感信息后的局部截图。
为什么长日志的报错行在原文件里,Agent Lee 却没看到?
超过裁剪阈值的文件只保留首尾。找到报错时间,另存包含报错行及前后上下文的脱敏片段再上传。