title: [ISSUE-XXXX] [简短标题] tags: [issue] created: 2026-05-26 updated: 2026-05-26 type: issue status: fixed severity: critical

[ISSUE-XXXX] [简短标题]¶

状态：✅ 已修复 / 🔧 修复中 / ⚠️ 已知未修 / 🔄 反复出现 首次出现：v0.x.y 修复版本：v0.x.y（如未修留空） 严重度：🔴 严重（用户卡死/崩溃）/ 🟡 中等（功能不可用）/ 🟢 轻微（体验问题）类别：调度 / UI / 登录 / 数据 / 性能 / 工具 相关 wiki：xxx.md 相关 rule：xxx.md（可选）

用户感知的现象¶

[用一句话描述用户看到/抱怨什么。用户原话比技术描述更有价值，能让未来 AI 一眼对上号]

"用户原话引用块"

根因分析¶

[1-2 段说清楚到底为什么会出问题。引用具体源码位置（文件:行号）]

修复方案¶

[代码层面做了什么。最好附 diff 片段]

// 之前
// ...

// 修复后
// ...

改动文件¶

文件	改了什么
`src/...`	一句话

验证方式¶

[怎么复现 + 怎么验证修复有效。让未来 AI/人能照做]

...
...

如何避免再犯¶

[这是最重要的一节 — 写给未来的自己/AI。教训提炼到具体可执行的检查项]

改 X 时记得查 Y
任何 Z 都必须有 W