dcc-mcp-debug

# DCC 运行调试手册 (DCC-MCP-Debug) > 这套方法是**用户自己的工具/工作流**，不是 Autodesk 官方文档记录的功能—— > 不要把它当成"MotionBuilder/3ds Max 内置能力"介绍给别人，也不要在其它机器上假设它一定存在 > （得先用"安装DCC连接器"流程装好）。 ## 背景 DCC 软件（MotionBuilder、3ds Max、Maya）通常自带一个内嵌 Python 解释器，版本往往和系统里独立安装的 Python 不一致。如果某些依赖包（比如某个 `.pyd` 编译扩展）是专门编译给 DCC 内嵌 Python 版本的， 在系统独立 Python 下 `import` 会直接失败（`ModuleNotFoundError` 或 ABI 不匹配）。这种情况下， 唯一能"跑起来看效果"的办法就是让 DCC 自己执行代码——这份手册记录的就是怎么从外部（比如这个 agent 所在的 shell）把代码注入到正在运行的 DCC 进程里执行，而不用用户手动去点。 ## 原理 DCC 软件装好 commandPort 连接器后，会监听一个本地 TCP 端口，**端口号等于该 DCC 进程自己的 PID**，收到的原始文本会被当成 Python 代码 `exec()` 执行。具体是哪个插件/怎么装的见下面 "安装 DCC 连接器"。 `exec()` 执行的是一段匿名字符串，不是真实文件，所以像 `os.path.dirname(__file__)` 这种写法本来 会报 `NameError: name '__file__' is not defined`——用脚本文件路径调用 `exec` 时默认会自动垫一行 `__file__ = "<脚本绝对路径>"` 绕开这个问题（可以用 `--no-file-shim` 关掉；`-c` 内联代码模式没有 文件路径，不垫这行）。 这个命令端口是个**有状态的 REPL**：一条连接建立时先吐一次 Python 版本 banner，之后同一条连接上 可以连续发多条命令、各自收响应，不需要每条命令都重新连接。`dcc_service.py` 就是利用这一点，给 每个注册的 DCC 各维护一条常驻连接，所有 `exec` 请求都在对应连接上排队执行 （`dcc_bridge.DCCConnection` 内部加了锁）。 ## 安装 DCC 连接器（commandPort） `dcc_mcp_debug/plugin/` 下是 commandPort 插件本身（各 Python 版本的 `.pyd` + 3ds Max 的 `.ms`、 MotionBuilder 的 `.py`、Maya 的 `.mod` 模块声明 + 模块里的 `userSetup.py`）——这就是上面"原理"里说的那个"黑盒 TCP 执行入口"的真身。它**随包分发**，`pip install` 之后就在安装好的包里，不需要另外找文件。 **优先用自动安装**（不用查版本对照表、不用先知道装在哪个盘）： - MCP 工具 `dcc_install_connector`（先带 `dry_run: true` 预演一次） - 命令行 `dcc-cli mobu install-connector` / `dcc-cli max install-connector` / `dcc-cli maya install-connector` 它会调用目标 DCC 自带的独立解释器（`mobupy.exe` / `3dsmaxpy.exe` / `mayapy.exe`）问出 **Python 版本**和 **sys.path**， 据此挑对应的 `.pyd`、并选对该装哪一层 site-packages（MotionBuilder 各版本有两层 site-packages 且都在 sys.path 上，靠"哪个目录存在"判断会装错），最后放好启动脚本。目标 DCC 没在运行时用 `--install-dir` / `install_dir` 指定安装根目录。装进 `Program Files` **需要管理员权限**，权限不足会明确报错；装完**必须 重启该 DCC** 才生效。 手工步骤和版本对照表见 [`https://github.com/pitelink/dcc-debug/blob/main/dcc_mcp_debug/plugin/安装说明.md`](https://github.com/pitelink/dcc-debug/blob/main/dcc_mcp_debug/plugin/安装说明.md)，作为兜底 （自动安装失败、或目标版本不在支…