@fifine/aim-studio 0.0.2 → 0.0.4

package/dist/templates/aim/workflow.md

@@ -67,11 +67,10 @@ aim init
 │       ├── script.md     # 剧本与分镜规范
 │       ├── character.md  # 角色设定规范
 │       └── world.md      # 世界观设定规范
-├── workspace/            # 工作区
-│   └── {项目名}/         # 每个项目一个目录
-│       ├── 全局上下文.txt
-│       ├── 项目配置.md
-│       └── 第1集_*/      # 剧集目录
+├── aim-workspace/        # 工作区（项目根目录下）
+│   └── {开发者名}/       # 每个开发者一个目录
+│       ├── journal-1.md  # 工作日志
+│       └── index.md     # 工作索引
 ├── materials/            # 小说原文
 └── tasks/                # 任务追踪
 ```
@@ -168,18 +167,18 @@ spec/story/
 - 修复问题后需要补充规范
 - 建立新的约定
 
-### 2. workspace/ - 工作区
+### 2. aim-workspace/ - 工作区
 
-**用途**：存放创作输出
+**用途**：存放开发者的工作日志和会话记录
+
+**位置**：直接在项目根目录下（不在 .aim-studio/ 中）
 
 **结构**：
 ```
-workspace/{项目名}/
-├── 项目配置.md          # 视频格式配置
-├── 全局上下文.txt       # 角色设定、世界观
-├── 使用说明.md          # 使用说明
-├── 第1集_*/             # 剧集目录
-└── ...
+aim-workspace/{开发者名}/
+├── journal-1.md        # 工作日志（第1次会话）
+├── journal-2.md       # 工作日志（第2次会话）
+└── index.md           # 工作索引
 ```
 
 ### 3. materials/ - 小说原文

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

@@ -1,187 +1,337 @@
 ---
 name: export
-description: 导出剧本用于AI视频生成
+description: 导出剧本用于AI视频生成（纯文本格式）
 ---
 
 # 导出剧本
 
-将剧本导出为可直接粘贴到 AI 视频生成工具（如 Seedance）的格式。
+将剧本导出为可直接粘贴到 AI 视频生成工具（如 Seedance）的**纯文本格式**。
 
-## 导出流程
+---
+
+## 核心功能
+
+本命令生成**不带任何 Markdown 符号**的纯文本文件，可直接复制粘贴到 Seedance 的视频生成输入框。
+
+### 新增功能
+
+- ✅ **违规检测** - 自动检测真人素材、版权内容、敏感内容
+- ✅ **时长选择** - 支持 5s/10s/15s/30s/45s/60s 多种时长
+- ✅ **智能处理** - 检测到违规时提供多种处理选项
 
-### 1. 选择导出范围
+---
+
+## 使用方法
+
+### 基本用法
 
 ```bash
-# 导出单集
-/aim:export --ep 1
+# 导出第1集
+python3 .aim-studio/scripts/export.py --ep 1
 
 # 导出多集
-/aim:export --ep 1-5
+python3 .aim-studio/scripts/export.py --ep 1-3
 
