Design Template

Issue #<编号>：<标题>

复制本页到 Issue-<编号> 后替换占位内容；不要直接把模板页作为设计文档链接。

• 类型：功能 / 优化 / 缺陷修复
• 状态：草案 / 待确认 / 已确认 / 已实现 / 归档
• Issue：填写完整 URL
• PR：待创建；创建后填写完整 URL
• 最近更新：YYYY-MM-DD
• 代码基线：分支 / 提交 SHA

背景与问题

说明当前行为和影响。缺陷补充环境、复现步骤、实际及预期结果。

目标与范围

列出目标、边界条件，以及本次不处理的内容。

方案与取舍

描述数据流、交互、接口、兼容和失败处理；缺陷说明根因与修复位置。明确区分已确认结论与假设。

验收标准

• 可观察、可验证的用户行为。
• 边界与失败场景。
• 既有能力与受影响平台回归。

验证记录

日期	代码提交 / 环境	命令或场景	结果与证据
待填写	待填写	待填写	通过 / 失败 / 未运行（原因）

截图和附件上传至 assets/issue-<编号>/，记录中提供可访问的链接；较长记录可拆为 Issue-<编号>-Validation。

风险、未决事项与回退

列明尚未验证的平台、依赖、兼容限制和回退方法。

关联资料

填写关联设计、Issue、PR 与必要的代码永久链接；同步更新分类索引和 Issue / PR 正文的 Wiki 入口。