from __future__ import annotations from datetime import datetime import math from pathlib import Path from PySide6.QtCore import Qt, QThread, QTimer, Slot from PySide6.QtWidgets import ( QApplication, QFileDialog, QLineEdit, QMessageBox, QPushButton, QTableWidgetItem, QTreeWidgetItem, ) from PySide6.QtGui import QColor from .constants import SNAPSHOT_FACE_LOGICAL_IDS_KEY from .model import StepModel from .records import OperationRecord from .ui_helpers import * # noqa: F403 from .workers import EditWorker, LoadWorker, ScanWorker PROPERTY_VALUE_TOLERANCE = 1e-9 def _record_message_field(message: str | None, key: str) -> str | None: if not message: return None marker = f"{key}=" start = str(message).find(marker) if start < 0: return None start += len(marker) end = str(message).find(",", start) if end < 0: end = len(str(message)) value = str(message)[start:end].strip().rstrip(".") return value or None def _triple_or_none(value: object) -> tuple[float, float, float] | None: if isinstance(value, str): text = value.strip().strip("()[]") chunks = [chunk.strip() for chunk in text.replace(";", ",").split(",") if chunk.strip()] elif isinstance(value, (list, tuple)): chunks = list(value) else: return None if len(chunks) != 3: return None try: return (float(chunks[0]), float(chunks[1]), float(chunks[2])) except (TypeError, ValueError): return None def _int_or_none(value: object) -> int | None: try: return int(value) except (TypeError, ValueError): return None class WindowStateMixin: def _reset_selection(self, clear_highlight: bool = True, clear_info: bool = True) -> None: self.selected_kind = None self.selected_part_id = None self.selected_solid_id = None self.selected_face_id = None self.selected_edge_id = None self.selected_pick_position = None if clear_info: self._clear_current_object_info() if clear_highlight: self._clear_highlight() self._update_selected_object_title() self._update_action_states() def _clear_current_object_info(self) -> None: self.current_info_values = {} self.current_info_text = "" if hasattr(self, "info_tree"): self.info_tree.clear() if hasattr(self, "info_text"): self.info_text.clear() self._clear_property_editor() def _show_pick_marker(self, pick_position: tuple[float, float, float] | None) -> None: if getattr(self, "pick_marker_actor", None) is not None and hasattr(self, "renderer"): self.renderer.RemoveActor(self.pick_marker_actor) self.pick_marker_actor = None if getattr(self, "render_window", None) is not None: self.render_window.Render() def _with_pick_info( self, info: dict[str, object], pick_position: tuple[float, float, float] | None, ) -> dict[str, object]: if pick_position is None: return info enriched = dict(info) enriched["pick_position"] = pick_position return enriched def _selection_status(self, message: str, pick_position: tuple[float, float, float] | None) -> str: if pick_position is None: return message return f"{message}，拾取点 {_format_value(pick_position)}" def _edit_busy(self, message: str = "编辑计算中，请等待当前操作完成。") -> bool: if self.load_in_progress: self.statusBar().showMessage("STEP background loading is still running.") return True if self.operation_in_progress: self.statusBar().showMessage(message) return True if self.scan_in_progress: self.statusBar().showMessage("扫描中，请等待扫描完成后再执行该操作。") return True return False def _sync_id_picker(self, kind: str, target_id: int) -> None: self.last_id_kind = kind self.id_input.setText(str(target_id)) self._update_id_select_title(kind) def _update_action_states(self) -> None: self._update_selected_object_title() self._update_id_select_title() if not hasattr(self, "mode_combo"): return has_loaded_model = self.model is not None busy = self.operation_in_progress or self.scan_in_progress or self.load_in_progress has_model = has_loaded_model and not busy selected_kind = self.selected_kind has_selection = any( item is not None for item in ( self.selected_part_id, self.selected_solid_id, self.selected_face_id, self.selected_edge_id, ) ) has_part = self.selected_part_id is not None has_solid = self.selected_solid_id is not None has_face = self.selected_face_id is not None and selected_kind in {"face", "feature"} has_edge = self.selected_edge_id is not None and selected_kind == "edge" id_text = self.id_input.text().strip() if hasattr(self, "id_input") else "" history_row = self.history_list.currentRow() if hasattr(self, "history_list") else -1 has_history = has_model and bool(getattr(self, "operation_history", [])) has_history_selection = has_history and 0 <= history_row < len(self.operation_history) has_diff_preview = has_model and bool(getattr(self, "diff_actors", [])) has_measure_points = bool(getattr(self, "measure_point_a", None) or getattr(self, "measure_point_b", None)) has_measure_result = bool(getattr(self, "measure_point_a", None) and getattr(self, "measure_point_b", None)) pick_value = getattr(self, "current_info_values", {}).get("pick_position") has_pick_position = self.selected_pick_position is not None or ( isinstance(pick_value, (tuple, list)) and len(pick_value) == 3 ) selected_id_text = self._selected_id_text() if hasattr(self, "_selected_id_text") else "" has_current_info = bool(getattr(self, "current_info_text", "")) wait_or_load_tip = "请先加载 STEP 文件，或等待当前后台任务完成。" if hasattr(self, "open_button"): self._set_control_state( self.open_button, not busy, "导入一个 .step 或 .stp 几何模型。", "请等待当前后台任务完成后再导入其他几何模型。", ) self._set_control_state( self.reload_button, has_loaded_model and not busy, "按当前显示路径读取 STEP 模型。", wait_or_load_tip, ) if hasattr(self, "quick_export_all_button"): self._set_control_state( self.quick_export_all_button, has_model, "导出当前完整 STEP 模型。", wait_or_load_tip, ) if hasattr(self, "part_tree"): self._set_control_state( self.part_tree, has_model, "从结构树中选择零件、Solid 或装配节点。", wait_or_load_tip, ) if hasattr(self, "mode_combo"): self._set_control_state( self.mode_combo, not busy, "选择模式决定鼠标点击模型时按什么对象类型选择。", "请等待当前后台任务完成后再切换选择模式。", ) if hasattr(self, "id_input"): self._set_control_state( self.id_input, True, "输入要选中的对象 ID；加载模型后可点击选择按钮跳转。", "输入要选中的对象 ID；加载模型后可点击选择按钮跳转。", ) self._set_control_state( self.select_id_button, has_model and bool(id_text), "按当前选择模式跳转到输入的 ID。", "请先加载模型并输入整数 ID。", ) if hasattr(self, "export_all_button"): self._set_control_state( self.export_all_button, has_model, "导出当前完整 STEP 模型。", wait_or_load_tip, ) self._set_control_state( self.export_check_button, has_model, "检查当前导出对象的 B-Rep、数量、体积和包围盒等质量信息。", wait_or_load_tip, ) self._set_control_state( self.export_part_button, has_model and has_part, "导出当前选中对象所属零件。", "请先选择零件，或选择属于某个零件的 Solid、Face 或 Edge。", ) self._set_control_state( self.export_solid_button, has_model and has_solid, "导出当前选中对象所属 Solid。", "请先选择 Solid，或选择属于某个 Solid 的 Face 或 Edge。", ) self._set_control_state( self.export_face_button, has_model and has_face, "导出当前选中的 Face 或同域面区域。", "请先在 Face 或特征模式下选择一个 Face。", ) self._set_control_state( self.export_feature_button, has_model and selected_kind == "feature" and self.selected_face_id is not None, "导出特征模式识别到的区域。", "请先切换到特征模式并选择孔、槽、圆角或凸台候选。", ) self._set_control_state( self.export_edge_button, has_model and has_edge, "导出当前选中的 Edge。", "请先切换到 Edge 模式并选择一条 Edge。", ) if hasattr(self, "repair_model_button"): self._set_control_state( self.repair_model_button, has_model, "对当前完整模型执行 ShapeFix 和同域面/边合并，并写入撤销历史。", wait_or_load_tip, ) self._set_control_state( self.repair_selected_button, has_model and (has_solid or has_part), "优先修复当前选中对象所属Solid；没有Solid时修复所属零件，并写入撤销历史。", "请先选择零件、Solid、Face 或 Edge，或等待当前后台任务完成。", ) if hasattr(self, "isolate_button"): self._set_control_state( self.isolate_button, has_model and has_selection, "只显示当前选中的对象或区域。", "请先加载模型并选择零件、Solid、Face、Edge 或特征。", ) self._set_control_state( self.fit_button, has_model and has_selection, "把相机对准当前选中对象。", "请先加载模型并选择一个对象。", ) self._set_control_state( self.show_all_button, has_model, "恢复显示完整模型。", wait_or_load_tip, ) self._set_control_state( self.show_internal_edges_checkbox, has_model, "显示或隐藏同域内部拓扑边。", wait_or_load_tip, ) if hasattr(self, "set_measure_a_button"): measure_point_tip = "把当前选中对象的拾取点或中心设为测量点。" self._set_control_state( self.set_measure_a_button, has_model and has_selection, measure_point_tip, "请先加载模型并选择一个对象。", ) self._set_control_state( self.set_measure_b_button, has_model and has_selection, measure_point_tip, "请先加载模型并选择一个对象。", ) self._set_control_state( self.copy_measure_button, has_measure_result, "复制 A/B 两点距离和 X/Y/Z 差值。", "请先设置测量点 A 和 B。", ) self._set_control_state( self.clear_measure_button, has_measure_points, "清除 A/B 测量点和 3D 测量线。", "当前没有可清除的测量点。", ) if hasattr(self, "history_list"): self._set_control_state( self.history_list, has_history, "点击历史记录可查看参数、定位目标并显示差异预览。", "当前还没有编辑历史。", ) self._set_control_state( self.clear_diff_button, has_diff_preview, "清除当前显示的差异预览。", "当前没有正在显示的差异预览。", ) self._set_control_state( self.export_diff_button, has_history_selection, "导出当前选中历史记录的差异报告。", "请先在操作历史中选择一条记录。", ) self._set_control_state( self.export_history_button, has_history, "导出本次会话的完整编辑历史 JSON。", "当前还没有可导出的编辑历史。", ) if hasattr(self, "copy_id_button"): self._set_control_state( self.copy_id_button, bool(selected_id_text), "复制当前选中对象的 ID。", "请先选择一个对象。", ) self._set_control_state( self.copy_pick_button, has_pick_position, "复制最近一次鼠标拾取到的三维坐标。", "当前没有可复制的拾取坐标。", ) self._set_control_state( self.copy_info_button, has_current_info, "复制当前属性区里的完整文本。", "当前属性区还没有可复制的信息。", ) if hasattr(self, "property_table"): self._set_control_state( self.property_table, has_selection and has_current_info, "查看当前选中对象的属性；可修改的行可以输入目标值。", "请先选择一个对象。", ) self._update_edit_action_states(has_model) def _update_edit_action_states(self, has_model: bool) -> None: if not hasattr(self, "push_button"): return action_info = self._selected_action_info() if has_model else {} surface = str(action_info.get("surface", "")) curve = str(action_info.get("curve", "")) feature_guess = str(action_info.get("feature_guess", "")) angular_span = _float_or_none(action_info.get("angular_span")) has_face = self.selected_face_id is not None and self.selected_kind in {"face", "feature"} has_edge = self.selected_edge_id is not None and self.selected_kind == "edge" is_plane = has_face and surface == "plane" is_shell_candidate = is_plane and action_info.get("shell_region_status") == "candidate" is_cylinder = has_face and surface == "cylinder" and "diameter" in action_info is_cone = has_face and surface == "cone" and "reference_radius" in action_info is_sphere = has_face and surface == "sphere" and "radius" in action_info is_torus = has_face and surface == "torus" and "major_radius" in action_info and "minor_radius" in action_info is_generic_surface = has_face and surface in { "bezier surface", "b-spline surface", "surface of revolution", "surface of extrusion", "offset surface", "other surface", } is_hole_or_groove = is_cylinder and feature_guess == "hole/groove candidate" is_boss = is_cylinder and feature_guess == "boss/outer-round candidate" is_existing_fillet = is_cylinder and feature_guess == "round/fillet candidate" is_full_cylinder = angular_span is not None and angular_span >= math.tau * 0.92 is_slot_or_half_hole = ( is_hole_or_groove and angular_span is not None and angular_span < math.tau * 0.92 and _float_or_none(action_info.get("slot_chord_width_estimate")) is not None ) is_blind = action_info.get("cylinder_end_type") == "blind" has_bottom = bool(_int_values(action_info.get("feature_bottom_face_ids"))) has_manual_bottom = bool( hasattr(self, "hole_bottom_face_input") and self.hole_bottom_face_input.text().strip() ) has_fillet_support = len(_int_values(action_info.get("feature_existing_fillet_support_face_ids"))) >= 2 is_line_edge = has_edge and curve == "line" can_push = has_model and is_plane can_resize_shell = has_model and is_shell_candidate can_resize_hole = has_model and is_hole_or_groove can_resize_slot = has_model and is_slot_or_half_hole can_resize_boss = has_model and is_boss and is_full_cylinder can_suppress_hole = has_model and is_hole_or_groove and is_full_cylinder can_resize_depth = has_model and is_hole_or_groove and ((is_blind and has_bottom) or has_manual_bottom) can_fillet_edge = has_model and is_line_edge can_resize_existing_fillet = has_model and is_existing_fillet and has_fillet_support can_chamfer_edge = has_model and is_line_edge can_resize_edge_length = has_model and has_edge can_transform_part = has_model and self.selected_part_id is not None can_transform_solid = has_model and self.selected_solid_id is not None self._set_control_state( self.offset_input, can_push, "输入平面 Face 的推拉距离。", "请先选择一个可推拉的平面 Face。", ) self._set_control_state( self.push_button, can_push, "对当前平面 Face 执行推拉。", "请先选择一个平面 Face，或在特征模式下选择可推拉平面候选。", ) if hasattr(self, "resize_shell_thickness_button"): self._set_control_state( self.shell_thickness_input, can_resize_shell, "输入薄壁/壳体局部区域的目标厚度。", "请先选择一个已识别到相对平面的薄壁/壳体平面候选。", ) self._set_control_state( self.resize_shell_thickness_button, can_resize_shell, "按目标厚度推拉当前薄壁/壳体平面区域。", "请先选择一个已识别到相对平面的薄壁/壳体平面候选。", ) self._set_control_state( self.hole_diameter_input, can_resize_hole, "输入圆柱孔/槽的目标直径。", "请先选择被识别为孔/槽候选的圆柱 Face。", ) self._set_control_state( self.resize_button, can_resize_hole, "调整当前圆柱孔/槽候选的直径。", "请先选择被识别为孔/槽候选的圆柱 Face。", ) if hasattr(self, "resize_slot_button"): self._set_control_state( self.slot_width_input, can_resize_slot, "输入槽/半孔候选的目标宽度。", "请先选择被识别为槽/半孔的部分圆柱 Face。", ) self._set_control_state( self.resize_slot_button, can_resize_slot, "按目标槽宽调整当前槽/半孔候选；当前版本会换算为对应圆柱直径后执行。", "请先选择被识别为槽/半孔的部分圆柱 Face。", ) if hasattr(self, "resize_slot_depth_button"): self._set_control_state( self.slot_depth_input, can_resize_slot, "输入槽/半孔候选的目标凹入深度。", "请先选择被识别为槽/半孔的部分圆柱 Face。", ) self._set_control_state( self.resize_slot_depth_button, can_resize_slot, "按目标槽深调整当前槽/半孔候选；当前版本会换算为对应圆柱直径后执行。", "请先选择被识别为槽/半孔的部分圆柱 Face。", ) self._set_control_state( self.boss_diameter_input, can_resize_boss, "输入完整圆柱凸台候选的目标直径。", "请先选择被识别为完整凸台/外圆候选的圆柱 Face。", ) self._set_control_state( self.resize_boss_button, can_resize_boss, "调整当前完整圆柱凸台候选的直径。", "请先选择被识别为完整凸台/外圆候选的圆柱 Face。", ) self._set_control_state( self.suppress_button, can_suppress_hole, "封堵当前完整圆柱孔候选。", "请先选择接近完整圆柱的孔候选；半孔/槽不会放行。", ) self._set_control_state( self.hole_depth_input, can_resize_hole, "输入盲孔/盲槽的目标深度。", "请先选择孔/槽圆柱面。", ) self._set_control_state( self.hole_bottom_face_input, can_resize_hole, "必要时输入底面 Face ID，用来明确盲孔/盲槽深度。", "请先选择孔/槽圆柱面。", ) self._set_control_state( self.resize_depth_button, can_resize_depth, "调整当前盲孔/盲槽深度；自动底面不稳定时可手动填写底面 Face ID。", "请先选择孔/槽圆柱面；如果没有自动识别到底面，请填写底面 Face ID。", ) self._set_control_state( self.edge_fillet_radius_input, can_fillet_edge or can_resize_existing_fillet, "输入新圆角或已有圆角的目标半径。", "请先选择直线Edge，或选择可修改的已有圆角 Face。", ) self._set_control_state( self.fillet_edge_button, can_fillet_edge, "给当前直线Edge添加新圆角。", "请先选择一条直线Edge。", ) self._set_control_state( self.resize_existing_fillet_button, can_resize_existing_fillet, "尝试修改当前已有圆角/倒圆候选的半径。", "请先选择一个已有圆角/倒圆候选 Face；当前版本需要识别到至少两个支撑 Face。", ) self._set_control_state( self.edge_chamfer_distance_input, can_chamfer_edge, "输入当前直线Edge的倒角距离。", "请先选择一条直线Edge。", ) self._set_control_state( self.chamfer_edge_button, can_chamfer_edge, "给当前直线Edge添加倒角。", "请先选择一条直线Edge。", ) self._set_control_state( self.edge_target_length_input, can_resize_edge_length, "输入当前Edge的目标长度。", "请先选择一条Edge。", ) self._set_control_state( self.edge_length_anchor_combo, can_resize_edge_length, "选择修改Edge长度时尽量固定哪一端。", "请先选择一条Edge。", ) self._set_control_state( self.resize_edge_length_button, can_resize_edge_length, "修改当前Edge的长度；直线Edge优先局部形变，圆/椭圆/平面曲线优先用局部或径向策略。", "请先选择一条Edge。", ) for widget in (self.translate_x_input, self.translate_y_input, self.translate_z_input): self._set_control_state( widget, can_transform_part or can_transform_solid, "输入选中零件或 Solid 的平移距离。", "请先选择一个零件、Solid，或其所属 Face/Edge。", ) self._set_control_state( self.translate_part_button, can_transform_part, "平移当前选中对象所属零件。", "请先选择一个零件，或选择属于某个零件的对象。", ) self._set_control_state( self.rotate_part_button, can_transform_part, "旋转当前选中对象所属零件。", "请先选择一个零件，或选择属于某个零件的对象。", ) self._set_control_state( self.rotate_axis_combo, can_transform_part or can_transform_solid, "选择选中零件或 Solid 的旋转轴。", "请先选择一个零件、Solid，或其所属 Face/Edge。", ) self._set_control_state( self.rotate_angle_input, can_transform_part or can_transform_solid, "输入选中零件或 Solid 的旋转角度。", "请先选择一个零件、Solid，或其所属 Face/Edge。", ) self._set_control_state( self.translate_solid_button, can_transform_solid, "平移当前选中对象所属 Solid。", "请先选择一个 Solid，或选择属于某个 Solid 的 Face/Edge。", ) self._set_control_state( self.rotate_solid_button, can_transform_solid, "旋转当前选中对象所属 Solid。", "请先选择一个 Solid，或选择属于某个 Solid 的 Face/Edge。", ) if hasattr(self, "cylinders_button"): self._set_control_state( self.cylinders_button, has_model, "扫描当前模型中的圆柱面候选。", "请先加载 STEP 文件。", ) if hasattr(self, "editable_refresh_button"): self._set_control_state( self.editable_refresh_button, has_model, "扫描可编辑对象。", "请先加载 STEP 文件，或等待当前后台任务完成。", ) self._set_control_state( self.editable_deep_scan_button, has_model, "深度扫描更多可编辑对象。", "请先加载 STEP 文件，或等待当前后台任务完成。", ) self._set_control_state( self.editable_table, has_model and self.editable_table.rowCount() > 0, "点击一行可选中对应对象并填入相关编辑参数。", "当前没有可编辑对象列表；请先点击扫描对象。", ) if hasattr(self, "candidate_filter_combo"): has_cylinder_candidates = has_model and bool(getattr(self, "cylinder_candidates_loaded", False)) self._set_control_state( self.candidate_filter_combo, has_cylinder_candidates, "筛选已扫描的圆柱面候选。", "请先点击扫描圆柱面。", ) self._set_control_state( self.cylinder_table, has_model and self.cylinder_table.rowCount() > 0, "点击一行可选中对应圆柱 Face。", "当前没有圆柱面候选列表；请先点击扫描圆柱面。", ) if hasattr(self, "undo_button"): self._set_control_state( self.undo_button, has_model and bool(self.undo_stack), "撤销上一步编辑。", "当前没有可撤销的编辑。", ) if hasattr(self, "redo_button"): self._set_control_state( self.redo_button, has_model and bool(self.redo_stack), "重做刚撤销的编辑。", "当前没有可重做的编辑。", ) self._update_property_apply_state(has_model) def _set_control_state(self, widget, enabled: bool, enabled_tip: str, disabled_tip: str) -> None: widget.setEnabled(enabled) tip = enabled_tip if enabled else disabled_tip if hasattr(self, "_set_help_tip"): self._set_help_tip(widget, tip) else: widget.setToolTip(tip) def _current_selection_mode(self) -> str: if not hasattr(self, "mode_combo"): return getattr(self, "last_id_kind", "Face") data = self.mode_combo.currentData() if data is not None: return _selection_mode_value(data) return _selection_mode_value(self.mode_combo.currentText()) def _set_selection_mode(self, mode: str) -> None: if not hasattr(self, "mode_combo"): self.last_id_kind = _selection_mode_value(mode) return value = _selection_mode_value(mode) index = self.mode_combo.findData(value) if index >= 0: self.mode_combo.setCurrentIndex(index) else: self.mode_combo.setCurrentText(_selection_mode_label(value)) self.last_id_kind = value self._update_id_select_title(value) def _update_id_select_title(self, kind: str | None = None) -> None: current_kind = kind if current_kind is None and hasattr(self, "mode_combo"): current_kind = self._current_selection_mode() current_kind = current_kind or getattr(self, "last_id_kind", "Face") if hasattr(self, "id_select_label"): self.id_select_label.setText(f"按ID：{_selection_mode_label(current_kind)}") def _update_selected_object_title(self) -> None: if not hasattr(self, "object_edit_box"): return self.object_edit_box.setTitle(f"当前选中对象：{self._selected_object_title_suffix()}") def _selected_object_title_suffix(self) -> str: if self.selected_kind == "part" and self.selected_part_id is not None: return f"零件 {self.selected_part_id}" if self.selected_kind == "solid" and self.selected_solid_id is not None: return f"Solid {self.selected_solid_id}" if self.selected_kind == "feature" and self.selected_face_id is not None: feature_label = self._selected_feature_label() if feature_label: return f"{feature_label} {self.selected_face_id}（来源Face）" return f"特征 {self.selected_face_id}（来源Face）" if self.selected_kind == "face" and self.selected_face_id is not None: logical_id = self.current_info_values.get("face_region_logical_id") if logical_id is None: logical_id = self.current_info_values.get("logical_face_id") feature_label = self._selected_feature_label() feature_suffix = f"（识别为{feature_label}）" if feature_label else "" if logical_id not in {None, "", self.selected_face_id}: return f"Face {logical_id}（拓扑 {self.selected_face_id}）{feature_suffix}" return f"Face {self.selected_face_id}{feature_suffix}" if self.selected_kind == "edge" and self.selected_edge_id is not None: return f"Edge {self.selected_edge_id}" return "未选择" def _selected_feature_label(self) -> str: info = dict(getattr(self, "current_info_values", {}) or {}) explicit_type = str(info.get("feature_type", "") or "").strip() if explicit_type: return explicit_type surface = str(info.get("surface", "") or "") feature_guess = str(info.get("feature_guess", "") or "") if surface == "cylinder" and feature_guess == "hole/groove candidate": angular_span = _float_or_none(info.get("angular_span")) if info.get("slot_kind") == "partial-cylindrical-groove" or ( angular_span is not None and angular_span < math.tau * 0.92 ): return "槽/半孔候选" return "圆柱孔/槽候选" if surface == "cylinder" and feature_guess == "boss/outer-round candidate": return "凸台/外圆候选" if surface == "cylinder" and feature_guess == "round/fillet candidate": return "圆角/倒圆候选" if surface == "plane" and info.get("push_pull_status"): return "可推拉平面候选" return "" def _clear_property_editor(self) -> None: if not hasattr(self, "property_table"): return self.property_editor_specs = [] self.property_table_expanded = False was_blocked = self.property_table.blockSignals(True) try: self.property_table.setRowCount(0) finally: self.property_table.blockSignals(was_blocked) self._resize_property_table_height() self._update_property_apply_state(False) def _refresh_property_editor(self) -> None: if not hasattr(self, "property_table"): return has_selection = any( item is not None for item in ( self.selected_part_id, self.selected_solid_id, self.selected_face_id, self.selected_edge_id, ) ) if not has_selection: self._clear_property_editor() return info = dict(getattr(self, "current_info_values", {}) or {}) action_info = self._selected_action_info() for key, value in action_info.items(): info.setdefault(key, value) specs = self._property_editor_specs(info, action_info) self.property_editor_specs = specs self.property_table_expanded = False self.property_editor_updating = True was_blocked = self.property_table.blockSignals(True) try: self.property_table.setRowCount(len(specs)) for row, spec in enumerate(specs): editable = bool(spec.get("editable") and spec.get("enabled")) value_type = str(spec.get("value_type", "number")) input_editable = editable and value_type != "command" label_item = self._property_table_item(str(spec.get("label", "")), editable=False) current_item = self._property_table_item(str(spec.get("current_text", "")), editable=False) target_item = self._property_table_item( "" if input_editable else str(spec.get("target_text", "")), editable=False, ) status_text = "" if editable else str(spec.get("status_text", "")) status_item = self._property_table_item(status_text, editable=False) target_item.setToolTip(self._property_target_tooltip(spec, editable=editable)) row_items = (label_item, current_item, target_item, status_item) self._style_property_row_items(row_items, editable=editable) for column, item in enumerate(row_items): item.setToolTip(item.toolTip() or item.text()) self.property_table.setItem(row, column, item) self.property_table.setRowHeight(row, 28 if editable else 24) if editable: if input_editable: self._set_property_target_editor(row, spec) else: self.property_table.removeCellWidget(row, 2) self._set_property_row_button(row, spec) else: self.property_table.removeCellWidget(row, 2) self.property_table.removeCellWidget(row, 3) self._resize_property_table_height() finally: self.property_table.blockSignals(was_blocked) self.property_editor_updating = False self._update_property_apply_state() def _style_property_row_items( self, items: tuple[QTableWidgetItem, QTableWidgetItem, QTableWidgetItem, QTableWidgetItem], *, editable: bool, ) -> None: label_item, current_item, target_item, status_item = items if editable: row_backgrounds = ("#fff7ed", "#fffbeb", "#fff7ed", "#fff7ed") for item, color in zip(items, row_backgrounds): item.setBackground(QColor(color)) label_item.setForeground(QColor("#7c2d12")) current_item.setForeground(QColor("#431407")) target_item.setForeground(QColor("#111827")) status_item.setForeground(QColor("#9a3412")) label_font = label_item.font() label_font.setBold(True) label_item.setFont(label_font) status_font = status_item.font() status_font.setBold(True) status_item.setFont(status_font) return target_item.setBackground(QColor("#eef2f6")) target_item.setForeground(QColor("#8f99a8")) status_item.setForeground(QColor("#64748b")) def _set_property_target_editor(self, row: int, spec: dict[str, object]) -> None: editor = QLineEdit(str(spec.get("target_text", ""))) editor.setObjectName("propertyTargetEditor") editor.setToolTip(self._property_target_tooltip(spec, editable=True)) editor.setCursor(Qt.CursorShape.IBeamCursor) editor.setFrame(True) editor.textChanged.connect(lambda _text="", _row=row: self._update_property_apply_state()) editor.returnPressed.connect(lambda target_row=row: self.apply_property_row_edit(target_row)) self.property_table.setCellWidget(row, 2, editor) def _set_property_row_button(self, row: int, spec: dict[str, object]) -> None: button = QPushButton("未改动") button.setObjectName("propertyRowEditButton") tooltip = f"只应用“{spec.get('label', '当前属性')}”这一行的目标值。" range_hint = self._property_range_hint(spec) if range_hint: tooltip = f"{tooltip}\n\n{range_hint}" button.setToolTip(tooltip) button.setCursor(Qt.CursorShape.PointingHandCursor) button.setProperty("changed", False) button.clicked.connect(lambda _checked=False, target_row=row: self.apply_property_row_edit(target_row)) self.property_table.setCellWidget(row, 3, button) def _property_target_tooltip(self, spec: dict[str, object], *, editable: bool) -> str: tip_key = "enabled_tip" if editable else "disabled_tip" parts = [str(spec.get(tip_key, "")).strip()] if editable: parts.append(self._property_range_hint(spec)) return "\n\n".join(part for part in parts if part) def _property_range_hint(self, spec: dict[str, object]) -> str: parts: list[str] = [] hard_range = self._property_hard_range_text(spec) if hard_range: parts.append(f"有效范围：{hard_range}") range_hint = str(spec.get("range_hint", "")).strip() if range_hint: parts.append(f"建议范围：{range_hint}") return "\n".join(parts) def _property_hard_range_text(self, spec: dict[str, object]) -> str: chunks: list[str] = [] min_value = _float_or_none(spec.get("min_value")) max_value = _float_or_none(spec.get("max_value")) if min_value is not None: operator = ">" if spec.get("min_exclusive") else ">=" chunks.append(f"{operator} {_format_float(min_value)}") if max_value is not None: operator = "<" if spec.get("max_exclusive") else "<=" chunks.append(f"{operator} {_format_float(max_value)}") return " 且 ".join(chunks) def _resize_property_table_height(self) -> None: if not hasattr(self, "property_table"): return row_count = self.property_table.rowCount() collapsed_rows = int(getattr(self, "property_table_collapsed_rows", 6) or 6) expanded = bool(getattr(self, "property_table_expanded", False)) visible_rows = row_count if expanded else min(row_count, collapsed_rows) visible_rows = max(1, visible_rows) row_height = max(int(self.property_table.verticalHeader().defaultSectionSize()), 22) header_height = int(self.property_table.horizontalHeader().height()) frame = int(self.property_table.frameWidth()) * 2 height = header_height + frame + visible_rows * row_height + 8 self.property_table.setMinimumHeight(height) self.property_table.setMaximumHeight(height) has_hidden_rows = row_count > collapsed_rows self.property_table.setVerticalScrollBarPolicy( Qt.ScrollBarPolicy.ScrollBarAlwaysOff if expanded or not has_hidden_rows else Qt.ScrollBarPolicy.ScrollBarAsNeeded ) if hasattr(self, "property_expand_button"): self.property_expand_button.setVisible(has_hidden_rows) if expanded: self.property_expand_button.setText(f"收起到前 {collapsed_rows} 项") self.property_expand_button.setToolTip("收起当前选中对象属性表，让面板只保留最常用的前几行。") else: self.property_expand_button.setText(f"展开全部属性 ({row_count} 项)") self.property_expand_button.setToolTip("展开当前选中对象的完整属性表；参数化建模按钮会继续留在下方。") def toggle_property_table_expanded(self) -> None: if not hasattr(self, "property_table"): return self.property_table_expanded = not bool(getattr(self, "property_table_expanded", False)) self._resize_property_table_height() def _property_table_item(self, text: str, *, editable: bool) -> QTableWidgetItem: item = QTableWidgetItem(text) flags = Qt.ItemFlag.ItemIsSelectable | Qt.ItemFlag.ItemIsEnabled if editable: flags |= Qt.ItemFlag.ItemIsEditable item.setFlags(flags) return item def _property_editor_specs( self, info: dict[str, object], action_info: dict[str, object], ) -> list[dict[str, object]]: editable_specs, used_keys = self._editable_property_specs(action_info) specs = list(editable_specs) for key, value in self._ordered_property_info_items(info): if key in used_keys: continue specs.append( { "key": key, "label": INFO_LABELS.get(key, key), "current_text": _format_value(value), "current_raw": value, "target_text": "", "editable": False, "enabled": False, "status_text": "只读", "disabled_tip": "这个属性来自当前 STEP/B-Rep 几何或识别结果，当前版本只能查看，不能直接修改。", } ) if not specs: specs.append( { "key": "empty", "label": "当前对象", "current_text": "尚未选择", "target_text": "", "editable": False, "enabled": False, "status_text": "只读", "disabled_tip": "请先在模型中选择零件、Solid、Face、Edge 或特征。", } ) return specs def _ordered_property_info_items(self, info: dict[str, object]) -> list[tuple[str, object]]: items = self._ordered_info_items(info) if not self._is_feature_like_info(info): return items item_by_key = {key: value for key, value in items} priority_keys = [ "feature_type", "feature_edit_actions", "feature_mode", "feature_guess", "confidence", "slot_status", "slot_kind", "slot_chord_width_estimate", "slot_sagitta_depth_estimate", "slot_arc_length_estimate", "slot_angular_span", "slot_open_angle", "slot_note", "diameter", "radius", "height_estimate", "same_domain_height_estimate", "hole_depth_estimate", "cylinder_end_type", "feature_bottom_face_ids", "feature_bottom_confidence", "feature_bottom_note", "feature_source_face_id", "feature_face_ids", "feature_side_face_ids", "feature_end_face_ids", "feature_slot_face_ids", "feature_slot_boundary_face_ids", "surface", "axis_point", "axis", ] ordered: list[tuple[str, object]] = [] emitted: set[str] = set() for key in priority_keys: if key in item_by_key and key not in emitted: ordered.append((key, item_by_key[key])) emitted.add(key) ordered.extend((key, value) for key, value in items if key not in emitted) return ordered def _is_feature_like_info(self, info: dict[str, object]) -> bool: if str(info.get("kind", "") or "") == "feature": return True if str(info.get("feature_type", "") or ""): return True feature_guess = str(info.get("feature_guess", "") or "") return feature_guess in { "hole/groove candidate", "boss/outer-round candidate", "round/fillet candidate", } def _ordered_info_items(self, info: dict[str, object]) -> list[tuple[str, object]]: ordered: list[tuple[str, object]] = [] emitted: set[str] = set() for _group_name, keys in INFO_GROUPS: for key in keys: if key in info and key not in emitted: ordered.append((key, info[key])) emitted.add(key) for key in sorted(key for key in info if key not in emitted): ordered.append((key, info[key])) return ordered def _editable_property_specs(self, action_info: dict[str, object]) -> tuple[list[dict[str, object]], set[str]]: has_model = self.model is not None and not (self.operation_in_progress or self.scan_in_progress or self.load_in_progress) surface = str(action_info.get("surface", "")) curve = str(action_info.get("curve", "")) feature_guess = str(action_info.get("feature_guess", "")) angular_span = _float_or_none(action_info.get("angular_span")) has_face = self.selected_face_id is not None and self.selected_kind in {"face", "feature"} has_edge = self.selected_edge_id is not None and self.selected_kind == "edge" is_plane = has_face and surface == "plane" is_shell_candidate = is_plane and action_info.get("shell_region_status") == "candidate" is_cylinder = has_face and surface == "cylinder" and "diameter" in action_info is_cone = has_face and surface == "cone" and "reference_radius" in action_info is_sphere = has_face and surface == "sphere" and "radius" in action_info is_torus = has_face and surface == "torus" and "major_radius" in action_info and "minor_radius" in action_info is_generic_surface = has_face and surface in { "bezier surface", "b-spline surface", "surface of revolution", "surface of extrusion", "offset surface", "other surface", } is_hole_or_groove = is_cylinder and feature_guess == "hole/groove candidate" is_boss = is_cylinder and feature_guess == "boss/outer-round candidate" is_existing_fillet = is_cylinder and feature_guess == "round/fillet candidate" is_full_cylinder = angular_span is not None and angular_span >= math.tau * 0.92 is_slot_or_half_hole = ( is_hole_or_groove and angular_span is not None and angular_span < math.tau * 0.92 and _float_or_none(action_info.get("slot_chord_width_estimate")) is not None ) is_blind = action_info.get("cylinder_end_type") == "blind" has_bottom = bool(_int_values(action_info.get("feature_bottom_face_ids"))) has_boss_height_cap = bool( _int_values(action_info.get("feature_start_end_face_ids")) or _int_values(action_info.get("feature_end_end_face_ids")) ) has_fillet_support = len(_int_values(action_info.get("feature_existing_fillet_support_face_ids"))) >= 2 is_line_edge = has_edge and curve == "line" specs: list[dict[str, object]] = [] used_keys: set[str] = set() def numeric_text(value: object, fallback: str = "") -> str: number = _float_or_none(value) return _format_float(number) if number is not None else fallback def vector_text(value: tuple[float, float, float] | None) -> str: if value is None: return "" return ", ".join(_format_float(item) for item in value) def relative_range_hint(current: object, caution_ratio: float, high_ratio: float) -> str: number = _float_or_none(current) if number is None or number <= 0: return "建议先小幅试改并查看预览，过大变化可能导致布尔失败或周边变形。" lower = max(number * (1.0 - caution_ratio), 0.0) upper = number * (1.0 + caution_ratio) return ( f"建议先在 {_format_float(lower)} - {_format_float(upper)} 内试改" f"（相对当前值约 +/-{caution_ratio * 100.0:.0f}%）；" f"变化超过 {high_ratio * 100.0:.0f}% 时风险较高。" ) def positive_minimum() -> dict[str, object]: return {"min_value": 0.0, "min_exclusive": True} def push_pull_hint() -> str: diagonal = _float_or_none(action_info.get("bbox_diagonal")) if diagonal is not None and diagonal > 0: return ( "可输入正数或负数，单位同模型；" f"建议单次绝对值不超过 {_format_float(diagonal * 0.08)}，" f"超过 {_format_float(diagonal * 0.2)} 时风险较高。" ) return "可输入正数或负数，单位同模型；建议先小幅试改并查看预览。" def translation_hint() -> str: diagonal = _float_or_none(action_info.get("bbox_diagonal")) if diagonal is not None and diagonal > 0: return ( "格式为 X, Y, Z；" f"建议单次平移距离不超过 {_format_float(diagonal * 0.5)}，" f"超过 {_format_float(diagonal * 2.0)} 时请重点确认单位和方向。" ) return "格式为 X, Y, Z；建议先小幅试改并查看预览。" def hole_diameter_upper_limit(current: object) -> float | None: current_number = _float_or_none(current) height = _float_or_none(action_info.get("height_estimate")) limits: list[float] = [] if current_number is not None and current_number > 0: limits.append(current_number * 2.0) if height is not None and height > 0: limits.append(height * 2.0) return min(limits) if limits else None def hole_diameter_hint(current: object) -> str: hint = relative_range_hint(current, 0.35, 1.0) upper = hole_diameter_upper_limit(current) if upper is not None: hint = ( f"{hint} 当前版本会阻止超过 {_format_float(upper)} 的目标直径，" "避免布尔返回成功但孔壁没有真正变成目标直径。" ) return hint def hole_radius_hint(current_radius: object, current_diameter: object) -> str: hint = relative_range_hint(current_radius, 0.35, 1.0) upper = hole_diameter_upper_limit(current_diameter) if upper is not None: hint = ( f"{hint} 当前版本会阻止超过 {_format_float(upper * 0.5)} 的目标半径，" "避免布尔返回成功但孔壁没有真正变成目标半径。" ) return hint def add_spec( *, key: str, label: str, current_raw: object, target_text: str, action: str, target_attr: str | None = None, target_attrs: tuple[str, ...] | None = None, enabled: bool, enabled_tip: str, disabled_tip: str, value_type: str = "number", used: tuple[str, ...] = (), range_hint: str = "", min_value: float | None = None, max_value: float | None = None, min_exclusive: bool = False, max_exclusive: bool = False, target_transform: str | None = None, transform_context: dict[str, object] | None = None, current_text: str | None = None, button_text: str | None = None, choices: dict[str, object] | None = None, positive_pair: bool = False, ) -> None: specs.append( { "key": key, "label": label, "current_text": _format_value(current_raw) if current_text is None else current_text, "current_raw": current_raw, "target_text": target_text, "action": action, "target_attr": target_attr, "target_attrs": target_attrs, "editable": True, "enabled": has_model and enabled, "status_text": "可修改" if has_model and enabled else "不可修改", "enabled_tip": enabled_tip, "disabled_tip": disabled_tip, "value_type": value_type, "range_hint": range_hint, "min_value": min_value, "max_value": max_value, "min_exclusive": min_exclusive, "max_exclusive": max_exclusive, "target_transform": target_transform, "transform_context": transform_context or {}, "button_text": button_text or "", "choices": choices or {}, "positive_pair": positive_pair, } ) used_keys.update(used or (key,)) if is_plane: plane_origin = _triple_or_none(action_info.get("plane_origin")) plane_direction = ( _triple_or_none(action_info.get("push_pull_outward_direction")) or _triple_or_none(action_info.get("normal")) ) current_plane_position = None if plane_origin is not None and plane_direction is not None: current_plane_position = ( plane_origin[0] * plane_direction[0] + plane_origin[1] * plane_direction[1] + plane_origin[2] * plane_direction[2] ) add_spec( key="face_target_normal_position", label="Face目标法向位置", current_raw=current_plane_position if current_plane_position is not None else "", target_text=numeric_text(current_plane_position), action="push_pull_face", target_attr="offset_input", enabled=current_plane_position is not None, enabled_tip="输入当前平面沿推拉方向的目标位置；程序会换算成相对推拉距离执行。", disabled_tip="当前平面缺少稳定法向或原点，不能换算目标位置。", range_hint="这是沿当前推拉方向的一维位置坐标，单位同模型；目标值可大于或小于当前值。", target_transform="plane_target_position_to_offset", transform_context={"current_plane_position": current_plane_position}, used=("plane_origin", "push_pull_outward_direction", "normal"), ) add_spec( key="push_pull_distance", label="Face本次偏移量", current_raw=0.0, target_text="0", action="push_pull_face", target_attr="offset_input", enabled=True, enabled_tip="输入本次沿当前平面推拉方向的相对偏移距离；执行后几何会更新，下一次本次偏移量会重新从 0 开始。", disabled_tip="当前对象不是可推拉的平面 Face。", range_hint=push_pull_hint(), current_text="0（相对当前）", ) if is_shell_candidate: current = _float_or_none(action_info.get("shell_thickness_estimate")) add_spec( key="shell_thickness_estimate", label="薄壁厚度", current_raw=current if current is not None else "", target_text=numeric_text(current), action="resize_shell_thickness", target_attr="shell_thickness_input", enabled=current is not None, enabled_tip="输入薄壁/壳体局部区域的目标厚度。", disabled_tip="当前平面没有稳定识别到可修改的薄壁厚度。", value_type="positive", range_hint=relative_range_hint(current, 0.35, 0.8), used=("shell_thickness_estimate", "shell_current_thickness"), **positive_minimum(), ) if is_hole_or_groove: current_diameter = _float_or_none(action_info.get("diameter")) current_radius = _float_or_none(action_info.get("radius")) diameter_upper = hole_diameter_upper_limit(current_diameter) add_spec( key="diameter", label="孔/圆柱直径", current_raw=current_diameter if current_diameter is not None else "", target_text=numeric_text(current_diameter), action="resize_hole", target_attr="hole_diameter_input", enabled=current_diameter is not None, enabled_tip="输入当前孔/槽圆柱面的目标直径。", disabled_tip="当前圆柱面没有稳定识别为孔/槽候选。", value_type="positive", range_hint=hole_diameter_hint(current_diameter), max_value=diameter_upper, **positive_minimum(), ) add_spec( key="hole_cylinder_radius", label="孔/槽圆柱半径", current_raw=current_radius if current_radius is not None else "", target_text=numeric_text(current_radius), action="resize_hole", target_attr="hole_diameter_input", enabled=current_radius is not None, enabled_tip="输入当前孔/槽圆柱面的目标半径；程序会换算成目标直径后执行。", disabled_tip="当前圆柱面没有稳定识别为孔/槽候选。", value_type="positive", range_hint=hole_radius_hint(current_radius, current_diameter), target_transform="radius_to_diameter", used=("radius",), max_value=diameter_upper * 0.5 if diameter_upper is not None else None, **positive_minimum(), ) axis_point = _triple_or_none(action_info.get("axis_point")) axis_direction = _triple_or_none(action_info.get("axis")) axis_range_value = action_info.get("same_domain_v_range") or action_info.get("v_range") current_axis_center = None if ( axis_point is not None and axis_direction is not None and isinstance(axis_range_value, (list, tuple)) and len(axis_range_value) >= 2 ): v_min = _float_or_none(axis_range_value[0]) v_max = _float_or_none(axis_range_value[1]) if v_min is not None and v_max is not None: v_mid = (v_min + v_max) * 0.5 current_axis_center = ( axis_point[0] + axis_direction[0] * v_mid, axis_point[1] + axis_direction[1] * v_mid, axis_point[2] + axis_direction[2] * v_mid, ) add_spec( key="hole_axis_center", label="孔轴心坐标", current_raw=current_axis_center if current_axis_center is not None else "", target_text=vector_text(current_axis_center), action="move_cylindrical_hole_axis", target_attrs=("hole_center_x_input", "hole_center_y_input", "hole_center_z_input"), enabled=bool(is_full_cylinder and current_axis_center is not None and current_diameter is not None), enabled_tip="输入完整圆柱孔轴心的目标坐标 X, Y, Z；程序会先填旧孔，再按同直径切出新孔。", disabled_tip="当前只对接近完整圆柱的孔放行轴心坐标修改；半孔/开放槽需要保留扇形开口，暂不使用整圆柱工具修改。", value_type="vector3", range_hint=translation_hint(), used=("axis_point", "axis", "same_domain_v_range", "v_range"), ) add_spec( key="suppress_cylindrical_hole", label="封堵圆柱孔", current_raw="未封堵", target_text="无需输入", action="suppress_hole", enabled=bool(is_full_cylinder and current_diameter is not None), enabled_tip="用补料体封堵当前完整圆柱孔。点击状态列按钮执行，不需要输入目标值。", disabled_tip="只有接近完整圆柱面的孔/槽候选才能直接封堵；半孔或槽请先使用槽/孔尺寸修改。", value_type="command", range_hint="该操作会直接改变几何并写入历史；复杂孔失败时会回滚到操作前状态。", button_text="封堵", ) if is_slot_or_half_hole: current_slot = _float_or_none(action_info.get("slot_chord_width_estimate")) add_spec( key="slot_chord_width_estimate", label="槽/半孔宽度", current_raw=current_slot if current_slot is not None else "", target_text=numeric_text(current_slot), action="resize_slot_width", target_attr="slot_width_input", enabled=current_slot is not None, enabled_tip="输入槽或半孔的目标宽度。", disabled_tip="当前对象不是稳定的槽/半孔候选。", value_type="positive", range_hint=relative_range_hint(current_slot, 0.35, 1.0), **positive_minimum(), ) current_slot_depth = _float_or_none(action_info.get("slot_sagitta_depth_estimate")) add_spec( key="slot_sagitta_depth_estimate", label="槽/半孔深度", current_raw=current_slot_depth if current_slot_depth is not None else "", target_text=numeric_text(current_slot_depth), action="resize_slot_depth", target_attr="slot_depth_input", enabled=current_slot_depth is not None, enabled_tip="输入槽或半孔的目标凹入深度。", disabled_tip="当前对象没有稳定的槽/半孔深度估算。", value_type="positive", range_hint=relative_range_hint(current_slot_depth, 0.35, 1.0), **positive_minimum(), ) current_slot_arc = _float_or_none(action_info.get("slot_arc_length_estimate")) add_spec( key="slot_arc_length_estimate", label="槽/半孔圆弧长度", current_raw=current_slot_arc if current_slot_arc is not None else "", target_text=numeric_text(current_slot_arc), action="resize_slot_arc_length", target_attr="slot_arc_length_input", enabled=current_slot_arc is not None, enabled_tip="输入槽或半孔的目标圆弧长度。", disabled_tip="当前对象没有稳定的槽/半孔圆弧长度估算。", value_type="positive", range_hint=relative_range_hint(current_slot_arc, 0.35, 1.0), **positive_minimum(), ) current_slot_angle = ( _float_or_none(action_info.get("slot_angular_span")) or _float_or_none(action_info.get("angular_span")) ) current_slot_angle_degrees = ( math.degrees(current_slot_angle) if current_slot_angle is not None else None ) add_spec( key="slot_angular_span_degrees", label="槽/半孔圆弧角度(度)", current_raw=current_slot_angle_degrees if current_slot_angle_degrees is not None else "", target_text=numeric_text(current_slot_angle_degrees), action="resize_slot_angular_span", target_attr="slot_angular_span_input", enabled=current_slot_angle is not None, enabled_tip="输入槽或半孔的目标圆弧角度；程序会保持当前圆柱半径并重建局部扇形槽。", disabled_tip="当前对象没有稳定的槽/半孔圆弧角度估算。", value_type="positive", range_hint="建议先小幅修改；当前版本允许大于 0 且小于约 331 度的局部圆柱槽角度。", max_value=math.degrees(math.tau * 0.92), max_exclusive=True, target_transform="degrees_to_radians", used=("slot_angular_span", "angular_span"), **positive_minimum(), ) current_slot_open_angle_degrees = ( math.degrees(max(math.tau - current_slot_angle, 0.0)) if current_slot_angle is not None else None ) add_spec( key="slot_open_angle_degrees", label="槽/半孔开口角度(度)", current_raw=current_slot_open_angle_degrees if current_slot_open_angle_degrees is not None else "", target_text=numeric_text(current_slot_open_angle_degrees), action="resize_slot_angular_span", target_attr="slot_angular_span_input", enabled=current_slot_angle is not None, enabled_tip="输入槽或半孔的目标开口角度；程序会换算成圆弧角度后重建局部扇形槽。", disabled_tip="当前对象没有稳定的槽/半孔开口角度估算。", value_type="positive", range_hint="开口角越小，槽越接近完整圆柱；当前版本要求开口角大于约 29 度且小于 360 度。", min_value=math.degrees(math.tau * 0.08), min_exclusive=True, max_value=360.0, max_exclusive=True, target_transform="slot_open_angle_degrees_to_angular_span", used=("slot_open_angle",), ) manual_slot_pair_text = self.slot_pair_face_input.text().strip() if hasattr(self, "slot_pair_face_input") else "" manual_slot_pair_id = None if manual_slot_pair_text: try: manual_slot_pair_id = int(manual_slot_pair_text) except ValueError: manual_slot_pair_id = None current_diameter_for_slot = _float_or_none(action_info.get("diameter")) has_manual_slot_pair = bool(manual_slot_pair_text and manual_slot_pair_id is not None) slot_pair_target_text = manual_slot_pair_text add_spec( key="slot_pair_face_id", label="槽孔配对端Face ID", current_raw=slot_pair_target_text, target_text=slot_pair_target_text, action="set_manual_slot_pair_face", target_attr="slot_pair_face_input", enabled=True, enabled_tip="设置长圆槽/槽孔另一个半圆端的 Face ID；自动配对不准时，先填这里再修改槽孔参数。", disabled_tip="当前对象不是槽/半孔候选，不能设置槽孔配对端。", value_type="integer_or_empty", range_hint="留空表示使用自动识别结果；填写时必须是当前模型里存在、且不是当前槽端自己的 Face ID。", min_value=0.0, button_text="设置", ) add_spec( key="slot_total_length_estimate", label="槽孔总长度", current_raw="", current_text="执行时计算", target_text="", action="resize_slot_total_length", target_attr="slot_total_length_input", enabled=has_manual_slot_pair, enabled_tip="输入长圆槽/槽孔的目标总长度；程序会在点击修改时按手动配对端计算当前长度并执行。", disabled_tip="为了避免选择时卡顿，当前不会自动扫描配对端；请先在上一行手动填写另一个半圆槽端 Face ID。", value_type="positive", range_hint="需要先填写槽孔配对端 Face ID。点击修改时才会做配对端几何计划，避免选中对象时卡住界面。", **positive_minimum(), ) add_spec( key="slot_center_distance_estimate", label="槽孔中心距", current_raw="", current_text="执行时计算", target_text="", action="resize_slot_total_length", target_attr="slot_total_length_input", enabled=has_manual_slot_pair and current_diameter_for_slot is not None, enabled_tip="输入长圆槽两端半圆中心距；程序会用当前槽宽换算成槽孔总长度后执行。", disabled_tip="请先填写有效的槽孔配对端 Face ID；当前槽还需要有稳定直径才能按中心距换算。", value_type="positive", range_hint="目标槽孔总长度 = 目标中心距 + 当前槽宽/直径。点击修改时才会计算当前配对几何。", target_transform="slot_center_distance_to_total_length", transform_context={"slot_current_diameter": current_diameter_for_slot}, **positive_minimum(), ) bottom_face_ids = _int_values(action_info.get("feature_bottom_face_ids")) auto_bottom_face_id = bottom_face_ids[0] if bottom_face_ids else None manual_bottom_text = self.hole_bottom_face_input.text().strip() if hasattr(self, "hole_bottom_face_input") else "" manual_bottom_id = None if manual_bottom_text: try: manual_bottom_id = int(manual_bottom_text) except ValueError: manual_bottom_id = None bottom_target_text = manual_bottom_text or (str(auto_bottom_face_id) if auto_bottom_face_id is not None else "") add_spec( key="hole_bottom_face_id", label="底面Face ID", current_raw=bottom_target_text, target_text=bottom_target_text, action="set_manual_hole_bottom_face", target_attr="hole_bottom_face_input", enabled=True, enabled_tip="设置盲孔/盲槽的底面 Face ID；自动识别不准时，先填这里再修改深度。", disabled_tip="当前对象不是孔/槽候选，不能设置底面 Face ID。", value_type="integer_or_empty", range_hint="留空表示使用自动识别结果；填写时必须是当前模型里存在的 Face ID。", min_value=0.0, button_text="设置", ) current_depth = _float_or_none(action_info.get("hole_depth_estimate")) if self.model is not None and self.selected_face_id is not None and manual_bottom_id is not None: probe_depth = current_depth if current_depth is not None and current_depth > 0 else 1.0 try: depth_plan = self.model.cylindrical_depth_plan( self.selected_face_id, probe_depth, bottom_face_id=manual_bottom_id, ) manual_depth = _float_or_none(depth_plan.get("current_depth")) if manual_depth is not None and manual_depth > 0: current_depth = manual_depth except Exception: pass can_depth = bool((is_blind or manual_bottom_id is not None) and (has_bottom or manual_bottom_id is not None) and current_depth is not None) if is_blind or current_depth is not None: add_spec( key="hole_depth_estimate", label="盲孔/盲槽深度", current_raw=current_depth if current_depth is not None else "", target_text=numeric_text(current_depth), action="resize_hole_depth", target_attr="hole_depth_input", enabled=can_depth, enabled_tip="输入盲孔或盲槽的目标深度。", disabled_tip="需要识别到盲孔/盲槽底面后才能直接修改深度。", value_type="positive", range_hint=relative_range_hint(current_depth, 0.35, 1.0), **positive_minimum(), ) if is_boss: current_boss = _float_or_none(action_info.get("diameter")) current_boss_radius = _float_or_none(action_info.get("radius")) add_spec( key="boss_diameter", label="凸台直径", current_raw=current_boss if current_boss is not None else "", target_text=numeric_text(current_boss), action="resize_boss", target_attr="boss_diameter_input", enabled=bool(is_full_cylinder and current_boss is not None), enabled_tip="输入完整圆柱凸台的目标直径。", disabled_tip="当前凸台候选不是接近完整圆柱，暂不放行直径修改。", value_type="positive", range_hint=relative_range_hint(current_boss, 0.3, 0.8), used=("diameter",), **positive_minimum(), ) add_spec( key="boss_radius", label="凸台半径", current_raw=current_boss_radius if current_boss_radius is not None else "", target_text=numeric_text(current_boss_radius), action="resize_boss", target_attr="boss_diameter_input", enabled=bool(is_full_cylinder and current_boss_radius is not None), enabled_tip="输入完整圆柱凸台的目标半径；程序会换算成目标直径后执行。", disabled_tip="当前凸台候选不是接近完整圆柱，暂不放行半径修改。", value_type="positive", range_hint=relative_range_hint(current_boss_radius, 0.3, 0.8), target_transform="radius_to_diameter", used=("radius",), **positive_minimum(), ) boss_axis_point = _triple_or_none(action_info.get("axis_point")) boss_axis_direction = _triple_or_none(action_info.get("axis")) boss_axis_range = action_info.get("same_domain_v_range") or action_info.get("v_range") current_boss_axis_center = None if ( boss_axis_point is not None and boss_axis_direction is not None and isinstance(boss_axis_range, (list, tuple)) and len(boss_axis_range) >= 2 ): v_min = _float_or_none(boss_axis_range[0]) v_max = _float_or_none(boss_axis_range[1]) if v_min is not None and v_max is not None: v_mid = (v_min + v_max) * 0.5 current_boss_axis_center = ( boss_axis_point[0] + boss_axis_direction[0] * v_mid, boss_axis_point[1] + boss_axis_direction[1] * v_mid, boss_axis_point[2] + boss_axis_direction[2] * v_mid, ) add_spec( key="boss_axis_center", label="凸台轴心坐标", current_raw=current_boss_axis_center if current_boss_axis_center is not None else "", target_text=vector_text(current_boss_axis_center), action="move_cylindrical_boss_axis", target_attrs=("boss_center_x_input", "boss_center_y_input", "boss_center_z_input"), enabled=bool(is_full_cylinder and current_boss_axis_center is not None and current_boss is not None), enabled_tip="输入完整圆柱凸台轴心的目标坐标 X, Y, Z；程序会先移除旧凸台包络，再按同直径在目标轴心补出凸台。", disabled_tip="当前只对接近完整圆柱的凸台候选放行轴心坐标修改。", value_type="vector3", range_hint=translation_hint(), used=("axis_point", "axis", "same_domain_v_range", "v_range"), ) current_boss_height = _float_or_none(action_info.get("same_domain_height_estimate")) if current_boss_height is None: current_boss_height = _float_or_none(action_info.get("height_estimate")) add_spec( key="boss_height", label="凸台高度", current_raw=current_boss_height if current_boss_height is not None else "", target_text=numeric_text(current_boss_height), action="resize_boss_height", target_attr="boss_height_input", enabled=bool(is_full_cylinder and current_boss_height is not None and has_boss_height_cap), enabled_tip="输入完整圆柱凸台的目标高度；程序会推拉识别到的凸台端盖 Face。", disabled_tip="当前凸台候选缺少稳定高度或端盖信息，暂不放行高度修改。", value_type="positive", range_hint=relative_range_hint(current_boss_height, 0.3, 0.8), used=("same_domain_height_estimate", "height_estimate"), **positive_minimum(), ) if is_cylinder and not is_hole_or_groove and not is_boss and not is_existing_fillet: current_generic_diameter = _float_or_none(action_info.get("diameter")) current_generic_radius = _float_or_none(action_info.get("radius")) add_spec( key="generic_cylinder_diameter", label="未明确圆柱直径", current_raw=current_generic_diameter if current_generic_diameter is not None else "", target_text=numeric_text(current_generic_diameter), action="resize_hole", target_attr="hole_diameter_input", enabled=current_generic_diameter is not None, enabled_tip="输入当前未明确圆柱面的目标直径；程序会按高风险圆柱切削/重切兜底路线尝试。", disabled_tip="当前圆柱面缺少稳定直径，不能直接修改。", value_type="positive", range_hint="高风险兜底：如果这是凸台或圆角，请改用凸台/圆角专门入口；如果是未识别的孔或槽，可以小幅尝试。", used=("diameter",), **positive_minimum(), ) add_spec( key="generic_cylinder_radius", label="未明确圆柱半径", current_raw=current_generic_radius if current_generic_radius is not None else "", target_text=numeric_text(current_generic_radius), action="resize_hole", target_attr="hole_diameter_input", enabled=current_generic_radius is not None, enabled_tip="输入当前未明确圆柱面的目标半径；程序会换算成直径后按高风险兜底路线尝试。", disabled_tip="当前圆柱面缺少稳定半径，不能直接修改。", value_type="positive", range_hint="高风险兜底：半径会先换算成直径；建议只做小幅修改并检查结果。", target_transform="radius_to_diameter", used=("radius",), **positive_minimum(), ) current_cylinder_height = _float_or_none(action_info.get("same_domain_height_estimate")) if current_cylinder_height is None: current_cylinder_height = _float_or_none(action_info.get("height_estimate")) add_spec( key="cylinder_height", label="圆柱高度", current_raw=current_cylinder_height if current_cylinder_height is not None else "", target_text=numeric_text(current_cylinder_height), action="resize_cylinder_height", target_attr="boss_height_input", enabled=bool(is_full_cylinder and current_cylinder_height is not None and has_boss_height_cap), enabled_tip="输入完整圆柱面的目标高度；程序会推拉识别到的圆柱端盖 Face。", disabled_tip="当前圆柱面不是完整圆柱，或缺少可推拉端盖信息。", value_type="positive", range_hint=relative_range_hint(current_cylinder_height, 0.3, 0.8), used=("same_domain_height_estimate", "height_estimate"), **positive_minimum(), ) if is_existing_fillet: current_radius = _float_or_none(action_info.get("existing_fillet_radius_estimate")) if current_radius is None: current_radius = _float_or_none(action_info.get("radius")) fillet_hint = relative_range_hint(current_radius, 0.35, 1.0) arc_length = _float_or_none(action_info.get("existing_fillet_arc_length_estimate")) if arc_length is not None and arc_length > 0: fillet_hint = ( f"{fillet_hint} 目标半径接近 {_format_float(arc_length * 0.5)} " "（圆角圆弧长度估算的一半）时比例会很异常。" ) add_spec( key="existing_fillet_radius_estimate", label="已有圆角半径", current_raw=current_radius if current_radius is not None else "", target_text=numeric_text(current_radius), action="resize_existing_fillet", target_attr="edge_fillet_radius_input", enabled=bool(current_radius is not None and has_fillet_support), enabled_tip="输入已有圆角/倒圆面的目标半径。", disabled_tip="当前圆角候选缺少稳定支撑面，暂不放行修改。", value_type="positive", range_hint=fillet_hint, used=("existing_fillet_radius_estimate", "radius"), **positive_minimum(), ) current_fillet_arc = _float_or_none(action_info.get("existing_fillet_arc_length_estimate")) current_fillet_span = _float_or_none(action_info.get("existing_fillet_angular_span")) if current_fillet_span is None: current_fillet_span = _float_or_none(action_info.get("angular_span")) add_spec( key="existing_fillet_arc_length_estimate", label="已有圆角圆弧长度", current_raw=current_fillet_arc if current_fillet_arc is not None else "", target_text=numeric_text(current_fillet_arc), action="resize_existing_fillet", target_attr="edge_fillet_radius_input", enabled=bool( current_fillet_arc is not None and current_fillet_span is not None and current_fillet_span > 1e-6 and has_fillet_support ), enabled_tip="输入已有圆角/倒圆面的目标圆弧长度；程序会按当前圆弧角度换算成目标半径。", disabled_tip="当前圆角候选缺少稳定圆弧长度、角度或支撑面，暂不放行修改。", value_type="positive", range_hint=relative_range_hint(current_fillet_arc, 0.35, 1.0), target_transform="arc_length_to_radius", transform_context={"angular_span": current_fillet_span}, used=("existing_fillet_arc_length_estimate",), **positive_minimum(), ) if is_cone: current_reference_radius = _float_or_none(action_info.get("reference_radius")) current_reference_diameter = ( current_reference_radius * 2.0 if current_reference_radius is not None else None ) add_spec( key="cone_reference_radius", label="圆锥参考半径", current_raw=current_reference_radius if current_reference_radius is not None else "", target_text=numeric_text(current_reference_radius), action="resize_cone_reference_radius", target_attr="cone_reference_radius_input", enabled=current_reference_radius is not None, enabled_tip="输入圆锥面的目标参考半径；程序会围绕圆锥轴做径向缩放。", disabled_tip="当前圆锥面缺少稳定参考半径，不能直接修改。", value_type="positive", range_hint=relative_range_hint(current_reference_radius, 0.25, 0.6), used=("reference_radius",), **positive_minimum(), ) add_spec( key="cone_reference_diameter", label="圆锥参考直径", current_raw=current_reference_diameter if current_reference_diameter is not None else "", target_text=numeric_text(current_reference_diameter), action="resize_cone_reference_radius", target_attr="cone_reference_radius_input", enabled=current_reference_diameter is not None, enabled_tip="输入圆锥面的目标参考直径；程序会换算为参考半径后围绕圆锥轴径向缩放。", disabled_tip="当前圆锥面缺少稳定参考直径，不能直接修改。", value_type="positive", range_hint=relative_range_hint(current_reference_diameter, 0.25, 0.6), target_transform="diameter_to_radius", used=("feature_reference_diameter",), **positive_minimum(), ) current_semi_angle = _float_or_none(action_info.get("semi_angle")) current_semi_angle_degrees = ( abs(math.degrees(current_semi_angle)) if current_semi_angle is not None else None ) add_spec( key="cone_semi_angle_degrees", label="圆锥半角(度)", current_raw=current_semi_angle_degrees if current_semi_angle_degrees is not None else "", target_text=numeric_text(current_semi_angle_degrees), action="resize_cone_reference_radius", target_attr="cone_reference_radius_input", enabled=current_reference_radius is not None and current_semi_angle is not None, enabled_tip="输入圆锥面的目标半角；程序会换算为目标参考半径后围绕圆锥轴径向缩放。", disabled_tip="当前圆锥面缺少稳定参考半径或半角，不能直接修改半角。", value_type="positive", range_hint="建议先小幅修改；当前版本要求半角大于 0 且小于 89 度。", max_value=89.0, max_exclusive=True, target_transform="cone_semi_angle_degrees_to_reference_radius", transform_context={ "current_reference_radius": current_reference_radius, "current_semi_angle": current_semi_angle, }, used=("semi_angle",), **positive_minimum(), ) if is_sphere: current_sphere_radius = _float_or_none(action_info.get("radius")) current_sphere_diameter = _float_or_none(action_info.get("diameter")) add_spec( key="sphere_radius", label="球面半径", current_raw=current_sphere_radius if current_sphere_radius is not None else "", target_text=numeric_text(current_sphere_radius), action="resize_sphere_radius", target_attr="sphere_radius_input", enabled=current_sphere_radius is not None, enabled_tip="输入球面的目标半径；程序会围绕球心均匀缩放所属零件/Solid。", disabled_tip="当前球面缺少稳定半径，不能直接修改。", value_type="positive", range_hint=relative_range_hint(current_sphere_radius, 0.25, 0.6), used=("radius",), **positive_minimum(), ) add_spec( key="sphere_diameter", label="球面直径", current_raw=current_sphere_diameter if current_sphere_diameter is not None else "", target_text=numeric_text(current_sphere_diameter), action="resize_sphere_radius", target_attr="sphere_radius_input", enabled=current_sphere_diameter is not None, enabled_tip="输入球面的目标直径；程序会换算为半径后围绕球心均匀缩放。", disabled_tip="当前球面缺少稳定直径，不能直接修改。", value_type="positive", range_hint=relative_range_hint(current_sphere_diameter, 0.25, 0.6), target_transform="diameter_to_radius", used=("diameter", "feature_sphere_diameter"), **positive_minimum(), ) if is_torus: current_major_radius = _float_or_none(action_info.get("major_radius")) current_minor_radius = _float_or_none(action_info.get("minor_radius")) current_major_diameter = ( current_major_radius * 2.0 if current_major_radius is not None else None ) current_minor_diameter = ( current_minor_radius * 2.0 if current_minor_radius is not None else None ) add_spec( key="torus_major_radius", label="环面主半径", current_raw=current_major_radius if current_major_radius is not None else "", target_text=numeric_text(current_major_radius), action="resize_torus_major_radius", target_attr="torus_radius_input", enabled=current_major_radius is not None, enabled_tip="输入环面的目标主半径；当前版本会围绕环面中心均匀缩放，主半径和小半径会等比例变化。", disabled_tip="当前环面缺少稳定主半径，不能直接修改。", value_type="positive", range_hint=relative_range_hint(current_major_radius, 0.25, 0.6), used=("major_radius", "feature_torus_major_radius"), **positive_minimum(), ) add_spec( key="torus_major_diameter", label="环面主直径", current_raw=current_major_diameter if current_major_diameter is not None else "", target_text=numeric_text(current_major_diameter), action="resize_torus_major_radius", target_attr="torus_radius_input", enabled=current_major_diameter is not None, enabled_tip="输入环面的目标主直径；程序会换算为主半径后执行环面修改。", disabled_tip="当前环面缺少稳定主直径，不能直接修改。", value_type="positive", range_hint=relative_range_hint(current_major_diameter, 0.25, 0.6), target_transform="diameter_to_radius", used=("feature_torus_major_radius",), **positive_minimum(), ) add_spec( key="torus_minor_radius", label="环面小半径", current_raw=current_minor_radius if current_minor_radius is not None else "", target_text=numeric_text(current_minor_radius), action="resize_torus_minor_radius", target_attr="torus_radius_input", enabled=current_minor_radius is not None, enabled_tip="输入环面的目标小半径；当前版本会围绕环面中心均匀缩放，主半径和小半径会等比例变化。", disabled_tip="当前环面缺少稳定小半径，不能直接修改。", value_type="positive", range_hint=relative_range_hint(current_minor_radius, 0.25, 0.6), used=("minor_radius", "feature_torus_minor_radius"), **positive_minimum(), ) add_spec( key="torus_minor_diameter", label="环面小直径", current_raw=current_minor_diameter if current_minor_diameter is not None else "", target_text=numeric_text(current_minor_diameter), action="resize_torus_minor_radius", target_attr="torus_radius_input", enabled=current_minor_diameter is not None, enabled_tip="输入环面的目标小直径；程序会换算为小半径后执行环面修改。", disabled_tip="当前环面缺少稳定小直径，不能直接修改。", value_type="positive", range_hint=relative_range_hint(current_minor_diameter, 0.25, 0.6), target_transform="diameter_to_radius", used=("feature_torus_minor_radius",), **positive_minimum(), ) if has_edge: current_length = _float_or_none(action_info.get("length")) is_circle_edge = curve == "circle" is_ellipse_edge = curve == "ellipse" current_anchor_mode = "auto" current_anchor_label = "自动" if hasattr(self, "edge_length_anchor_combo"): current_anchor_mode = str(self.edge_length_anchor_combo.currentData() or "auto") current_anchor_label = self.edge_length_anchor_combo.currentText() add_spec( key="length", label="Edge长度", current_raw=current_length if current_length is not None else "", target_text=numeric_text(current_length), action="resize_any_edge_length", target_attr="edge_target_length_input", enabled=current_length is not None, enabled_tip="输入当前Edge的目标长度。", disabled_tip="当前Edge没有稳定长度信息。", value_type="positive", range_hint=relative_range_hint(current_length, 0.25, 0.5), **positive_minimum(), ) add_spec( key="edge_length_anchor_mode", label="Edge长度基准", current_raw=current_anchor_mode, target_text=current_anchor_label, action="set_edge_length_anchor_mode", target_attr="edge_length_anchor_combo", enabled=True, enabled_tip="设置修改Edge长度时固定哪里：自动、中心、固定起点或固定终点。", disabled_tip="请先选择一条Edge。", value_type="choice", range_hint="可输入：自动、中心、固定起点、固定终点，也可以输入 auto、center、start、end。", button_text="设置", choices={ "自动": "auto", "auto": "auto", "中心": "center", "固定中心": "center", "center": "center", "centre": "center", "起点": "keep-start", "固定起点": "keep-start", "start": "keep-start", "keep-start": "keep-start", "终点": "keep-end", "固定终点": "keep-end", "end": "keep-end", "keep-end": "keep-end", }, ) edge_start_point = _triple_or_none(action_info.get("start_point")) edge_end_point = _triple_or_none(action_info.get("end_point")) edge_center_point = _triple_or_none(action_info.get("length_center")) can_move_line_endpoint = bool(is_line_edge and edge_start_point is not None and edge_end_point is not None) add_spec( key="edge_start_point", label="Edge起点坐标", current_raw=edge_start_point if edge_start_point is not None else "", target_text=vector_text(edge_start_point), action="move_edge_start_point", target_attrs=("edge_start_x_input", "edge_start_y_input", "edge_start_z_input"), enabled=can_move_line_endpoint, enabled_tip="输入目标 X, Y, Z 坐标，只移动当前直线 Edge 的起点，并重建周边平面。", disabled_tip="只有带稳定起点/终点的直线 Edge 才能直接移动端点坐标。", value_type="vector3", range_hint="格式为 X, Y, Z。建议先小幅移动；当前版本仅对简单全平面多面体开放。", used=("start_point",), ) add_spec( key="edge_center_point", label="Edge中心坐标", current_raw=edge_center_point if edge_center_point is not None else "", target_text=vector_text(edge_center_point), action="move_edge_center_point", target_attrs=("edge_center_x_input", "edge_center_y_input", "edge_center_z_input"), enabled=bool(can_move_line_endpoint and edge_center_point is not None), enabled_tip="输入目标 X, Y, Z 坐标，保持当前直线Edge长度不变并移动整条Edge。", disabled_tip="只有带稳定起点/终点/中心的直线 Edge 才能直接移动中心坐标。", value_type="vector3", range_hint="格式为 X, Y, Z。建议先小幅移动；当前版本仅对简单全平面多面体开放。", used=("length_center",), ) add_spec( key="edge_end_point", label="Edge终点坐标", current_raw=edge_end_point if edge_end_point is not None else "", target_text=vector_text(edge_end_point), action="move_edge_end_point", target_attrs=("edge_end_x_input", "edge_end_y_input", "edge_end_z_input"), enabled=can_move_line_endpoint, enabled_tip="输入目标 X, Y, Z 坐标，只移动当前直线 Edge 的终点，并重建周边平面。", disabled_tip="只有带稳定起点/终点的直线 Edge 才能直接移动端点坐标。", value_type="vector3", range_hint="格式为 X, Y, Z。建议先小幅移动；当前版本仅对简单全平面多面体开放。", used=("end_point",), ) if is_circle_edge: current_radius = _float_or_none(action_info.get("radius")) current_diameter = _float_or_none(action_info.get("diameter")) can_resize_circle = bool(current_length is not None and current_length > 0 and current_radius is not None and current_radius > 0) circle_context = { "edge_current_length": current_length, "edge_current_radius": current_radius, } add_spec( key="circle_edge_radius", label="圆Edge半径", current_raw=current_radius if current_radius is not None else "", target_text=numeric_text(current_radius), action="resize_any_edge_length", target_attr="edge_target_length_input", enabled=can_resize_circle, enabled_tip="输入圆形/圆弧Edge的目标半径；程序会换算成等比例Edge目标长度后执行。", disabled_tip="当前圆Edge缺少稳定半径或长度信息。", value_type="positive", range_hint=relative_range_hint(current_radius, 0.25, 0.5), target_transform="circle_edge_radius_to_length", transform_context=circle_context, used=("radius",), **positive_minimum(), ) add_spec( key="circle_edge_diameter", label="圆Edge直径", current_raw=current_diameter if current_diameter is not None else "", target_text=numeric_text(current_diameter), action="resize_any_edge_length", target_attr="edge_target_length_input", enabled=bool(can_resize_circle and current_diameter is not None and current_diameter > 0), enabled_tip="输入圆形/圆弧Edge的目标直径；程序会换算成等比例Edge目标长度后执行。", disabled_tip="当前圆Edge缺少稳定直径或长度信息。", value_type="positive", range_hint=relative_range_hint(current_diameter, 0.25, 0.5), target_transform="circle_edge_diameter_to_length", transform_context=circle_context, used=("diameter",), **positive_minimum(), ) if is_ellipse_edge: current_major = _float_or_none(action_info.get("major_radius")) current_minor = _float_or_none(action_info.get("minor_radius")) ellipse_context = { "edge_current_length": current_length, "edge_current_major_radius": current_major, "edge_current_minor_radius": current_minor, } add_spec( key="ellipse_edge_major_radius", label="椭圆Edge主半径", current_raw=current_major if current_major is not None else "", target_text=numeric_text(current_major), action="resize_any_edge_length", target_attr="edge_target_length_input", enabled=bool(current_length is not None and current_length > 0 and current_major is not None and current_major > 0), enabled_tip="输入椭圆Edge的目标主半径；程序会换算成目标Edge长度并执行平面曲线缩放。", disabled_tip="当前椭圆Edge缺少稳定主半径或长度信息。", value_type="positive", range_hint=relative_range_hint(current_major, 0.25, 0.5), target_transform="ellipse_edge_major_radius_to_length", transform_context=ellipse_context, used=("major_radius",), **positive_minimum(), ) add_spec( key="ellipse_edge_minor_radius", label="椭圆Edge小半径", current_raw=current_minor if current_minor is not None else "", target_text=numeric_text(current_minor), action="resize_any_edge_length", target_attr="edge_target_length_input", enabled=bool(current_length is not None and current_length > 0 and current_minor is not None and current_minor > 0), enabled_tip="输入椭圆Edge的目标小半径；程序会换算成目标Edge长度并执行平面曲线缩放。", disabled_tip="当前椭圆Edge缺少稳定小半径或长度信息。", value_type="positive", range_hint=relative_range_hint(current_minor, 0.25, 0.5), target_transform="ellipse_edge_minor_radius_to_length", transform_context=ellipse_context, used=("minor_radius",), **positive_minimum(), ) if is_line_edge: edge_limit = current_length * 0.45 if current_length is not None and current_length > 0 else None edge_soft = current_length * 0.12 if current_length is not None and current_length > 0 else None edge_warning = current_length * 0.25 if current_length is not None and current_length > 0 else None fillet_edge_hint = "建议半径先用较小值试改；过大容易导致倒圆失败。" chamfer_edge_hint = "建议距离先用较小值试改；过大容易导致倒角失败。" if edge_soft is not None and edge_warning is not None: fillet_edge_hint = ( f"建议半径先不超过 Edge 长度的 12%（约 {_format_float(edge_soft)}）；" f"超过 25%（约 {_format_float(edge_warning)}）时风险较高。" ) chamfer_edge_hint = ( f"建议距离先不超过 Edge 长度的 12%（约 {_format_float(edge_soft)}）；" f"超过 25%（约 {_format_float(edge_warning)}）时风险较高。" ) add_spec( key="new_fillet_radius", label="新增圆角半径", current_raw="未添加", target_text="", action="fillet_edge", target_attr="edge_fillet_radius_input", enabled=True, enabled_tip="输入半径后给当前直线Edge添加新圆角。", disabled_tip="只有直线Edge才能直接添加圆角。", value_type="positive", range_hint=fillet_edge_hint, max_value=edge_limit, max_exclusive=edge_limit is not None, **positive_minimum(), ) add_spec( key="new_chamfer_distance", label="新增倒角距离", current_raw="未添加", target_text="", action="chamfer_edge", target_attr="edge_chamfer_distance_input", enabled=True, enabled_tip="输入距离后给当前直线Edge添加新倒角。", disabled_tip="只有直线Edge才能直接添加倒角。", value_type="positive", range_hint=chamfer_edge_hint, max_value=edge_limit, max_exclusive=edge_limit is not None, **positive_minimum(), ) adjacent_face_ids = _int_values(action_info.get("adjacent_face_ids")) default_chamfer_reference = adjacent_face_ids[0] if adjacent_face_ids else None current_chamfer_reference = default_chamfer_reference if hasattr(self, "edge_chamfer_reference_face_input"): hidden_reference = self.edge_chamfer_reference_face_input.text().strip() if hidden_reference: try: hidden_reference_id = int(hidden_reference) if not adjacent_face_ids or hidden_reference_id in adjacent_face_ids: current_chamfer_reference = hidden_reference_id else: self.edge_chamfer_reference_face_input.setText("") except ValueError: self.edge_chamfer_reference_face_input.setText("") current_chamfer_reference = default_chamfer_reference add_spec( key="new_asymmetric_chamfer_distances", label="新增不等距倒角D1/D2", current_raw="未添加", target_text="", action="chamfer_edge_asymmetric", target_attrs=("edge_chamfer_distance1_input", "edge_chamfer_distance2_input"), enabled=bool(len(adjacent_face_ids) >= 2), enabled_tip="输入两个距离，例如 1, 2，给当前直线Edge添加两侧距离不同的倒角。", disabled_tip="不等距倒角需要当前直线Edge至少有两个相邻Face。", value_type="number_pair", range_hint=f"{chamfer_edge_hint} D1/D2 会以倒角参考Face决定方向。", max_value=edge_limit, max_exclusive=edge_limit is not None, positive_pair=True, ) add_spec( key="new_distance_angle_chamfer", label="新增距离+角度倒角D/角度", current_raw="未添加", target_text="", action="chamfer_edge_distance_angle", target_attrs=("edge_chamfer_angle_distance_input", "edge_chamfer_angle_degrees_input"), enabled=bool(len(adjacent_face_ids) >= 2), enabled_tip="输入距离和角度，例如 1, 45，给当前直线Edge添加距离+角度倒角。", disabled_tip="距离+角度倒角需要当前直线Edge至少有两个相邻Face。", value_type="number_pair", range_hint=f"{chamfer_edge_hint} 角度单位是度，建议先使用 20 到 70 度。", positive_pair=True, ) add_spec( key="chamfer_reference_face_id", label="倒角参考Face ID", current_raw=current_chamfer_reference if current_chamfer_reference is not None else "", target_text=str(current_chamfer_reference) if current_chamfer_reference is not None else "", action="set_chamfer_reference_face", target_attr="edge_chamfer_reference_face_input", enabled=bool(adjacent_face_ids), enabled_tip=f"设置不等距倒角参考Face；可用相邻Face：{tuple(adjacent_face_ids)}。", disabled_tip="当前Edge没有稳定的相邻Face，不能设置不等距倒角参考Face。", value_type="integer_or_empty", range_hint=f"可用相邻Face：{tuple(adjacent_face_ids)}。留空则使用第一个相邻Face。", button_text="设置", ) if self.selected_kind in {"part", "solid"}: target_is_part = self.selected_kind == "part" translate_action = "translate_selected_part" if target_is_part else "translate_selected_solid" rotate_action = "rotate_selected_part" if target_is_part else "rotate_selected_solid" add_spec( key="translation_vector", label="平移 X/Y/Z", current_raw=(0.0, 0.0, 0.0), target_text="0, 0, 0", action=translate_action, target_attrs=("translate_x_input", "translate_y_input", "translate_z_input"), enabled=True, enabled_tip="输入三个数，例如 10, 0, 0，平移当前对象。", disabled_tip="请先选择零件或 Solid。", value_type="vector3", range_hint=translation_hint(), ) current_center = _triple_or_none(action_info.get("center_of_mass")) bbox_min = _triple_or_none(action_info.get("bbox_min")) bbox_max = _triple_or_none(action_info.get("bbox_max")) if current_center is None and bbox_min is not None and bbox_max is not None: current_center = ( (bbox_min[0] + bbox_max[0]) * 0.5, (bbox_min[1] + bbox_max[1]) * 0.5, (bbox_min[2] + bbox_max[2]) * 0.5, ) add_spec( key="target_center_position", label="目标中心坐标", current_raw=current_center if current_center is not None else "", target_text=vector_text(current_center), action=translate_action, target_attrs=("translate_x_input", "translate_y_input", "translate_z_input"), enabled=current_center is not None, enabled_tip="输入目标中心坐标；程序会自动换算成平移 X/Y/Z 后移动当前对象。", disabled_tip="当前对象缺少稳定中心坐标，不能按目标中心移动。", value_type="vector3", range_hint="格式为 X, Y, Z。这里输入的是目标绝对坐标，不是平移距离。", target_transform="target_center_to_translation", transform_context={"current_center": current_center}, used=("center_of_mass",), ) current_diagonal = _float_or_none(action_info.get("bbox_diagonal")) scale_action = "scale_selected_part" if target_is_part else "scale_selected_solid" add_spec( key="bbox_diagonal_scale", label="目标整体尺寸", current_raw=current_diagonal if current_diagonal is not None else "", target_text=numeric_text(current_diagonal), action=scale_action, target_attr="scale_target_diagonal_input", enabled=current_diagonal is not None and current_diagonal > 0, enabled_tip="输入目标包围盒对角线，按当前对象中心等比缩放零件或Solid。", disabled_tip="当前对象缺少有效包围盒尺寸，不能等比缩放。", value_type="positive", range_hint=relative_range_hint(current_diagonal, 0.35, 1.0), used=("bbox_diagonal",), **positive_minimum(), ) current_volume = _float_or_none(action_info.get("volume")) add_spec( key="target_volume_scale", label="目标体积", current_raw=current_volume if current_volume is not None else "", target_text=numeric_text(current_volume), action=scale_action, target_attr="scale_target_diagonal_input", enabled=bool(current_volume is not None and current_volume > 0 and current_diagonal is not None and current_diagonal > 0), enabled_tip="输入目标体积；程序会按体积比例换算为等比缩放后的整体尺寸。", disabled_tip="当前对象缺少有效体积或包围盒尺寸，不能按体积缩放。", value_type="positive", range_hint=relative_range_hint(current_volume, 0.5, 2.0), target_transform="volume_to_bbox_diagonal", transform_context={ "current_volume": current_volume, "current_bbox_diagonal": current_diagonal, }, used=("volume",), **positive_minimum(), ) current_surface_area = _float_or_none(action_info.get("surface_area")) add_spec( key="target_surface_area_scale", label="目标表面积", current_raw=current_surface_area if current_surface_area is not None else "", target_text=numeric_text(current_surface_area), action=scale_action, target_attr="scale_target_diagonal_input", enabled=bool( current_surface_area is not None and current_surface_area > 0 and current_diagonal is not None and current_diagonal > 0 ), enabled_tip="输入目标表面积；程序会按面积比例换算为等比缩放后的整体尺寸。", disabled_tip="当前对象缺少有效表面积或包围盒尺寸，不能按表面积缩放。", value_type="positive", range_hint=relative_range_hint(current_surface_area, 0.5, 2.0), target_transform="surface_area_to_bbox_diagonal", transform_context={ "current_surface_area": current_surface_area, "current_bbox_diagonal": current_diagonal, }, used=("surface_area",), **positive_minimum(), ) bbox_size = _triple_or_none(action_info.get("bbox_size")) axis_scale_action_prefix = "scale_selected_part" if target_is_part else "scale_selected_solid" if bbox_size is not None: for axis_name, axis_index, target_attr in ( ("X", 0, "scale_x_size_input"), ("Y", 1, "scale_y_size_input"), ("Z", 2, "scale_z_size_input"), ): current_axis_size = bbox_size[axis_index] add_spec( key=f"bbox_{axis_name.lower()}_size_scale", label=f"目标{axis_name}向尺寸", current_raw=current_axis_size, target_text=numeric_text(current_axis_size), action=f"{axis_scale_action_prefix}_{axis_name.lower()}_size", target_attr=target_attr, enabled=current_axis_size > 0, enabled_tip=f"输入目标 {axis_name} 向包围盒尺寸，只沿 {axis_name} 轴缩放当前对象。", disabled_tip=f"当前对象缺少有效 {axis_name} 向包围盒尺寸。", value_type="positive", range_hint=relative_range_hint(current_axis_size, 0.25, 1.0), **positive_minimum(), ) axis = self.rotate_axis_combo.currentText() if hasattr(self, "rotate_axis_combo") else "Z" add_spec( key="rotation_axis", label="旋转轴", current_raw=axis, target_text=axis, action="set_rotate_axis", target_attr="rotate_axis_combo", enabled=True, enabled_tip="设置零件或 Solid 旋转时使用的轴：X、Y 或 Z。", disabled_tip="请先选择零件或 Solid。", value_type="choice", range_hint="可输入：X、Y、Z。", button_text="设置", choices={ "X": "X", "x": "X", "Y": "Y", "y": "Y", "Z": "Z", "z": "Z", }, ) add_spec( key="rotation_angle_degrees", label=f"旋转角度({axis}轴)", current_raw=0.0, target_text="0", action=rotate_action, target_attr="rotate_angle_input", enabled=True, enabled_tip=f"输入旋转角度，当前使用 {axis} 轴。", disabled_tip="请先选择零件或 Solid。", range_hint="角度可正可负；建议单次输入 -360 到 360 度，超过后请确认旋转方向和单位。", ) return specs, used_keys def _on_property_table_item_changed(self, _item: QTableWidgetItem) -> None: if getattr(self, "property_editor_updating", False): return self._update_property_apply_state() def _update_property_apply_state(self, has_model: bool | None = None) -> None: if not hasattr(self, "property_table"): return if has_model is None: has_model = self.model is not None and not ( self.operation_in_progress or self.scan_in_progress or self.load_in_progress ) for row, spec in enumerate(getattr(self, "property_editor_specs", [])): widget = self.property_table.cellWidget(row, 3) if isinstance(widget, QPushButton): if str(spec.get("value_type", "number")) == "command": row_changed = True widget.setText(str(spec.get("button_text") or "执行")) enabled = bool(has_model and spec.get("enabled") and spec.get("action")) tooltip = f"执行“{spec.get('label', '当前操作')}”。" else: text = self._property_target_text(row) row_changed = self._property_target_changed(spec, text) widget.setText("应用" if row_changed else "未改动") enabled = bool(has_model and spec.get("enabled") and spec.get("action") and row_changed) if row_changed: tooltip = f"应用“{spec.get('label', '当前属性')}”这一行的目标值。" else: tooltip = f"“{spec.get('label', '当前属性')}”的目标值和当前值相同，无需执行。修改目标值后再应用。" range_hint = self._property_range_hint(spec) if range_hint: tooltip = f"{tooltip}\n\n{range_hint}" widget.setProperty("changed", bool(row_changed)) widget.setToolTip(tooltip) widget.setCursor(Qt.CursorShape.PointingHandCursor if enabled else Qt.CursorShape.ArrowCursor) widget.style().unpolish(widget) widget.style().polish(widget) widget.setEnabled(enabled) if not hasattr(self, "apply_property_button"): return changed = self._changed_property_rows() enabled = bool(has_model and changed) disabled_tip = "请先选择对象，并在属性表中修改一个可编辑目标值。" if changed and len(changed) > 1: disabled_tip = "请使用每一行状态列里的修改按钮，单独应用某个特征。" self._set_control_state( self.apply_property_button, enabled and len(changed) == 1, "应用属性表中被修改的一行目标值。", disabled_tip, ) def _changed_property_rows(self) -> list[tuple[int, dict[str, object], str]]: if not hasattr(self, "property_table"): return [] changed: list[tuple[int, dict[str, object], str]] = [] for row, spec in enumerate(getattr(self, "property_editor_specs", [])): if not spec.get("action") or not spec.get("enabled"): continue if str(spec.get("value_type", "number")) == "command": continue if spec.get("action") in { "set_manual_hole_bottom_face", "set_manual_slot_pair_face", "set_edge_length_anchor_mode", "set_chamfer_reference_face", "set_rotate_axis", }: continue text = self._property_target_text(row) if self._property_target_changed(spec, text): changed.append((row, spec, text)) return changed def _property_target_text(self, row: int) -> str: if not hasattr(self, "property_table"): return "" widget = self.property_table.cellWidget(row, 2) if isinstance(widget, QLineEdit): return widget.text().strip() item = self.property_table.item(row, 2) return item.text().strip() if item is not None else "" def _display_property_target_changed( self, spec: dict[str, object], text: str, value_type: str, ) -> bool | None: current_text = str(spec.get("current_text", "")).strip() if not current_text: return None if value_type == "vector3": try: values = self._parse_property_vector3(text) current = self._parse_property_vector3(current_text) except ValueError: return None return any(abs(values[index] - current[index]) > PROPERTY_VALUE_TOLERANCE for index in range(3)) if value_type == "number_pair": try: values = self._parse_property_number_pair(text) current = self._parse_property_number_pair(current_text) except ValueError: return None return any(abs(values[index] - current[index]) > PROPERTY_VALUE_TOLERANCE for index in range(2)) if value_type in {"integer", "integer_or_empty"}: try: return int(text) != int(current_text) except ValueError: return None if value_type in {"number", "positive"}: value = _float_or_none(text) current = _float_or_none(current_text) if value is None or current is None: return None return abs(value - current) > PROPERTY_VALUE_TOLERANCE return None def _property_target_changed(self, spec: dict[str, object], text: str) -> bool: value_type = str(spec.get("value_type", "number")) if not text: if value_type == "integer_or_empty": return str(spec.get("current_raw", "")).strip() != "" return False display_changed = self._display_property_target_changed(spec, text, value_type) if display_changed is not None: return display_changed if value_type == "vector3": try: values = self._parse_property_vector3(text) except ValueError: return True if str(spec.get("target_transform") or "") == "target_center_to_translation": current = _triple_or_none(spec.get("current_raw")) if current is not None: return any(abs(values[index] - current[index]) > PROPERTY_VALUE_TOLERANCE for index in range(3)) current = _triple_or_none(spec.get("current_raw")) if current is not None: return any(abs(values[index] - current[index]) > PROPERTY_VALUE_TOLERANCE for index in range(3)) return any(abs(value) > PROPERTY_VALUE_TOLERANCE for value in values) if value_type == "choice": try: value = self._property_choice_value(spec, text) except ValueError: return True return str(value) != str(spec.get("current_raw", "")) if value_type == "number_pair": try: values = self._parse_property_number_pair(text) except ValueError: return True if spec.get("positive_pair") and any(value <= 0 for value in values): return True if any(self._property_scalar_range_error(spec, value) for value in values): return True current = spec.get("current_raw") if isinstance(current, (tuple, list)) and len(current) == 2: try: current_pair = (float(current[0]), float(current[1])) except (TypeError, ValueError): return True return any(abs(values[index] - current_pair[index]) > PROPERTY_VALUE_TOLERANCE for index in range(2)) return True if value_type in {"integer", "integer_or_empty"}: try: value = int(text) except ValueError: return True if self._property_scalar_range_error(spec, float(value)): return True current_text = str(spec.get("current_raw", "")).strip() try: current = int(current_text) except ValueError: return True return value != current try: value = float(text) except ValueError: return True if value_type == "positive" and value <= 0: return True if self._property_scalar_range_error(spec, value): return True current = _float_or_none(spec.get("current_raw")) if current is None: return True return abs(value - current) > PROPERTY_VALUE_TOLERANCE def apply_current_property_edit(self) -> None: changed = self._changed_property_rows() if not changed: self.statusBar().showMessage("请先在当前选中对象表中修改一个可编辑目标值。") return if len(changed) > 1: QMessageBox.information(self, "一次应用一个修改", "请只修改一行目标值，然后再点击应用当前修改。") return row, _spec, _text = changed[0] self.apply_property_row_edit(row) def apply_property_row_edit(self, row: int) -> None: specs = getattr(self, "property_editor_specs", []) if row < 0 or row >= len(specs): self.statusBar().showMessage("当前属性行已经失效，请重新选择对象。") return spec = specs[row] if not spec.get("action") or not spec.get("enabled"): self.statusBar().showMessage("这一行当前不能直接修改。") return text = self._property_target_text(row) is_command = str(spec.get("value_type", "number")) == "command" if not is_command and not self._property_target_changed(spec, text): self.statusBar().showMessage("请先在这一行的目标值列输入一个不同的新值。") return try: if not is_command: self._sync_property_edit_target(spec, text) except ValueError as exc: QMessageBox.information(self, "目标值无效", str(exc)) return action_name = str(spec.get("action", "")) action = getattr(self, action_name, None) if action is None: QMessageBox.information(self, "暂不支持", f"当前属性没有可用的执行入口：{action_name}") return action() def set_manual_hole_bottom_face(self) -> None: self._update_action_states() self._refresh_property_editor() text = self.hole_bottom_face_input.text().strip() if hasattr(self, "hole_bottom_face_input") else "" if text: self.statusBar().showMessage(f"已设置盲孔/盲槽底面 Face ID：{text}，现在可以继续修改深度。") else: self.statusBar().showMessage("已清除手动底面 Face ID，将使用自动识别结果。") def set_manual_slot_pair_face(self) -> None: self._update_action_states() self._refresh_property_editor() text = self.slot_pair_face_input.text().strip() if hasattr(self, "slot_pair_face_input") else "" if text: self.statusBar().showMessage(f"已设置槽孔配对端 Face ID：{text}，后续槽孔修改会优先使用这个配对端。") else: self.statusBar().showMessage("已清除手动槽孔配对端 Face ID，将使用自动识别结果。") def set_edge_length_anchor_mode(self) -> None: self._update_action_states() self._refresh_property_editor() label = self.edge_length_anchor_combo.currentText() if hasattr(self, "edge_length_anchor_combo") else "" self.statusBar().showMessage(f"已设置Edge长度基准：{label or '自动'}。") def set_chamfer_reference_face(self) -> None: self._update_action_states() self._refresh_property_editor() text = ( self.edge_chamfer_reference_face_input.text().strip() if hasattr(self, "edge_chamfer_reference_face_input") else "" ) if text: self.statusBar().showMessage(f"已设置不等距倒角参考 Face ID：{text}。") else: self.statusBar().showMessage("已清除不等距倒角参考 Face ID，将使用当前Edge的第一个相邻Face。") def set_rotate_axis(self) -> None: self._update_action_states() self._refresh_property_editor() axis = self.rotate_axis_combo.currentText() if hasattr(self, "rotate_axis_combo") else "Z" self.statusBar().showMessage(f"已设置旋转轴：{axis}。") def _sync_property_edit_target(self, spec: dict[str, object], text: str) -> None: value_type = str(spec.get("value_type", "number")) if value_type == "command": return if value_type == "vector3": values = self._parse_property_vector3(text) values = self._transform_property_vector3_target(spec, values) target_attrs = tuple(spec.get("target_attrs") or ()) if len(target_attrs) != 3: raise ValueError("这个属性缺少 X/Y/Z 输入绑定。") for attr, value in zip(target_attrs, values): getattr(self, str(attr)).setText(_format_float(value)) return if value_type == "choice": value = self._property_choice_value(spec, text) target_attr = spec.get("target_attr") if not target_attr: raise ValueError("这个属性缺少目标输入绑定。") widget = getattr(self, str(target_attr)) index = widget.findData(value) if hasattr(widget, "findData") else -1 if index < 0 and hasattr(widget, "findText"): index = widget.findText(str(text)) if index < 0: raise ValueError(f"找不到可用选项：{text}") widget.setCurrentIndex(index) return if value_type == "number_pair": values = self._parse_property_number_pair(text) if spec.get("positive_pair") and any(value <= 0 for value in values): raise ValueError("请输入两个大于 0 的目标值。") for value in values: range_error = self._property_scalar_range_error(spec, value) if range_error: raise ValueError(range_error) target_attrs = tuple(spec.get("target_attrs") or ()) if len(target_attrs) != 2: raise ValueError("这个属性缺少两个目标输入绑定。") for attr, value in zip(target_attrs, values): getattr(self, str(attr)).setText(_format_float(value)) return if value_type in {"integer", "integer_or_empty"}: target_attr = spec.get("target_attr") if not target_attr: raise ValueError("这个属性缺少目标输入绑定。") if not text and value_type == "integer_or_empty": getattr(self, str(target_attr)).setText("") return try: value = int(text) except ValueError as exc: raise ValueError("请输入整数形式的 Face ID。") from exc range_error = self._property_scalar_range_error(spec, float(value)) if range_error: raise ValueError(range_error) key = str(spec.get("key", "")) if self.model is not None and key in {"hole_bottom_face_id", "slot_pair_face_id", "chamfer_reference_face_id"}: if value < 0 or value >= len(self.model.faces): label = { "hole_bottom_face_id": "底面", "slot_pair_face_id": "槽孔配对端", "chamfer_reference_face_id": "倒角参考", }.get(key, "Face") raise ValueError(f"{label} Face ID {value} 不存在。") if key == "slot_pair_face_id" and self.selected_face_id is not None and value == self.selected_face_id: raise ValueError("槽孔配对端不能和当前槽端使用同一个 Face ID。") if key == "chamfer_reference_face_id" and self.selected_edge_id is not None: try: adjacent_face_ids = _int_values(self.model.edge_info(self.selected_edge_id).get("adjacent_face_ids")) except Exception: adjacent_face_ids = [] if adjacent_face_ids and value not in adjacent_face_ids: raise ValueError(f"倒角参考 Face ID 必须是当前 Edge 的相邻 Face，可用值：{tuple(adjacent_face_ids)}。") getattr(self, str(target_attr)).setText(str(value)) return try: value = float(text) except ValueError as exc: raise ValueError("请输入数字形式的目标值。") from exc if value_type == "positive" and value <= 0: raise ValueError("请输入大于 0 的目标值。") range_error = self._property_scalar_range_error(spec, value) if range_error: raise ValueError(range_error) value = self._transform_property_scalar_target(spec, value) target_attr = spec.get("target_attr") if not target_attr: raise ValueError("这个属性缺少目标输入绑定。") getattr(self, str(target_attr)).setText(_format_float(value)) def _transform_property_scalar_target(self, spec: dict[str, object], value: float) -> float: transform = str(spec.get("target_transform") or "") if not transform: return value context = spec.get("transform_context") if not isinstance(context, dict): context = {} if transform == "radius_to_diameter": if value <= 0: raise ValueError("目标半径必须大于 0。") return value * 2.0 if transform == "diameter_to_radius": if value <= 0: raise ValueError("目标直径必须大于 0。") return value * 0.5 if transform == "plane_target_position_to_offset": current_position = _float_or_none(context.get("current_plane_position")) if current_position is None: raise ValueError("当前平面缺少稳定法向位置，不能换算推拉距离。") return value - current_position if transform == "degrees_to_radians": if value <= 0: raise ValueError("目标角度必须大于 0。") return math.radians(value) if transform == "slot_open_angle_degrees_to_angular_span": if value <= 0 or value >= 360.0: raise ValueError("槽/半孔开口角度必须大于 0 且小于 360 度。") target_span = math.tau - math.radians(value) if target_span <= 1e-6 or target_span >= math.tau * 0.92: raise ValueError("换算后的槽/半孔圆弧角度必须大于 0 且小于接近完整圆柱的范围。") return target_span if transform == "cone_semi_angle_degrees_to_reference_radius": current_radius = _float_or_none(context.get("current_reference_radius")) current_angle = _float_or_none(context.get("current_semi_angle")) if current_radius is None or current_radius <= 0 or current_angle is None: raise ValueError("当前圆锥面缺少稳定参考半径或半角，不能换算目标半角。") if value <= 0 or value >= 89.0: raise ValueError("圆锥目标半角必须大于 0 且小于 89 度。") current_tangent = abs(math.tan(current_angle)) target_tangent = math.tan(math.radians(value)) if current_tangent <= 1e-9 or target_tangent <= 1e-9: raise ValueError("圆锥半角过小，不能稳定换算参考半径。") return current_radius * target_tangent / current_tangent if transform == "arc_length_to_radius": angular_span = _float_or_none(context.get("angular_span")) if angular_span is None or angular_span <= 1e-6: raise ValueError("当前对象缺少稳定圆弧角度，不能把圆弧长度换算为半径。") return value / angular_span if transform == "slot_center_distance_to_total_length": diameter = _float_or_none(context.get("slot_current_diameter")) if diameter is None or diameter <= 0: raise ValueError("当前槽孔缺少稳定宽度/直径，不能把中心距换算为总长度。") if value <= 0: raise ValueError("槽孔中心距必须大于 0。") return value + diameter if transform == "volume_to_bbox_diagonal": current_volume = _float_or_none(context.get("current_volume")) current_diagonal = _float_or_none(context.get("current_bbox_diagonal")) if current_volume is None or current_volume <= 0 or current_diagonal is None or current_diagonal <= 0: raise ValueError("当前对象缺少稳定体积或整体尺寸，不能换算目标体积。") if value <= 0: raise ValueError("目标体积必须大于 0。") return current_diagonal * ((value / current_volume) ** (1.0 / 3.0)) if transform == "surface_area_to_bbox_diagonal": current_surface_area = _float_or_none(context.get("current_surface_area")) current_diagonal = _float_or_none(context.get("current_bbox_diagonal")) if current_surface_area is None or current_surface_area <= 0 or current_diagonal is None or current_diagonal <= 0: raise ValueError("当前对象缺少稳定表面积或整体尺寸，不能换算目标表面积。") if value <= 0: raise ValueError("目标表面积必须大于 0。") return current_diagonal * math.sqrt(value / current_surface_area) if transform in {"circle_edge_radius_to_length", "circle_edge_diameter_to_length"}: current_length = _float_or_none(context.get("edge_current_length")) current_radius = _float_or_none(context.get("edge_current_radius")) if current_length is None or current_length <= 0 or current_radius is None or current_radius <= 0: raise ValueError("当前圆Edge缺少稳定的长度或半径，不能换算目标长度。") target_radius = value * 0.5 if transform == "circle_edge_diameter_to_length" else value if target_radius <= 0: raise ValueError("圆Edge目标半径必须大于 0。") return current_length * target_radius / current_radius if transform in {"ellipse_edge_major_radius_to_length", "ellipse_edge_minor_radius_to_length"}: current_length = _float_or_none(context.get("edge_current_length")) radius_key = "edge_current_major_radius" if transform == "ellipse_edge_major_radius_to_length" else "edge_current_minor_radius" current_radius = _float_or_none(context.get(radius_key)) if current_length is None or current_length <= 0 or current_radius is None or current_radius <= 0: raise ValueError("当前椭圆Edge缺少稳定的长度或半径，不能换算目标长度。") if value <= 0: raise ValueError("椭圆Edge目标半径必须大于 0。") return current_length * value / current_radius raise ValueError(f"这个属性使用了未知的目标换算方式：{transform}") def _transform_property_vector3_target( self, spec: dict[str, object], values: tuple[float, float, float], ) -> tuple[float, float, float]: transform = str(spec.get("target_transform") or "") if not transform: return values context = spec.get("transform_context") if not isinstance(context, dict): context = {} if transform == "target_center_to_translation": current_center = _triple_or_none(context.get("current_center")) or _triple_or_none(spec.get("current_raw")) if current_center is None: raise ValueError("当前对象缺少稳定中心坐标，不能换算平移量。") return ( values[0] - current_center[0], values[1] - current_center[1], values[2] - current_center[2], ) raise ValueError(f"这个属性使用了未知的向量换算方式：{transform}") def _property_choice_value(self, spec: dict[str, object], text: str) -> object: choices = spec.get("choices") if not isinstance(choices, dict) or not choices: raise ValueError("这个属性缺少可用选项。") normalized = str(text).strip() if not normalized: raise ValueError("请输入一个选项。") if normalized in choices: return choices[normalized] lowered = normalized.lower() for label, value in choices.items(): if str(label).strip().lower() == lowered: return value raise ValueError(f"不支持的选项：{text}") def _property_scalar_range_error(self, spec: dict[str, object], value: float) -> str: label = str(spec.get("label", "目标值")) min_value = _float_or_none(spec.get("min_value")) max_value = _float_or_none(spec.get("max_value")) if min_value is not None: min_exclusive = bool(spec.get("min_exclusive")) if (min_exclusive and value <= min_value) or (not min_exclusive and value < min_value): operator = "大于" if min_exclusive else "大于或等于" return f"{label} 必须{operator} {_format_float(min_value)}。" if max_value is not None: max_exclusive = bool(spec.get("max_exclusive")) if (max_exclusive and value >= max_value) or (not max_exclusive and value > max_value): operator = "小于" if max_exclusive else "小于或等于" return f"{label} 必须{operator} {_format_float(max_value)}。" return "" def _parse_property_number_pair(self, text: str) -> tuple[float, float]: text = text.strip().strip("()[]") chunks = text.replace("；", ",").replace(";", ",").replace("，", ",").replace(" ", ",").split(",") values = [chunk for chunk in chunks if chunk.strip()] if len(values) != 2: raise ValueError("请输入两个数字，例如 1, 2。") try: return (float(values[0]), float(values[1])) except ValueError as exc: raise ValueError("这两个目标值都必须是数字。") from exc def _parse_property_vector3(self, text: str) -> tuple[float, float, float]: text = text.strip().strip("()[]") chunks = text.replace("，", ",").replace(";", ",").replace("；", ",").replace(" ", ",").split(",") values = [chunk for chunk in chunks if chunk.strip()] if len(values) != 3: raise ValueError("请输入三个数字，例如 10, 0, 0。") try: return (float(values[0]), float(values[1]), float(values[2])) except ValueError as exc: raise ValueError("平移 X/Y/Z 必须都是数字。") from exc def _selected_action_info(self) -> dict[str, object]: if self.model is None: return {} current_info = dict(getattr(self, "current_info_values", {}) or {}) current_face_id = _int_or_none( current_info.get("feature_source_face_id", current_info.get("topological_face_id", current_info.get("face_id"))) ) if ( self.selected_face_id is not None and current_face_id == self.selected_face_id and str(current_info.get("surface", "") or "") ): return current_info try: if self.selected_kind == "feature" and self.selected_face_id is not None: return self.model.feature_info(self.selected_face_id) if self.selected_kind == "face" and self.selected_face_id is not None: info = self.model.face_info(self.selected_face_id) if info.get("surface") in {"cylinder", "plane"}: return self.model.feature_info(self.selected_face_id) return info if self.selected_kind == "edge" and self.selected_edge_id is not None: return self.model.edge_info(self.selected_edge_id) except Exception: return dict(self.current_info_values) return dict(self.current_info_values) def _locate_operation_record(self, record: OperationRecord) -> str: if self.model is None: return "" self._reset_selection(clear_highlight=True) located = False locator_note = "" if record.target_kind in {"face", "feature"} and record.target_id is not None: resolved_face_id = self._resolve_record_face_id(record) if resolved_face_id is not None: info = self.model.feature_info(resolved_face_id) if record.target_kind == "feature" else self.model.face_info(resolved_face_id) self.selected_kind = "feature" if record.target_kind == "feature" else "face" self.selected_face_id = resolved_face_id self.selected_part_id = int(info["part_id"]) self.selected_solid_id = int(info["solid_id"]) if int(info["solid_id"]) >= 0 else None self.selected_pick_position = record.pick_position self._set_selection_mode("Feature" if record.target_kind == "feature" else "Face") current_logical_id = self.model.face_region_logical_id(resolved_face_id) self._sync_id_picker("Feature" if record.target_kind == "feature" else "Face", current_logical_id) face_ids = ( _int_values(info.get("feature_highlight_face_ids")) if record.target_kind == "feature" else self.model.face_region_ids(resolved_face_id) ) if not face_ids: face_ids = self.model.face_region_ids(resolved_face_id) self._highlight_faces(face_ids=face_ids) self.set_info(self._with_pick_info(info, record.pick_position)) located = True region_note = f"；同域面区域 {len(face_ids)} 个Face" if len(face_ids) > 1 else "" id_note = ( f"逻辑 Face ID {current_logical_id}" if record.target_logical_id is not None else f"Face {record.target_id}" ) if resolved_face_id != record.target_id: id_note += f"（当前拓扑Face {resolved_face_id}）" locator_note = ( f"定位: 已尝试高亮当前模型中的 {id_note}{region_note}。" "布尔编辑后Face ID可能发生语义变化，请结合拾取点确认。" ) else: if record.target_logical_id is not None: locator_note = f"定位: 原目标逻辑 Face ID {record.target_logical_id} 在当前模型索引中已经不存在。" else: locator_note = f"定位: 原目标Face {record.target_id} 在当前模型索引中已经不存在。" elif record.target_kind == "edge" and record.target_id is not None: resolved_edge_id = self._resolve_record_edge_id(record) if resolved_edge_id is not None: info = self.model.edge_info(resolved_edge_id) self.selected_kind = "edge" self.selected_edge_id = resolved_edge_id self.selected_part_id = int(info["part_id"]) self.selected_solid_id = int(info.get("solid_id", -1)) if int(info.get("solid_id", -1)) >= 0 else None self.selected_pick_position = record.pick_position self._set_selection_mode("Edge") self._sync_id_picker("Edge", resolved_edge_id) self._highlight_edge(resolved_edge_id) self.set_info(self._with_pick_info(info, record.pick_position)) located = True locator_note = ( f"定位: 已尝试高亮当前模型中的Edge {resolved_edge_id}。" "布尔/倒圆编辑后Edge ID可能发生语义变化，请结合拾取点确认。" ) else: locator_note = f"定位: 原目标Edge {record.target_id} 在当前模型索引中已经不存在。" elif record.target_kind == "part" and record.target_id is not None: part_id = int(record.target_id) if self.model.part_by_id(part_id) is not None: info = self.model.part_info(part_id) self.selected_kind = "part" self.selected_part_id = part_id self.selected_pick_position = record.pick_position self._set_selection_mode("Part") self._sync_id_picker("Part", part_id) self._highlight_faces(part_ids=[part_id]) self.set_info(self._with_pick_info(info, record.pick_position)) located = True locator_note = f"定位: 已尝试高亮当前模型中的零件 {part_id}。" else: locator_note = f"定位: 原目标零件 {part_id} 在当前模型索引中已经不存在。" elif record.target_kind == "solid" and record.target_id is not None: solid_id = int(record.target_id) if 0 <= solid_id < len(self.model.solids): info = self.model.solid_info(solid_id) self.selected_kind = "solid" self.selected_solid_id = solid_id self.selected_part_id = int(info["part_id"]) self.selected_pick_position = record.pick_position face_ids = [i for i, sid in enumerate(self.model.face_solid_ids) if sid == solid_id] self._set_selection_mode("Solid") self._sync_id_picker("Solid", solid_id) self._highlight_faces(face_ids=face_ids) self.set_info(self._with_pick_info(info, record.pick_position)) located = True locator_note = f"定位: 已尝试高亮当前模型中的Solid {solid_id}。" else: locator_note = f"定位: 原目标Solid {solid_id} 在当前模型索引中已经不存在。" if record.pick_position is not None: self._show_pick_marker(record.pick_position) if not locator_note: locator_note = "定位: 已记录当时的拾取点。" elif located: locator_note += f"\n拾取点: {_format_value(record.pick_position)}" else: locator_note += f"\n已记录当时拾取点: {_format_value(record.pick_position)}" if not locator_note: locator_note = "定位: 这条历史记录没有可定位的目标或拾取点。" self._update_action_states() self.statusBar().showMessage(locator_note.splitlines()[0]) return locator_note def _resolve_record_face_id(self, record: OperationRecord) -> int | None: if self.model is None: return None verified_face_id = self._record_verified_face_id(record) if verified_face_id is not None: return verified_face_id moved_face_id = self._record_moved_face_id(record) if moved_face_id is not None: return moved_face_id plane_position_face_id = self._record_plane_position_face_id(record) if plane_position_face_id is not None: return plane_position_face_id if not self._record_face_count_changed(record): stable_face_id = self._record_stable_face_id(record) if stable_face_id is not None: return stable_face_id nearest_face_id = self._record_nearest_semantic_face_id(record) if nearest_face_id is not None: return nearest_face_id stable_face_id = self._record_stable_face_id(record) if stable_face_id is not None: return stable_face_id return None def _record_verified_face_id(self, record: OperationRecord) -> int | None: if self.model is None: return None value = _record_message_field(record.result_message, "verified_face") if value is None: return None try: face_id = int(value) except (TypeError, ValueError): return None if not (0 <= face_id < len(self.model.faces)): return None return face_id if self._record_face_semantic_matches(record, face_id) else None def _record_moved_face_id(self, record: OperationRecord) -> int | None: if self.model is None or record.pick_position is None: return None moved_point = self._record_moved_pick_position(record) if moved_point is None: return None candidates = self._record_candidate_face_ids(record) if not candidates: return None nearest = self.model.nearest_face_id_to_point(candidates, moved_point) if nearest is None: return None return nearest if self._record_face_semantic_matches(record, nearest) else None def _record_moved_pick_position(self, record: OperationRecord) -> tuple[float, float, float] | None: parameters = record.parameters if isinstance(record.parameters, dict) else {} distance = ( self._record_float_parameter(record, "semantic_distance") if parameters.get("semantic_distance") not in {"", None} else self._record_float_parameter(record, "push_pull_distance") ) direction = ( _triple_or_none(parameters.get("outward_direction")) or _triple_or_none(parameters.get("push_pull_outward_direction")) or _triple_or_none(parameters.get("shell_desired_movement_vector")) ) if distance is None or direction is None: return None length = math.sqrt(direction[0] * direction[0] + direction[1] * direction[1] + direction[2] * direction[2]) if length <= 1e-12: return None unit = (direction[0] / length, direction[1] / length, direction[2] / length) px, py, pz = record.pick_position return ( float(px) + unit[0] * float(distance), float(py) + unit[1] * float(distance), float(pz) + unit[2] * float(distance), ) def _record_nearest_semantic_face_id(self, record: OperationRecord) -> int | None: if self.model is None or record.pick_position is None: return None candidates = self._record_candidate_face_ids(record) if not candidates: return None nearest = self.model.nearest_face_id_to_point(candidates, record.pick_position) if nearest is None: return None return nearest if self._record_face_semantic_matches(record, nearest) else None def _record_stable_face_id(self, record: OperationRecord) -> int | None: if self.model is None: return None if record.target_logical_id is not None: try: logical_matches = self.model.face_ids_for_logical_id(int(record.target_logical_id)) except Exception: logical_matches = [] logical_matches = [ face_id for face_id in logical_matches if self._record_face_semantic_matches(record, face_id) ] if logical_matches: return self.model.nearest_face_id_to_point(logical_matches, record.pick_position) if record.target_id is None: return None try: face_id = int(record.target_id) except (TypeError, ValueError): return None if 0 <= face_id < len(self.model.faces) and self._record_face_semantic_matches(record, face_id): return face_id return None def _record_face_count_changed(self, record: OperationRecord) -> bool: before = record.before_snapshot if isinstance(record.before_snapshot, dict) else {} after = record.after_snapshot if isinstance(record.after_snapshot, dict) else {} before_ids = before.get(SNAPSHOT_FACE_LOGICAL_IDS_KEY) after_ids = after.get(SNAPSHOT_FACE_LOGICAL_IDS_KEY) if isinstance(before_ids, (list, tuple)) and isinstance(after_ids, (list, tuple)): return len(before_ids) != len(after_ids) return True def _record_face_semantic_matches(self, record: OperationRecord, face_id: int) -> bool: if self.model is None or not (0 <= int(face_id) < len(self.model.faces)): return False part_id = self._record_int_parameter(record, "part_id") if part_id is not None and self.model.face_part_ids[int(face_id)] != part_id: return False surface_hint = self._record_surface_hint(record) surface_kind = self.model.face_surface_kind(int(face_id)) if surface_hint and surface_kind != surface_hint: return False target_diameter = self._record_target_diameter(record) if target_diameter is not None: current_diameter = self.model.face_cylinder_diameter(int(face_id)) if current_diameter is None: return False diameter_tolerance = max(abs(target_diameter) * 0.02, 1e-5) if abs(current_diameter - target_diameter) > diameter_tolerance: return False return True def _record_surface_hint(self, record: OperationRecord) -> str: parameters = record.parameters if isinstance(record.parameters, dict) else {} surface = str(parameters.get("surface", "") or "") if surface in { "plane", "cylinder", "cone", "sphere", "torus", "bezier surface", "b-spline surface", "surface of revolution", "surface of extrusion", "offset surface", "other surface", }: return surface operation_name = str(record.operation_name or "") if any(token in operation_name for token in ("孔", "圆柱", "槽", "凸台", "圆角", "倒圆")): return "cylinder" if any(token in operation_name for token in ("推拉", "薄壁", "壳体")): return "plane" if self._record_target_diameter(record) is not None: return "cylinder" return "" def _record_plane_position_face_id(self, record: OperationRecord) -> int | None: if self.model is None: return None target_position = self._record_float_parameter(record, "target_plane_position") direction = _triple_or_none((record.parameters or {}).get("outward_direction")) if target_position is None or direction is None: return None direction_length = math.sqrt(direction[0] * direction[0] + direction[1] * direction[1] + direction[2] * direction[2]) if direction_length <= 1e-12: return None unit = (direction[0] / direction_length, direction[1] / direction_length, direction[2] / direction_length) tolerance = max((self._record_float_parameter(record, "bbox_diagonal") or 1.0) * 1e-5, 1e-4) best_face_id: int | None = None best_error = math.inf for face_id in self._record_candidate_face_ids(record): if not (0 <= int(face_id) < len(self.model.faces)): continue try: info = self.model.face_info(int(face_id)) except Exception: continue if info.get("surface") != "plane": continue normal = _triple_or_none(info.get("normal")) or _triple_or_none(info.get("oriented_normal")) if normal is not None and abs(normal[0] * unit[0] + normal[1] * unit[1] + normal[2] * unit[2]) < 0.85: continue origin = _triple_or_none(info.get("plane_origin")) if origin is None: continue position = origin[0] * unit[0] + origin[1] * unit[1] + origin[2] * unit[2] error = abs(position - target_position) if error < best_error: best_error = error best_face_id = int(face_id) if best_face_id is not None and best_error <= tolerance: return best_face_id return None def _record_target_diameter(self, record: OperationRecord) -> float | None: return ( self._record_float_parameter(record, "new_diameter") or self._record_float_parameter(record, "derived_new_diameter") or self._record_float_parameter(record, "target_diameter") or self._record_float_parameter(record, "diameter") ) def _resolve_record_edge_id(self, record: OperationRecord) -> int | None: if self.model is None: return None if record.pick_position is not None: nearest = self.model.nearest_edge_id_to_point(self._record_candidate_edge_ids(record), record.pick_position) if nearest is not None: return nearest if record.target_id is None: return None try: edge_id = int(record.target_id) except (TypeError, ValueError): return None return edge_id if 0 <= edge_id < len(self.model.edges) else None def _record_candidate_face_ids(self, record: OperationRecord) -> list[int]: if self.model is None: return [] part_id = self._record_int_parameter(record, "part_id") solid_id = self._record_int_parameter(record, "solid_id") face_ids = list(range(len(self.model.faces))) if part_id is not None: face_ids = [face_id for face_id in face_ids if self.model.face_part_ids[face_id] == part_id] if solid_id is not None and solid_id >= 0: same_solid = [face_id for face_id in face_ids if self.model.face_solid_ids[face_id] == solid_id] if same_solid: face_ids = same_solid surface_hint = self._record_surface_hint(record) if surface_hint: surface_face_ids: list[int] = [] for face_id in face_ids: if self.model.face_surface_kind(face_id) == surface_hint: surface_face_ids.append(face_id) if not surface_face_ids: return [] face_ids = surface_face_ids target_diameter = self._record_target_diameter(record) if target_diameter is not None and target_diameter > 0: diameter_tolerance = max(target_diameter * 0.02, 1e-5) cylindrical_face_ids: list[int] = [] for face_id in face_ids: current_diameter = self.model.face_cylinder_diameter(face_id) if current_diameter is not None: if abs(current_diameter - target_diameter) <= diameter_tolerance: cylindrical_face_ids.append(face_id) if not cylindrical_face_ids: return [] face_ids = cylindrical_face_ids return face_ids def _record_candidate_edge_ids(self, record: OperationRecord) -> list[int]: if self.model is None: return [] part_id = self._record_int_parameter(record, "part_id") solid_id = self._record_int_parameter(record, "solid_id") edge_ids = list(range(len(self.model.edges))) if part_id is not None: edge_ids = [edge_id for edge_id in edge_ids if self.model.edge_part_ids[edge_id] == part_id] if solid_id is not None and solid_id >= 0: edge_ids = [edge_id for edge_id in edge_ids if self.model.edge_solid_ids[edge_id] == solid_id] return edge_ids or list(range(len(self.model.edges))) def _record_int_parameter(self, record: OperationRecord, key: str) -> int | None: parameters = record.parameters if isinstance(record.parameters, dict) else {} value = parameters.get(key) if value is None or value == "": return None try: return int(value) except (TypeError, ValueError): return None def _record_float_parameter(self, record: OperationRecord, key: str) -> float | None: parameters = record.parameters if isinstance(record.parameters, dict) else {} return _float_or_none(parameters.get(key)) def undo_edit(self) -> None: if self.model is None: return if self._edit_busy("编辑计算中，暂时不能撤销。"): return if not self.undo_stack: self.statusBar().showMessage("没有可撤销的编辑") return current = self.model.snapshot() snapshot = self.undo_stack[-1] undone = self.operation_history[-1] if self.operation_history else OperationRecord("编辑", "编辑") try: self._restore_snapshot(snapshot) except Exception as exc: rollback_message = self._restore_after_failed_undo_redo(current) QMessageBox.critical(self, "撤销失败", f"{exc}\n\n{rollback_message}") self.statusBar().showMessage("撤销失败，模型已尽量恢复到撤销前状态") return self.undo_stack.pop() if self.operation_history: self.operation_history.pop() self.redo_stack.append(current) self.redo_history.append(undone) self._refresh_history_list() self._update_action_states() self.statusBar().showMessage(f"已撤销：{undone.summary}") def redo_edit(self) -> None: if self.model is None: return if self._edit_busy("编辑计算中，暂时不能重做。"): return if not self.redo_stack: self.statusBar().showMessage("没有可重做的编辑") return current = self.model.snapshot() snapshot = self.redo_stack[-1] redone = self.redo_history[-1] if self.redo_history else OperationRecord("编辑", "编辑") try: self._restore_snapshot(snapshot) except Exception as exc: rollback_message = self._restore_after_failed_undo_redo(current) QMessageBox.critical(self, "重做失败", f"{exc}\n\n{rollback_message}") self.statusBar().showMessage("重做失败，模型已尽量恢复到重做前状态") return self.redo_stack.pop() if self.redo_history: self.redo_history.pop() self.undo_stack.append(current) self.operation_history.append(redone) self._refresh_history_list() self._update_action_states() self.statusBar().showMessage(f"已重做：{redone.summary}") def _restore_snapshot(self, snapshot: dict[int, object]) -> None: if self.model is None: return self.model.restore_snapshot(snapshot) self._reset_selection() self._populate_part_tree() self._rebuild_scene(reset_camera=False) self._clear_editable_candidates() self._clear_cylinder_candidates() stats = self.model.stats() self.set_info( { "parts": stats.parts, "solids": stats.solids, "faces": stats.faces, "edges": stats.edges, "vertices": stats.vertices, } ) def _restore_after_failed_undo_redo(self, snapshot: dict[int, object]) -> str: try: self._restore_snapshot(snapshot) except Exception as rollback_exc: return f"恢复原状态也失败：{rollback_exc}。建议重新加载 STEP 文件。" return "模型已恢复到操作前状态，历史记录未移动。"