用途:本技能是编写 Asset Transformer SDK(pxz)Python 脚本的权威参考,主要服务于本地 Asset Transformer MCP 的 run_python 工具,代码在运行中的 Pixyz 会话内进程内执行;也可为 at-upa-scripting 等技能提供 API 基础。API 面记录在 pxz-api-reference.md,未列出的函数、类、参数或常量即不存在,不应调用。
执行方式:MCP 以 exec(compile(code, "<mcp_run_python>", "exec"), {"pxz": pxz}) 运行代码。pxz 已是全局变量,无需 import,也无需调用 pxz.initialize() 或任何许可相关函数。场景有状态,跨调用持续存在,可先用 pxz.scene.getRoot() / getChildren 查看已加载内容,必要时清理。标准库可导入,但没有 argparse 式输入通道,输入为代码字面量或从场景读取。print 输出会被捕获返回。
主要能力:导入导出 io.importScene、io.importFiles、io.exportScene(按扩展名推断格式)、io.getImportFormats / getExportFormats;CAD 处理 repairCAD、assembleCAD、tessellate、tessellateRelativelyToAABB、repairMesh;优化 decimate、decimateTarget、removeHoles、deletePatches、合并或实例化重复部件、removeOccludedGeometries;UV 的 automaticUVMapping、unwrapUV、repackUV;烘焙 combineMaterials 或 beginBakingSession / bake*Map / endBakingSession;查询编辑 getChildren、getPolygonCount、getAABB、findOccurrencesByProperty、deleteOccurrences、hide / show;截图 view.takeScreenshot,必要时 raytrace.renderImage。
用法与限制:pxz 采用整数句柄模型,无对象式 API,多数函数接收 occurrence 列表。exportScene 真实签名为 exportScene(fileName: str, root: int = 0),无 format 等关键字,按格式选项通过 core.setModuleProperty("io", ...) 设置。多步改动用 startUndoRedoStep / endUndoRedoStep 包裹。无许可时本地执行不可用,可本地语法检查后改为远程 Pipeline Automation 执行,但本地快速迭代仍需许可。参考基于已安装 2026.4.0.0 存根,升级后需重新提取。