🎬 AIComics — AI 漫剧自动生成系统

写故事 → 拆镜头 → AI 生成 → 配音 → 发布，全自动一人公司视频工厂

---

🛒 Commercial Releases — Buy on Gumroad

10 products available — AI-animated donghua, production toolkits, handbooks, games, and novels. All instantly downloadable. No DRM. Paid products from $0.99. Use EARLYBIRD50 for 50% off. Use offer codes below for 50% off.

📺 AI Animation (Donghua)

Product	Price	Link
Nine Turns of the Crimson Heavens — Complete Season (Ep 1–12) · 九转丹霄全季	$4.99 → $2.49 with EARLYBIRD50	Gumroad
Nine Turns of the Crimson Heavens — Episode 1 (The Night the Village Burned)	FREE	Gumroad
Starfall Chronicle EP2 — Under the Dome (AI Donghua)	$0.99	Gumroad
Free: 30s White-Label AI Animation Sample (免费样品)	Free	Gumroad

🛠️ Toolkits & Handbooks

Product	Price	Link
Vertical Manhua AI Toolkit · 竖屏漫剧制作工具包	$0.99	Gumroad
AICG Animation Production Handbook · AI 动画工作流手册	$0.99	Gumroad
White-Label AI Animation Suite · 白标AI动画套件	$0.99	Gumroad
Crypto Spread Scanner — Arbitrage Detection	$0.99	Gumroad

🎮 Games & Novels

Product	Price	Link
Starfall Night — HTML5 Arcade Game	$0.99	Gumroad
Nine Heavens Ascension — Xianxia Novel · 九天飞升	$0.99	Gumroad

🔗 Full store: https://chfr1982.gumroad.com 📧 Custom / white-label inquiries: chfr19820610@gmail.com

🎁 Launch Offers (50% Off All Paid Products)

50% OFF any product — Use code EARLYBIRD50 at checkout → works on every paid product (20 uses per product)

Episode 1 is FREE — no code needed, just download → Get Episode 1 →

Free 30s sample — no signup required → Watch now →

⚡ All codes are limited. Don't wait!

👉 Start free, then get the full season

Watch the free 30-second sample — no email required. Then grab Episode 1 for free to see if you like the style.

Want the whole story? The complete 12-episode season is $4.99 — but use code EARLYBIRD50 for 50% off → $2.49 — Get the full season →

Building your own AI animation pipeline? The AICG Animation Production Handbook ($0.99, or $0.49 with EARLYBIRD50) documents the full ComfyUI + Blender + Remotion workflow used to produce every episode. The open-source system you're looking at right now is free; the handbook teaches you how to use it end-to-end.

---

📺 演示

Painterly 3D Noir 风格 (E01)	Painterly 3D Noir 风格 (E03)
E01 · 00:24 · 1280×720	E03 · 01:31 · 1280×720

