极致高性能：采用 Meta-Driven Positional Array (元数据驱动定长数组) 架构。日志以单行 JSON 数组 ([...]) 形式落盘，消除 Key 冗余与装箱开销，性能提升数倍。
架构解耦：元数据外置于 .log.meta.json。日志包仅负责高速序列化，可视化由外部工具或 Viewable 接口根据元数据动态渲染。
零摩擦入口：自动识别环境上下文（应用名、IP等），无需手动构建。
语义脱敏：内置敏感信息（如手机号、密钥）的自动脱敏与正则过滤。
高度可扩展：支持多种写入渠道（文件切分、Elasticsearch批量传输）。

📦 安装

go get apigo.cc/go/log

💡 快速开始

import "apigo.cc/go/log"

// 使用默认配置初始化 (或在配置中指定)
logger := log.NewLogger(log.Config{Name: "my-app", Level: "info"})

// 记录业务日志 (自动通过 cast.ToMap 处理变长参数)
logger.Info("用户登录", "userId", 10086, "ip", "1.2.3.4")
logger.Error("数据库连接失败", "db", "mysql", "err", err)

🛠 API 指南

核心功能

分级记录
- Debug, Info, Warning, Error —— 标准日志方法，支持 message + 变长 extra 参数。
通用记录 (Log)
- Log(LogEntry) —— 记录自定义结构的日志。注意：仅支持实现 LogEntry 接口的类型。
独立可视化工具 (logv)
- 安装：
```
go install apigo.cc/go/log/logv@latest
```
- 使用：tail -f app.log | logv tail -f app.log | logv -json，依赖当前目录的 .log.meta.json 文件。

自定义日志扩展

如果标准日志分级不能满足业务需求，可以轻松扩展自定义日志类型：

定义结构体：必须嵌入 log.BaseLog 或 log.ErrorLog 等结构体以实现 LogEntry 接口。
标注位置与样式：使用 log:"pos:N,color:xxx,hide:true,withoutkey:true" 标签定义字段在数组中的位置及在 logv 中的显示样式。
注册模型：在 init() 中调用 log.RegisterType("my-type", MyLog{})。
获取与发送：使用 log.GetEntry[MyLog]() 并调用 logger.Log(entry)。
参考示例: log/extra.go。

type BusinessLog struct {
    log.BaseLog  // 必须嵌入
    Action string `log:"pos:10,color:cyan"`
    UserId string `log:"pos:11"`
}

func init() {
    log.RegisterType("business", BusinessLog{})
}

func LogBusiness(logger *log.Logger, action, userId string) {
    entry := log.GetEntry[BusinessLog]()
    logger.FillBase(&entry.BaseLog, "business")
    entry.Action = action
    entry.UserId = userId
    logger.Log(entry) 
}

配置项 (JSON/YAML)

Name: 应用名称。
Level: 日志级别 (debug, info, warning, error)。
File: 输出目标（支持 console 或 es:// 地址）。
SplitTag: 文件切分标识（仅在输出到文件时有效）。
Truncations: 堆栈信息截断前缀（多个以逗号分隔，默认截断 github.com/, golang.org/, /apigo.cc/）。
Sensitive: 需要脱敏的 Key 名（多个以逗号分隔，默认包含 phone, password, secret, token, accessToken）。
RegexSensitive: 正则表达式脱敏规则。
SensitiveRule: 脱敏展示规则 (例如 12:4*4 表示长度为12时保留前4后4，中间打码)。
KeepKeyCase: 是否保持 Extra 字段中 Key 的原始大小写。默认一律转换为小写以确保搜索一致性。
Fast: (保留字段) 是否开启极速模式。目前已通过架构优化默认实现极速写入。

🧪 验证状态

测试全部通过，异步写入与性能达标。

详见：TEST.md

README.md Unescape Escape

@go/log

🎯 设计哲学

📦 安装

💡 快速开始

🛠 API 指南

核心功能

自定义日志扩展

配置项 (JSON/YAML)

🧪 验证状态

README.md