Huobao Drama 开源短剧生成平台：从剧本到视频

4）资源管理与任务追踪

• 是什么：统一管理生成的素材，并跟踪任务进度
• 怎么做：
  • 素材库统一管理
  • 本地存储支持
  • 资源导入导出
  • 任务进度追踪
• 注意事项（可选）：
  • 数据库存储默认使用 SQLite（见 configs/config.example.yaml）
  • 静态资源访问基于 storage.base_url 拼接（默认 http://localhost:5678/static），反代/换域名时要一起调整

五、技术选型

• 后端：Go 1.23+ · Gin · GORM · SQLite(含 modernc.org/sqlite) · Zap · Viper
• 前端：Vue 3.4+ · TypeScript · Vite 5 · Element Plus · TailwindCSS · Pinia · Vue Router · vue-i18n · Axios
• 数据：SQLite（默认），配置里也出现 gorm.io/driver/mysql 依赖（是否启用 MySQL 以代码/文档为准）
• 可观测/日志：Zap（仓库依赖显示）
• 容器化：Docker 多阶段构建（Node 20 + Go 1.23-alpine + alpine runtime） · docker-compose
• 媒体处理：FFmpeg（必需）

六、如何使用

运行前准备（所有方式通用）

• 如果你本机手动运行（非 Docker）：先安装 ffmpeg，并确保 ffmpeg -version 可用
• AI 能力需要配置供应商与 Key：配置文件里仅指定默认 provider，具体 API Key 通常在 Web 界面里配置（以实际界面/仓库文档为准）
• 默认端口：
  • 后端/API：5678
  • 前端开发服务器：3012（仅开发模式，见 web/vite.config.ts）

方式一：Docker

仓库 README 给了两种 Docker 跑法：Docker Hub 直接跑，或本地构建后跑。这里按 README 原样整理可复制命令：

# 直接运行（Docker Hub）
docker run -d \
  --name huobao-drama \
  -p 5678:5678 \
  -v $(pwd)/data:/app/data \
  --restart unless-stopped \
  huobao/huobao-drama:latest

• 数据目录与挂载路径：
  • 宿主机：$(pwd)/data
  • 容器内：/app/data（SQLite DB + storage 都在这下面，具体以运行后生成内容为准）
• 访问：
  • http://localhost:5678
• 重要说明（Linux）：
  • 如果容器内要访问宿主机的 Ollama/本地模型，需加：--add-host=host.docker.internal:host-gateway（详见 DOCKER_HOST_ACCESS.md）

方式二：Docker Compose（推荐）

项目自带 docker-compose.yml（包含 healthcheck、命名卷、extra_hosts），最省事：

# 启动
docker-compose up -d
# 看日志
docker-compose logs -f
# 停止
docker-compose down

• 默认端口：5678:5678
• 数据持久化：使用命名卷 huobao-data:/app/data（见 docker-compose.yml）
• 自定义配置文件：
  • compose 里预留了挂载（默认注释掉）：./configs/config.yaml:/app/configs/config.yaml:ro
  • 你需要先准备 configs/config.yaml（可从示例复制）

方式三：手动构建（前端/后端）

1）拉代码 + 准备配置

git clone https://github.com/chatfire-AI/huobao-drama.git
cd huobao-drama
cp configs/config.example.yaml configs/config.yaml

configs/config.yaml 关键项（示例来自仓库，敏感信息不在这里）：

server:
  port: 5678
  host: "0.0.0.0"
  cors_origins:
    - "http://localhost:3012"
database:
  type: "sqlite"
  path: "./data/drama_generator.db"
storage:
  type: "local"
  local_path: "./data/storage"
  base_url: "http://localhost:5678/static"
ai:
  default_text_provider: "openai"
  default_image_provider: "openai"
  default_video_provider: "doubao"

2）开发模式（前后端分离，热更新）

# 终端 1：后端
go mod download
go run main.go

# 终端 2：前端
cd web
npm install
npm run dev

• 前端：http://localhost:3012
• 后端：http://localhost:5678
• 代理规则：前端会把 /api 转发到 http://localhost:5678（见 web/vite.config.ts）

3）单服务模式（后端同时提供前端静态文件）

cd web
npm install
npm run build
cd..
go run main.go

• 访问：http://localhost:5678

七、二次开发注意事项

• 环境依赖版本（从仓库文件推断）：
  • Go：1.23+（见 go.mod）
  • Node.js：README 写 18+；Dockerfile 使用 node:20-alpine（本地用 18/20 通常都可，最终以你依赖安装结果为准）
  • FFmpeg：4.0+（必需）
• 本地开发启动方式：
  • 后端：go run main.go
  • 前端：npm run dev（默认 3012），并代理 /api -> 5678
• 常见问题
  • SQLite 只读/写权限：生产机用 systemd 部署时，确保运行用户对 data/ 目录与 DB 文件都有写权限；否则可能出现 attempt to write a readonly database（README 给了排查与修复命令）
  • Docker 访问宿主机模型：统一用 http://host.docker.internal:<port>/v1，Linux 下需要 host-gateway 映射（见 DOCKER_HOST_ACCESS.md 与 docker-compose.yml 的 extra_hosts）
  • 跨域/前端连不上后端：检查 configs/config.yaml 的 server.cors_origins 是否包含你的前端地址；开发模式代理在 web/vite.config.ts

八、目录结构与主要文件

huobao-drama/
├── main.go # 后端入口
├── go.mod # Go 依赖与版本（Go 1.23）
├── Dockerfile # 多阶段构建（前端 build + 后端 build + runtime 含 ffmpeg）
├── docker-compose.yml # Compose 一键启动（含 healthcheck/volume/extra_hosts）
├── configs/
│   └── config.example.yaml # 配置示例（复制为 config.yaml 使用）
├── api/ # API 层（Gin HTTP，按 README 的分层说明）
├── application/ # 应用服务层（业务编排）
├── domain/ # 领域层（模型/领域逻辑）
├── infrastructure/ # 基础设施层（DB/外部服务等）
├── migrations/ # 迁移相关（README 说明首次启动会自动建表）
├── pkg/ # 通用包/工具代码
└── web/ # 前端（Vue3 + Vite）
    ├── package.json # 前端依赖与脚本
    └── vite.config.ts # dev server(3012) + /api 代理到 5678

九、源码地址

• https://github.com/chatfire-AI/huobao-drama