-# 导出全部
-/aim:export --all
+# 导出全部集数
+python3 .aim-studio/scripts/export.py --all
+
+# 导出后打开文件夹
+python3 .aim-studio/scripts/export.py --ep 1 --open
 ```
 
-### 2. 选择导出格式
+### 导出格式
 
-| 格式 | 用途 | 说明 |
+| 格式 | 说明 | 用途 |
 |------|------|------|
-| `seedance` | Seedance Web 端 | 单场次独立 prompt，包含上下文 |
-| `batch` | 批量生成 | 所有场次合并，适合批量处理 |
-| `review` | 预览检查 | 带注释格式，便于检查 |
-| `text` | 纯文本发布 | 去除备注，统一标点 |
+| `seedance` | 完整格式，包含角色、环境、上下文（默认） | 推荐用于 Seedance |
+| `simple` | 极简格式，只有场景描述和对话 | 快速复制 |
 
-### 3. 导出内容结构
+```bash
+# 使用简单格式
+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
 ```
-export/
-├── EP01/
-│   ├── scene_01.txt      # 场次1 - 可直接粘贴
-│   ├── scene_02.txt      # 场次2 - 可直接粘贴
-│   ├── context.txt       # 本集上下文摘要
-│   └── characters.txt    # 本集角色参考
-├── EP02/
-│   └── ...
-└── global_context.txt    # 全局设定（角色、世界观）
+
+### 违规检测
+
+导出时会自动检查以下违规内容：
+
+| 违规类型 | 检测内容 | 风险 |
+|----------|----------|------|
+| **真人素材** | 明星、公众人物、网红、真实照片等 | 平台禁止 |
+| **版权内容** | 哈利波特、漫威、金庸小说、IP等 | 侵权风险 |
+| **敏感内容** | 暴力、血腥、政治、宗教等 | 审核风险 |
+
+```bash
+# 仅检查违规，不导出
+python3 .aim-studio/scripts/export.py --check
+
+# 强制导出（忽略违规警告）
+python3 .aim-studio/scripts/export.py --ep 1 --force
 ```
 
 ---
 
-## Seedance 导出格式
+## 违规检测流程
 
-### 单场次 Prompt 模板
+### 自动检测
 
-每个场次文件包含完整的上下文信息，可直接粘贴：
+执行导出命令时，系统会自动：
 
-```
-【角色设定】
-[角色名]：[外貌描述]，[性格关键词]
-（如有多位角色，逐一列出）
+1. **扫描角色设定** - 检查 `spec/story/character.md`
+2. **扫描世界观** - 检查 `spec/story/world.md`
+3. **扫描所有场景** - 检查 `tasks/EP*/` 下的所有文件
 
-【场景设定】
-[场景名称]：[环境描述]，[氛围]
+### 检测结果示例
 
-【前情提要】（如适用）
-[上一场次的关键事件，1-2句话]
+```
+============================================================
+🚨 违规检测报告
+============================================================
+
+⚠️  检测到以下潜在违规内容：
+
+【真人素材风险】
+  - 关键词: 明星
+  - 关键词: 刘德华
+
+【版权风险】
+  - 关键词: 金庸
+
+============================================================
+💡 建议处理方式：
+  1. 修改角色设定 - 使用虚构角色替代真人
+  2. 替换版权内容 - 使用原创元素替代受版权保护的内容
+  3. 简化敏感描述 - 移除可能引发争议的描述
+  4. 强制导出 - 仍要导出（风险自负）
+============================================================
+```
 
-【本场次剧本】
-场次 X：[场景] - [时间] - [气氛] - [时长]
+### 用户选择
 
-[画面描述]
+检测到违规后，用户可以选择：
 
-[角色名]：(情绪) 台词
+| 选项 | 说明 |
+|------|------|
+| 1 | 修改角色设定 - 提示用户手动修改角色文件 |
+| 2 | 替换版权内容 - 提示用户修改版权相关内容 |
+| 3 | 简化敏感描述 - 提示用户移除敏感描述 |
+| 4 | 强制导出 - 忽略警告，继续导出 |
+| 5 | 退出 - 不导出 |
 
-[画面描述]
+---
 
-...
+## 输出文件
 
-【视觉风格】
-[风格关键词，如：xianxia, fantasy, cinematic lighting]
+导出会生成纯文本文件到 `export/` 目录：
+
+```
+export/
+├── EP01_场景1.txt      # 可直接粘贴，包含时长
+├── EP01_场景2.txt      # 可直接粘贴
+├── EP02_场景1.txt
+└── ...
 ```
 
