用途：debug-agent 用于系统化、基于运行时证据的调试，避免仅凭代码猜测直接修复。它要求先收集真实运行数据，再定位根因。
主要能力：生成 3-5 个关于缺陷原因的假设；在代码中插入 NDJSON 日志并行验证假设；引导用户复现问题；分析日志并对每个假设给出 CONFIRMED/REJECTED/INCONCLUSIVE 结论；仅在 100% 置信且有日志证明时修复；修复后保留埋点做前后日志对比验证；失败时回退被否假设的改动并生成新假设。
使用方式：先以后台进程运行 npx debug-agent 2>&1 &，从启动输出的 JSON 中记录 endpoint、logPath、sessionId。JavaScript/TypeScript 用一行 fetch 模板向 endpoint 发送日志；其他语言用标准库以追加模式向 logPath 写 NDJSON 行。每次运行前清空日志文件，用户复现后读取日志分析。日志负载包含 sessionId、runId、hypothesisId、location、message、data、timestamp。
适用场景：需要运行时证据的缺陷排查，尤其是多步流程、分支路径、状态变更和边界值问题。
限制：禁止记录密钥、密码、API 密钥或 PII；埋点建议 1-10 条，典型 2-6 条；禁止用 setTimeout、sleep 或人为延迟作为修复；验证成功前不得移除埋点；只能删除本会话的日志文件；服务器启动失败须立即停止。日志文件无需手动创建，会自动生成。