Storyboardify - AI 驱动的分镜创作工具

> 版本: v0.1.5-dev
> 状态: ⚠️ 早期开发阶段 (Alpha)
> 定位: 专注分镜创作阶段的AI辅助工具

核心价值: 将 Scriptify 剧本转换为专业分镜脚本和完整制作包

⚠️ 开发状态

当前处于早期开发阶段 (v0.1.x),API 和功能可能会发生变化

✅ 已完成 (v0.1.0):
- 核心分镜脚本生成
- 制作包生成 (人物和场景设定表)
- 三种生成模式 (Express/Coach/Hybrid)
- 三工作区支持 (Manga/Short-Video/Dynamic-Manga)

🚧 开发中 (v0.1.5):
- 图片生成功能 (代码完成,待测试)
- 角色一致性追踪
- 批量生成系统

📋 计划中:
- v0.2.0: 图片生成完善 + 导出增强
- v0.3.0: 智能优化 + 题材适配

⚠️ 产品边界

Storyboardify 专注于分镜创作,不涉及拍摄、制作、剪辑等后期环节。

✅ 做什么:
- Scriptify 剧本导入
- 自动生成人物和场景设定表
- 智能分镜生成 (Express/Coach/Hybrid 三种模式)
- 图片生成 (v0.1.5+)
- 多格式导出

❌ 不做什么:
- 剧本创作 (请使用 Scriptify)
- 视频剪辑和渲染
- 配音和音效制作

💡 如需完整制作流程: 查看生态系统文档

---

🎯 核心功能

$3

- 自动生成人物设定表（外观、性格、绘画提示词）
- 自动生成场景设定表（布局、光源、色调、氛围）
- MidJourney/Stable Diffusion 提示词生成

$3

- Express 模式: 全自动AI生成 (快速，1-2分钟)
- Coach 模式: AI引导式学习创作 (互动，10-20分钟，适合新手)
- Hybrid 模式: AI框架+用户精调 (专业，20-30分钟)
- 智能镜头规划：景别/角度/运镜方式/时长/转场

$3

- 多提供商支持: 火山引擎 / 阿里云通义万相 / 智能混合
- 角色一致性: 90%+ 一致性追踪系统
- 批量生成: 智能并发控制 + 成本追踪
- 质量保障: 自动质量检查 + 最佳图片推荐
- 成本优化: 实时成本预警 + 每日限额保护

$3

- 漫画工作区 (4:3)：翻页位置、气泡位置、页数估算
- 短视频工作区 (9:16)：时间轴、字幕、配音参数
- 动态漫工作区 (16:9)：帧数范围、图层结构、3D参数

---

📦 安装

``bash npm install -g ai-storyboardify`

或本地开发:

`bash git clone https://github.com/wordflowlab/storyboardify.git cd storyboardify npm install npm run build`

---

`🚀 快速开始`

`$3`

`bash

`交互式选择 AI 助手、工作区、生成模式`


storyboardify init "我的分镜项目"

cd "我的分镜项目"`

支持13个AI编程助手: - Claude Code, Cursor, Gemini CLI - Windsurf, Roo Code, GitHub Copilot - Qwen Code, OpenCode, Codex CLI - Kilo Code, Auggie CLI, CodeBuddy, Amazon Q Developer

`$3`

推荐用法 - 在 Claude/Cursor 等 AI 助手中使用：

`bash /specify # 定义项目规格（工作区、模式） /import # 导入 Scriptify 剧本 /preproduce # 生成制作包（人物+场景设定表） /generate-express # Express 模式（全自动） /generate-coach # Coach 模式（AI引导） /generate-hybrid # Hybrid 模式（AI框架+用户） /generate-images # 生成分镜图片 (NEW! 🎨) /export # 导出分镜脚本`

命令行用法:

`bash storyboardify specify storyboardify import storyboardify preproduce storyboardify generate-express # 或 generate-coach / generate-hybrid storyboardify export`

`$3`

