◉ Pulse
NanJingSRD avatar
#17 today

NanJingSRD/arc-drama

TypeScript AI

AI漫剧生成平台 — 从小说到成片,一键编排

Created Jul 28, 2026
Stars
12
Today
+12
Forks
0
Quality
75/100
Momentum
16

README

Fetched from GitHub on Oct 30, 2026, 11:08 PM UTC · README.md

View original on GitHub

Third-party content — Open Source Pulse is not the owner of this repository.

This README belongs to NanJingSRD/arc-drama and its contributors. We fetch it directly from the project’s public GitHub repository and display it for reference only. All text, code, images and trademarks remain the property of their respective authors. See the repository for its license terms. Copyright / takedown policy.

ArcDrama

AI 漫剧生成平台 — 从小说到成片,一键编排

Python FastAPI React TypeScript Vite Tailwind CSS License

demo.mp4

🧩 提示词工厂

海量风格一键复制,让创意无缝转化为爆款AI漫剧。

功能模块 截图
风格模板库 视频模板
素材辐射图 图片模板
角色设定 一键复制提示词

✨ 核心能力

能力 描述
🎭 角色一致性 先设计角色形象,后续所有分镜自动引用,跨镜锁脸锁发型
🎬 分镜编排 剧本自动拆解成分镜,支持手动调整机位、运镜、时长
🎨 风格统一 内置 35+ 影视风格(吉卜力、赛博朋克、诺兰、黑泽明等),一键应用到全片
🎥 多供应商视频 内置 SRD、可灵、Grok 等 6 大 AI 供应商,自动路由最优模型
🧵 异步任务队列 生成任务后台排队执行,支持实时进度追踪与失败重试
📤 剪映草稿导出 成片一键导出为剪映草稿,零门槛进入后期剪辑

🔄 工作流程

flowchart LR
    A[📖 小说/剧本] --> B[🎬 创建项目]
    B --> C[🎭 角色设计]
    B --> D[🏞️ 场景设计]
    B --> E[🎁 道具资产]
    C & D & E --> F[📝 剧本分集]
    F --> G[🎞️ 分镜图生成]
    G --> H[🎥 视频生成]
    H --> I[🔧 FFmpeg 合成]
    I --> J[📤 剪映草稿导出]
    H --> K[📊 Token 用量统计]
    K --> L[💰 按量计费]
Loading

🚀 快速开始

前置要求

  • Python >= 3.12
  • Node.js >= 20.19.0
  • pnpm >= 10.0
  • FFmpeg

Docker 部署(推荐)

# 1. 克隆仓库
git clone https://gitee.com/nanjing-srd/arc-drama.git
cd arc-drama/backend

# 2. 配置环境变量
cp .env.example .env
# 编辑 .env,填入你的 AI 供应商 API Key

# 3. 构建并启动
docker build -t arcdrama-backend .
docker run -p 1243:1243 --env-file .env arcdrama-backend

本地开发

后端

cd backend

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

# 安装依赖
pip install -e .

# 启动服务(含异步任务队列 Worker)
python -m ai_anidrama.run

服务启动后访问 http://localhost:1243/health 检查健康状态。

前端

cd frontend

# 安装依赖
pnpm install

# 启动开发服务器
pnpm dev

前端开发服务器默认运行在 http://localhost:5173,通过 Vite 代理自动连接后端。


📦 功能特性

  • 项目管理 — 多项目并行,支持小说/剧本一键导入
  • 角色设计 — 四格布局(胸像 + 三视图),支持风格参考图锁定
  • 场景 & 道具资产 — 独立资产库,支持按项目复用
  • 剧本编辑器 — 可视化分集管理,支持 AI 辅助扩写
  • 分镜工作台 — 拖拽式分镜序列,实时预览画面构图
  • 视频生成 — 接入多供应商,自动选择最优模型与参数
  • 任务队列 — 异步处理生成任务,实时 SSE 推送进度
  • 用量统计 — Token 消耗、视频时长、费用明细一目了然
  • 代理商分销 — 多级代理体系,佣金自动结算
  • 国际化 — 内置中/英/越三语界面

🤖 AI 供应商支持

供应商 文本生成 图像生成 视频生成 配置项
SRD ✅ ✅ — SRD_API_KEY / SRD_IMAGE_API_KEY
Ark(火山方舟) ✅ ✅ ✅ ARK_API_KEY
Dashscope(通义) ✅ ✅ ✅ DASHSCOPE_API_KEY
OpenAI ✅ ✅ — OPENAI_API_KEY
Grok ✅ — — GROK_API_KEY
Kling(可灵) — — ✅ KLING_API_KEY

