@fifine/aim-studio 0.0.1

package/dist/templates/markdown/spec/guides/index.md.txt

@@ -0,0 +1,89 @@
+# Thinking Guides
+
+> **Purpose**: Expand your thinking to catch things you might not have considered.
+
+---
+
+## Why Thinking Guides?
+
+**Most bugs and tech debt come from "didn't think of that"**, not from lack of skill:
+
+- Didn't think about what happens at layer boundaries → cross-layer bugs
+- Didn't think about code patterns repeating → duplicated code everywhere
+- Didn't think about edge cases → runtime errors
+- Didn't think about future maintainers → unreadable code
+
+These guides help you **ask the right questions before coding**.
+
+---
+
+## Available Guides
+
+| Guide | Purpose | When to Use |
+|-------|---------|-------------|
+| [Code Reuse Thinking Guide](./code-reuse-thinking-guide.md) | Identify patterns and reduce duplication | When you notice repeated patterns |
+| [Cross-Layer Thinking Guide](./cross-layer-thinking-guide.md) | Think through data flow across layers | Features spanning multiple layers |
+| [Cross-Platform Thinking Guide](./cross-platform-thinking-guide.md) | Catch platform-specific assumptions | Scripts, paths, commands |
+
+---
+
+## Quick Reference: Thinking Triggers
+
+### When to Think About Cross-Layer Issues
+
+- [ ] Feature touches 3+ layers (API, Service, Component, Database)
+- [ ] Data format changes between layers
+- [ ] Multiple consumers need the same data
+- [ ] You're not sure where to put some logic
+
+→ Read [Cross-Layer Thinking Guide](./cross-layer-thinking-guide.md)
+
+### When to Think About Code Reuse
+
+- [ ] You're writing similar code to something that exists
+- [ ] You see the same pattern repeated 3+ times
+- [ ] You're adding a new field to multiple places
+- [ ] **You're modifying any constant or config**
+- [ ] **You're creating a new utility/helper function** ← Search first!
+
+→ Read [Code Reuse Thinking Guide](./code-reuse-thinking-guide.md)
+
+### When to Think About Cross-Platform Issues
+
+- [ ] Writing scripts that users will run directly
+- [ ] Adding usage examples or help text
+- [ ] Working with file paths or commands
+- [ ] **Migrating from shell scripts to Python**
+
+→ Read [Cross-Platform Thinking Guide](./cross-platform-thinking-guide.md)
+
+---
+
+## Pre-Modification Rule (CRITICAL)
+
+> **Before changing ANY value, ALWAYS search first!**
+
+```bash
+# Search for the value you're about to change
+grep -r "value_to_change" .
+```
+
+This single habit prevents most "forgot to update X" bugs.
+
+---
+
+## How to Use This Directory
+
+1. **Before coding**: Skim the relevant thinking guide
+2. **During coding**: If something feels repetitive or complex, check the guides
+3. **After bugs**: Add new insights to the relevant guide (learn from mistakes)
+
+---
+
+## Contributing
+
+Found a new "didn't think of that" moment? Add it to the relevant guide.
+
+---
+
+**Core Principle**: 30 minutes of thinking saves 3 hours of debugging.

package/dist/templates/markdown/spec/story/character.md.txt

