log

type Logger interface {
	// Debugw 用于记录调试级别的日志，通常用于开发阶段，包含详细的调试信息。
	Debugw(msg string, kvs ...any)

	// Infow 用于记录信息级别的日志，表示系统的正常运行状态。
	Infow(msg string, kvs ...any)

	// Warnw 用于记录警告级别的日志，表示可能存在问题但不影响系统正常运行。
	Warnw(msg string, kvs ...any)

	// Errorw 用于记录错误级别的日志，表示系统运行中出现的错误，需要开发人员介入处理。
	Errorw(msg string, kvs ...any)

	// Panicw 用于记录严重错误级别的日志，表示系统无法继续运行，记录日志后会触发 panic。
	Panicw(msg string, kvs ...any)

	// Fatalw 用于记录致命错误级别的日志，表示系统无法继续运行，记录日志后会直接退出程序。
	Fatalw(msg string, kvs ...any)

	// Sync 用于刷新日志缓冲区，确保日志被完整写入目标存储。
	Sync()
}

type Options struct {
	// DisableCaller 指定是否禁用 caller 信息.
	// 如果设置为 false（默认值），日志中会显示调用日志所在的文件名和行号，例如："caller":"main.go:42".
	DisableCaller bool
	// DisableStacktrace 指定是否禁用堆栈信息.
	// 如果设置为 false（默认值），在日志级别为 panic 或更高时，会打印堆栈跟踪信息.
	DisableStacktrace bool
	// Level 指定日志级别.
	// 可选值包括：debug、info、warn、error、dpanic、panic、fatal.
	// 默认值为 info.
	Level string
	// Format 指定日志的输出格式.
	// 可选值包括：console（控制台格式）和 json（JSON 格式）.
	// 默认值为 console.
	Format string
	// OutputPaths 指定日志的输出位置.
	// 默认值为标准输出（stdout），也可以指定文件路径或其他输出目标.
	OutputPaths []string
}