Skip to content

PROBLEM_TRACKING.md

Latest commit

 

History

History
211 lines (155 loc) · 6.36 KB

PROBLEM_TRACKING.md

File metadata and controls

211 lines (155 loc) · 6.36 KB

Redream 问题追踪与验证流程

方案A：轻量级问题追踪

📋 工作流程

Step 1: 问题收集

位置: memory/YYYY-MM-DD.md (每日记录)

格式:

## 问题记录 [PROB-XXX]

**时间**: YYYY-MM-DD HH:MM
**描述**: 简要描述问题
**位置**: 文件/回目
**严重程度**: P0(致命)/P1(重要)/P2(优化)
**状态**: 待分析/修复中/已解决

Step 2: 问题分析

位置: deliverables/vX.Y.Z/FIX_CHECKLIST.md

要求:

  • 每个问题必须有唯一ID
  • 分析问题根因
  • 制定修复方案
  • 预估修复时间

格式:

| ID | 问题 | 根因 | 修复方案 | 状态 | 提交 |
|----|------|------|----------|:----:|------|
| P0-001 | 重复段落 | 编辑疏漏 | 删除重复 | ✅ | abc123 |

Step 3: 修复实施

要求:

  1. 每次修复必须关联问题ID
  2. Git提交信息包含问题ID
  3. 修复后立即更新CHECKLIST.md

Git提交格式:

fix(vX.Y.Z): [P0-001] 删除81回重复段落

- 删除"且说那日午后"重复段落
- 保留"这一日午后"版本

fixes: P0-001

Step 4: 修复验证

检查清单:

  • 问题是否真正解决
  • 是否引入新问题
  • CHECKLIST.md是否更新
  • Git是否提交
  • 是否重复问题（检查历史）

🔄 防重复机制

工作前检查清单

每次开始修复前，必须检查：

  1. 检查FIX_CHECKLIST.md

    • 搜索相似问题关键词
    • 确认该问题是否已修复过

  2. 检查Git历史

    git log --grep="问题关键词" --oneline

  3. 检查memory文件

    • 搜索该问题是否已记录

📊 问题分类标准

级别 定义 示例 响应时间
P0 致命错误，影响阅读/理解 段落重复、逻辑矛盾、人物断裂 立即
P1 重要问题，影响质量 语言风格不统一、细节错误 24小时内
P2 优化项，提升品质 回末诗优化、意境提升 排期处理

🗂️ 文件结构

~/apps/redream/
├── deliverables/vX.Y.Z/
│   ├── FIX_CHECKLIST.md          # 当前版本修复清单
│   ├── P2P3_CHECKLIST.md         # 扩展修复清单
│   └── PROBLEMS.md               # 问题历史记录(累计)
├── memory/
│   └── YYYY-MM-DD.md             # 每日问题记录
└── scripts/
    └── quality-check.sh          # (可选)质量检查脚本

✅ 已归档问题历史

v0.2.10 修复的问题

ID 问题 根因 修复方案 状态 提交
P0-001 81回重复段落 编辑时复制粘贴 删除"且说那日午后" ✅ 9aa878c
P0-002 季节跳跃 时间线疏忽 81回"深秋"→"暮秋" ✅ 9aa878c
P0-003 黛玉咳血直白 描写过于直接 "半碗猩红"→"几点暗红" ✅ 9aa878c
P0-004 宝钗台词温情 性格把握不准 "你我皆是命不由己"→"这世间..." ✅ 9aa878c
P0-005 帕子线索断裂 伏笔未回收 82回藏帕，85回取出 ✅ 832a44b
P0-006 朝堂铺垫突兀 背景交代不清 81回增加贾政密谈 ✅ 832a44b
P0-007 元妃托梦直白 梦境过于直接 "园子荒芜"→"废墟呼喊不出" ✅ 85931af
P0-009 提亲铺垫不足 情节过于巧合 紫鹃听到风声 ✅ 832a44b
P0-010 黛玉之死戏剧化 用力过猛 去掉"手握白绫" ✅ 85931af
P0-011 宝玉反应夸张 表演式悲伤 "跪在那里一动不动" ✅ 85931af
P0-014 凤姐被休冲突 与原著绣春囊冲突 改为"抄家后自保休妻" ✅ 85931af
P0-015 凤姐入狱逻辑 去王家不合理 直接入狱 ✅ 85931af
P0-016 89回捡落花不协调 与抄家氛围不符 "望竹子" ✅ 85931af
P0-017 诗稿被撕矛盾 与85回焚稿矛盾 删除该情节 ✅ 85931af
P1-002 宝玉被捕卑微 缺乏"沉默倔强" 护诗稿、不肯走 ✅ 832a44b
P1-003 宝玉麻木期缺失 顿悟过程断裂 90回"不言不语" ✅ 6342797
P1-004 微小反抗缺失 人物弧光不连续 编草蚂蚱、对麻雀说话 ✅ 6342797
P1-007 宝钗临终台词 不符合停机德 "这一生...尽了...本分" ✅ 5d8cb71
P1-008 凤姐狱中韧性 缺少不服输 整理头发、冷哼 ✅ 5d8cb71
ISS-001 分卷混入v0.1.8 源文件未清理 删除标记重新分卷 ✅ 15fe3ed
ISS-002 "躺在床上"白话 语言风格不统一 →"卧于榻上" ✅ f089afe

⚠️ 重复问题预警

以下问题已多次出现，需特别注意：

  1. 分卷错误 (ISS-001)

    • 原因：混入旧版本标记
    • 预防：每次分卷前清理源文件

  2. 白话表达 (ISS-002)

    • 原因：现代用语习惯
    • 预防：统一改为"卧于榻上"等文言表达

  3. 床上/躺下等词

    • 高频出现，需全文搜索替换

🔍 验证脚本(可选)

#!/bin/bash
# scripts/quick-check.sh

echo "=== 问题重复检查 ==="

# 检查1: 是否有v0.1.8混入
grep -n "v0.1.8" deliverables/*/fulltext/*.md && echo "⚠️ 发现旧版本标记!"

# 检查2: 是否有"躺在床上"
grep -n "躺在床上" deliverables/*/fulltext/*.md && echo "⚠️ 发现白话表达!"

# 检查3: 回末诗是否缺失
grep -L "【回末诗】" deliverables/*/fulltext/*.md && echo "⚠️ 有文件缺少回末诗!"

echo "=== 检查完成 ==="

✅ 验证结果记录

2026-03-31 最终验证

$ ./scripts/problem-check.sh v0.2.10

[检查1] 旧版本标记(v0.1.8)...      ✓ 通过
[检查2] 白话表达(躺在床上等)...     ✓ 通过  
[检查3] 分卷文件数量...            ⚠ 4个(符合规范)
[检查4] 回末诗完整性...            ⚠ Part 4为6回(107回已合并)
[检查5] 版本号一致性...            ✓ 通过

结果: ✓ 全部核心检查通过

已修复问题汇总

问题ID 描述 修复次数 状态
ISS-001 分卷混入v0.1.8 1 ✅ 已解决
ISS-002 "躺在床上"白话 3 ✅ 已解决(共17处)

方案A实施完成 : 2026-03-31
适用版本: v0.2.10-FINAL及以后
下次工作前: 必须先阅读本文件和FIX_CHECKLIST.md