cinematic-script-writer

电影剧本编写工具

运用角色一致性和电影摄影知识，为 AI 视频生成创作专业电影剧本。

安装

# Install via npm
npm install -g cinematic-script-writer

# Or install via OpenClaw CLI
openclaw skills install cinematic-script-writer

CLI 用法

上下文管理

创建和管理包含角色、时代和场景的故事上下文：

# Create a new story context
cinematic-script create-context --name "My Story" --era "Ancient India" --period "Ramayana Era"

# List all saved contexts
cinematic-script list-contexts

# Get a specific context
cinematic-script get-context --id <context-id>

# Delete a context
cinematic-script delete-context --id <context-id>

故事生成

生成故事创意并创作电影剧本：

# Generate story ideas for a context
cinematic-script generate-ideas --context-id <context-id> --count 3

# Create a full cinematic script from an idea
cinematic-script create-script --context-id <context-id> --idea-id <idea-id>

# Generate YouTube metadata for a script
cinematic-script generate-metadata --script-id <script-id>

电影摄影参考

查阅摄影机角度、灯光和镜头类型数据库：

# List all camera angles
cinematic-script list-angles

# List all camera movements
cinematic-script list-movements

# List all shot types
cinematic-script list-shots

# Get camera setup recommendation
cinematic-script suggest-camera --scene-type "dialogue" --mood "dramatic"

# Get lighting suggestions
cinematic-script suggest-lighting --scene-type "interior" --mood "mysterious"

# Get color grading suggestions
cinematic-script suggest-grading --genre "action"

# Search cinematography database
cinematic-script search --query "low angle lighting"

角色一致性

创建角色参考资料并验证提示词：

# Create a character reference sheet
cinematic-script create-character-ref --character-id "char1" --name "Kutil" --visual "Purple rakshasa with golden eyes" --era "Ancient" --style "Pixar 3D"

# Create a voice profile for dialogue consistency
cinematic-script create-voice --character-id "char1" --name "Kutil" --personality "Mischievous, witty" --age "adult" --role "protagonist"

# Validate a prompt for anachronisms
cinematic-script validate-prompt --prompt "Your prompt here" --character-ids "char1,char2" --context-id <context-id>

存储

将项目保存到 Google Drive 或本地存储：

# Connect to Google Drive
cinematic-script connect-drive

# Connect to local storage
cinematic-script connect-local

# Check storage connection status
cinematic-script storage-status

# Save project to storage
cinematic-script save --title "My Story" --context-id <context-id> --script-id <script-id>

存储实现细节：

• Google Drive：使用 Google OAuth2 进行身份验证。凭证会安全地存储在内存中。
• 本地存储：作为备用方案，将文件保存到用户的下载文件夹。
• 库：使用 googleapis 集成 Google Drive。

导出

以多种格式导出剧本：

# Export as Markdown (default)
cinematic-script export --script-id <script-id> --format markdown

# Export as JSON
cinematic-script export --script-id <script-id> --format json

# Export as plain text
cinematic-script export --script-id <script-id> --format text

功能

• 故事上下文管理：创建和管理故事背景、角色和时代
• 故事创意生成：生成多个包含引子和反转的故事构想
• 电影剧本创作：创作包含摄影机角度、灯光和镜头类型的完整剧本
• 角色一致性：提供参考表和声音档案，确保角色一致
• 环境一致性：提供符合时代背景的风格指南并检测时代错置
• YouTube 元数据：生成标题、描述和 SEO 标签
• 存储集成：保存到 Google Drive 或本地存储
• 导出选项：支持 JSON、Markdown 或纯文本格式

适用场景

• 撰写电影剧本或影视剧本
• 为动画或视频创作包含角色的故事
• 为 AI 工具（Midjourney、Sora、Veo、Runway）生成图像或视频提示词
• 获取电影摄影指导（摄影机角度、灯光、调色）
• 在不同场景中保持角色一致
• 将剧本项目保存到 Google Drive

电影摄影参考

摄影机角度

角度	情绪效果	适用场景
平视	亲近、平等、中立	对话、情感时刻
低角度	力量、支配、英雄气概	反派亮相、英雄时刻
高角度	脆弱、弱势、全景概览	失败、展现规模
鸟瞰	渺小、疏离、图案感	宏大场面、孤立场景
虫视	敬畏、宏伟、压倒性的存在感	纪念碑、巨人、神灵
荷兰角	不安、迷失方向、紧张	混乱、梦境、恐怖
俯拍	全知、监视	桌边场景、打斗编排
肩平视角	亲密、随意、纪实感	边走边谈
腰平视角	牛仔风格、轻松中的紧张感	西部片、对峙
膝部高度	儿童视角、扎根感	儿童故事、谦逊

