v2.2.0 · CATIA 点位、界面与 PSZ 稳定性更新

PDPSTools v2.2.0

本次更新完善首次使用和 CATIA 点位流程，修复螺柱坐标读取、工具箱横向溢出及 PSZ 回写与后台任务稳定性问题。

主要更新

• 首次使用引导：无项目数据时可直接添加项目目录，选中后自动扫描子目录。
• 螺柱点位：修复 COM 位置数组读取失败；默认 Q114 同时匹配 FQ114，支持多关键字与同名实例，预览显示装配路径和毫米坐标。
• 界面适配：操作按钮随窗口宽度换行，表格列宽自动适配，长名称和路径悬停查看完整内容。
• 点位导入与导出：支持 mm/cm/m/in 单位、追加导入、跨来源重复检测，以及全部/保留/重复点报告。
• PSZ 稳定性：区分 PS/EMS 对象，按条目限定删除；临时包校验后原子回写，独立备份并检查源文件变化。
• 维护与交付：后台任务退出协调、扫描缓存失效与错误重试、纯函数服务拆分、依赖版本固定、Windows CI 测试与打包检查。

使用与升级

下载 PDPSTools-v2.2.0-windows-x64.exe，放在可写目录后双击运行。无需另装 Python；CATIA 功能需要已经安装并启动 CATIA V5。

升级时关闭旧版，将新 EXE 放在原目录，保留 pdps_master_config.json、paths_config.json、recent_projects.json 和 pdps_ui_settings.json。

螺柱点位先读取、核对，再确认创建；点位表示组件原点在活动根装配中的位置，单位 mm。

验证

• 36 项本地回归测试通过。
• 超长路径及不同窗口宽度/字号下的布局检查通过。
• 现场 CATIA 只读验证：32 个螺柱原点，其中 FQ114 6 个、其余 Q114 26 个，坐标与 CATIA 返回值一致。
• 最新 EXE 通过十秒隔离启动检查；实际工程中的点创建和失败回滚仍需现场验收。

发行版同时提供 .sha256 文件用于校验下载完整性。源码可从对应 Git 标签下载。

远程 Windows 回归测试、打包和启动检查均已通过：查看 CI 结果。

V2.1

V2.1

• 修复 Product 遍历提取焊点时 PartDocument 局部变量作用域错误。
• 兼容 Product 中多层 Part 实例遍历，恢复焊点坐标提取。
• 使用 CATIA/pycatia 点对象进行坐标测量，避免读取到全零坐标。
• 当前 Product 回归验证：遍历 86 个 Part 实例，成功提取 418 个非零坐标焊点。
• 重新编译 Windows 独立版 EXE。

V2.0

V2.0 更新记录

CATIA / 3DXML

• 增强 3DXML 二进制几何中心解析，支持球体、正方体、三棱锥等形体识别。
• 增加按形体分别设置半径阈值，并记录几何类型和焊点层数。
• 增加 CATIA 几何图形集球体扫描，并支持从当前表格生成重心点。
• CATProduct 生成点时，在当前 Product 内创建 Part 并写入点；3DXML 只读代理给出明确提示。

焊点数据与界面

• 修正几何中心传入焊点表的字段映射：Location 为 X,Y,Z，ExternalId 与 Name 一致，Type 为焊点层数。
• 增加动态重命名、自定义主名称、前缀、后缀、序号规则及恢复原名功能。
• 焊点数据和几何体重心操作区改为紧凑的横向分组布局，并增加进度提示。
• 保留生成点球操作的详细进度显示。

使用说明

• 下载下方 PDPSTools.exe，Windows 环境直接运行。
• CATIA 相关功能需要本机安装 CATIA V5，并具备 pycatia/pywin32 所需的 COM 环境。
• 用户配置会保存到 EXE 所在目录。

V1.0

已有功能可正常运行，包括项目路径管理，catia焊点提取，插枪图等。

PDPSTools

Full Changelog: https://github.com/ShuiYinMaster/PDPSTools/commits/tools

PDPSManagerApp_PyQt5 V0.5

加个LOGO