| 字段 | 说明 |
|---|---|
| BUG-XXX | 编号，三位递增 |
| 发现版本 | 发现时的版本号 |
| 状态 | 🔴 待修复 / 🟡 修复中 / ✅ 已修复 |
| 根因 | 实现错误 / 场景缺失 / 需求变更 |
维护规则： · Human 发现 Bug → Claude 在此记录 · Claude Code 修复完成 → 自动将状态更新为 ✅ 已修复 · 版本验收时确认本版本所有 Bug 均已修复或有明确说明
状态：⬜ 待修复（指令已生成，等待 Claude Code 执行） 发现版本：V0.2a 严重程度：P0（违反核心产品原则） 发现时间：2025-03-01
现象： Alex 在回复中以夸赞形式引用用户的错误表达，例如：
"I love how you said 'I am very happy to meeting you' — let me share how natives might put it..."
根因： SYSTEM_PROMPT 只禁止了直接纠错，未覆盖"包装式纠错"场景。 Alex 通过"夸赞用户的错误表达"来引出正确表达，本质上仍是显性纠错。
修复方案：
在 app/services/chat_service.py 的 SYSTEM_PROMPT 末尾追加三条绝对禁令：
- 禁止以任何形式引用用户刚才说的话（无论夸赞还是批评）
- 禁止用"how you said..."、"the way you put it..."等句式
- 禁止任何"先引用错误，再示范正确"的结构
执行指令文件：CLAUDE_CODE_BUGFIX_001_INSTRUCTIONS.md
修复验证：
运行 pytest tests/test_alex_behavior.py -v
验收门槛：D1 维度（禁止行为）6个用例全部通过
状态：⬜ 待修复（已并入 V0.2b Step 8） 发现版本：V0.2b 开发中 严重程度：P1（需求遗漏） 发现时间：2025-03-01
现象： 从历史记录进入旧对话时，无法找到「查看复盘」按钮。
根因： 需求追溯缺口（Requirements Traceability Gap）。 SPEC_V02B.md 的 BDD Scenario 中有"历史对话的复盘随时可访问"场景， 但 Step 8 的执行指令生成时漏掉了这条场景的实现要求。
修复方案：
在 CLAUDE_CODE_V02B_INSTRUCTIONS.md 的 Step 8 中追加：
- 进入历史会话时，调用
GET /review/{session_id} - 返回 200 → 右上角渲染「查看复盘」按钮
- 返回 404 → 静默处理，不显示按钮
预防措施： CLAUDE_CODE_DOC_STANDARD V2.1 已在 BDD 层新增反问检查机制，此类问题将在最上游被拦截。
- 状态：🟡 修复中
- 发现版本：V0.3.1（规划阶段，Step 6 未执行）
- 描述：Hands free 模式下，Alex TTS 回复播放完毕后，VAD 未自动恢复监听，用户需要刷新页面才能继续对话
- 根因：场景缺失——SPEC 未定义 TTS 播放结束后的状态转换，缺少对话循环闭环逻辑
- 影响 Step：Step 6（未开始，当前版本内修复）
- 修复方案：
- TTS 播放完毕回调中自动重启 VAD 监听
- TTS 播放期间暂停 VAD，避免 Alex 声音触发自身录音
- 新增 Scenario：
- Alex 回复结束后自动恢复监听
- Alex 说话时暂停 VAD 避免误触
- 修复版本：V0.3.1 Step 6
- 状态：🟡 修复中
- 发现版本：V0.3.1（规划阶段，Step 6 未执行）
- 描述：用户重新进入页面后，若 activation 设置为 hands_free，VAD 自动启动监听，行为不合理——用户未主动发起对话即被监听
- 根因：场景缺失——SPEC 混淆了"用户偏好持久化"与"会话状态激活"，未定义页面重新进入时的初始状态
- 影响 Step：Step 5（UI 初始化逻辑）、Step 6（VAD 启动时机）
- 修复方案：
- 页面加载时只渲染 activation 偏好（Voice Settings 选中状态），不自动启动 VAD
- 新增"开始对话"触发点，用户主动操作后才启动 VAD
- 新增 Scenario：
- 重新进入页面 Hands free 不自动监听
- 用户主动开始对话后才启动监听
- 修复版本：V0.3.1 Step 5 + Step 6
### BUG-XXX：[简短描述]
**状态**：⬜ 待修复 / 🔄 修复中 / ✅ 已修复
**发现版本**：VX.X
**严重程度**：P0（阻断）/ P1（主流程）/ P2（体验）
**发现时间**：YYYY-MM-DD
**现象**：[用户看到了什么]
**根因**：[技术层面的原因]
**修复方案**：[怎么修复]
**修复验证**：[如何确认修复有效]