摄影机运动

运动	效果	用途
固定	稳定、观察	沉思、肖像
摇摄	展现空间	水平跟随动作
俯仰	展现高度	垂直跟随动作
推轨	沉浸感、亲密感	朝向或远离主体移动
横移	跟随动作	平行横向移动
升降机运动	宏大规模、戏剧感	扫掠式揭示、转场
手持	紧迫感、真实感	纪录片、动作、混乱场面
斯坦尼康	平滑漂浮感	穿行跟拍、梦境
变焦	突然聚焦、惊讶	戏剧性强调、喜剧效果
移焦	揭示关联	在不同主体之间转移注意力

镜头类型

镜头	取景范围	情感效果
建立镜头	宽阔的场景	交代场景、地理位置和时间
全景／远景	主体及周围环境	展现背景、环境和规模
中景	腰部以上	对话、肢体语言
特写	头部／肩部	情绪、反应、亲密感
大特写	仅细节（眼睛、手部）	强烈情绪、象征意义
过肩镜头	越过一个主体拍摄另一个主体	对话、视角
主观镜头	角色所见	沉浸感、主观性
插入镜头	物体细节	剧情信息、象征意义
双人镜头	两个主体同框	关系、张力

灯光技巧

技巧	氛围	最适用场景
三点布光	专业、均衡	对话、访谈
高调光	快乐、乐观、明亮	喜剧、广告
低调光	戏剧性、神秘	剧情片、恐怖片、黑色电影
黄金时刻	浪漫、怀旧、梦幻	爱情片、情感时刻
蓝色时刻	忧郁、神秘	城市、都市景观
明暗对照法	强烈的明暗对比	艺术电影、时代剧
轮廓光／逆光	分离感、空灵感	剪影、神圣感
实景光	真实、自然	蜡烛、火焰、灯具
丁达尔光束	神圣、启示	灵性时刻、森林
霓虹灯光	都市、未来感	赛博朋克、夜生活

调色风格

风格	视觉效果	类型
青橙色	商业大片电影感	动作片、科幻片
黑色电影风格	高对比度、低饱和度	犯罪片、悬疑片
复古／棕褐色	温暖、怀旧	时代剧、回忆
粉彩色	柔和、梦幻	爱情片、成长题材
漂白绕印	低饱和度、粗粝	战争片、惊悚片
交叉冲印	超现实色彩	音乐视频、梦境

图像提示词格式

为 AI 工具生成图像提示词时：

[Shot type] [camera angle] of [subject doing action], [visual style] style,
[lighting technique], [composition rule], [color grading],
[era-appropriate details], [mood keywords], highly detailed, cinematic

示例：

Low-angle close-up of Kutil the purple rakshasa with mischievous golden eyes,
Pixar 3D style, dramatic underlighting with rim light, rule-of-thirds composition,
warm golden color grading, ancient Lanka palace background with ornate pillars,
playful yet mysterious mood, highly detailed, cinematic, 8k

输出结构

保存项目时，将生成以下文件：

Story Title/
├── 00_INDEX.md           # Navigation
├── 01_SCRIPT_README.md   # Human-readable script
├── 02_IMAGE_PROMPTS.md   # All AI generation prompts
├── 03_CHARACTER_REFS.md  # Character design guides
├── 04_VOICE_GUIDES.md    # Dialogue consistency guides
├── 05_YOUTUBE_META.md    # Title, description, tags
└── 99_CONTEXT_INFO.md    # Story context and background

重要规则

1. 始终保持角色一致性 - 在每条图像提示词中加入角色完整的视觉描述
2. 切勿包含时代错误 - 根据时代背景核验道具、服装和物件
3. 让电影摄影与情绪相匹配 - 用低角度表现力量，用高角度表现脆弱
4. 同时包含图像和视频提示词 - 图像提示词描述静态画面，视频提示词描述动作
5. 输出须达到可制作标准 - 每个脚本都应包含足够详细的信息，供团队制作
6. 尊重基调 - 喜剧需要喜剧节奏；剧情片需要延长对反应的停留时间

许可证

MIT

作者

Praveen Kumar