Changelog

[1.1.4] - 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。

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

性能质变:
- 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 倍。

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

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

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

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