@fifine/aim-studio 0.0.3 → 0.0.5

package/dist/templates/claude/commands/aim/export.md

@@ -13,6 +13,12 @@ description: 导出剧本用于AI视频生成（纯文本格式）
 
 本命令生成**不带任何 Markdown 符号**的纯文本文件，可直接复制粘贴到 Seedance 的视频生成输入框。
 
+### 新增功能
+
+- ✅ **违规检测** - 自动检测真人素材、版权内容、敏感内容
+- ✅ **时长选择** - 支持 5s/10s/15s/30s/45s/60s 多种时长
+- ✅ **智能处理** - 检测到违规时提供多种处理选项
+
 ---
 
 ## 使用方法
@@ -45,6 +51,97 @@ python3 .aim-studio/scripts/export.py --ep 1 --open
 python3 .aim-studio/scripts/export.py --ep 1 --format simple
 ```
 
+### 时长选择
+
+支持以下视频时长：
+
+```bash
+# 5秒短视频
+python3 .aim-studio/scripts/export.py --ep 1 --duration 5
+
+# 10秒（默认）
+python3 .aim-studio/scripts/export.py --ep 1 --duration 10
+
+# 15秒
+python3 .aim-studio/scripts/export.py --ep 1 --duration 15
+
+# 30秒
+python3 .aim-studio/scripts/export.py --ep 1 --duration 30
+
+# 45秒
+python3 .aim-studio/scripts/export.py --ep 1 --duration 45
+
+# 60秒
+python3 .aim-studio/scripts/export.py --ep 1 --duration 60
+```
+
+### 违规检测
+
+导出时会自动检查以下违规内容：
+
+| 违规类型 | 检测内容 | 风险 |
+|----------|----------|------|
+| **真人素材** | 明星、公众人物、网红、真实照片等 | 平台禁止 |
+| **版权内容** | 哈利波特、漫威、金庸小说、IP等 | 侵权风险 |
+| **敏感内容** | 暴力、血腥、政治、宗教等 | 审核风险 |
+
+```bash
+# 仅检查违规，不导出
+python3 .aim-studio/scripts/export.py --check
+
+# 强制导出（忽略违规警告）
+python3 .aim-studio/scripts/export.py --ep 1 --force
+```
+
+---
+
+## 违规检测流程
+
+### 自动检测
+
+执行导出命令时，系统会自动：
+
+1. **扫描角色设定** - 检查 `spec/story/character.md`
+2. **扫描世界观** - 检查 `spec/story/world.md`
+3. **扫描所有场景** - 检查 `tasks/EP*/` 下的所有文件
+
+### 检测结果示例
+
+```
+============================================================
+🚨 违规检测报告
+============================================================
+
+⚠️  检测到以下潜在违规内容：
+
+【真人素材风险】
+  - 关键词: 明星
+  - 关键词: 刘德华
+
+【版权风险】
+  - 关键词: 金庸
+
+============================================================
+💡 建议处理方式：
+  1. 修改角色设定 - 使用虚构角色替代真人
+  2. 替换版权内容 - 使用原创元素替代受版权保护的内容
+  3. 简化敏感描述 - 移除可能引发争议的描述
+  4. 强制导出 - 仍要导出（风险自负）
+============================================================
+```
+
+### 用户选择
+
+检测到违规后，用户可以选择：
+
+| 选项 | 说明 |
+|------|------|
+| 1 | 修改角色设定 - 提示用户手动修改角色文件 |
+| 2 | 替换版权内容 - 提示用户修改版权相关内容 |
+| 3 | 简化敏感描述 - 提示用户移除敏感描述 |
+| 4 | 强制导出 - 忽略警告，继续导出 |
+| 5 | 退出 - 不导出 |
+
 ---
 
 ## 输出文件
@@ -53,21 +150,19 @@ python3 .aim-studio/scripts/export.py --ep 1 --format simple
 
 ```
 export/
