Cinematic Script Writer

核心功能

Cinematic Script Writer 是一款面向AI视频生成时代的专业剧本创作工具，将传统电影工业的 cinematography（电影摄影）知识体系与生成式AI工作流深度融合。其核心能力围绕四大模块展开：

1. 故事架构与上下文管理

通过create-context建立包含时代背景（era/period）、角色设定的完整故事宇宙，支持从概念到成片的完整 pipeline。内置的generate-ideas可批量产出带钩子（hook）和反转的故事创意。

2. 专业镜头语言数据库

系统内置完整的 cinematography 参考体系，涵盖：

• 10种机位角度（Eye-level/Low-angle/Dutch angle等）及情绪映射
• 10种运镜方式（Dolly/Truck/Crane/Steadicam等）与使用场景
• 9种景别类型（从Establishing到Extreme close-up的叙事功能）
• 10种布光技法（Three-point/Chiaroscuro/God-rays等）
• 6种调色风格（Teal-orange/Noir/Pastel等）

智能推荐系统（suggest-camera/suggest-lighting）可按场景类型（对话/动作）和情绪目标自动匹配技术方案。

3. 角色一致性工程

针对AI生成视频的最大痛点——角色漂移，提供：

• 视觉参考表（Character Ref Sheet）：锁定外观特征、风格（Pixar 3D/写实等）
• 声线档案（Voice Profile）：定义性格标签、年龄感、角色定位
• 时代校验（Anachronism Detection）：自动检测道具、服饰是否违背设定时代

4. 生产级输出与协作

• 多格式导出：Markdown（人类可读）、JSON（API对接）、Plain text
• AI工具适配：专为Midjourney、Sora、Veo、Runway优化的提示词格式
• YouTube元数据：自动生成标题、描述、SEO标签
• 云端存储：Google Drive OAuth2集成，项目文件结构化归档（含脚本、提示词、角色指南、声线指南等7类文档）

显著优势

1. 工业标准知识库：将电影学院级别的 cinematography 系统封装为可查询API，降低专业门槛
2. AI原生工作流：输出直接对接主流视频生成工具，非传统剧本软件的文字-centric设计
3. 一致性基础设施：角色/环境/时代的三重校验机制，解决生成式AI的连贯性难题
4. 全链路覆盖：从创意→脚本→视觉提示→发布元数据→存储的端到端方案

潜在局限

• 依赖外部AI工具：本身不生成视频/图像，需配合Midjourney/Sora等使用
• 时代数据库覆盖：Anachronism检测依赖内置知识库，冷门历史细节可能漏检
• Google Drive权限：企业环境可能受OAuth策略限制
• 无协作编辑：暂不支持多人实时编辑，依赖版本化导出

适合人群

• AI视频创作者（YouTube/B站/ TikTok长视频）
• 独立动画制作人
• 广告/营销团队的短视频策划
• 影视专业学生（学习cinematography的实操工具）
• 游戏过场动画设计师

常规风险

1. 版权模糊性：AI生成内容的版权归属因平台而异，商用需确认Sora/Veo等条款
2. 时代准确性误依赖：自动校验为辅助工具，关键历史项目需人工复核
3. OAuth令牌安全：Google Drive凭证仅存内存，但生产环境需注意日志泄露风险
4. 风格同质化：过度依赖内置调色/布光模板可能导致视觉趋同
5. Node依赖：需维护npm环境，版本冲突可能影响CLI稳定性

核心用法

Cinematic Script Writer 是一款面向 AI 视频创作的专业电影脚本生成工具，主要功能涵盖四大模块：

1. 故事情境管理：创建并管理包含时代背景、角色设定的完整故事上下文，支持 Ancient India、Ramayana Era 等特定年代设定
2. 电影脚本生成：自动生成包含运镜角度、灯光设计、色彩分级的完整分镜脚本，可直接用于 Midjourney、Sora、Veo、Runway 等 AI 视频工具
3. 角色一致性系统：提供角色视觉参考表（character reference sheets）和声音档案（voice profiles），支持时代错位检测（anachronism detection）
4. 云存储集成：通过 OAuth2 认证将项目保存至 Google Drive，或本地存储作为备用方案

CLI 工具链设计完善，从情境创建（create-context）、故事创意生成（generate-ideas）、脚本撰写（create-script）到 YouTube 元数据生成（generate-metadata）形成完整工作流。摄影指导数据库包含 10 种机位角度、10 种运镜方式、9 种景别、10 种灯光技术及 5 种调色风格，支持场景类型与情绪关键词的智能推荐。

显著优点

• 专业级摄影指导：内置电影摄影知识体系，将情感诉求（权力/脆弱/神秘）转化为具体技术参数（低角度/高角度/低调照明）
• AI 工作流优化：生成的 Image Prompt 结构规范 [景别] [机位] of [主体], [风格], [灯光], [构图], [调色]...，直接复制到主流 AI 工具即可使用
• 跨场景一致性：角色视觉描述自动注入每帧提示词，配合声音档案确保多场景角色统一
• 生产就绪输出：导出结构包含脚本、提示词汇总、角色参考、声音指南、YouTube SEO 元数据，满足团队协作需求

潜在缺点与局限性

• 来源可信度限制：个人开发者维护（T3 级别），长期维护稳定性与漏洞响应速度存疑
• 网络依赖性强：Google Drive 集成为核心功能之一，需稳定网络及 OAuth 授权流程
• 平台锁定风险：深度依赖 Google 生态，未提及其他云存储提供商支持
• 时代准确性依赖：Anachronism detection 基于内置数据库，冷门历史时期的准确性需人工复核
• 中文本地化不足：界面、文档及输出内容均为英文，中文创作者需二次处理

适合人群

• AI 视频创作者（Midjourney/Sora/Veo/Runway 用户）
• YouTube 内容创作者需要批量生成故事类视频
• 独立动画制作人寻求快速原型制作工具
• 影视专业学生练习摄影技术与脚本写作
• 需维护多角色一致性的大型叙事项目团队

常规风险

1. OAuth 凭证安全：环境变量读取 GOOGLE_CLIENT_ID 和 GOOGLE_CLIENT_SECRET，用户需确保凭证存储安全、权限范围最小化（当前使用 drive.file 范围，仅能访问应用创建的文件）
2. 隐私数据外泄：脚本内容上传至 Google Drive，敏感题材创作者需评估云存储合规性
3. 依赖项演进风险：当前仅依赖 uuid@9.0.0，未来版本若增加依赖需重新审计
4. 输出版权归属：AI 生成内容的版权法律地位因司法管辖区而异，商业使用需法律评估