@@ -0,0 +1,95 @@
+# 角色设定规范 (Character Profile)
+
+## 核心角色表
+
+| 姓名 | 性别 | 年龄 | 核心关键词 (Tag) |
+|---|---|---|---|
+| 主角名 | 男/女 | 18 | 热血, 腹黑, 剑客 |
+
+---
+
+## 角色详情模板
+
+请为每个主要角色复制以下模板并填写：
+
+### [角色姓名]
+
+**基本信息**
+- **全名**:
+- **昵称/代号**:
+- **性别**:
+- **年龄**:
+- **生日**:
+- **职业/身份**:
+
+**外貌特征 (Visual Description)**
+> *用于 AI 绘画提示词参考*
+- **发型/发色**:
+- **眼睛/瞳色**:
+- **体型/身高**:
+- **服装风格**:
+- **饰品/特征**:
+- **面部表情惯例**:
+
+**性格特征 (Personality)**
+- **核心性格**: (如：傲娇、冷静、鲁莽)
+- **优点**:
+- **缺点/弱点**:
+- **说话风格**: (如：口头禅、语速、用词习惯)
+- **价值观/动机**:
+
+**背景故事 (Backstory)**
+- **过往经历**:
+- **核心冲突**:
+- **人际关系**:
+    - vs [角色B]: (关系描述)
+
+---
+
+## 配角/路人设定
+
+- **[配角A]**: 简短描述...
+
+---
+
+## 进阶设定（可选）
+
+> 以下内容适用于长篇连续剧，根据项目需要选择使用。
+
+### 角色成长轨迹
+
+> 记录角色在故事中的变化，避免性格突变
+
+| 章节/集数 | 状态/阶段 | 关键变化 | 心理状态 | 备注 |
+|-----------|-----------|----------|----------|------|
+| (示例) EP01 | 初登场 | - | 天真烂漫 | |
+| (示例) EP05 | 转折点 | 经历背叛 | 开始怀疑 | |
+| (示例) EP10 | 成熟期 | 接受现实 | 冷静务实 | |
+
+### 角色关系演变
+
+> 追踪角色间关系的变化，适用于多角色长篇故事
+
+| 角色 | 初始关系 | 当前关系 | 关键转折点 | 当前章节 |
+|------|----------|----------|------------|----------|
+| (示例) 配角A | 陌生人 | 盟友 | EP03共同战斗 | EP10 |
+
+### 章节状态快照
+
+> 每集结束时角色的状态（位置、装备、情绪、知识等），帮助保持连续性
+
+| 章节 | 当前位置 | 装备/道具 | 情绪状态 | 已知信息 | 重要变化 |
+|------|----------|-----------|----------|----------|----------|
+| (示例) EP05 | 王都 | 佩剑、信物 | 焦虑 | 知道了真相 | 获得信物 |
+
+### 角色视觉一致性检查表
+
+> 确保 AI 绘画/视频生成时角色外观一致
+
+| 特征项 | 设定 | 是否可变 | 备注 |
+|--------|------|----------|------|
+| 发型/发色 | | 固定/可变 | |
+| 瞳色 | | 固定/可变 | |
+| 标志性饰品 | | 固定/可变 | |
+| 服装变化 | | 按章节记录 | |
+| SD Prompt 片段 | | | |

package/dist/templates/markdown/spec/story/index.md.txt

@@ -0,0 +1,31 @@
+# 漫剧创作指南 (Story Creation Guide)
+
+> 本目录包含漫剧/小说创作的规范与最佳实践。
+
+---
+
+## 概览
+
+本目录下的文档旨在指导 AI 与创作者协作进行高质量的漫剧或小说创作。请根据项目具体需求填写相关设定。
+
+---
+
+## 指南索引
+
+| 指南 | 说明 | 状态 |
+|------|------|------|
+| [角色设定](./character.md) | 角色档案、性格、外貌、背景故事 | 待定 |
+| [世界观设定](./world.md) | 地理、历史、魔法/科技体系、势力分布 | 待定 |
+| [剧本规范](./script.md) | 剧本格式、分镜描述、对白规范 | 待定 |
+
+---
+
+## 使用说明
+
+1. **角色先行**：在开始写作前，请先完善[角色设定](./character.md)。
+2. **构建世界**：明确[世界观](./world.md)有助于维持故事逻辑的一致性。
+3. **遵循格式**：请严格按照[剧本规范](./script.md)输出现场/对白，以便后续进行 AI 绘画或分镜制作。
+
+---
+
+**语言**：建议使用**简体中文**进行创作。

package/dist/templates/markdown/spec/story/script.md.txt

