TalkCraft 新手安装与工作流搭建
从插件安装到一键数字人、参考图视频两套工作流的节点连线与分阶段测试方法。
- TalkCraft 不下载本地模型、不需要额外 Python 依赖，装完直接调用 ComfyUI 合作方 API 节点。
- 插件自带一键数字人和参考图视频两套工作流 JSON，导入后先替换素材再运行。
- 先测试提示词和台词，确认无误再跑视频生成，能省掉不必要的 API 开销。
- 报错大多出在插件目录嵌套、ElevenLabs 节点旁路状态和 seed 参数格式这三处。
使用前准备
本文只讲安装、导入、连接、设置和测试，不讲提示词写法。
ComfyUI 能正常启动并打开网页界面。
已有可用 ComfyUI 合作方 API 节点的账号和 Credits。
数字人工作流需要一张人物图片和一段音频。
参考图视频工作流需要一张或两张参考图。
方法一：Git 安装
关闭 ComfyUI，找到 custom_nodes 文件夹。
在文件夹内打开终端，执行下面这条命令：
git clone https://github.com/wwzhifeng/ComfyUI-TalkCraft.git
确认 __init__.py 直接位于 ComfyUI-TalkCraft 目录内，不能再套一层文件夹。
方法二：下载 ZIP 安装
打开插件的 GitHub 页面，点击 Code，再点击 Download ZIP。
解压后把文件夹放进 custom_nodes。
文件夹名可以从 ComfyUI-TalkCraft-main 改成 ComfyUI-TalkCraft。
ZIP 解压后如果 custom_nodes 下出现 ComfyUI-TalkCraft/ComfyUI-TalkCraft-main 两层文件夹，__init__.py 会被套在里层，ComfyUI 识别不到插件。正确结构是 __init__.py 直接在 ComfyUI-TalkCraft 目录下。
启动并检查
启动 ComfyUI，查看终端确认没有 ComfyUI-TalkCraft 导入失败的报错。
打开 ComfyUI 网页，浏览器按 Ctrl+F5 强制刷新。
双击画布空白区域，搜索 TalkCraft。
正常能看到六个相关节点：TalkCraft 一键数字人、数字人动作方案、台词来源（自动/手动）、TalkCraft 参考图视频、视频方案选择、提示词预览。
搜索不到就先确认安装路径，再完整关闭并重启 ComfyUI。
直接导入自带工作流
插件自带两份工作流，分别是 TalkCraft-一键数字人.json 和 TalkCraft-参考图视频.json，存放在插件目录下的 example_workflows 文件夹。
打开 ComfyUI 网页。
把需要的 JSON 文件直接拖进画布，或用「打开工作流」功能选择 JSON。
导入后先不要直接运行。
替换示例图片、上传音频。
检查模型选择是否正确。
先重启 ComfyUI，确认 TalkCraft 安装成功；再更新 ComfyUI 本身，让它包含工作流用到的 OpenRouter、Kling、ElevenLabs 或 Seedance 合作方 API 节点。TalkCraft 不会自动安装这些节点。
节点、连线与关键参数
完整的一键数字人工作流用到 10 个节点：Load Image、Load Audio、ElevenLabs Speech to Text（可选，默认旁路）、台词来源（自动/手动）、TalkCraft 一键数字人、OpenRouter LLM、数字人动作方案、提示词预览、Kling Avatar 2.0、Save Video。还可以再放一个提示词预览，专门显示台词。
| 起点 | 终点 |
|---|---|
Load Image.IMAGE | OpenRouter LLM.image_1 |
Load Image.IMAGE | Kling Avatar 2.0.image |
Load Audio.AUDIO | Kling Avatar 2.0.sound_file |
Load Audio.AUDIO | ElevenLabs Speech to Text.audio |
ElevenLabs Speech to Text.text | 台词来源.自动转写文本 |
台词来源.最终台词 | TalkCraft 一键数字人.台词或音频内容 |
台词来源.最终台词 | 台词预览.文本 |
TalkCraft 一键数字人.LLM表演任务 | OpenRouter LLM.prompt |
TalkCraft 一键数字人.LLM系统指令 | OpenRouter LLM.system_prompt |
OpenRouter LLM.STRING | 数字人动作方案.LLM返回JSON |
数字人动作方案.最终视频提示词 | 提示词预览.文本 |
数字人动作方案.最终视频提示词 | Kling Avatar 2.0.prompt |
Kling Avatar 2.0.VIDEO | Save Video.video |
TalkCraft 一键数字人的主要参数
| 参数 | 说明 |
|---|---|
| 创作目标 | 说明视频用途，比如「自然介绍产品功能」 |
| 人物与品牌设定 | 说明人物身份、品牌要求及不能改变的内容 |
| 表演风格 | 自然讲述、专业播报、商业口播或亲切交流 |
| 动作强度 | 保守、适中或明显 |
| 镜头方式 | 固定镜头、轻微推进或自动选择 |
| 目标数字人 API | 只负责提示词适配，不替换右侧实际视频模型节点 |
| 锁定项（身份/服装发型/背景光线） | 三项默认保持开启 |
| 禁止事项 | 可填写额外限制，禁止字幕已由结果节点强制添加 |
不用自动转写时，把音频台词直接粘贴到「手动台词」，保持「自动转写优先」开启即可。手动台词留空时 TalkCraft 仍能生成通用表演，但动作对不上具体语义重点。
默认灰色旁路，不调用转写 API。选中节点按 Ctrl+B 可以切换旁路状态，取消旁路后音频会发到 ElevenLabs 云端并按节点显示的价格计费。
分阶段测试流程
先测提示词和台词，确认无误再跑视频生成，可以省掉不必要的生成成本。
测试手动台词
保持 ElevenLabs 节点为灰色旁路状态。
在「台词来源」填写手动台词。
选中「台词预览」节点，点击节点上方蓝色运行按钮。
确认预览内容正确。
测试自动转写
选中 ElevenLabs 节点，按 Ctrl+B 取消旁路。
选中「台词预览」节点，点击运行按钮，检查自动识别文本。
不再使用自动转写时，再按一次 Ctrl+B 恢复旁路。
只测试提示词
选中最终「提示词预览」节点，点击运行按钮。
这一步只运行图片分析和提示词生成，不需要跑 Kling 视频节点。
检查人物身份、动作强度和禁止字幕要求是否符合预期。
生成短视频
使用 3～10 秒音频，Kling 模式选择 std。
确认图片和音频连接正确，运行完整工作流。
生成后检查口型、身份、动作、字幕伪影和背景稳定性。
首尾帧工作流的节点与连线
参考图视频工作流比一键数字人少几个节点：两个 Load Image、TalkCraft 参考图视频、OpenRouter LLM、视频方案选择、提示词预览、一个首尾帧视频 API 节点（比如 Seedance）、Save Video。
| 起点 | 终点 |
|---|---|
首帧 Load Image.IMAGE | OpenRouter LLM.image_1 |
尾帧 Load Image.IMAGE | OpenRouter LLM.image_2 |
首帧 Load Image.IMAGE | 视频API.first_frame |
尾帧 Load Image.IMAGE | 视频API.last_frame |
TalkCraft 参考图视频.LLM视频任务 | OpenRouter LLM.prompt |
TalkCraft 参考图视频.LLM系统指令 | OpenRouter LLM.system_prompt |
OpenRouter LLM.STRING | 视频方案选择.LLM返回JSON |
视频方案选择.最终视频提示词 | 提示词预览.文本 |
视频方案选择.最终视频提示词 | 视频API.prompt |
视频API.VIDEO | Save Video.video |
TalkCraft 参考图视频的主要参数
| 参数 | 说明 |
|---|---|
| 创作意图 | 说明人物或物体如何从首帧运动到尾帧 |
| 参考模式 | 选择「首尾帧生视频」 |
| 素材角色说明 | 填写「图1：首帧；图2：尾帧」 |
| 目标视频 API | 选择需要适配的提示词类型，只改变提示词规则 |
| 主镜头 / 运动强度 | 第一次测试建议自动选择或固定机位、强度适中 |
| 时长秒数 | 应与实际视频 API 节点的时长设置一致 |
目标视频 API 只改变提示词规则，Seedance、Kling 等实际视频节点的模型选项、时长、分辨率仍需单独设置。
__init__.py 是否直接在插件目录下、是否完整重启、终端有无导入错误、浏览器是否按了 Ctrl+F5。Ctrl+F5。Ctrl+B 取消旁路。seed 是整数（例如 0），不要留空，也别随意删改自带工作流的控件。更新与卸载
更新（Git 安装方式）
进入插件目录：
cd ComfyUI/custom_nodes/ComfyUI-TalkCraft
拉取更新：
git pull
更新后完整重启 ComfyUI，并按 Ctrl+F5。
更新（ZIP 安装方式）
备份自己修改过的插件文件。
下载新版 ZIP，关闭 ComfyUI。
用新版插件文件替换旧版，启动 ComfyUI 并强制刷新浏览器。
卸载
关闭 ComfyUI。
删除 ComfyUI/custom_nodes/ComfyUI-TalkCraft 文件夹。
重新启动 ComfyUI。
卸载插件不会自动删除已经生成的视频和用户保存的工作流，但使用了 TalkCraft 节点的工作流在插件卸载后会显示缺失节点。
内容整理自插件自带说明文档与实际安装、导入、连线操作流程。