用途:debug 技能用于调试需要运行时证据的前端/UI 缺陷。当你准备让用户打开 DevTools 查看控制台、复现问题并反馈输出,或准备添加 console.log 时,应改用此技能。它把日志采集放到服务端,由你直接读取,避免用户手动复制粘贴。
主要能力:提供基于 Bun 的 CLI 日志服务器,含 serve 与 cleanup 子命令;通过 HTTP 接口创建会话、写入日志;日志以 NDJSON 格式保存,每条含时间戳、消息、数据、假设编号和代码位置。工作流包括:启动日志服务器、创建会话、生成 3-5 条可测试假设、在代码中插入 3-8 个带假设编号的埋点、清空日志并复现、读取日志逐条判定假设(CONFIRMED/REJECTED/INCONCLUSIVE)、仅在证据确认根因后修复、对比修复前后日志验证、可选做五问分析、最后移除埋点并删除日志文件。
使用方式:运行 bun scripts/cli.ts serve /path/to/project & 启动服务,默认端口 8787,可用 DEBUG_PORT 覆盖,日志目录默认 .debug,可用 DEBUG_LOG_DIR 覆盖。用 curl 向 /session 创建会话并保存返回的 session_id,向 /log 写入日志。清理命令为 bun scripts/cli.ts cleanup clear 或 remove 加项目路径与会话 ID。浏览器端可用 sendBeacon 或 fetch 发送日志。
适用场景:状态/值问题(null、undefined、类型错误)、条件逻辑分支、异步时序(竞态、加载顺序)、用户交互流程(弹窗、表单、点击)。也提供 Chrome 扩展调试方案:内容脚本经 chrome.runtime.sendMessage 转发到后台脚本,再由后台 fetch 到本地日志服务;注入到 MAIN world 的脚本可用 window.postMessage 中继。
限制:日志可能受混合内容、CSP、CORS 预检影响,需用开发服务器代理或 sendBeacon 等方式规避;端口 8787 被占用时需先释放。资料未提供安装方式、收费、价格与平台支持等细节。