@@ -0,0 +1,313 @@
+# 剧本与分镜规范 (Script & Storyboard)
+
+## 视频格式配置（必填）
+
+> 在开始创作前，请先确定视频格式。这将影响每场戏的时长和内容密度。
+
+| 配置项 | 选项 | 当前设定 |
+|--------|------|----------|
+| 视频类型 | 单集 / 连续剧 | （请填写） |
+| 视频长度 | 短视频（1-3分钟）/ 中视频（5-15分钟）/ 长视频（20分钟+） | （请填写） |
+| 单场时长 | 短视频：15-30秒/场；中视频：30-60秒/场；长视频：1-3分钟/场 | （请填写） |
+| 每集场次数 | 建议：短视频3-5场；中视频5-10场；长视频10-20场 | （请填写） |
+
+**示例配置**：
+```
+视频类型：连续剧
+视频长度：短视频（2-3分钟/集）
+单场时长：20-30秒
+每集场次数：4-6场
+```
+
+---
+
+## Seedance 2.0 Prompt 优化指南
+
+> 基于 Seedance 2.0 论文核心分析，以下是针对音视频联合生成的最优 Prompt 策略。
+
+### Prompt 结构框架（必填六要素）
+
+```
+【主体描述】+ 【动作/表演细节】+ 【环境/氛围】+ 【镜头语言】+ 【音频/声音设计】+ 【风格/影调】
+```
+
+### 各维度优化技巧
+
+#### 1. 主体描述（利用强语义理解）
+- ✅ **具体明确**："一位穿着暗红色羊绒大衣的40岁女性" 优于 "一个女人"
+- ✅ **多模态细节**：同时描述视觉外观和声音特征
+  ```
+  例："一位嗓音略带沙哑的中年男性，穿着磨损的皮夹克，说话时带有明显的四川方言口音"
+  ```
+
+#### 2. 动作与表演（避免慢动作陷阱）
+- ⚠️ **避免**：仅写 "缓慢行走"（模型可能用慢动作糊弄）
+- ✅ **推荐**：明确动作意图和情绪强度
+  ```
+  例："她快步穿过人群，肩膀微微颤抖，表现出压抑的愤怒，步伐急促但保持平衡"
+  ```
+
+#### 3. 镜头控制（利用原生运镜能力）
+
+| 运镜类型 | Prompt 写法 |
+|---------|------------|
+| 希区柯克变焦 | "Dolly zoom effect: camera pulls back while zooming in" |
+| 环绕镜头 | "360-degree orbital shot around the subject" |
+| 跟踪镜头 | "Handheld tracking shot following the character" |
+| 长镜头 | "Continuous long take without cuts" |
+| 特写转场 | "Push-in to extreme close-up on eyes" |
+| 推镜头 | "Slow push-in from medium shot to close-up" |
+| 拉镜头 | "Pull-back shot revealing the environment" |
+
+#### 4. 音频设计（核心差异化能力）
+**必须显式描述音频**，因为模型是音视频联合生成：
+
+```
+【人声细节】
+- 语言："普通话/粤语/四川话/英语"
+- 音色："清脆的少女音/浑厚的男低音/沙哑的烟嗓"
+- 情绪语调："颤抖的哭腔/抑扬顿挫的朗诵/冷漠的平淡语气"
+- 内容：直接写出台词或描述说话内容
+
+【环境音效】
+- "海浪拍打礁石的声音，海鸥远处鸣叫"
+- "雨声从轻柔转为倾盆，配合雷声渐近"
+
+【音乐氛围】
+- "低沉的大提琴独奏，逐渐加入弦乐，营造悬疑感"
+```
+
+#### 5. 风格与影调
+- ✅ 描述具体视觉特征而非空泛词
+- ❌ 避免："高质量"、"4K"、"精美"
+- ✅ 推荐："冷色调，高对比度，电影级调色"
+
+### 中文场景特化技巧
+
+1. **方言使用**：直接指定
+   ```
+   "角色用上海话交谈，语调软糯，带有老派弄堂口音"
+   ```
+
+2. **文化元素**：模型对东方表演有理解
+   ```
+   "京剧旦角，兰花指手势，眼波流转，念白带有韵白节奏"
+   "武侠风格，抱拳行礼，衣袂飘动，配乐是古筝与笛子"
+   ```
+
+3. **短剧节奏**：指定快节奏叙事
+   ```
+   "短剧风格，快节奏剪辑感，每3秒一个情绪转折，配合紧张的音乐节拍"
+   ```
+
+---
+
+## 场次文件格式标准
+
+### 文件结构（Seedance 2.0 优化版）
+
+```markdown
+【主体描述】
+角色外观、服装、体型、年龄等具体描述
+声音特征：音色、语调、方言口音
+
+【动作与表演】
+具体动作描述，包含情绪强度和动作意图
+避免模糊描述，明确动作节奏
+
+【环境与氛围】
+场景地点、时间、天气、光线
+环境氛围关键词
+
+【镜头语言】
+运镜方式：推/拉/摇/移/跟/升降
+景别：远景/全景/中景/近景/特写
+特殊效果：慢动作/快进/定格
+
+【音频设计】
+人声：语言、音色、语调、台词内容
+环境音：具体的环境声音描述
+音乐：背景音乐风格和情绪
+
+【风格影调】
+整体视觉风格
+色调和光影特点
+参考作品风格（可选）
+
+【剧本内容】
+对白和动作描写
+```
+
+---
+
+## 文件命名规范（简体中文）
+
+> **重要**：所有目录和文件名必须使用简体中文，便于用户识别和管理。
+
+**剧集目录命名**：`第{集数}集_{中文标题}`
+
+**场次文件命名**：`场次{序号}.txt`
+
+**封面图片命名**：`场次{序号}_封面.png` 或 `场次{序号}_封面.jpg`
+
+**示例目录结构**：
+```
+输出/
+├── 项目配置.md              # 视频格式配置
+├── 全局上下文.txt           # 角色设定、世界观
+├── 第1集_系统觉醒/
+│   ├── 剧本.md              # 完整剧本
+│   ├── 场次1.txt            # 可粘贴到视频生成工具
+│   ├── 场次1_封面.png       # 场次1封面图片
+│   ├── 场次2.txt
+│   ├── 场次2_封面.png
+│   └── 上下文摘要.txt       # 本集结尾状态
+├── 第2集_一剑开天门/
+│   └── ...
+└── ...
+```
+
+---
+
+## 封面图片生成规范
+
+> 每个场次视频都应有对应的封面图片，用于视频封面展示。
+
+### 封面图片要求
+
+| 属性 | 要求 |
+|------|------|
+| 尺寸 | 1920x1080（横版）或 1080x1920（竖版） |
+| 格式 | PNG 或 JPG |
+| 风格 | 与视频视觉风格一致 |
+
+### 封面 Prompt 模板
+
+```
+【封面图片提示词】
+风格：[视觉风格关键词]
+主体：[主要角色/物体]
+动作：[关键姿势/表情]
+场景：[背景环境]
+光线：[光照效果]
+构图：[镜头角度/构图方式]
+```
+
+---
+
+## 完整示例 Prompt
+
+### 示例1：修仙玄幻场景
+
+```markdown
+【主体描述】
+沈安在：白衣中年男子，约40岁，两鬓霜白，面容俊俏，身材修长。
+声音特征：沉稳有力的男中音，说话时带有仙风道骨的从容感。
+
+【动作与表演】
+双手负于身后，从高处跃下，落地时衣袂飘动，表情从慵懒转为严肃。
+步伐稳健，眼神锐利地盯着前方，表现出高人的威严感。
+
+【环境与氛围】
+青云峰山道，清晨，阳光透过云层洒落，山间云雾缭绕。
+氛围：仙侠意境，空灵飘逸。
+
+【镜头语言】
+运镜：从高处俯拍沈安在跃下，跟随下落，落地时切换到低角度仰拍。
+景别：全景 → 中景 → 近景。
+节奏：落地瞬间有轻微的慢动作效果。
+
+【音频设计】
+人声：沈安在大喝"站住！"，声音在山谷中回荡。
+环境音：山风吹过树林的沙沙声，远处鸟鸣。
+音乐：古筝急促拨动，营造紧张感，落地时音乐骤停。
+
+【风格影调】
+xianxia, chinese fantasy, cinematic lighting, ethereal atmosphere.
+色调：冷色调为主，晨光带来暖色点缀。
+参考：《琅琊榜》《陈情令》的仙侠视觉风格。
+
+【剧本内容】
+沈安在落地，双手负于身后，故作高深地看着慕容天。
+沈安在：(冷淡) 你要去哪？
+慕容天低头，不敢直视沈安在。
+```
+
+### 示例2：情绪特写场景
+
+```markdown
+【主体描述】
+慕容天：少年身形，约16岁，穿着朴素道袍，背着包袱。
+声音特征：清亮的少年音，说话时带着压抑的哭腔。
+
+【动作与表演】
+停下脚步，回头望向青云峰顶，眼眶泛红，嘴角苦笑。
+肩膀微微颤抖，表现出压抑的悲伤和不甘。
+
+【环境与氛围】
+青云峰山道，上午，阳光透过树叶洒落斑驳光影。
+氛围：落寞、决绝。
+
+【镜头语言】
+运镜：固定机位，缓慢推近到面部特写。
+景别：远景 → 中景 → 面部特写。
+特殊：最后定格在眼睛的极端特写，捕捉泪光。
+
+【音频设计】
+人声：慕容天自语，声音低沉颤抖。
+环境音：山间寂静，偶尔有风吹树叶声。
+音乐：低沉的大提琴独奏，逐渐加入弦乐，营造悲伤感。
+
+【风格影调】
+xianxia, chinese fantasy, melancholic, cinematic.
+色调：偏冷的蓝色调，阳光带来微弱暖色。
+参考：《卧虎藏龙》的情感戏视觉风格。
+
+【剧本内容】
+慕容天：(自语) 三年了……我还是无法突破筑基期。
+慕容天停下脚步，回头望向青云峰顶。
+慕容天：(苦笑) 也许离开才是最好的选择。
+```
+
+---
+
+## 避坑指南
+
+| ❌ 避免 | ✅ 替代 |
+|--------|--------|
+| "高质量"、"4K"、"精美" 等空泛词 | 具体描述材质、光影、运镜方式 |
+| 仅描述视觉，忽略音频 | 音视频联合描述，至少指定环境音 |
+| 过度限制（指定每秒的动作） | 给模型创意空间，描述意图和情绪 |
+| 长句堆砌 | 用分段清晰分隔不同维度 |
+| "像XX电影"（模型可能不理解） | 描述该电影的具体视觉特征 |
+| "缓慢行走"等模糊动作 | 明确动作意图、情绪强度和节奏 |
+
+---
+
+## 进阶设定（可选）
+
+### 章节摘要模板
+
+> 每章完成后记录核心信息，帮助 AI 记住前文。
+
+```markdown
+## 第X章摘要
+- **核心事件**：（一句话概括）
+- **关键决策**：（角色做出的重要决定）
+- **角色登场**：（本章出现的角色）
+- **伏笔埋设**：（埋下的伏笔ID）
+- **伏笔揭示**：（揭示的伏笔ID）
+- **角色状态变化**：（位置、情绪、关系等变化）
+- **预计下章内容**：（简要提示）
+```
+
+### 场次时长估算指南
+
+| 视频类型 | 对白密度 | 动作密度 | 建议时长 |
+|----------|----------|----------|----------|
+| 短视频 | 少（1-3句） | 多 | 15-20秒 |
+| 短视频 | 多（5-10句） | 少 | 20-30秒 |
+| 中视频 | 少 | 多 | 30-45秒 |
+| 中视频 | 多 | 少 | 45-60秒 |
+| 长视频 | 少 | 多 | 1-2分钟 |
+| 长视频 | 多 | 少 | 2-3分钟 |