-### 示例输出
+### 输出格式示例
 
 ```
-【角色设定】
-沈安在：白衣中年男子，两鬓霜白，面容俊俏，气质高深莫测。性格：腹黑、护短、爱演。
-慕容天：少年身形，目光从落寞到坚定。性格：勤奋、尊师重道、意志坚定。
+=== 场景1: 青云峰主殿 ===
 
-【场景设定】
-青云峰主殿：破旧的大殿，阳光透过残破窗棂洒落，萧条冷清的氛围。
+[DURATION: 10s]
 
-【前情提要】
-慕容天决定下山离开，沈安在内心吐槽自己的穿越遭遇。
+[CHARACTERS]
+沈安在: 白衣中年男子, 两鬓霜白, 面容俊俏
+慕容天: 少年身形, 目光坚定
 
-【本场次剧本】
-场次 1：青云峰主殿内 - 清晨 - 萧条落寞 - 30秒
+[ENVIRONMENT]
+青云峰主殿: 破旧大殿, 阳光洒落, 萧条冷清
 
-白衣中年沈安在瘫坐在太师椅上，神情苦涩。殿外，少年慕容天背着大包小包，站在门口。
+[PREVIOUS CONTEXT]
+慕容天决定下山离开
 
-慕容天：(低沉) 师父，弟子不孝，今日便要下山继承家业，还望师父珍重！
+[SCENE]
+场次 1: 青云峰主殿内 - 清晨 - 萧条落寞 - 30秒
 
-沈安在听到声音，却懒得出门。镜头推进他的脸，苦涩中带着自嘲。
+白衣中年沈安在瘫坐在太师椅上，神情苦涩。
 
-沈安在：(内心独白) 老天啊，你是让我来这边受折磨的吗？
+慕容天：(低沉) 师父，弟子不孝，今日便要下山！
 
-【视觉风格】
+沈安在听到声音，却懒得出门。镜头推进他的脸，苦涩中带着自嘲。
+
+[STYLE]
 xianxia, chinese fantasy, cinematic lighting, melancholic atmosphere
 ```
 
 ---
 
-## 保持一致性的策略
+## 快速使用流程
+
+### 步骤 1：导出（带检测）
 
-### 1. 全局上下文文件
+```bash
+python3 .aim-studio/scripts/export.py --ep 1 --duration 10 --open
+```
 
-`global_context.txt` 包含：
-- 核心角色设定（外貌、性格、说话风格）
-- 世界观设定（力量体系、地理环境）
-- 视觉风格关键词
+### 步骤 2：处理违规（如有）
 
-**使用方式**：
-- 首次使用时，先粘贴全局上下文
-- 或将全局上下文保存为 Seedance 的"项目设定"
+根据检测结果选择处理方式
 
-### 2. 集间上下文文件
+### 步骤 3：复制
 
-每集的 `context.txt` 包含：
-- 本集角色状态快照
-- 本集关键事件摘要
-- 上一集结尾状态
+打开 `export/` 文件夹，选择对应场次的 `.txt` 文件，**直接全选复制**。
 
-### 3. 角色参考文件
+### 步骤 4：粘贴到 Seedance
 
-每集的 `characters.txt` 包含：
-- 本集出场角色的完整设定
-- SD Prompt 片段
-- 服装变化记录
+将复制的内容**直接粘贴**到 Seedance 的 prompt 输入框中，点击生成。
 
 ---
 
-## 执行方式
+## 与其他命令配合
 
+```
+1. /aim:story              → 创作剧本
+2. /aim:check-story        → 检查剧情一致性
+3. /aim:export --ep 1      → 导出第1集（10秒）
+4. 复制到 Seedance         → 生成视频
+```
+
+---
+
+## 完整参数说明
+
+### 所有参数一览表
+
+| 参数 | 必填 | 可选值 | 默认值 | 说明 |
+|------|------|--------|--------|------|
+| `--ep` | 是 | `1`, `1-3`, `all` | 无 | 指定导出的集数 |
+| `--format` | 否 | `seedance`, `simple` | `seedance` | 导出格式 |
+| `--duration` | 否 | `5`, `10`, `15`, `30`, `45`, `60` | `10` | 视频时长（秒） |
+| `--output` | 否 | 任意目录名 | `export` | 输出目录名称 |
+| `--open` | 否 | 开关 | 关闭 | 导出后自动打开文件夹 |
+| `--check` | 否 | 开关 | 关闭 | 仅检查违规，不导出 |
+| `--force` | 否 | 开关 | 关闭 | 强制导出，忽略违规警告 |
+
+### 参数详细说明
+
+#### `--ep` (必填)
+指定要导出的集数：
+- `1` - 导出第1集
+- `1-3` - 导出第1集到第3集
+- `all` - 导出所有集数
+
+示例：
 ```bash
-# 交互式导出
-/aim:export
+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      # 导出全部
+```
 
-# 快速导出（使用默认设置）
-/aim:export --ep 1 --format seedance
+#### `--format` (可选)
+导出内容的格式：
+- `seedance`（默认）- 完整格式，包含角色、环境、上下文、风格等所有信息
+- `simple` - 极简格式，只有场景描述和对话
 
