核心用法
Cinematic Script Writer 是一款面向 AI 视频生成时代的专业电影脚本工具，采用 CLI 交互模式，核心工作流分为四个阶段：首先通过 create-context 建立故事上下文（时代背景、角色设定、视觉风格），随后使用 generate-ideas 生成故事创意并筛选，再通过 create-script 输出包含完整摄影指导的专业脚本，最后导出为 Markdown/JSON 格式或直接保存至 Google Drive。工具内置 175+ 种经过分类的摄影技法数据库，涵盖 10 种机位角度、10 种运动方式、9 种景别、10 种灯光技法及 5 种调色风格，用户可通过 suggest-camera、、suggest-lighting` 等命令快速获取场景化建议。
角色一致性系统是该工具的核心竞争力。通过 create-character-ref 生成视觉参考表（包含外貌、时代风格、渲染引擎参数），配合 create-voice 建立语音档案（性格、年龄、角色定位），再结合 validate-prompt 进行时代错位检测，确保跨场景的角色形象与对话风格统一。针对 AI 视频工具的特性，工具提供标准化的提示词模板，将机位、角度、灯光、构图、调色、时代细节等要素结构化输出，可直接复制到 Midjourney、Sora、Veo、Runway 等平台使用。
显著优点
专业级摄影知识库：不同于通用 AI 写作工具，该 Skill 内置经过电影工业验证的摄影技法数据库，每种技术都标注了情绪效果与适用场景，帮助非专业用户快速掌握视觉叙事语言。例如低角度镜头标注为"权力、支配、英雄主义"，适用于反派登场或英雄时刻，这种情绪-技术映射大大降低了学习门槛。
角色一致性保障：AI 视频生成最大的痛点是角色漂移，该工具通过三重机制解决：视觉参考表确保形象稳定、语音档案确保对话风格统一、时代检测确保道具服装无穿越。生成的提示词强制包含角色完整视觉描述，从源头减少 AI 的随机发挥。
生产级输出结构：保存项目时自动生成 7 个标准化文档，涵盖人类可读脚本、AI 提示词合集、角色设计指南、配音指导、YouTube 元数据等，满足从创意到发布的完整工作流需求，特别适合团队协作与版本管理。
灵活的存储策略：支持 Google Drive 云端同步与本地存储双模式，OAuth2 认证流程标准安全，本地模式则完全离线运行，适应不同用户的隐私偏好。
潜在缺点与局限性
CLI 门槛限制：纯命令行交互对非技术用户不够友好，需要记忆大量子命令与参数，相比图形界面工具学习曲线较陡。虽然功能强大，但创意工作者可能更期待可视化的时间轴或故事板界面。
数据库静态更新：摄影技法数据库以本地 TypeScript 文件形式存在，意味着 175+ 条记录需要随版本更新才能扩充，无法实时接入行业最新趋势或用户自定义技法。对于追求前沿视觉风格的创作者，可能存在滞后性。
AI 平台适配局限：虽然提示词模板兼容主流 AI 视频工具，但各平台（如 Sora 与 Veo）的提示词语法差异、分辨率限制、时长约束等细节未在文档中体现，用户仍需手动调整优化。
时代检测覆盖盲区：Anachronism Detection 依赖内置的历史数据库，对于小众文化、架空世界或未来科幻场景的准确性存疑，复杂设定仍需人工复核。
适合的目标群体
- AI 视频创作者：使用 Midjourney 生成分镜、Sora/Veo/Runway 生成动态视频的个人或小型团队
- 独立动画制作人：需要快速产出带完整摄影指导的预演脚本（Previs）
- YouTube 内容创作者：追求电影感叙事的知识区、故事区 UP 主
- 影视专业学生：通过结构化数据库系统学习摄影技法与视觉语言
- 广告创意团队：需要快速迭代多版本脚本并保持一致性的商业项目
使用风险
性能依赖：作为 Node.js CLI 工具，大规模项目（数百个场景）的生成与验证可能存在性能瓶颈，建议分章节处理。Google Drive 同步受网络状况影响，大文件上传可能超时。
依赖项风险：依赖 googleapis 等 npm 包，需关注供应链安全更新。虽然当前审查未发现漏洞，但建议定期执行 npm audit。
内容合规风险：工具本身不限制创作主题，用户生成的脚本与提示词需自行承担平台审核风险（如 YouTube 社区准则、AI 平台的内容政策）。
OAuth 授权管理：Google Drive 集成需要用户主动授权，建议定期检查 Google 账号的第三方应用权限，避免长期未使用的凭证残留。