文档中心问题日志采集（Deepfos Logger）
Deepfos Logger 是公司内部使用的浏览器扩展。顾问复现问题时，可以用它采集页面发起的接口请求，识别 HTTP 错误和常见业务错误，并把完整 JSON 日志交给研发定位。
它不是录屏工具，不会记录鼠标点击和页面画面。一次标准采集只需要：开始录制 → 复现一次 → 停止录制 → 导出 JSON。
安装包下载
-
版本：
1.5.1 -
SHA-256：
682817220b2ba9134b13bdb5bb6c3e29e6b6737cd5e0fed863d98f5898b13db4 -
支持：Chrome；Microsoft Edge 等 Chromium 内核浏览器也可按相同方式加载
下载后先解压 ZIP，再按照下面的步骤加载扩展；不要直接双击 ZIP 安装。
数据安全提示
导出的 JSON 和 cURL 可能包含 Cookie、Authorization、请求参数、客户数据和接口响应。日志仅限公司内部排障使用，只能通过公司认可的内部渠道传递，不要发到公开群、外部工单或其它公网位置。
什么时候使用
适合在以下情况使用：
-
页面报错、白屏、保存失败或操作没有结果；
-
问题可以重现，但仅靠截图无法判断原因；
-
研发需要接口地址、状态码、请求参数或响应内容；
-
需要确认问题环境中各前后端服务的版本。
如果问题涉及客户敏感数据，先确认内部数据处理要求，再进行最小范围录制。
安装扩展
Chrome
-
下载 ZIP，并解压到一个固定目录。
-
确认解压后的目录中可以直接看到
manifest.json。 -
在地址栏输入
chrome://extensions/。 -
打开右上角的“开发者模式”。
-
点击“加载已解压的扩展程序”。
-
选择包含
manifest.json的解压目录。 -
看到“Deepfos Logger”后，将它固定到浏览器工具栏。
Microsoft Edge
-
在地址栏输入
edge://extensions/。 -
打开“开发人员模式”。
-
点击“加载解压缩的扩展”。
-
选择包含
manifest.json的解压目录。
安装完成后，不要移动或删除解压目录，否则扩展会失效。扩展不需要安装 Node.js，也没有服务地址、账号或环境等配置项。
安装后准备
开始采集前：
-
刷新要排查的业务页面，确保扩展脚本已经加载。
-
登录目标环境，并进入接近问题发生位置的页面。
-
关闭或暂停与本次问题无关的网页，尤其是会持续刷新数据的页面。
-
准备好最短复现步骤，尽量只重现一次问题。
Deepfos Logger 录制期间会采集浏览器各标签页发起的 XHR/fetch 接口请求。关闭无关页面既能减少噪音，也能避免把不相关信息带入日志。
采集并导出日志
1. 开始录制
点击工具栏中的“Deepfos Logger”，再点击“开始录制”。
开始成功后：
-
扩展图标变为红色，并显示
REC； -
弹窗显示“录制中”和本次会话号；
-
上一次记录会被立即清空。
开始新一轮录制前，如果旧日志还需要保留，请先导出。关闭扩展弹窗不会停止录制。
2. 复现问题
回到业务页面，按准备好的最短步骤操作一次，直到问题出现。
只执行与问题有关的操作，不要在录制期间浏览其它系统。该工具只采集接口请求，不会保存操作画面；需要页面现象时请另外截图。
3. 停止录制
问题出现后立即打开扩展，点击“停止录制”。不要让录制长时间保持开启。
弹窗中可以查看：
-
“严重错误”：网络失败或 HTTP 5xx；
-
“错误”：HTTP 4xx 或识别到的业务错误；
-
“信息”：正常接口请求；
-
“总计”：本次采集到的请求数量。
可以用“全部 / 严重 / 错误 / 信息”筛选。点击一条日志可展开查看请求 URL、响应内容、耗时和 cURL；只需复现单个接口时，可以点击“复制 cURL”补充给研发。
4. 导出 JSON
点击“导出 JSON”，等待浏览器完成下载。文件名类似：
deepfos-logger-2026-07-22-会话号.json
导出时会同时探测目标环境的前后端服务版本；网络异常或部分服务不可访问时，下载可能需要等待几十秒。请等文件真正出现在下载列表后再关闭弹窗。
导出不会清空现有日志。JSON 是排障交付的首选文件，包含本次会话摘要、扩展版本、环境版本探测结果和接口明细。
交给研发时附上什么
不要只发一句“页面报错”。建议复制下面的模板，与 JSON 文件和必要截图一起发送：
问题环境：
租户 / 空间 / 应用：
发生时间：
问题页面：
复现步骤：
预期结果：
实际结果：
是否每次出现：
附件：Deepfos Logger JSON、页面截图
如果只需要排查某一个接口，可以在 JSON 之外补充该条请求的 cURL。cURL 中可能含当前登录凭据，仍须按敏感日志处理。
常见问题
浏览器工具栏里找不到扩展
进入扩展管理页，确认“Deepfos Logger”已启用。再通过浏览器的扩展菜单把图标固定到工具栏。如果页面提示扩展损坏或目录不存在，重新选择包含 manifest.json 的解压目录。
点击“开始录制”后没有日志
依次确认：
-
扩展图标已经变红并显示
REC； -
安装或重新加载扩展后，已经刷新业务页面；
-
操作确实触发了接口请求；
-
当前页面是普通的 HTTP/HTTPS 业务页面，而不是
chrome://等浏览器内部页面。
工具只采集 XHR/fetch 接口，不采集 JS、CSS、图片、WebSocket 或页面点击。
日志里有很多无关请求
录制范围包含浏览器中的其它标签页。停止当前录制，关闭无关页面，再点击“开始录制”重新采集；新一轮开始时会清空旧日志。
有 URL 和 cURL，但没有响应体
部分页面的安全策略可能阻止扩展读取响应体。此时工具会降级保留请求 URL、请求头、状态码和 cURL，仍可导出给研发，并在问题说明中注明“日志没有响应体”。
点击导出后迟迟没有下载
导出前会探测环境版本，异常环境中可能等待几十秒。保持弹窗打开，等下载出现后再关闭。最终 JSON 的 versions.probe 会记录版本探测结果或失败原因。
cURL 执行后返回 401 或登录失效
cURL 使用的是录制时的登录会话，Cookie 过期后不能继续使用。重新登录目标环境并录制一次，不要手工把旧 Cookie 发到公开位置。
上一次的日志不见了
每次点击“开始录制”都会新建会话并清空旧记录。开启下一轮之前先导出需要保留的 JSON。
更新扩展后仍然表现异常
在扩展管理页对“Deepfos Logger”点击“重新加载”，然后刷新业务页面。若收到新版本 ZIP，可解压到新目录后重新加载该目录；旧目录确认不再使用后再删除。
使用边界
-
仅限公司内部排障，不上架浏览器公开商店，也不要对外分发安装包。
-
单次最多保留约 1000 条请求；请求较多时应缩短录制时间，以导出的 JSON 为准。
-
开始录制会清空旧日志；停止录制和导出 JSON 不会清空。
-
工具提供的是排障线索，严重级别和业务错误识别结果仍需由研发结合实际接口判断。
回到顶部
咨询热线
400-821-9199
