0808 Tools 使用文档

操作流程：
① 选中要对齐的组件 → 激活对齐工具（单选=by_pick模式，多选=by_bound模式）
② 鼠标点击目标边、面或剖面完成对齐
快捷键：

• Ctrl 切换复制模式（对齐同时复制）
• Shift 切换为"从点移动到平面"功能
• Tab 与平面对齐（对齐后旋转物体贴合平面）
• ↑ 顶面对齐 | ↓ 底面对齐 | → X轴中心 | ← Y轴中心

VCB 数值输入（对齐后右下角直接输入）：标签显示 Distance，支持：直接输入距离值 | 算术式（加减乘除） | x数字/*数字 按该数量重复复制 | /数字 等分复制（需先 Ctrl 开启复制模式）
状态栏提示："选择要对齐的对象" → 选中后按模式显示 "选择一个边, 面或剖面来对齐, Shift = 从点移动到平面, Ctrl = 切换复制" 或 "选择要对齐的线或平面, Shift = 对齐边缘, 面或剖面, Tab = 与平面对齐(对齐后)"
鼠标提示（tooltip）：悬停时显示 "与中心边缘对齐" / "对齐边缘" / "与面对齐"，指示当前将执行的对齐方式

三步操作流程：
① DRAW AREA（框选区域）：矩形模式按住左键拖动；多边形模式逐点点击
② MOVE1（选起点）：点击选择拉伸起点
③ MOVE2（选终点）：点击选择终点完成拉伸，或在VCB输入精确距离（如 200mm）
快捷键：

• Shift MOVE2状态下锁定推理方向
• Enter 确认当前拉伸方向和距离

右键菜单：切换为点选/切换为框选 | 完成（结束框选进入拉伸） | 设置屏幕虚拟显示文字
屏幕文字提示（视口顶部横幅，实时切换）：

• 框选模式未选时："左键点下拖动框选柜子需要拉伸的范围"
• 点选模式未选时："左键点击添加框选范围 回退键删除上一个添加点"
• 已框选后："点击两个位置确定拉伸距离或者数值框输入距离"
• 每条均附带："Tab键 >> 切换拉伸方向 / 方向右键 >> 锁定红轴 / 方向左键 >> 锁定绿轴 / 方向上键 >> 锁定蓝轴"

拉伸中反馈：拉伸点旁实时显示当前距离数值（mm）；VCB 输入纯数字按 mm 直接设定拉伸距离

两步操作：
① 左键点击第一个组件（被修剪体）—— 光标变为"修剪光标1"
② 左键点击第二个组件（修剪刀具）—— 光标变为"修剪光标2"
系统执行布尔差集运算：刀具形状从被修剪体上挖去，两个实体均保留（刀具不会消失）。
状态栏提示：激活时 "请先选择第一个组或组件。" → 选中第一个后 "请选择第二个组或组件。"
警告弹窗：实体校验失败时弹出 "警告: …结果可能不如预期。是否要继续？"（是/否），选"否"取消本次运算
应用场景：板件开槽、板件拼接让位、五金孔位开洞

操作流程：
① 选中要保留显示的对象（可多选，组件/组/面均可）
② 点击“孤立”按钮 → 当前编辑上下文中除所选外的全部实体被隐藏
执行逻辑：

• 仅隐藏当前编辑上下文内的其余实体（双击进入组件内部后使用也支持，包裹层级自动排除）
• 操作可通过 Ctrl+Z 一次性撤销

恢复显示：点击同工具栏的“显示全部”按钮
注意：未选中任何对象时点击无效果（不会弹窗报错）

操作流程：
① 选中要隐藏的对象（可多选）→ 点击“隐藏”按钮
② 所选对象被隐藏并写入 0808_hidden 记忆标记，选择集自动清空
特殊用法：

• 空选择时点击 = 隐藏全部：递归遍历当前上下文所有尚未被 0808 标记隐藏的实体，全部隐藏并打标记
• 与 SketchUp 原生“隐藏”的区别：带专属标记，后续可被“显示全部”精准识别恢复，不会误恢复你手动隐藏的其他对象

撤销：支持 Ctrl+Z 撤销（操作名“隐藏”/“隐藏所有”）

操作流程：
① 无需选择任何对象，直接点击“显示全部”按钮
② 所有带 0808_hidden 标记的隐藏实体被找出并恢复可见，标记同步重置
恢复范围：

• 只恢复由 0808“隐藏/孤立”工具隐藏的对象（递归遍历所有嵌套层级）
• 不影响你用 SketchUp 原生“隐藏”命令隐藏的对象，两套隐藏体系互不干扰

撤销：支持 Ctrl+Z 撤销（操作名“显示全部”）

两步操作：
① 鼠标移动到有材质的面上，左键点击选择源材质（要被替换的）
② 鼠标移动到另一个材质面上，左键点击选择目标材质（替换为）
系统自动将场景中所有使用源材质的面（包括所有组件内部）全部替换为目标材质。
鼠标旁屏幕文字（深红色）：第一步显示 "替换{当前悬停材料名} ..."；第二步显示 "替换 {源材质}\n用 {目标材质}"；无材质的面显示为"预设材料"；选择相同材质时光标变为错误样式
状态栏提示："选择一种材料进行替换" → "选择另一种材料替换 {源材质名}" → 执行中 "正在更换材料--请稍候..."

使用方式：
• 鼠标悬停在边上 → 实时显示该边的长度
• 鼠标悬停在面上 → 射线检测对面距离，显示两面间距
• 左键点击 → 在模型中创建永久标注尺寸
快捷键：

• Shift 反转射线测量方向（测量面的另一侧距离）

视觉反馈：蓝色测量线段 + 橙色端点 + 中间显示距离数值
状态栏："将鼠标放在面或边上以进行测量。Shift = 反转侧"

操作流程：
① 激活工具 → 自动弹出 "0808挑选工具"悬浮面板：面板中列出已保存的关键字，点选关键字即设为当前过滤条件（切换关键字时自动清空当前选择重新开始）；右下角 "写入关键字+"按钮 可添加新关键字到列表
② 在场景中框选或点选 → 仅匹配关键字的实体被选中
匹配规则：关键字同时匹配 实例名称 / 组件定义名称 / 图层标记名称
框选方向：

• 左到右框选 = 内部模式（实线框，仅选完全在框内的实体）
• 右到左框选 = 交叉模式（虚线框，碰到框即选中）

右键菜单：重设关键字

操作方式：
① 选中一个组/组件后激活工具，出现六面滑块（上/下/左/右/前/后）
② 鼠标移到滑块附近（变红高亮）→ 左键点击开始拖动 → 拖动到目标位置 → 左键确认
VCB 输入格式（右下角直接输入）：

• 数字 设为模型绝对尺寸（如输入 500 = 该方向总长变为500mm）
• +数字 延伸指定距离（如 +50 = 该方向增大50mm）
• -数字 收缩指定距离（如 -30 = 该方向缩小30mm）
• *数字 扩大到指定倍数（如 *2 = 变为原来的2倍）
• /数字 缩小到1/n（如 /3 = 变为原来的1/3）

右键菜单：0808拉伸（按已存切面弹窗执行拉伸，需先选中柜体并添加切面） | 设置屏幕虚拟显示文字 | 参考面剖切 | 切面编辑模式（鼠标指向实体时显示）
"0808拉伸"弹窗：标题"精确拉伸（看屏幕上方文字提示）"，按已有切面动态出现 参考红面 / 参考绿面 / 参考蓝面 输入框（记忆上次值，初始 50）；框内同样支持 +加 / -减 / *放大 / 缩小与直接输入数值
屏幕文字提示（视口顶部横幅）："每个输入框的数值是单个面片拉伸的距离，正数变大，负数变小 / 按Tab键→循环切换拉伸轴参考（实时显示当前是X/Y/Z轴状态） / 按Shift键→循环切换动边 / 各轴动边当前在哪一侧"；动边端点旁标注 "动边" 二字（随 Shift 切换）
弹窗提示：未选柜体时 "请先选中柜体（将鼠标移到组件上）" | 无切面时 "请先添加切面（单击柜体），或左键添加参考面后再拉伸" | 切片缺外框时 "缺少外框构造点，请先执行「保存切片」"
切片编辑模式反馈：每个切片旁显示 "X/Y/Z: 百分比%"，拖动时黄色显示 "±偏移量mm"

操作流程：
① 点击工具图标 → 打开 Vue 悬浮面板
② 在面板中选择颜色色块（12种预设色：红/蓝/绿/黄/黑/白/橙/紫/灰/金/青/粉）
③ 点击面板中的文字条目 → 自动切换到放置模式，可贴合任意面放置
编辑：使用SU选择工具双击已放置的3D文字 → 弹出 "编辑3D文字" 对话框（字段：文本内容 / 文字高度(mm) / 挤出深度(mm) / 对齐：左对齐|中间对齐|右对齐 / 填充：是|否 / 颜色下拉），成功后弹出通知 "3D文字已更新: {文本}"
自定义3D文字弹窗：字段：文本内容（默认"3D文字"）/ 文字高度(mm)（默认100）/ 挤出深度(mm)（默认10）/ 颜色（12色下拉，默认蓝色）
状态栏提示：放置模式下显示 "在面上点击放置3D文字 | 右键或Esc取消"
错误提示：异常时弹窗 "创建3D文字失败: …" / "编辑3D文字失败: …"
参数：字体=黑体 | 可自定义文字高度(mm)和挤出深度(mm)

操作步骤：
① 弹窗"墙面盒子尺寸"（字段：框体宽 / 框体深 / 框体高，输入有记忆） → 输入框体尺寸
② 鼠标悬停非水平面（墙面） → 出现虚拟框预览
③ 左键点击确定位置 → 方向键微调
④ Enter 或双击确认放置
模型模式入口：从 HtmlDialog "0808_模型放置图库" 双击模型缩略图 → 直接进入放置（虚拟框取模型外框尺寸）
快捷键：

• ←→↑↓ 微调盒子在墙面上的位置
• Enter / 双击 = 确认放置（含超出墙面检查）

状态栏显示："距左/距右/距上/距下" + 实时数值，并附方向键操作提示
VCB输入：输入边距精确定位，格式"水平,垂直"，解析失败蜂鸣并清空
右键菜单：重设尺寸 | 墙面盒子边距设置（弹窗"墙面盒子边距"） | 重新加载模型尺寸（从图库放置模型时）
错误提示弹窗："盒子尺寸超过墙面范围，请缩小尺寸"（回车时尺寸超限） | "盒子超出墙面范围，请调整位置"（回车时越界） | "盒子超出墙面范围，无法放置"（双击/放置时越界） | "找不到盒子组件文件" | "放置失败: …" | 模型模式下 "找不到模型文件" / "模型外框尺寸无效"

操作流程：
① 点击工具 → 弹出 5 项参数对话框
② 配置清理选项 → 点击确定执行清理
对话框选项：

• 清理 组件：是/否 —— 清除未在场景中使用的组件定义
• 清理 图层：是/否 —— 清除未分配任何实体的空图层
• 清理 材料：是/否 —— 清除未应用到任何面的材质
• 清理 样式：是/否 —— 清除未使用的显示样式
• 打印 报告：是/否/清单 —— "是"弹出统计框，"清单"生成详细日志txt文件并自动打开

统计报告示例："清除: 组件: 12 of 45、图层: 3 of 8、材料: 5 of 20"（清除数 / 原总数）；四项全选"否"时弹出 "没有东西被清除 ！"
清单模式：在模型同目录生成 "模型名-清除日志.txt" 记录每个被清除的资源名称

操作流程：
① 选中要清除属性的组件/组（可多选）
② 点击"属性清除"按钮执行
清除范围：

• 删除实例的所有 attribute_dictionaries（包括动态组件属性）
• 删除组件定义（definition）的所有属性字典
• 深层递归：自动处理所有嵌套层级内的子组件

完成提示：弹出通知"已经清除所选范围内全部属性字典"
注意：未选中组件时会弹出提示"请选中要清除属性的组件"

操作流程：
① 选中要设定唯一的组件（可多选）
② 点击"超级唯一"按钮执行
执行逻辑：

• 对每个选中的组件执行 make_unique
• 递归处理：自动深入所有嵌套层级，将内部每个子组件也设为唯一
• 区别于原生的 make_unique：原生只处理当前层级，此工具处理所有层级

完成提示：弹出通知"已经把所选组件实例和其内部嵌套组件实例全部设定唯一"
注意：未选中组件时会弹出提示"请选中要设定唯一的组件"

操作流程：
① 框选要处理的组件范围（可多选）
② 点击"删除隐藏"按钮执行
执行逻辑：

• 递归遍历所选组件内部所有层级
• 查找所有 hidden? == true 的组件/组实例
• 一次性删除所有找到的隐藏实例

完成提示：弹出通知"已经删除所选部分隐藏组件"
注意：未选中组件时会弹出提示"请框选要删除隐藏的组件"

操作流程：
① 选中要重命名的组件（可多选）
② 点击"深层命名" → 弹出输入框
③ 输入自定义名称（如"卧室柜"）→ 点击确定
命名规则：

• 组件定义重命名为："输入名_原名称"（如"卧室柜_左侧板"）
• 实例名称取组件定义名中 #号之前的部分
• 组（Group）同样重命名为"输入名_原名"
• 递归处理：自动深入所有嵌套层级

完成提示：弹出消息框"更名完成!"

操作流程：
① 选中要打包的多个实体（组件、组、边线、面等均可）
② 点击"打包成组" → 弹出输入框
③ 输入组名（默认自动生成"打包组名#1"）→ 点击确定
结果：

• 所有选中实体被包裹到一个新的命名组中
• 组名自动确保唯一（重名时自动追加编号）
• 完成后自动选中新创建的组

操作流程：
① 选中要设定图层的实体（可多选）
② 点击"图层设定" → 弹出输入框（带下拉列表）
③ 从下拉列表中选择目标图层（显示当前模型中所有图层）→ 点击确定
结果：

• 所有选中实体的 layer 属性被设置为选择的图层
• 默认选中当前活动图层（可切换）

用途：快速将柜门、五金、板件等分别归类到对应图层，方便显隐控制

操作流程：
① 点击工具 → 弹出 "输入框体尺寸" 对话框（框体宽、框体深、框体高，记忆上次输入值）
② 鼠标在场景中移动 → 蓝色半透明虚拟盒子跟随鼠标（悬停非水平面时自动贴合面法线方向）
③ 左键单击确定位置（进入微调模式）
④ 双击 或 Enter 确认放置
智能吸附：自动检测左右两侧墙面距离，靠近一侧时自动吸附（被吸附面变红色高亮）
尺寸线微调：

• 点击左边橙色尺寸线 → 弹出"左边距离"输入框（字段：宽度mm），精确设定与左墙距离
• 点击右边橙色尺寸线 → 弹出"右边距离"输入框（字段：宽度mm），精确设定与右墙距离

视觉反馈：RGB三色轴箭头 + 橙色端点标注左右墙距离（深红色数值）
VCB 输入：按长度解析，无法解析时蜂鸣提示并清空输入框
右键菜单：重设尺寸
状态栏："左键单击确定虚拟框后 | 左键双击或者回车放置物件 | 或者鼠标点击左右尺寸线来修改虚拟框位置"

操作流程：
① 点击工具 → 打开 "0808_组件绘制图库" 对话框
② 左侧为目录树（按类别分文件夹），右侧为缩略图预览网格
③ 双击目标组件缩略图 → 进入绘制工具，在场景中拖拽绘制该组件（支持 VCB 直接输入尺寸）
图库路径：插件目录下 0808_本地模型仓库 中的组件绘制图库
注意：该工具为VIP功能，需要登录且VIP未到期

操作流程：
① 选中一个组/组件（必须恰好选中 1 个，多选或空选无效果）
② 点击“局部放大”按钮 → 相机自动移动到该组件正前方并缩放至充满视口
执行逻辑：

• 按所选组件的包围盒自动计算视点：相机位于组件正前方、沿 Y 轴看向组件、Z 轴朝上
• 相当于一键“摆正视角 + 充满视图”，特别适合逐个柜体检查细节

注意：选中数量不是 1 个时点击无反应（不弹窗报错）；查看完毕可用鼠标滚轮/环绕工具自由退出该视角

操作流程：
① 鼠标悬停高亮组件 → 左键点击选中（可多选）
② 使用方向键或右键菜单执行切割
方向键快捷切割：

• ← 左边割掉 | → 右边割掉 | ↑ 上边割掉 | ↓ 下边割掉
• Ctrl+↑ 后边割掉 | Ctrl+↓ 前边割掉
• Ctrl+← 左右均分 | Ctrl+→ 上下均分
• Enter 弹出 "0808切割框体" 对话框（字段：左右均分/上下均分，默认均为 1），可同时两向均分

弹窗输入：均分弹窗字段为"左右均分个数"/"上下均分个数"（记忆上次值）；各边割掉弹窗均为单字段（前/后/左/右/上/下边割掉，记忆上次值），支持数学表达式（如 100+50、300/2）
状态栏提示："选择一个组或组件 按： ↑上 ↓下 ←左 →右 ctrl+↓前 ctrl+↑后 ctrl+←左 ctrl+→右 回车键 切割框体 左键点击加减选"
右键菜单：左右均分 | 上下均分 | 前/后/左/右/上/下边割掉 | 快速加门（弹出"掩码门板"参数弹窗） | 设置屏幕虚拟显示文字

操作流程：
① 激活工具后左键逐个点选组件累加选择（包围盒自动合并，蓝色半透明外框 + 黄色方向标签预览）
② 按数字键或方向键触发替换，替换组件自动匹配所选体块的方位与尺寸
快捷键：

• Ctrl 切换『合』（整体替换为 1 个组件）/ 『分』（逐个分别替换）模式
• Tab 循环切换备用替换图库（0→1→2→3→0）
• 主键盘 0-9 → 调用图库中『快速替换左边数字N.skp』| 小键盘 0-9 → 『快速替换右边数字N.skp』
• 图库0下方向键：← 左封板 | → 右封板 | ↑ 顶封板 | ↓ 踢脚板（取自本地仓库“柜体封板”目录）

屏幕提示：顶部蓝底三行“按Ctrl键 ==> 切换合并和分别替换两个 / 按Tab键 ==> 循环切换备用替换图库 + 当前库号（0-3 放大显示） / 鼠标右键掩码门板”；拾取后内空面上黄底显示方向标签（前/上/下/左/右）
右键菜单：0808快速加门 | 设置屏幕虚拟显示文字 | 记忆切换的图库（勾选后写入 SketchUp 默认设置）
"快速加门"弹窗（标题"掩码门板"）：门板掩码 / 上边留空 / 下边留空 / 左边留空 / 右边留空 / 门板厚度（均记忆上次值，mm） / 门板盖法（外盖门|内嵌门下拉）
注意：图库中对应编号的 skp 文件不存在时不执行替换；操作名“快速替换自适应方位”，可 Ctrl+Z 撤销

操作流程：
① 左键逐个点击组/组件进行累加选择（再次点击已选对象可减选）
② 按数字键或方向键 → 从本地图库加载对应组件替换/贴合到所选对象
快捷键：

• ← 左封板 | → 右封板 | ↑ 顶封板 | ↓ 踢脚板（读取本地图库“柜体封板”目录）
• 主键盘 0-9 插入“快速替换左边数字N.skp” | 小键盘 0-9 插入“快速替换右边数字N.skp”
• Esc 清空已选，重新开始

自定义：替换本地图库中同名 skp 文件即可换成自己的组件（文件名不变）
状态栏提示："快速替换 选中体块后 请尝试按左右的数字键0到9 还有四个方向键 左键点击加减选"
右键菜单：快速加门 | 设置屏幕虚拟显示文字
注意：操作名“快速替换”，可 Ctrl+Z 撤销

操作流程：
① 左键点击柜体内部空间 → 自动射线检测六个方向的内空范围（半透明蓝色高亮，中央显示宽/深/高）
② 连续左键单击可追加识别多个内空，之后的加板/插件操作对所有已选内空同时生效
③ 使用方向键、数字键或右键菜单添加板件/部件
方向键加板（图库0，各自弹出参数弹窗，输入值有记忆）：

• ↑ 弹窗"橫板 ▎"：距离上边 ┳（默认0）/ 插入板厚 ▂（默认18）
• ↓ 弹窗"橫板 ▎"：距离下边 ┻（默认0）/ 插入板厚 ▂（默认18）
• ← 弹窗"竖板 ▎"：距离左边 ┣ / 插入板厚 ▂ | → 距离右边 ┫ / 插入板厚 ▂（默认0/18）
• Ctrl+↓ 弹窗"前板 ▎"：距离前边 ▉（默认0）/ 插入板厚 ▂（默认18）
• Ctrl+↑ 背板弹窗（6字段）：距离后边 ▉（默认0）/ 插入板厚（默认18）/ 5或9厚度背板的上/下/左/右插入值（各默认5）

数字键快捷（图库0）：

• 小键盘 + 插入抽屉 | - 挂衣杆 | * 插入灯带
• 主键盘 0-9 插入左侧打包件 | 小键盘 0-9 插入右侧打包件（读取本地图库“识别内空”目录同名 skp）

其他快捷键：

• 单独点按 Ctrl 切换内空插入位置（柜内部/柜外部）——内空前顶边下方实时显示“插入柜内部”（黑字）或“插入柜外部”（红字）；“外部”时部件用世界坐标插入模型顶层、不进柜体组件
• Tab 循环切换备用内空图库（0→1→2→3→0），当前库编号显示在视口顶部；配合右键“记忆切换的图库”可记住上次用的库
• 图库 1/2/3 模式下：↑↓←→ 直接插入该库目录下的上/下/左/右组件（sN/xN/zN/yN.skp），数字键插入“识别内空左/右边数字N0~N9”组件
• Enter 跳到内空图库（打包件）对话框页面，双击图片即刻插入
• Esc 清空全部已识别内空，重新开始

右键菜单（9 项）：

• 生成中竖板（根据均分门板）：弹窗"根据均分门板生成中竖板"（字段：均分门板个数 / 插入板厚 / 左侧盖值 / 右侧盖值，单位mm，输入有记忆），按门板位置生成中竖板
• 添加平板门：弹窗字段——上盖 / 下盖 / 左盖 / 右盖 / 门板厚度 / 门板盖法 / 门板开向
• 添加均分横板 / 均分竖板：弹窗"橫板均分"/"竖板均分"（字段：均分空间个数 / 插入板厚，输入有记忆），一键均分
• 添加打包件：打开打包件图库对话框挑选插入
• 回退到上一次内空状态：恢复上一次的内空选择
• 设置屏幕虚拟显示文字：调整视口顶部/模型前部提示文字大小与显隐
• 0808内空插入位置：弹窗选择插入到柜内部或柜外部（与单独点按 Ctrl 等效）
• 记忆切换的图库（可勾选）：开启后记住 Tab 切到的图库编号，关闭立即回到图库0

状态栏提示："选择一个合适内空单击鼠标左键识别内部空间后 1.按： ↑上 ↓下 ←左 →右 ctrl+↓前 ctrl+↑后 添加柜板 2.回车跳到内空图库页面，双击图片即刻插入 3.鼠标右键有其他高级加板功能"

操作流程：
① 左键点击柜体内部的面 → 自动识别封闭内空，生成高亮空间盒（可连续点击追加多个内空）
② 用快捷键、屏幕文字按钮或右键菜单对内空执行加板/编辑操作
方向自适应原理：根据相机视角自动判断当前观察方向（左/右/前/后/顶/底），你从哪个方向看，↑↓←→就对应哪个方向；柜体倾斜/旋转摆放也能正确识别；可用右键“锁定内空方向”把当前视角方向固定住，不再随视角变化
加板快捷键（各自弹出参数弹窗，输入有记忆）：

• ↑/↓ 弹窗"插入层板"（字段：距上或距下 默认0 / 板厚 默认18）
• ←/→ 弹窗"插入竖板"（字段：距左或距右 默认0 / 板厚 默认18）
• Ctrl+↑/Ctrl+↓ 弹窗"插入立板"（字段默认 0.mm / 18.mm）
• 数字 1 弹窗"橫板均分" | 数字 2 弹窗"竖板均分"（字段默认 2 / 18.mm）
• Tab 循环切换临时选中的内空（多内空时逐个操作）
• 单独点按 Ctrl 切换内空插入位置（柜内部/柜外部）；所有加板、抽屉、衣杆、酒架、背板等插入都跟随此设置，“外部”时用世界坐标插入模型顶层

屏幕可点击按钮（鼠标悬停高亮，单击执行）：

• 内空编辑：内空回退 | 内空压缩（弹窗改尺寸） | 内空合并 | 内空分割 | 内空拉伸 | 内空均分
• 加板插件：横板均分 | 竖板均分 | 距前挡板（加拉条） | 距后背板（打开背板参数面板） | 加抽屉 | 加门板 | 加衣杆 | 加组件（打开内空图库，含酒架斜格等）

各功能弹窗字段明细：

• 加拉条：位置（下拉：前面|后面，默认前面）/ 板厚（默认18.mm）/ 缩进（默认0.mm）
• 距后背板：打开 HtmlDialog "0808_插入背板" 参数面板；背板拉条设置弹窗——拉条类型（下拉：竖条|横条）/ 板厚（18）/ 数量（2）/ 宽（60）/ 距上边、距下边（竖条时）或 距左边、距右边（横条时，均默认0）
• 内空分割：弹窗"内空分割"——分割方向（下拉：左右|右左|上下|下上|前后|后前，默认左右）/ 分割数值（如 100,200 逗号分隔）
• 内空均分：弹窗"内空均分"——方向（下拉：左右|上下|前后）/ 份数（默认2）
• 加门板：弹窗"绘制门板"——上盖 / 下盖 / 左盖 / 右盖 / 门板厚度（记忆）/ 门板盖法（下拉：外盖门|内嵌门）/ 门板开向（下拉：左开门|右开门|对开门|抽面|上翻门|下翻门）
• 留空设置：上空 / 下空 / 左空 / 右空 / 前空 / 后空（均默认0.mm）

右键菜单：

• 拉伸内空：进入拉伸子工具——内空六面中心出现绿色手柄（标注上/下/左/右/前/后，悬停变玫红），单击手柄开始拉伸 → 移动预览实时距离 → 再单击确认；支持键盘直接输入：数字=目标尺寸、+数字=延伸、-数字=收缩、*数字=扩大倍数、/数字=缩小倍数；右键“完成”或 Esc 返回主工具
• 选定内空：只保留鼠标所指的那一个内空为当前操作对象
• 均分内空：弹窗输入均分参数，把内空虚拟框分成多份
• 横板均分 / 竖板均分：同数字键 1/2
• 内空回退：恢复上一次的内空选择（未识别内空时右键也只有此项）
• 设置视图大小：调整屏幕功能文字按钮的大小
• 锁定内空方向 / 取消锁定内空方向：把当前视角方向固定到各内空（无锁定时“取消锁定”置灰）
• 0808内空插入位置：弹窗选择插入到柜内部或柜外部（与单独点按 Ctrl 等效）

状态栏提示："鼠标左键识别内部空间后 按： ↑上 ↓下 ←左 →右 ctrl+↓前 ctrl+↑后 添加柜体板"
VCB 输入（拉伸内空子工具）：输入内容自动提取数字按 mm 处理为拉伸距离
注意：Esc 有临时选中内空时先清除临时选择、再按一次重置工具

前提条件：先选中要被替换的组/组件（未选中或选区不含组/组件时会弹窗“请先选择组或组件”并退出）
操作流程（两种方式）：
① 方式一：左键点击场景中的其他组件 → 所选对象立即替换为该组件的定义（保留原位置与方位）
② 方式二：点击空白处或按 Enter → 打开“挑选替换图库”对话框，浏览缩略图后双击目标组件完成替换
视觉提示：鼠标旁显示红色文字“挑选组件 / 点击左键”
状态栏：“点击场景组件来替换所选组件 || 点击空白处文件夹选择组件”
注意：操作名“替换组件”，可 Ctrl+Z 撤销

前提条件：场景中已导入 CAD 平面图（DWG/DXF），选中需要转换的边线
操作流程：
① 选中 CAD 线段 → 点击"CAD转柜" → 弹出参数对话框
对话框参数（8项，记忆上次输入值）：

• 柜体深度（mm）—— 转换后柜体的进深
• 柜板厚度（mm）—— 板件厚度
• 是否立起（是/否）—— 转换后的柜体是否竖立
• 前踢脚缩进（mm）—— 前底板与前面的缩进距离
• 后踢脚缩进（mm）—— 后底板与后面的缩进距离
• 最小过滤值 —— 忽略小于此长度的线段
• 最大过滤值 —— 忽略大于此长度的线段
• 柜子偏移值（mm）—— 生成的柜体相对CAD线的偏移

② 确认参数 → 系统自动将CAD边线转换为三维柜体板件模型

操作流程：
① 鼠标移动悬停组件（自动高亮并显示宽深高尺寸）
② 左键点击选中 → 弹出参数对话框
③ 输入参数后确认 → 自动在组件前面生成门板
掩码字符串格式：

• 1 = 左开门 | 2 = 右开门 | 0 = 抽面
• 示例：120 = 左开门+右开门+抽面（3扇）
• 示例：12 = 对开门（左+右）

对话框（标题"掩码门板"，输入有记忆）：门板掩码（默认12） | 上边留空/下边留空/左边留空/右边留空（各默认0mm） | 门板厚度（默认18mm） | 门板盖法（下拉：外盖门|内嵌门，默认外盖门）
屏幕文字提示：鼠标旁显示 "移动鼠标\n快速选择"；悬停组件时显示 "宽度: / 深度: / 高度:" 实时尺寸
状态栏提示："掩码门板"

操作流程：
① 左键点击第一个点（左下角）—— 开始显示红色矩形框+蓝色填充预览
② 左键点击第二个点（右上角）—— 确定矩形范围
③ 弹窗"两点掩码"（输入有记忆）：门板厚度（默认20mm） | 门板盖法（下拉：外盖门|内嵌门，默认外盖门） | 门板掩码（默认12）
掩码格式：1=左开门，2=右开门，0=抽面；如120=左+右+抽面，12=对开门
视觉反馈：鼠标旁显示"点击左下角"/"点击右上角"提示文字
状态栏提示："对角线掩码画门"
按 Esc：取消并重置

操作流程：
① 左键点击左下角（实时显示红色边框+蓝色填充预览）
② 左键点击右上角 → 确定矩形范围
③ 弹窗"对角画门"（输入有记忆）：

• 门板厚度（默认20mm）
• 门板盖法（下拉）：外盖门 | 内嵌门（默认外盖门）
• 门板开向（下拉）：左开门 | 右开门 | 对开门 | 抽面 | 见光板 | 上翻门 | 下翻门（默认左开门）

屏幕文字提示：鼠标旁显示"点击左下角"/"点击右上角"
状态栏提示："对角线画门"
按 Esc：自动切换到「三点画门」工具

三点状态机：
① 点击第一点（左下）—— 确定起始角点
② 点击第二点（右下）—— 确定宽度方向，VCB显示“Width”，可输入精确宽度
③ 点击第三点（右上）—— 确定高度方向，VCB显示“Height”，可输入精确高度
④ 自动弹窗"三点画门"（字段同对角画门：门板厚度默认20mm / 门板盖法下拉外盖门|内嵌门 / 门板开向下拉左开门|右开门|对开门|抽面|见光板|上翻门|下翻门，输入有记忆） → 确认后生成门板
VCB输入：直接输入数字+回车 = 设定当前方向的精确尺寸（state1=宽度，state2=高度）
状态栏提示：依次显示 "第一点左下" → "第二点右下"（VCB标签 Width） → "第三点右上"（VCB标签 Height），屏幕同步显示三点提示文字
快捷键：Shift 长按锁定推理方向
按 Esc：自动切换到「对角画门」工具

操作流程：
① 先用选择工具选中需要更换样式的门板
② 点击"门板样式" → 打开对话框 "0808_门型图库"（700×500）
③ 左侧为门型分类目录树，右侧为门板样式缩略图预览
④ 双击目标门板样式 → 系统自动将选中门板替换为该样式
图库路径：插件目录下 0808_本地模型仓库/门型图库
注意：该工具为VIP功能

操作流程：
① 先用选择工具框选门板组件
② 点击“拉手安装”按钮 → 打开对话框 "0808_拉手图库"（700×500）挑选拉手样式
③ 选定样式后弹窗 "0808插入拉手" 设置安装参数
弹窗参数（输入有记忆）：

• 拉手位置（下拉）：上横 | 上 | 中 | 下 | 下横（默认中）
• 距离高边（默认70mm）—— 拉手离门板高度方向边缘的距离
• 距离宽边（默认25mm）—— 拉手离门板宽度方向边缘的距离
• 拉手内进（默认0mm）—— 拉手向门板内侧的偏移量

错误提示：未选中门板时弹窗 "请框选你想要添加拉手的门板!"
智能识别：自动识别门板类型（左开/右开/上翻/下翻/抽面）并计算对应安装坐标

操作流程：
① 用选择工具框选含有拉手的门板组件（可多选）
② 点击"删除拉手"按钮
③ 系统递归查找所有名称包含"l_拉手"的组件实例并删除
结果：弹出通知"拉手已经全部删除完毕"
注意：未选中组件时会弹出提示"请框选要删除拉手的门板"

操作流程：
① 先用选择工具框选门板组件
② 点击“铰链安装”按钮 → 弹窗 "半自动加装铰链"（字段：铰链类型，下拉：大弯铰链|中弯铰链|直背铰链，默认中弯铰链，记忆）
③ 确认后自动安装
自动计算规则（根据门高）：

• 300-400mm → 2个铰链，距边 100mm
• 400-900mm → 2个铰链，距边 120mm
• 900-1500mm → 3个铰链，距边 120mm + 中间均分

智能识别：自动区分左开门/右开门/上翻门/下翻门，并计算对应侧的安装位置

操作方式：一键切换（无需选择，无对话框）
工作原理：遍历模型所有图层（标记），找到名称包含"柜门"的图层，切换其可见性
使用场景：

• 查看柜体内部结构时，点击隐藏所有门板
• 再次点击，门板重新显示

前提：门板组件需分配在名称含"柜门"的图层上（插件创建的门板默认已设好）

操作方式：点击工具图标 → 开/关切换小窗（菜单项带勾选状态）
窗口规格：标题“0808_工具箱”，200×600 可缩放，加载 Vue 前端面板
权限逻辑：

• 小窗本身免费打开，内部工具按钮逐一做登录/VIP 校验
• 登录、用户中心、网站主页、视频教程、图文教程、打开插件文件夹、设定语言、历史更新、赞助等入口免校验

相关设置：菜单“0808小窗显隐设置” → 弹窗 "0808网页显隐设置"（字段：0808工具箱网页，下拉：显示|关闭），确定后提示 "设置成功,下次开启SU后生效!"

操作流程：
① 用选择工具选中一个或多个矩形面
② 点击“面生体”按钮 → 弹窗 "面生框体"（输入有记忆）
弹窗参数：

• 厚度（默认20）—— 生成实体的厚度
• 往面前后（下拉：往面前|往面后，默认往面前）—— 结果向面的哪个方向拓展
• 删除所选（下拉：是|否，默认是）—— 生成后是否删除原始面

注意：仅处理矩形面，非矩形面将被跳过

操作流程：
① 选中要处理的组/组件 → 点击“体生面” → 弹出“体生平面”参数对话框
② 确认参数 → 按包围盒在指定朝向生成矩形平面
对话框参数（记忆上次输入）：

• 四方面（下拉：前面|后面|左面|右面，默认前面）—— 在哪个朝向生成平面
• 是否隐藏原框体（下拉：是|否，默认是）—— 生成后是否隐藏原三维柜体

后续动作：自动清理孤立边线，并自动激活“切割平面”工具方便继续分割
注意：需先选中组/组件；常用于“柜体 → 平面分割 → 重新生成柜体”的快速重建流程

操作流程：
① 移动鼠标拾取参考边（自动高亮）→ 左键确认进入偏移状态
② 移动鼠标 → 显示与参考边平行的虚线预览
③ 左键点击创建平行分割边（或辅助线），或在 VCB 输入距离精确定位
快捷键与 VCB：

• Ctrl（弹起时）切换创建分割边 / 辅助线模式
• VCB 输入长度（标签“距离mm”）→ 按精确距离创建
• 分割完成后输入 *N 或 Nx → 阵列复制 N 份 | 输入 /N → 按间距 N 等分（自动先撤销再重建）
• Esc 重置到拾取参考边状态

状态栏：“创建与拾取的边平行的边 按Ctrl创建辅助线”/“创建平行于拾取边的辅助线 按Ctrl创建边”
注意：支持在组/组件内部的面上直接操作（坐标自动变换）；搭配“体生面”使用效率更高

前提条件：先选中一个组/组件作为占位模板体（代表门板区域的总范围）
操作流程：
① 点击“掩码站位” → 弹出“掩码门板站位”对话框，输入门板掩码（默认12，记忆上次输入）
② 确定后按掩码字符数均分模板体宽度，从左到右逐扇缩放放置门板，最后自动删除原模板体
掩码规则（每字符 = 一扇门，从左到右）：

• 1 = 左开门 | 2 = 右开门 | 0 = 抽面
• 门板组件取自本地仓库 柜门样式/平板门/ 目录，可自行替换样式
• 生成的门板自动归入门板图层，动态组件自动重绘

注意：操作名“掩码门板站位”，可 Ctrl+Z 撤销；未选中模板体时无法执行

操作流程：
① 用选择工具选中要拆散的打包柜体
② 点击“柜体拆散”按钮
执行顺序：删除属性 → 删除隐藏 → 递归炒开所有嵌套层级
结果：弹出通知“已经拆散所有打包柜体”，最底层板件自动被选中
错误提示：未选中时弹窗“请选中要拆散的打包柜体”

操作流程：
① 用选择工具选中一个组件（必须是组件实例，不能是组）
② 点击“三视图”按钮 → 弹窗“生成三视图”（输入有记忆）
弹窗参数：

• 间距（默认200）—— 视图之间的间隔距离
• 方位（下拉：上左|上左右|上右，默认上右）

错误提示弹窗：未选或多选时“请选择一个组件进行操作”；组件轴不一致时“组件轴和场景的轴必须保持一致”

操作流程：
① 激活工具 → 自动弹出对话框“拾取面生成体”（400×300 厚度预设面板，默认厚度 550）
② 鼠标移动到组件内的面上 → 自动高亮显示（蓝色半透明）
③ 左键点击 → 立即生成实体板件
视觉反馈：

• 蓝色半透明高亮矩形面 + RGB三色轴箭头 + 尺寸标注
• 非矩形面显示红色屏幕文字“这个面不满足算法\n请选择任意矩形面！”

错误提示弹窗：点击非矩形面时“这个面不满足算法，请选择任意矩形面！”
右键菜单：-重设厚度 | -重设外层坐标轴

操作方式：
① 鼠标移动到组件面上（自动捕捉最近角点并预览切口形状）
② 左键单击完成开洞
模式切换（Tab 循环）：

• 直角模式 → 切掉矩形角
• 圆角模式 → 倒圆角
• 圆洞模式 → 在角点附近开圆形孔

VCB输入格式：

• 圆角模式：VCB标签“圆角半径”，输入半径（如 150）
• 直角/圆洞模式：VCB标签“距离长边(红色)+距离宽边(绿色)”，输入距红边+距绿边（如 200+150）

屏幕横幅提示（Tab切换时）："按TAB键可以切换，当前为：直角模式" / "…圆角模式" / "…圆洞模式"；画圆时显示 "半径:数值"
状态栏提示："单击鼠标左键完成开洞，鼠标右键重设切口尺寸，当在直角和圆洞模式下可键盘输入距红绿边的尺寸，在圆角模式下可键盘输入圆角半径"
默认切口尺寸（记忆）：长100 / 宽150 / 圆角半径200 / 圆洞半径150
右键菜单：-重设切口尺寸（弹窗修改以上四项）

操作方式：
• 左键点击 → 将当前面的材质贴图旋转 90°（通过UV坐标重新计算）
• 右键菜单：

• 清除面所在组材质（板）—— 仅清除当前板件的材质
• 清除最外层组材质（柜）—— 清除整个柜体所有嵌套组件的材质

状态栏："单击鼠标左键贴图旋转90度，鼠标右键局部和整体清除材质"

操作流程：
① 将「贴片组」（扁平组）紧贴在需要开口的组上
② 全选贴片组和被开口的组 → 点击“刻章”按钮
③ 系统自动分离扁平组（刻章贴片）和非扁平组（被开口实体）
④ 通过射线检测确定开口深度，执行 PushPull 创建凹槽
结果通知："刻章工具运行完毕，组内所有嵌套实体被释放压缩，如果贴片组紧贴需要开口的组就会被开口"

4步状态机：
① 选第1点（底面起始角）
② 选第2点（底面长度方向），可 VCB 输入精确长度
③ 选第3点（底面宽度方向），可按 1-9 快捷生成
④ 选第4点（高度方向），可按 1-9 快捷生成
快捷键：

• Tab 切换绘制模式：角点 → 边线中点 → 中心
• 1-9 快捷高度（默认 18/36/50/100/200/300/400/500/600mm，可自定义）
• ↑ 锁定Z轴蓝色 | ← 锁定Y轴绿色 | → 锁定X轴红色
• ↓ 打开设置对话框
• Shift 锁定推理方向
• Enter state>1时以当前尺寸生成 | 双击 = state3时生成

特殊捕捉点（tooltip）："正方形" | "黄金分割点" | "面中心" | "1/3"
VCB输入：支持加减乘除运算（如 500+100、300*2）
状态栏提示："盒子模式:绘制盒子条件 {角点/边线中点/中心}(按 TAB 进行切换) | 创建 组/组件: {无/组/组件}(右键设置)| " + 阶段提示 "选择第1点" / "选择第2点" / "按 1-9 快捷生成(可选第3点定底面宽)" / "按 1-9 快捷生成(可选第4点定高度)"
设置弹窗：按 ↓ 或右键"设置参数" → 弹窗"输入参数框"（字段：名称 默认Box / 绘制模式 下拉：角点|边线中点|中心 / 创建 组/组件 下拉：无|组|组件）；右键"设置快捷高度" → 弹窗"设置快捷高度"（字段："快捷高度(mm，逗号分隔)"，默认 18,36,50,100,200,300,400,500,600）
右键菜单：角点|边线中点|中心（勾选） | 无|组|组件（勾选） | 设置参数 | 快捷高度九项（"1: 18mm"…"9: 600mm"） | 设置快捷高度

操作流程：
① 点击工具 → 打开 300×817 Vue 参数化选项面板（常驻侧边栏）
② 在场景中选中一个参数化柜体 → 面板自动同步显示该柜体的参数
③ 修改参数值后点击确认 → 柜体自动按新参数重建
面板内容：

• rule_infos（规则参数）：柜体宽度、柜体深度、柜体高度等基础尺寸
• custom_inputs（自定义参数）：板厚、踢脚高、背板厚度等可选配置

智能联动：选中不同柜体时面板自动刷新；使用缩放工具调整后自动读取新尺寸并重建
对话框：标题 "0808_参数化柜体选项"（300×817 可缩放，STYLE_UTILITY 常驻）
错误提示弹窗："请选中一个0808参数化柜体"（未选中或选中的不是组/组件时） | 重建异常时弹窗显示错误信息
注意：必须选中带有 0808_cab_dict 属性的参数化柜体才能显示参数

操作流程：
① 点击工具 → 打开 300×817 模板选择面板
② 面板显示 Resources 目录下所有 JSON 模板文件列表（按文件名显示）
③ 点击目标模板名称 → 系统读取 JSON 参数文件并在场景原点生成柜体
对话框：标题 "0808_参数化柜体生成"（300×817 可缩放，STYLE_UTILITY 常驻）
模板管理：

• 模板位于 0808_Parametric/Resources/ 目录
• 支持子目录分类存放（自动递归扫描所有 .json 文件）
• 可通过"参数化编辑"工具直接打开目录手动编辑模板

注意：生成的柜体为完整的参数化柜体，后续可用"参数化选项"修改参数

操作方式：点击工具 → 系统文件管理器打开 0808_Parametric/Resources 资源目录（Windows 用资源管理器、macOS 用访达）
目录内容：存放参数化柜体的 JSON 配置模板（尺寸、板件、规则定义）
使用建议：

• 用文本编辑器（VS Code 等）编辑 JSON，保存后参数化功能即可读取新模板
• 编辑前建议先备份原文件，JSON 格式错误会导致模板加载失败

适用人群：需要自定义参数化柜体模板的高级用户

操作流程：
① 点击工具 → 自动激活板件拾取工具并打开 300×817 参数面板
② 在场景中点击/框选板件 → 面板显示该板件的完整参数信息
③ 在面板中修改参数并确认 → 柜体自动按新参数重建
拾取方式：

• 点选：左键单击选中单个板件（自动识别参数化板件）
• 框选：从左到右框选 = 仅内部（实线框）；从右到左 = 交叉选择（虚线框）

面板功能：

• 修改（say）：修改板件参数（尺寸、位置、材质等）后重建柜体
• 删除（delete_board）：从柜体中删除当前选中的板件
• 复制（add_board）：复制当前板件（Z方向自动偏移 +100mm 避免重叠）

视觉反馈：选中板件显示蓝色边界框 + 板面四角标注（0/1/2/3）+ 红色/绿色方向边线
对话框：标题 "0808_板件参数编辑器"（300×817 可缩放，STYLE_UTILITY 常驻）
错误提示：重建异常时弹窗显示错误信息

操作流程：
① 左键点击选择参数化柜体 → 显示黄色边界框+六面绿色操控方块
② 鼠标悬停方块（变黄色）→ 左键点击选中（变红色）
③ 拖动鼠标拉伸 → 显示洋红色虚线和距离值
④ 再次左键点击确认，或在 VCB 输入精确值
VCB输入格式：

• 数字 设为模型绝对尺寸（如 500 = 该方向总长变为500mm）
• +数字 延伸指定距离 | -数字 收缩指定距离
• *数字 扩大到指定倍数 | /数字 缩小到1/n

右键菜单：显示参考点（可勾选）
屏幕文字提示：拉伸中在目标点旁实时显示当前拉伸距离数值
状态栏提示：随操作阶段动态更新操作指引
错误提示：选中对象非参数柜体时弹出通知 "非参数柜体，不支持拉伸"
拉伸路径：有切片时使用切片拉伸，无切片时使用参数化重建

操作步骤：
① 鼠标移到第一条边线上 → 左键点击选择（边变红高亮）
② 鼠标移到第二条边线上，点击前上下滑动可改变标注方向
③ 左键点击第二条边 → 完成标注
VCB输入：标签 "标尺偏移距离"，输入偏移量后回车（默认100，输入有记忆）
状态栏提示："移动鼠标到线上点击左键选择一条边，再次点击左键选择另一条边完成标注 | 点击第二条边之前上下滑动鼠标可以改变标注方向 | 标注偏移量设置在屏幕右下角直接输入后回车"

操作步骤：
① 鼠标移到面上 → 自动显示最近边线的标注预览
② Tab 切换标注方向（4个方向循环：向鼠标方向 / 反向 / 面法线方向 / 面法线反向）
③ 左键点击完成标注
VCB输入：标签 "标尺偏移距离"，输入偏移量后回车（默认100，输入有记忆，非法输入蜂鸣清空）
屏幕文字提示：标注预览中央显示尺寸数字（12号黑色粗体居中）
状态栏提示："移动鼠标到面上到标注预览出现点击左键完成标注 | TAB键切换4个标注方向 | 标注偏移量设置在屏幕右下角直接输入后回车"

操作步骤：
① 鼠标移到面上 → 自动检测最近边线并标注预览
② Tab 切换标注方向（4个方向循环）
③ 左键点击 → 标注所有经过该线的板件交点（自动批量标注）
VCB输入：标签 "标尺偏移距离"，输入偏移量后回车（默认100，输入有记忆）
状态栏提示："移动鼠标到面上到标注预览出现点击左键完成标注 | TAB键切换4个标注方向 | 标注偏移量设置在屏幕右下角直接输入后回车"
特点：自动递归遍历选中组件内所有边线并批量标注，最后生成一条总距离标注

三点操作流程：
① 点击第一点（起点）
② 点击第二点（终点）—— 定义测量线方向
③ 点击第三点（方向点）—— 确定标注偏移方向，自动批量标注所有交点
快捷键：

• Shift 锁定推理方向
• ↑↓ 锁定Z轴蓝色 | ← 锁定Y轴绿色 | → 锁定X轴红色

VCB输入：第二点前标签 "Width" 输入测量线长度 | 第三点前标签 "Height" 输入偏移距离（非法输入蜂鸣清空）
状态栏提示：依次显示 "点击第一点起点" → "点击第二点终点" → "点击第三点确定方向点"
屏幕文字提示：光标旁跟随显示当前步骤文字（同状态栏），并有推理点 tooltip
特点：自动检测测量线与组件内所有面的交点，两两标注并跳过距离<5mm的点

操作流程：
① 选中要清除标注的范围（可直接选标注，也可框选含标注的组/组件）
② 点击“删除标注” → 立即执行，无对话框
执行逻辑：

• 递归遍历选区，自动进入未锁定的组/组件内部查找尺寸标注
• 多实例组件先自动 make_unique，避免影响场景中其他实例的标注
• 锁定的组件会被跳过不处理

注意：操作名“0808删除选中标注”，可 Ctrl+Z 撤销；异常时仅蜂鸣提示不弹窗

操作流程：
① 用选择工具选中包含板件的柜体组
② 点击"生成五金"按钮
③ 系统自动分析板件拼接关系，根据板类属性添加对应的五金连接件
无对话框：一键执行，全自动分析和生成
结果：每个板件拼接处自动添加三合一/木榫等五金组件，柜体标记 hardware=true
注意：板件需已设置正确的板类属性和连接方式，否则五金可能不完整

操作流程：
① 激活工具 → 左键点击板件进行选择（可多选切换：已选移除/未选添加）
② 选中板件后自动弹出连接方式列表对话框
③ 选择新的连接方式 → 自动删除旧五金并重新生成
视觉反馈：选中板件显示蓝色半透明边界框
对话框：标题 "修改连接方式"（300×817 可缩放，STYLE_UTILITY），列出可选连接类型
右键菜单：完成（执行替换并退出）
错误提示弹窗："请先选中柜子"（执行时未选中任何板件）
注意：仅允许点击板件，不允许点击五金件；点击空白处清空选择

操作流程：
① 用选择工具选中包含五金的柜体组
② 点击"删除五金"按钮
③ 系统遍历柜体内所有五金组件定义并删除，重置 hardware 属性为 false
无对话框：一键执行，无弹窗提示；未选中时不执行任何操作（静默）

操作流程：
① 用选择工具选中包含五金的柜体组
② 点击"导出生产数据"按钮
③ 系统自动在桌面创建"导出生产数据"文件夹（已存在则清空重建）
④ 将各板件的五金孔位、连接信息导出为文件
导出路径：~/Desktop/导出生产数据/
无对话框：一键导出，导出完成后无额外提示
错误提示弹窗："请求失败"（网络请求异常时） | "材质xx 规格xx 未绑定物料信息"（料单导出时对应物料未绑定）

操作流程：
① 激活工具 → 清空选择，屏幕顶部显示当前参考点类型
② 左键点击五金件 → 选中并弹出参数对话框
③ 在VCB或对话框中输入偏移距离 → 实时预览移动后位置（洋红色箭头+距离值）
④ 右键菜单选择"完成移动"/"完成复制" → 执行操作
快捷键：

• Tab 循环切换参考点：自身参考 → 起点参考 → 终点参考
• Ctrl(Win) / Command(Mac) 按住切换复制模式

VCB输入：标签 "五金移动"（默认100，记忆），直接输入偏移距离（mm）+回车 = 实时预览（正数向外，负数向内）
对话框：标题 "五金移动(Ctrl复制)"（160×285，STYLE_UTILITY 小面板），可选参考点与移动距离
屏幕文字提示：屏幕顶部显示当前参考点类型（自身参考/起点参考/终点参考，默认自身参考）；预览时洋红色箭头+距离值
右键菜单：完成移动 / 完成复制
状态栏提示："查看屏幕上方，按Tab切换平移参考点，键盘直接输入偏移距离回车即可看到偏移后预览，右键完成偏移。按住Ctrl键可复制五金件"（Mac 为按住Command）

操作流程：
① 用选择工具选中一个组件实例
② 点击"规整轴向"按钮
③ 系统自动将组件的坐标轴转换为与场景世界轴一致的方向
④ 完成后弹窗提示 "更改成功"
用途：解决组件轴向不规则导致拆单导出数据异常的问题

操作方式：点击工具 → 弹出通知“正在后台计算，请你耐心等待！！！” → 自动生成并打开 Excel
输出文件：保存到本地仓库 0808_BOM 目录，文件名“0808_BOM 模型名 时间戳.xlsx”，完成后自动打开表格及所在文件夹
三个工作表：

• 柜体清单：统计“0808_柜体计价”图层（标记）上的组件
• 柜门清单：统计“0808_柜门计价”图层上的组件
• 五金清单：按组件定义名识别，名称含“拉手/挂衣杆/滑道/铰链/轨道”或任意含“0808”字样（如 0808_abc）

表格列：序号 | 名称 | 缩略图 | 宽(mm) | 高(mm) | 深(mm) | 数量 | 单价 | 合计 | 备注（默认单价：柜体/柜门 250、五金 25，公式自动求合计，可在 Excel 中直接改单价）
空结果通知原文："没有查找到柜体，请确保柜体在 0808_柜体计价 图层（标记）" | "没有查找到门板，请确保柜体在 0808_柜门计价 图层（标记）" | "没有查找到任何五金，请确保五金模型定义包含 拉手，挂衣杆，滑道，铰链，轨道，或者任意名字包含0808字样，（例如0808_abc）"（对应类别为空时各自弹通知）
注意：表尾标注“su0808工具箱提供报表（仅供参考）”

操作方式：点击工具 → 直接打开内嵌 OpenCutList 对话框的材料（materials）页面
主要功能：

• 材料管理：定义板材类型（板件/实木/型材）、厚度与标准尺寸
• 零件清单：自动提取场景中各板件的尺寸、数量、材质并归类汇总
• 开料图：按板材规格自动排版，输出利用率和切割方案，可导出打印

使用建议：统计前先给板件赋好材质、用“深层命名”规范板件名称，清单可读性更好；详细用法参见 OpenCutList 官方文档

操作流程：
① 选中要出图的组/组件（或不选则处理整个模型）
② 点击"工程图预览导出" → 打开 960×700 预览对话框
③ 系统自动逐个生成部件工程图（显示进度条）
④ 左侧部件列表可点击选择查看，右侧 Canvas 实时绘制预览
导出设置：

• 导出目录 —— 点击"更改目录"选择保存位置
• 文件前缀 —— 默认"cabinet"，可自定义
• 合并导出 —— 所有部件合并为 1 个 DXF 文件
• 分开导出 —— 每个部件单独 1 个 DXF 文件

文件命名：前缀_部件名_时间戳.dxf
对话框：标题 "SU0808 工程图预览与导出"（960×700 可缩放，STYLE_DIALOG），内含预览画布与进度条
状态栏提示："预览工程图并导出 DXF"
结果：导出完成弹窗显示导出文件数量和前几个文件名；失败时弹窗 "导出失败: （错误信息）"

操作方式：一键导出（无预览对话框）
前提：已通过"工程图预览导出"设置过导出目录
流程：选中组/组件 → 点击按钮 → 直接导出到上次设置的目录
状态栏提示："使用上次目录快速导出 DXF"
结果弹窗：成功时 "导出成功 N 个文件:" + 文件列表（最多列出前 8 个，超出显示“...”） | 失败时 "导出失败: （错误信息）"

操作方式：点击工具 → 自动打开 0808 小窗并跳转对应页面
两种状态：

• 已有登录会话：自动恢复登录态并直接打开用户中心面板
• 未登录：显示登录页，自动预填上次登录的账号

用户中心功能：查看账号信息、VIP 到期时间、充值续费、邀请码、头像上传、退出登录等
对话框：标题 "0808_工具箱"（200×600 可缩放，STYLE_UTILITY，即 0808 小窗）
提示弹窗："请登录0808"（未登录调用受限功能时，随后自动跳登录页） | VIP 到期时弹出到期提示 | "无法获取邀请码，请重新登录" | 头像上传选择非图片时 "请使用 JPG 或 PNG 格式"（选择文件对话框标题 "选择头像图片"）
通知："头像已更新" / "头像上传失败：（错误详情）" | "su0808网络鉴权成功，无需登录"（自动登录成功，3秒内去重）

操作方式：点击工具 → 默认浏览器打开官网 www.su0808.com
网站内容：插件下载、功能介绍、VIP 购买、教程入口、联系方式等

操作方式：点击工具 → 浏览器打开官方 B 站空间 space.bilibili.com/14012018
内容：各工具的实操演示、完整建模流程案例、新版本功能介绍；建议新手从入门系列看起

操作方式：点击工具 → 浏览器打开幕布文档 mubu.com/doc/7A-7OFr3QlS
内容：按工具栏分类的图文说明、快捷键清单、常见问题解答；适合随查随用当字典使用

操作方式：点击工具 → 文件管理器打开 0808_本地模型仓库 目录
仓库作用：

• 存放“快速替换”“掩码门板”“柜体封板”“柜门样式”等功能调用的 skp 组件文件
• 按目录分类管理，文件名即功能对应关系（如『快速替换左边数字1.skp』）
• 用户可自行替换/新增同名 skp 实现自定义组件库

注意：替换文件时保持文件名不变，各工具才能正确读取

操作流程：
① 激活工具 → 弹窗"墙体参数"（字段：墙高 默认2800 / 墙厚 默认120 / 对齐方式 下拉：左|中|右 默认右，输入有记忆；点取消即退出工具）
② 左键逐点点击确定墙体路径（实时显示墙体预览）
③ 双击左键或按 Enter 完成绘制（首尾相连自动封闭）
快捷键：

• Shift 锁定推理方向
• ← 锁定Y轴 | → 锁定X轴 | ↑ 锁定Z轴 | ↓ 解锁

VCB输入：标签“输入距离”，输入数值+回车按当前方向偏移
状态栏提示（兼鼠标tooltip）：起点前 "选择起始点 | Shift键锁定推理 | 方向键锁定轴" → 取点中 "继续选择点（基于上一个点的推理） | 双击左键或者回车完成绘制 | Shift键锁定两个捕捉点推理 | 左右方向键锁定绿红轴 | 下方向键解锁 | 收尾相连自动封闭"

操作流程：
① 激活工具 → 弹窗"窗户参数"（字段：窗户宽 默认1200 / 窗户高 默认1500 / 上下距离 默认900 / 窗类型 下拉：开洞|A|B，输入有记忆；点取消即退出工具）
② 移动鼠标到墙面 → 窗洞矩形实时预览，鼠标靠近哪侧参照就锚定哪侧，距参照小于50mm自动吸附
③ 单击或 Enter 放置窗户，完成开洞
快捷键：

• ←→ 增减窗格竖条数量（1~20） | ↑↓ 增减横条数量
• Esc 重选墙面

VCB输入：标签"边距"，输入 "左右距,上下距"（如 500,900）回车相对最近参照精确定位；非法输入蜂鸣清空
屏幕尺寸文字："距左/距右/距下/距上" + 数值（深紫红加粗）
状态栏提示："移动鼠标到墙面放置窗户"（未框面） → "移动鼠标定位窗户 | 输入 左右距,上下距 回车 = 精确定位 | 单击或回车 = 放置 | 方向键 = 窗格条 | Esc = 重选墙面"（已框面） → 超宽时 "窗户宽度超过墙面范围，请缩小尺寸"
错误提示弹窗："窗户宽度超过墙面范围，请缩小尺寸"（超宽仍放置） | "再选中一次墙体"（射线未命中墙） | "这个墙不适合开窗洞"（墙面不连续）

操作流程：
① 点击工具 → 打开对话框 "0808_本地模型库"（1243×721，可视化浏览）
② 左侧按目录树切换分类，右侧缩略图网格预览仓库中的组件
③ 双击目标缩略图 → 进入内空插入模式：左键连续点击选中柜体内空（可多选） → 按 Enter 或右键“确定_插入部件”把组件批量插入到所有已选内空
保存模型入库：选中一个组/组件后在对话框中保存 → 弹窗"给你的模型取个好听的名字吧！"（字段：什么名字呢?）；名称已存在时提示"名称重复"；未选中时提示"请选择一个组或者组件"
删除模型：弹窗确认"你确定要删除这个模型?"（是/否）
首次初始化：弹窗"图库初始化 请指定图库位置！" → 选择目录；所选目录无 skp 时提示"当前目录未找到skp文件 请重新指定目录！"
状态栏提示：插入模式 "左键连续点击选中空间后，回车或者右键菜单确定插入" → 移动放置时 "点击鼠标右键或者回车确定"
右键菜单（插入模式）：确定_插入部件 | 回退_到上一次内空状态
插入位置：跟随“0808内空插入位置”设置（柜内部/柜外部），“外部”时用世界坐标插入模型顶层
仓库来源：即本地模型仓库目录，自行添加的 skp 会同步出现在浏览器中
注意：VIP 功能，需登录且 VIP 未到期

操作方式：点击工具 → 打开对话框 "0808历史更新"（620×820 可缩放，STYLE_DIALOG），按版本列表展示更新日志
状态栏/tooltip：状态栏 "更新历史 - 当前版本: （版本号）"，悬停提示 "查看更新历史 (版本号)"
版本信息：

• 工具栏按钮悬停提示显示当前版本号（读自本地版本配置文件）
• 日志按版本倒序排列，包含新增功能、优化项与修复内容

使用建议：升级插件后先看一遍新版日志，了解新功能和操作变化