yss-project/docs/image-analysis-stage-rules.md

图片阶段判断规则快速参考

🎯 四阶段判断标准（严格执行）

1. 白模 (white_model)

核心特征：

• ✅ 统一的浅色材质（灰色、米白色、浅木色）
• ✅ 表面光滑，看不到材质纹理细节（木纹、布纹、石材纹理等）
• ✅ 可以有家具（家具也是统一材质）
• ✅ 可以有灯光（灯光不影响白模判断）
• ✅ 可以有浅色（浅色≠装饰色彩）

判断标准：

hasColor = false（统一浅色≠装饰色彩）
hasTexture = false（光滑漆面≠真实纹理）
hasLighting = true/false（有无灯光不影响）

典型场景：

• SketchUp导出的白模
• 3ds Max初期模型
• 统一灰色/米白色漆面的空间

❌ 常见误判：

• 把"浅色统一材质"误判为"有装饰色彩"
• 把"有家具的白模"误判为"软装/渲染"

⚠️ 关键：如果所有表面都是统一的光滑漆面（无纹理细节），就是白模！

---

2. 软装 (soft_decor)

核心特征：

• ✅ 有真实材质纹理（能看到清晰的木纹、布纹、石材纹理）
• ✅ 有装饰色彩（不同材质有不同颜色：木色、布色、石色）
• ✅ 可以有灯光（重要！软装也可以有强灯光）
• ❌ CG渲染感不强（不像3D软件渲染出来的，材质更真实自然）

判断标准：

hasColor = true（有装饰色彩）
hasTexture = true（有材质纹理）
hasLighting = true/false（可以有灯光！）
质量分数 < 85分（中等质量）
CG感不强（关键！）

典型场景：

• 真实拍摄的家具布置图
• 材质真实但不像CG渲染
• 材质样板拼贴图
• 有纹理但光影自然的设计方案

✅ 改进：

• 之前：soft_decor要求"灯光弱" → 导致有强灯光的软装被误判为rendering
• 现在：soft_decor可以有灯光，重点是"CG感不强"

区分软装 vs 渲染： | 特征 | 软装 | 渲染 | |------|------|------| | 材质纹理 | ✅ 真实自然 | ✅ 清晰但CG感明显 | | 灯光效果 | ✅ 可有（自然光影） | ✅ 有（计算机模拟） | | CG感 | ❌ 不强 | ✅ 明显 | | 质量分数 | 70-84分 | 75-89分 | | 真实感 | 接近真实照片 | 能看出是3D渲染 |

---

3. 渲染 (rendering)

核心特征：

• ✅ CG计算机渲染感明显（能看出是3D软件渲染的：V-Ray、Corona、3ds Max）
• ✅ 有清晰的材质纹理（木纹、布纹清晰）
• ✅ 有装饰色彩（多种材质颜色）
• ✅ 有明显的灯光效果（光影、高光、阴影）
• ❌ 但质量中等（不是照片级真实感）

判断标准：

hasColor = true
hasTexture = true
hasLighting = true（灯光明显）
质量分数 70-89分（关键！）
CG感明显（能看出是3D渲染）

典型场景：

• V-Ray/Corona渲染输出
• 3ds Max效果图
• SketchUp高级渲染
• Enscape实时渲染

⚠️ 区分渲染 vs 后期： | 特征 | 渲染 | 后期 | |------|------|------| | 真实感 | CG感明显 | 照片级真实 | | 质量分数 | 70-89分 | ≥90分 | | 材质细节 | 清晰但CG | 超精细真实 | | 光影效果 | 计算机模拟 | 真实摄影级 |

关键区分点：

• 渲染：能看出是CG（计算机生成图像）
• 后期：看起来像真实拍摄的照片

---

4. 后期/照片级参考图 (post_process)

核心特征：

• ✅ 照片级真实感（看起来像真实拍摄的照片，不是CG）
• ✅ 极致材质纹理（超清晰的木纹、布纹、金属拉丝、细微划痕）
• ✅ 强烈色彩氛围（丰富的色彩层次、环境反射、色彩融合）
• ✅ 完美灯光效果（精致的光晕、柔和过渡、环境光反射）
• ✅ 超高质量（接近或达到摄影级质量）

判断标准：

hasColor = true
hasTexture = true（超清晰）
hasLighting = true（完美）
质量分数 ≥90分（关键！之前是≥85分）
照片级真实感（不是普通CG渲染）

典型场景：

• 真实拍摄的室内照片
• 客户发送的参考图（真实照片）
• 后期精修到照片级的渲染图
• 摄影级真实感的高端渲染

✅ 改进：