-# 导出纯文本格式
-/aim:export --ep 1 --format text
+示例：
+```bash
+python3 .aim-studio/scripts/export.py --ep 1 --format seedance
+python3 .aim-studio/scripts/export.py --ep 1 --format simple
+```
 
-# 导出并打开目录
-/aim:export --ep 1 --open
+#### `--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秒
 ```
 
----
+#### `--output` (可选)
+指定输出目录的名称，默认值为 `export`
 
-## 导出后检查清单
+示例：
+```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` (可选)
+只检查违规内容，不进行导出。检查结果会显示是否有违规，但不会生成文件。
 
-1. **首次使用**：建议先粘贴 `global_context.txt` 到 Seedance，建立项目基准
-2. **连续剧**：每集开始前，先粘贴上一集的 `context.txt`
-3. **角色一致性**：使用相同的角色描述和 SD Prompt 片段
-4. **时长控制**：根据视频格式配置，调整每场次的字数
+示例：
+```bash
+python3 .aim-studio/scripts/export.py --check
+# 输出违规报告，不导出任何文件
+```
 
----
+#### `--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
+```
+
+---
+
+## 注意事项
 
-输出目标：纯文本 / 长图文案 / 剧本杀格式（请根据用户需求调整）
+1. **纯文本格式**：导出的文件不包含任何 `#`、`*`、`[]` 等 Markdown 符号
+2. **字符编码**：文件使用 UTF-8 编码，确保 Seedance 能正确识别
+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/onboard.md

@@ -41,7 +41,7 @@ Every AI session starts with a blank slate. Unlike human engineers who accumulat
 
 **The Problem**: Without memory, AI asks the same questions repeatedly, makes the same mistakes, and can't build on previous work.
 
-**The Solution**: The `.aim-studio/workspace/` system captures what happened in each session - what was done, what was learned, what problems were solved. The `/aim:start` command reads this history at session start, giving AI "artificial memory."
+**The Solution**: The `aim-workspace/` system captures what happened in each session - what was done, what was learned, what problems were solved. The `/aim:start` command reads this history at session start, giving AI "artificial memory."
 
 ### Challenge 2: AI Has Generic Knowledge, Not Project-Specific Knowledge
 
@@ -67,11 +67,13 @@ Even after injecting guidelines, AI has limited context window. As conversation
 .aim-studio/
 |-- .developer              # Your identity (gitignored)
 |-- workflow.md             # Complete workflow documentation
-|-- workspace/              # "AI Memory" - session history
-|   |-- index.md            # All developers' progress
-|   +-- {developer}/        # Per-developer directory
-|       |-- index.md        # Personal progress index
-|       +-- journal-N.md    # Session records (max 2000 lines)
+|-- tasks/                  # Task tracking (unified)
+
+aim-workspace/               # "AI Memory" - session history (directly visible)
+|-- index.md                # All developers' progress
++-- {developer}/            # Per-developer directory
+    |-- index.md            # Personal progress index
+    +-- journal-N.md        # Session records (max 2000 lines)
 |-- tasks/                  # Task tracking (unified)
 |   +-- {MM}-{DD}-{slug}/   # Task directory
 |       |-- task.json       # Task metadata
@@ -116,7 +118,7 @@ AI needs the same onboarding - but compressed into seconds at session start.
 **WHAT IT ACTUALLY DOES**:
 1. Reads developer identity (who am I in this project?)
 2. Checks git status (what branch? uncommitted changes?)
-3. Reads recent session history from `workspace/` (what happened before?)
+3. Reads recent session history from `aim-workspace/` (what happened before?)
 4. Identifies active features (what's in progress?)
 5. Understands current project state before making any changes
 
@@ -199,7 +201,7 @@ The `/check-*` commands focus on code quality within a single layer. But real ch
 All the context AI built during this session will be lost when session ends. The next session's `/aim:start` needs this information.
 
 **WHAT IT ACTUALLY DOES**:
-1. Records session summary to `workspace/{developer}/journal-N.md`
+1. Records session summary to `aim-workspace/{developer}/journal-N.md`
 2. Captures what was done, learned, and what's remaining
 3. Updates index files for quick lookup