material_manager.py

bl_info = {
    "name": "Material Manager Pro",
    "author": "qwe2528068-a11y",
    "version": (1, 0, 0),
    "blender": (4, 0, 0),
    "location": "3D Viewport > Sidebar > Material Mgr",
    "description": "材质管理插件 — 预设材质库 + 自定义属性编辑",
    "category": "Material",
}

import os
import json
import bpy
from bpy.types import Panel, Operator, PropertyGroup, Menu, UIList
from bpy.props import (
    StringProperty, FloatProperty, FloatVectorProperty,
    EnumProperty, BoolProperty, IntProperty, PointerProperty, CollectionProperty
)

# ═══════════════════════════════════════════════════════════
#  预设材质库
#  数值为 Blender 4.x Principled BSDF 的标量近似预设，参考常见 PBR/IOR 资料。
# ═══════════════════════════════════════════════════════════

PRESET_MATERIALS = {
    # ── 金属类 ──
    "黄金": {
        "category": "金属", "base_color": (1.0, 0.766, 0.336, 1.0),
        "roughness": 0.15, "metallic": 1.0, "specular": 0.5, "specular_tint": 0.2,
    },
    "玫瑰金": {
        "category": "金属", "base_color": (1.0, 0.599, 0.552, 1.0),
        "roughness": 0.18, "metallic": 1.0, "specular": 0.5, "specular_tint": 0.15,
    },
    "白银": {
        "category": "金属", "base_color": (0.972, 0.96, 0.915, 1.0),
        "roughness": 0.1, "metallic": 1.0, "specular": 0.5, "specular_tint": 0.0,
    },
    "铂金": {
        "category": "金属", "base_color": (0.92, 0.895, 0.86, 1.0),
        "roughness": 0.08, "metallic": 1.0, "specular": 0.55, "specular_tint": 0.0,
    },
    "紫铜": {
        "category": "金属", "base_color": (0.955, 0.637, 0.538, 1.0),
        "roughness": 0.2, "metallic": 1.0, "specular": 0.5, "specular_tint": 0.1,
    },
    "黄铜": {
        "category": "金属", "base_color": (0.887, 0.789, 0.434, 1.0),
        "roughness": 0.22, "metallic": 1.0, "specular": 0.5, "specular_tint": 0.05,
    },
    "青铜": {
        "category": "金属", "base_color": (0.714, 0.428, 0.181, 1.0),
        "roughness": 0.32, "metallic": 1.0, "specular": 0.45, "specular_tint": 0.3,
    },
    "铸铁": {
        "category": "金属", "base_color": (0.56, 0.57, 0.58, 1.0),
        "roughness": 0.45, "metallic": 1.0, "specular": 0.4, "specular_tint": 0.0,
    },
    "钨钢": {
        "category": "金属", "base_color": (0.58, 0.59, 0.62, 1.0),
        "roughness": 0.18, "metallic": 1.0, "specular": 0.45, "specular_tint": 0.0,
    },
    "铝": {
        "category": "金属", "base_color": (0.913, 0.921, 0.925, 1.0),
        "roughness": 0.28, "metallic": 1.0, "specular": 0.5, "specular_tint": 0.0,
    },
    "钛合金": {
        "category": "金属", "base_color": (0.672, 0.637, 0.585, 1.0),
        "roughness": 0.24, "metallic": 1.0, "specular": 0.5, "specular_tint": 0.0,
    },
    "铬": {
        "category": "金属", "base_color": (0.55, 0.556, 0.554, 1.0),
        "roughness": 0.03, "metallic": 1.0, "specular": 0.5, "specular_tint": 0.0,
    },
    "生锈铁": {
        "category": "金属", "base_color": (0.55, 0.2, 0.08, 1.0),
        "roughness": 0.82, "metallic": 0.25, "specular": 0.18, "specular_tint": 0.4,
    },
    # ── 玻璃类 ──
    "透明玻璃": {
        "category": "玻璃", "base_color": (1.0, 1.0, 1.0, 1.0),
        "roughness": 0.0, "metallic": 0.0, "specular": 0.5,
        "transmission": 1.0, "ior": 1.45, "alpha": 0.0,
    },
    "光学水晶": {
        "category": "玻璃", "base_color": (1.0, 1.0, 1.0, 1.0),
        "roughness": 0.0, "metallic": 0.0, "specular": 0.5,
        "transmission": 1.0, "ior": 1.5, "alpha": 0.0,
    },
    "铅玻璃": {
        "category": "玻璃", "base_color": (1.0, 1.0, 1.0, 1.0),
        "roughness": 0.0, "metallic": 0.0, "specular": 0.55,
        "transmission": 0.95, "ior": 1.7, "alpha": 0.0,
    },
    "磨砂玻璃": {
        "category": "玻璃", "base_color": (1.0, 1.0, 1.0, 1.0),
        "roughness": 0.25, "metallic": 0.0, "specular": 0.4,
        "transmission": 0.9, "ior": 1.45, "alpha": 0.05,
    },
    "着色玻璃": {
        "category": "玻璃", "base_color": (0.3, 0.6, 0.8, 1.0),
        "roughness": 0.05, "metallic": 0.0, "specular": 0.5,
        "transmission": 0.85, "ior": 1.45, "alpha": 0.05,
    },
    "琥珀玻璃": {
        "category": "玻璃", "base_color": (0.8, 0.5, 0.15, 1.0),
        "roughness": 0.05, "metallic": 0.0, "specular": 0.5,
        "transmission": 0.75, "ior": 1.5, "alpha": 0.05,
    },
    "翡翠玻璃": {
        "category": "玻璃", "base_color": (0.15, 0.65, 0.35, 1.0),
        "roughness": 0.03, "metallic": 0.0, "specular": 0.5,
        "transmission": 0.7, "ior": 1.52, "alpha": 0.05,
    },
    "彩虹玻璃": {
        "category": "玻璃", "base_color": (0.95, 0.95, 1.0, 1.0),
        "roughness": 0.02, "metallic": 0.0, "specular": 0.5,
        "transmission": 0.9, "ior": 1.5, "alpha": 0.02,
        "clearcoat": 0.8, "clearcoat_roughness": 0.02,
    },
    "裂纹玻璃": {
        "category": "玻璃", "base_color": (0.95, 0.95, 0.95, 1.0),
        "roughness": 0.15, "metallic": 0.0, "specular": 0.4,
        "transmission": 0.8, "ior": 1.45, "alpha": 0.08,
        "clearcoat": 0.3, "clearcoat_roughness": 0.5,
    },
    "可见玻璃": {
        "category": "玻璃", "base_color": (0.55, 0.75, 0.85, 1.0),
        "roughness": 0.08, "metallic": 0.0, "specular": 0.5,
        "transmission": 0.55, "ior": 1.45, "alpha": 0.25,
        "clearcoat": 0.2, "clearcoat_roughness": 0.05,
    },
    "茶色玻璃": {
        "category": "玻璃", "base_color": (0.55, 0.35, 0.18, 1.0),
        "roughness": 0.06, "metallic": 0.0, "specular": 0.5,
        "transmission": 0.5, "ior": 1.45, "alpha": 0.3,
        "clearcoat": 0.15, "clearcoat_roughness": 0.05,
    },
    "墨绿玻璃": {
        "category": "玻璃", "base_color": (0.08, 0.25, 0.15, 1.0),
        "roughness": 0.1, "metallic": 0.0, "specular": 0.45,
        "transmission": 0.45, "ior": 1.5, "alpha": 0.35,
    },
    # ── 塑料类 ──
    "光面塑料": {
        "category": "塑料", "base_color": (0.8, 0.2, 0.2, 1.0),
        "roughness": 0.15, "metallic": 0.0, "specular": 0.5, "clearcoat": 0.3,
    },
    "哑光塑料": {
        "category": "塑料", "base_color": (0.5, 0.5, 0.5, 1.0),
        "roughness": 0.6, "metallic": 0.0, "specular": 0.5,
    },
    "粗糙塑料": {
        "category": "塑料", "base_color": (0.3, 0.7, 0.3, 1.0),
        "roughness": 0.8, "metallic": 0.0, "specular": 0.3,
    },
    "亚克力": {
        "category": "塑料", "base_color": (1.0, 1.0, 1.0, 1.0),
        "roughness": 0.05, "metallic": 0.0, "specular": 0.55,
        "transmission": 0.3, "ior": 1.49, "clearcoat": 0.5,
    },
    "ABS塑料": {
        "category": "塑料", "base_color": (0.15, 0.15, 0.15, 1.0),
        "roughness": 0.4, "metallic": 0.0, "specular": 0.45,
    },
    "PVC": {
        "category": "塑料", "base_color": (0.85, 0.85, 0.8, 1.0),
        "roughness": 0.3, "metallic": 0.0, "specular": 0.4,
    },
    "软胶": {
        "category": "塑料", "base_color": (0.2, 0.5, 0.8, 1.0),
        "roughness": 0.35, "metallic": 0.0, "specular": 0.35, "subsurface": 0.1,
    },
    "半透明塑料": {
        "category": "塑料", "base_color": (0.9, 0.5, 0.2, 1.0),
        "roughness": 0.2, "metallic": 0.0, "specular": 0.4,
        "transmission": 0.4, "subsurface": 0.15, "alpha": 0.6,
    },
    # ── 木材类 ──
    "橡木": {
        "category": "木材", "base_color": (0.55, 0.35, 0.15, 1.0),
        "roughness": 0.5, "metallic": 0.0, "specular": 0.4,
        "sheen": 0.5, "sheen_tint": 0.3,
    },
    "胡桃木": {
        "category": "木材", "base_color": (0.3, 0.15, 0.05, 1.0),
        "roughness": 0.4, "metallic": 0.0, "specular": 0.35,
        "sheen": 0.6, "sheen_tint": 0.4,
    },
    "松木": {
        "category": "木材", "base_color": (0.75, 0.6, 0.3, 1.0),
        "roughness": 0.55, "metallic": 0.0, "specular": 0.35,
        "sheen": 0.4, "sheen_tint": 0.2,
    },
    "红木": {
        "category": "木材", "base_color": (0.5, 0.15, 0.05, 1.0),
        "roughness": 0.35, "metallic": 0.0, "specular": 0.4,
        "sheen": 0.7, "sheen_tint": 0.5, "clearcoat": 0.3,
    },
    "樱桃木": {
        "category": "木材", "base_color": (0.6, 0.25, 0.12, 1.0),
        "roughness": 0.4, "metallic": 0.0, "specular": 0.4,
        "sheen": 0.55, "sheen_tint": 0.35,
    },
    "黑檀木": {
        "category": "木材", "base_color": (0.08, 0.05, 0.02, 1.0),
        "roughness": 0.3, "metallic": 0.0, "specular": 0.45,
        "sheen": 0.5, "sheen_tint": 0.2, "clearcoat": 0.4,
    },
    "竹子": {
        "category": "木材", "base_color": (0.5, 0.55, 0.2, 1.0),
        "roughness": 0.5, "metallic": 0.0, "specular": 0.3,
        "sheen": 0.3, "sheen_tint": 0.1,
    },
    "枫木": {
        "category": "木材", "base_color": (0.85, 0.7, 0.45, 1.0),
        "roughness": 0.5, "metallic": 0.0, "specular": 0.35,
        "sheen": 0.35, "sheen_tint": 0.2,
    },
    "柚木": {
        "category": "木材", "base_color": (0.45, 0.3, 0.15, 1.0),
        "roughness": 0.45, "metallic": 0.0, "specular": 0.35,
        "sheen": 0.45, "sheen_tint": 0.3,
    },
    "白蜡木": {
        "category": "木材", "base_color": (0.72, 0.58, 0.38, 1.0),
        "roughness": 0.45, "metallic": 0.0, "specular": 0.38,
        "sheen": 0.4, "sheen_tint": 0.25,
    },
    "桦木": {
        "category": "木材", "base_color": (0.88, 0.78, 0.55, 1.0),
        "roughness": 0.5, "metallic": 0.0, "specular": 0.35,
        "sheen": 0.3, "sheen_tint": 0.15,
    },
    "紫檀木": {
        "category": "木材", "base_color": (0.28, 0.08, 0.04, 1.0),
        "roughness": 0.3, "metallic": 0.0, "specular": 0.45,
        "sheen": 0.7, "sheen_tint": 0.45, "clearcoat": 0.35,
    },
    "水曲柳": {
        "category": "木材", "base_color": (0.62, 0.48, 0.3, 1.0),
        "roughness": 0.48, "metallic": 0.0, "specular": 0.36,
        "sheen": 0.42, "sheen_tint": 0.28,
    },
    "铁力木": {
        "category": "木材", "base_color": (0.15, 0.08, 0.03, 1.0),
        "roughness": 0.28, "metallic": 0.0, "specular": 0.48,
        "sheen": 0.55, "sheen_tint": 0.25, "clearcoat": 0.3,
    },
    "榉木": {
        "category": "木材", "base_color": (0.65, 0.45, 0.25, 1.0),
        "roughness": 0.5, "metallic": 0.0, "specular": 0.35,
        "sheen": 0.38, "sheen_tint": 0.22,
    },
    "红杉木": {
        "category": "木材", "base_color": (0.55, 0.28, 0.18, 1.0),
        "roughness": 0.52, "metallic": 0.0, "specular": 0.32,
        "sheen": 0.45, "sheen_tint": 0.3,
    },
    "橡木深色": {
        "category": "木材", "base_color": (0.35, 0.2, 0.1, 1.0),
        "roughness": 0.42, "metallic": 0.0, "specular": 0.42,
        "sheen": 0.55, "sheen_tint": 0.35, "clearcoat": 0.2,
    },
    "花梨木": {
        "category": "木材", "base_color": (0.42, 0.18, 0.07, 1.0),
        "roughness": 0.33, "metallic": 0.0, "specular": 0.43,
        "sheen": 0.65, "sheen_tint": 0.4, "clearcoat": 0.25,
    },
    "桃花心木": {
        "category": "木材", "base_color": (0.48, 0.2, 0.12, 1.0),
        "roughness": 0.38, "metallic": 0.0, "specular": 0.4,
        "sheen": 0.5, "sheen_tint": 0.35,
    },
    "梣木": {
        "category": "木材", "base_color": (0.78, 0.65, 0.42, 1.0),
        "roughness": 0.47, "metallic": 0.0, "specular": 0.37,
        "sheen": 0.38, "sheen_tint": 0.22,
    },
    "鸡翅木": {
        "category": "木材", "base_color": (0.2, 0.12, 0.06, 1.0),
        "roughness": 0.35, "metallic": 0.0, "specular": 0.4,
        "sheen": 0.5, "sheen_tint": 0.3, "clearcoat": 0.3,
    },
    # ── 石材类 ──
    "大理石": {
        "category": "石材", "base_color": (0.92, 0.9, 0.85, 1.0),
        "roughness": 0.2, "metallic": 0.0, "specular": 0.5, "subsurface": 0.15,
    },
    "花岗岩": {
        "category": "石材", "base_color": (0.35, 0.33, 0.3, 1.0),
        "roughness": 0.35, "metallic": 0.0, "specular": 0.4,
        "clearcoat": 0.5, "clearcoat_roughness": 0.3,
    },
    "砂岩": {
        "category": "石材", "base_color": (0.7, 0.55, 0.35, 1.0),
        "roughness": 0.6, "metallic": 0.0, "specular": 0.2,
    },
    "板岩": {
        "category": "石材", "base_color": (0.25, 0.25, 0.27, 1.0),
        "roughness": 0.5, "metallic": 0.0, "specular": 0.25,
        "clearcoat": 0.15, "clearcoat_roughness": 0.4,
    },
    "石灰石": {
        "category": "石材", "base_color": (0.78, 0.75, 0.68, 1.0),
        "roughness": 0.45, "metallic": 0.0, "specular": 0.3,
    },
    "玉石": {
        "category": "石材", "base_color": (0.55, 0.7, 0.45, 1.0),
        "roughness": 0.1, "metallic": 0.0, "specular": 0.5,
        "subsurface": 0.25, "transmission": 0.15, "ior": 1.3,
    },
    "黑曜石": {
        "category": "石材", "base_color": (0.05, 0.05, 0.05, 1.0),
        "roughness": 0.08, "metallic": 0.0, "specular": 0.6,
        "clearcoat": 0.7, "clearcoat_roughness": 0.02,
    },
    "鹅卵石": {
        "category": "石材", "base_color": (0.5, 0.48, 0.45, 1.0),
        "roughness": 0.3, "metallic": 0.0, "specular": 0.35,
        "clearcoat": 0.2, "clearcoat_roughness": 0.2,
    },
    # ── 陶瓷类 ──
    "白瓷": {
        "category": "陶瓷", "base_color": (0.95, 0.93, 0.9, 1.0),
        "roughness": 0.1, "metallic": 0.0, "specular": 0.6,
        "clearcoat": 0.4, "subsurface": 0.1,
    },
    "细瓷": {
        "category": "陶瓷", "base_color": (0.9, 0.88, 0.85, 1.0),
        "roughness": 0.05, "metallic": 0.0, "specular": 0.7,
        "clearcoat": 0.6, "subsurface": 0.15,
    },
    "红陶": {
        "category": "陶瓷", "base_color": (0.65, 0.3, 0.18, 1.0),
        "roughness": 0.5, "metallic": 0.0, "specular": 0.25,
    },
    "青瓷": {
        "category": "陶瓷", "base_color": (0.6, 0.75, 0.65, 1.0),
        "roughness": 0.08, "metallic": 0.0, "specular": 0.6,
        "clearcoat": 0.5, "subsurface": 0.1,
    },
    "骨瓷": {
        "category": "陶瓷", "base_color": (0.93, 0.9, 0.85, 1.0),
        "roughness": 0.03, "metallic": 0.0, "specular": 0.65,
        "transmission": 0.15, "subsurface": 0.2,
    },
    "粗陶": {
        "category": "陶瓷", "base_color": (0.55, 0.35, 0.2, 1.0),
        "roughness": 0.65, "metallic": 0.0, "specular": 0.15,
    },
    "紫砂": {
        "category": "陶瓷", "base_color": (0.4, 0.18, 0.1, 1.0),
        "roughness": 0.45, "metallic": 0.0, "specular": 0.2,
        "subsurface": 0.05,
    },
    # ── 橡胶类 ──
    "黑色橡胶": {
        "category": "橡胶", "base_color": (0.05, 0.05, 0.05, 1.0),
        "roughness": 0.85, "metallic": 0.0, "specular": 0.1,
    },
    "彩色橡胶": {
        "category": "橡胶", "base_color": (0.15, 0.4, 0.7, 1.0),
        "roughness": 0.75, "metallic": 0.0, "specular": 0.15,
    },
    "硅胶": {
        "category": "橡胶", "base_color": (0.9, 0.9, 0.9, 1.0),
        "roughness": 0.55, "metallic": 0.0, "specular": 0.2, "subsurface": 0.15,
    },
    "泡沫": {
        "category": "橡胶", "base_color": (0.85, 0.85, 0.82, 1.0),
        "roughness": 0.9, "metallic": 0.0, "specular": 0.05, "sheen": 1.0, "sheen_tint": 0.5,
    },
    "轮胎橡胶": {
        "category": "橡胶", "base_color": (0.03, 0.03, 0.03, 1.0),
        "roughness": 0.6, "metallic": 0.0, "specular": 0.08,
    },
    "半透明硅胶": {
        "category": "橡胶", "base_color": (0.95, 0.9, 0.85, 1.0),
        "roughness": 0.4, "metallic": 0.0, "specular": 0.25,
        "subsurface": 0.25, "transmission": 0.1, "alpha": 0.7,
    },
    # ── 织物类 ──
    "天鹅绒": {
        "category": "织物", "base_color": (0.6, 0.1, 0.1, 1.0),
        "roughness": 0.7, "metallic": 0.0, "specular": 0.1,
        "sheen": 8.0, "sheen_tint": 0.5,
    },
    "棉布": {
        "category": "织物", "base_color": (0.9, 0.9, 0.85, 1.0),
        "roughness": 0.9, "metallic": 0.0, "specular": 0.05,
        "sheen": 2.0, "sheen_tint": 0.3,
    },
    "丝绸": {
        "category": "织物", "base_color": (0.15, 0.15, 0.55, 1.0),
        "roughness": 0.25, "metallic": 0.0, "specular": 0.5,
        "sheen": 6.0, "sheen_tint": 0.6, "clearcoat": 0.3,
    },
    "皮革": {
        "category": "织物", "base_color": (0.35, 0.15, 0.05, 1.0),
        "roughness": 0.4, "metallic": 0.0, "specular": 0.3,
        "sheen": 0.5, "sheen_tint": 0.3, "subsurface": 0.1,
    },
    "牛仔布": {
        "category": "织物", "base_color": (0.15, 0.2, 0.45, 1.0),
        "roughness": 0.85, "metallic": 0.0, "specular": 0.05,
        "sheen": 1.0, "sheen_tint": 0.2,
    },
    "羊毛": {
        "category": "织物", "base_color": (0.7, 0.65, 0.55, 1.0),
        "roughness": 0.95, "metallic": 0.0, "specular": 0.03,
        "sheen": 3.0, "sheen_tint": 0.4,
    },
    "绒面革": {
        "category": "织物", "base_color": (0.55, 0.35, 0.2, 1.0),
        "roughness": 0.75, "metallic": 0.0, "specular": 0.08,
        "sheen": 4.0, "sheen_tint": 0.5,
    },
    "麻布": {
        "category": "织物", "base_color": (0.75, 0.68, 0.55, 1.0),
        "roughness": 0.9, "metallic": 0.0, "specular": 0.05,
        "sheen": 1.5, "sheen_tint": 0.25,
    },
    # ── 发光类 ──
    "红色霓虹": {
        "category": "发光", "base_color": (1.0, 0.05, 0.05, 1.0),
        "roughness": 0.3, "metallic": 0.0, "specular": 0.2,
        "emission_color": (1.0, 0.05, 0.05, 1.0), "emission_strength": 15.0,
    },
    "蓝色霓虹": {
        "category": "发光", "base_color": (0.05, 0.1, 1.0, 1.0),
        "roughness": 0.3, "metallic": 0.0, "specular": 0.2,
        "emission_color": (0.05, 0.1, 1.0, 1.0), "emission_strength": 15.0,
    },
    "绿色霓虹": {
        "category": "发光", "base_color": (0.05, 1.0, 0.1, 1.0),
        "roughness": 0.3, "metallic": 0.0, "specular": 0.2,
        "emission_color": (0.05, 1.0, 0.1, 1.0), "emission_strength": 15.0,
    },
    "粉色霓虹": {
        "category": "发光", "base_color": (1.0, 0.1, 0.5, 1.0),
        "roughness": 0.3, "metallic": 0.0, "specular": 0.2,
        "emission_color": (1.0, 0.1, 0.5, 1.0), "emission_strength": 12.0,
    },
    "白色LED": {
        "category": "发光", "base_color": (1.0, 1.0, 1.0, 1.0),
        "roughness": 0.2, "metallic": 0.0, "specular": 0.1,
        "emission_color": (1.0, 1.0, 1.0, 1.0), "emission_strength": 5.0,
    },
    "暖黄灯": {
        "category": "发光", "base_color": (1.0, 0.85, 0.5, 1.0),
        "roughness": 0.2, "metallic": 0.0, "specular": 0.1,
        "emission_color": (1.0, 0.75, 0.3, 1.0), "emission_strength": 5.0,
    },
    "冷白灯": {
        "category": "发光", "base_color": (0.8, 0.85, 1.0, 1.0),
        "roughness": 0.2, "metallic": 0.0, "specular": 0.1,
        "emission_color": (0.8, 0.85, 1.0, 1.0), "emission_strength": 8.0,
    },
    "橙色警示灯": {
        "category": "发光", "base_color": (1.0, 0.4, 0.05, 1.0),
        "roughness": 0.3, "metallic": 0.0, "specular": 0.15,
        "emission_color": (1.0, 0.4, 0.05, 1.0), "emission_strength": 10.0,
    },
    # ── 车漆类 ──
    "红色金属漆": {
        "category": "车漆", "base_color": (0.8, 0.1, 0.1, 1.0),
        "roughness": 0.05, "metallic": 0.3, "specular": 0.5,
        "clearcoat": 1.0, "clearcoat_roughness": 0.03,
    },
    "珍珠白车漆": {
        "category": "车漆", "base_color": (0.9, 0.9, 0.95, 1.0),
        "roughness": 0.05, "metallic": 0.5, "specular": 0.5,
        "clearcoat": 1.0, "clearcoat_roughness": 0.02, "specular_tint": 0.4,
    },
    "蓝色金属漆": {
        "category": "车漆", "base_color": (0.1, 0.2, 0.7, 1.0),
        "roughness": 0.05, "metallic": 0.35, "specular": 0.5,
        "clearcoat": 1.0, "clearcoat_roughness": 0.03,
    },
    "哑光黑漆": {
        "category": "车漆", "base_color": (0.05, 0.05, 0.05, 1.0),
        "roughness": 0.4, "metallic": 0.0, "specular": 0.3,
        "clearcoat": 0.5, "clearcoat_roughness": 0.5,
    },
    "变色龙漆": {
        "category": "车漆", "base_color": (0.3, 0.15, 0.5, 1.0),
        "roughness": 0.05, "metallic": 0.6, "specular": 0.5,
        "clearcoat": 1.0, "clearcoat_roughness": 0.02, "specular_tint": 0.6,
    },
    "赛车绿": {
        "category": "车漆", "base_color": (0.05, 0.2, 0.08, 1.0),
        "roughness": 0.05, "metallic": 0.25, "specular": 0.5,
        "clearcoat": 1.0, "clearcoat_roughness": 0.03,
    },
    "亮黄色车漆": {
        "category": "车漆", "base_color": (0.95, 0.75, 0.05, 1.0),
        "roughness": 0.05, "metallic": 0.2, "specular": 0.5,
        "clearcoat": 1.0, "clearcoat_roughness": 0.03,
    },
    # ── 有机类 ──
    "皮肤": {
        "category": "有机", "base_color": (0.85, 0.65, 0.55, 1.0),
        "roughness": 0.55, "metallic": 0.0, "specular": 0.35, "subsurface": 0.3,
    },
    "象牙": {
        "category": "有机", "base_color": (0.95, 0.88, 0.72, 1.0),
        "roughness": 0.15, "metallic": 0.0, "specular": 0.4, "subsurface": 0.2,
    },
    "蜜蜡": {
        "category": "有机", "base_color": (0.8, 0.55, 0.2, 1.0),
        "roughness": 0.25, "metallic": 0.0, "specular": 0.3,
        "subsurface": 0.35, "transmission": 0.2,
    },
    "骨头": {
        "category": "有机", "base_color": (0.88, 0.82, 0.7, 1.0),
        "roughness": 0.3, "metallic": 0.0, "specular": 0.3, "subsurface": 0.15,
    },
    "珍珠母": {
        "category": "有机", "base_color": (0.9, 0.85, 0.78, 1.0),
        "roughness": 0.1, "metallic": 0.0, "specular": 0.55,
        "clearcoat": 0.6, "subsurface": 0.15, "specular_tint": 0.3,
    },
    "珊瑚": {
        "category": "有机", "base_color": (0.9, 0.3, 0.25, 1.0),
        "roughness": 0.3, "metallic": 0.0, "specular": 0.3, "subsurface": 0.2,
    },
    # ── 液体类 ──
    "清水": {
        "category": "液体", "base_color": (0.98, 0.98, 1.0, 1.0),
        "roughness": 0.0, "metallic": 0.0, "specular": 0.5,
        "transmission": 0.95, "ior": 1.33, "alpha": 0.0,
    },
    "海水": {
        "category": "液体", "base_color": (0.1, 0.4, 0.65, 1.0),
        "roughness": 0.05, "metallic": 0.0, "specular": 0.5,
        "transmission": 0.7, "ior": 1.34, "alpha": 0.05,
    },
    "蜂蜜": {
        "category": "液体", "base_color": (0.75, 0.45, 0.08, 1.0),
        "roughness": 0.1, "metallic": 0.0, "specular": 0.4,
        "transmission": 0.5, "ior": 1.5, "subsurface": 0.2, "alpha": 0.1,
    },
    "牛奶": {
        "category": "液体", "base_color": (0.95, 0.93, 0.88, 1.0),
        "roughness": 0.15, "metallic": 0.0, "specular": 0.35,
        "subsurface": 0.5, "transmission": 0.15, "ior": 1.35, "alpha": 0.3,
    },
    "油": {
        "category": "液体", "base_color": (0.7, 0.55, 0.15, 1.0),
        "roughness": 0.05, "metallic": 0.0, "specular": 0.45,
        "transmission": 0.6, "ior": 1.47, "alpha": 0.05,
    },
    "水银": {
        "category": "液体", "base_color": (0.75, 0.75, 0.78, 1.0),
        "roughness": 0.02, "metallic": 1.0, "specular": 0.55,
        "ior": 1.6, "alpha": 0.0,
    },
    "红酒": {
        "category": "液体", "base_color": (0.35, 0.02, 0.05, 1.0),
        "roughness": 0.05, "metallic": 0.0, "specular": 0.4,
        "transmission": 0.55, "ior": 1.34, "alpha": 0.08,
    },
    "可乐": {
        "category": "液体", "base_color": (0.15, 0.05, 0.02, 1.0),
        "roughness": 0.05, "metallic": 0.0, "specular": 0.4,
        "transmission": 0.45, "ior": 1.34, "alpha": 0.1,
    },
    # ── 冰雪类 ──
    "冰块": {
        "category": "冰雪", "base_color": (0.92, 0.95, 0.98, 1.0),
        "roughness": 0.08, "metallic": 0.0, "specular": 0.5,
        "transmission": 0.9, "ior": 1.31, "alpha": 0.0, "clearcoat": 0.2,
    },
    "新雪": {
        "category": "冰雪", "base_color": (0.98, 0.98, 0.98, 1.0),
        "roughness": 0.7, "metallic": 0.0, "specular": 0.15,
        "sheen": 4.0, "sheen_tint": 0.2, "subsurface": 0.3,
    },
    "积雪": {
        "category": "冰雪", "base_color": (0.92, 0.93, 0.94, 1.0),
        "roughness": 0.6, "metallic": 0.0, "specular": 0.2,
        "subsurface": 0.25, "sheen": 2.0, "sheen_tint": 0.1,
    },
    "冰霜": {
        "category": "冰雪", "base_color": (0.85, 0.9, 0.95, 1.0),
        "roughness": 0.35, "metallic": 0.0, "specular": 0.3,
        "transmission": 0.3, "ior": 1.31, "alpha": 0.15,
        "clearcoat": 0.1, "clearcoat_roughness": 0.4,
    },
    "极地冰": {
        "category": "冰雪", "base_color": (0.78, 0.85, 0.95, 1.0),
        "roughness": 0.05, "metallic": 0.0, "specular": 0.5,
        "transmission": 0.85, "ior": 1.31, "alpha": 0.02, "subsurface": 0.1,
    },
    # ── 宝石类 ──
    "钻石": {
        "category": "宝石", "base_color": (1.0, 1.0, 1.0, 1.0),
        "roughness": 0.0, "metallic": 0.0, "specular": 0.6,
        "transmission": 0.95, "ior": 2.42, "alpha": 0.0,
    },
    "红宝石": {
        "category": "宝石", "base_color": (0.85, 0.05, 0.1, 1.0),
        "roughness": 0.02, "metallic": 0.0, "specular": 0.55,
        "transmission": 0.75, "ior": 1.77, "alpha": 0.02,
    },
    "蓝宝石": {
        "category": "宝石", "base_color": (0.05, 0.1, 0.7, 1.0),
        "roughness": 0.02, "metallic": 0.0, "specular": 0.55,
        "transmission": 0.75, "ior": 1.77, "alpha": 0.02,
    },
    "祖母绿": {
        "category": "宝石", "base_color": (0.05, 0.55, 0.15, 1.0),
        "roughness": 0.02, "metallic": 0.0, "specular": 0.55,
        "transmission": 0.7, "ior": 1.58, "alpha": 0.02,
    },
    "紫水晶": {
        "category": "宝石", "base_color": (0.45, 0.15, 0.55, 1.0),
        "roughness": 0.03, "metallic": 0.0, "specular": 0.55,
        "transmission": 0.7, "ior": 1.55, "alpha": 0.03,
    },
    "黄水晶": {
        "category": "宝石", "base_color": (0.75, 0.5, 0.05, 1.0),
        "roughness": 0.03, "metallic": 0.0, "specular": 0.55,
        "transmission": 0.7, "ior": 1.55, "alpha": 0.03,
    },
    "石榴石": {
        "category": "宝石", "base_color": (0.55, 0.02, 0.05, 1.0),
        "roughness": 0.03, "metallic": 0.0, "specular": 0.5,
        "transmission": 0.65, "ior": 1.73, "alpha": 0.03,
    },
    "蛋白石": {
        "category": "宝石", "base_color": (0.85, 0.8, 0.9, 1.0),
        "roughness": 0.05, "metallic": 0.0, "specular": 0.55,
        "transmission": 0.4, "ior": 1.45, "alpha": 0.05,
        "subsurface": 0.2, "clearcoat": 0.5,
    },
    # ── 食物类 ──
    "黑巧克力": {
        "category": "食物", "base_color": (0.15, 0.06, 0.02, 1.0),
        "roughness": 0.35, "metallic": 0.0, "specular": 0.3, "subsurface": 0.1,
    },
    "牛奶巧克力": {
        "category": "食物", "base_color": (0.35, 0.18, 0.08, 1.0),
        "roughness": 0.3, "metallic": 0.0, "specular": 0.3, "subsurface": 0.15,
    },
    "焦糖": {
        "category": "食物", "base_color": (0.55, 0.25, 0.05, 1.0),
        "roughness": 0.15, "metallic": 0.0, "specular": 0.35, "subsurface": 0.3,
    },
    "面包皮": {
        "category": "食物", "base_color": (0.55, 0.3, 0.1, 1.0),
        "roughness": 0.7, "metallic": 0.0, "specular": 0.1,
        "sheen": 1.5, "sheen_tint": 0.3,
    },
    "奶酪": {
        "category": "食物", "base_color": (0.9, 0.7, 0.15, 1.0),
        "roughness": 0.25, "metallic": 0.0, "specular": 0.3, "subsurface": 0.35,
    },
    "黄油": {
        "category": "食物", "base_color": (0.95, 0.85, 0.3, 1.0),
        "roughness": 0.2, "metallic": 0.0, "specular": 0.35,
        "subsurface": 0.4, "transmission": 0.1,
    },
    "草莓酱": {
        "category": "食物", "base_color": (0.65, 0.05, 0.05, 1.0),
        "roughness": 0.2, "metallic": 0.0, "specular": 0.3,
        "subsurface": 0.35, "transmission": 0.1, "alpha": 0.5,
    },
    "生肉": {
        "category": "食物", "base_color": (0.6, 0.15, 0.1, 1.0),
        "roughness": 0.4, "metallic": 0.0, "specular": 0.25, "subsurface": 0.3,
    },
    # ── 纸张类 ──
    "打印纸": {
        "category": "纸张", "base_color": (0.95, 0.95, 0.93, 1.0),
        "roughness": 0.65, "metallic": 0.0, "specular": 0.1,
        "sheen": 1.0, "sheen_tint": 0.2,
    },
    "牛皮纸": {
        "category": "纸张", "base_color": (0.65, 0.5, 0.3, 1.0),
        "roughness": 0.7, "metallic": 0.0, "specular": 0.08,
        "sheen": 0.5, "sheen_tint": 0.3,
    },
    "硬纸板": {
        "category": "纸张", "base_color": (0.5, 0.38, 0.22, 1.0),
        "roughness": 0.8, "metallic": 0.0, "specular": 0.05,
        "sheen": 0.3, "sheen_tint": 0.2,
    },
    "铜版纸": {
        "category": "纸张", "base_color": (0.92, 0.9, 0.85, 1.0),
        "roughness": 0.2, "metallic": 0.0, "specular": 0.35,
        "sheen": 1.5, "sheen_tint": 0.1, "clearcoat": 0.2,
    },
    "旧报纸": {
        "category": "纸张", "base_color": (0.72, 0.65, 0.45, 1.0),
        "roughness": 0.75, "metallic": 0.0, "specular": 0.05,
        "sheen": 0.4, "sheen_tint": 0.4,
    },
    "餐巾纸": {
        "category": "纸张", "base_color": (0.93, 0.92, 0.88, 1.0),
        "roughness": 0.85, "metallic": 0.0, "specular": 0.03,
        "sheen": 3.0, "sheen_tint": 0.3, "alpha": 0.8,
    },
    # ── 涂层类 ──
    "清漆": {
        "category": "涂层", "base_color": (1.0, 1.0, 1.0, 1.0),
        "roughness": 0.03, "metallic": 0.0, "specular": 0.55,
        "clearcoat": 0.9, "transmission": 0.15, "ior": 1.5, "alpha": 0.1,
    },
    "哑光漆": {
        "category": "涂层", "base_color": (0.9, 0.9, 0.9, 1.0),
        "roughness": 0.5, "metallic": 0.0, "specular": 0.3,
        "clearcoat": 0.6, "clearcoat_roughness": 0.5,
    },
    "珐琅": {
        "category": "涂层", "base_color": (0.15, 0.25, 0.45, 1.0),
        "roughness": 0.05, "metallic": 0.0, "specular": 0.6,
        "clearcoat": 0.8, "clearcoat_roughness": 0.02, "subsurface": 0.1,
    },
    "镀锌": {
        "category": "涂层", "base_color": (0.75, 0.75, 0.75, 1.0),
        "roughness": 0.2, "metallic": 0.9, "specular": 0.45,
        "clearcoat": 0.1, "clearcoat_roughness": 0.3,
    },
    "氧化层": {
        "category": "涂层", "base_color": (0.5, 0.45, 0.35, 1.0),
        "roughness": 0.5, "metallic": 0.6, "specular": 0.2,
        "sheen": 1.0, "sheen_tint": 0.5,
    },
    "粉末涂层": {
        "category": "涂层", "base_color": (0.15, 0.15, 0.18, 1.0),
        "roughness": 0.35, "metallic": 0.0, "specular": 0.25,
        "sheen": 0.5, "sheen_tint": 0.1, "clearcoat": 0.15,
    },
    "皱纹漆": {
        "category": "涂层", "base_color": (0.2, 0.2, 0.2, 1.0),
        "roughness": 0.6, "metallic": 0.0, "specular": 0.15,
        "clearcoat": 0.1, "clearcoat_roughness": 0.7, "sheen": 2.0, "sheen_tint": 0.3,
    },
    # ── 镜子类 ──
    "银镜": {
        "category": "镜子", "base_color": (0.95, 0.95, 0.97, 1.0),
        "roughness": 0.02, "metallic": 1.0, "specular": 0.5,
    },
    "镀铬镜": {
        "category": "镜子", "base_color": (0.88, 0.9, 0.95, 1.0),
        "roughness": 0.01, "metallic": 1.0, "specular": 0.5, "clearcoat": 0.1,
    },
    "铜镜": {
        "category": "镜子", "base_color": (0.9, 0.55, 0.35, 1.0),
        "roughness": 0.04, "metallic": 1.0, "specular": 0.48,
    },
    "金镜": {
        "category": "镜子", "base_color": (0.95, 0.75, 0.2, 1.0),
        "roughness": 0.03, "metallic": 1.0, "specular": 0.5,
    },
    "玻璃镜": {
        "category": "镜子", "base_color": (0.92, 0.94, 0.95, 1.0),
        "roughness": 0.01, "metallic": 1.0, "specular": 0.5,
        "clearcoat": 0.5, "clearcoat_roughness": 0.01,
    },
    "黑镜": {
        "category": "镜子", "base_color": (0.15, 0.15, 0.18, 1.0),
        "roughness": 0.02, "metallic": 1.0, "specular": 0.5,
    },
    "复古镜": {
        "category": "镜子", "base_color": (0.85, 0.82, 0.75, 1.0),
        "roughness": 0.08, "metallic": 1.0, "specular": 0.45,
        "sheen": 0.5, "sheen_tint": 0.4,
    },
    "烟熏镜": {
        "category": "镜子", "base_color": (0.4, 0.4, 0.45, 1.0),
        "roughness": 0.03, "metallic": 1.0, "specular": 0.5,
    },
}