-├── EP01_场景1.txt      # 可直接粘贴
+├── EP01_场景1.txt      # 可直接粘贴，包含时长
 ├── EP01_场景2.txt      # 可直接粘贴
 ├── EP02_场景1.txt
 └── ...
 ```
 
----
-
-## Seedance 纯文本格式
-
-导出的文件内容示例（无任何 Markdown 符号）：
+### 输出格式示例
 
 ```
 === 场景1: 青云峰主殿 ===
 
+[DURATION: 10s]
+
 [CHARACTERS]
 沈安在: 白衣中年男子, 两鬓霜白, 面容俊俏
 慕容天: 少年身形, 目光坚定
@@ -95,61 +190,140 @@ xianxia, chinese fantasy, cinematic lighting, melancholic atmosphere
 
 ## 快速使用流程
 
-### 步骤 1：导出
+### 步骤 1：导出（带检测）
 
 ```bash
-python3 .aim-studio/scripts/export.py --ep 1 --open
+python3 .aim-studio/scripts/export.py --ep 1 --duration 10 --open
 ```
 
-### 步骤 2：复制
+### 步骤 2：处理违规（如有）
+
+根据检测结果选择处理方式
+
+### 步骤 3：复制
 
 打开 `export/` 文件夹，选择对应场次的 `.txt` 文件，**直接全选复制**。
 
-### 步骤 3：粘贴到 Seedance
+### 步骤 4：粘贴到 Seedance
 
 将复制的内容**直接粘贴**到 Seedance 的 prompt 输入框中，点击生成。
 
 ---
 
-## 保持一致性的技巧
+## 与其他命令配合
 
-### 1. 角色描述一致性
+```
+1. /aim:story              → 创作剧本
+2. /aim:check-story        → 检查剧情一致性
+3. /aim:export --ep 1      → 导出第1集（10秒）
+4. 复制到 Seedance         → 生成视频
+```
 
-每次导出时，脚本会自动从 `spec/story/character.md` 提取角色信息。确保角色设定文件中的描述保持一致。
+---
 
-### 2. 视觉风格关键词
+## 完整参数说明
 
-在世界观文件 `spec/story/world.md` 中定义统一的视觉风格关键词，导出会自动包含这些关键词。
+### 所有参数一览表
 
-### 3. 上下文衔接
+| 参数 | 必填 | 可选值 | 默认值 | 说明 |
+|------|------|--------|--------|------|
+| `--ep` | 是 | `1`, `1-3`, `all` | 无 | 指定导出的集数 |
+| `--format` | 否 | `seedance`, `simple` | `seedance` | 导出格式 |
+| `--duration` | 否 | `5`, `10`, `15`, `30`, `45`, `60` | `10` | 视频时长（秒） |
+| `--output` | 否 | 任意目录名 | `export` | 输出目录名称 |
+| `--open` | 否 | 开关 | 关闭 | 导出后自动打开文件夹 |
+| `--check` | 否 | 开关 | 关闭 | 仅检查违规，不导出 |
+| `--force` | 否 | 开关 | 关闭 | 强制导出，忽略违规警告 |
 
-每集导出时会包含 `[PREVIOUS CONTEXT]` 部分，帮助 Seedance 理解剧情连续性。
+### 参数详细说明
 
----
+#### `--ep` (必填)
+指定要导出的集数：
+- `1` - 导出第1集
+- `1-3` - 导出第1集到第3集
+- `all` - 导出所有集数
 
-## 常见问题
+示例：
+```bash
+python3 .aim-studio/scripts/export.py --ep 1       # 导出第1集
+python3 .aim-studio/scripts/export.py --ep 1-3     # 导出1到3集
+python3 .aim-studio/scripts/export.py --ep all      # 导出全部
+```
 
-### Q: 导出文件有乱码？
+#### `--format` (可选)
+导出内容的格式：
+- `seedance`（默认）- 完整格式，包含角色、环境、上下文、风格等所有信息
+- `simple` - 极简格式，只有场景描述和对话
 
