@fifine/aim-studio 0.0.8 → 0.0.10

package/dist/templates/opencode/commands/aim/story.md

@@ -0,0 +1,393 @@
+# 漫剧创作
+
+启动漫剧创作模式，开始你的故事创作。
+
+---
+
+## 适用场景
+
+- 创作全新的漫剧项目
+- 开始新剧集的创作
+- 为现有项目添加新角色或新情节
+
+---
+
+## 完整工作流程
+
+### 流程概览
+
+```
+┌─────────────────────────────────────────────────────────────────────────┐
+│                        漫剧创作完整流程                                  │
+├─────────────────────────────────────────────────────────────────────────┤
+│                                                                         │
+│  1. 初始化 ──────────────────────────────────────────────────────→     │
+│     aim init -u <你的名字>                                              │
+│                                                                         │
+│  2. 开始工作 ────────────────────────────────────────────────────→     │
+│     /aim:start                                                        │
+│                                                                         │
+│  3. 设置风格 ────────────────────────────────────────────────────→     │
+│     cat .aim-studio/spec/story/style-guide.md                          │
+│                                                                         │
+│  4. 创作阶段 ────────────────────────────────────────────────────→     │
+│     │                                                                  │
+│     ├─→ /aim:story              启动漫剧创作                           │
+│     │                                                                  │
+│     ├─→ /aim:portrait <角色>   创建角色肖像（可选，可多次）            │
+│     │                                                                  │
+│     ├─→ /aim:visualize          生成场景图片（可选，可多次）           │
+│     │                                                                  │
+│     └─→ /aim:check-story       检查剧情一致性（可选，可多次）          │
+│     │                                                                  │
+│     ├─→ /aim:legitimize        检查并修复违规内容（推荐）              │
+│                                                                         │
+│  5. 导出阶段 ────────────────────────────────────────────────────→     │
+│     │                                                                  │
+│     └─→ /aim:export            导出 Seedance 视频提示词              │
+│                                                                         │
+│  6. 完成工作 ────────────────────────────────────────────────────→     │
+│     /aim:finish-work                                                 │
+│                                                                         │
+└─────────────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 详细步骤
+
+### 步骤 1：初始化项目
+
+```bash
+# 在你的项目目录中
+aim init -u 你的名字
+```
+
+这会创建以下结构：
+
+```
+项目目录/
+├── .aim-studio/              # 系统配置
+│   ├── spec/story/          # 创作规范
+│   │   ├── script.md        # 剧本规范
+│   │   ├── character.md     # 角色设定
+│   │   └── world.md         # 世界观设定
+│   └── tasks/               # 任务存储
+├── aim-workspace/           # 工作日志（你的创作记录）
+└── ...
+```
+
+### 步骤 2：开始工作
+
+```bash
+/aim:start
+```
+
+AI 会：
+1. 读取项目状态
+2. 查看最近的工作日志
+3. 询问你今天要做什么
+
+### 步骤 3：设置视频风格（重要！）
+
+在开始创作之前，先设置项目的视频风格：
+
+```bash
+cat .aim-studio/spec/story/style-guide.md
+```
+
+**五大风格选择**：
+
+| 风格 | 特点 | 适用场景 |
+|------|------|----------|
+| **正常/写实** | 真实自然、无滤镜 | 现代剧、现实主义 |
+| **邵氏/港新武侠** | 武侠传统、动作想象 | 古装武侠、江湖 |
+| **好莱坞硬派** | 真实打斗、英雄主义 | 动作片、超级英雄 |
+| **日本时代剧** | 暴力美学、文化深度 | 武士片、历史剧 |
+| **韩国犯罪片** | 写实暴力、社会批判 | 犯罪、悬疑、社会剧 |
+
+选择风格后，编辑 `style-guide.md` 文件顶部，设置为你的当前风格。
+
+**创作时需考虑**：
+- 场景描述使用对应风格的视觉语言
+- 动作设计采用对应风格的动作特点
+- 色调氛围参考对应风格的色彩方案
+
+### 步骤 4：开始创作
+
+#### 4.1 启动创作模式
+
+```bash
+/aim:story
+```
+
+AI 会询问你想要创作什么。
+
+#### 4.2 创建角色（可选但推荐）
+
+当你创作了新角色后，使用：
+
+```bash
+/aim:portrait 角色名
+```
+
+**示例**：
+```
+/aim:portrait 慕容天
+/aim:portrait 沈安在
+/aim:portrait 女主角
+```
+
+这会生成角色的 AI 绘画提示词，你可以保存下来用于后续生成角色图片。
+
+#### 4.3 生成场景图片（可选）
+
+当你写完一个场景后，想要生成对应的图片：
+
+```bash
+/aim:visualize
+```
+
+这会将当前剧本段落转换为 Qwen-Image 优化的绘画提示词。
+
+#### 4.4 检查剧情一致性（推荐）
+
+完成一段创作后，检查是否有前后不一致：
+
+```bash
+/aim:check-story
+```
+
+这会检查：
+- 角色行为是否符合人设
+- 剧情逻辑是否连贯
+- 场景描述是否一致
+
+#### 4.5 检查并修复违规内容（重要！）
+
+在导出之前，检查并修复违规内容（真人素材、版权内容、敏感内容）：
+
+```bash
+/aim:legitimize --check   # 检查是否有违规
+/aim:legitimize --fix     # 自动修复违规内容
+```
+
+**违规类型**：
+- 真人素材：明星、网红、真实照片
+- 版权内容：金庸小说、漫威、哈利波特
+- 敏感内容：暴力、血腥、政治
+
+**修复方式**：
+- 将真人名称替换为虚构角色名
+- 使用原创元素替代版权内容
+- 移除敏感描述
+
+### 步骤 5：导出视频提示词
+
+当你完成一集或几集的创作后，准备生成视频：
+
+```bash
+/aim:export
+```
+
+实际上是在终端执行：
+
+```bash
+python3 .aim-studio/scripts/export.py --ep 1
+```
+
+#### 4.1 选择导出集数
+
+```bash
+# 导出第1集
+python3 .aim-studio/scripts/export.py --ep 1
+
+# 导出1-3集
+python3 .aim-studio/scripts/export.py --ep 1-3
+
+# 导出全部
+python3 .aim-studio/scripts/export.py --all
+```
+
+#### 4.2 选择视频时长
+
+根据场景复杂度选择：
+
+```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秒或60秒（长场景）
+python3 .aim-studio/scripts/export.py --ep 1 --duration 45
+python3 .aim-studio/scripts/export.py --ep 1 --duration 60
+```
+
+#### 4.3 违规检测
+
+导出时会自动检查违规内容：
+
+| 违规类型 | 检测内容 | 风险等级 |
+|----------|----------|----------|
+| 真人素材 | 明星、网红、真实照片 | ⚠️ 高风险 |
+| 版权内容 | 金庸小说、漫威、哈利波特 | ⚠️ 中风险 |
+| 敏感内容 | 暴力、血腥、政治 | ⚠️ 中风险 |
+
+如果检测到违规，系统会提示你选择处理方式：
+
+```
+请选择处理方式（输入数字）：
+  1. 修改角色设定 - 使用虚构角色替代真人
+  2. 替换版权内容 - 使用原创元素
+  3. 简化敏感描述 - 移除敏感描述
+  4. 强制导出 - 仍要导出（风险自负）
+  5. 退出 - 不导出
+```
+
+#### 4.4 完整导出示例
+
+```bash
+# 最常用：导出第1集，10秒，自动打开文件夹
+python3 .aim-studio/scripts/export.py --ep 1 --open
+
+# 完整参数：导出第1集，30秒，seedance格式
+python3 .aim-studio/scripts/export.py --ep 1 --duration 30 --format seedance
+
+# 批量导出：1-3集，15秒
+python3 .aim-studio/scripts/export.py --ep 1-3 --duration 15
+```
+
+#### 4.5 仅检查违规
+
+如果你只想检查内容是否合规，不导出：
+
+```bash
+python3 .aim-studio/scripts/export.py --check
+```
+
+### 步骤 6：完成工作
+
+```bash
+/aim:finish-work
+```
+
+这会：
+1. 检查内容完整性
+2. 检查格式是否符合规范
+3. 可选：运行剧情一致性检查
+4. 记录工作内容
+
+#### 5.1 记录会话（可选单独使用）
+
+```bash
+# 记录本次工作
+python3 ./.aim-studio/scripts/add_session.py \
+  --title "第1集创作" \
+  --summary "完成第1集前5场的创作"
+```
+
+---
+
+## 常见场景
+
+### 场景 1：全新项目，从零开始
+
+```
+1. aim init -u 我的名字
+2. /aim:start
+3. /aim:story
+   → 告诉 AI 要创作什么类型的故事
+4. 创作角色和剧情...
+5. /aim:portrait 角色1
+6. /aim:portrait 角色2
+7. 继续创作...
+8. /aim:check-story
+9. /aim:export --ep 1 --open
+10. /aim:finish-work
+```
+
+### 场景 2：继续之前的创作
+
+```
+1. /aim:start
+   → AI 会读取之前的进度
+2. 继续创作...
+3. /aim:check-story
+4. /aim:export --ep 2 --duration 15
+5. /aim:finish-work
+```
+
+### 场景 3：修改角色设定
+
+```
+1. /aim:portrait 角色名
+   → 生成新的肖像提示词
+2. 手动更新 character.md
+3. /aim:check-story
+   → 检查修改后是否一致
+```
+
+### 场景 4：生成宣传图片
+
+```
+1. /aim:visualize
+   → 将剧本场景转换为图片提示词
+2. 复制提示词到 AI 绘画工具
+3. 生成图片
+```
+
+---
+
+## 参数速查表
+
+### export.py 完整参数
+
+| 参数 | 必填 | 可选值 | 默认值 | 说明 |
+|------|------|--------|--------|------|
+| `--ep` | 是 | `1`, `1-3`, `all` | 无 | 导出集数 |
+| `--format` | 否 | `seedance`, `simple` | `seedance` | 格式 |
+| `--duration` | 否 | `5/10/15/30/45/60` | `10` | 时长(秒) |
+| `--output` | 否 | 目录名 | `export` | 输出目录 |
+| `--open` | 否 | 开关 | 关闭 | 导出后打开 |
+| `--check` | 否 | 开关 | 关闭 | 仅检查违规 |
+| `--force` | 否 | 开关 | 关闭 | 强制导出 |
+
+### add_session.py 参数
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--title` | 是 | 会话标题 |
+| `--summary` | 是 | 工作摘要 |
+| `--commit` | 否 | Git 提交哈希 |
+
+---
+
+## 注意事项
+
+1. **先检查后导出**：建议先运行 `--check` 确认无违规
+2. **选择合适时长**：复杂场景用 15-30 秒，简单对话用 5-10 秒
+3. **保持角色一致**：每次创作前回顾 character.md
+4. **记录工作进度**：完成后使用 finish-work 记录，便于后续继续
+
+---
+
+## 相关命令
+
+| 命令 | 用途 |
+|------|------|
+| `/aim:start` | 开始会话 |
+| `/aim:story` | 开始创作 |
+| `/aim:portrait` | 生成角色肖像 |
+| `/aim:visualize` | 生成场景图片 |
+| `/aim:legitimize` | 检查并修复违规内容 |
+| `/aim:check-story` | 检查剧情一致性 |
+| `/aim:export` | 导出视频提示词 |
+| `/aim:finish-work` | 完成工作 |