CUSTOM_PRESETS = {}  # 从 JSON 加载的自定义预设

_PRESETS_DIR = os.path.dirname(os.path.realpath(__file__))
_PRESETS_FILE = os.path.join(_PRESETS_DIR, "material_manager_presets.json")


def _load_custom_presets():
    """从 JSON 文件加载自定义预设"""
    global CUSTOM_PRESETS
    if os.path.exists(_PRESETS_FILE):
        try:
            with open(_PRESETS_FILE, "r", encoding="utf-8") as f:
                data = json.load(f)
            for name, preset in data.items():
                # 恢复 tuple
                for key in ("base_color", "emission_color"):
                    if key in preset:
                        preset[key] = tuple(preset[key])
                CUSTOM_PRESETS[name] = preset
        except (json.JSONDecodeError, OSError):
            pass


def _save_custom_presets():
    """保存自定义预设到 JSON 文件"""
    data = {}
    for name, preset in CUSTOM_PRESETS.items():
        entry = dict(preset)
        for key in ("base_color", "emission_color"):
            if key in entry and hasattr(entry[key], "__iter__"):
                entry[key] = list(entry[key])
        data[name] = entry
    try:
        with open(_PRESETS_FILE, "w", encoding="utf-8") as f:
            json.dump(data, f, ensure_ascii=False, indent=2)
    except OSError:
        pass


