一句话视频 (sologen)

一句话，帮我生成视频。

sologen 是一个端到端自动化系统：输入一句话，自动完成选题、成文、口播稿 + HTML 幻灯片、TTS 配音、视频合成，以及可选的剪映增强流程。

功能总览

• 网站端一键创建任务，实时查看进度与日志
• 自动安装并加载 4 个核心 skill
  • topic-generator
  • wechat-writing
  • koubo
  • tts-auto-record
• 端到端产物输出
  • topics.json
  • article.md
  • koubo_script.txt
  • slides.html
  • final_video.mp4
• 可选剪映方案（GitHub 方案）
  • capcut-mate API 适配（用于接入剪映草稿自动化能力）

技术栈

• 后端: FastAPI
• 前端: 原生 HTML/CSS/JS（由后端静态托管）
• 媒体处理: edge-tts + ffmpeg + Pillow
• 部署: systemd + Nginx（阿里云 ECS）

目录结构

sologen/
  backend/
    app/
  frontend/
  skills/
  scripts/
  deploy/
  docs/
  artifacts/

本地启动

1. 安装依赖

cd backend
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. 安装系统依赖（macOS / Linux）

# Linux 示例
sudo apt-get update
sudo apt-get install -y ffmpeg

3. 启动服务

cd backend
uvicorn app.main:app --host 0.0.0.0 --port 8787 --reload

4. 访问网站

http://127.0.0.1:8787

环境变量

参考 .env.example，重点配置：

• SOLOGEN_BASE_URL
• SOLOGEN_OUTPUT_ROOT
• SOLOGEN_CAPCUT_MATE_BASE_URL（可选）

GitHub 方案说明（剪映增强）

本项目接入了 GitHub 开源项目 capcut-mate 的适配层（backend/app/services/capcut_mate_client.py）：

• Repo: https://github.com/Hommy-master/capcut-mate
• 用途: 调用其开放 API，衔接剪映草稿自动化流程
• 方式: 在本系统中作为可选后处理器，不影响主流程可用性

阿里云部署

部署文档见：

• docs/deploy-aliyun.md
• deploy/sologen.service
• scripts/deploy_to_aliyun.sh