ComfyUI 与 AI 创作开发手册
本手册说明 ComfyUI 与AI 创作的关系：ComfyUI 负责真正执行模型和节点；AI 创作负责普通用户表单、目录批处理、阶段产物传递和编导任务计划；AI 创作应用开发负责把 API 工作流发布为 .xmwf。AI 客服与人工坐席不属于 ComfyUI。
关系一图看懂：
ComfyUI = 负责加载图片、视频、语言或其他节点模型并执行工作流；
AI 创作 = 负责输入表单、右键上下文、批处理、A→B→C 和编导计划；
Ollama = 可选的本地文字理解与规划层，用于提示词适配或智能拆镜，不代替 ComfyUI；
AI 创作应用开发 = 把 ComfyUI API 工作流封装成普通表单应用；
ComfyUI = 负责加载图片、视频、语言或其他节点模型并执行工作流；
AI 创作 = 负责输入表单、右键上下文、批处理、A→B→C 和编导计划；
Ollama = 可选的本地文字理解与规划层，用于提示词适配或智能拆镜，不代替 ComfyUI；
AI 创作应用开发 = 把 ComfyUI API 工作流封装成普通表单应用；
.xmwf = AI 创作安装和分发使用的“写吗工作流应用包”。普通用户和开发者分别做什么
普通用户
安装 ComfyUI 和作者提供的创作应用；在写吗简单模式中选择模板、素材和脚本，不需要打开节点图。
开发者
在 ComfyUI 调通工作流并导出 API JSON，再在写吗中配置参数、依赖、输出和错误提示，发布为 .xmwf。
需要具体案例：照片反推、中文创意出图、长剧本拆镜、角色场景绑定、A→B→C、跨镜头和完全离线模式，请查看 AI 创作短剧全流程实战手册。
一、从哪里下载 ComfyUI
手动安装适合熟悉 Python、虚拟环境和显卡依赖的用户：官方手动安装教程。
写吗不会捆绑 ComfyUI、模型、自定义节点或 FFmpeg。这是为了避免安装包巨大、许可证混杂和用户下载不需要的模型。请先把 ComfyUI 独立安装并运行成功，再连接写吗。
二、第一次安装与启动
- 安装 ComfyUI Desktop，或完整解压 Windows Portable。
- 启动 ComfyUI，等待控制台或桌面程序完成环境初始化。
- 浏览器或桌面界面可以正常打开后，确认服务地址。写吗默认连接
http://127.0.0.1:8188。 - 从官方模板选择一个基础文生图工作流，按提示下载所需模型；也可以把已有模型放入对应
models子目录。 - 先在 ComfyUI 自己的界面中成功生成一张图片。只有这一步成功，才能说明模型、节点和显卡环境基本可用。
- 需要自定义节点时，优先使用 ComfyUI-Manager。Desktop 版本已默认包含 Manager。
安全建议：本机使用保持
127.0.0.1。不要直接把 8188 端口映射到公网；远程使用应经过可信 VPN、身份认证和 HTTPS 反向代理。三、导出写吗需要的 API 工作流
- 在 ComfyUI 设置中启用开发者模式（Dev Mode / API save）。
- 打开并完整运行工作流，确保所有模型、自定义节点和输出节点都可用。
- 使用 File → Export Workflow (API) 导出 API 格式 JSON。
- 不要把普通 Save / Ctrl+S 保存的界面布局 JSON 直接当作 API 工作流。
- 在写吗对应插件设置或开发者发布页导入该 JSON，再测试连接和运行。
官方说明：开发者模式 · Workflow API Format
四、AI 创作
4.1 它负责什么
写吗负责读取当前项目、选区、章节、人物设定和视觉资料，帮助用户组织提示词、分镜、媒体版本与正文关联；ComfyUI 负责实际加载模型和节点工作流，生成图片、帧或视频。
因此，普通用户面对的操作应当是：
- 为当前选区生成插图；
- 为文章生成封面；
- 为角色生成立绘或参考图；
- 为章节生成分镜和关键帧；
- 使用图片生成短镜头；
- 将多段镜头、旁白、字幕和音乐合成为视频；
- 把最终结果插回 Markdown 或 MDX 文档。
它不是把 ComfyUI 的所有节点编辑能力重新复制进写吗。复杂节点、模型和自定义节点仍然在 ComfyUI 中维护。
截图占位：AI 创作总览
建议展示正文来源、任务模板、提示词、生成队列、结果预览和插入文档按钮。
4.2 使用前准备
必备项目
- 单独安装并启动 ComfyUI；
- 至少安装一个能够正常出图的 Checkpoint；
- 需要 LoRA、ControlNet、放大、换脸或视频能力时，提前安装对应模型和自定义节点；
- 需要最终合成 MP4 时，准备
ffmpeg.exe； - 在 ComfyUI 自己的界面里先成功运行一次基础工作流。
ComfyUI 默认地址通常为：
http://127.0.0.1:8188
建议优先保持本机地址。不要为了方便，直接把 8188 端口暴露到公网。
在写吗中连接
进入：
设置 → 插件设置 → AI 创作
填写或确认：
- ComfyUI 地址；
- 默认 Checkpoint 文件名；
- 默认图片宽度和高度；
- 采样步数、CFG、采样器和调度器；
- 默认正向与负向提示词；
- 图片 API 工作流；
- 视频 API 工作流；
- 输出目录；
- FFmpeg 路径。
然后点击“测试连接”。测试成功只表示服务可访问，不代表每个工作流中的模型和节点都完整。
截图占位：ComfyUI 连接与模型设置
标出服务地址、测试连接、Checkpoint、图片工作流、视频工作流、输出目录和 FFmpeg。
4.3 API 工作流与普通工作流的区别
写吗提交任务时，需要的是 ComfyUI API 格式 JSON 工作流。普通界面保存的工作流 JSON 主要用于在 ComfyUI 界面中恢复节点布局，不一定可以直接作为 API 工作流调用。
稳妥流程：
- 在 ComfyUI 中打开并运行工作流；
- 确认所有节点和模型均可用；
- 使用 ComfyUI 的 API 格式导出功能保存 JSON；
- 在写吗插件设置中导入该 API 工作流；
- 检查提示词、宽高、Seed、输入图和输出节点的参数绑定；
- 使用简单文本做一次测试，再用于正式项目。
工作流中出现“节点类型不存在”，通常不是写吗的问题，而是当前 ComfyUI 缺少相应自定义节点或节点版本不一致。
4.4 第一次从正文生成图片
推荐按下面步骤操作：
- 打开已经保存到项目中的 Markdown 或 MDX 文档；
- 选中一段有明确画面的正文，例如人物出场、环境描写、产品卖点或教程场景；
- 通过编辑器右键或扩展入口选择“根据选中文字生成图片”；
- 检查正文来源和任务类型；
- 选择角色、场景、风格或道具视觉档案；
- 设置宽高、数量、Seed 和输出类型；
- 使用写吗现有 AI 或本地规则生成提示词；
- 人工检查人物数量、服装、地点、时间、镜头、文字和禁止元素；
- 提交到 ComfyUI；
- 预览结果并选择插入当前文档、打开文件、打开目录或继续生成新版本；
- 满意后标记为采用版本。
正文未保存时仍可能生成，但无法稳定记录项目相对路径、正文哈希和版本关联。正式生成前建议先按 Ctrl+S。
4.5 可以生成哪些内容
| 任务 | 适合场景 | 主要输入 |
|---|---|---|
| 选区插图 | 给当前段落配图 | 当前选区、尺寸、视觉档案 |
| 章节插图 | 从整章提取多个重点画面 | 当前文档、重点场景数量 |
| 文章封面 | 公众号、网站、短视频封面 | 主题、标题留白、平台比例 |
| 角色立绘 | 固定人物形象 | 角色档案、参考图、固定 Seed、LoRA |
| 场景概念图 | 地点、建筑和世界观 | 场景档案、风格档案 |
| 图片生视频 | 动态海报或短镜头 | 输入图、视频工作流、帧率和时长 |
| 发布套图 | 同一内容适配多个平台 | 原始视觉、平台尺寸和裁切规则 |
| 分镜关键帧 | 影视、小说或脚本可视化 | 章节、镜头数量、人物和场景资料 |
4.6 视觉资料库
为了让人物、场景和画风保持一致，可以建立以下档案：
- 角色；
- 场景；
- 风格；
- 道具；
- 产品；
- 组织标识或品牌视觉。
每个档案可以记录：
- 名称、说明和标签；
- 正向提示词；
- 负向提示词；
- 项目内参考图片；
- 固定 Seed；
- Checkpoint；
- LoRA 名称和权重；
- 专用 API 工作流。
参考图通常复制到：
<项目>/.xiema/ai-media/references/
索引保存项目相对路径。整个项目移动到其他磁盘或电脑时，只要目录结构完整，资料仍可继续解析。
截图占位：角色、场景与风格资料库
展示参考图、正负提示词、Seed、Checkpoint、LoRA、权重和专用工作流。
4.7 分镜与短视频流程
- 打开章节或脚本文档；
- 选择“根据当前文档生成分镜”；
- 设置镜头数量；
- 逐镜头检查标题、正文片段、提示词、负向提示词、人物、场景、镜头语言和时长；
- 先生成关键帧；
- 确认人物和场景一致后，再生成镜头视频；
- 填写或修改旁白；
- 导出 SRT 字幕；
- 使用本机语音或其他 TTS 生成旁白音频；
- 导入背景音乐；
- 使用 FFmpeg 统一画幅、拼接镜头、混合旁白与音乐；
- 输出 MP4 并进入媒体索引和版本历史。
截图占位：分镜、关键帧、旁白和视频合成
建议展示镜头列表、单镜头编辑、关键帧、生成视频、SRT、旁白和最终 MP4。
4.8 媒体版本和正文一致性
每次生成可以记录：
- 正文文件路径；
- 正文选区和正文哈希；
- 提示词和负向提示词；
- 模型、工作流、LoRA 和 Seed；
- 输出文件；
- 版本组和采用状态。
正文修改后，插件可以检查关联媒体是否可能过期。角色参考图、模型、LoRA、风格或 Seed 改变时，也应提醒一致性风险。
项目数据通常位于：
<项目>/.xiema/ai-media/
├─ visual-library.json
├─ media-index.json
├─ references/
└─ storyboards/
<项目>/assets/generated/<年月>/
├─ images/
├─ videos/
├─ covers/
├─ characters/
├─ scenes/
├─ storyboards/
└─ movies/
4.9 隐私与安全
- 插件本身不应直接读取用户的在线 AI 密钥；文本规划复用写吗统一 AI 服务、联网策略和请求日志；
- 使用本地模型规划提示词时，正文可留在本机；
- 使用在线 AI 时，选区或章节是否离开本机取决于用户选择的服务；
- 本机 ComfyUI 请求通常只发往
127.0.0.1； - 参考图、媒体索引和输出文件保存在项目目录；
- 不要把 ComfyUI 8188 端口裸露在公网；
- 需要远程使用时，应通过 VPN、身份认证、HTTPS 反向代理和来源 IP 限制；
- 第三方模型、LoRA、工作流和素材可能有各自许可证，商用前必须确认授权。
4.10 常见故障
| 现象 | 优先检查 |
|---|---|
| 测试连接失败 | ComfyUI 是否启动；地址端口是否正确；防火墙、代理和联网范围是否拦截 |
| 找不到模型 | Checkpoint 或 LoRA 文件名是否与 ComfyUI 实际文件一致 |
| 节点类型不存在 | 自定义节点是否安装；节点版本是否兼容 |
| 图片可以生成，视频失败 | 是否导入正确的 API 工作流；视频模型、帧数和输入图绑定是否完整 |
| 生成后没有插入正文 | 当前标签是否可编辑；文档是否保存；自动插入是否开启 |
| FFmpeg 合成失败 | FFmpeg 路径、输入编码、音频格式、画幅和文件占用 |
| 人物每张图差异很大 | 建立角色档案；固定参考图、Seed、Checkpoint、LoRA 和提示词 |
| 队列长时间没有结果 | 查看 ComfyUI 控制台、显存占用、节点报错和输出节点 |
五、.xmwf 到底是什么
.xmwf 是“XieMa Workflow（写吗工作流应用）”的文件扩展名，由AI 创作应用开发使用。它不是模型文件，也不是 ComfyUI 原生格式；它把 ComfyUI API 工作流、普通用户可修改的参数、依赖说明、输出定义和作者信息包装成一个可安装应用。
| 文件 | 作用 |
|---|---|
manifest.json | 公开的名称、作者、版本、说明、表单字段、依赖、输出、价格和授权信息。 |
payload.json | 公开包中的 ComfyUI API 工作流、节点绑定和锁定值。 |
payload.enc | 保护包中的 AES-256-GCM 加密负载，替代 payload.json。 |
cover.png/jpg/webp | 可选封面。 |
source.xmwf | 安装后保存的原始包副本；它不是作者制作包时必须手工放入的内容。 |
普通用户怎么用：打开“扩展 → AI 创作应用开发”，点击“安装 .xmwf”，选择文件；若为保护包，再输入作者提供的授权密钥。当前源码没有注册 Windows 双击文件关联，因此不要把“双击 .xmwf 自动安装”写进宣传。
公开包与保护包
公开包工作流负载为明文，适合免费分享和开源。保护包负载使用 PBKDF2-SHA256 派生密钥并以 AES-256-GCM 加密；密钥验证成功后保存在写吗加密凭据库。
保护包只能提高普通复制门槛，不能提供绝对 DRM：工作流最终仍需在用户电脑中解密并提交给本机 ComfyUI。高价值商业工作流仍应配合授权协议、作者服务或在线许可系统。
安装时会检查什么
- 扩展名、压缩包大小、文件数量和解压后总大小；
manifest.json格式、格式版本、最低写吗版本和 ComfyUI 引擎声明；- 负载 SHA-256、可选封面 SHA-256、可选 RSA-PSS 发布者签名；
- 重复路径、非法文件名、ZIP 路径越界和单文件大小；
- 同一工作流 ID 的发布者公钥指纹，避免已签名应用被无签名或不同作者版本替换；
- 替换安装失败时回滚旧版本。
当前支持范围
源码静态核对：主要链路已接通。
已核对插件窗口与设置注册、扩展菜单入口、目录右键批处理、手动安装、在线目录下载、SHA-256 与作者签名、公开/加密包解锁、参数表单、图片上传、节点类型预检、ComfyUI 队列提交、WebSocket 进度、结果下载、首件确认、继续未完成批次和
已核对插件窗口与设置注册、扩展菜单入口、目录右键批处理、手动安装、在线目录下载、SHA-256 与作者签名、公开/加密包解锁、参数表单、图片上传、节点类型预检、ComfyUI 队列提交、WebSocket 进度、结果下载、首件确认、继续未完成批次和
.xmwf-result.json 来源记录。尚未宣称完成实机通过：当前检查环境没有 Windows WPF 与 .NET 10 SDK，也没有真实 ComfyUI、模型和显卡，无法在本次检查中完成最终编译和出图。发布前仍应在目标 Windows 电脑上执行构建，并用一个真实公开包、一个保护包和一个目录批处理各跑一遍。
六、AI 创作开发（开发者模式）
AI 创作服务于文章、角色和分镜；AI 创作应用开发则把任意 ComfyUI API 工作流包装成可安装的 .xmwf 应用，例如批量商品图、照片修复、证件照、统一风格封面或图片放大。
普通用户使用步骤
- 启动 ComfyUI CMD 服务，不必打开节点网页；
- 在写吗中安装并启用“AI 创作应用开发”；
- 安装本地
.xmwf，或从在线目录选择可信作者的应用； - 安装前查看作者、版本、价格、购买页、最低宿主版本、依赖、SHA-256 和签名状态；
- 填写作者公开的提示词、图片、数值、选项和目录；未公开节点保持作者原值；
- 点击依赖预检，确认节点、模型和输入文件齐全；
- 批处理时先运行“首件”，确认效果后再继续全部；
- 查看实时节点进度、失败原因和输出来源；任务中断后使用“继续未完成”；
- 输出旁会保存
.xmwf-result.json，记录来源应用和参数。
第三方作者制作应用
- 在 ComfyUI 中把工作流调试成功并导出 API 格式；
- 导入写吗作者工具；
- 选择允许普通用户修改的节点输入；
- 为字段设置中文名称、说明、控件类型、默认值、普通/高级分组和联动条件；
- 配置输出目录、依赖和锁定参数；
- 导出公开包，或使用 AES-256-GCM 导出保护包；
- 使用 RSA-PSS 作者签名，减少篡改和冒名更新；
- 填写授权协议、作者页和购买页后发布。
工作流包安全边界
- 安装器检查 SHA-256、签名、ZIP 路径越界、重复路径、非法文件名和解压大小；
- 首次安装已签名应用后，会记住工作流 ID 对应的发布者公钥指纹；换密钥或从已签名降级为未签名会被拒绝；
- 保护包可以阻止普通解压复制，但工作流最终必须在用户电脑内解密并提交给本机 ComfyUI，因此不是绝对不可提取的 DRM；
- 只安装可信来源工作流。依赖预检通过不代表第三方自定义节点没有安全风险。
配图占位：工作流应用列表、参数联动和实时进度
建议展示签名状态、依赖预检、首件确认、批处理清单、继续未完成和输出追踪。
images/quick-start/22-comfy-workflow-app.png七、发布前检查清单
- ComfyUI 本机可以正常打开并完成基础出图；
- 写吗“测试连接”成功；
- 使用的是 API 格式 JSON，不是普通界面工作流；
- 工作流所需模型、自定义节点与版本均已安装；
.xmwf的作者、来源、SHA-256、签名和授权条款已核对；- 批处理先开启首件确认；
- 没有把 8188 端口裸露到公网；
- 商用模型、LoRA、工作流和素材已确认许可证。