def _get_all_presets():
    """合并内置预设 + 自定义预设"""
    merged = dict(PRESET_MATERIALS)
    merged.update(CUSTOM_PRESETS)
    return merged


def get_categories(self, context):
    cats = sorted(set(p["category"] for p in PRESET_MATERIALS.values()))
    custom_cats = sorted(set(p["category"] for p in CUSTOM_PRESETS.values()))
    for c in custom_cats:
        if c not in cats:
            cats.append(c)
    items = [("ALL", "全部", "显示所有预设")]
    for c in cats:
        items.append((c, c, f"{c}类材质"))
    return items


PBR_ASSET_ROOT_DEFAULT = "D:/blenderwork/material-assets"
PBR_MANIFEST_FILENAME = "manifest.json"
_PBR_MANIFEST_CACHE = {}


def _normalize_asset_root(asset_root):
    root = asset_root.strip() if asset_root else PBR_ASSET_ROOT_DEFAULT
    return bpy.path.abspath(root)


def _load_pbr_manifest(asset_root):
    """读取真实 PBR 材质库 manifest。"""
    root = _normalize_asset_root(asset_root)
    manifest_path = os.path.join(root, PBR_MANIFEST_FILENAME)
    if not os.path.exists(manifest_path):
        return {"version": 1, "root": root, "materials": []}

    try:
        mtime = os.path.getmtime(manifest_path)
    except OSError:
        mtime = None

    cached = _PBR_MANIFEST_CACHE.get(manifest_path)
    if cached and cached.get("mtime") == mtime:
        return cached["data"]

    try:
        with open(manifest_path, "r", encoding="utf-8") as f:
            data = json.load(f)
    except (json.JSONDecodeError, OSError):
        data = {"version": 1, "root": root, "materials": []}

    data.setdefault("materials", [])
    _PBR_MANIFEST_CACHE[manifest_path] = {"mtime": mtime, "data": data}
    return data


