v3.1.3 发布说明 🚀

本次 v3.1.3 是从 v3.0.0 以来的一次阶段性汇总发布，重点聚焦在 稳定性增强、AI Card 收敛一致性、以及错误观测能力提升。
在持续迭代中，我们补齐了连接重试边界、去重与终态保护，并统一了 DingTalk 错误载荷日志规范，帮助线上问题更快定位、更易追踪。

🚀 核心改进 (Key Improvements)

1. 稳定性与可靠性 (Reliability)

• 入站去重能力加固：强化 inbound dedup 处理，并补充运行时计数器，降低重复处理风险。
• 重连策略持续优化：降低误判重连的概率，暴露运行时重连统计；并进一步限制重连循环次数，避免特定场景出现无限循环（#153）。
• 网关行为更可控：围绕重连与运行时状态的可观测性继续补强，便于排障与回归验证。

1. AI Card 生命周期修复 (AI Card Lifecycle Fixes)

• 终态卡片保护：修复终态 AI Card 仍被后续流式更新的问题。
• 交付阶段去重收敛：修复 deliver 阶段重复 final update。
• 无文本回复兜底收口：当回复无文本时，确保 AI Card 正常 finalize，避免卡片停留在中间状态。
• 敏感信息防泄露：抑制 stop reason 泄露，降低日志与链路中的非预期暴露风险。

1. 错误日志标准化与排障能力 (Observability & Diagnostics)

• 统一 ErrorPayload 日志格式：新增并落地统一 DingTalk 错误载荷日志格式器。
• 跨链路标准化：在 inbound 与 AI Card 流程统一错误日志前缀、code/message/payload 输出结构。
• 测试覆盖完善：新增单元与集成测试，覆盖 400 错误载荷日志场景与格式约束。
• 文档同步更新：补充统一 ErrorPayload 日志约定，方便团队协作与线上故障定位。
• 主动消息风险提示增强：新增 proactive target 风险提示与日志关联能力，并切换到 API-based proactive risk 路径。

📌 版本演进概览 (Version Milestones)

• v3.0.1：去重与重连误判修复，补充运行时计数。
• v3.0.2：AI Card 终态保护与重复 final update 修复。
• v3.1.0：统一 ErrorPayload 日志体系（实现 + 测试 + 文档）。
• v3.1.1：主动消息风险提示与日志关联增强。
• v3.1.2：重连循环上限修复 + stop reason 泄露抑制 + proactive risk API 化。
• v3.1.3：无文本回复场景下 AI Card finalize 修复。

🤝 贡献者 (Contributors)

感谢本版本周期内的贡献者：

• @soimy：主导稳定性修复、AI Card 生命周期完善、错误日志体系建设与文档测试补齐。
• @Prajna：修复重连循环边界问题（#153），显著提升异常场景下的运行稳定性。

完整变更日志: v3.0.0...v3.1.3