用途：在修改数据流代码后，验证其在运行时确实工作，而不仅是编译通过。适用于修改 /api/ 或 /shared/api/ 下的文件、改动双写/影子读/变更逻辑，或修复数据流缺陷并需要证据确认已解决。
前提：需运行 Vite 开发服务器（npm run dev）才能捕获日志。devLog() 会 POST 到 /__dev/log，由 Vite 插件写入 .logs/dev-*.jsonl；没有服务器则不会记录任何条目。
验证流程：代码改动后先通过类型检查与单元测试，再确认开发服务器运行，在浏览器中触发操作，然后运行 devlog:check；发现错误则依据日志诊断并回到代码改动，有警告则检查不匹配项，最后确认验证完成。
命令：npm run type-check（静态类型）、npm run test:run（单元测试）、npm run devlog:check（运行时验证，有错误退出 1，有警告退出 0）、npm run devlog:errors（显示警告与错误）、npm run devlog（显示最近事件）、npm run devlog:trace ID（按 correlationId 追踪单个操作）。开发服务器运行时可用 curl localhost:PORT/__dev/logs 等 HTTP 检查。
检查要点：双写应出现 write-success，异常为 write-error 或意外的 write-skipped；影子读应出现 compare-match，异常为带缺失 ID 的 compare-mismatch；任何改动都应有事件，零事件说明代码路径未被触发。注意 devlog:check 对警告退出 0，仅对错误退出 1，但警告仍需检查，影子读不匹配可能表示回填缺口。
日志格式：.logs/dev-*.jsonl，每行一个 JSON 对象，含 timestamp、category、event、level、correlationId 及可选 data 和 duration。可用 grep 按 level、category 或 event 过滤。
限制：无法启动开发服务器时存在验证缺口，需在可用测试运行后执行 devlog:check。