def _get_pbr_asset_root(context):
    props = getattr(context.scene, "matmgr_props", None) if context and context.scene else None
    if props and getattr(props, "pbr_asset_root", ""):
        return _normalize_asset_root(props.pbr_asset_root)
    return PBR_ASSET_ROOT_DEFAULT


def _resolve_asset_path(asset_root, relative_path):
    if not relative_path:
        return ""
    if os.path.isabs(relative_path):
        return relative_path
    return os.path.normpath(os.path.join(_normalize_asset_root(asset_root), relative_path))


def _validate_pbr_asset_entry(entry, asset_root):
    maps = entry.get("maps", {}) if isinstance(entry, dict) else {}
    if not entry.get("id") or not maps:
        return False
    for rel_path in maps.values():
        if rel_path and os.path.exists(_resolve_asset_path(asset_root, rel_path)):
            return True
    return False


def _get_pbr_materials(context):
    asset_root = _get_pbr_asset_root(context)
    manifest = _load_pbr_manifest(asset_root)
    materials = []
    for entry in manifest.get("materials", []):
        if _validate_pbr_asset_entry(entry, asset_root):
            materials.append(entry)
    return materials


def _get_pbr_categories(self, context):
    materials = _get_pbr_materials(context)
    cats = sorted(set(entry.get("category", "其他") for entry in materials))
    items = [("ALL", "全部", "显示所有真实材质")]
    for c in cats:
        items.append((c, c, f"{c}类真实材质"))
    return items


# ═══════════════════════════════════════════════════════════
#  属性组 — 自定义材质参数
# ═══════════════════════════════════════════════════════════

class MaterialParamsProperty(PropertyGroup):
    """存储自定义材质参数"""
    name: StringProperty(name="名称", default="New Material")

    base_color: FloatVectorProperty(
        name="基础色", subtype="COLOR",
        default=(0.8, 0.8, 0.8, 1.0), size=4,
        min=0.0, max=1.0,
    )
    roughness: FloatProperty(
        name="粗糙度", default=0.4,
        min=0.0, max=1.0, precision=3,
    )
    metallic: FloatProperty(
        name="金属度", default=0.0,
        min=0.0, max=1.0, precision=3,
    )
    specular: FloatProperty(
        name="高光强度", default=0.5,
        min=0.0, max=1.0, precision=3,
    )
    specular_tint: FloatProperty(
        name="高光染色", default=0.0,
        min=0.0, max=1.0, precision=3,
    )
    transmission: FloatProperty(
        name="透射", default=0.0,
        min=0.0, max=1.0, precision=3,
    )
    ior: FloatProperty(
        name="折射率(IOR)", default=1.45,
        min=1.0, max=3.0, precision=3,
    )
    subsurface: FloatProperty(
        name="次表面散射", default=0.0,
        min=0.0, max=1.0, precision=3,
    )
    clearcoat: FloatProperty(
        name="清漆层", default=0.0,
        min=0.0, max=1.0, precision=3,
    )
    clearcoat_roughness: FloatProperty(
        name="清漆粗糙度", default=0.03,
        min=0.0, max=1.0, precision=3,
    )
    sheen: FloatProperty(
        name="光泽", default=0.0,
        min=0.0, max=100.0, precision=1,
    )
    sheen_tint: FloatProperty(
        name="光泽染色", default=0.5,
        min=0.0, max=1.0, precision=3,
    )
    emission_color: FloatVectorProperty(
        name="自发光颜色", subtype="COLOR",
        default=(0.0, 0.0, 0.0, 1.0), size=4,
        min=0.0, max=1.0,
    )
    emission_strength: FloatProperty(
        name="自发光强度", default=0.0,
        min=0.0, max=1000.0, precision=1,
    )
    alpha: FloatProperty(
        name="透明度", default=1.0,
        min=0.0, max=1.0, precision=3,
    )


