Flatten skill category directory structure

This commit is contained in:
2026-05-20 17:04:50 +08:00
parent 0dd552a6f7
commit 63f2baa4bd
354 changed files with 0 additions and 0 deletions
@@ -0,0 +1,49 @@
# Art Style Format Example
Below is the standard format for `art_style.md`.
```markdown
Art Style: Cinematic Realism
Style Description:
Warm film tones, primarily natural lighting, 35mm film grain texture.
Referenced from the visual language of Into the Wild and Nomadland.
Widescreen ratio, anamorphic lens oval bokeh and soft edges.
Keywords: cinematic, film grain, natural lighting, warm amber tones, 35mm film, anamorphic
Palette: warm yellow, amber, deep brown, golden hour gold
Lighting: natural light, golden hour, backlit silhouette, Tyndall effect
Recommended Model: Midjourney V7 (best for cinematic texture) / Kling (character realism)
Reference:
- style_cache/cinematic/01_highway.png
- style_cache/cinematic/02_bar.png
- style_cache/cinematic/03_canyon.png
- style_cache/cinematic/04_starry.png
Style JSON:
{
"visual_style_analysis": {
"color_palette": ["#D4A574", "#8B6914", "#2C1810", "#E8C98E", "#4A3728"],
"color_mood": "warm amber and golden tones with deep brown shadows",
"lighting_and_shadows": "natural golden hour lighting, strong rim light, Tyndall effect, soft diffused shadows",
"texture": "35mm film grain, slight lens aberration, organic noise",
"composition_style": "wide anamorphic framing, rule of thirds, deep depth of field for landscapes",
"line_style": "soft organic edges, no hard outlines, photographic realism",
"art_style_keywords": ["cinematic", "film grain", "golden hour", "anamorphic", "warm amber", "natural lighting", "35mm film", "photorealistic"]
}
}
```
## Format Notes
- First line format: `Art Style: ` + style name
- `Style Description:` 2-4 sentences describing the visual language, may reference films/works
- `Keywords:` comma-separated English keywords, used for subsequent image generation prompts
- `Palette:` list main color tendencies
- `Lighting:` list lighting and shadow characteristics
- `Recommended Model:` recommend the most suitable model based on style, with brief rationale
- `Reference:` list selected reference image paths (relative to project directory), one per line, starting with `- `. Built-in presets are auto-cached to `style_cache/{style}/{filename}.png` by the script; custom styles may point to local files under `style_references/`
- `Style JSON:` structured style data returned by `read_media` analysis of reference images (JSON format), injected into prompts for character and prop image generation
- Content indented 2 spaces for visual alignment
@@ -0,0 +1,49 @@
# 美术风格格式示例
以下是 `art_style.md` 的标准格式。
```markdown
美术风格:电影质感写实
风格描述:
温暖的胶片色调,自然光为主,35mm 胶片颗粒感。
参考电影《Into the Wild》《Nomadland》的视觉语言。
宽银幕比例,anamorphic 镜头的椭圆光斑和柔和边缘。
关键词:cinematic, film grain, natural lighting, warm amber tones, 35mm film, anamorphic
色调:暖黄、琥珀色、深棕、golden hour 金色
光影:自然光、golden hour、逆光剪影、丁达尔效应
推荐生图模型:Midjourney V7(电影质感最佳)/ Kling(人物写实)
参考图:
- style_cache/cinematic/01_highway.png
- style_cache/cinematic/02_bar.png
- style_cache/cinematic/03_canyon.png
- style_cache/cinematic/04_starry.png
风格JSON:
{
"visual_style_analysis": {
"color_palette": ["#D4A574", "#8B6914", "#2C1810", "#E8C98E", "#4A3728"],
"color_mood": "warm amber and golden tones with deep brown shadows",
"lighting_and_shadows": "natural golden hour lighting, strong rim light, Tyndall effect, soft diffused shadows",
"texture": "35mm film grain, slight lens aberration, organic noise",
"composition_style": "wide anamorphic framing, rule of thirds, deep depth of field for landscapes",
"line_style": "soft organic edges, no hard outlines, photographic realism",
"art_style_keywords": ["cinematic", "film grain", "golden hour", "anamorphic", "warm amber", "natural lighting", "35mm film", "photorealistic"]
}
}
```
## 格式要点
- 首行格式:`美术风格:` + 风格名称
- `风格描述:` 用 2~4 句话描述视觉语言,可引用参考电影/作品
- `关键词:` 英文逗号分隔,用于后续生图 prompt
- `色调:` 列出主要色彩倾向
- `光影:` 列出光线和阴影特征
- `推荐生图模型:` 根据风格特点推荐最适合的模型,附简短理由
- `参考图:` 列出选定的参考图路径(相对项目目录),每行一个,以 `- ` 开头。内置预设由脚本自动缓存到 `style_cache/{style}/{filename}.png`,自定义风格可指向 `style_references/` 下的本地文件
- `风格JSON:` `read_media` 分析参考图返回的结构化风格数据(JSON 格式),用于人设图和物件图生成时注入提示词
- 内容缩进 2 空格,保持视觉对齐
@@ -0,0 +1,74 @@
# Background Design Format Example
Below is the standard format for a single background's `{bg_name}/design.md`. Each background has its own directory and file.
```markdown
# Desert Highway
## Scene Description
- Environment type: Outdoor / Open terrain
- Terrain/Space: Straight two-lane highway stretching to the distant horizon, flat sandy desert on both sides
- Palette/Atmosphere: Warm yellow desert base, golden hour sunlight, purple-red horizon
- Key elements: Road surface cracks and heat haze, distant red rock mesa silhouettes, dried grass and fallen road signs on the shoulder
- Weather/Time: Clear and cloudless, around dusk
## Scene List
Scene 1 (Dawn Departure), Scene 2 (Highway Solitude), Scene 7 (Looking Back at the End)
## Image Settings
Prompt:
A long straight desert highway stretching to the horizon, cracked asphalt
with heat haze, flat sandy terrain on both sides, distant red rock mesas,
dried grass and a tilted road sign on the shoulder. Golden hour warm light,
purple-red sky at the horizon. Cinematic, 35mm film, warm amber tones,
wide establishing shot, no people.
single scene, no split screen, no multiple panels, no collage.
Model: nano_banana_2
Reference: style_cache/cinematic/01_highway.png
## Candidates
- candidate_01.jpg — nano_banana_2, ultra-wide horizon stretch
- candidate_02.jpg — nano_banana_2, low angle road close-up
- candidate_03.jpg — nano_banana_2, dusk backlit panorama
## Selected
selected.jpg (Candidate 01)
```
## Format Notes
- H1 `#` for background name
- H2 `##` for each section, must include these 5 sections:
- `## Scene Description` — itemized list: environment type, terrain/space, palette/atmosphere, key elements, weather/time
- `## Scene List` — which scenes this background appears in (extracted from script.md)
- `## Image Settings` — contains three sub-fields:
- `Prompt:` — English, combining scene description with art style keywords, must include `no people`
- `Model:` — image generation model name
- `Reference:` — art style reference image path (relative to theme directory)
- `## Candidates` — all generated candidate image paths (relative to background directory), with model and composition notes
- `## Selected` — final selected image path (chosen by user in preview page)
- Images stored in the background's directory (candidate_*.jpg, selected.jpg)
- Before user selection, `## Selected` section is left empty
- **Aspect ratio: always 16:9 widescreen** (`aspect_ratio: "16:9"`) to showcase full scene
## File Organization
```
./.mv/{song_name}/{theme}/
backgrounds/
{bg_name_1}/
design.md # Background design document
candidate_01.jpg # Candidate images
candidate_02.jpg
selected.jpg # Final selected image
{bg_name_2}/
design.md
candidate_01.jpg
selected.jpg
```
@@ -0,0 +1,74 @@
# 背景图设计格式示例
以下是单个背景的 `{bg_name}/design.md` 标准格式。每个背景独立一个目录和文件。
```markdown
# 荒漠公路 Desert Highway
## 场景描述
- 环境类型:室外 / 开阔地形
- 地形/空间:笔直的双车道公路,延伸至远方地平线,两侧是平坦的黄沙戈壁
- 色调/氛围:暖黄色沙漠基调,golden hour 金色阳光,天际线泛紫红
- 关键元素:路面裂纹和热浪扭曲、远处红色岩山轮廓、路边枯草丛和倒伏的路标
- 天气/时段:晴朗无云、黄昏前后
## 出场幕列表
第一幕(黎明启程)、第二幕(公路独行)、第七幕(终点回望)
## 生图设定
提示词:
A long straight desert highway stretching to the horizon, cracked asphalt
with heat haze, flat sandy terrain on both sides, distant red rock mesas,
dried grass and a tilted road sign on the shoulder. Golden hour warm light,
purple-red sky at the horizon. Cinematic, 35mm film, warm amber tones,
wide establishing shot, no people.
single scene, no split screen, no multiple panels, no collage.
模型:nano_banana_2
参考图:style_cache/cinematic/01_highway.png
## 候选图
- candidate_01.jpg — nano_banana_2, 超广角地平线延伸
- candidate_02.jpg — nano_banana_2, 低角度路面特写
- candidate_03.jpg — nano_banana_2, 黄昏逆光全景
## 选定图
selected.jpg(候选图 01)
```
## 格式要点
- 一级标题 `#` 用于背景名(中文名 + 英文名)
- 二级标题 `##` 用于各字段分区,必须包含以下 5 个分区:
- `## 场景描述` — 用列表逐项描述:环境类型、地形/空间、色调/氛围、关键元素、天气/时段
- `## 出场幕列表` — 该背景在哪些幕中出现(从 script.md 提取)
- `## 生图设定` — 包含三个子字段:
- `提示词:` — 英文,融合场景描述和美术风格关键词,必须包含 `no people`
- `模型:` — 使用的生图模型名称
- `参考图:` — 美术风格参考图路径(相对 theme 目录)
- `## 候选图` — 所有生成的候选图路径(相对背景目录),每行附模型和构图说明
- `## 选定图` — 最终选定的图片路径(由用户在预览页面中挑选)
- 图片存放在背景同级目录下(candidate_*.jpg, selected.jpg)
- 生成候选图后、用户选定前,`## 选定图` 区域留空
- **宽高比统一使用 16:9 宽屏**(`aspect_ratio: "16:9"`),展示场景全貌
## 文件组织
```
./.mv/{song_name}/{theme}/
├── backgrounds/
│ ├── {bg_name_1}/
│ │ ├── design.md # 背景设计说明
│ │ ├── candidate_01.jpg # 候选图
│ │ ├── candidate_02.jpg
│ │ └── selected.jpg # 最终选定图
│ ├── {bg_name_2}/
│ │ ├── design.md
│ │ ├── candidate_01.jpg
│ │ └── selected.jpg
```
@@ -0,0 +1,79 @@
# Character Design Format Example
Below is the standard format for a single character's `{character_name}/design.md`. Each character has its own directory and file.
```markdown
# The Traveller
## Appearance
- Age/Gender: Male, early 30s
- Build: Medium-lean, broad shoulders
- Hair: Dark brown, slightly curly, somewhat long
- Face: Short stubble, defined features
- Clothing: Red-grey plaid flannel shirt, worn brown cowboy boots, naturally faded jeans with knee wear
- Accessories: Old leather-strap watch on left wrist
## Personality
Calm and free-spirited, with world-weariness in his eyes but no defeat.
Unhurried movements, as if long accustomed to the open road and solitude.
## Signature Items
- Martin D-28 natural wood guitar (with wear marks and stickers)
- Beat-up dark blue Ford F-150 pickup truck
## Image Settings
Prompt:
A rugged man in his 30s with short stubble and slightly curly brown hair,
wearing a red-grey plaid flannel shirt and worn cowboy boots, carrying a
Martin acoustic guitar. Cinematic, 35mm film, warm amber tones, natural lighting.
single character, single view, no split screen, no multiple panels, no collage, no reference sheet.
Model: Midjourney V7 --ar 2:3
Reference: style_cache/cinematic/01_highway.png
## Candidates
- candidate_01.jpg — Midjourney V7, full body standing pose
- candidate_02.jpg — Kling, upper body close-up
- candidate_03.jpg — Midjourney V7, playing guitar side view
## Selected
selected.jpg (Candidate 01)
```
## Format Notes
- H1 `#` for character name
- H2 `##` for each section, must include these 6 sections:
- `## Appearance` — itemized list: age/gender, build, hair, face, clothing, accessories
- `## Personality` — expression, posture, overall temperament description
- `## Signature Items` — character-specific recognizable objects, list format
- `## Image Settings` — contains three sub-fields:
- `Prompt:` — English, combining character description with art style keywords
- `Model:` — image generation model name
- `Reference:` — art style reference image path (relative to theme directory)
- `## Candidates` — all generated candidate image paths (relative to character directory), with model and composition notes
- `## Selected` — final selected image path (chosen by user in preview page)
- Images stored in the character's directory (candidate_*.jpg, selected.jpg)
- Before user selection, `## Selected` section is left empty
## File Organization
```
./.mv/{song_name}/{theme}/
characters/
{character_name_1}/
design.md # Character design document
candidate_01.jpg # Candidate images
candidate_02.jpg
selected.jpg # Final selected image
{character_name_2}/
design.md
candidate_01.jpg
selected.jpg
```
@@ -0,0 +1,78 @@
# 角色设计格式示例
以下是单个角色的 `{character_name}/design.md` 标准格式。每个角色独立一个目录和文件。
```markdown
# 旅人 The Traveller
## 外貌特征
- 年龄/性别:30多岁男性
- 体型:中等偏瘦,肩膀宽厚
- 发型:深棕色头发微卷,略长
- 面部:蓄着短胡茬,轮廓分明
- 服装:红灰格纹法兰绒衬衫、磨旧的棕色牛仔靴、膝盖自然磨损的牛仔裤
- 配饰:左手腕旧皮表带手表
## 性格气质
沉稳而自由,眼神中有沧桑但不颓废。
动作不急不缓,像是已经习惯了漫长的公路和独处。
## 标志物件
- Martin D-28 原木色吉他(有使用痕迹和贴纸)
- 破旧的深蓝色 Ford F-150 皮卡
## 生图设定
提示词:
A rugged man in his 30s with short stubble and slightly curly brown hair,
wearing a red-grey plaid flannel shirt and worn cowboy boots, carrying a
Martin acoustic guitar. Cinematic, 35mm film, warm amber tones, natural lighting.
single character, single view, no split screen, no multiple panels, no collage, no reference sheet.
模型:Midjourney V7 --ar 2:3
参考图:style_cache/cinematic/01_highway.png
## 候选图
- candidate_01.jpg — Midjourney V7, 全身站姿
- candidate_02.jpg — Kling, 半身特写
- candidate_03.jpg — Midjourney V7, 弹吉他侧面
## 选定图
selected.jpg(候选图 01)
```
## 格式要点
- 一级标题 `#` 用于角色名(中文名 + 英文名)
- 二级标题 `##` 用于各字段分区,必须包含以下 6 个分区:
- `## 外貌特征` — 用列表逐项描述:年龄/性别、体型、发型、面部、服装、配饰
- `## 性格气质` — 表情、姿态、整体气质描述
- `## 标志物件` — 角色专属的识别性物件,列表形式
- `## 生图设定` — 包含三个子字段:
- `提示词:` — 英文,融合角色描述和美术风格关键词
- `模型:` — 使用的生图模型名称
- `参考图:` — 美术风格参考图路径(相对 theme 目录)
- `## 候选图` — 所有生成的候选图路径(相对角色目录),每行附模型和构图说明
- `## 选定图` — 最终选定的图片路径(由用户在预览页面中挑选)
- 图片存放在角色同级目录下(candidate_*.jpg, selected.jpg)
- 生成候选图后、用户选定前,`## 选定图` 区域留空
## 文件组织
```
./.mv/{song_name}/{theme}/
├── {character_name_1}/
│ ├── design.md # 角色设计说明
│ ├── candidate_01.jpg # 候选图
│ ├── candidate_02.jpg
│ └── selected.jpg # 最终选定图
├── {character_name_2}/
│ ├── design.md
│ ├── candidate_01.jpg
│ └── selected.jpg
```
@@ -0,0 +1,147 @@
# Lyrics Breakdown Example
Song: Example Song (3:52)
Audio: audios/example.wav
```
[prelude]
0:00 - 0:25
0:25 - 0:30
You fill the cup where glances meet
Moonlight, a pot of brew
0:30 - 0:35
Tears scald as I look up
In which scene
0:35 - 0:40
I wield my sword in gentle dance
You trim the western window's candle
0:40 - 0:45
And all the world's turmoil
Countless worldly affairs
0:45 - 0:50
Far from courts into the wild
Tenderness and chivalry
0:50 - 0:55
Yet I fear fate grows thin
A few steps in the mortal dust
0:55 - 1:02
Beyond dreams I walk the mortal road
Nothing beyond the heart
1:02 - 1:07
In dreams I long for your brow
1:07 - 1:13
It is this mortal world
That one glance
That froze time
1:13 - 1:18
That let my heart
Be haunted by longing
1:18 - 1:23
Like blossoms surging toward the sky
Like sunset woven into verse
1:23 - 1:29
Partings and meetings dissolve like smoke in an instant
1:29 - 1:35
It is this mortal world
That one glance
Flowing through time
1:35 - 1:40
That gave rise in lifetime after lifetime
To an undying thread of longing
1:40 - 1:46
See the butterfly circling my finger
1:46 - 1:52
Could it be the vow once left unspoken
[interlude]
1:52 - 2:00
2:00 - 2:05
You fill the cup where glances meet
Moonlight, a pot of brew
2:05 - 2:10
Tears scald as I look up
In which scene
2:10 - 2:15
I wield my sword in gentle dance
You trim the western window's candle
2:15 - 2:20
And all the world's turmoil
Countless worldly affairs
2:20 - 2:25
Far from courts into the wild
Tenderness and chivalry
2:25 - 2:30
Yet I fear fate grows thin
A few steps in the mortal dust
2:30 - 2:35
Beyond dreams I walk the mortal road
Nothing beyond the heart
2:35 - 2:40
In dreams I long for your brow
2:40 - 2:46
It is this mortal world
That one glance
That froze time
2:46 - 2:51
That let my heart
Be haunted by longing
2:51 - 2:56
Like blossoms surging toward the sky
Like sunset woven into verse
2:56 - 3:02
Partings and meetings dissolve like smoke in an instant
3:02 - 3:08
It is this mortal world
That one glance
Flowing through time
3:08 - 3:13
That gave rise in lifetime after lifetime
To an undying thread of longing
3:13 - 3:18
See the butterfly circling my finger
3:18 - 3:24
Could it be the vow once left unspoken
[outro]
3:24 - 3:52
```
## Format Notes
- Header contains song name and **audio file path** (relative to project root)
- Instrumental segments marked with brackets: `[prelude]`, `[interlude]`, `[outro]`
- Each lyric line on its own line
- Instrumental segments only have timecodes, no lyrics
- Timecode format: `start - end` (min:sec)
@@ -0,0 +1,147 @@
# 歌词拆解示例
歌曲:示例歌曲(3:52)
音频:audios/example.wav
```
[prelude]
0:00 - 0:25
0:25 - 0:30
你斟满回首处
月光一壶
0:30 - 0:35
泪滚烫我举目
在哪一幕
0:35 - 0:40
有我挥剑轻轻舞
你剪西窗烛
0:40 - 0:45
还有天下纷扰
无数的世俗
0:45 - 0:50
远庙堂入江湖
柔情侠骨
0:50 - 0:55
却只怕缘分疏
红尘几步
0:55 - 1:02
梦外行过人间路
心外无一物
1:02 - 1:07
梦里思恋你的眉目
1:07 - 1:13
最是这人间
那一眼
凝固了时间
1:13 - 1:18
才让我的心间
萦绕着思念
1:18 - 1:23
如繁花涌向天边
如彩霞铺成诗篇
1:23 - 1:29
离合聚散瞬息之间散如烟
1:29 - 1:35
最是这人间
那一眼
流动在时间
1:35 - 1:40
才有了生生里
不灭的牵念
1:40 - 1:46
看绕指的蝴蝶
1:46 - 1:52
可是从前欲说还休的誓言
[interlude]
1:52 - 2:00
2:00 - 2:05
你斟满回首处
月光一壶
2:05 - 2:10
泪滚烫我举目
在哪一幕
2:10 - 2:15
有我挥剑轻轻舞
你剪西窗烛
2:15 - 2:20
还有天下纷扰
无数的世俗
2:20 - 2:25
远庙堂入江湖
柔情侠骨
2:25 - 2:30
却只怕缘分疏
红尘几步
2:30 - 2:35
梦外行过人间路
心外无一物
2:35 - 2:40
梦里思恋你的眉目
2:40 - 2:46
最是这人间
那一眼
凝固了时间
2:46 - 2:51
才让我的心间
萦绕着思念
2:51 - 2:56
如繁花涌向天边
如彩霞铺成诗篇
2:56 - 3:02
离合聚散瞬息之间散如烟
3:02 - 3:08
最是这人间
那一眼
流动在时间
3:08 - 3:13
才有了生生里
不灭的牵念
3:13 - 3:18
看绕指的蝴蝶
3:18 - 3:24
可是从前欲说还休的誓言
[outro]
3:24 - 3:52
```
## 格式要点
- 头部包含歌曲名称和 **音频文件路径**(相对项目根目录)
- 纯音乐段用方括号标记:`[prelude]`、`[interlude]`、`[outro]`
- 每句歌词单独一行
- 纯音乐段只标注时间码,无歌词
- 时间码格式:`起始时间 - 结束时间`(分:秒)
@@ -0,0 +1,75 @@
# Props Design Format Example
Below is the standard format for a single prop's `{prop_name}/design.md`. Each prop has its own directory and file.
```markdown
# Old Pickup Truck
## Appearance
- Type: Vehicle
- Form: 1970s Ford F-150 pickup, boxy and rugged body lines, open truck bed
- Color/Material: Dark blue paint extensively peeled revealing primer and rust, metal body with visible dents
- Size/Scale: Standard full-size pickup, truck bed can seat a person or hold a guitar case
- Details: Spider-web crack on lower-left windshield, faded highway stickers on bumper, old blanket and ropes scattered in truck bed, left taillight wrapped with tape
## Narrative Role
The old pickup is the physical vessel of the traveller's drifting life, carrying all his luggage and memories.
The rust and scars on the body mirror the traveller's own experiences — worn but still running,
suggesting a "not perfect but never giving up" attitude toward life. It appears repeatedly in highway shots,
serving as both transportation and mobile home, one of the film's most central visual symbols.
## Image Settings
Prompt:
A beat-up 1970s dark blue Ford F-150 pickup truck parked on the shoulder
of a desert highway at golden hour. Peeling paint revealing rust and primer,
cracked windshield, faded bumper stickers, old blanket in the truck bed.
Cinematic, 35mm film, warm amber tones, wide shot.
single object, no split screen, no multiple panels, no collage.
Model: Midjourney V7 --ar 3:2
Reference: style_cache/cinematic/02_bar.png
## Candidates
- candidate_01.jpg — Midjourney V7, highway side panorama
- candidate_02.jpg — Gemini, front 45-degree close-up
- candidate_03.jpg — Midjourney V7, dusk backlit silhouette
## Selected
selected.jpg (Candidate 01)
```
## Format Notes
- H1 `#` for prop name
- H2 `##` for each section, must include these 5 sections:
- `## Appearance` — itemized list: type, form, color/material, size/scale, details
- `## Narrative Role` — a paragraph describing the prop's function and symbolic meaning in the story
- `## Image Settings` — contains three sub-fields:
- `Prompt:` — English, combining prop description with art style keywords
- `Model:` — image generation model name
- `Reference:` — art style reference image path (relative to theme directory)
- `## Candidates` — all generated candidate image paths (relative to prop directory), with model and composition notes
- `## Selected` — final selected image path (chosen by user in preview page)
- Images stored in the prop's directory (candidate_*.jpg, selected.jpg)
- Before user selection, `## Selected` section is left empty
## File Organization
```
./.mv/{song_name}/{theme}/
props/
{prop_name_1}/
design.md # Prop design document
candidate_01.jpg # Candidate images
candidate_02.jpg
selected.jpg # Final selected image
{prop_name_2}/
design.md
candidate_01.jpg
selected.jpg
```
@@ -0,0 +1,75 @@
# 物件设计格式示例
以下是单个物件的 `{prop_name}/design.md` 标准格式。每个物件独立一个目录和文件。
```markdown
# 旧皮卡 Old Pickup Truck
## 外观描述
- 类型:载具
- 形态:1970s Ford F-150 皮卡,车身线条方正硬朗,车斗敞开
- 颜色/材质:深蓝色车漆大面积剥落露出底漆和铁锈,金属车身带明显凹痕
- 尺寸/比例:标准全尺寸皮卡,车斗可坐人或放吉他箱
- 细节特征:挡风玻璃左下角蛛网状裂纹、保险杠贴着褪色公路贴纸、车斗里散落旧毛毯和绳索、左尾灯用胶带缠着
## 叙事作用
旧皮卡是旅人漂泊生活的物质载体,承载着他所有的行李和记忆。
车身的锈迹与伤痕映射着旅人自身的经历——破旧但仍在行驶,
暗示一种"不完美但不放弃"的生活态度。它在公路镜头中反复出现,
既是交通工具也是移动的家,是全片最核心的视觉符号之一。
## 生图设定
提示词:
A beat-up 1970s dark blue Ford F-150 pickup truck parked on the shoulder
of a desert highway at golden hour. Peeling paint revealing rust and primer,
cracked windshield, faded bumper stickers, old blanket in the truck bed.
Cinematic, 35mm film, warm amber tones, wide shot.
single object, no split screen, no multiple panels, no collage.
模型:Midjourney V7 --ar 3:2
参考图:style_cache/cinematic/02_bar.png
## 候选图
- candidate_01.jpg — Midjourney V7, 公路侧方全景
- candidate_02.jpg — Gemini, 车头45度特写
- candidate_03.jpg — Midjourney V7, 黄昏逆光剪影
## 选定图
selected.jpg(候选图 01)
```
## 格式要点
- 一级标题 `#` 用于物件名(中文名 + 英文名)
- 二级标题 `##` 用于各字段分区,必须包含以下 5 个分区:
- `## 外观描述` — 用列表逐项描述:类型、形态、颜色/材质、尺寸/比例、细节特征
- `## 叙事作用` — 一段话描述物件在故事中的功能和象征意义
- `## 生图设定` — 包含三个子字段:
- `提示词:` — 英文,融合物件描述和美术风格关键词
- `模型:` — 使用的生图模型名称
- `参考图:` — 美术风格参考图路径(相对 theme 目录)
- `## 候选图` — 所有生成的候选图路径(相对物件目录),每行附模型和构图说明
- `## 选定图` — 最终选定的图片路径(由用户在预览页面中挑选)
- 图片存放在物件同级目录下(candidate_*.jpg, selected.jpg)
- 生成候选图后、用户选定前,`## 选定图` 区域留空
## 文件组织
```
./.mv/{song_name}/{theme}/
├── props/
│ ├── {prop_name_1}/
│ │ ├── design.md # 物件设计说明
│ │ ├── candidate_01.jpg # 候选图
│ │ ├── candidate_02.jpg
│ │ └── selected.jpg # 最终选定图
│ ├── {prop_name_2}/
│ │ ├── design.md
│ │ ├── candidate_01.jpg
│ │ └── selected.jpg
```
@@ -0,0 +1,88 @@
# Script Format Example
Below is the standard format for `script.md`. The HTML preview parser depends on this format — follow it strictly.
```markdown
# MV Script — Song Name
Song: Song Name
## Scene 1: Dawn Departure
* 0:00 - 0:12 (12s)
**Scene Description:**
In the early morning mist, the traveller crouches beside the pickup truck bed tightening luggage straps, then stands and wipes sweat from his forehead with the back of his hand.
He turns and opens the driver's door. Sitting in the driver's seat, he grips the steering wheel with both hands, takes a deep breath, and turns the key.
The moment the engine starts, the rear-view mirror reflects the small town silhouette behind him gradually swallowed by morning fog.
The camera slowly pulls back from the side window as the pickup drives onto the open road, wheels kicking up a trail of dust.
**Visual Style:** Warm golden morning light, 35mm film grain, backlit silhouette, shallow depth of field
**Key Props:** Old pickup truck (dark blue, rusted patches, canvas bag strapped to roof rack)
**Transition:** Wheel close-up match cut to next scene's aerial highway view
---
## Scene 2: Highway Solitude
* 0:12 - 0:23 (11s)
> First lyric line
> Second lyric line
**Scene Description:**
Interior car POV — the traveller steers with one hand while the other taps the door panel to the rhythm.
Sunlight through the windshield casts moving light patches on his face; he squints slightly, corners of his mouth lifting unconsciously.
A guitar sits on the passenger seat, its strings vibrating faintly with each bump, producing a low hum.
The camera slowly pushes in from his profile to an eye close-up, the straight road ahead reflected in his pupils.
**Visual Style:** Warm amber tones, natural light entering from the right, handheld slight shake
**Key Props:** Old pickup truck (same as above), guitar (natural wood folk guitar, faded stickers on body)
**Transition:** Dissolve to aerial shot
---
## Scene 3: Campfire in the Wild
* 0:23 - 0:35 (12s)
> Third lyric line
> Fourth lyric line
**Scene Description:**
Dusk in the wilderness — the traveller takes the guitar from the passenger seat and carries it toward a small campfire just lit.
He sits on a rock, head down tuning strings, left hand sliding along frets testing notes.
He looks up at the last strip of orange sunset on the distant ridge line, his expression shifting from concentration to release.
Wind sweeps across the grass, the campfire flames tilt and flicker rightward, sparks drifting up toward the dark blue sky.
The camera tilts up slowly from a fretboard close-up to his face, then continues up to a sky full of stars.
**Visual Style:** Warm-cool boundary tones (campfire warmth vs cool blue sky), telephoto compression
**Key Props:** Guitar (same as above)
**Transition:** Starry sky match cut to next scene
```
## Format Notes
- H1 `#` is used only for the file title (`MV Script — Song Name`), followed by a `Song: Song Name` line
- H2 `##` is used for each scene title (e.g. `## Scene 1: Dawn Departure`)
- Timecode line format: `* M:SS - M:SS (Xs)`
- Not bold, no segment type labels (Verse/Chorus etc.)
- Duration in parentheses (seconds), must be an **integer between 4-15**
- Lyric quotes start with `> `, instrumental scenes have no lyric quotes
- Each scene must contain four fields: `**Scene Description:**`, `**Visual Style:**`, `**Key Props:**`, `**Transition:**`
- `**Key Props:**` lists important non-character visual elements, prop name + brief appearance in parentheses, comma-separated; write `None` if no key props
- Scene Description **must include specific dynamics**, generic static descriptions are prohibited:
- Specify character body movements and motion paths
- Specify expression/emotion changes
- Specify character interaction with objects/environment
- Specify camera movement (tilt up, push in, pan, pull back, etc.)
- Specify environmental dynamics (wind, light changes, flames, water, etc.)
- Scenes separated by `---`
- Script timespans can split or merge lyric segments — they don't need to match lyric.md one-to-one
- Each phase's output is independent: modifying the script doesn't require changing lyrics
@@ -0,0 +1,88 @@
# 脚本格式示例
以下是 `script.md` 的标准格式。HTML 预览解析器依赖此格式,请严格遵循。
```markdown
# MV 脚本 — 歌曲名
歌曲:歌曲名
## 第一幕:黎明启程
* 0:00 - 0:12 (12s)
**场景描述:**
清晨薄雾中,旅人蹲在皮卡后斗旁系紧行李绳,起身后用手背抹去额头的汗,
转身拉开驾驶座车门。他坐进驾驶位,双手握住方向盘,深吸一口气后拧动钥匙。
引擎发动的瞬间,后视镜里映出身后的小镇轮廓渐渐被晨雾吞没。
镜头从驾驶座侧窗缓缓后拉,皮卡驶上空旷的公路,车轮扬起一道灰尘。
**视觉风格:** 暖金色晨光,35mm胶片颗粒感,逆光剪影,浅景深
**关键物件:** 旧皮卡(深蓝色、锈迹斑驳、车顶行李架绑着帆布包)
**转场:** 车轮特写匹配下一幕公路俯瞰
---
## 第二幕:公路独行
* 0:12 - 0:23 (11s)
> 第一行歌词
> 第二行歌词
**场景描述:**
车内视角,旅人单手扶方向盘,另一只手随节奏轻敲门板。
阳光透过挡风玻璃在他脸上投下移动的光斑,他微微眯眼,嘴角不自觉上扬。
副驾上放着一把吉他,车身颠簸时琴弦轻微震颤发出嗡嗡声。
镜头从旅人侧脸缓缓推近至眼部特写,瞳孔中映出前方笔直的公路。
**视觉风格:** 暖琥珀色调,自然光从右侧打入,手持微晃质感
**关键物件:** 旧皮卡(同上)、吉他(原木色民谣吉他、琴身贴有褪色贴纸)
**转场:** 叠化切至俯瞰镜头
---
## 第三幕:旷野扎营
* 0:23 - 0:35 (12s)
> 第三行歌词
> 第四行歌词
**场景描述:**
黄昏旷野,旅人把吉他从皮卡副驾取出,抱在怀里走向一小堆刚点燃的篝火。
他在一块石头上坐下,低头调弦,左手在品丝上滑动试音。
抬头望向远处山脊线上最后一抹橘红色晚霞,表情从专注渐变为释然。
风吹过草地,篝火的火焰向右倾斜摇曳,火星飘向暗蓝色的天空。
镜头从吉他指板特写缓缓上摇至旅人面部,再继续上摇至满天星斗。
**视觉风格:** 暖冷交界色调(篝火暖光 vs 天空冷蓝),长焦压缩感
**关键物件:** 吉他(同上)
**转场:** 星空匹配下一幕转场
```
## 格式要点
- 一级标题 `#` 仅用于文件标题(`MV 脚本 — 歌曲名`),后跟 `歌曲:歌曲名` 行
- 二级标题 `##` 用于每幕场景标题(如 `## 第一幕:黎明启程`)
- 时间码行格式:`* M:SS - M:SS (Xs)`
- 不加粗、不标注段落类型(Verse/Chorus 等)
- 括号内为时长(秒),必须为 **4~15 秒的整数**
- 歌词引用以 `> ` 开头,纯音乐幕无歌词引用
- 每幕必须包含四个字段:`**场景描述:**`、`**视觉风格:**`、`**关键物件:**`、`**转场:**`
- `**关键物件:**` 列出该幕出现的重要非人物视觉元素,物件名 + 括号简述外观,多个逗号分隔;无关键物件写 `无`
- 场景描述**必须包含具体动态**,禁止笼统静态描述:
- 写清角色的肢体动作和运动轨迹
- 写清表情/情绪变化
- 写清角色与物件/环境的交互
- 写清镜头运动方式(上摇、推近、横移、后拉等)
- 写清环境动态(风、光影变化、火焰、水面等)
- 场景之间用 `---` 分隔
- 脚本的时间段可以对歌词段落进行拆分或合并,不需要与 lyric.md 一一对应
- 各阶段产物相互独立:修改脚本不需要回改歌词
@@ -0,0 +1,26 @@
# Story Concept Format Example
Below is the standard format for `story_concept.md`.
```markdown
Story Theme:
The Double Mirror of Time
Story Summary:
When two women separated by a thousand years share breath and touch
through the same melody, AI becomes the medium connecting ancient ink
and modern pixels.
Core Characters:
[Modern]: A girl recording songs alone in a cold minimalist apartment in 2026
[Ancient]: A swordswoman waiting or dancing under a solitary lamp on a snowy night, a thousand years ago
```
## Format Notes
- Contains three fields: `Story Theme:`, `Story Summary:`, `Core Characters:`
- Story Theme is one brief sentence (20-50 words)
- Story Summary uses 2-4 sentences to describe the core narrative
- Core Characters start with [Character Name], followed by character description (appearance, personality, identity, etc.)
- Multiple characters each on their own line, distinguished by [] markers
- Content indented 2 spaces for visual alignment
@@ -0,0 +1,25 @@
# 故事概念格式示例
以下是 `story_concept.md` 的标准格式。
```markdown
故事主题:
时间的双面镜
故事简要:
当两名相隔千年的女性,在同一段旋律中共享了呼吸与触觉,
AI成为了连接古代墨迹与现代像素的介质。
核心人物:
【现代面】:身处2026年,在冰冷极简的落地窗公寓里独自录歌的女孩
【古代面】:身处千年前,在雪夜孤灯下等待或起舞的红尘侠女
```
## 格式要点
- 包含三个字段:`故事主题:`、`故事简要:`、`核心人物:`
- 故事主题一句简短的话(20~50字)
- 故事简要用 2~4 句话描述核心叙事
- 核心人物用【角色名】开头,后接角色描述(外貌、性格、身份等关键信息)
- 多个角色各占一行,以【】标记区分
- 内容缩进 2 空格,保持视觉对齐
@@ -0,0 +1,143 @@
# Storyboard Format Example
Below is the standard format for `storyboard.md`. Each scene corresponds to a scene in the script, referencing generated background, character, and prop images, with video generation prompts.
```markdown
# Song Name — MV Storyboard
## Scene 1: Dawn Departure
* 0:00 - 0:12 (12s)
Characters: traveller
Scene Background: Desert Highway
Key Props: Old Pickup Truck
Scene Description:
A man stands beside a beat-up pickup truck, dawn light pouring from the horizon,
backlighting his and the guitar's silhouette.
In the distance lies an empty desert highway stretching to the horizon.
Video Prompt:
use image 1 as the background, image 2 as the character reference,
image 3 as the prop reference. A rugged man stands beside a vintage
blue pickup truck at dawn. Golden hour backlight creates silhouette.
He reaches into the truck bed to grab his guitar. Camera slowly
dollies in from wide establishing shot. Warm amber tones, 35mm film grain.
Reference:
- backgrounds/desert_highway/selected.jpg (background reference)
- characters/traveller/selected.jpg (character reference)
- props/old_pickup/selected.jpg (prop reference)
Candidates:
- scene_01.jpg — nano_banana_2, ultra-wide pickup panorama
Selected:
scene_01.jpg
---
## Scene 2: Highway Solitude
* 0:12 - 0:23 (11s)
> Wind blows across the edge of the wasteland
> I hear the distance calling
Characters: traveller
Scene Background: Desert Highway
Scene Description:
The pickup drives down a straight highway, window half open, the man steers
with one hand while the other rests on the window frame. Sunlight falls on
his face, expression calm and determined.
Video Prompt:
use image 1 as the background, image 2 as the character reference.
A man driving a vintage pickup truck on a straight desert highway,
one hand on steering wheel, other arm resting on open window.
Sunlight on his face, calm determined expression. Interior car shot,
shallow depth of field. Camera slowly pans from dashboard to his profile.
Cinematic, 35mm film grain, warm amber palette.
Reference:
- backgrounds/desert_highway/selected.jpg (background reference)
- characters/traveller/selected.jpg (character reference)
Candidates:
- scene_02.jpg — nano_banana_2, interior profile close-up
Selected:
scene_02.jpg
---
## Scene 3: Starlit Camp
* 0:23 - 0:35 (12s)
> Stars fall beside the campfire
> Lighting the path you came from
Characters: (none)
Scene Background: Starlit Camp
Scene Description:
An empty wilderness campsite, a campfire burning faintly, sparks scattering
toward the Milky Way. The pickup sits in the distance, headlights off,
moonlight washing over the sandy ground.
Video Prompt:
use image 1 as the background scene. A solitary campfire burning
in vast desert wilderness at night, embers floating up toward
milky way galaxy. Gentle wind makes flames flicker. No people.
Camera slowly tilts up from campfire to starry sky. Cool blue
shadows, warm fire glow contrast, long exposure stars effect.
Reference:
- backgrounds/starlit_camp/selected.jpg (background reference)
Candidates:
- scene_03.jpg — nano_banana_2, campfire starry panorama
Selected:
scene_03.jpg
```
## Format Notes
- H1 `#` used only for the file title (Song Name — MV Storyboard)
- H2 `##` for each scene title, matching scene names from `script.md`
- Timecode line format: `* M:SS - M:SS (Xs)`, consistent with `script.md`
- Lyric quotes start with `> ` (synced from script.md), instrumental scenes have no lyrics
- Each scene contains these fields:
- `Characters:` — characters appearing in the scene (comma-separated), write `(none)` if no characters
- `Scene Background:` — corresponding background name (matching `backgrounds/` directory name)
- `Key Props:` — prop names (comma-separated), may be omitted if none
- `Scene Description:` — description of the visual scene, indented 2 spaces, may span multiple lines
- `Video Prompt:` — English prompt, referencing image numbers + describing dynamics and camera, indented 2 spaces
- `Reference:` — list format, each line noting purpose (background/character/prop reference), paths relative to theme directory
- `Candidates:` — list format, each line recording storyboard image filename (in `storyboard/` directory) with composition notes
- `Selected:` — user-selected final storyboard image filename
- Scenes separated by `---`
## Reference Image Strategy
| Scene Type | Reference Images |
|------------|-----------------|
| Character scene | Background `selected.jpg` + Character `selected.jpg` |
| Character + prop scene | Background `selected.jpg` + Character `selected.jpg` + Prop `selected.jpg` |
| Multi-character | Background `selected.jpg` + Multiple character `selected.jpg` |
| Empty scene / landscape | Background `selected.jpg` only |
## File Organization
```
./.mv/{song_name}/{theme}/
storyboard.md # Storyboard document
storyboard/ # Storyboard images directory
scene_01.jpg
scene_02.jpg
...
```
@@ -0,0 +1,140 @@
# 分镜规划格式示例
以下是 `storyboard.md` 的标准格式。每幕对应脚本中的一个场景,引用已生成的背景图、人设图和物件图,包含视频生成提示词。
```markdown
# 歌曲名 — MV 分镜规划
## 第一幕:黎明启程
* 0:00 - 0:12 (12s)
出场角色:traveller
场景背景:desert_highway
关键物件:old_pickup
场景描述:
男人站在破旧皮卡旁,晨光从地平线倾泻而来,逆光勾勒出他和吉他的剪影。
远处是空旷的荒漠公路,延伸至天际线。
视频提示词:
use image 1 as the background, image 2 as the character reference,
image 3 as the prop reference. A rugged man stands beside a vintage
blue pickup truck at dawn. Golden hour backlight creates silhouette.
He reaches into the truck bed to grab his guitar. Camera slowly
dollies in from wide establishing shot. Warm amber tones, 35mm film grain.
参考图:
- backgrounds/desert_highway/selected.jpg(背景参考)
- characters/traveller/selected.jpg(角色参考)
- props/old_pickup/selected.jpg(物件参考)
候选图:
- scene_01.jpg — nano_banana_2, 超广角皮卡全景
选定图:
scene_01.jpg
---
## 第二幕:公路独行
* 0:12 - 0:23 (11s)
> 风吹过荒原的尽头
> 我听见远方在呼唤
出场角色:traveller
场景背景:desert_highway
场景描述:
皮卡行驶在笔直的公路上,车窗半开,男人单手扶方向盘,
另一手搭在车窗外。阳光打在他侧脸上,表情平静而坚定。
视频提示词:
use image 1 as the background, image 2 as the character reference.
A man driving a vintage pickup truck on a straight desert highway,
one hand on steering wheel, other arm resting on open window.
Sunlight on his face, calm determined expression. Interior car shot,
shallow depth of field. Camera slowly pans from dashboard to his profile.
Cinematic, 35mm film grain, warm amber palette.
参考图:
- backgrounds/desert_highway/selected.jpg(背景参考)
- characters/traveller/selected.jpg(角色参考)
候选图:
- scene_02.jpg — nano_banana_2, 车内侧脸特写
选定图:
scene_02.jpg
---
## 第三幕:星空营地
* 0:23 - 0:35 (12s)
> 星星落在篝火旁
> 照亮你来时的路
出场角色:(无)
场景背景:starlit_camp
场景描述:
无人的荒野营地,篝火微弱地燃烧着,火星飞散向漫天星河。
皮卡停在远处,车头灯已熄灭,月光洒在沙地上。
视频提示词:
use image 1 as the background scene. A solitary campfire burning
in vast desert wilderness at night, embers floating up toward
milky way galaxy. Gentle wind makes flames flicker. No people.
Camera slowly tilts up from campfire to starry sky. Cool blue
shadows, warm fire glow contrast, long exposure stars effect.
参考图:
- backgrounds/starlit_camp/selected.jpg(背景参考)
候选图:
- scene_03.jpg — nano_banana_2, 篝火星空全景
选定图:
scene_03.jpg
```
## 格式要点
- 一级标题 `#` 仅用于文件标题(歌曲名 — MV 分镜规划)
- 二级标题 `##` 用于每幕场景标题,与 `script.md` 的幕名保持一致
- 时间码行格式:`* M:SS - M:SS (Xs)`,与 `script.md` 一致
- 歌词引用以 `> ` 开头(从 script.md 同步),纯音乐幕无歌词
- 每幕包含以下字段:
- `出场角色:` — 该场景中出现的角色**目录名**(逗号分隔),无角色则写 `(无)`
- `场景背景:` — 对应的背景**目录名**(与 `backgrounds/` 目录名一致)
- `关键物件:` — 物件**目录名**(逗号分隔),无物件可省略
- `场景描述:` — 中文画面描述,缩进 2 空格,可多行
- `视频提示词:` — 英文 prompt,引用参考图编号 + 描述动态和镜头,缩进 2 空格
- `参考图:` — 列表形式,每行注明用途(背景参考/角色参考/物件参考),路径相对 theme 目录
- `候选图:` — 列表形式,每行记录分镜图文件名(位于 `storyboard/` 目录下)和构图说明
- `选定图:` — 用户选定的最终分镜图文件名
- 场景之间用 `---` 分隔
## 参考图使用策略
| 场景类型 | 参考图 |
|----------|--------|
| 角色场景 | 背景 `selected.jpg` + 角色 `selected.jpg` |
| 角色 + 物件场景 | 背景 `selected.jpg` + 角色 `selected.jpg` + 物件 `selected.jpg` |
| 多角色同框 | 背景 `selected.jpg` + 多个角色 `selected.jpg` |
| 纯空镜/风景 | 仅背景 `selected.jpg` |
## 文件组织
```
./.mv/{song_name}/{theme}/
├── storyboard.md # 分镜规划文档
├── storyboard/ # 分镜图目录
│ ├── scene_01.jpg
│ ├── scene_02.jpg
│ └── ...
```