@fifine/aim-studio 0.0.3 → 0.0.4

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：报告完成
 
 向用户报告完成的内容和下一步建议。