package/dist/templates/opencode/commands/aim/visualize.md

@@ -0,0 +1,177 @@
+# 场景图片生成
+
+将当前剧本段落转换为 AI 绘画提示词，针对 Qwen-Image 优化。
+
+## Qwen-Image 核心优势
+
+| 能力维度 | 技术特点 | 优势 |
+|---------|---------|------|
+| **复杂文本渲染** | 中英文多行文本、段落级语义 | 中文渲染 58.30%，远超竞品 |
+| **精准图像编辑** | 语义一致性与视觉保真度 | 支持链式编辑 |
+| **空间关系** | MSRoPE 位置编码 | 精确布局控制 |
+
+---
+
+## Prompt 结构原则
+
+Qwen-Image 使用 **Qwen2.5-VL 作为文本编码器**，最优 Prompt 应包含：
+
+```
+【主体对象】+ 【属性细节（颜色/数量/形状/材质）】+ 【空间关系】+ 【文本内容（如需要）】+ 【环境背景】+ 【风格/光影】
+```
+
+---
+
+## 执行步骤
+
+### 1. 生成提示词
+
+直接读取当前选中的剧本段落，将其转换为 Qwen-Image 优化的提示词。
+
+### 2. 输出格式
+
+每个场次生成以下格式的提示词：
+
+```markdown
+## 场次 X 图片提示词
+
+### 主体描述
+[主体对象]，[颜色]，[数量]，[形状]，[材质]
+
+### 属性细节
+- 面部特征：[脸型、眼睛、眉毛、发型等]
+- 服装：[颜色、材质、款式]
+- 配饰：[如有]
+
+### 空间关系
+[主体在画面中的位置]，[与其他物体的距离]，[前景/背景关系]
+
+### 文本内容（如需要）
+- 文字内容："需要渲染的文字"
+- 文字位置：[左上角/中央/底部等]
+- 字体样式：[手写体/宋体/霓虹灯管字体等]
+
+### 环境背景
+[场景描述]，[时间]，[天气]，[氛围]
+
+### 风格光影
+[整体风格]，[色调]，[光源方向]，[参考作品]
+
+### 完整英文提示词
+```
+{Subject}, {Appearance details}, {Clothing}, {Position}, 
+{Environment}, {Lighting}, {Style}, {Quality tags}
+```
+
+### 负面提示词
+```
+ugly, deformed, bad anatomy, extra limbs, blurry, low quality, 
+western style (if Chinese style needed), modern clothing (if period piece)
+```
+```
+
+---
+
+## 中文场景特化技巧
+
+### 1. 直接使用中文字符
+
+```
+✅ "招牌上写着'云计算'"
+❌ "sign with Chinese characters meaning cloud computing"
+```
+
+### 2. 利用成语、诗句、对联
+
+```
+一首古诗书法作品，内容为：
+"毕竟西湖六月中，风光不与四时同。
+接天莲叶无穷碧，映日荷花别样红。"
+字体为楷书，背景是水墨画风格的西湖景色。
+```
+
+### 3. 复杂排版布局
+
+```
+一张信息图表，标题为"情绪健康习惯"，周围环绕六个模块：
+左上："练习正念" - 莲花图标
+右上："持续学习" - 书本图标
+左中："培养感恩" - 双手图标
+右中："定期运动" - 跑步图标
+左下："保持联结" - 对话图标
+右下："优先睡眠" - 月亮图标
+整体为优雅的信息图风格，对称布局。
+```
+
+---
+
+## 避坑指南
+
+| ❌ 避免 | ✅ 替代 |
+|--------|--------|
+| "高质量"、"精美" 等空泛词 | 具体描述材质、光影、分辨率要求 |
+| 模糊的文本描述 | 用引号明确标注每个文字 |
+| 忽略空间位置词 | 使用"左上角"、"中央"、"底部"等明确位置 |
+| 过长的无结构句子 | 分段描述不同元素，使用分号或换行 |
+| 假设模型懂特定IP或风格 | 详细描述视觉特征 |
+
+---
+
+## 示例
+
+### 输入剧本
+
+```
+场次 1：青云峰主殿内 - 清晨 - 萧条落寞
+
+白衣中年沈安在瘫坐在太师椅上，神情苦涩。殿外，少年慕容天背着大包小包，站在门口。
+```
+
+### 输出提示词
+
+```markdown
+## 场次 1 图片提示词
+
+### 主体描述
+- 人物1：沈安在，白衣中年男子，两鬓霜白，面容俊俏，神情苦涩
+- 人物2：慕容天，少年身形，背着大包小包
+
+### 属性细节
+- 沈安在服装：白色道袍，材质为丝绸，款式宽松
+- 慕容天服装：青色布衣，背着布包裹
+- 场景道具：太师椅（深棕色木质）、残破窗棂
+
+### 空间关系
+沈安在位于画面中央偏左，瘫坐在太师椅上；慕容天位于画面右侧门口处，两人之间有一定距离
+
+### 环境背景
+青云峰主殿内部，破旧的大殿，阳光透过残破窗棂洒落，萧条冷清的氛围，清晨光线
+
+### 风格光影
+中国仙侠风格，水墨画质感，柔和晨光从左侧打入，产生柔和阴影，色调偏冷
+
+### 完整英文提示词
+```
+A middle-aged Chinese man in white Taoist robe, sitting slumped on a wooden chair, 
+bitter expression, white hair at temples, handsome face. 
+In the background, a young man in blue clothes standing at the doorway, carrying large cloth bundles.
+Dilapidated temple interior, morning sunlight through broken windows, 
+melancholic atmosphere, Chinese xianxia style, ink painting texture, 
+soft lighting from left, cool color tone, cinematic composition
+```
+
+### 负面提示词
+```
+ugly, deformed, bad anatomy, extra limbs, blurry, low quality, 
+modern clothing, western style, bright colors, happy expression
+```
+```
+
+---
+
+## 注意事项
+
+1. **文本渲染**：如需要在图片中渲染文字，必须用引号明确标注
+2. **中文优化**：Qwen-Image 对中文渲染有独特优势，直接使用汉字
+3. **空间布局**：使用明确的位置词（左上角、中央、底部等）
+4. **结构化描述**：分段描述不同元素，避免过长的无结构句子

