ChenShuo2004/cs-board

📽️ cs‑board – 本地 AI 白板视频制作工作台

一句话概括

把中文文案、参考音频和可选的风格/人物素材，一键转成配音、插画、手绘笔迹、字幕和音画同步的 MP4 白板动画。

---

🎯 核心定位

• 本地运行 – 所有音频、模型调用和生成的素材都保存在本机，隐私安全。
• 端到端流水线 – 从音色克隆 → 文本拆解 → 插画生成 → 手绘动画 → 字幕/合成 → 导出 MP4，全部自动化。
• 可选云服务 – 通过 MiniMax H3、OpenLux 等兼容 OpenAI 协议的 API 调用文本和图片模型，也可以自行部署 IndexTTS（Gradio/FastAPI）进行本地音色克隆。
• 局域网协作 – 多台电脑共享同一制作队列，团队可在同一网络下协同工作。

---

🛠️ 主要功能

功能	说明
本地音色克隆	接入自建的 IndexTTS 服务，参考音频不离开本机，实现人物/品牌专属配音。
12 种视觉模板	从极简白板到赛博霓虹、国风卡通、3D 黏土等，每种模板自带配色、线条风格和构图建议。
自定义人物/画风	最多 5 位角色，每人 1‑3 张参考图，或上传 1 张整体风格图，系统在全片保持统一风格。
动态信息图	根据旁白的真实时间轴生成逐句出现的知识卡片，避免画面抢跑。
中文重点词叠加	本地渲染 4‑10 字的中文关键短语，规避常见的中文乱码问题，可随时关闭。
可控节奏	开关字幕、调节笔触粗细、选择 4 档绘制量、每张图容纳 1‑4 个分镜，灵活控制视频节奏。
任务复用/恢复	配音、分镜、图片、视频段落都有检查点，修改本地渲染设置时无需重新调用模型。
局域网协作	同一局域网内的机器可查看共享队列、进度和历史记录，个人偏好保存在各自浏览器。

---

🚀 快速上手（5 分钟启动）

1. 准备环境 – Windows 10/11、macOS 15+、Python 3.11+、Node 22.13+、FFmpeg/FFprobe 在 PATH 中。需要可访问的 IndexTTS 2.5 服务和 OpenLux API Key（文本+图片模型权限）。
2. 安装 (以 macOS 为例)

   brew install python@3.13 node ffmpeg
   python3.13 scripts/prepare_env.py
   .venv/bin/python -m pip install -r webapp/requirements.txt
   (cd web && npm ci)
   

3. 启动

   ./start-webapp.sh   # Windows 使用 start-webapp.ps1
   

   浏览器自动打开 http://127.0.0.1:13000/。
4. 配置 API – 在右上角 API 设置 填入 OpenLux API Key、文本模型（默认 gpt-5）、图片模型（默认 gpt-image-2）以及 IndexTTS 地址。点 Test 确认连通。
5. 创建视频 – 上传 10‑30 秒的参考音频、粘贴中文文案、选择制作模式（标准/自定义/动态信息图）和视觉模板，点击 开始 即可。

---

📚 适用场景

模式	推荐使用情境
标准制作	知识讲解、故事口播、课程宣传 – 自动拆分分镜、生成插画并绘制白板动画。
自定义参考	品牌视频、固定 IP、系列内容 – 上传风格图和角色参考，实现统一人物与画风。
动态信息图	商业分析、观点表达、课程内容 – 旁白同步出现的动态卡片，帮助观众“边听边懂」。

---

📁 项目结构概览

assets/          # 画笔、模板素材
docs/            # 动态信息图工作流文档
examples/        # 演示 GIF/视频
scripts/         # 渲染、时间线、维护脚本
tests/           # 单元/集成测试
video_renderer/  # Remotion（React‑based）视频渲染器
web/             # React 前端
webapp/          # FastAPI 后端
start‑webapp.*   # 一键启动脚本（Windows/Unix）

---

🧪 开发/测试指南

• 前端：(cd web && npm test)
• 后端任务队列与断点恢复：python -m unittest discover -s tests -v
• Remotion 类型检查：(cd video_renderer && npm run build)

---

🤝 贡献与许可证

• 贡献 – 提交 Issue 或 Pull Request，涉及渲染逻辑的改动请提供真实素材下的时序、遮罩和成片验证。
• 许可证 – MIT License.

---

📢 赞助商

MiniMax H3 视频生成 API（秘塔科技）提供低价 768p/2K 视频生成，兼容 OpenAI 协议并支持 ComfyUI，使用专属链接可领取额度。

---

简而言之：cs‑board 把「文字+声音」变成「手绘白板动画」的全链路工具，适合个人创作者和小团队在本地快速产出高质量中文视频，且支持自定义风格和局域网协作。