# ═══════════════════════════════════════════════════════════
#  辅助函数
# ═══════════════════════════════════════════════════════════

# ── 输入名 → (属性名, 默认值, 转换函数) ──
# 转换函数: None=直接赋值, "rgba_from_float"=float→RGBA, "float_from_rgba"=RGBA→float
_PRINCIPLED_INPUTS = {
    "Base Color":            ("base_color",        (0.8, 0.8, 0.8, 1.0), None),
    "Roughness":             ("roughness",         0.4,                   None),
    "Metallic":              ("metallic",          0.0,                   None),
    "Specular IOR Level":    ("specular",          0.5,                   None),
    "Specular Tint":         ("specular_tint",     0.0,                   "rgba_from_float"),
    "Transmission Weight":   ("transmission",      0.0,                   None),
    "IOR":                   ("ior",               1.45,                  None),
    "Subsurface Weight":     ("subsurface",        0.0,                   None),
    "Coat Weight":           ("clearcoat",         0.0,                   None),
    "Coat Roughness":        ("clearcoat_roughness", 0.03,                None),
    "Sheen Weight":          ("sheen",             0.0,                   None),
    "Sheen Tint":            ("sheen_tint",        0.5,                   "rgba_from_float"),
    "Emission Color":        ("emission_color",    (0.0, 0.0, 0.0, 1.0), None),
    "Emission Strength":     ("emission_strength", 0.0,                   None),
    "Alpha":                 ("alpha",             1.0,                   None),
}

_PRESET_EXPECTED_COUNT = 154
_PRESET_EXPECTED_CATEGORY_COUNT = 18


def _validate_preset_materials():
    """开发用：校验内置预设是否符合当前 Principled BSDF 参数范围。"""
    errors = []
    supported_keys = {"category"}
    supported_keys.update(prop_name for prop_name, _default, _converter in _PRINCIPLED_INPUTS.values())

    if len(PRESET_MATERIALS) != _PRESET_EXPECTED_COUNT:
        errors.append(f"预设数量应为 {_PRESET_EXPECTED_COUNT}，当前为 {len(PRESET_MATERIALS)}")

    categories = {preset.get("category") for preset in PRESET_MATERIALS.values()}
    if len(categories) != _PRESET_EXPECTED_CATEGORY_COUNT:
        errors.append(f"分类数量应为 {_PRESET_EXPECTED_CATEGORY_COUNT}，当前为 {len(categories)}")

    range_checks = {
        "roughness": (0.0, 1.0),
        "metallic": (0.0, 1.0),
        "specular": (0.0, 1.0),
        "specular_tint": (0.0, 1.0),
        "transmission": (0.0, 1.0),
        "ior": (1.0, 3.0),
        "subsurface": (0.0, 1.0),
        "clearcoat": (0.0, 1.0),
        "clearcoat_roughness": (0.0, 1.0),
        "sheen": (0.0, 100.0),
        "sheen_tint": (0.0, 1.0),
        "emission_strength": (0.0, 1000.0),
        "alpha": (0.0, 1.0),
    }

    for name, preset in PRESET_MATERIALS.items():
        for required_key in ("category", "base_color"):
            if required_key not in preset:
                errors.append(f"{name}: 缺少 {required_key}")

        for key in preset:
            if key not in supported_keys:
                errors.append(f"{name}: 不支持的参数 {key}")

        for color_key in ("base_color", "emission_color"):
            if color_key not in preset:
                continue
            color = preset[color_key]
            if not hasattr(color, "__iter__") or len(color) != 4:
                errors.append(f"{name}: {color_key} 必须是 4 通道颜色")
                continue
            for channel in color:
                if not 0.0 <= channel <= 1.0:
                    errors.append(f"{name}: {color_key} 通道超出 0-1 范围")
                    break

        for key, (minimum, maximum) in range_checks.items():
            if key in preset and not minimum <= preset[key] <= maximum:
                errors.append(f"{name}: {key}={preset[key]} 超出 {minimum}-{maximum} 范围")

    return errors


def _set_bsdf_input(bsdf, input_name, prop_name, default, converter, params_dict):
    val = params_dict.get(prop_name, default)
    inp = bsdf.inputs.get(input_name)
    if inp is None:
        return
    if converter == "rgba_from_float":
        inp.default_value = (val, val, val, 1.0)
    else:
        inp.default_value = val


def _get_bsdf_params(bsdf, input_name, prop_name, converter):
    inp = bsdf.inputs.get(input_name)
    if inp is None:
        return (prop_name, None)
    val = inp.default_value
    if converter == "rgba_from_float":
        if hasattr(val, "__getitem__"):
            val = val[0]
        else:
            val = float(val)
    return (prop_name, val)


def _configure_transparency(mat, params_dict):
    """高透射材质自动设置视口透明和折射"""
    transmission = params_dict.get("transmission", 0.0)
    alpha = params_dict.get("alpha", 1.0)

    if transmission > 0.01 or alpha < 0.99:
        mat.blend_method = "HASHED"
        mat.shadow_method = "HASHED"
        if hasattr(mat, "use_screen_refraction"):
            mat.use_screen_refraction = True
        if hasattr(mat, "use_transparent_shadow"):
            mat.use_transparent_shadow = True


def _sync_viewport_color(mat, params_dict):
    """同步实体/材质预览模式使用的材质颜色。"""
    color = params_dict.get("base_color")
    if color is None:
        return
    alpha = params_dict.get("alpha", color[3] if len(color) > 3 else 1.0)
    mat.diffuse_color = (color[0], color[1], color[2], alpha)


def create_principled_material(name, params_dict):
    mat = bpy.data.materials.new(name=name)
    mat.use_nodes = True
    nodes = mat.node_tree.nodes
    links = mat.node_tree.links
    nodes.clear()

    bsdf = nodes.new("ShaderNodeBsdfPrincipled")
    bsdf.location = (0, 0)

    for input_name, (prop_name, default, converter) in _PRINCIPLED_INPUTS.items():
        _set_bsdf_input(bsdf, input_name, prop_name, default, converter, params_dict)

    output = nodes.new("ShaderNodeOutputMaterial")
    output.location = (300, 0)
    links.new(bsdf.outputs["BSDF"], output.inputs["Surface"])

    # 高透射材质 → 自动开启视口透明
    _configure_transparency(mat, params_dict)
    _sync_viewport_color(mat, params_dict)

    return mat


def apply_params_to_material(mat, params_dict):
    if not mat.use_nodes:
        return
    bsdf = None
    for node in mat.node_tree.nodes:
        if node.type == "BSDF_PRINCIPLED":
            bsdf = node
            break
    if bsdf is None:
        return

    for input_name, (prop_name, default, converter) in _PRINCIPLED_INPUTS.items():
        if prop_name in params_dict:
            _set_bsdf_input(bsdf, input_name, prop_name, default, converter, params_dict)

    _configure_transparency(mat, params_dict)
    _sync_viewport_color(mat, params_dict)


def get_params_from_material(mat):
    params = {}
    if not mat.use_nodes:
        return params
    bsdf = None
    for node in mat.node_tree.nodes:
        if node.type == "BSDF_PRINCIPLED":
            bsdf = node
            break
    if bsdf is None:
        return params

    for input_name, (prop_name, _default, converter) in _PRINCIPLED_INPUTS.items():
        key, val = _get_bsdf_params(bsdf, input_name, prop_name, converter)
        if val is not None:
            params[key] = val

    return params


def _get_target_mesh_objects(context):
    """获取要应用材质的网格对象；无选中项时回退到活动对象。"""
    targets = [obj for obj in context.selected_objects if obj.type == "MESH"]
    active = context.object
    if not targets and active and active.type == "MESH":
        targets = [active]
    return targets


def _assign_material_to_objects(mat, objects):
    """把材质写入对象的第一个材质槽。"""
    for obj in objects:
        if obj.data.materials:
            obj.data.materials[0] = mat
        else:
            obj.data.materials.append(mat)


def _refresh_view3d(context):
    screen = getattr(context, "screen", None)
    if not screen:
        return
    for area in screen.areas:
        if area.type == "VIEW_3D":
            area.tag_redraw()


def _find_principled_bsdf(nodes):
    for node in nodes:
        if node.type == "BSDF_PRINCIPLED":
            return node
    return None


def _set_image_colorspace(image, colorspace):
    if not image or not colorspace:
        return
    try:
        image.colorspace_settings.name = colorspace
    except TypeError:
        pass


def _create_image_texture_node(nodes, image_path, label, colorspace, pack_image=False):
    if not image_path or not os.path.exists(image_path):
        return None
    image = bpy.data.images.load(image_path, check_existing=True)
    _set_image_colorspace(image, colorspace)
    if pack_image:
        try:
            image.pack()
        except RuntimeError:
            pass
    tex = nodes.new("ShaderNodeTexImage")
    tex.label = label
    tex.name = label
    tex.image = image
    return tex


def _link_texture_vector(links, mapping, tex):
    if mapping and tex and "Vector" in tex.inputs:
        links.new(mapping.outputs["Vector"], tex.inputs["Vector"])


def _apply_pbr_metadata(mat, asset_entry, asset_root):
    mat["matmgr_pbr_id"] = asset_entry.get("id", "")
    mat["matmgr_source"] = asset_entry.get("source", "")
    mat["matmgr_source_url"] = asset_entry.get("source_url", "")
    mat["matmgr_license"] = asset_entry.get("license", "")
    mat["matmgr_asset_root"] = asset_root