package/dist/templates/markdown/spec/story/world.md.txt

@@ -0,0 +1,92 @@
+# 世界观设定规范 (World Building)
+
+## 世界概览
+
+- **世界名称**:
+- **核心基调**: (如：赛博朋克、高魔奇幻、现代都市、克苏鲁)
+- **核心规则**: (如：魔法均需等价交换、科技高度发达但贫富悬殊)
+
+---
+
+## 地理与环境
+
+### [主要地点A]
+- **描述**:
+- **氛围**:
+- **重要地标**:
+
+### [主要地点B]
+- **描述**:
+
+---
+
+## 势力与组织
+
+### [组织名称]
+- **性质**: (如：政府、公会、邪教)
+- **宗旨**:
+- **主要成员**:
+- **徽章/标志**:
+
+---
+
+## 力量体系 (Magic/Tech System)
+
+- **体系名称**:
+- **等级划分**:
+- **获取方式**:
+- **代价/限制**:
+
+---
+
+## 历史大事记
+
+1. **[年份/时期]**: 事件描述...
+2. **[年份/时期]**: 事件描述...
+
+---
+
+## 进阶设定（可选）
+
+> 以下内容适用于长篇连续剧，根据项目需要选择使用。
+
+### 故事时间线
+
+> 统一记录故事内的时间流逝，避免时间逻辑错误
+
+| 故事时间 | 章节/集数 | 关键事件 | 参与角色 |
+|----------|-----------|----------|----------|
+| 第1天 | EP01 | 主角觉醒 | 主角、导师 |
+| (示例) 第3天 | EP02 | 进入王都 | 主角、配角A |
+
+### 伏笔追踪表
+
+> 记录埋下的伏笔，避免烂尾或遗忘
+
+| ID | 伏笔内容 | 埋设章节 | 计划揭示章节 | 状态 | 关联角色 |
+|----|----------|----------|--------------|------|----------|
+| F001 | (示例) 神秘项链 | EP01 | EP15 | 待揭示 | 主角 |
+| F002 | (示例) 失踪的父亲 | EP03 | ? | 进行中 | 配角A |
+
+**状态说明**：
+- `待揭示`：尚未开始揭示
+- `进行中`：正在逐步揭示
+- `已完成`：伏笔已完全揭示
+
+### 场景视觉参考
+
+> 为 AI 绘画/视频生成提供场景一致性参考
+
+| 场景名称 | 关键特征 | 氛围 | 时间段 | SD Prompt 片段 |
+|----------|----------|------|--------|----------------|
+| (示例) 王都学院 | 欧式建筑 | 庄严 | 白天 | fantasy academy |
+| (示例) 废弃仓库 | 破败 | 压抑 | 夜晚 | abandoned warehouse |
+
+### 设定变更日志
+
+> 记录创作过程中的设定修改，便于追溯和同步更新
+
+| 日期 | 变更内容 | 影响范围 | 需同步更新 | 状态 |
+|------|----------|----------|------------|------|
+| (示例) 2024-01-15 | 主角年龄改为18 | EP01-05对白 | ✅ 已更新 | 完成 |
+| (示例) 2024-01-20 | 新增配角C | EP08起 | ⏳ 待更新 | 进行中 |