pd_log library
pd_log 的核心 Dart API：统一日志输出、平台桥接与日志文件查询。
- 提供
v/d/i/w/e/out多级别日志输出； - 平台接口用于控制台输出、根路径查询与文件事件； 文件写入与缓冲完全由 Dart 层统一管理；
- 暴露日志根路径、文件列表与按日期/年份/月的查询方法；
- 自 0.5.0 起，日志路径结构统一为：
/<year>/<month>/<day>.log。
Classes
- ListOptions
- 列表查询通用选项。
- LogEvent
- 日志变更事件（仅写入 NDJSON，不强制反序列化）。
- LogLedger
- 事件溯源 + 快照 的轻量管理器。
- LogRecord
- 快照条目：记录某日志文件的最新状态。
- LogRotation
- 日志滚动工具，提供按配置删除过期日志的能力。
- LogStyleConfig
- 日志样式配置。
- PDLog
- 日志工具类，提供统一的日志输出能力。
- PDLogConfig
- 日志配置项，用于全局控制日志行为。
- PDLogFile
- 日志文件的元信息。
Enums
- LogLevel
- 日志级别枚举。
- LogRetentionStrategy
- 日志滚动策略枚举。
- SortBy
- 排序字段：时间或名称。
- SortDirection
- 排序方向：升序或降序。
- UploadState
- 上传状态枚举。
Extensions
- LogLevelExt on LogLevel
-
为
LogLevel添加扩展能力。
Constants
-
kDefaultLogStyles
→ const Map<
LogLevel, LogStyleConfig> - 默认样式主题，按日志级别提供常用的颜色与样式。