[PinableAgents]

审计与修复已完成，保持草稿，不自动合并

基线：a92728a6ccd69370e78379a48c32b50e43ea6fb4；修复提交：15607860637629e4fe79f6f453fc612315b13c9d。主分支未修改。

远端严格 CI：全部通过

成功运行：https://github.com/PinableAgents/mlog/actions/runs/35564168911

• Go1.24.13：全根模块（含examples）精确覆盖 1,045/1,045语句，100%；完整race、vet均通过。
• 路径fuzz：CI执行240,880次，通过；本地另一次112,376次，通过。
• 六个实现分别并发输出200条日志并校验五字段、消息、级别、时间及条数；race通过。
• 34组基准，每组五次采样，远端完整运行通过；本地也有独立完整原始数据。
• Go1.27.1：完整race通过；govulncheck1.8.0返回 No vulnerabilities found.
• 已下载并核验quality/security artifact的SHA256；核心源码、测试、示例、工作流远端blob哈希与本地测试版本一致。

原版覆盖率仅33.9%，完整race失败。原诊断workflow的continue-on-error已移除。100%为语句覆盖，不代表分支/输入空间100%或无漏洞。安全扫描仅代表本次工具链、平台及漏洞库下未发现已知问题。

修复内容

修复单文件字段丢失、With路由失效、目录越界、特殊writer竞争和无界增长；修复异步字段所有权、Close/重初始化竞争，新增Flush队列屏障及Accepted/Processed/Dropped/Rejected计数；保护配置、安全模式和路径cache；纠正“安全格式化等于自动线程安全”的承诺。

性能摘要（本地环境，不与CI机器数据混合）

Go1.24.13 / linux-amd64 / Xeon8573C / GOMAXPROCS4 / 五次中位数。统一五字段JSON、时间格式、同一rolling writer；关闭caller/压缩/控制台。异步禁止丢弃，排空与Close计时；slog的同schema ReplaceAttr成本计入。

实现	ns/op	B/op	allocs/op	四并发ns/op
Zerolog1.34.0	1196	0	0	1421
Zap1.27.1	1662	24	1	1869
mlog同步	1806	168	3	2120
mlog异步含排空	2283	1288	7	2416
slog	2779	48	4	2811
Logrus1.9.4	5628	2281	35	6841

mlog同步比Zap耗时高约8.7%；异步比同步慢约26.4%，不宣称异步一定提速。真实文件含OS页缓存，不是fsync持久化或p99/SLA证据。

交付与评审边界

完整报告：docs/mlog-audit-20260921.md；用法：README；原始数据：docs/audit-results/；独立比较模块：benchmarks/。CI artifact含coverage.out、精确计数、race/vet/fuzz、基准输出及漏洞扫描。

新增InitialZapChecked/Flush/GetAsyncStats/MaxRouteWriters；旧InitialZap仍panic。LoadConfig拒绝未知YAML字段。SafeFormat对map仅输出类型摘要。调用期间共享数据仍需调用方加锁；GLOG是同步Zap接口。根目录需应用控制，符号链接检查不消除本地敌对进程TOCTOU。路由上限是每core而非全局；lumberjack不提供fsync，Processed不等于成功持久化；无自动脱敏/加密/防篡改。Windows/macOS运行时、断电恢复、多进程共写和长时间轮转压缩尚未实测。