缺陷记录 (Debug)
已知缺陷清单和 bug 记录索引。每个 bug 一个独立文件,通过
tzxq-bug-fix技能管理。
缺陷状态
| 状态 | 标记 | 说明 |
|---|---|---|
| open | 🔴 | 未修复 |
| in_progress | 🟡 | 修复中 |
| fixed | 🟢 | 已修复(修复记录见 docs/fixed/) |
| wontfix | ⚫ | 不予修复 |
| duplicate | 🔵 | 重复 bug |
缺陷清单
| ID | 标题 | 模块 | 严重度 | 状态 | 关联文件 |
|---|---|---|---|---|---|
| — | 暂无记录 | — | — | — | — |
Bug 记录模板
每个 bug 文件命名为 bug-{模块}-{简述}.md,存入 docs/debug/。
markdown
# Bug: {标题}
- **ID**: bug-{模块}-{简述}
- **状态**: 🔴 open / 🟡 in_progress / 🟢 fixed
- **严重度**: 🔴高 / 🟡中 / 🟢低
- **模块**: {stores/services/pages/game/planet-map/review/write}
- **发现日期**: YYYY-MM-DD
- **修复日期**: 未修复 / YYYY-MM-DD
- **关联修复**: docs/fixed/fix-{简述}.md
## 现象
{描述 bug 表现,包含截图引用说明}
## 复现步骤
1. {步骤1}
2. {步骤2}
3. {步骤3}
## 预期结果
{正常应该是什么行为}
## 实际结果
{当前 bug 行为}
## 涉及文件
| 文件 | 行号 | 问题描述 |
|------|------|----------|
| `path/to/file.vue` | L123 | 具体问题 |
## 根因分析
{分析问题根因}
## 影响范围
{对哪些功能/模块有影响}严重度定义
| 严重度 | 标记 | 定义 |
|---|---|---|
| 高 | 🔴 | 核心功能不可用、数据丢失、崩溃 |
| 中 | 🟡 | 功能异常但不阻断主流程、体验降级 |
| 低 | 🟢 | UI 瑕疵、文案错误、边缘情况 |