Skip to content

言录 1.0.0 稳定版

Latest

Choose a tag to compare

@LiuXiu233 LiuXiu233 released this 16 Jul 10:08
6922c55

言录 1.0.0

言录 1.0.0 把首版日志能力推进为有稳定模式、安全预算、采样与集成契约的基础库,同时保留 0.1 的主要入口。

主要内容

  • 结构化记录增加模式版本: 1,提供独立模式文档。
  • 六级日志、子日志器、频道、上下文和错误记录入口保持兼容。
  • JSON Lines、言据、控制台、内存、函数和轮转文件处理器形成统一管线。
  • 深层值先做非递归预算预检,再深拷贝和递归脱敏。
  • 敏感键改为大小写不敏感,覆盖常见认证、Cookie、API Key 和数据库连接凭据。
  • 固定间隔采样支持始终保留高等级记录;外部采样器采用结构化调用边界。
  • 容错处理器提供显式、可观察的输出端降级。
  • 时间源可注入,子日志器继承,测试和示例可确定。
  • 文件轮转按真实 UTF-8 字节计算,配置和单条记录受硬预算保护。
  • 请求构造器移除查询、片段和绝对地址权限部分,并脱敏首部。
  • 数据库构造器分离语句模板与参数并脱敏参数。

依赖

  • 最低言序:1.1.6。
  • 言据:v1.2.0,语义范围^1.2
  • 网络、TCP、UDP、环境、进程、原生扩展:不申请。
  • 文件:仅文件处理器需要,由言序权限模型和顶层应用约束。

验证

  • 5 卷规格覆盖等级、上下文、格式、轮转、资源、隔离、采样、容错、请求和数据库集成。
  • 4 个示例覆盖服务文件日志、自定义处理器、采样、请求和数据库。
  • 128 条嵌套结构化日志性能回归在默认执行预算内完成。
  • 规格、示例和基准同时执行树解释器与字节码 VM 对照。
  • CI 在 Linux、macOS、Windows 使用最低言序 1.1.6,并用当前稳定言序执行完整质量门禁。

兼容提示

  • 记录新增模式版本
  • 轮转按 UTF-8 字节而不是字符计算。
  • 输入和快照不再共享可变嵌套值。
  • 超限或不可编码值现在返回稳定错误。
  • 默认敏感键范围扩大。

完整替换方式见docs/MIGRATION_1.0.md