用途：为 Java 应用添加或改进日志，采用结构化、可被 AI 解析的格式，便于 Claude Code 等工具分析应用行为与排查问题。适用场景包括用户要求“加日志/改进日志/调试”、从日志分析应用流程、搭建 JSON 结构化日志、用关联 ID 做请求追踪。
主要能力：推荐 JSON 日志（字段可直接提取、token 更省、便于 jq 过滤）；给出面向 AI 调试的关键字段（requestId、step、duration_ms、level）；覆盖 SLF4J 基础（Logger 声明、参数化日志、日志级别 ERROR/WARN/INFO/DEBUG/TRACE）；MDC 请求上下文（RequestContextFilter 写入 requestId、认证后写入 userId、异步线程需手动复制 MDC）；记录业务事件、外部调用耗时、流程步骤；明确禁止记录密码、完整卡号、令牌、PII 等敏感数据；异常只在边界记录一次并附上下文。
使用方式：Spring Boot 3.4+ 可在 application.yml 中配置 logging.structured.format.console 为 logstash/ecs/gelf，并用 profile 在 JSON 与人类可读格式间切换；3.4 以下引入 logstash-logback-encoder 并在 logback-spring.xml 中配置，使用 StructuredArguments.kv 添加自定义字段。分析日志可用 jq 过滤错误、按 requestId 追踪、筛选 duration_ms 大于 1000 的慢操作。
限制：资料未提供具体版本兼容范围之外的性能数据、收费信息或平台支持情况；MDC 不会自动传播到新线程，需手动处理。