TxTools 3.0.2

安装

下载 TxToolsInstaller.zip，完整解压后双击 TxToolsInstaller.exe，选择目标安装版本并按安装器提示完成部署。

自动路径规划（用不了）

• 过渡路径改用机器人与外部轴联合关节空间搜索，同时考虑机器人姿态和焊钳开口；中间点保存搜索时采用的关节解、构型、TCP 位姿及外部轴值。
• 进枪、焊点、出枪按实际执行顺序检查，home 保留原始关节姿态；准备点按来源焊点识别，重复运行更新已有准备点。
• 树边连接和路径简化均检查关节扫掠；写入后按操作树实际点序再次检查，预先存在的过渡点也参与所在区间检查。
• 已通过的独立分段分别保留；某段失败或取消时，只清理该段未提交的过渡点，未连通区间单独报告。
• 完善已有干涉集复用、机器人安装总成识别及固定安装接触处理；规划结束、失败或取消时恢复机器人、外部轴和碰撞查询状态。

零件树整理

• 支持读取 CATIA 活动产品或 PS 零件分支，在双树中预览来源结构与目标结构。
• 支持勾选参与分支、跳过中间容器、编辑目标名称，以及拖动节点调整归属和同级顺序；预览调整完成后统一执行。
• CATIA 叶子匹配存在歧义时，可通过 PS 原生拾取框指定零件实例，避免同名零件被错误归类。
• 支持仅创建容器结构或同时归类已有零件；整理结果和结构草稿可继续用于快速分序。

快速分序

• 支持按零件层级、手选工序节点或绑定零件实例组合生成工序预览，同名但不同实例的零件分别处理。
• 层级模式按绑定零件的最深公共工序分配焊点；跨分支点可保留原位、人工指定工序或归入最近公共装配。
• 支持 Ctrl、Shift 和全选进行批量操作，通过右键分配或拖动调整点位归属与先后顺序；拖动时支持边缘滚动和悬停展开。
• 新建、已有工序与虚拟待分配区统一参与预览；待分配区不会创建真实操作，未分配点保留原位置。
• 人工分配与零件绑定不一致时标红提示；重新扫描保留仍有效的手工调整，执行前检查对象、绑定和机器人/工具关联变化。
• 写入后核对工序及点位顺序，归属移动和点序调整纳入同一撤销分组；阻止拆分含过渡点的源操作及机器人/工具关联不一致的迁移。

可达性与干涉检查

• 静态干涉检查优先复用机器人或焊钳的已有干涉集，没有有效组时使用临时检测范围。
• 同一窗口内重复检查复用范围；文档、对象结构、位姿或干涉组成员变化后重新建立范围。
• 显示范围准备与点位检查进度，干涉结果整行标红；结果和导出明确区分有干涉、无干涉、未知及未检查。
• 干涉结果与轴限位分别统计，避免将碰撞直接归为接近关节极限。

导出与焊钳定义

• 焊枪导出完善操作与点位选择、参考坐标显示，支持按各操作自身参考坐标导出。
• 几何命名增加重名处理，改进长路径兼容性；编码失败时使用短路径重试，并避免覆盖已有 CGR 文件。
• 完善 CATIA 交互和焊点标注的显示、布局及操作状态管理。
• 焊钳定义支持统一设置开口方向，使开口、磨量及 OPEN 姿态使用一致符号；静、动电极帽分别同步到对应连杆。
• 先定义焊钳类型，再重新获取设备接口创建 CLOSE、OPEN 姿态及开闭逻辑，改进重复定义时的资源引用处理。

插件信息与界面

• 主题窗口新增关于页面，提供项目、发行版和问题反馈入口，以及可离线查看的第三方许可证。
• 支持手动检查 GitHub 最新稳定版，查询结果和网络异常在页面内显示。
• 配方快捷面板采用无边框圆角样式，随尺寸与 DPI 调整外观；完善桌宠动画切换和事件处理。

v3.0.1

3.0.1 — 2026-10-28

新增焊点矩阵

• 同步调整与查看多个操作的机器人动作

功能与交互

