ISSUE-NNN: 简短描述(动宾结构,说明什么出了什么问题)
发现日期: YYYY-MM-DD
状态: 待分析 | 已定位 | 已修复 | 待确认
类型: 建模误差 | 实现 bug | 参数不确定
影响范围: 一句话说明哪些场景受影响,哪些不受影响
问题现象
用数据或错误信息说明"看到了什么"。避免在这里解释原因。
- 如果是精度问题:给出具体数字(RMSPE、比值、绝对误差)
- 如果是 bug:给出复现步骤和错误输出
- 如果是参数不确定:说明当前用了什么值,以及不确定的具体方面
根因分析
说明"为什么会这样"。
指向具体代码位置(文件:行号)。如果是多层原因,用级联方式写清楚。
如果根因尚未确认,在此注明"假设"并标出未验证的部分。
Spec / 文档依据
列出查阅了哪些文档,找到了什么依据。区分"明确说明"和"推断":
明确说明(直接引用原文):
"spec 原文..."
— 文档名 §章节
推断(基于 spec 的合理推断,但非直接说明):
- 推断内容,以及推断依据
未解决(查了 spec 但仍不确定的):
- 描述不确定的问题,以及需要什么额外信息
解决方案
备选方案
列出考虑过的方案,说明各自的权衡:
| 方案 | 描述 | 优点 | 缺点 |
|---|---|---|---|
| A | |||
| B |
采用方案
说明选择哪个方案及理由。
涉及文件:
| 文件 | 改动说明 |
|---|---|
path/to/file.rs | 具体改了什么 |
验证
修复后如何确认问题已解决:
- 运行哪个测试/脚本
- 预期的指标变化(修复前 → 修复后)
遗留问题
修复后仍存在的、与本 issue 相关但范围外的问题。 如无,删除此节。