log/CHANGELOG.md

Changelog

[1.1.10] - 2026-05-05

• 稳定性增强:
  • 修复 TestSplitTag 在秒级进位边界时的偶发性失败。优化后的测试逻辑同时校验日志产生前后的两个潜在时间槽，闭环消除了环境抖动导致的 race condition。

[1.1.9] - 2026-05-05

• 稳定性增强:
  • 改进 SplitTag 测试用例，通过秒级切分步进，闭环验证了 FileWriter 的文件自动轮转逻辑，确保在高频或定时切分场景下的可靠性。

[1.1.8] - 2026-05-05

• 深度脱敏与性能平衡:
  • 引入“混合路径”序列化策略：对基础类型（String, Int, Bool 等）采用高性能手动编码，对复杂类型（Struct, Map, Slice）采用 cast.ToJSONDesensitizeBytes。
  • 完美解决嵌套对象、数组内对象的深度脱敏问题，同时将序列化性能维持在极高水平。
• 基准测试优化: 相比全量 cast 调用，混合路径将异步写入耗时降低了 60% 以上，内存分配减少了 70%。

[1.1.7] - 2026-05-05

• 极致精简与摩擦消除:
  • 移除了所有冗余或已弃用的配置项：Fast, KeepKeyCase, RegexSensitive, SensitiveRule。
  • 删除了 Logger 中未被使用的 desensitization 处理函数及 SetDesensitization 方法，进一步收窄 API。
• 功能增强与修复:
  • 脱敏逻辑闭环: 修复了 ToArrayBytes 仅对 Map 字段脱敏的缺陷。现在支持对结构体根层级的敏感字段（如 String 类型）进行全量遮蔽。
  • 标准化命名映射: 增强 fixField 逻辑，同时支持自动忽略下划线 (_) 和横线 (-)，确保 SecretKey (Go) 与 secret_key (Config) 能完美匹配。
• 稳定性保障:
  • 新增 functional_test.go，闭环验证了 SplitTag 文件切分能力与增强后的 Sensitive 脱敏逻辑。
  • 优化 serializer.go 内部判断逻辑，基准测试显示性能有显著提升。

[1.1.6] - 2026-05-05

• 性能优化:
  • 重构 FillBase 方法签名，由接收接口 LogEntry 改为接收指针 *BaseLog。
  • 此项改动消除了在填充元数据时通过接口调用 GetBaseLog() 的开销，直接操作结构体指针，进一步提升日志预处理性能。
• 文档与示例对齐:
  • 完善 README.md 中的 Config 配置项说明，涵盖 Fast, KeepKeyCase, Truncations, SensitiveRule 等所有字段。
  • 修正 BusinessLog 扩展示例，确保与最新的 FillBase 签名及元数据填充逻辑保持一致。
• 扩展与迁移指引: 同步更新 extra.go 中的注释示例，为从旧版本或其他项目迁移提供准确的参考实现。

[1.1.5] - 2026-05-05

• 高性能 Meta 驱动架构:
  • 日志存储格式由 JSON Object 彻底切换为 JSON Positional Array ([...])，通过位置索引消除重复 Key 的存储与传输开销。
  • 实现基于反射的 零装箱 (No-Boxing) 序列化，直接拼接 JSON 字符串，大幅降低内存分配与 CPU 占用。
• 元数据外置与可视化:
  • 引入 .log.meta.json 机制，将字段顺序、颜色、格式化等可视化逻辑从核心包中剥离。
  • 新增独立 CLI 工具 logv，支持基于元数据文件的 stdin 流式日志渲染。
  • 改造 Viewable 接口，支持基于 MetaRegistry 的动态终端彩色输出渲染。
• 字段优化与压缩:
  • 合并 ImageName/Tag 为 Image，合并 ServerName/Ip 为 Server，精简日志槽位。
  • 引入 hide:true 标签，支持在控制台隐藏结构性元数据（如 LogName, LogType），保持输出极致纯净。
• 架构兼容性:
  • 调整 Writer 接口，支持自定义 Writer（如 ESWriter）自行决定序列化格式（如转回 Object 以适配 ES 索引）。
  • utility.go 新增对旧版 JSON 对象日志的解析兼容。
• 安全加固: 为 http, db, redis, discover 等子包同步添加 .gitignore 以排除自动生成的 .log.meta.json。

[1.1.2] - 2026-05-05

• 架构解耦:
  • 正式移除 log 包对数据库日志（DB 方法及 DBLog 结构）的内置支持，推动“日志格式随业务走”的架构对齐。
  • 导出 GetCallStacks 方法，支持外部包捕获符合截断配置的调用栈。