package/dist/templates/opencode/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * OpenCode templates
+ *
+ * These are GENERIC templates for user projects.
+ *
+ * Directory structure:
+ *   opencode/
+ *   ├── commands/       # Slash commands
+ *   ├── agents/         # Multi-agent pipeline agents
+ *   ├── lib/            # Shared library code
+ *   └── plugin/         # Plugin hooks
+ */
+/**
+ * Command template with name and content
+ */
+export interface CommandTemplate {
+    name: string;
+    content: string;
+}
+/**
+ * Agent template with name and content
+ */
+export interface AgentTemplate {
+    name: string;
+    content: string;
+}
+/**
+ * Plugin file template with target path and content
+ */
+export interface PluginTemplate {
+    targetPath: string;
+    content: string;
+}
+/**
+ * Get all command templates
+ * Commands are stored in commands/aim/ subdirectory
+ * This creates commands like /aim:start, /aim:finish-work, etc.
+ */
+export declare function getAllCommands(): CommandTemplate[];
+/**
+ * Get all agent templates
+ */
+export declare function getAllAgents(): AgentTemplate[];
+/**
+ * Get all plugin files (lib + plugin directories)
+ */
+export declare function getAllPlugins(): PluginTemplate[];
+//# sourceMappingURL=index.d.ts.map