• 焊点矩阵支持键盘切换点位并定位机器人、原生前插/后插过渡点、操作轨迹播放和原生序列编辑器播放。序列范围须完整覆盖现有复合操作；播放、暂停和清理期间互锁拾取与点位编辑，结束后恢复当前操作。
• TxAgent 支持执行期间排队文字引导，在模型返回或工具之间的安全边界应用；补齐被跳过或未完成的工具结果，保持消息协议配对。执行过程可折叠，回复支持复制结论和完整会话内容。
• 配方支持同名更新、删除及偏好清理；默认焊点配方增加迁移基线和精确指纹匹配，保留自定义内容检测及本地执行历史。
• 设备对齐增加世界坐标三角网格、最低点和支撑面分析；BASE0 校验与校正复用宿主实现。

正确性与可靠性

• 收紧跨实例写入和只读比较的权限检查，保留 UI 线程封送，阻止旧协议目标及嵌套转发绕过限制。
• 通过工程生命周期事件校验撤销事务和几何读取上下文；读取结束恢复原显示状态与加载级别，恢复失败明确报告。
• 修正 PLC/逻辑行为接口、旋转单位及 RPY/Euler 区分、CATIA 参考系歧义、仿真重置和操作绑定等边界。
• 改进代码工作区的编码保留、原始备份恢复、精确编辑和路径校验；记忆与 API 注解采用原子保存并报告写入失败。
• 完善 Office 模板页序、占位符及图片处理，生成完成后发布文件；焊点标注导出拆分为独立服务。
• 完善焊钳机构、TCPF 和姿态写入的参数校验、撤销分组及界面状态控制。

构建与发行

• 主项目、MCP 桥、JT 解码器及 CGR 工作进程共享外部依赖、输出和中间目录配置；构建入口为 tools/Build.ps1。
• 离线部署包提供 25 个注册命令、插件依赖和桌宠运行组件。发行标签为 v3.0.1，插件程序集版本保持 1.0.0.0；随附离线二进制采用 Debug 配置。
• TxToolsInstaller.zip 提供完整离线安装目录，TxTools.zip 提供平铺插件文件；文件完整性通过发行附件中的 SHA-256 清单校验。
• 离线包不包含可选的 ffmpeg.exe 和 IronPythonLib。PS 2402 SDK、宿主许可、WebView2、CATIA 与 Excel 环境按所用功能另行准备。

验证范围

• Debug 与 Release 源码构建通过；部署清单的 238 个文件及其 SHA-256 校验通过，离线插件与当前 Debug 构建一致。
• 跨环境 19 项、导出 315 项、CGR 压缩 105 组图元/6 组边链/3 组索引映射、配方控件 119 项和配方分享 49 项检查通过；无宿主界面回归通过。
• 自动化回归不能替代目标 PS/CATIA/Excel 环境中的实际工程、显示、拾取、运动和保存验收。

TxTools_3.0.0

TxTools 更新日志

本文件记录 TxTools 主分支的主要功能、兼容性和文档变化。日期以中国标准时间为准。

2.1.3 — 2026-09-15

新增

• TxAgent 进程内 AI 助手：在 Process Simulate 内通过工具调用查询和操作场景，工具执行统一回到 PS UI 主线程。
• 多模型支持与路由：内置 DeepSeek、Kimi、千问、OpenAI、Ollama，并支持自定义 OpenAI 兼容端点；根据对话、视觉、轻量任务和长上下文场景选择模型。
• TxAgent 工具体系：增加场景查询、对象搜索/选中、操作与焊点分析、机器人/TCP 信息、可达性、碰撞组、对象位置、仿真控制、截图与图像分析等能力。
• 源码工作区能力：支持在限定工作区内读取、搜索、创建、精确修改、回滚和编译 C# 源码；变更操作经过审批并保留备份。
• 记忆、知识和配方：支持多对话历史、Facts/Gotchas、Markdown 知识库、代码片段、语义检索、任务计划和可复用配方。
• 多 PDPS 实例协作：支持实例发现、跨环境只读执行和结果对比，并提供无界面 RPC 执行器。
• CrossEnvIO：新增跨环境结构、组件、焊点和数学数据的导入、导出与重建辅助工具。
• McpBridge：新增通过 stdio 向外部 Agent 暴露 PS 工具的桥接子项目。
• ExportByColor 通用导出：支持按资源导出 CGR、STL、OBJ、PLY、FBX，并支持设备合并、大网格分批处理、原点变换和 CATIA Product 导入。