-确保使用 `--format seedance`（默认）格式，这是为 Seedance 优化的纯文本格式。
+示例：
+```bash
+python3 .aim-studio/scripts/export.py --ep 1 --format seedance
+python3 .aim-studio/scripts/export.py --ep 1 --format simple
+```
 
-### Q: 如何只导出一个场景？
+#### `--duration` (可选)
+生成的视频时长（秒）：
+- `5` - 5秒短视频
+- `10` - 10秒（**默认值**）
+- `15` - 15秒
+- `30` - 30秒
+- `45` - 45秒
+- `60` - 60秒
 
-目前脚本按集导出。如果需要单场景，可以手动编辑导出的文件。
+示例：
+```bash
+python3 .aim-studio/scripts/export.py --ep 1 --duration 5   # 5秒
+python3 .aim-studio/scripts/export.py --ep 1 --duration 30  # 30秒
+```
 
-### Q: 导出的内容太长？
+#### `--output` (可选)
+指定输出目录的名称，默认值为 `export`
 
-Seedance 对 prompt 长度有限制。可以使用 `--format simple` 获得更简洁的版本。
+示例：
+```bash
+python3 .aim-studio/scripts/export.py --ep 1 --output my-videos
+# 输出到 my-videos/ 目录
+```
 
----
+#### `--open` (可选)
+导出完成后自动打开输出文件夹（仅 Windows/Mac/Linux）
 
-## 与其他命令配合
+示例：
+```bash
+python3 .aim-studio/scripts/export.py --ep 1 --open
+```
+
+#### `--check` (可选)
+只检查违规内容，不进行导出。检查结果会显示是否有违规，但不会生成文件。
 
+示例：
+```bash
+python3 .aim-studio/scripts/export.py --check
+# 输出违规报告，不导出任何文件
 ```
-1. /aim:story              → 创作剧本
-2. /aim:check-story        → 检查剧情一致性
-3. /aim:export --ep 1      → 导出第1集
-4. 复制到 Seedance         → 生成视频
+
+#### `--force` (可选)
+强制导出，即使检测到违规内容也会继续导出。**注意：使用此参数风险自负！**
+
+示例：
+```bash
+python3 .aim-studio/scripts/export.py --ep 1 --force
+```
+
+### 组合使用示例
+
+```bash
+# 完整示例：导出第1集，30秒时长，导出后打开文件夹
+python3 .aim-studio/scripts/export.py --ep 1 --duration 30 --open
+
+# 导出1-3集，15秒，简单格式
+python3 .aim-studio/scripts/export.py --ep 1-3 --duration 15 --format simple
+
+# 仅检查违规
+python3 .aim-studio/scripts/export.py --check
+
+# 强制导出（忽略警告）
+python3 .aim-studio/scripts/export.py --ep 1 --force
 ```
 
 ---
@@ -158,4 +332,6 @@ Seedance 对 prompt 长度有限制。可以使用 `--format simple` 获得更
 
 1. **纯文本格式**：导出的文件不包含任何 `#`、`*`、`[]` 等 Markdown 符号
 2. **字符编码**：文件使用 UTF-8 编码，确保 Seedance 能正确识别
-3. **首次使用**：建议先导出单集测试，确认格式符合预期
+3. **时长选择**：根据场景复杂度选择合适时长，复杂场景建议 15-30 秒
+4. **违规检测**：建议先检查违规，修改后再导出，确保内容合规
+5. **强制导出**：使用 `--force` 会忽略警告，风险由用户自行承担

package/dist/templates/claude/commands/aim/finish-work.md

