catia-com-bridge — CATIA V5 COM 通用桥梁

概述

提供从 Python 安全调用 CATIA V5 COM 接口的通用方案：Python subprocess.run() → cscript → VBS → COM → CATIA。

在 WorkBuddy 沙箱环境下，直接调用 cscript 可能被 LOLBin 策略拦截，但通过 Python 子进程嵌套调用已验证可行（2026-06-07）。

为什么需要这个桥梁？

本机环境

前置条件

• Windows 系统（cscript 和 CATIA 均为 Windows 独占）
• CATIA V5 已启动，目标文档已打开
• Python 3.x（WorkBuddy managed）

工作原理

Python script
  └─ subprocess.run(["cscript", "//nologo", "script.vbs", arg1, arg2...])
       └─ cscript.exe (Windows Script Host)
            └─ script.vbs
                 └─ GetObject(, "CATIA.Application")  ← COM 连接到运行中的 CATIA
                      └─ 读取/操作 CATIA 对象模型
                           └─ WScript.Echo 输出结果 → Python stdout 捕获

使用方式

方式 1：直接使用桥梁模块（推荐）

import sys
sys.path.insert(0, r"C:\Users\vobes23\.workbuddy\skills\catia-com-bridge\scripts")
from catia_bridge import run_catia_script, check_catia_running

# 检查 CATIA 是否在运行
if not check_catia_running():
    print("ERROR: CATIA is not running")
    sys.exit(1)

# 执行 VBS 脚本
result = run_catia_script(
    vbs_path=r"D:\path\to\script.vbs",
    args=["output.txt", "extra_param"],
    timeout=300
)

if result.returncode == 0:
    for line in result.stdout.splitlines():
        print(line)
else:
    print(f"ERROR: {result.stderr}")

方式 2：Skill 引用模式

其他 Skill 声明对本 Skill 的依赖，使用桥梁函数：

# 在 Skill 脚本中
import sys
bridge_dir = r"C:\Users\vobes23\.workbuddy\skills\catia-com-bridge\scripts"
if bridge_dir not in sys.path:
    sys.path.insert(0, bridge_dir)

from catia_bridge import run_catia_script

VBS 脚本规范

被桥梁调用的 VBS 脚本应遵循以下规范：

1. 接收参数：通过 WScript.Arguments 获取调用参数
2. 连接 CATIA：Set catia = GetObject(, "CATIA.Application")
3. 输出结果：使用 WScript.Echo 输出结构化数据
4. 错误报告：使用 WScript.Echo "ERROR|CODE|Description" 格式
5. 退出码：WScript.Quit 0（成功）/ WScript.Quit 1（失败）

示例模板：

Option Explicit
Dim catia, outputPath
Set catia = GetObject(, "CATIA.Application")
outputPath = WScript.Arguments(0)  ' 第一个参数：输出文件路径

' 执行 CATIA 操作...
Dim fso, outFile
Set fso = CreateObject("Scripting.FileSystemObject")
Set outFile = fso.CreateTextFile(outputPath, True)
outFile.WriteLine "data..."
outFile.Close
WScript.Quit 0

桥梁 API 参考

check_catia_running() -> bool

检查 CATIA V5 进程是否在运行（通过进程名 CNEXT.exe）。

run_catia_script(vbs_path, args=None, timeout=300) -> CompletedProcess

执行 VBS 脚本并返回结果。

返回值 subprocess.CompletedProcess：

• .returncode — 0 成功
• .stdout — WScript.Echo 输出
• .stderr — 错误输出

get_catia_app() — 仅 VBS 侧

VBS 脚本内部使用的 CATIA 连接模式：

Set catia = GetObject(, "CATIA.Application")
Set topProduct = catia.ActiveDocument.Product

文件结构

catia-com-bridge/
├── SKILL.md
└── scripts/
    └── catia_bridge.py    ← 桥梁核心模块（纯 Python，零外部依赖）

使用本桥梁的 Skill

已知限制

• 仅支持 Windows（依赖 cscript 和 CATIA COM）
• 需要 CATIA 唯一实例（多实例时可能连接错误的实例）
• VBS 脚本执行期间 CATIA UI 可能短暂无响应
• 不适用于实时高频调用（每次调用启动一个 cscript 进程）

故障排查