用途:Debug Mode 面向需要运行时证据的前端/UI 缺陷调试,强调“不要猜测”,按假设→埋点→复现→分析→修复→验证的流程推进。适用于状态/取值异常(null、undefined、类型错误)、条件分支判断、异步时序(竞态、加载顺序)以及用户交互流程(弹窗、表单、点击)等问题。
主要能力:提供基于 Bun 的 CLI 日志服务器,含 serve 与 cleanup 两个子命令;通过 HTTP 接口创建会话、写入日志,日志以 NDJSON 逐行保存。支持用假设编号标记埋点、修复前后对比验证,以及可选的“五个为什么”根因分析。
使用方式:运行 bun scripts/cli.js serve /path/to/project & 启动服务(默认端口 8787,可用 DEBUG_PORT 覆盖;日志目录默认 .debug,可用 DEBUG_LOG_DIR 覆盖)。用 curl 向 /session 创建会话并保存返回的 session_id,再向 /log 写入日志。清理用 bun scripts/cli.js cleanup clear 或 remove 加项目路径与会话 ID。埋点代码需包裹在 // #region debug 与 // #endregion 之间,便于后续移除。
限制与注意:需先收集日志再修复,验证通过前不要移除埋点;若日志为空,需排查混合内容、CSP、CORS 或防火墙问题,可用 sendBeacon、开发服务器代理等方式规避。浏览器扩展内容脚本受 CSP 限制,需经后台脚本转发日志。资料未提供收费、平台支持范围等更多信息。