Appearance
轻量日志工具(无依赖)
系统概览
无依赖的轻量日志工具,从 utils.ts 拆分而来(ADR-141),专门消除 state ↔ utils 的循环依赖。所有模块应统一经本文件导入日志函数,而非从 utils.ts 取,从而保证标签格式一致、且不反向拉入状态模块。
核心职责
logInfo(tag, message, ...args)— 统一[tag] message前缀,走console.infologWarn(tag, message, err?)— 走console.warn;err为空时不传第二参数,避免打印undefinedlogError(tag, message, err?)— 走console.error
对外 API(节选)
logInfo(tag: string, message: string, ...args: unknown): voidlogWarn(tag: string, message: string, err?: unknown): voidlogError(tag: string, message: string, err?: unknown): void
关键约定
- 前缀格式固定为
[tag] message,message为空时退化为[tag] warn/error的err为undefined时不传入,避免控制台出现多余的undefined
与其他子系统关系
- 被全模块引用(统一日志出口)
- 由 ADR-141 从
utils.ts剥离,切断与state.ts的循环依赖