JokeArtist产品系统Vibe Coding

本项目立项旨在解决内容创作者在短视频/公众号图文时代面临的「漫画内容生产效率低、门槛高」问题。传统流程中，一段笑话或段子要变成可发布的漫画作品，需要经历剧本改编、分镜设计、角色设定、逐帧绘制、文字排版、平台发布等多个环节，依赖专业画师和编辑团队协作，单条内容生产周期往往以天计。

行业场景面向自媒体内容运营领域，尤其针对微信公众号漫画类账号的日常运营。业务背景：运营者每天需要产出大量"笑话→漫画"内容以维持日更频率，纯人工创作成本高、产能有限、风格难统一。本项目将大模型文本理解、AI 图像生成、自动排版合成为一条完整流水线，实现"输入一段笑话，自动产出一套角色一致、带对话气泡的 2×3 格漫画长图"，并支持一键发布到微信公众号草稿箱，将单条内容生产时间从数小时压缩到分钟级。

本项目为 AI 笑话漫画生成服务，核心功能模块如下：

1. 故事批量生成模块：用户输入一个主题或笑话种子，系统调用大语言模型（DeepSeek/Volcengine）自动拆解分镜、生成多条结构化漫画故事脚本（含场景描述、角色设定、对话内容），支持并行批量生成（可配置并发数，硬上限 10），自动分批处理超大批量（>20 条自动分批）。
2. 漫画图片生成模块：基于角色参考图保持主角一致性，采用"单次调用生成整张 2×3 漫画"策略，一次 API 调用即产出完整六宫格漫画。图片生成支持火山方舟 Seedream、即梦、SiliconFlow 三套引擎自动回退，确保高可用。
3. 文字合成与排版模块：自动在漫画图片上合成对话气泡、字幕、旁白文字，使用 Pillow + NotoSansCJK 中文字体精确渲染，输出最终可发布的漫画长图。
4. 模板化生成模块：8 个 API 端点覆盖"设计→生成故事→生成图片→发布"全流程模板化操作，支持按故事范围批量操作，支持断点继续。
5. 仿写系列生成模块：给定样例故事与可选截图，自动提取故事风格与画风，生成"画风一致、故事各异、角色各异"的系列漫画，无需角色参考图。
6. 微信公众号发布模块：对接微信公众号 API，支持将生成的漫画一键发布到草稿箱，含公众号多账号管理、发布记录追溯、统计数据采集（阅读/点赞/转发等）。
7. 用户与权限管理模块：基于 Cookie 会话 + ContextVar 的鉴权体系，支持 admin/user 双角色、细粒度页面/操作权限、按用户数据隔离，管理员可跨用户操作。
8. 运行时配置管理模块：前端可动态切换 AI 引擎 API Key、对话模型、图片模型，修改即生效，无需重启服务；提供模型连通性测试接口。

本项目由我独立完成全栈开发，负责的具体任务包括：需求分析与产品定义、系统架构设计、后端全部 API 开发（FastAPI）、AI 能力集成与多引擎适配器开发、图像处理与文字合成引擎开发、前端页面开发（原生 HTML/CSS/JS，无框架）、微信公众号 API 对接、用户鉴权与权限体系搭建、数据库设计与 Repository 层开发、一键部署脚本编写、运维监控方案落地，以及线上生产环境的部署与维护。

技术栈：后端 FastAPI + Python 3.13 + Pydantic + httpx（异步 HTTP）；AI 引擎集成火山方舟（Volcengine doubao-seed 对话模型 + Seedream 图片模型）、SiliconFlow、即梦三套引擎，通过统一适配器模式（UnifiedLLMAdapter）实现多模型自动回退；图像处理使用 Pillow + cairosvg；数据持久化使用 SQLite（线程安全连接单例 + Repository 模式）；前端为原生 HTML/CSS/JS 模块化架构；部署使用 shell 脚本 + rsync 增量部署 + systemd 式监控守护。

架构亮点：① 采用统一 LLM 适配器模式，多模型列表依次尝试 + 异常自动回退，单接口屏蔽底层引擎差异，业务层零感知；② 图片生成采用"整张 2×3 漫画一次 API 调用"策略（singlecall），配合 crop.py 自动裁白边 + 边框强化 + 内容紧缩，大幅减少 API 调用次数和角色不一致风险；③ 故事批量生成支持自动分批 + 槽位并发 + 增量保存，保证最终顺序=批次顺序；④ 运行时配置热更新——数据库覆盖 .env，修改后自动重置适配器单例，免重启生效。