def create_pbr_material(asset_entry, asset_root, options=None):
    """根据 manifest 条目创建真实 PBR 贴图材质。"""
    options = options or {}
    maps = asset_entry.get("maps", {})
    name = asset_entry.get("name_zh") or asset_entry.get("name") or asset_entry.get("id") or "PBR Material"

    mat = bpy.data.materials.new(name=name)
    mat.use_nodes = True
    nodes = mat.node_tree.nodes
    links = mat.node_tree.links
    nodes.clear()

    bsdf = nodes.new("ShaderNodeBsdfPrincipled")
    bsdf.location = (0, 0)
    output = nodes.new("ShaderNodeOutputMaterial")
    output.location = (500, 0)
    links.new(bsdf.outputs["BSDF"], output.inputs["Surface"])

    tex_coord = nodes.new("ShaderNodeTexCoord")
    tex_coord.location = (-900, 0)
    mapping = nodes.new("ShaderNodeMapping")
    mapping.location = (-700, 0)
    scale = float(asset_entry.get("scale", 1.0) or 1.0)
    mapping.inputs["Scale"].default_value = (scale, scale, scale)
    links.new(tex_coord.outputs["UV"], mapping.inputs["Vector"])

    pack_image = bool(options.get("pack_images", False))
    defaults = asset_entry.get("defaults", {})
    if "Roughness" in bsdf.inputs:
        bsdf.inputs["Roughness"].default_value = defaults.get("roughness", 0.5)
    if "Metallic" in bsdf.inputs:
        bsdf.inputs["Metallic"].default_value = defaults.get("metallic", 0.0)
    if "Specular IOR Level" in bsdf.inputs:
        bsdf.inputs["Specular IOR Level"].default_value = defaults.get("specular", 0.5)

    y = 250
    base_tex = _create_image_texture_node(nodes, _resolve_asset_path(asset_root, maps.get("base_color")), "Base Color", "sRGB", pack_image)
    if base_tex:
        base_tex.location = (-450, y)
        _link_texture_vector(links, mapping, base_tex)
        links.new(base_tex.outputs["Color"], bsdf.inputs["Base Color"])
        y -= 220

    rough_tex = _create_image_texture_node(nodes, _resolve_asset_path(asset_root, maps.get("roughness")), "Roughness", "Non-Color", pack_image)
    if rough_tex:
        rough_tex.location = (-450, y)
        _link_texture_vector(links, mapping, rough_tex)
        links.new(rough_tex.outputs["Color"], bsdf.inputs["Roughness"])
        y -= 220

    metal_tex = _create_image_texture_node(nodes, _resolve_asset_path(asset_root, maps.get("metallic")), "Metallic", "Non-Color", pack_image)
    if metal_tex:
        metal_tex.location = (-450, y)
        _link_texture_vector(links, mapping, metal_tex)
        links.new(metal_tex.outputs["Color"], bsdf.inputs["Metallic"])
        y -= 220

    normal_output = None
    normal_tex = _create_image_texture_node(nodes, _resolve_asset_path(asset_root, maps.get("normal")), "Normal", "Non-Color", pack_image)
    if normal_tex:
        normal_tex.location = (-450, y)
        _link_texture_vector(links, mapping, normal_tex)
        normal_map = nodes.new("ShaderNodeNormalMap")
        normal_map.location = (-180, y)
        links.new(normal_tex.outputs["Color"], normal_map.inputs["Color"])
        normal_output = normal_map.outputs["Normal"]
        y -= 220

    if options.get("use_displacement"):
        height_path = maps.get("displacement") or maps.get("height")
        height_tex = _create_image_texture_node(nodes, _resolve_asset_path(asset_root, height_path), "Height / Bump", "Non-Color", pack_image)
        if height_tex:
            height_tex.location = (-450, y)
            _link_texture_vector(links, mapping, height_tex)
            bump = nodes.new("ShaderNodeBump")
            bump.location = (-180, y)
            bump.inputs["Strength"].default_value = float(defaults.get("bump_strength", 0.08))
            bump.inputs["Distance"].default_value = float(defaults.get("bump_distance", 0.05))
            links.new(height_tex.outputs["Color"], bump.inputs["Height"])
            if normal_output:
                links.new(normal_output, bump.inputs["Normal"])
            normal_output = bump.outputs["Normal"]
            y -= 220

    if normal_output:
        links.new(normal_output, bsdf.inputs["Normal"])

    alpha_path = maps.get("alpha") or maps.get("opacity")
    alpha_tex = _create_image_texture_node(nodes, _resolve_asset_path(asset_root, alpha_path), "Alpha", "Non-Color", pack_image)
    if alpha_tex and "Alpha" in bsdf.inputs:
        alpha_tex.location = (-450, y)
        _link_texture_vector(links, mapping, alpha_tex)
        links.new(alpha_tex.outputs["Color"], bsdf.inputs["Alpha"])
        mat.blend_method = "HASHED"
        mat.shadow_method = "HASHED"
        y -= 220

    ao_tex = _create_image_texture_node(nodes, _resolve_asset_path(asset_root, maps.get("ao")), "AO (备用)", "Non-Color", pack_image)
    if ao_tex:
        ao_tex.location = (-450, y)
        _link_texture_vector(links, mapping, ao_tex)

    viewport_color = defaults.get("base_color") or asset_entry.get("viewport_color")
    if viewport_color and len(viewport_color) >= 3:
        alpha = viewport_color[3] if len(viewport_color) > 3 else 1.0
        mat.diffuse_color = (viewport_color[0], viewport_color[1], viewport_color[2], alpha)

    _apply_pbr_metadata(mat, asset_entry, _normalize_asset_root(asset_root))
    return mat


# ═══════════════════════════════════════════════════════════
#  场景属性 — 存储在场景中的全局状态
# ═══════════════════════════════════════════════════════════

class MATMGR_SceneProps(PropertyGroup):
    active_category: EnumProperty(
        name="分类筛选",
        items=get_categories,
        description="按分类筛选预设材质",
    )
    search_text: StringProperty(
        name="搜索",
        description="搜索预设材质名称",
    )
    mat_name: StringProperty(
        name="名称",
        default="New Material",
        description="新材质名称",
    )
    apply_to_selected: BoolProperty(
        name="应用到选中物体",
        default=True,
        description="创建材质后自动应用到选中物体",
    )
    image_path: StringProperty(
        name="图片路径",
        subtype='FILE_PATH',
        description="选择一张图片作为贴图材质",
    )
    pbr_asset_root: StringProperty(
        name="PBR素材目录",
        default=PBR_ASSET_ROOT_DEFAULT,
        subtype='DIR_PATH',
        description="真实PBR贴图素材库目录",
    )
    pbr_category: EnumProperty(
        name="PBR分类筛选",
        items=_get_pbr_categories,
        description="按分类筛选真实PBR材质",
    )
    pbr_search_text: StringProperty(
        name="搜索PBR",
        description="搜索真实PBR材质名称",
    )
    pbr_use_displacement: BoolProperty(
        name="使用高度/凹凸",
        default=False,
        description="如果素材有高度图，创建 Bump 节点增强凹凸效果",
    )
    pbr_pack_images: BoolProperty(
        name="打包贴图",
        default=False,
        description="把贴图打包进当前 blend 文件（会增大文件体积）",
    )
    material_search_text: StringProperty(
        name="搜索材质",
        description="搜索场景材质名称",
    )
    material_list_index: IntProperty(
        name="场景材质索引",
        default=0,
    )
    editor_show_advanced: BoolProperty(
        name="显示高级参数",
        default=False,
        description="显示透明、次表面、清漆、光泽和自发光等高级参数",
    )


# ═══════════════════════════════════════════════════════════
#  操作器
# ═══════════════════════════════════════════════════════════

class MATMGR_OT_create_from_preset(Operator):
    """从预设创建材质"""
    bl_idname = "matmgr.create_from_preset"
    bl_label = "创建预设材质"
    bl_options = {"REGISTER", "UNDO"}

    preset_name: StringProperty()

    def execute(self, context):
        preset = _get_all_presets().get(self.preset_name)
        if preset is None:
            self.report({"ERROR"}, f"预设 '{self.preset_name}' 不存在")
            return {"CANCELLED"}

        scene = context.scene
        props = scene.matmgr_props

        mat_name = props.mat_name if props.mat_name.strip() else self.preset_name
        mat = create_principled_material(mat_name, preset)
        mat["matmgr_preset"] = self.preset_name

        scene.matmgr_active_material_name = mat.name

        if props.apply_to_selected:
            target_objects = _get_target_mesh_objects(context)
            _assign_material_to_objects(mat, target_objects)

        self.report({"INFO"}, f"已创建材质: {mat.name}")
        return {"FINISHED"}


class MATMGR_OT_create_from_image(Operator):
    """从图片文件创建贴图材质"""
    bl_idname = "matmgr.create_from_image"
    bl_label = "从图片创建材质"
    bl_options = {"REGISTER", "UNDO"}

    filepath: StringProperty(subtype='FILE_PATH')

    def invoke(self, context, event):
        context.window_manager.fileselect_add(self)
        return {"RUNNING_MODAL"}

    def execute(self, context):
        if not self.filepath:
            return {"CANCELLED"}

        scene = context.scene
        props = scene.matmgr_props

        # 用文件名作为材质名
        import os
        img_name = os.path.splitext(os.path.basename(self.filepath))[0]
        mat_name = props.mat_name.strip() if props.mat_name.strip() else f"IMG_{img_name}"

        # 加载图片
        img = bpy.data.images.load(self.filepath)
        img.pack()

        # 创建材质节点
        mat = bpy.data.materials.new(name=mat_name)
        mat.use_nodes = True
        nodes = mat.node_tree.nodes
        links = mat.node_tree.links
        nodes.clear()

        bsdf = nodes.new("ShaderNodeBsdfPrincipled")
        bsdf.location = (0, 0)
        bsdf.inputs["Roughness"].default_value = 0.4
        bsdf.inputs["Specular IOR Level"].default_value = 0.4

        tex = nodes.new("ShaderNodeTexImage")
        tex.location = (-300, 0)
        tex.image = img

        output = nodes.new("ShaderNodeOutputMaterial")
        output.location = (300, 0)

        links.new(tex.outputs["Color"], bsdf.inputs["Base Color"])
        links.new(bsdf.outputs["BSDF"], output.inputs["Surface"])

        scene.matmgr_active_material_name = mat.name
        mat["matmgr_preset"] = "__IMAGE__"

        # 应用到选中物体；无选中项时回退到活动物体
        if props.apply_to_selected:
            target_objects = _get_target_mesh_objects(context)
            _assign_material_to_objects(mat, target_objects)

        self.report({"INFO"}, f"已创建贴图材质: {mat.name}")
        return {"FINISHED"}


class MATMGR_OT_create_custom(Operator):
    """从自定义参数创建材质"""
    bl_idname = "matmgr.create_custom"
    bl_label = "创建自定义材质"
    bl_options = {"REGISTER", "UNDO"}

    def execute(self, context):
        params = context.scene.matmgr_params
        props = context.scene.matmgr_props

        name = params.name if params.name.strip() else "Custom Material"

        p = {
            "base_color": params.base_color,
            "roughness": params.roughness,
            "metallic": params.metallic,
            "specular": params.specular,
            "specular_tint": params.specular_tint,
            "transmission": params.transmission,
            "ior": params.ior,
            "subsurface": params.subsurface,
            "clearcoat": params.clearcoat,
            "clearcoat_roughness": params.clearcoat_roughness,
            "sheen": params.sheen,
            "sheen_tint": params.sheen_tint,
            "emission_color": params.emission_color,
            "emission_strength": params.emission_strength,
            "alpha": params.alpha,
        }
        mat = create_principled_material(name, p)

        context.scene.matmgr_active_material_name = mat.name

        if props.apply_to_selected:
            target_objects = _get_target_mesh_objects(context)
            _assign_material_to_objects(mat, target_objects)

        self.report({"INFO"}, f"已创建自定义材质: {mat.name}")
        return {"FINISHED"}


class MATMGR_OT_apply_material(Operator):
    """将材质应用到选中的物体"""
    bl_idname = "matmgr.apply_material"
    bl_label = "应用材质到选中物体"
    bl_options = {"REGISTER", "UNDO"}

    material_name: StringProperty()

    def execute(self, context):
        mat = bpy.data.materials.get(self.material_name)
        if mat is None:
            self.report({"ERROR"}, f"材质 '{self.material_name}' 不存在")
            return {"CANCELLED"}

        target_objects = _get_target_mesh_objects(context)
        if not target_objects:
            self.report({"WARNING"}, "没有选中的网格物体")
            return {"CANCELLED"}

        _assign_material_to_objects(mat, target_objects)

        self.report({"INFO"}, f"已将 '{mat.name}' 应用到 {len(target_objects)} 个物体")
        return {"FINISHED"}


