DirectorFrame AI 使用说明

DirectorFrame AI 是一款面向漫剧、短剧、小说改编和分镜创作的 AI 分镜生产桌面应用。它通过“导演 DSL + Prompt Compiler + Skill 插件 + 无限画布”把剧情拆解成镜头，并批量生成可管理、可归档、可质检的分镜图。

1. 安装与启动

开发模式启动

npm install
npm start

如果 PowerShell 拦截 npm.ps1，使用：

npm.cmd install
npm.cmd start

打包 Windows 安装包

npm.cmd run dist

打包完成后，安装包会生成在：

release/

2. 基础工作流

推荐使用流程：

1. 新建或打开项目。
2. 导入小说、剧本或剧情文本。
3. 导入角色参考图、场景参考图、风格参考图。
4. 在无限画布中调整镜头卡片和素材节点位置。
5. 选择单个镜头生成，或批量生成全部镜头。
6. 查看生成记录、错误日志和质检状态。
7. 导出项目归档。

3. 配置生图 API

左侧“项目设置”中需要配置：

• Provider：选择 GPT Image 或 自定义平台
• API Key：填写你的平台密钥
• API Base URL：OpenAI 或兼容平台地址，例如：https://api.openai.com/v1
• 模型：例如 gpt-image-1.5
• 画幅：支持 16:9、9:16、3:4、1:1、3:2 等
• 超时秒数：单次生成等待时间，默认 180 秒
• 重试：失败后自动重试次数

如果使用自定义平台，请填写完整的 自定义 Endpoint。系统会向该地址发送 Prompt、画幅、模型、质量和镜头数据。

4. 导入剧本

点击左侧 导入小说 / 剧本，选择 .txt 或 .md 文件。

系统会自动将文本拆解为多个镜头，并为每个镜头生成基础导演 DSL 和 Prompt。

每个镜头卡片包含：

• 分镜图
• 镜头标题
• 剧情拍点
• 镜头语言
• Prompt
• 角色绑定
• 场景绑定
• 风格绑定
• 生成记录
• 质检状态

5. 导入角色、场景和风格参考

左侧按钮：

• 角色：导入人物设定图、角色参考图
• 场景：导入场景、地点、空间参考图
• 风格：导入画风、色彩、构图参考图

导入后，图片会复制到项目资产库中，避免原始文件移动后丢失。

在画布中可以拖拽素材节点。如果把素材节点拖到某个镜头卡片附近，系统会自动把素材绑定到该镜头。

6. 画布操作

• 拖拽镜头卡片：调整镜头排布
• 拖拽画布空白处：移动视图
• Ctrl + 鼠标滚轮：缩放画布
• 画布 / 紧凑：切换显示模式
• 拖拽角色、场景、风格节点：调整参考资产位置并绑定镜头

7. 单镜头生成

选择某个镜头卡片后，右侧面板会显示该镜头详情。

点击：

只生成当前镜头

系统只会生成当前选中的镜头，不会重新生成其他镜头。

适合用于：

• 单张重试
• 调整 Prompt 后重新生成
• 检查角色或场景绑定效果
• 修复失败镜头

8. 批量生成

点击左侧：

批量生成分镜图

系统会按镜头顺序生成图片，并显示：

• 当前镜头
• 生成进度
• 已用时间
• 请求状态
• 失败原因
• 重试记录

如果生成时间过长，可以点击：

取消生成

取消后，任务队列会保留未完成镜头，之后可以点击：

恢复任务

继续生成未完成部分。

9. 生成结果归档

每次生成成功后，系统会保存：

• 图片文件
• 元数据 JSON
• Prompt
• Negative Prompt
• 镜头 DSL
• 模型参数
• Provider 信息
• 生成时间

生成文件会保存在项目资产目录中，便于后续整理、备份和交付。

10. 质检功能

系统包含两类质检：

规则质检

默认开启，检查：

• Prompt 是否完整
• 图片是否生成
• DSL 是否完整
• 绑定资产是否可访问
• 生成是否失败
• 图片是否已归档

视觉模型质检

在项目设置中开启：

视觉质检：开启

开启后，系统会调用视觉模型检查图片是否符合镜头 DSL 和 Prompt。

注意：视觉质检需要可用的 API Key 和支持图片理解的模型。

11. 生产自检

点击：

运行生产自检

系统会检查：

• API Key 是否配置
• API 地址是否可用
• Provider 是否是真实平台
• 请求超时是否设置
• 镜头 DSL / Prompt 是否完整
• 资产路径是否可访问
• 任务队列是否支持恢复
• 是否开启视觉质检
• 是否配置图标、签名和自动更新

自检结果分为：

• 不能投入生产
• 可小规模试生产
• 生产就绪

12. 常见问题

生成一直很久没有结果

检查：

• API Base URL 是否正确
• API Key 是否有效
• 模型是否支持图片生成
• 网络是否能访问接口
• 超时秒数是否太短

系统会在超时后显示错误日志，不会无限卡住。

GitHub 推送失败

如果看到 127.0.0.1 代理错误，检查 Git 代理：

git config --global --get http.proxy
git config --global --get https.proxy

不需要代理时清除：

git config --global --unset http.proxy
git config --global --unset https.proxy

图片导入失败

检查：

• 文件是否是 png、jpg、jpeg、webp
• 文件路径是否可访问
• 文件是否被其他程序占用
• 项目目录是否有写入权限

此项目还没完善还在开发调试中

还是个demo