DFCine Docs

简体中文

English

简体中文

English

外观

使用 WorkBuddy 控制 DFCine 画布 ​

完成本指南中的配置后，你可以在 WorkBuddy 中通过自然语言读取和操作当前打开的 DFCine 画布，也可以进一步配置微信机器人，在微信聊天窗口中控制画布。

配置前准备 ​

开始前，请确认：

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

第一步：下载并安装 WorkBuddy ​

访问 WorkBuddy 下载邀请页面：

  1. 点击“下载 WorkBuddy”。
  2. 在弹出的下载页面中选择 Windows x64 版本。
  3. 下载完成后，打开安装程序并按照提示完成安装。
  4. 安装完成后先不必配置连接器，继续完成下面的 DFCine 设置。

第二步：在 DFCine 中生成 WorkBuddy 配置 ​

  1. 打开 DFCine，并进入一个项目画布。
  2. 打开 DFCine 的“设置”。
  3. 在设置菜单中选择“MCP Agent”。
  4. 查看“本地控制 Token”是否有内容。

如果 Token 是空的，请点击“重新生成 Token”。

如果你之前已经配置过 Codex，并且 Codex 可以正常使用 DFCine MCP，请不要重新生成 Token。重新生成后旧 Token 会立即失效，原来的 Codex 配置将无法连接，需要重新执行 Codex 配置脚本。

接下来找到“WorkBuddy MCP 配置”区域：

  1. 在“完整配置脚本”右侧点击“复制脚本”。
  2. 按下 Win 键，搜索并打开 PowerShell。
  3. 在 PowerShell 中粘贴刚才复制的完整脚本。
  4. 按下回车键执行。

执行成功后，PowerShell 会提示 DFCine MCP 配置已经写入 WorkBuddy 配置文件，并提醒你重启 WorkBuddy。

这段脚本会保留 WorkBuddy 中已有的 MCP 服务，只新增或更新名为 dfcine 的服务器。你不需要手动编辑配置文件，也不需要设置系统环境变量。

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

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

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

第三步：在 WorkBuddy 中启用 DFCine 连接器 ​

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

  1. 打开 WorkBuddy。
  2. 在左侧栏顶部点击“专家 / 技能 / 连接器”选项。
  3. 在打开的页面中点击“连接器”。
  4. 在页面左上角选择“自定义连接器”。
  5. 打开“我的 MCP”，检查是否能看到 dfcine。
  6. 第一次使用时，按照提示点击“信任”。
  7. 确认 dfcine 已经启用。

如果能在“我的 MCP”中看到 dfcine，说明 WorkBuddy 已经读取到 DFCine 的 MCP 配置。

如果 dfcine 显示连接失败，请先关闭再重新打开该连接器的启用开关。如果仍然无法连接，请完全退出并重新打开 WorkBuddy，然后再次检查连接状态。

第四步：测试 WorkBuddy 与 DFCine 的连接 ​

在 WorkBuddy 中新建或打开一个对话，然后直接输入测试指令：

  1. 模型可以选择 Auto，也可以自行选择其他模型。
  2. 如有需要，也可以按照 WorkBuddy 的说明接入第三方模型。
  3. 输入并发送测试指令。

建议先输入：

text
你现在能看到 DFCine 的 MCP 功能吗？请列出当前可以使用的 DFCine 工具。

连接正常时，WorkBuddy 会返回一组名称以 dfcine_ 开头的工具。你也可以继续输入：

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

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

第五步：开始使用 WorkBuddy 控制画布 ​

配置成功后，你可以直接描述想让 WorkBuddy 完成的操作。例如：

text
请读取 DFCine 当前选中的节点和工作流说明，根据当前工作流的要求优化提示词，先告诉我准备修改的内容，再写入节点。

也可以输入：

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

WorkBuddy 只能使用 DFCine 当前已经开放并授权的 MCP 功能。执行涉及写入参数或运行节点的操作前，请留意任务中显示的计划和确认信息。

第六步：使用微信控制 DFCine 画布 ​

WorkBuddy 还支持通过微信机器人接收任务。具体配置方法请查看 WorkBuddy 微信 ClawBot 配置教程。

完成微信绑定和机器人配置后，你可以：

  • 在微信聊天窗口中通过微信 ClawBot 发送画布控制指令。
  • 在 WorkBuddy 的“助理”按钮中选择微信控制任务所使用的模型。
  • 通过微信让 WorkBuddy 调用已经启用的 DFCine MCP 工具。

使用微信控制时，运行 WorkBuddy 和 DFCine 的电脑需要保持开机，并确保 DFCine 已打开项目和画布、MCP Agent 已启用。

常见问题 ​

WorkBuddy 中没有看到 dfcine ​

  • 确认已经在 PowerShell 中执行“WorkBuddy MCP 配置”下的完整脚本。
  • 完全退出并重新打开 WorkBuddy。
  • 进入“专家 / 技能 / 连接器 -> 连接器 -> 自定义连接器 -> 我的 MCP”重新检查。
  • 回到 DFCine，重新复制 WorkBuddy 脚本并执行一次。

看到了 dfcine，但工具没有启用 ​

  • 第一次使用时需要点击“信任”。
  • 确认 dfcine 连接器的启用开关已经打开。
  • 如果显示连接失败，请关闭并重新打开启用开关；仍然失败时，完全退出并重新打开 WorkBuddy。
  • 新建一个任务后再测试，不要继续使用配置前已经打开的旧任务。

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

  • 确认 DFCine 正在运行。
  • 确认“MCP Agent”中的“启用”已经勾选，并点击过“保存 MCP 设置”。
  • 确认 DFCine 已经打开项目和画布。
  • 确认 WorkBuddy 使用的端口和 Token 与 DFCine 当前设置一致。

配置 WorkBuddy 后 Codex 无法使用 ​

WorkBuddy 配置本身不会破坏 Codex 配置。最常见的原因是在配置过程中重新生成了 Token。

如果重新生成过 Token，请分别重新复制并执行：

  • “Codex 全局接入”中的完整配置脚本。
  • “WorkBuddy MCP 配置”中的完整配置脚本。

执行完成后，重启 Codex 和 WorkBuddy。

修改端口或 Token 后连接失败 ​

端口或 Token 发生变化后，需要重新执行最新的 WorkBuddy 配置脚本，并重启 WorkBuddy。已经配置 Codex 的用户还需要重新执行 Codex 配置脚本并重启 Codex。

DFCine documentation site.

Copyright (c) DIGITFOLD.