class MATMGR_OT_select_by_material(Operator):
    """选中使用此材质的所有物体"""
    bl_idname = "matmgr.select_by_material"
    bl_label = "选中使用此材质的物体"
    bl_options = {"REGISTER", "UNDO"}

    material_name: StringProperty()

    def execute(self, context):
        mat = bpy.data.materials.get(self.material_name)
        if mat is None:
            return {"CANCELLED"}

        bpy.ops.object.select_all(action="DESELECT")
        count = 0
        for obj in bpy.data.objects:
            if obj.type == "MESH":
                for slot in obj.material_slots:
                    if slot.material == mat:
                        obj.select_set(True)
                        count += 1
                        break

        self.report({"INFO"}, f"已选中 {count} 个使用 '{mat.name}' 的物体")
        return {"FINISHED"}


class MATMGR_OT_delete_material(Operator):
    """删除材质"""
    bl_idname = "matmgr.delete_material"
    bl_label = "删除材质"
    bl_options = {"REGISTER", "UNDO"}

    material_name: StringProperty()

    def invoke(self, context, event):
        return context.window_manager.invoke_confirm(self, event)

    def execute(self, context):
        mat = bpy.data.materials.get(self.material_name)
        if mat is None:
            return {"CANCELLED"}
        mat_name = mat.name
        bpy.data.materials.remove(mat)

        if context.scene.matmgr_active_material_name == mat_name:
            context.scene.matmgr_active_material_name = ""

        self.report({"INFO"}, f"已删除材质: {mat_name}")
        return {"FINISHED"}


class MATMGR_OT_purge_unused(Operator):
    """清理未使用的材质"""
    bl_idname = "matmgr.purge_unused"
    bl_label = "清理未使用材质"
    bl_options = {"REGISTER", "UNDO"}

    def invoke(self, context, event):
        return context.window_manager.invoke_confirm(self, event)

    def execute(self, context):
        count = 0
        for mat in list(bpy.data.materials):
            if mat.users == 0:
                mat_name = mat.name
                bpy.data.materials.remove(mat)
                count += 1

        self.report({"INFO"}, f"已清理 {count} 个未使用的材质")
        return {"FINISHED"}


class MATMGR_OT_load_to_editor(Operator):
    """载入材质参数到编辑器"""
    bl_idname = "matmgr.load_to_editor"
    bl_label = "载入到编辑器"
    bl_options = {"REGISTER", "UNDO"}

    material_name: StringProperty()

    def execute(self, context):
        mat = bpy.data.materials.get(self.material_name)
        if mat is None:
            return {"CANCELLED"}

        params = get_params_from_material(mat)
        editor = context.scene.matmgr_params
        editor.name = mat.name
        for key, value in params.items():
            if hasattr(editor, key):
                setattr(editor, key, value)

        self.report({"INFO"}, f"已载入材质参数: {mat.name}")
        return {"FINISHED"}


class MATMGR_OT_toggle_material_details(Operator):
    """展开或收起场景材质详情"""
    bl_idname = "matmgr.toggle_material_details"
    bl_label = "展开/收起材质详情"
    bl_options = {"REGISTER"}

    material_name: StringProperty()

    def execute(self, context):
        scene = context.scene
        if scene.matmgr_active_material_name == self.material_name:
            scene.matmgr_active_material_name = ""
        else:
            scene.matmgr_active_material_name = self.material_name
        return {"FINISHED"}


class MATMGR_OT_update_material(Operator):
    """用编辑器参数更新材质"""
    bl_idname = "matmgr.update_material"
    bl_label = "更新材质"
    bl_options = {"REGISTER", "UNDO"}

    material_name: StringProperty()

    def execute(self, context):
        mat = bpy.data.materials.get(self.material_name)
        if mat is None:
            return {"CANCELLED"}

        editor = context.scene.matmgr_params
        p = {
            "base_color": editor.base_color,
            "roughness": editor.roughness,
            "metallic": editor.metallic,
            "specular": editor.specular,
            "specular_tint": editor.specular_tint,
            "transmission": editor.transmission,
            "ior": editor.ior,
            "subsurface": editor.subsurface,
            "clearcoat": editor.clearcoat,
            "clearcoat_roughness": editor.clearcoat_roughness,
            "sheen": editor.sheen,
            "sheen_tint": editor.sheen_tint,
            "emission_color": editor.emission_color,
            "emission_strength": editor.emission_strength,
            "alpha": editor.alpha,
        }
        apply_params_to_material(mat, p)

        if editor.name.strip() and editor.name != mat.name:
            mat.name = editor.name

        self.report({"INFO"}, f"已更新材质: {mat.name}")
        # 强制刷新视口
        for area in context.screen.areas:
            if area.type == "VIEW_3D":
                area.tag_redraw()
        return {"FINISHED"}


class MATMGR_OT_rename_material(Operator):
    """重命名材质"""
    bl_idname = "matmgr.rename_material"
    bl_label = "重命名"
    bl_options = {"REGISTER", "UNDO"}

    old_name: StringProperty()
    new_name: StringProperty(name="新名称", default="")

    def invoke(self, context, event):
        return context.window_manager.invoke_props_dialog(self)

    def execute(self, context):
        if not self.new_name.strip():
            return {"CANCELLED"}
        mat = bpy.data.materials.get(self.old_name)
        if mat is None:
            return {"CANCELLED"}
        if self.new_name in bpy.data.materials:
            self.report({"ERROR"}, f"名称 '{self.new_name}' 已存在")
            return {"CANCELLED"}
        mat.name = self.new_name
        if context.scene.matmgr_active_material_name == self.old_name:
            context.scene.matmgr_active_material_name = self.new_name
        return {"FINISHED"}


class MATMGR_OT_duplicate_material(Operator):
    """复制材质"""
    bl_idname = "matmgr.duplicate_material"
    bl_label = "复制材质"
    bl_options = {"REGISTER", "UNDO"}

    material_name: StringProperty()

    def execute(self, context):
        mat = bpy.data.materials.get(self.material_name)
        if mat is None:
            return {"CANCELLED"}
        new_mat = mat.copy()
        new_mat.name = mat.name + "_copy"
        context.scene.matmgr_active_material_name = new_mat.name
        self.report({"INFO"}, f"已复制材质: {new_mat.name}")
        return {"FINISHED"}


class MATMGR_OT_save_as_preset(Operator):
    """保存当前自定义参数为预设"""
    bl_idname = "matmgr.save_as_preset"
    bl_label = "保存为预设"
    bl_options = {"REGISTER", "UNDO"}

    preset_name: StringProperty(name="预设名称", default="My Preset")
    preset_category: StringProperty(name="分类", default="自定义")

    def invoke(self, context, event):
        wm = context.window_manager
        return wm.invoke_props_dialog(self)

    def execute(self, context):
        if not self.preset_name.strip():
            return {"CANCELLED"}
        all_presets = _get_all_presets()
        if self.preset_name in all_presets:
            self.report({"ERROR"}, f"预设 '{self.preset_name}' 已存在")
            return {"CANCELLED"}

        editor = context.scene.matmgr_params
        p = {
            "category": self.preset_category,
            "base_color": tuple(editor.base_color),
            "roughness": editor.roughness,
            "metallic": editor.metallic,
            "specular": editor.specular,
            "specular_tint": editor.specular_tint,
            "transmission": editor.transmission,
            "ior": editor.ior,
            "subsurface": editor.subsurface,
            "clearcoat": editor.clearcoat,
            "clearcoat_roughness": editor.clearcoat_roughness,
            "sheen": editor.sheen,
            "sheen_tint": editor.sheen_tint,
            "emission_color": tuple(editor.emission_color),
            "emission_strength": editor.emission_strength,
            "alpha": editor.alpha,
        }
        CUSTOM_PRESETS[self.preset_name] = p
        _save_custom_presets()
        self.report({"INFO"}, f"已保存自定义预设: {self.preset_name}")
        return {"FINISHED"}


class MATMGR_OT_delete_preset(Operator):
    """删除自定义预设"""
    bl_idname = "matmgr.delete_preset"
    bl_label = "删除预设"
    bl_options = {"REGISTER", "UNDO"}

    preset_name: StringProperty()

    def invoke(self, context, event):
        return context.window_manager.invoke_confirm(self, event)

    def execute(self, context):
        if self.preset_name not in CUSTOM_PRESETS:
            self.report({"ERROR"}, "只能删除自定义预设")
            return {"CANCELLED"}
        del CUSTOM_PRESETS[self.preset_name]
        _save_custom_presets()
        self.report({"INFO"}, f"已删除自定义预设: {self.preset_name}")
        return {"FINISHED"}


class MATMGR_OT_refresh_pbr_library(Operator):
    """刷新真实 PBR 材质库"""
    bl_idname = "matmgr.refresh_pbr_library"
    bl_label = "刷新PBR材质库"
    bl_options = {"REGISTER"}

    def execute(self, context):
        _PBR_MANIFEST_CACHE.clear()
        count = len(_get_pbr_materials(context))
        self.report({"INFO"}, f"已刷新真实PBR材质库：{count} 个材质")
        return {"FINISHED"}


class MATMGR_OT_create_from_pbr_asset(Operator):
    """从真实 PBR 贴图素材创建材质"""
    bl_idname = "matmgr.create_from_pbr_asset"
    bl_label = "创建PBR材质"
    bl_options = {"REGISTER", "UNDO"}

    asset_id: StringProperty()

    def execute(self, context):
        scene = context.scene
        props = scene.matmgr_props
        asset_root = _get_pbr_asset_root(context)
        entry = None
        for item in _get_pbr_materials(context):
            if item.get("id") == self.asset_id:
                entry = item
                break

        if entry is None:
            self.report({"ERROR"}, f"PBR材质 '{self.asset_id}' 不存在或贴图缺失")
            return {"CANCELLED"}

        try:
            mat = create_pbr_material(entry, asset_root, {
                "use_displacement": props.pbr_use_displacement,
                "pack_images": props.pbr_pack_images,
            })
        except Exception as exc:
            self.report({"ERROR"}, f"创建PBR材质失败: {exc}")
            return {"CANCELLED"}

        scene.matmgr_active_material_name = mat.name
        if props.apply_to_selected:
            target_objects = _get_target_mesh_objects(context)
            _assign_material_to_objects(mat, target_objects)

        _refresh_view3d(context)
        self.report({"INFO"}, f"已创建真实PBR材质: {mat.name}")
        return {"FINISHED"}


# ═══════════════════════════════════════════════════════════
#  面板
# ═══════════════════════════════════════════════════════════

_SAFE_CATEGORY_ICONS = {
    "金属": "MATERIAL",
    "玻璃": "SHADING_RENDERED",
    "塑料": "MATERIAL",
    "木材": "TEXTURE",
    "石材": "MESH_ICOSPHERE",
    "陶瓷": "MATERIAL",
    "橡胶": "MOD_SOFT",
    "织物": "MOD_CLOTH",
    "发光": "LIGHT_POINT",
    "车漆": "MATERIAL",
    "有机": "MATERIAL",
    "液体": "MOD_FLUIDSIM",
    "冰雪": "FREEZE",
    "宝石": "SOLO_ON",
    "食物": "MATERIAL",
    "纸张": "TEXTURE",
    "涂层": "SHADING_RENDERED",
    "镜子": "SHADING_RENDERED",
}


def _matmgr_category_icon(category):
    return _SAFE_CATEGORY_ICONS.get(category, "MATERIAL")


def _short_label(text, limit=14):
    if not text:
        return ""
    return text if len(text) <= limit else text[:limit - 1] + "…"


