AI驱动的分镜脚本创作工具 - Slash Command 架构,与 Scriptify 生态集成
npm install ai-storyboardify> 版本: 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)
- 视频剪辑和渲染
- 配音和音效制作
💡 如需完整制作流程: 查看生态系统文档
---
---
``bash`
npm install -g ai-storyboardify
或本地开发:
`bash`
git clone https://github.com/wordflowlab/storyboardify.git
cd storyboardify
npm install
npm run build
---
`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
推荐用法 - 在 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
`bash1. 定义项目规格
/specifyAI引导选择:工作区(manga/short-video/dynamic-manga)、生成模式(express/coach/hybrid)
---
📚 命令列表
$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!
---
MIT License
---
- Scriptify - AI驱动的剧本创作工具
- WordFlowLab - 文字内容创作工具生态
---
版本: v1.0.0
发布日期: 2025-10-31
状态: ✅ 核心功能完成,Slash Command 架构