# Soft

**Repository Path**: xlf1987/Soft

## Basic Information

- **Project Name**: Soft
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-21
- **Last Updated**: 2026-02-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🏭 Soft — AI 内容工厂

**一站式 AI 短视频内容生产流水线**，从选题投喂到脚本生成、分镜绘制、视频合成、封面设计、文案标签——全链路自动化。

---

## ✨ 核心特性

| 模块 | 功能 |
|------|------|
| 🎯 **选题工坊** | 手动投喂 / URL 导入 → 选题审核 → 一键生成 |
| 🤖 **人设管理** | 多人设多平台，每个人设绑定独立风格 |
| 📝 **三模板绑定** | 脚本(script) + 封面(cover) + 文案标签(copywriting) 自由组合 |
| ⚡ **6 阶段流水线** | 脚本 → 分镜 → 图片 → 视频 → 封面/文案 → 打包入库 |
| 📊 **作品看板** | 实时进度追踪、成品预览、画廊模式浏览 |
| ⚙️ **AI 服务集成** | MiniMax M2.5 (脚本/文案) + 阿里云 DashScope (图片/视频) |

## 🏗 技术架构

```
┌──────────────────────────────────────┐
│           Frontend (Vite + React)    │
│  React 19 · TailwindCSS 4 · Lucide  │
└──────────────┬───────────────────────┘
               │ REST API
┌──────────────▼───────────────────────┐
│           Backend (FastAPI)          │
│  SQLAlchemy · aiosqlite · Pydantic  │
├──────────────────────────────────────┤
│  Services                           │
│  ├─ llm_service   (MiniMax M2.5)    │
│  ├─ image_service (DashScope)       │
│  ├─ video_service (DashScope)       │
│  └─ pipeline_runner (6-stage)       │
├──────────────────────────────────────┤
│  SQLite (content_factory.db)        │
└──────────────────────────────────────┘
```

## 📦 数据模型

```
Persona ──┐
          ├── Binding ──┬── script_template    (必选)
Template ─┤             ├── cover_template     (可选)
          │             └── copywriting_template(可选)
Topic ────┴── PipelineTask ── ContentPackage
```

## 🚀 快速开始

### 前置依赖

- Python 3.11+
- Node.js 18+
- ffmpeg（视频拼接阶段需要）

### 1. 克隆仓库

```bash
git clone https://github.com/<your-username>/soft.git
cd soft
```

### 2. 后端

```bash
cd backend

# 创建虚拟环境
python -m venv venv
source venv/bin/activate   # Windows: venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
# 编辑 .env，填入你的 API Key
```

### 3. 前端

```bash
cd frontend
npm install
```

### 4. 启动

```bash
# 终端 1：后端 (端口 8000)
cd backend && source venv/bin/activate
uvicorn app.main:app --reload --port 8000

# 终端 2：前端 (端口 5173)
cd frontend
npm run dev
```

打开浏览器访问 `http://localhost:5173`

### 5. 初始化种子数据

首次启动后，调用种子接口初始化示例数据：

```bash
curl -X POST http://localhost:8000/api/seed/init
```

## ⚙️ 环境变量

在 `backend/.env` 中配置：

| 变量 | 说明 | 必填 |
|------|------|------|
| `DASHSCOPE_API_KEY` | 阿里云百炼 DashScope API Key | ✅ |
| `ARK_API_KEY` | 火山方舟 Seedance API Key | ❌ |
| `ARK_BASE_URL` | 火山方舟 API 地址 | ❌ |
| `DATABASE_URL` | 数据库连接串 (默认 SQLite) | ❌ |
| `STORAGE_PATH` | 文件存储路径 (默认 `./storage`) | ❌ |

> **提示**：未配置 API Key 时，LLM 服务会返回模拟数据，方便本地开发调试。

## 📁 项目结构

```
Soft/
├── backend/
│   ├── app/
│   │   ├── main.py              # FastAPI 入口
│   │   ├── models.py            # SQLAlchemy 数据模型
│   │   ├── schemas.py           # Pydantic 请求/响应模型
│   │   ├── database.py          # 数据库配置
│   │   ├── routers/             # API 路由
│   │   │   ├── personas.py      # 人设 CRUD
│   │   │   ├── prompts.py       # 提示词模板 CRUD
│   │   │   ├── bindings.py      # 绑定 CRUD
│   │   │   ├── topics.py        # 选题 CRUD
│   │   │   ├── pipeline.py      # 流水线任务管理
│   │   │   ├── settings.py      # 系统设置
│   │   │   └── seed.py          # 种子数据初始化
│   │   └── services/            # 业务逻辑
│   │       ├── llm_service.py   # LLM 调用 (脚本 + 文案)
│   │       ├── image_service.py # 图片生成 (DashScope)
│   │       ├── video_service.py # 视频生成 (DashScope)
│   │       └── pipeline_runner.py # 6 阶段流水线引擎
│   ├── .env.example             # 环境变量模板
│   └── requirements.txt         # Python 依赖
├── frontend/
│   ├── src/
│   │   ├── App.tsx              # 路由 & 布局
│   │   ├── pages/
│   │   │   ├── Dashboard.tsx    # 作品看板 (任务卡片 + 画廊)
│   │   │   ├── Workshop.tsx     # 内容工坊 (选题投喂 + 生成)
│   │   │   ├── Resources.tsx    # 资源管理 (人设/模板/绑定)
│   │   │   ├── Analytics.tsx    # 数据分析
│   │   │   └── Settings.tsx     # 系统设置
│   │   ├── services/api.ts      # API 客户端
│   │   └── hooks/useAPI.ts      # 数据请求 Hook
│   ├── package.json
│   └── vite.config.ts
├── .gitignore
└── README.md
```

## 🔄 流水线阶段

| 阶段 | 名称 | 说明 |
|------|------|------|
| 0 | 准备中 | 加载绑定关系、获取人设 & 三类模板 |
| 1 | 脚本生成 | 基于脚本模板 + 人设 + 选题 → LLM 生成口播脚本 |
| 2 | 分镜绘制 | 脚本拆分场景 → 生成分镜描述 |
| 3 | 图片生成 | 分镜描述 → AI 绘图 (DashScope wanx2.1) |
| 4 | 视频合成 | 图片 → AI 视频 (DashScope wan2.6) |
| 5 | 封面 & 文案 | 封面模板 → 封面图 / 文案模板 → 标题+描述+标签 |
| 6 | 打包入库 | 汇总所有产出 → ContentPackage 入库 |

## 📄 License

MIT