2024/07/17
2025/11/11最后一次更新
记录整理一下用过的代码
由于本人不会编程，所有代码均由AI辅助生成
代码在下面两个链接里，雨雀文档为主要编辑的，金山文档为备份，更新会不及时
全文链接：
语雀：https://www.yuque.com/orange_shawn/bxzspq/vzkh5kd0plg1cx41?singleDoc#
金山文档：https://kdocs.cn/l/cdjTIftYlUSD
```html
```html
目录
一、基础说明与资源
1. 使用注意事项：区分含/不含“bl_info”代码的安装启用方式，强调数据需提前备份及风险告知
2. Blender相关文档：提供官方手册（含Python API、渲染、命令行参数）、脚本示例、纹理烘焙文档及社区资源，说明外部调用需安装“bpy”库（Python 3.7-3.8）
二、插件管理
1. 橙砸的工具箱：专为Blender开发者设计的插件管理工具，支持自定义文件夹管理、动态加载、可视化分类（暂未正常工作）与灵活控制，解决原生插件管理繁琐问题，提升开发调试效率，含多版本更新优化
三、材质相关插件
1. 批量烘焙纹理颜色从高模到底模：需搭配MeshLab批量减面工具，支持批量导入匹配原始与减面网格，自动处理UV、管理材质、自定义烘焙分辨率，记录未匹配文件日志
2. 一键覆盖所选对象材质参数：仅在Blender 4.1.1测试可用，运行后在3D视口右侧生成面板，通过Blender材质数据路径批量修改所选对象材质参数
3. 一键清理场景中网格空材质槽：遍历场景网格物体，从后向前移除未分配材质的空材质槽，支持物体模式检查，纠正单材质槽对象操作错误
4. 查找指定材质并孤立显示模型（已弃用）：通过面板输入材质名，在当前视图层孤立显示含该材质的模型，不扫描被排除集合
5. 根据材质关键词查询可见网格对象：在3D视口右侧“测试”面板输入材质关键词，查找并选中场景中含该关键词材质的可见网格对象
6. 合并同名材质：支持按内容、前缀、后缀及正则匹配，合并名称含指定字符串（忽略“.001”等后缀）的材质，自动更新关联对象的材质引用
7. 合并选中网格重复材质并清理材质槽：适配Blender 4.1.1+，一键合并所选物体同名材质槽、清理空材质槽，支持多选批量操作，显示处理进度条，支持撤销
四、灯光与UV相关插件
1. 根据高光位置设置灯光位置：含多版本迭代，初版基本功能可用，可根据模型高光位置调整灯光位置
2. 重命名网格UV名称：在3D视口右侧生成“重命名UV”面板，批量重命名所选网格UV图层，含输入有效性检查、错误警告处理
3. 一键选择UV展开失败对象：分析网格拓扑、UV布局及缝合边配置，自动识别并选中可能存在UV展开问题的对象，支持大型模型性能优化
五、模型相关插件
1. 一键Y向上（坐标系转换插件）：实现Blender默认Z向上与游戏引擎Y向上的双向转换，保持对象位置、层级及几何形态，支持多对象类型，含误差修正与场景清理
2. 批量清除自定义拆边法向数据：已整合到对象标记清理工具，一键清除选中网格的自定义拆边法向数据，支持自动切换物体模式，含错误处理
3. 网格对象重叠筛选工具（已整合进场景选择工具）：通过BVH树检测选中网格间重叠，在“橙_工具”面板提供操作按钮，反馈重叠对象结果
4. 场景选择工具：多版本更新，支持筛选特定属性对象（无几何/UV网格、无材质对象、重叠对象等），新增曲线/网格孤立元素选择、顶层父级/子级切换功能
5. 对象标记清理工具：适配Blender 4.5+，批量处理选中网格的边标记（倒角权重、锐边等）与附加数据（顶点组、形状键），支持自定义勾选处理项，操作可逆
6. 曲线倒角深度设置插件：适配Blender 4.5+，批量设置选中曲线的倒角深度与分辨率，支持实时预览、快捷调整（双倍/减半/重置）
六、名称与结构相关插件
1. 导出所选模型名称列表为CSV：导出选中对象的位置、旋转、缩放等变换数据到CSV，支持多坐标系、自定义导出选项，自动命名文件
2. 一键清理所选对象尾缀（.001）：批量移除选中对象名称的指定尾缀（可修改代码调整目标尾缀），也可通过Blender自带改名功能实现
3. 对象命名工具：支持“前缀+中缀+后缀”三段式命名、批量前后缀管理、自动编号与间隔符设置，多版本更新新增正则替换、独立间隔符等功能
4. 修复中文乱码名称：智能检测并修复导入模型的中文名称乱码，支持多编码解码、层级化处理与名称规范化，含测试-应用两步流程
5. 父子对象合集整理：自动识别场景顶层父对象，为其创建同名合集并移入所有子级，清理空合集，支持撤销，适配Blender 4.5
6. 层级组织工具：适配Blender 4.5+，支持批量归组对象到指定父级（自定义命名与编号）、清理冗余空物体与重组嵌套网格，操作直观且支持撤销
七、网格合并相关工具
1. 清理所选父物体的空物体子级：递归清理所选对象及其子集中无网格数据的空对象，保留含有效子对象的分支，优化场景结构
2. 一键合并所选对象子集中的网格物体（单选版，不推荐）：运行后生成面板，合并所选对象子集的网格，替换原对象并改名，存在后缀与变换问题
3. 一键合并所选对象子集中的网格物体（多选版）：批量处理多个选中对象，合并其子网格、删除非网格子对象，保留父级关系，支持撤销
4. 递归合并父对象同一层级网格：递归遍历选定父对象的子层级，合并同一父级下的子网格对象，含错误处理与界面集成
八、渲染相关插件
1. 简易批处理渲染：在“橙_渲染”面板添加摄像机槽位，设置帧范围与输出路径，批量渲染并实时显示进度，支持ESC或按钮停止渲染
2. 摄像机分辨率管理：为场景摄像机预设渲染分辨率，切换摄像机时可自动应用，含视口锁定、分辨率互换与多视口适配功能
1. 变换计算器：在“橙_工具”面板提供功能，通过空物体标识测量点，计算物体间角度（含补角）、距离（含分量）与缩放比例，实时显示结果并支持复制