• 内部优化:
  • fillBase 回归私有，强化 Log(entry) 的自动填充契约，降低外部摩擦。
• 体验对齐:
  • 修复 viewer.go 中空错误字符串导致日志类型被跳过显示的 Bug。
  • Log 方法集成 fillBase 自动补全逻辑，对于直接调用 Log(entry) 的自定义日志类型，若未设置时间戳则自动填充元数据，无需手动干预。
• 生态同步: 依赖 config 升级至 v1.0.5。

[1.1.0] - 2026-05-05

• 性能质变:
  • GetEntry 改为泛型实现 GetEntry[T]()，消除 reflect.Type 传参及运行时类型断言。
  • 主路径零反射：增强 LogEntry 接口，支持通过 GetBaseLog() 直接获取 BaseLog 指针，填充基础字段耗时降至 $O(1)$。
  • 极速时间戳：LogTime 改为 int64 (纳秒)，完全消除了日志写入时的 time.Format 开销。
  • FileWriter 重构：采用单协程 bufio 无锁写入架构，支持 64KB 缓冲区与高性能文件轮转。
• 架构加固:
  • 引入 logPayload 路由包裹，彻底解决多 Logger 实例异步写入时的“串话”漏洞。
  • 修复同步 Fallback 模式下的线程安全隐患。
• 扩展恢复: 重新启用 extra.go 中的标准日志结构（Request, DB, Task, Monitor, Statistic），并完成泛型化适配。
• 可视化优化: 重构 Viewable 逻辑，基于 strings.Builder 和 cast 包优化 JSON 解析，渲染速度提升 2-3 倍。

[1.0.3] - 2026-05-05

• 接口规范化: 重构 Logger.Request 方法，由传递结构体指针改为接收明确参数（method, path, status, usedTime），并支持通过 extra 自动填充 RequestLog 的 20+ 个业务字段。
• 架构解耦: 将 extra.go 中的所有预定义日志结构及其快捷方法注释掉。仅作为示例供应用端参考实现，推动“应用自维护日志结构”的标准规范。
• 类型安全性: 强化 Logger.Log 方法约束，仅接受实现 LogEntry 接口（通常继承自 BaseLog）的类型，不再支持任意 any 格式。
• 文档完善: README.md 新增“自定义日志扩展”指南，明确了 BaseLog 继承、GetEntry 对象池获取及 Log 发送的完整闭环。
• 测试对齐: 更新所有测试用例与基准测试，演示如何在应用端定义和使用自定义日志结构。

[1.0.2] - 2026-05-04

• 设计优化: 引入 ResetLogEntry 自动化重置机制，基于反射和缓存实现日志对象字段的自动初始化与清空（Map/Slice 默认容量 8）。
• 接口精简: 简化 LogEntry 接口为标记接口，移除了冗余的 Base() 和 Reset() 手动实现。
• 扩展性增强: Task, Monitor, Statistic, DB 等快捷方法全面支持变长 extra ...any 参数，并集成 cast.ToMap 自动转换。
• 构建修复: 修复了 convert 模块对 cast 新 API 的兼容性问题。

[1.0.1] - 2026-05-04

• 结构增强: DBLog 结构体新增 Error 和 CallStacks 字段，提升数据库错误诊断效率。
• DB 方法重构: Logger.DB 方法支持可选错误参数，自动处理 dbError 类型并记录调用栈。
• 扩展日志支持: 新增 TaskLog, MonitorLog, StatisticLog 标准结构及其 Logger 快捷方法，置于 extra.go。
• RequestLog 封装: Logger 新增 Request 方法，简化请求日志记录流程。
• 调用栈优化: 优化 getCallStacks 逻辑，确保能正确捕获业务代码和测试代码的调用位置，同时过滤掉日志库内部帧。

[1.0.0] - 2026-05-02

• 初始版本: 由 ssgo/log 迁移并基于 apigo.cc/go 标准重构。
• 高性能引擎: 引入 LogEntry 池化与 sync.Pool 复用，支持零分配日志对象。
• 异步写入: 实现基于 Channel 的非阻塞异步写入引擎，将 IO 压力从主路径完全剥离。
• 批量刷盘: FileWriter 引入 bufio.Writer 缓冲，ESWriter 优化 Bulk 请求构造，大幅提升 IO 吞吐量。
• 灵活格式: 引入 Formatter 接口，支持 JSON 与文本等自定义格式。
• 增强视图: 内置 ConsoleWriter 与增强型 Viewer，支持 RequestLog 高亮显示与状态码变色。
• 字段规范: 统一字段 Key 为小写，确保跨平台解析一致性。
• 安全性: 集成高性能字段脱敏能力，并提供幂等停机与 Panic 恢复机制。