═══════════════════════════════════════════════════════════════════════════
  Pick-Durian 文档一致性分析 — 执行摘要
  扫描时间：2026-05-12  | 版本：v0.4.0 SKILL.md + score.py v0.3.1
═══════════════════════════════════════════════════════════════════════════

【关键统计】
✓ 文档数量：6 份 (SKILL.md, photo-protocol.md, visual_checklist.md, ripeness-criteria.md, hardened-flesh.md, rind-lignification.md)
✓ 代码文件：1 份 (score.py v0.3.1, 540 行)
✗ 发现不一致项：10 大类
  - 🔴 严重级：4 项（涉及所有触觉信号、checklist 字段映射、L1 分级）
  - 🟡 中等级：3 项（权重归一化、信号权重实现、重复计算）
  - 🟠 轻微级：3 项（流程文档、推荐补拍、决策逻辑）

═══════════════════════════════════════════════════════════════════════════

【 🔴 严重级 — 立即修复】

1️⃣  触觉信号字段命名混乱（影响范围：100%）
   问题：knock_consistency vs knock_sound？shell_touch 在 photo-protocol 无指引
   后果：Agent 可能传错字段名，触觉信号被 score.py 忽略
   修复成本：⭐⭐ (中)

2️⃣  visual_checklist 18 项与 score.py 不对齐（影响范围：35%）
   问题：第 12/15/18 项在 score.py 中未使用；peduncle_state/shell_seam/locule_evenness 未在主 checklist 列出
   后果：用户记录的信息被浪费；总项数混淆（18 vs 28）
   修复成本：⭐⭐⭐ (高)

3️⃣  L1 果柄状态分级不完整（影响范围：33% - RLI 精度）
   问题：文档定义 5 档，score.py 只实现 3 个 enum；L1=4 重复定义
   后果：RLI 置信度被人为压低；中间档位无法传输
   修复成本：⭐⭐⭐ (高)

4️⃣  L5 触感信号无用户动作指引（影响范围：20% - RLI 信息完整度）
   问题：photo-protocol.md 没有"C5.5"或"L5 动作"的说明；rind-lignification.md 提到但无详细指引
   后果：L5 字段通常缺失，RLI 置信度自动降为 medium/low
   修复成本：⭐⭐ (中)

═══════════════════════════════════════════════════════════════════════════

【 🟡 中等级 — 本周期内修复】

5️⃣  RLI 权重归一化未文档化（影响范围：置信度误解）
   问题：当 L2/L5 缺失时，权重自动重新分配，但文档未说明
   后果：用户可能误解"3 项缺失时的 RLI"的精度含义
   修复成本：⭐ (低)

6️⃣  UFR 信号无数值权重，仅计数（影响范围：风险评估粗糙度）
   问题：H1 房间不均应权重高于 H5 果壳色均，但代码中等权
   后果：功能可用，但评分缺乏细分度
   修复成本：⭐⭐ (中)

7️⃣  RLI 与成熟度信号重复使用（影响范围：成熟度评分重复加权）
   问题：底部裂缝、果壳颜色在 assess_ripeness 和 RLI 中都用到
   后果：这些信号被"加权融合"时被隐性重复计算
   修复成本：⭐⭐ (中)

═══════════════════════════════════════════════════════════════════════════

【 🟠 轻微级 — 长期改进】

8️⃣  五步工作流顺序说明不足（影响范围：文档清晰度）

9️⃣  推荐补拍（📸4 顶部图）未在 score.py 追踪（影响范围：H1 质量无反馈）

🔟  决策树 vs 加权模型的差异未说明（影响范围：理解深度）

═══════════════════════════════════════════════════════════════════════════

【 📋 建议修复优先级排序】

▶ PHASE 1（紧急，影响功能正确性）
  ☐ 扩展 l1_map：{"fresh_green": 2, "yellow_brown": 4, "brown_moist": 6, "brown_dry_woody": 8, "black_shrunk": 10}
  ☐ 统一 knock_* 字段命名（确认是 knock_consistency 还是 knock_sound）
  ☐ 为 shell_touch(L5) 补充 photo-protocol 中的用户动作指引

▶ PHASE 2（本周期，影响数据质量）
  ☐ visual_checklist.md 重构：明确哪 18 项是主 checklist，哪 10 项是 RLI/UFR 子项
  ☐ score.py 中的 peduncle_state/shell_seam/locule_evenness/shell_uniformity 在主 checklist 中显式列出
  ☐ UFR 信号补充数值权重（如 H1: 权重 3, H2: 权重 3, H3: 权重 2, H4: 权重 2, H5: 权重 1）

▶ PHASE 3（长期，改进可维护性）
  ☐ 创建 references/varieties.md 对齐 score.py 的品种判定规则
  ☐ SKILL.md 补充"常见错误"一节（视觉臆测触觉、缺失字段处理）
  ☐ score.py 输出补充 data_sources 字段，追踪每个决策的信息来源

═══════════════════════════════════════════════════════════════════════════

【 🔧 修复工作量估算】

        严重级  中等级  轻微级
代码改动  8h     6h     4h      (score.py 修改 + 枚举扩展)
文档更新  12h    8h     6h      (SKILL.md, visual_checklist, photo-protocol 重构)
测试验证  4h     3h     2h      (单元测试 + 集成测试 + 文档对齐检查)
─────────────────────────────────
总预估    24h    17h    12h     (严重级最少 24h 起步，建议 40h 完成 Phase 1+2)

═══════════════════════════════════════════════════════════════════════════

【 📍 详细报告位置】
/Users/xin/vstation/pick-durian/INCONSISTENCY_ANALYSIS.md (466 行)

包含内容：
  ✓ 10 大不一致项的详细对比（代码片段 + 文档引用行号）
  ✓ 每项的影响范围、修复难度评估
  ✓ 建议的修复方案
  ✓ Phase 1/2/3 分阶段路线图

═══════════════════════════════════════════════════════════════════════════
