用途:在正在运行的 TouchDesigner 项目中直接操作网络,创建、检查、修改和调试算子。桥接由捆绑的 TOX 在 TouchDesigner 内暴露本地 HTTP 接口,Node 脚本调用该接口,无需安装 MCP。
使用前提:TouchDesigner 2025 或更高版本;Node.js 18 或更高版本用于 scripts/client.mjs;若 op.TDAPI 不存在,需加载 assets/toe/TouchDesignerAPI.tox;TOX 的 Port 参数非 44444 时用 TDAPI_PORT 指定。
强制首步:每次会话在做任何 TouchDesigner 工作前先读一次 references/basics.md,已读则不再重复读;未读前不得执行变更类 execute 调用。
连接验证:node scripts/client.mjs ping。无法连接时提示用户加载 TOX 或对齐 TDAPI_PORT。
工作流:按需读取 references 下的 operator-families.md、geometry-comp.md、rendering.md、glsl.md、operator-tips.md;用 pane、selection、operators、params、inspect、network 检查状态;用 execute 执行小段 Python;设置参数前先用 params 核对参数名;复杂改动后另起一次调用检查错误,因为 TD 错误状态在帧边界更新。
客户端命令示例:node scripts/client.mjs pane;node scripts/client.mjs params sphereSOP --match "rad*";node scripts/client.mjs inspect /project1/base1/sphere1;node scripts/client.mjs network /project1 --depth 1。Python 可通过 stdin 传入以避免引号问题。
必需模式:优先使用 op.TDAPI 辅助函数,如 CreateOp、ChainOperators、GetParameterList、CheckErrors;创建的算子设 viewer=True;用 Null 算子作稳定端点;核对参数名;有意布局避免重叠;邻近引用用相对路径;先建源几何再接入 Geometry COMP。
个人知识库:仅在已存在或用户明确要求时使用,默认路径 ~/.touchdesigner-skill/knowledge/,可用 TD_SKILL_KB_DIR 覆盖,用 kb path 查看、kb init 初始化;只存可跨项目复用的知识,不存项目专属信息、路径、客户名或密钥;写入前先询问,除非用户明确要求记录;不得写回 SKILL.md 或 references/。
桥接资产:assets/toe/TouchDesignerAPI.tox、assets/toe/develop.toe、assets/toe/src/TouchDesignerAPI.py、assets/toe/src/td_utils.py。
限制:资料未提供收费、价格、平台支持范围或效果保证等信息。