OpenTxAgent — Process Simulate / PDPS AI 工程助手

English · 常用任务 · 工具目录 · 集成与启动 · TxTools 主项目 · 更新日志

面向 Siemens Tecnomatix Process Simulate（PDPS） 的进程内 AI 助手，用场景工具查询工程、检查机器人与设备、执行 C# / Python 自动化，并将重复操作保存为带参数的 Markdown 配方。

AI agent for Siemens Tecnomatix Process Simulate (PDPS) — scene tools, C# / Python automation, robot reachability, BASE0 checks, device leveling, reusable recipes and CATIA / Excel workflows.

常用任务

我想完成什么	从这里开始
查询对象、操作、机器人和点位	工具目录：通过场景工具取得实际对象与工程数据
检查机器人可达性、关节余量和 BASE0	机器人检查：可达性分析、基座检查与校正
检测底座倾斜并将设备调平、落地	设备网格调平：三角网格最低点、支撑面与写入后复测
导出焊点评审资料	焊点截图接口：视口图像、可编辑标注和 Excel 坐标表
把重复操作变成按钮	默认配方：对象绑定、参数、执行按钮及 Markdown 导入导出
连接 CATIA、生成文档或执行脚本	工具目录：CATIA 树/焊枪、DOCX/PPTX/XLSX、C# / Python
接入自己的模型或本机 Ollama	模型与配置：内置提供商和自定义兼容端点
从外部 MCP 客户端访问 PS	使用宿主的 TxTools McpBridge

核心能力

场景与工程工具：对象搜索与层级、选择、操作与焊点、位姿、TCP/参考系、碰撞、仿真及 CEE/PLC 相关接口。当前源码包含 100 个内置工具定义，模型可见集合由启用的工具组和动态配方决定。
机器人与设备检查：复用宿主的多 TCP、IK、关节与 BASE0 分析；使用世界坐标三角网格检测最低点、支撑倾角和共面误差，调平与落地后重新读取验证。
工程脚本与配方：执行 C# / Python，将已验证代码保存为带对象、文本、数字、布尔、颜色参数和执行按钮的 Markdown 配方。对象绑定随工程重新选择，同名导入另建副本。
交付与外部应用：视口/窗口截图、Excel 焊点标注、CATIA 产品树与焊枪导出，以及 DOCX、XLSX、PPTX 生成与模板处理。
多模型与本地存储：主对话、视觉工具、历史、Facts/Gotchas、代码片段和知识检索。模型能力与可用性以所配置端点为准。
多个 PS 实例：实例发现、命名管道 RPC、目标端权限与线程检查、跨实例执行及只读对比。

集成与启动

本仓库发布 Agent 源码子树及部分宿主共享源码增量，需要合入兼容的完整 TxTools 工程；不包含独立构建工程或可直接运行的安装包。

准备 TxTools 宿主与合法安装的 PS 2402 SDK，按集成说明同步 Agent 源码及 integration/TxTools 中的共享实现。
检查宿主编译清单、UI 嵌入资源和默认配方 targets，在完整宿主中使用 tools/Build.ps1 构建。
部署完整插件输出并注册 TxAgent 命令。在 PS 中打开助手，配置模型端点和凭据，再从场景查询开始使用。
需要停靠界面时按 Viewer 部署说明注册；可选桌宠组件按组件说明准备。

环境	要求
宿主	Windows、Process Simulate 2402；其他版本需单独验证
主插件	.NET Framework 4.8 / x64；宿主 C# 语言版本为 8.0
界面	WebView2 Runtime
模型	支持工具调用的兼容端点；视觉工具还需支持图像的模型
可选功能	Python 环境、CATIA V5、活动 Excel 工作簿、Electron/动画组件，按功能准备

Siemens SDK、外部应用、模型权重及下载运行组件需另行准备，不随源码分发。运行时代码片段还受所用 CodeDom 编译器限制。

模型与配置

内置提供商包括 DeepSeek、Kimi、Qwen、OpenAI 和 Ollama，也支持自定义 OpenAI 兼容端点。提供商与模型目录由源码配置及端点返回共同决定，不保证任意型号均支持工具或视觉。

API Key 使用 Windows DPAPI 绑定当前用户加密，更换用户或机器后需重新配置。历史、偏好、知识库和执行日志由部署环境本地管理，存储机制见维护说明。

架构与执行

flowchart LR
    UI[PS 内的聊天与配方界面] --> H[Agent Harness]
    H <--> M[配置的模型端点]
    H --> T[工具与脚本适配]
    T --> P[PS 主线程与 SDK]
    T --> E[CATIA / Excel / 文件]
    H --> S[本地历史与记忆]

UI 通过 HarnessAgentLoop 接入通用循环。工具声明名称、JSON Schema、只读/写入及线程属性；PS SDK 调用通过 PsContext / PsAgentHost 回到宿主主线程。开发入口见 Harness 接入。

建议按 查询 → 核对参数或代码 → 执行 → 检查结果 → 保存配方 组织工程操作。场景写入使用共享撤销分组，工程加载和模式切换后不再沿用旧事务或旧几何状态。

部分失败不代表自动回滚；文件、Excel 和 CATIA 的变更不能依赖 PS 撤销恢复。Python、静态脚本检查和项目构建不构成执行沙箱。调平针对模型的三角化表示，复杂底座可能需要指定支撑几何。

源码导航

路径	职责
TxAgentCommand.cs	命令入口、工具注册和后台初始化
Core	模型客户端、Harness、存储、路由、配方与跨实例服务
Ps / Tools	SDK 访问、工具声明、脚本和设备网格分析
UI / Scripting	WinForms、WebView2、桌宠适配与 Python 宿主
recipes	正式配方定义和使用说明
integration/TxTools	本版本依赖的宿主共享源码增量
maintenance / deployment	资源嵌入、组件准备、存储与部署

兼容性与反馈

本版本在集成宿主中通过 2402 SDK 的 Release 编译及相关离线回归。真实工程、CEE、仿真、CATIA 和 Excel 行为仍需在目标环境验收。详细接口与限制见工具说明，版本变更见更新日志。

源码采用 MIT License，专有 SDK 边界见 NOTICE。问题与功能建议可提交到 Issues；请说明宿主版本、工具名称、复现步骤和预期结果，并移除工程敏感信息。