• 之前：质量≥85分就判定为后期 → 导致高质量渲染图被误判
• 现在：质量≥90分才判定为后期 → 更严格

⚠️ 重要区分：

• 真实照片 → post_process
• 照片级渲染（后期精修）→ post_process
• CG渲染（即使质量88分）→ rendering

---

🔥 关键改进说明

改进1：软装不再要求"灯光弱"

之前的错误逻辑：

soft_decor: 有纹理，有色彩，灯光弱
rendering: 有纹理，有色彩，灯光强，CG感

❌ 问题：很多软装图也有强烈灯光，被误判为rendering

现在的正确逻辑：

soft_decor: 有纹理，有色彩，CG感不强
rendering: 有纹理，有色彩，CG感明显

✅ 改进：重点判断CG感，而不是灯光强弱

改进2：后期阈值提高到90分

之前的错误逻辑：

质量≥85分 → post_process

❌ 问题：很多高质量渲染图（85-89分）被误判为后期

现在的正确逻辑：

质量≥90分 + 照片级真实感 → post_process
质量70-89分 + CG感明显 → rendering

✅ 改进：更严格的后期判断标准

---

📊 判断流程图

开始分析图片
    ↓
【优先级1】检查材质
    ↓
统一浅色 + 无纹理细节？
    ↓ 是
  white_model（白模）
    ↓ 否
【优先级2】检查质量
    ↓
质量≥90分 + 照片级真实感？
    ↓ 是
  post_process（后期）
    ↓ 否
【优先级3】检查CG感
    ↓
有纹理 + 有色彩
    ↓
CG感明显？
    ↓ 是              ↓ 否
rendering（渲染）  soft_decor（软装）

---

🧪 测试案例

案例1：有强灯光的软装图

特征：

• 木纹清晰可见
• 布艺纹理真实
• 灯光明亮
• 材质自然，CG感不强
• 质量：78分

判定：

• 之前：rendering ❌（因为有强灯光）
• 现在：soft_decor ✅（CG感不强）

---

案例2：高质量V-Ray渲染

特征：

• 材质纹理清晰
• 灯光效果完美
• CG渲染感明显
• 质量：87分

判定：

• 之前：post_process ❌（因为质量≥85分）
• 现在：rendering ✅（质量<90分，CG感明显）

---

案例3：真实照片

特征：

• 照片级真实感
• 超精细材质
• 自然光影
• 质量：93分

判定：

• 之前：post_process ✅
• 现在：post_process ✅（质量≥90分）

---

💡 常见问题

Q1: 如何判断"CG感"？

A: 观察以下特征：

• ✅ CG感明显：过于完美、光影计算感、材质反射过于规则
• ❌ CG感不强：自然真实、细节不完美、光影自然随机

Q2: 白模可以有家具吗？

A: 可以！白模的关键是材质统一光滑，不是"是否有家具"。

• ✅ 白模：有家具，但所有家具都是统一的灰色/米白色漆面
• ❌ 软装：有家具，能看到木纹、布纹等材质细节

Q3: 软装和渲染的区别是什么？

A: 核心区别是CG感：

• 软装：材质真实自然，像真实照片或材质拼贴
• 渲染：CG计算机渲染感明显，能看出是3D软件渲染

灯光不是区分点！两者都可以有强灯光。

Q4: 质量85-89分是什么阶段？

A: 根据CG感判断：

• CG感明显 → rendering
• 照片级真实 + AI高置信度 → post_process

质量≥90分才自动判定为后期。

---

🔧 调试技巧

查看AI判定过程

打开浏览器控制台F12，搜索：

📊 [快速分析] AI返回结果

示例日志

📊 [快速分析] AI返回结果: {
  阶段分类: 'soft_decor',
  置信度: '85%',
  空间类型: '客厅',
  有颜色: true,
  有纹理: true,
  有灯光: true,  // ✅ 软装也可以有灯光
  质量分数: 78   // <90分，不是后期
}

✅ 判定为软装阶段：AI高置信度判定为软装

---

📌 总结

核心规则

1. 白模：统一材质，无纹理细节（可有家具、灯光）
2. 软装：有纹理，有色彩，CG感不强（可有灯光！）
3. 渲染：有纹理，有色彩，CG感明显，质量70-89分
4. 后期：照片级真实，质量≥90分

关键改进

• ✅ 软装不再要求"灯光弱"
• ✅ 后期阈值提高到90分
• ✅ 重点判断"CG感"而非灯光

预期效果

• 🟠 软装识别率：40% → 80%
• 🔵 渲染识别率：70% → 90%
• 🔴 后期识别率：60% → 85%

---

版本: v1.0
更新日期: 2024-12-08
适用于: image-analysis.service.ts (快速模式 + 详细模式)