🎥 5 集完整漫剧已产出 — 《我变成僵尸后全校跪求我别死》全 5 集，每集 6 个分镜，总计 4 分 24 秒 完整视频内容。 风格: Painterly 3D Noir (#1A1A2E #16213E #E94560 #0F3460 #FFD700) 产出路径: state/releases/ · state/produced_videos/

---

✨ 它能做什么

AIComics 是一个全本地运行的 AI 漫剧创作系统。v5.1 已支持从故事到发布的完整管线 + MLLM 智能层 + 质量控制闭环 + Agent 架构：

环节	说明	技术
📝 写剧本	设定世界观、角色、剧情，自动生成分镜脚本	大语言模型
📖 小说导入	小说文本→章节拆分→整季蓝图→分镜计划	import_novel()
🎨 出画面	每个分镜生成动漫风格的关键帧图片 + 角色四视图	ComfyUI + SDXL
🛡️ 防偏移	Drift Gate 检测画面偏离参考图 → PASS/WARN/FAIL	drift_gate.py
🔗 跨集一致	跨集角色一致性检查	consistency_service.py
🔊 配配音	多语言TTS（中/英/日/韩）+ 字幕翻译	Piper TTS + translate_subtitles()
🎬 做视频	多模型路由（动作→Kling/对话→Seedance/远景→Wan）+ FLF插值	VideoRouter + FFmpeg
📡 发平台	YouTube/TikTok/Instagram + 小红书/B站/抖音	international.py + social-auto-upload
🖥️ 桌面端	Electron 桌面应用	desktop/

---

🆕 v5.0 + v5.1 + v5.2 — 30新模块 · 303新测试 · 1357全绿

基于 12 竞品深度调研 + DSH团队 godogen (7K⭐) 方法论对照，分5方向实施。

v5.0 P0 — 修死代码 (5项)

模块	说明
project_initializer.py	template_loader 正确接入项目初始化，填充 style_bible.art_style
character_workshop.py	lora_config 自动生成 LoRA 训练配置（best-effort，不阻塞）
i18n.py	新增 make_llm_callback() 工厂，接 OpenAI 兼容 API，无 key 降级词典
wan_provider.py	182 行完整 IProvider 实现（submit+poll 异步模式，最多轮询 5 分钟）
pyproject.toml + requirements-lock.txt	新增 i18n/tts/publish 三组 optional deps，取消注释 5 个依赖

v5.0 P1 — 质量控制 (5项)

模块	说明
quality_gate.py	ffprobe 视频质量门：分辨率≥720p / 帧率≥24fps / 比特率≥500kbps / 音视频同步
artifact_detector.py	AI 伪影检测：手指/面部/文字/时序/色彩 + VLM 支持，单个 critical 直接 FAIL
auto_retry.py	自动重试：生成→检测→prompt 精炼→provider 切换→重生成
thumbnail.py	FFmpeg 关键帧提取 + Pillow 缩略图网格
web/app.py	FastAPI app：/api/health · /api/drift/check · /api/artifact/check · /api/quality/check

v5.0 P2 — MLLM 智能 (3项)

模块	说明
mllm_storyboard.py	MLLM 故事→结构化分镜引擎，无 API key 时 fallback 到 template
content_anchor.py	Content Anchor 角色记忆：正面/侧面/背影锚点 + 对话记忆 (Gloria CVPR 2026)
smart_router.py	7 维智能路由：质量/速度/成本/稳定性/特性/负载/延迟，自动 fallback chain

v5.0 P3 — 杀手功能 (3项)

模块	说明
autocameo.py	AutoCameo 自拍入剧：VLM 面部特征提取→face prompt→角色替换→ContentAnchor 桥接
audio_avatar.py	TTS 音频→唇形同步+表情动画（7 种情绪），HunyuanVideo-Avatar 风格
orchestrator.py	统一多平台发布编排器：国内(抖音/小红书/B站) + 国际(YouTube/TikTok/Instagram)

v5.0 P4 — Agent 架构 (2项)

模块	说明
director_agent.py	Director Agent：7-agent 编排管线（Script→Storyboard→Character→Image→Video→Quality→Publish）
api_key_manager.py	API Key 统一管理：加密存储 / 轮换追踪 / 配额监控 / 故障转移

v5.1 — Godogen 方法论迁移 (3项)

基于 godogen (7K⭐) 7 条方法论逐条对照，4 条已超过，3 条 gap 补上：

模块	说明	godogen 对照
silent_failure.py	8 类漫剧专属沉默失败检测：唇音不同步/字幕遮挡/跳切违和/运镜穿帮/色调漂移/画幅错误/时间轴偏移/表情僵硬	条目4: 沉默失败陷阱库
cost_dashboard.py	成本仪表盘：累积追踪 + 预算门禁(80%警告/100%拦截) + 按 provider/episode 分拆	条目5: 成本仪表盘
playback_review.py	成片回看自证：播放/节奏/叙事 beat/情绪弧线/分辨率一致性/前置 gate + VLM 审 + 手动审	条目6: 成片回看自证

v5.1 Web API (17端点)

端点	方法	说明
/api/health	GET	健康检查（返回版本号）
/api/drift/check	POST	Drift Gate 偏移检测
/api/artifact/check	POST	AI 伪影检测
/api/quality/check	POST	ffprobe 视频质量门
/api/quality/available	GET	ffprobe 可用性检查
/api/silent-failure/check	POST	沉默失败检测（8 类暗病）
/api/silent-failure/catalog	GET	沉默失败陷阱目录
/api/cost/dashboard	GET	成本仪表盘
/api/cost/budget	GET	预算状态
/api/playback/review	POST	成片回看自证
/api/keys/status	GET	API Key 配置状态

v5.1 实测 — 九转丹霄 E13-E15

用 v5.1 gate 实测现有分镜数据：

集数	SilentFailure	陷阱数	PlaybackReview	回看分
E13	⚠️ SUSPECT (55分)	3 (jump_cut)	✅ PASS	93
E14	⚠️ SUSPECT (40分)	4 (jump_cut)	✅ PASS	93
E15	✅ CLEAN (100分)	0	✅ PASS	93

发现：E13/E14 存在跳切违和（同场景不同地点间缺过渡镜头），E15 干净。所有集 duration_check 扣分（20-21s 太短，期望 >30s）。

测试

• v4.0 基线 1036 → v5.0 1133 → v5.1 1257 → v5.2 1357 passed, 1 skipped, 0 failed（零回归）
• 30 个新模块 · ~9,600 行新代码 · 321 个新测试（135 v5.x + 86 CLI + 82 v5.2 智能层 + 18 v5.2 管线集成）

v5.2 — Jev System One 智能层 (8模块)

蒸馏自 TypeSafe AI Jev (System One) 校准决策方法论。全本地运行，零API依赖。

模块	Jev原语	AIComics应用
calibrated_decision.py	Noul/Choice/Score 三原语	校准概率+置信度替代硬阈值
confidence_gate.py	置信度门控路由	质量门：高→通过/中→复核/低→拒绝
best_of_n.py	Best-of-N仲裁	多候选取最优，替代串行重试
loop_breaker.py	卡死检测	重试循环早停，省生成预算
speculative_fanout.py	并行扇出评估	4检查一次性并行，不串行
model_cascade.py	难度→模型级联	简单→Wan(免费)/复杂→Kling(付费)
guardrail.py	输入输出护栏	prompt送API前检测违禁，省credits
patch_verifier.py	diff验证+语义CI	分镜/配置/角色改动前验证连续性

---

🆕 v4.0 新功能 — 14项升级 · 4优先级 · 1036测试零回归

基于 GitHub 竞品调研 + v3.0 深度审计，补齐断链、防偏移、跨集一致性、发布集成。

P0 — 核心体验

功能	模块	说明
角色四视图	execute_asset_generation	正面/侧面/背面/45° 四视图自动生成
多模型视频路由	VideoRouter.route()	动作→Kling / 对话→Seedance / 远景→Wan
防偏移 Drift Gate	drift_gate.py	check(shots, refs) → PASS/WARN/FAIL + drift_score
多语言TTS+字幕	translate_subtitles()	中→英/日/韩 字幕 + 多语言TTS路由

P1 — 生产力

功能	模块	说明
跨集一致性	consistency_service.py	check_cross_episode_consistency()
发布平台集成	international.py	YouTube/TikTok/Instagram selenium 上传
模板系统	template_loader.py	6题材YAML模板（恐怖/爱情/职场/修仙/悬疑/甜宠）

P2/P3 — 扩展能力

功能	模块	说明
LoRA训练配置	lora_config.py	SDXL角色LoRA训练配置生成
Docker一键部署	7个compose文件	dev/prod/gpu/cpu/comfyui/all-in-one
小说→漫剧管道	import_novel()	小说→章节→整季蓝图→分镜计划
Electron桌面端	desktop/	Electron main + preload 脚手架
☁️ 云端轻量模式	cloud_mode.py	AICOMIC_CLOUD=1 跳过local providers，全走API，镜像<500MB
🏪 社区模板市场	template_market.py	install/uninstall/share/browse/preview 全CLI支持，base64分发

测试

• v3.0 基线 992 → v4.0 1036 passed, 1 skipped, 0 failed（零回归）

---

🆕 v3.0 新功能 — 三线渲染 + 角色一致性 + 视频生成

三线渲染架构 (2D / 2.5D / 3D)

aicomic render --list-modes              # 查看三档就绪状态
aicomic render --mode 2d                 # 2D: ffmpeg Ken Burns
aicomic render --mode 2.5d               # 2.5D: Blender Cycles 赛璐珑
aicomic render --mode 3d                 # 3D: Tripo→Mixamo→cel-shader

功能	模块	说明
三线渲染路由	render/mode_router.py	2D/2.5D/3D三档选择 + 按镜头类型自动路由
2D 渲染线	render/two_d/	ffmpeg Ken Burns zoom/pan + 关键帧插值 (v1.0成熟)
2.5D 渲染线	render/two_half_d/	Blender Cycles赛璐珑材质 + 轨道相机±12° (100/100放行)
3D 渲染线	render/three_d/	Tripo图生3D→Mixamo绑骨→cel-shader渲染 (gate 5/5)
Triple-Lock 角色一致性	image_consistency/triple_lock.py	IPAdapter FaceID(0.75) + ControlNet(0.8) + FaceDetailer(0.4)
多模型视频路由	providers/video_router.py	动作→Kling / 对话→Seedance / 远景→Wan
FLF 首尾帧插值	providers/flf_interpolator.py	首帧+尾帧→模型插值运动，保证shot间连续性
图像管线 + 诊断	image_pipeline/ (8模块)	抠图→生图→放大→合成 + 就绪诊断

---

🆕 v2.0 功能 — 6项扩展（模板/小说/多语言/发布/云/社区）

功能	CLI 命令	Web API	说明
漫剧模板系统	list-templates / template-blueprint --template horror	GET /api/templates	6 题材 YAML 模板（恐怖/爱情/职场/修仙/悬疑/甜宠）
小说→漫剧管道	novel-import --novel-file book.txt --template mystery	POST /api/novel/import	小说文本→章节拆分→整季蓝图→分镜计划
多语言配音&字幕	translate-subtitles --srt-file zh.srt --languages en,ja,ko	POST /api/translate	中→英/日/韩 字幕翻译 + 多语言 TTS 路由 + 翻译记忆库
发布平台集成	publish --video v.mp4 --platforms douyin,xiaohongshu,bilibili	GET /api/publish/status · POST /api/publish/schedule · GET /api/publish/analytics/summary	国内 3 平台 + YouTube/TikTok/Instagram + 定时发布 + 数据回收
云端轻量模式	AICOMIC_CLOUD=1 环境变量	—	跳过 local_providers 全走 API，Docker 镜像 < 500MB
社区模板市场	install-template --url <url> / share-template --name horror	—	模板安装/卸载/分享/在线浏览/预览

模板系统

# 列出所有模板
aicomic list-templates

# 用模板生成蓝图
aicomic template-blueprint --hook "村里老人说，夜里不能回头看井口。" --template horror

# 初始化项目时指定模板
aicomic init-project --name "我的恐怖漫剧" --template horror

# 安装社区模板
aicomic install-template --url <base64-url>

# 分享自己的模板
aicomic share-template --name horror

小说→漫剧管道

# 导入小说→生成整季蓝图
aicomic novel-import --novel-file novel.txt --template mystery --episodes 12 --shots-per-episode 10

发布平台

# 检查就绪状态
aicomic check-publish --platforms douyin,xiaohongshu,bilibili

# 发布视频
aicomic publish --video output.mp4 --platforms douyin,xiaohongshu

多语言

# 翻译字幕
aicomic translate-subtitles --srt-file zh.srt --languages en,ja,ko --output-dir reports/subtitles

当前成品示例： 《我变成僵尸后全校跪求我别死》E01-E05（30 张关键帧 + 30 段配音 + 5 集完整视频）

---

🏗️ 系统架构

graph TB
    subgraph User["🎭 用户层"]
        CLI["CLI 命令行"]
        WEB["Web 创作台<br/>(React SPA)"]
        API["REST API<br/>(FastAPI)"]
        DESKTOP["🖥️ Electron<br/>桌面端"]
    end

    subgraph Core["⚙️ 核心引擎 src/aicomic/"]
        direction TB
        CLI_CORE["cli/<br/>入口 & 命令"]
        CORE_BP["core/<br/>业务逻辑<br/>项目/剧集/分镜/版本"]
        PROV["providers/<br/>Provider 抽象层<br/>ComfyUI / Piper /<br>OpenAI / Seedance"]
        CHAR["characters/<br/>角色系统<br/>一致性/四视图/提示词注入"]
        VIDEO_SYNTH["video_synthesis/<br/>视频合成管线<br/>图片→场景→字幕→配音→合成"]
        IMG_PIPE["image_pipeline/<br/>图像管线+诊断<br/>(8模块)"]
        DRIFT["🛡️ drift_gate<br/>防偏移检测"]
        CONSIST["🔗 consistency_service<br/>跨集一致性"]
        UTILS["utils/<br/>工具函数"]
        CLI_CORE --> CORE_BP
        CORE_BP --> PROV
        CORE_BP --> CHAR
        CORE_BP --> VIDEO_SYNTH
        CORE_BP --> IMG_PIPE
        CORE_BP --> DRIFT
        CORE_BP --> CONSIST
    end

    subgraph Providers["🔌 Provider 插件"]
        COMFY["ComfyUI<br/>✨ 图片生成 (SDXL)"]
        PIPER["Piper TTS<br/>🔊 多语言配音"]
        OPENAI["OpenAI/DALL·E<br/>🎨 备选生图"]
        SEEDANCE["Seedance<br/>🎬 云视频合成"]
        KLING["Kling<br/>🎬 动作视频"]
        WAN["Wan<br/>🎬 远景视频"]
        MANUAL["手动模式<br/>📁 本地资产导入"]
    end

    subgraph V4["🆕 v4.0 扩展"]
        TEMPLATES["📋 template_loader<br/>6题材YAML模板"]
        NOVEL["📖 novel_import<br/>小说→漫剧管道"]
        LORA["🎨 lora_config<br/>角色LoRA训练配置"]
        I18N["🌐 translate_subtitles<br/>多语言字幕"]
        PUBLISH_INTL["📤 international.py<br/>YouTube/TikTok/IG"]
    end

    subgraph Output["📦 产出层"]
        IMAGES["关键帧图片"]
        AUDIO["多语言语音旁白"]
        VIDEO["合成视频 MP4<br/>state/releases/"]
        PUBLISH["发布包<br/>小红书/B站/抖音<br/>YouTube/TikTok/IG"]
    end

    subgraph Automation["🔄 自动循环"]
        VF_LOOP["vf_master_loop<br/>自动生产循环<br/>30分钟/轮"]
        MONEY_LOOP["money_loop<br/>自动变现循环"]
        STYLE_ROTATION["风格轮换<br/>自动切换色板/风格"]
    end

    User --> Core
    Core --> V4
    PROV --> Providers
    Providers --> Output
    Output --> PUBLISH
    VF_LOOP --> Core
    MONEY_LOOP --> Output
    STYLE_ROTATION --> VF_LOOP

Loading

生产管线

flowchart LR
    A["📖 故事蓝图"] --> B["episode_manifest.json"]
    B --> C["build-season-jobs"]
    C --> D["build-provider-requests"]
    D --> E["execute-provider-requests"]
    E --> F["🎨 图片"]
    E --> G["🔊 配音"]
    F --> H["🎬 视频合成<br/>FFmpeg"]
    G --> H
    H --> I["📦 发布包<br/>state/releases/"]

Loading

数据流

sequenceDiagram
    participant U as 用户
    participant W as Web/CLI
    participant C as Core 引擎
    participant P as Provider
    participant F as FFmpeg
    participant O as 产出

    U->>W: 设定故事/角色
    W->>C: 生成分镜脚本
    C->>P: 请求图片生成(ComfyUI)
    P-->>C: 返回关键帧
    C->>P: 请求配音(Piper TTS)
    P-->>C: 返回音频
    C->>F: 合成视频
    F-->>C: MP4 文件
    C-->>O: 发布到平台

Loading

---

🚀 快速开始

前置要求

依赖	版本	用途
Python	3.12+	运行时
ComfyUI	v0.26.0+	AI 图片生成（SDXL 模型）
Piper TTS	latest	中文语音合成
FFmpeg	4.4+	视频合成
Node.js	20+	Web 前端构建（umijs/max）

一键安装

# 1. 克隆仓库
git clone https://github.com/chfr19820610-cell/AIComics.git
cd AIComics

# 2. 创建 Python 虚拟环境
python3.12 -m venv .venv

# 3. 激活环境 & 安装依赖
source .venv/bin/activate
pip install --upgrade pip
pip install -r requirements-lock.txt

# 4. 配置 ComfyUI 路径
#    编辑 config/aicomic_comfyui_paths.yaml，指向你的 ComfyUI models 目录
#    示例：
#   comfyui:
#     base_path: /path/to/ComfyUI
#     models_dir: /path/to/ComfyUI/models

# 5. 初始化演示数据库
PYTHONPATH="src" .venv/bin/python -m aicomic.cli.main init-demo-db

# 6. 启动系统
bash scripts/start.sh

Docker 部署（推荐）

# 一键启动（自动生成 .env.docker.local、local_providers/ 骨架）
bash scripts/start.sh

# 仅核心（不含 ComfyUI/Piper sidecar）
bash scripts/start.sh --no-comfyui

# 手动等效命令（start.sh 的内部实现）
docker compose -f docker-compose.yml build && docker compose -f docker-compose.yml up -d
# ComfyUI/Piper sidecar 需以覆盖层方式组合（独立使用 local-providers 文件会报错）：
docker compose -f docker-compose.yml -f docker-compose.local-providers.yml up -d

# 查看日志
docker compose logs -f

注意：.env.docker.local / .env.production.local 为本地密钥文件（被 .gitignore 排除）。 start.sh 首次运行会自动从 .env.production.example 生成。直接 docker compose up -d 前请确保该文件存在。

启动后访问

服务	地址	说明
创作台	http://localhost:8000/login	Web SPA 前端
API	http://localhost:7860/api/health	FastAPI 健康检查
ComfyUI	http://localhost:8188	ComfyUI Web UI

默认账号：creator / your-password-here

---

📊 当前状态

指标	值
版本	5.2.0
测试通过率	1357/1358 (99.9%)
验证脚本	23/23 (100% 端到端)
API 端点	63 个（含 17 个 v5.x 端点）
视频产出	5 集完整漫剧（4 分 24 秒）
资产完整度	60/60（30 图 + 30 配音）
Python 版本	3.12
许可证	Apache 2.0

---

🧪 运行测试

# 运行全部 1357 个测试
PYTHONPATH="src" .venv/bin/python -m pytest tests/ -v

# 快速模式（跳过耗时测试）
PYTHONPATH="src" .venv/bin/python -m pytest tests/ -q --skip-slow

# 运行特定模块测试
PYTHONPATH="src" .venv/bin/python -m pytest tests/test_p1_quality.py -v
PYTHONPATH="src" .venv/bin/python -m pytest tests/test_v51_godogen.py -v

---

🔄 无限自循环

系统自带轻量后台循环引擎，自动监控生产状态并补充资产：

# 启动生产 + 赚钱循环
PYTHONPATH="src" .venv/bin/python scripts/vf_master_loop.py &

# 查看循环日志
tail -f logs/vf_loop.log

定时任务会被自动发现和补充，无需手动干预。系统支持：

• 风格轮换 — 每轮自动切换色板/视觉风格（Painterly 3D Noir → Hybrid Comic Pop → Cinematic Liquid Glass）
• 资产补充 — 自动检测缺失的图片/音频并排队补充
• 自动发布 — 合成完成后自动打包发布包

---

✨ v1.0.0 核心功能

功能	说明
🧩 供应商抽象层	统一的 Provider 接口，支持 ComfyUI / OpenAI / Seedance / 手动 等多种图片生成后端，可热切换
👤 角色系统	角色定义、一致性检测、提示词注入、参考图管理，让同一角色在不同分镜中保持外形统一
📋 分镜版本管理	分镜可创建多个版本，对比选择最佳效果，支持回滚
🎬 视频合成管线	端到端视频合成：图片→场景→字幕→配音→合成，支持批量处理
🏗️ 声明式管线	YAML 清单定义生产流程，审批门+断点续跑+协调器，管线可编排可中断可恢复
🎨 ComfyUI 真实出图	SDXL 25步 1024×1024 真实出图验证脚本 + Docker 构建代理修复
✅ 1357 测试覆盖	从 314 提升至 1357 测试，覆盖 Provider 抽象层、角色系统、分镜版本管理、管线基础设施、v4.0-v5.2 全部功能（含 Jev 智能层）
🎨 风格轮换引擎	自动轮换视觉风格和色板，每条漫剧可拥有不同艺术风格
🔄 无限自循环	vf_master_loop 后台守护，自动生产+补充+发布，无需人工干预
🐳 Docker 全栈部署	docker-compose 一键启动（前端+后端+PostgreSQL+Redis），支持 local/production 双环境
🌐 Web 控制台	前端 Web UI 管理漫剧生产全流程

---

🗂️ 项目结构

graph LR
    subgraph Root["AIComics/"]
        SRC["src/aicomic/"]
        WEB["web/"]
        CFG["config/"]
        SCR["scripts/"]
        TST["tests/"]
        ST["state/"]
        DSK["desktop/"]
        DOCS["docs/"]
    end

    SRC --> CLI["cli/"]
    SRC --> CORE["core/"]
    SRC --> PROV2["providers/"]
    SRC --> CHAR2["characters/"]
    SRC --> VS["video_synthesis/"]
    SRC --> IMG2["image_pipeline/"]
    SRC --> IC["image_consistency/"]
    SRC --> UTL["utils/"]

    WEB --> BE["backend/ (FastAPI)"]
    WEB --> FE["frontend/ (React SPA)"]

    TST --> T1357["1357 个测试用例"]

    ST --> REL["releases/ (视频产出)"]
    ST --> PV["produced_videos/"]
    ST --> DA["demo_assets/"]
    ST --> GP["generated_projects/"]

Loading

目录	说明
src/aicomic/	核心引擎 — CLI / 业务逻辑 / Provider 抽象层 / 角色系统 / 视频合成 / 图像管线
src/aicomic/image_consistency/	角色一致性 — Triple-Lock + Drift Gate + 跨集检查
src/aicomic/image_pipeline/	图像管线 — 抠图→生图→放大→合成 + 就绪诊断 (8模块)
web/backend/	FastAPI 后端（52 个 API 端点）
web/frontend/	React SPA 创作台
desktop/	Electron 桌面端 (v4.0)
config/	配置文件（ComfyUI 路径、Provider 配置、6题材模板）
scripts/	运维脚本（vf_master_loop、启动脚本）
tests/	1357 个测试用例
state/releases/	已合成的 MP4 视频产出
state/produced_videos/	视频工厂产出目录

---

🛤️ 路线图

• 基础漫剧管线 (故事→分镜→图片→配音)
• CLI + Web API + SPA 三端入口
• 1036 测试全通过
• 供应商抽象层 (ComfyUI/Piper/OpenAI/Seedance)
• 角色系统 (定义/一致性/提示词注入/参考图)
• 分镜版本管理
• 自动风格轮换引擎 + 无限自循环
• v4.0: 角色四视图 + 防偏移Drift Gate + 跨集一致性
• v4.0: 多模型视频路由 (Kling/Seedance/Wan) + FLF插值
• v4.0: 多语言TTS + 字幕翻译
• v4.0: 漫剧模板系统 (6题材YAML模板)
• v4.0: 小说→漫剧管道 (import→split→plan)
• v4.0: 发布平台集成 (YouTube/TikTok/IG)
• v4.0: LoRA训练配置 + Docker一键部署 + Electron桌面端
• v4.0: 云端轻量模式 — AICOMIC_CLOUD=1 环境变量 + Dockerfile.cloud (<500MB)
• v4.0: 社区模板市场 — install/uninstall/share/browse/preview 模板全CLI支持
• v5.0: 修死代码 — template_loader/lora_config/i18n/wan_provider/依赖管理
• v5.0: 质量控制 — ffprobe质量门/AI伪影检测/自动重试/缩略图/FastAPI
• v5.0: MLLM智能 — MLLM分镜引擎/Content Anchor角色记忆/7维智能路由
• v5.0: 杀手功能 — AutoCameo自拍入剧/Audio Avatar唇形同步/多平台发布编排
• v5.0: Agent架构 — Director Agent 7-agent管线/API Key统一管理
• v5.1: Godogen方法论迁移 — 沉默失败检测(8类)/成本仪表盘/成片回看自证

---

🧭 分支说明与开源发布

分支	内容	说明
main	可部署的 AIComics 系统（当前默认分支）	Docker 化 + docker-compose 一键部署 + 前端后端全栈
archive/legacy	早期静态 HTML 视觉小说站（35 个提交）	历史资产保留，仅供追溯参考，不含本系统代码
feat/acom-0.6-p0	ACOM-0.6.0 管线基础设施 + 部署修复	与 main 同 commit（2f35fb4），安全网分支
gh-pages	GitHub Pages 静态站	独立部署分支

说明：公开 main 曾承载一批无关的静态 HTML 页面提交（index.html/v2*.html/ai-vn-game 等）。 为让 AIComics 以可部署系统对外公开，已将含全部部署修复的可部署系统提升为公开 main， 原静态站 35 个提交完整迁移至 archive/legacy 分支保留，未丢失任何历史数据。

⚠️ 部署前提（联网环境）：docker compose build 需要联网拉取基础镜像 （node:18-alpine、python:3.12-slim 等）。首次部署请在有网络的环境执行 bash scripts/start.sh 完成完整镜像构建。

---

📄 许可证

Apache 2.0 © 2026 Eric Chen

---

🤝 贡献

Issues、PR、Discussions 都欢迎！详见 CONTRIBUTING.md。

提交前请确保测试通过：

# 运行测试确认
PYTHONPATH="src" .venv/bin/python -m pytest tests/ -q

⭐ Star History