异常响应与日志规范

HTTP 接口使用项目统一响应包装，业务失败携带可检索的错误码和 Trace ID；不要把 Java 堆栈、SQL、Token 或供应商密钥直接返回前端。

日志按 Trace、Session、用户/租户和业务 ID 关联。AI 执行至少记录会话、节点、LLM、工具、RAG、Embedding 和流式输出事件；异步消费者额外记录消息 ID、重试次数和幂等键。

排障顺序：先查 Gateway 状态码和 Trace，再查目标服务日志，然后查数据库/缓存/消息状态，最后查外部模型或存储供应商。