@@ -68,6 +68,29 @@ description: 完成创作并记录工作
 python3 ./.aim-studio/scripts/add_session.py --title "<工作标题>" --summary "<工作摘要>"
 ```
 
+#### add_session.py 完整参数说明
+
+| 参数 | 必填 | 说明 | 示例 |
+|------|------|------|------|
+| `--title` | 是 | 会话标题，简洁描述本次工作 | `--title "第1集第3场创作"` |
+| `--summary` | 是 | 工作摘要，描述完成的内容 | `--summary "完成慕容天与沈安在的对手戏"` |
+| `--commit` | 否 | Git 提交哈希（如果有提交） | `--commit "abc1234"` |
+
+#### 使用示例
+
+```bash
+# 简单记录
+python3 ./.aim-studio/scripts/add_session.py \
+  --title "第1集第3场创作" \
+  --summary "完成慕容天与沈安在的对手戏"
+
+# 带 Git 提交的记录
+python3 ./.aim-studio/scripts/add_session.py \
+  --title "创作第1集" \
+  --summary "完成第1集前5场的创作" \
+  --commit "a1b2c3d"
+```
+
 ### 步骤 4：报告完成
 
 向用户报告完成的内容和下一步建议。

package/dist/templates/claude/commands/aim/legitimize.md

@@ -0,0 +1,250 @@
+---
+name: legitimize
+description: 检查并合法化剧本（AI智能修改违规内容）
+---
+
+# 剧本合法化
+
+使用 AI 智能检查并修改剧本中的违规内容，使其符合 AI 视频生成平台的规定。
+
+---
+
+## 适用场景
+
+- 检查剧本中是否存在违规内容（真人素材、版权角色、敏感内容等）
+- 自动将违规内容修改为合规内容
+- 修改角色名称使其"一听就像主角"
+- 强化肖像描述让 AI 更容易理解
+
+---
+
+## 使用方法
+
+### 检查剧本（只读，不修改）
+
+```bash
+/aim:legitimize --check
+```
+
+这会：
+1. 读取 `spec/story/character.md` 角色设定
+2. 读取 `spec/story/world.md` 世界观设定
+3. 读取当前剧集的所有场景文件
+4. 使用 AI 分析是否存在违规内容
+5. 输出详细的检查报告
+
+### 修复剧本（自动修改）
+
+```bash
+/aim:legitimize --fix
+```
+
+这会：
+1. 先检查所有违规内容
+2. 使用 AI 自动修改违规内容
+3. 保存修改后的文件
+4. 输出修改报告
+
+---
+
+## 违规类型及修改原则
+
+### 1. 真人素材（高风险）
+
+| 原始 | 修改后 | 说明 |
+|------|--------|------|
+| 刘德华 | 刘天霸 | 保留气质，换成虚构名字 |
+| 周杰伦 | 周云飞 | 同音替换 |
+| 网红脸 | 清秀面容 | 改为描述性词汇 |
+
+### 2. 版权角色（中风险）
+
+| 原始 | 修改后 | 说明 |
+|------|--------|------|
+| 张无忌 | 张凌风 | 金庸角色 → 原创 |
+| 钢铁侠 | 铁甲侠 | 漫威 → 原创 |
+| 哈利波特 | 哈云 | 哈利波特 → 原创 |
+
+### 3. 敏感内容（中风险）
+
+| 原始 | 修改后 | 说明 |
+|------|--------|------|
+| 血腥的屠杀 | 激烈的战斗 | 暴力 → 温和 |
+| 自杀 | 离去 | 敏感 → 规避 |
+| 赌博 | 比试 | 赌博 → 比赛 |
+
+---
+
+## 修改规则
+
+### 角色名称修改
+
+1. **同音/谐音替换**：保留原名的读音特点
+2. **气质保持**：修改后的名字要符合人物设定
+3. **主角感**：主角名字要"一听就像主角"
+4. **原创优先**：避免任何知名人物的名字
+
+### 肖像描述强化
+
+强化关键词，让 AI 更容易理解：
+- "帅气" → "剑眉星目，气宇轩昂"
+- "漂亮" → "柳眉杏眼，肤若凝脂"
+- "可爱" → "肉嘟嘟的小脸，大眼睛忽闪忽闪"
+
+---
+
+## 执行步骤
+
+### 步骤 1：读取剧本文件
+
+首先读取需要检查的文件：
+
+```bash
+# 读取角色设定
+cat .aim-studio/spec/story/character.md
+
+# 读取世界观设定
+cat .aim-studio/spec/story/world.md
+
+# 读取当前剧集
+ls -la .aim-studio/tasks/
+cat .aim-studio/tasks/EP01/*.md
+```
+
+### 步骤 2：AI 检查
+
+使用 AI 分析内容，查找以下违规：
+
+1. **真人素材**：明星、演员、网红、真实照片等
+2. **版权内容**：金庸小说角色、漫威、哈利波特等受版权保护的内容
+3. **敏感内容**：暴力、血腥、政治、宗教等
+
+### 步骤 3：输出报告
+
+输出格式：
+
+```
+📋 剧本合规性检查报告
+
+【角色设定】spec/story/character.md
+  ✅ 无违规
+
+【世界观设定】spec/story/world.md
+  ⚠️ 发现违规：
+  - 版权：金庸 → 修改为原创角色"金玄"
+  - 敏感："血腥战斗" → 改为"激烈对决"
+
+【场景文件】
+  EP01/场景1.md
+    ✅ 无违规
+  EP01/场景2.md
+    ⚠️ 发现违规：
+    - 版权："张无忌" → 修改为"张凌风"
+    - 真实人物："网红脸" → 改为"清秀面容"
+```
+
+### 步骤 4：自动修复（如果使用 --fix）
+
+对每个违规内容进行修改：
+
+1. 角色名称替换
+2. 肖像描述强化
+3. 敏感内容温和化
+
+修改后保存文件，并输出修改摘要。
+
+---
+
+## 完整示例
+
+### 示例 1：检查剧本
+
+```
+> /aim:legitimize --check
+
+正在读取剧本文件...
+正在使用 AI 分析...
+
+📋 剧本合规性检查报告
+
+【角色设定】
+  ⚠️ 发现违规：
+  1. 真实人物："刘德华" → 建议修改为"刘天霸"
+  2. 真实人物："网红脸" → 建议修改为"清秀面容"
+
+【世界观设定】
+  ✅ 无违规
+
+【场景文件】EP01
+  场景1.md
+    ✅ 无违规
+  场景2.md
+    ⚠️ 发现违规：
+    1. 版权角色："张无忌" → 建议修改为"张凌风"
+    2. 敏感内容："血腥屠杀" → 建议修改为"激烈战斗"
+
+共发现 4 处违规，建议使用 /aim:legitimize --fix 进行修复
+```
+
+### 示例 2：修复剧本
+
+```
+> /aim:legitimize --fix
+
+正在读取剧本文件...
+正在使用 AI 分析并修复...
+
+🔧 开始修复...
+
+【角色设定】
+  ✅ 已修复：
+  - "刘德华" → "刘天霸"
+  - "网红脸" → "清秀面容"
+  - 肖像描述强化："帅气" → "剑眉星目，气宇轩昂"
+
+【场景文件】
+  EP01/场景2.md
+    ✅ 已修复：
+    - "张无忌" → "张凌风"
+    - "血腥屠杀" → "激烈战斗"
+
+✅ 修复完成！共修复 4 处违规
+```
+
+---
+
+## 注意事项
+
+1. **API Key**：使用此命令需要配置 OpenAI API Key
+   ```bash
+   # 设置环境变量
+   export OPENAI_API_KEY=your-api-key
+   ```
+
+2. **备份建议**：修复前建议备份原始文件
+
+3. **审查修改**：AI 修改后建议人工审查确认
+
+4. **多次执行**：可以多次执行直到无违规
+
+---
+
+## 相关命令
+
+| 命令 | 用途 |
+|------|------|
+| `/aim:check-story` | 检查剧情一致性 |
+| `/aim:export` | 导出视频提示词 |
+| `/aim:story` | 开始创作 |
+
+---
+
+## 工作流程
+
+```
+1. /aim:story              → 创作剧本
+2. /aim:legitimize --check → 检查是否有违规
+3. /aim:legitimize --fix   → 自动修复违规内容
+4. /aim:check-story        → 再次检查剧情一致性
+5. /aim:export            → 导出视频提示词
+```