💬 加入社群

扫码加入微信群或飞书群,获取最新模型上线通知、优惠活动与技术交流。

微信群二维码       飞书群二维码
▲ 左:微信群  |  右:飞书群(如二维码过期请添加微信 zw1568633995)


🏗️ 技术架构

flowchart TB
    subgraph Frontend["🖥️ 前端 — React 19 + Vite 8"]
        F1[React 19 + TypeScript]
        F2[Zustand 状态管理]
        F3[wouter 路由]
        F4[Tailwind CSS v4]
        F5[Vite Dev Proxy]
    end

    subgraph Backend["⚙️ 后端 — FastAPI + DDD"]
        B1[API 层 — 24+ 路由]
        B2[应用层 — DTO / Service]
        B3[领域层 — Entity / Event]
        B4[基础设施层 — SQLAlchemy / 供应商适配器]
    end

    subgraph Worker["🔧 异步任务队列"]
        W1[TaskQueue]
        W2[TaskWorker]
    end

    subgraph AIProviders["🤖 AI 供应商适配器"]
        P1[SRD]
        P2[Ark]
        P3[Dashscope]
        P4[OpenAI]
        P5[Grok]
        P6[Kling]
    end

    subgraph Storage["💾 数据持久化"]
        S1[(SQLite / PostgreSQL)]
        S2[本地文件存储]
    end

    Frontend -->|HTTP / SSE| Backend
    Backend --> Worker
    Worker --> AIProviders
    Backend --> Storage
    Worker --> Storage
Loading

🛠️ 技术栈

层级 技术
后端框架 Python 3.12, FastAPI 0.115+, Uvicorn
数据库 SQLAlchemy 2.0, SQLite (开发) / PostgreSQL (生产)
异步队列 自研 TaskQueue + TaskWorker
视频处理 FFmpeg, Pillow
日志 structlog
前端框架 React 19, TypeScript 5.8, Vite 8
状态管理 Zustand
样式 Tailwind CSS v4, Radix UI, Headless UI
路由 wouter
动画 Framer Motion
拖拽 dnd-kit
国际化 i18next (中/英/越)
测试 Vitest, Testing Library
包管理 pnpm
容器化 Docker

📖 文档


🤝 贡献

欢迎提交 Issue 和 Pull Request!

# 提交前请确保代码通过检查
pnpm check        # 前端:类型检查 + lint + 测试
ruff check .      # 后端:代码风格检查

📄 许可证

本项目采用 MIT 许可证 开源。

Rendered by GitHub from the repository’s README. Scroll to read the full file.
First trending

Jul 29, 2026

first spotted on the list

Best rank

#17

highest position reached

Appearances

1

times on the trending list

Quality score

75

out of 100

Momentum

16

trend strength indicator

Star velocity

0.13

stars per day since creation

Activity — last 60 days

daily counts, collected every 6 hours
  • Stars
  • Forks
  • Merged PRs
  • Issues
  • Closed issues

Collecting activity data since launch — check back in a few days.

Star history

total stars per snapshot

Not enough snapshots yet — check back soon.

Rank history

position on trending · lower is better

Not enough snapshots yet — check back soon.

3D card for your website

Live HTML card with a glass surface and pointer tilt. Paste the iframe on any website.

<iframe src="https://www.notionpulse.cc/embed/NanJingSRD/arc-drama" width="420" height="240" style="border:0;max-width:100%;background:transparent" loading="lazy" title="NanJingSRD/arc-drama — trending on Open Source Pulse"></iframe>

Stars badge

Show current stars in your README or profile. Auto-updates every 6 hours.

NanJingSRD/arc-drama stars badge
Markdown
[![NanJingSRD/arc-drama](https://www.notionpulse.cc/api/badge/NanJingSRD/arc-drama.svg)](https://www.notionpulse.cc/repo/NanJingSRD/arc-drama)
HTML
<a href="https://www.notionpulse.cc/repo/NanJingSRD/arc-drama"><img src="https://www.notionpulse.cc/api/badge/NanJingSRD/arc-drama.svg" alt="NanJingSRD/arc-drama stars badge" /></a>

Repository of the Day

#17 Repository of the Day

Repository of the Week

#17 Repository of the Week

Repository of the Month

#17 Repository of the Month