核心用法
cinematic-script-writer 是一款面向AI视频生成工作流的专业脚本创作CLI工具，核心功能覆盖从故事构思到成品输出的完整链路：
1. 故事上下文管理 — 通过 create-context 创建包含时代背景、场景设定的故事宇宙，支持古代印度、赛博朋克等特定 era 的精确锚定，为后续生成提供一致性约束。
2. 智能脚本生成 — generate-ideas 结合上下文生成多组故事概念，create-script 输出完整分镜脚本，内置镜头角度（low-angle/高仰角营造压迫感，bird-eye/鸟瞰体现渺小）、运动方式（dolly/推拉制造沉浸，handheld/手持增强真实感）、灯光方案（three-point/三点布光、chiaroscuro/明暗对比）的专业数据库。
3. 角色一致性系统 — create-character-ref 生成视觉参考表，create-voice 建立声线档案，validate-prompt 自动检测时代错位（如古代场景出现塑料物品），解决AI视频生成中最棘手的角色漂移问题。
4. 多平台适配输出 — 针对Midjourney、Sora、Veo、Runway等工具优化提示词结构：[Shot type] [camera angle] of [subject], [style], [lighting], [grading], [era-details]。
5. 生产级交付 — 自动打包为7文件结构（脚本/提示词/角色参考/声线指南/YouTube元数据），支持Google Drive OAuth2直连存储。
显著优点
- 专业级电影摄影知识库：10种镜头角度×10种运动方式×10种灯光技术×6种调色方案，非专业用户可直接调用成熟视听语言
- 角色一致性工程化：视觉参考+声线档案的双重锁定，配合时代验证，显著降低AI生成中的形象崩坏
- 端到端工作流闭环：从概念→脚本→提示词→存储→YouTube SEO的一站式处理
潜在局限
- CLI交互门槛：纯命令行界面，对非技术型创作者不够友好
- 时代数据库覆盖：依赖内置era库，小众历史时期或架空世界需手动校验
- OAuth依赖：Google Drive功能需网络授权，离线场景受限
适合人群
AI视频创作者（YouTube短片、动画预告）、独立 filmmaker 使用Midjourney/Sora进行视觉预演、需要批量维护角色一致性的系列内容生产者。
常规风险
- 存储安全：Google Drive凭证仅内存存储，进程重启需重新授权
- 生成内容合规：AI脚本可能产出版权敏感元素（如特定影视风格），需人工二次审核
- 时代准确性：anachronism检测依赖规则库，边缘案例存在漏检可能