用途：让可执行 shell 的智能体宿主（OpenClaw、Hermes、Codex CLI、CI 机器人、自定义智能体运行时）通过 dcc-mcp-cli 控制实时 DCC 应用，无需 MCP 连接器；已配置 MCP 的 IDE 用户应继续使用原生 MCP 路径。
主要能力：本地模式先确保回环网关健康，再读取核心默认 FileRegistry；search、describe、load-skill、call、wait-ready、受保护的 stop-instance 与所选本地 DCC 实例通信。远程机器通过命名网关配置选择。CLI 默认返回 JSON。
关键用法：起始先跑 dcc-mcp-cli list；状态不明时跑 dcc-mcp-cli doctor；流程为 search → describe → call，例如 dcc-mcp-cli search --query sphere --dcc-type maya --limit 20，再 describe，随后 dcc-mcp-cli call <slug> --json '{"radius":2.0}'。远程配置可用 dcc-mcp-cli gateway register https://workstation.example:19293 --name pcA，以及 gateway list、gateway set pcA、list --gateway pcA。CLI 缺失时先征得同意再用 --ensure-cli；下载失败可用捆绑的仅 REST 的 Python 回退。
限制与注意：list 仅为清单与诊断，不等于行可调用；dispatch_status=ready 前不应调用。total 为 0 时必须停止，先征得用户同意再引导设置。网关不可达要停止并说明；仅本地回环可自动启动。未获同意不得安装包、改配置或启动 GUI。安装不自动触发插件启动，需宿主插件或边车存活后 list 才会显示实例。适配器安装的 --execute 必须获得用户同意；auto_install_enabled 为 false 时不得重试。DCC 崩溃或重启后应重新运行 list 与 search。