package/dist/templates/opencode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/opencode/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAqBH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,eAAe,EAAE,CAalD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,aAAa,EAAE,CAa9C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,cAAc,EAAE,CAsBhD"}

package/dist/templates/opencode/index.js

@@ -0,0 +1,84 @@
+/**
+ * OpenCode templates
+ *
+ * These are GENERIC templates for user projects.
+ *
+ * Directory structure:
+ *   opencode/
+ *   ├── commands/       # Slash commands
+ *   ├── agents/         # Multi-agent pipeline agents
+ *   ├── lib/            # Shared library code
+ *   └── plugin/         # Plugin hooks
+ */
+import { readdirSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+function readTemplate(relativePath) {
+    return readFileSync(join(__dirname, relativePath), "utf-8");
+}
+function listFiles(dir) {
+    try {
+        return readdirSync(join(__dirname, dir));
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get all command templates
+ * Commands are stored in commands/aim/ subdirectory
+ * This creates commands like /aim:start, /aim:finish-work, etc.
+ */
+export function getAllCommands() {
+    const commands = [];
+    const files = listFiles("commands/aim");
+    for (const file of files) {
+        if (file.endsWith(".md")) {
+            const name = file.replace(".md", "");
+            const content = readTemplate(`commands/aim/${file}`);
+            commands.push({ name, content });
+        }
+    }
+    return commands;
+}
+/**
+ * Get all agent templates
+ */
+export function getAllAgents() {
+    const agents = [];
+    const files = listFiles("agents");
+    for (const file of files) {
+        if (file.endsWith(".md")) {
+            const name = file.replace(".md", "");
+            const content = readTemplate(`agents/${file}`);
+            agents.push({ name, content });
+        }
+    }
+    return agents;
+}
+/**
+ * Get all plugin files (lib + plugin directories)
+ */
+export function getAllPlugins() {
+    const plugins = [];
+    // Read lib files
+    const libFiles = listFiles("lib");
+    for (const file of libFiles) {
+        if (file.endsWith(".js")) {
+            const content = readTemplate(`lib/${file}`);
+            plugins.push({ targetPath: `lib/${file}`, content });
+        }
+    }
+    // Read plugin files
+    const pluginFiles = listFiles("plugin");
+    for (const file of pluginFiles) {
+        if (file.endsWith(".js")) {
+            const content = readTemplate(`plugin/${file}`);
+            plugins.push({ targetPath: `plugin/${file}`, content });
+        }
+    }
+    return plugins;
+}
+//# sourceMappingURL=index.js.map