Release Notes - v0.8.25

GA 正式版 — 晋升自 0.8.25-beta.0。源码与 beta 完全一致；此正式版将 npm latest 从 0.8.24 升级到 0.8.25。
General Availability — Promoted from 0.8.25-beta.0 with identical source code. This release advances npm latest from 0.8.24 to 0.8.25.

🎯 本次重点 / Highlights

本版本提升 AI Card 在异常、上游缺失 final / settle、以及上游挂死场景下的生命周期可靠性：卡片会被正确收口，迟到回调不会生成无人关闭的孤儿卡片。

This release improves AI Card lifecycle reliability during errors, missing upstream final / settle callbacks, and upstream hangs: cards are finalized correctly and late callbacks cannot create orphan cards without a closer.

🐛 修复详情 / Fixes

AI Card 生命周期收口 (#644 / #647)

• closeStreaming() 会等待在途卡片创建完成后再收口，消除创建与收口的竞态。
• onIdle 与 onError 会先密封流式入口；迟到回调不再创建没有关闭方的卡片。
• 默认 10 分钟 watchdog 覆盖上游挂死或永不 settle 的场景。
• watchdog 与正常收口统一使用单飞保护，确保同一张卡只会调用一次 finishAICard。
• startStreaming 的早返回路径都会释放创建 promise gate，避免后续回合误复用已完成的 promise。
• 可选调用 markRunComplete，对齐较新的 OpenClaw channel 生命周期契约，同时保持旧版兼容。

🧪 发布核验 / Release verification

• 正式版源码与 v0.8.25-beta.0 完全一致；仅更新版本、CHANGELOG 和本 Release Notes。
• 发布包在 Node 22 下重新构建并核验：包含 dist/index.mjs、类型声明、插件元数据和本 Release Notes，且不包含开发依赖。
• 仓库当前 TypeScript 报错和 Vitest/esbuild 启动失败均已与 v0.8.24 对比，属于既有基线，不是本版本引入的回归。

📦 安装升级 / Installation & upgrade

openclaw plugins install @dingtalk-real-ai/dingtalk-connector@0.8.25
openclaw gateway restart

或者 / or:

npm install @dingtalk-real-ai/dingtalk-connector@latest

🔗 相关链接 / Related links

• PR #647
• Issue #644
• Beta release v0.8.25-beta.0
• 完整变更日志 / Full changelog