改进

• 完善 ExportByColor 的资源树展开、可见性筛选、设备去重、Detailed 表示读取、颜色分组、CGR 拓扑处理和失败恢复日志。
• CGR 编码增加 compact95 路径、表面方向处理、退化面过滤、开放网格背面策略、边线兼容路径和大网格分块。
• STL 增加 RGB 旁车清单；OBJ 输出 MTL 材质；PLY 输出面颜色；FBX 支持二进制和 ASCII 两种格式。
• 完善 AutoPath 的碰撞世界、碰撞组、枪轴和焊接路径规划逻辑。
• 更新 AutoRecorder、CatiaPartTree、ExportGun、LineToSolid、ThemeTuner、WeldGunDefiner、WeldSpotAllocator 和 WeldSpotGrouper 的实现与界面。
• 统一部分窗口的 DPI、主题、日志和控件布局处理，提升 PS 宿主内的显示一致性。
• TxAgent API Key 使用 Windows DPAPI 加密保存；插件目录不可写时回退到用户本地数据目录。
• 记忆和知识类数据由 JSON 逐步迁移到按条目保存的 Markdown 文件，改善可读性、并发性和 Git diff 质量。

文档与维护

• 更新根目录 README.md，补充 TxAgent、CrossEnvIO、McpBridge、模型路由、记忆系统和使用流程。
• 恢复主分支原有的项目说明文档，包括根目录 README、贡献指南、AutoPath、DeviceZAligner、SnakeGame 和 WeldSpotAllocator 文档。
• 新增 ExportByColor/TECHNICAL_REVIEW.md，记录导出链路、格式能力、风险分级、修复建议和回归测试清单。
• 新增 Agent 维护脚本与回归辅助材料，覆盖记忆清理、存储回归和视觉路由检查。

兼容性与部署

• 目标框架：.NET Framework 4.8；项目当前语言版本为 C# 8.0。
• 运行环境：推荐 Process Simulate 2402；PS SDK 和 CATIA COM 引用应使用目标机器实际安装版本。
• TxAgent 聊天界面依赖 WebView2；run_python 需要目标机器具备可用的 Python 环境。
• CGR 导出依赖运行中的 CATIA V5；STL、OBJ、PLY 和 FBX 可独立输出到文件目录。
• 编译项目时会在存在 McpBridge/McpBridge.csproj 的情况下联动构建 MCP 桥接程序。

已知限制

• ExportByColor 的 CGR 编码属于自定义兼容实现，仍需在目标 CATIA 版本和真实生产网格上进行导入验证。
• 多颜色几何、Detailed 表示恢复、导出异常边界和伴随文件原子发布等问题已在技术审查文档中列为后续优先修复项。
• PS SDK、CATIA COM 和 WebView2 均属于宿主环境依赖，未安装或版本不匹配时不能仅通过仓库代码解决。

版本说明

• 本次日志对应当前主分支 main 的累计更新。
• 详细设计和使用方式请参阅根目录 README.md 及各模块目录下的 README/技术文档。

TxTools_2.1.5

修复已知问题

TxTools_2.1.4

修复已知问题

TxTools_2.1.3

1、优化AI，增加了AI的知识库能力，读取PS跟PD文档作为知识来源
2、优化AI，增加代码的读取与编写能力，现在AI可以自己写插件了。
3、优化路径规划器的干涉集创建能力

TXTools_2.1.2

1、AI现在更聪慧了，可以想起来以前的事情了
2、修复了一下焊点导出到Excel的BUG
3、添加了两个小游戏
4、添加了路径自动规划能力

2.1.1

兼容性修复

V2.1

新增AI Agent工具
新增X枪运动学快速定义
新增导入资源的路径同步
新增按照绑定零件进行焊点分配

V2.01

chore: 更新 README.md 为中文帮助文档（覆盖）