`bash

`1. 定义项目规格`


/specify
AI引导选择：工作区(manga/short-video/dynamic-manga)、生成模式(express/coach/hybrid)
2. 导入 Scriptify 剧本

/import examples/test-import.json
3. 生成制作包

/preproduce
AI生成人物和场景设定表
4. 生成分镜脚本

/generate-coach    # Coach模式：AI逐步引导
或

/generate-express  # Express模式：全自动生成
或

/generate-hybrid   # Hybrid模式：AI框架+用户填充
5. 导出分镜

/export
AI引导选择导出格式（Markdown/Excel/剪映JSON等）


---
📚 命令列表
$3

-

/specify

 - 定义项目规格
$3

-

/import

 - 导入 Scriptify 剧本
$3

-

/preproduce

 - 生成制作包（人物+场景设定表）
$3

-

/generate-express

 - Express模式（全自动AI生成）
-

/generate-coach

 - Coach模式（AI引导式学习创作）
-

/generate-hybrid

 - Hybrid模式（AI框架+用户精调）
$3

-

/export

 - 导出分镜脚本
---
🏗 架构设计
Storyboardify 基于 Slash Command 三层架构:

`Markdown指令层 (templates/commands/*.md) → 定义"做什么" (检查标准和原则) → 不是对话脚本!

AI执行层 → 决定"怎么做" (灵活理解和执行) → 不是机械执行预设流程!

Bash脚本层 (scripts/bash/*.sh) → 执行"具体操作" (文件操作 + 输出JSON) → 不包含业务逻辑!`

详见: openspec/changes/refactor-to-slash-command/

---

`📖 文档导航`

`$3`


- 本文档 - 快速入门 ⭐ 新手必读
$3

- 架构说明 ⭐ 理解设计必读
- 测试报告 - 测试结果
- OpenSpec 变更 - 详细变更提案
---
🛣 开发路线图
Phase 1: MVP (已完成 ✅)
- 核心命令实现
- 三层架构
- 基础功能
- 13个AI平台集成

Phase 2: 图片生成桥接 (规划中 📋) - v1.1.0 (2-3周) - 核心图片生成能力 - 火山引擎/阿里云 API 集成 - 角色一致性追踪系统 - 智能提示词生成引擎 -/generate-images命令 - 目标: 角色一致性 90%+, 效率提升 80%

Phase 3: 导出增强 (规划中 📋) - v1.2.0 (1-2周) - 多格式导出 - 图片提示词 CSV 导出 - 批量配置导出 (火山引擎/阿里云) - ComfyUI 工作流导出 - Markdown 导出增强

Phase 4: 智能优化 (规划中 📋) - v1.3.0 (2-3周) - 专业优化工具 - 题材适配系统 (沙雕漫/甜宠剧/虐渣类) - 分镜质量评估工具 - 镜头优化建议引擎 - 成本预估计算器 -/validate-storyboard 和 /optimize-shots` 命令

Phase 5: 生态整合 (未来)
- 在线协作功能
- 插件系统
- 第三方工具集成

> 📖 详细规划: 查看 OPTIMIZATION_ROADMAP.md

---

🤝 贡献

欢迎提交 Issue 和 Pull Request!

---

📄 License

MIT License

---

🔗 相关项目

- Scriptify - AI驱动的剧本创作工具
- WordFlowLab - 文字内容创作工具生态

---

版本: v1.0.0
发布日期: 2025-10-31
状态: ✅ 核心功能完成,Slash Command 架构

Storyboardify - AI 驱动的分镜创作工具

> 版本: v0.1.5-dev
> 状态: ⚠️ 早期开发阶段 (Alpha)
> 定位: 专注分镜创作阶段的AI辅助工具

核心价值: 将 Scriptify 剧本转换为专业分镜脚本和完整制作包

⚠️ 开发状态

当前处于早期开发阶段 (v0.1.x),API 和功能可能会发生变化

✅ 已完成 (v0.1.0):
- 核心分镜脚本生成
- 制作包生成 (人物和场景设定表)
- 三种生成模式 (Express/Coach/Hybrid)
- 三工作区支持 (Manga/Short-Video/Dynamic-Manga)

🚧 开发中 (v0.1.5):
- 图片生成功能 (代码完成,待测试)
- 角色一致性追踪
- 批量生成系统

📋 计划中:
- v0.2.0: 图片生成完善 + 导出增强
- v0.3.0: 智能优化 + 题材适配

⚠️ 产品边界

Storyboardify 专注于分镜创作,不涉及拍摄、制作、剪辑等后期环节。

✅ 做什么:
- Scriptify 剧本导入
- 自动生成人物和场景设定表
- 智能分镜生成 (Express/Coach/Hybrid 三种模式)
- 图片生成 (v0.1.5+)
- 多格式导出

❌ 不做什么:
- 剧本创作 (请使用 Scriptify)
- 视频剪辑和渲染
- 配音和音效制作

💡 如需完整制作流程: 查看生态系统文档

---

🎯 核心功能

$3

- 自动生成人物设定表（外观、性格、绘画提示词）
- 自动生成场景设定表（布局、光源、色调、氛围）
- MidJourney/Stable Diffusion 提示词生成

$3

---

📦 安装

``bash npm install -g ai-storyboardify`

或本地开发:

`bash git clone https://github.com/wordflowlab/storyboardify.git cd storyboardify npm install npm run build`

---

`🚀 快速开始`

`$3`

`bash

`交互式选择 AI 助手、工作区、生成模式`


storyboardify init "我的分镜项目"

cd "我的分镜项目"`

支持13个AI编程助手: - Claude Code, Cursor, Gemini CLI - Windsurf, Roo Code, GitHub Copilot - Qwen Code, OpenCode, Codex CLI - Kilo Code, Auggie CLI, CodeBuddy, Amazon Q Developer

`$3`

推荐用法 - 在 Claude/Cursor 等 AI 助手中使用：

命令行用法:

`bash storyboardify specify storyboardify import storyboardify preproduce storyboardify generate-express # 或 generate-coach / generate-hybrid storyboardify export`

`$3`

`bash

`1. 定义项目规格`


/specify
AI引导选择：工作区(manga/short-video/dynamic-manga)、生成模式(express/coach/hybrid)
2. 导入 Scriptify 剧本

/import examples/test-import.json
3. 生成制作包

/preproduce
AI生成人物和场景设定表
4. 生成分镜脚本

/generate-coach    # Coach模式：AI逐步引导
或

/generate-express  # Express模式：全自动生成
或

/generate-hybrid   # Hybrid模式：AI框架+用户填充
5. 导出分镜

/export
AI引导选择导出格式（Markdown/Excel/剪映JSON等）


---
📚 命令列表
$3

-

/specify

 - 定义项目规格
$3

-

/import

 - 导入 Scriptify 剧本
$3

-

/preproduce

 - 生成制作包（人物+场景设定表）
$3

-

/generate-express

 - Express模式（全自动AI生成）
-

/generate-coach

 - Coach模式（AI引导式学习创作）
-

/generate-hybrid

 - Hybrid模式（AI框架+用户精调）
$3

-

/export

 - 导出分镜脚本
---
🏗 架构设计
Storyboardify 基于 Slash Command 三层架构:

`Markdown指令层 (templates/commands/*.md) → 定义"做什么" (检查标准和原则) → 不是对话脚本!

AI执行层 → 决定"怎么做" (灵活理解和执行) → 不是机械执行预设流程!

Bash脚本层 (scripts/bash/*.sh) → 执行"具体操作" (文件操作 + 输出JSON) → 不包含业务逻辑!`

详见: openspec/changes/refactor-to-slash-command/

---

`📖 文档导航`

`$3`


- 本文档 - 快速入门 ⭐ 新手必读
$3

- 架构说明 ⭐ 理解设计必读
- 测试报告 - 测试结果
- OpenSpec 变更 - 详细变更提案
---
🛣 开发路线图
Phase 1: MVP (已完成 ✅)
- 核心命令实现
- 三层架构
- 基础功能
- 13个AI平台集成

Phase 5: 生态整合 (未来)
- 在线协作功能
- 插件系统
- 第三方工具集成

> 📖 详细规划: 查看 OPTIMIZATION_ROADMAP.md

---

🤝 贡献

欢迎提交 Issue 和 Pull Request!

---

📄 License

MIT License

---

🔗 相关项目

- Scriptify - AI驱动的剧本创作工具
- WordFlowLab - 文字内容创作工具生态

---

版本: v1.0.0
发布日期: 2025-10-31
状态: ✅ 核心功能完成,Slash Command 架构