Sink 组合 API

当预设输出不足以表达路由规则时，使用 typed Logger::new(...) 和 sink 组合函数。它们接收完整 Record，因此仍保留 level、target、message 与 fields。

Logger::new(...)

pub fn Logger::new(
  sink : S,
  min_level~ : Level = Level::Info,
  target~ : String = "",
) -> Logger[S]

从任意 Sink 实现创建 typed Logger。min_level 在任何 sink 写入前生效；target 是默认值，之后可由 with_target(...)、child(...) 或单次 log(..., target=...) 覆盖。

fanout_sink(...)

pub fn fanout_sink(left : A, right : B) -> FanoutSink[A, B]

每条记录写入两个目的地，适合控制台加 JSON，或控制台加 callback。右侧获得独立记录副本，两个写入在记录值层面互不影响。

split_by_level(...)

pub fn split_by_level(
  left : A,
  right : B,
  min_level~ : Level = Level::Warn,
) -> SplitSink[A, B]

达到阈值的记录进入 left，低于阈值的记录进入 right。典型用法是把 warning/error 单独输出，而 info/debug 留在普通控制台。

callback_sink(...)

pub fn callback_sink(
  callback : (Record) -> Unit,
) -> CallbackSink

将完整结构化 Record 交给应用回调。适合测试、自定义桥接与集成；它不自动格式化记录。

redact_field(...) 与 redact_fields(...)

命中的字段会先交给 sujy123456/lunasieve 扫描。没有检出密钥时，整个字段值替换为 placeholder（默认 "***"）。检出密钥时只替换密钥片段，字段里的其余文本保留。消息正文不参与扫描。

英文原始 API

• Logger::new(...)
• fanout_sink(...)
• split_by_level(...)
• callback_sink(...)