# 故事锻造厂

**Repository Path**: lontoken/StoryForgeAI

## Basic Information

- **Project Name**: 故事锻造厂
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-31
- **Last Updated**: 2025-11-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# StoryForgeAI

自动化短剧生成系统 - 基于AIGC技术，从大纲自动生成短视频短剧。

## 功能特性

- 📝 **大纲导入**：支持Markdown/文本格式的大纲导入
- 🎬 **分集生成**：支持单模型和多角色协作两种模式生成100+集剧情
- 🤖 **多模型支持**：支持OpenAI、Claude、Gemini、Moonshot等多种大模型提供商
- 🔧 **灵活配置**：通过配置文件灵活配置不同角色的模型和参数
- 🎥 **分镜规划**：自动将剧本转换为镜头计划
- 🎨 **资产生成**：对接第三方API生成图像/视频资产，或手工绑定
- 🎤 **TTS合成**：自动生成配音
- 📺 **字幕对齐**：自动生成和对齐字幕
- 🎞️ **视频合成**：使用FFmpeg拼接视频、添加音频和字幕

## 安装

```bash
pip install -r requirements.txt
```

## 配置

1. 复制 `config.yaml.example` 为 `config.yaml` 并编辑，填入你的API密钥：
   - OpenAI API Key（用于文本生成）
   - Claude API Key（可选）
   - Gemini API Key（可选）
   - Moonshot API Key（可选）
   - 图像生成API配置
   - TTS API配置

2. 配置说明：
   - **提供商配置**：在 `providers` 节点下配置各个大模型提供商的API密钥和参数
   - **角色配置**：在 `roles` 节点下为不同角色指定不同的提供商和模型
   - **LLM全局配置**：在 `llm` 节点下配置全局的LLM调用参数（temperature、maxTokens等）
   - **HTTP代理配置**：
     - 全局代理：在 `proxy` 节点下配置，所有提供商共用
     - 提供商级别代理：在每个提供商的 `proxy` 字段中配置，优先级高于全局代理
     - 支持用户名密码认证：通过 `username` 和 `password` 字段
   - 更多配置说明请参考 [大模型配置说明文档](docs/大模型配置说明.md)

3. 确保已安装FFmpeg并添加到PATH

## 使用方法

### 初始化项目

```powershell
python -m storyforge init DemoProject
```

### 导入大纲

```powershell
python -m storyforge outline import --project DemoProject --file .\outline.md
```

### 生成分集（单模型模式）

```powershell
python -m storyforge episodes generate --project DemoProject --count 100 --provider openai
```

### 生成分集（多角色模式）

```powershell
python -m storyforge episodes generate --project DemoProject --count 100 --pipeline multi-role
```

### 规划分镜

```powershell
python -m storyforge shots plan --project DemoProject --episode 1
```

### TTS合成

```powershell
python -m storyforge tts synthesize --project DemoProject --episode 1 --voice narrator
```

### 字幕对齐

```powershell
python -m storyforge subtitle align --project DemoProject --episode 1
```

### 合成视频

```powershell
python -m storyforge compose episode --project DemoProject --episode 1 --out .\outputs\ep1.mp4
```

### 查看成本报告

```powershell
python -m storyforge cost report --project DemoProject
```

## 完整流程示例

```powershell
# 1. 初始化项目
python -m storyforge init DemoProject

# 2. 导入大纲
python -m storyforge outline import --project DemoProject --file .\outline.md

# 3. 生成分集
python -m storyforge episodes generate --project DemoProject --count 100 --pipeline multi-role

# 4. 规划分镜
python -m storyforge shots plan --project DemoProject --episode 1

# 5. TTS合成
python -m storyforge tts synthesize --project DemoProject --episode 1

# 6. 字幕对齐
python -m storyforge subtitle align --project DemoProject --episode 1

# 7. 合成视频
python -m storyforge compose episode --project DemoProject --episode 1
```

## 目录结构

```
StoryForgeAI/
  storyforge/          # 主包
    cli.py             # CLI入口
    config.py          # 配置管理
    orchestrator/      # 多角色编排器
    models/            # 数据模型
    services/          # 业务服务
    providers/         # 外部平台适配器
    utils/             # 工具函数
  projects/            # 项目数据
  assets/              # 资产文件
  outputs/             # 输出视频
  logs/                # 日志和统计
  config.yaml          # 配置文件
```

## 注意事项

- 当前版本为PoC（概念验证），部分功能为简化实现
- 外部API提供商需要根据实际情况实现
- FFmpeg必须安装并添加到PATH
- Windows PowerShell环境下，命令需逐条执行（不使用&&）

## 许可证

MIT License