DFCine Docs

简体中文

English

简体中文

English

外观

使用 Codex 控制 DFCine 画布 ​

完成本指南中的配置后，你可以直接在 Codex 中通过自然语言读取和操作当前打开的 DFCine 画布。

配置前准备 ​

开始前，请确认：

  • DFCine 已正常安装并通过软件授权。
  • DFCine 中已经打开一个项目和画布。
  • 电脑使用 Windows 系统，可以打开 PowerShell。
  • 请勿把 DFCine 的本地控制 Token 或完整配置脚本发送给其他人。

第一步：下载并安装 Codex ​

访问 OpenAI Codex 官方页面，根据页面提示下载并安装 Codex，然后使用你的 OpenAI 账号登录。

第二步：在 DFCine 中生成 Codex 配置脚本 ​

  1. 打开 DFCine，并进入一个项目画布。
  2. 打开 DFCine 的“设置”。
  3. 在设置菜单中选择“MCP Agent”。
  4. 点击“重新生成 Token”。
  5. 找到“Codex 全局接入”区域。
  6. 在“完整配置脚本”右侧点击“复制脚本”。按钮显示“已复制”即表示复制成功。

接下来打开 Windows PowerShell：

  1. 按下 Win 键，搜索 PowerShell。
  2. 打开“Windows PowerShell”或“PowerShell”。
  3. 在窗口中粘贴刚才复制的完整脚本。
  4. 按下回车键执行。

执行成功后，PowerShell 会提示 DFCine MCP 配置已经写入 Codex 配置文件，并提醒你重新打开终端或重启 Codex。

这段脚本会自动新增或更新 Codex 中名为 dfcine 的 MCP 服务器，不需要手动编辑配置文件。

如果以后再次点击“重新生成 Token”，需要重新复制并执行最新脚本，然后重启 Codex。旧 Token 会立即失效。

第三步：启用 DFCine MCP 服务 ​

回到 DFCine 的“MCP Agent”设置页面：

  1. 勾选“启用”。
  2. 点击“保存 MCP 设置”。
  3. 保持 DFCine、当前项目和画布处于打开状态。

默认本地服务地址为 http://127.0.0.1:38765/mcp。通常不需要修改“本地端口”。

第四步：检查 Codex 中的 DFCine 服务器 ​

如果 Codex 已经打开，请先完全退出并重新打开，使刚才的配置生效。

  1. 打开 Codex。
  2. 点击右下角的“设置”。
  3. 进入“设置”菜单。
  4. 选择“MCP 服务器”。
  5. 在服务器列表中查找 dfcine。

如果 dfcine 已显示并且处于正常启用状态，说明 Codex 已经读取到 DFCine 的 MCP 配置。

第五步：测试 MCP 连接 ​

在 Codex 中新建一个会话，然后输入：

text
现在 DFCine 画布的 MCP 服务有哪些？请列出你当前可以使用的 DFCine 工具。

连接正常时，Codex 会返回一组名称以 dfcine_ 开头的工具，例如读取画布信息、列出节点、读取选中节点、写入节点提示词、读取节点参数或运行节点等工具。

你也可以继续输入：

text
请读取当前 DFCine 画布的信息，并告诉我当前选中了哪个节点。

如果 Codex 能返回当前画布或节点信息，说明配置已经完成。

第六步：开始使用 Codex 控制画布 ​

配置成功后，你可以在 Codex 中直接描述想做的事情。例如：

text
请读取 DFCine 当前选中的节点和它的工作流说明，根据当前节点的要求优化提示词，先预览修改内容，确认没有问题后再写入节点。

也可以输入：

text
请读取当前画布的节点列表，并说明每个节点目前可以通过 MCP 完成哪些操作。

Codex 只能使用 DFCine 当前已经开放并授权的 MCP 功能。DFCine 后续会继续完善画布 MCP 能力，让 Agent 与画布之间的操作更加顺畅。

常见问题 ​

Codex 中没有看到 dfcine ​

  • 确认已经在 PowerShell 中执行完整配置脚本。
  • 完全退出并重新打开 Codex。
  • 回到 DFCine，重新复制脚本并执行一次。

能看到 dfcine，但无法读取画布 ​

  • 确认 DFCine 正在运行。
  • 确认已经勾选“启用”并点击“保存 MCP 设置”。
  • 确认 DFCine 已打开项目和画布。
  • 如果重新生成过 Token，请重新执行最新脚本并重启 Codex。

提示连接失败或服务器不可用 ​

  • 不要关闭 DFCine。DFCine 的 MCP 服务只在软件运行且 MCP Agent 已启用时可用。
  • 检查 DFCine 与 Codex 配置使用的端口是否一致。
  • 如果修改过本地端口，请重新复制并执行配置脚本。

PowerShell 执行脚本后没有生效 ​

  • 查看 PowerShell 中是否出现红色错误信息。
  • 确认粘贴的是“Codex 全局接入”下的完整脚本。
  • 执行成功后必须重启 Codex，再检查 MCP 服务器列表。

DFCine documentation site.

Copyright (c) DIGITFOLD.