class MATMGR_PT_presets(Panel):
    """预设材质库面板"""
    bl_label = "预设材质库"
    bl_idname = "MATMGR_PT_presets"
    bl_space_type = "VIEW_3D"
    bl_region_type = "UI"
    bl_category = "Material Mgr"
    bl_order = 10

    def draw(self, context):
        layout = self.layout
        scene = context.scene
        mgr = scene.matmgr_props

        # 新建材质名称
        row = layout.row(align=True)
        row.prop(mgr, "mat_name", text="")

        # 筛选
        row = layout.row(align=True)
        row.prop(mgr, "active_category", text="")
        row.prop(mgr, "search_text", text="", icon="VIEWZOOM")

        layout.prop(mgr, "apply_to_selected")

        # ── 图片贴图 ──
        box = layout.box()
        box.label(text="从图片创建贴图材质", icon="IMAGE_DATA")
        box.operator("matmgr.create_from_image", text="选择图片并创建材质", icon="FILE_FOLDER")

        layout.separator()

        # 预设列表
        search = mgr.search_text.lower() if mgr.search_text else ""
        category = mgr.active_category
        shown = 0

        for name, preset in _get_all_presets().items():
            if search and search not in name.lower():
                continue
            if category != "ALL" and preset["category"] != category:
                continue

            preset_category = preset.get("category", "其他")
            row = layout.row(align=True)
            op = row.operator("matmgr.create_from_preset",
                              text=f"{name}",
                              icon=_matmgr_category_icon(preset_category),
                              emboss=False)
            op.preset_name = name
            row.label(text=preset_category, icon="OUTLINER_OB_GROUP_INSTANCE")
            if name in CUSTOM_PRESETS:
                op = row.operator("matmgr.delete_preset", text="", icon="TRASH", emboss=False)
                op.preset_name = name
            shown += 1

        if shown == 0:
            layout.label(text="没有匹配的预设材质", icon="INFO")
        else:
            layout.label(text=f"显示 {shown} 个预设", icon="INFO")


class MATMGR_PT_pbr_library(Panel):
    """真实 PBR 材质库面板"""
    bl_label = "真实PBR材质库"
    bl_idname = "MATMGR_PT_pbr_library"
    bl_space_type = "VIEW_3D"
    bl_region_type = "UI"
    bl_category = "Material Mgr"
    bl_order = 15

    def draw(self, context):
        layout = self.layout
        props = context.scene.matmgr_props

        row = layout.row(align=True)
        row.prop(props, "pbr_asset_root", text="")
        row.operator("matmgr.refresh_pbr_library", text="", icon="FILE_REFRESH")

        asset_root = _get_pbr_asset_root(context)
        manifest_path = os.path.join(asset_root, PBR_MANIFEST_FILENAME)
        if not os.path.exists(manifest_path):
            box = layout.box()
            box.label(text="未找到 manifest.json", icon="INFO")
            box.label(text="当前素材目录:")
            box.label(text=asset_root)
            box.label(text=f"需要文件: {PBR_MANIFEST_FILENAME}")
            return

        row = layout.row(align=True)
        row.prop(props, "pbr_category", text="")
        row.prop(props, "pbr_search_text", text="", icon="VIEWZOOM")

        col = layout.column(align=True)
        col.prop(props, "pbr_use_displacement")
        col.prop(props, "pbr_pack_images")

        materials = _get_pbr_materials(context)
        search = props.pbr_search_text.lower() if props.pbr_search_text else ""
        category = props.pbr_category
        shown = 0

        layout.separator()
        for entry in materials:
            name = entry.get("name_zh") or entry.get("name") or entry.get("id", "PBR Material")
            english = entry.get("name", "")
            entry_category = entry.get("category", "其他")
            haystack = f"{name} {english} {entry.get('id', '')}".lower()
            if search and search not in haystack:
                continue
            if category != "ALL" and entry_category != category:
                continue

            row = layout.row(align=True)
            split = row.split(factor=0.58)
            op = split.operator("matmgr.create_from_pbr_asset", text=name, icon="TEXTURE", emboss=True)
            op.asset_id = entry.get("id", "")
            split.label(text=entry_category, icon="OUTLINER_OB_IMAGE")
            row.label(text=_short_label(entry.get("license", "")), icon="COPY_ID")
            shown += 1

        if shown == 0:
            layout.label(text="没有匹配的真实PBR材质", icon="INFO")
        else:
            layout.label(text=f"显示 {shown} / {len(materials)} 个PBR材质", icon="INFO")


class MATMGR_PT_editor(Panel):
    """材质属性编辑器面板"""
    bl_label = "材质属性编辑器"
    bl_idname = "MATMGR_PT_editor"
    bl_space_type = "VIEW_3D"
    bl_region_type = "UI"
    bl_category = "Material Mgr"
    bl_order = 20

    def draw(self, context):
        layout = self.layout
        scene_props = context.scene.matmgr_props
        params = context.scene.matmgr_params

        layout.prop(params, "name")

        box = layout.box()
        box.label(text="基础属性", icon="MATERIAL")
        box.prop(params, "base_color")
        col = box.column(align=True)
        col.prop(params, "roughness")
        col.prop(params, "metallic")
        col.prop(params, "specular")
        col.prop(params, "specular_tint")
        col.prop(params, "alpha")

        layout.prop(scene_props, "editor_show_advanced",
                    icon="TRIA_DOWN" if scene_props.editor_show_advanced else "TRIA_RIGHT")

        if scene_props.editor_show_advanced:
            box = layout.box()
            box.label(text="透明与透射", icon="MOD_WIREFRAME")
            col = box.column(align=True)
            col.prop(params, "transmission")
            col.prop(params, "ior")
            col.prop(params, "subsurface")

            box = layout.box()
            box.label(text="表面细节", icon="SHADING_RENDERED")
            col = box.column(align=True)
            col.prop(params, "clearcoat")
            col.prop(params, "clearcoat_roughness")
            col.prop(params, "sheen")
            col.prop(params, "sheen_tint")

            box = layout.box()
            box.label(text="自发光", icon="LIGHT_POINT")
            col = box.column(align=True)
            col.prop(params, "emission_color")
            col.prop(params, "emission_strength")

        layout.separator()
        col = layout.column(align=True)
        col.operator("matmgr.create_custom", text="创建自定义材质", icon="ADD")
        col.operator("matmgr.save_as_preset", text="保存为预设", icon="PRESET_NEW")


class MATMGR_UL_scene_materials(UIList):
    """场景材质原生列表"""
    bl_idname = "MATMGR_UL_scene_materials"

    def filter_items(self, context, data, propname):
        materials = getattr(data, propname)
        props = context.scene.matmgr_props
        search = props.material_search_text.lower().strip() if props.material_search_text else ""
        flags = []
        order = []

        for mat in materials:
            visible = not search or search in mat.name.lower()
            flags.append(self.bitflag_filter_item if visible else 0)

        return flags, order

    def draw_item(self, context, layout, data, item, icon, active_data, active_propname, index):
        mat = item
        if self.layout_type in {"DEFAULT", "COMPACT"}:
            row = layout.row(align=True)
            row.label(text=mat.name, icon="MATERIAL")
            row.label(text=str(mat.users), icon="USER")
        elif self.layout_type == "GRID":
            layout.alignment = "CENTER"
            layout.label(text="", icon="MATERIAL")


class MATMGR_PT_material_list(Panel):
    """场景材质列表面板"""
    bl_label = "场景材质列表"
    bl_idname = "MATMGR_PT_material_list"
    bl_space_type = "VIEW_3D"
    bl_region_type = "UI"
    bl_category = "Material Mgr"
    bl_order = 30

    def draw(self, context):
        layout = self.layout
        scene = context.scene
        props = scene.matmgr_props
        search = props.material_search_text.lower() if props.material_search_text else ""
        total = len(bpy.data.materials)

        layout.operator("matmgr.purge_unused", text="清理未使用材质", icon="TRASH")
        layout.prop(props, "material_search_text", text="", icon="VIEWZOOM")

        shown = 0
        for mat in bpy.data.materials:
            if search and search not in mat.name.lower():
                continue
            shown += 1

        layout.label(text=f"显示 {shown} / {total} 个材质" if search else f"共 {total} 个材质", icon="INFO")
        layout.separator()

        if shown == 0:
            layout.label(text="没有匹配的场景材质", icon="INFO")
            return

        active_index = min(max(props.material_list_index, 0), max(total - 1, 0))

        row = layout.row()
        row.template_list("MATMGR_UL_scene_materials", "",
                          bpy.data, "materials",
                          props, "material_list_index",
                          rows=6)

        toolbar = row.column(align=True)
        active_mat = bpy.data.materials[active_index] if total else None
        if active_mat:
            toolbar.operator("matmgr.load_to_editor", text="", icon="GREASEPENCIL").material_name = active_mat.name
            toolbar.operator("matmgr.apply_material", text="", icon="IMPORT").material_name = active_mat.name
            toolbar.operator("matmgr.select_by_material", text="", icon="RESTRICT_SELECT_OFF").material_name = active_mat.name
            toolbar.separator()
            toolbar.operator("matmgr.duplicate_material", text="", icon="DUPLICATE").material_name = active_mat.name
            op_rename = toolbar.operator("matmgr.rename_material", text="", icon="FONT_DATA")
            op_rename.old_name = active_mat.name
            toolbar.operator("matmgr.delete_material", text="", icon="TRASH").material_name = active_mat.name

            box = layout.box()
            box.label(text=active_mat.name, icon="MATERIAL")
            params = get_params_from_material(active_mat)
            if params:
                col = box.column(align=True)
                col.label(text=f"粗糙 {params.get('roughness', 0.0):.2f} | 金属 {params.get('metallic', 0.0):.2f} | Alpha {params.get('alpha', 1.0):.2f}")
                col.label(text=f"透射 {params.get('transmission', 0.0):.2f} | IOR {params.get('ior', 1.45):.2f} | 清漆 {params.get('clearcoat', 0.0):.2f}")
            else:
                box.label(text="没有可读取的 Principled BSDF 参数", icon="INFO")
            box.operator("matmgr.update_material",
                         text="用编辑器参数更新此材质",
                         icon="FILE_REFRESH").material_name = active_mat.name


# ═══════════════════════════════════════════════════════════
#  注册 / 注销
# ═══════════════════════════════════════════════════════════

CLASSES = [
    MaterialParamsProperty,
    MATMGR_SceneProps,
    MATMGR_OT_create_from_preset,
    MATMGR_OT_create_from_image,
    MATMGR_OT_create_custom,
    MATMGR_OT_apply_material,
    MATMGR_OT_select_by_material,
    MATMGR_OT_delete_material,
    MATMGR_OT_purge_unused,
    MATMGR_OT_load_to_editor,
    MATMGR_OT_toggle_material_details,
    MATMGR_OT_update_material,
    MATMGR_OT_rename_material,
    MATMGR_OT_duplicate_material,
    MATMGR_OT_save_as_preset,
    MATMGR_OT_delete_preset,
    MATMGR_OT_refresh_pbr_library,
    MATMGR_OT_create_from_pbr_asset,
    MATMGR_PT_presets,
    MATMGR_PT_pbr_library,
    MATMGR_PT_editor,
    MATMGR_UL_scene_materials,
    MATMGR_PT_material_list,
]


def register():
    _load_custom_presets()
    for cls in CLASSES:
        bpy.utils.register_class(cls)
    bpy.types.Scene.matmgr_props = PointerProperty(type=MATMGR_SceneProps)
    bpy.types.Scene.matmgr_params = PointerProperty(type=MaterialParamsProperty)
    bpy.types.Scene.matmgr_active_material_name = StringProperty(
        name="Active Material", default=""
    )


def unregister():
    for cls in reversed(CLASSES):
        bpy.utils.unregister_class(cls)
    del bpy.types.Scene.matmgr_props
    del bpy.types.Scene.matmgr_params
    del bpy.types.Scene.matmgr_active_material_name


if __name__ == "__main__":
    register()