cs-board README

The project's README from github.com/ChenShuo2004/cs-board. As one markdown file: README.md.

有温度出品｜白板声画工坊

把你的表达，做成一支会说话的视频。

白板声画工坊是一个本地运行的 AI 视频制作工作台。上传一段参考音频、粘贴中文文案，选择视觉模板或提供人物与风格参考，系统会自动完成音色克隆、内容拆解、插画、手绘笔迹、字幕与音画合成，并导出 MP4。

素材、密钥、任务历史和成片默认都保留在本机；同一局域网内的团队也可以共用一条制作队列。

白板动画成片示例

赞助商

秘塔科技 META SOTA MiniMax H3 视频生成 API｜秘塔科技
秘塔科技提供高性价比的 MiniMax H3 视频生成服务：768P 仅 0.09 元/秒，2K 仅 0.15 元/秒。支持原生 2K、音画同步，API 兼容 OpenAI 协议，同时支持 ComfyUI，无需自行部署 GPU。

🎁 通过 cs-board专属链接注册，即可领取赠送额度及专属优惠。

你可以用它做什么

参考音频 + 中文文案 +（可选）风格 / 人物参考
                    ↓
音色克隆 → 内容拆解 → 统一画面 → 动画渲染 → 字幕与音画合成
                    ↓
                 MP4 成片
制作模式 适合什么 你得到什么
标准制作 知识讲解、故事口播、课程宣传 自动拆分分镜，生成插画并绘制白板动画。
自定义参考 固定 IP、品牌视频、系列内容 上传一张风格图和人物参考，让画风与角色贯穿全片。
动态信息图 观点表达、商业分析、课程内容 根据真实旁白时间生成随讲解展开的动态知识卡片。

核心能力

能力 说明
本地音色克隆 接入自己的 IndexTTS Gradio 或 FastAPI 服务，参考音频不离开本机。
12 个视觉模板 从极简白板、国风、手账到赛博霓虹；每个模板都有对应的画面特征和内容建议。
自定义人物与画风 支持 1 张风格参考图，以及最多 5 个角色、每人 1–3 张参考图。
动态信息图 先将旁白对齐为短语时间表，再按真实说话时间逐项呈现内容，避免画面抢跑。
中文重点词 可本地叠加 4–10 字重点短语，避开图片模型生成中文容易乱码的问题；支持一键关闭。
可控成片节奏 支持字幕开关、笔身账号名、4 档线条绘制量，以及每张图承载 1–4 个分镜。
任务复用与恢复 配音、分镜、图片、分段视频与成片均有检查点；调整本地渲染设置时无需重复调用模型。
局域网协作 多台电脑可查看共享队列、进度和历史；个人制作偏好保留在各自浏览器。

视觉模板

选择模板会同时影响插画的配色、线条、材质与构图。预览图展示的是视觉方向；实际人物、物体和场景会随文案变化。

模板 预览 画面特征 推荐内容
极简粗线简笔白板风 极简粗线简笔白板风预览 粗黑线、少量配色、清爽留白 知识讲解、个人表达、复盘总结
极简商务涂鸦风 极简商务涂鸦风预览 几何图表、蓝绿配色、专业克制 产品介绍、商业分析、项目汇报
暖米黄素描白板风 暖米黄素描白板风预览 铅笔排线、纸张质感、温暖细腻 人物故事、个人成长、品牌叙事
粗线扁平国风卡通 粗线扁平国风卡通预览 朱红玉绿、国风纹样、生动平涂 传统文化、国风品牌、中文创意
爆款高热吸睛风 爆款高热吸睛风预览 高饱和、强对比、夸张动势 短视频开场、强观点、热点表达
黑金科技发布会风 黑金科技发布会风预览 黑金光效、科技舞台、高级权威 AI、科技产品、发布会
清新治愈手账风 清新治愈手账风预览 柔和水彩、低饱和配色、生活手账感 情感、生活方式、自我成长
复古报纸拼贴风 复古报纸拼贴风预览 撕纸拼贴、半色调、编辑杂志感 深度观点、文化内容、案例复盘
纸感隐喻拼贴风 纸感隐喻拼贴风预览 手工剪纸、观点隐喻、高级克制 价值观、关系、流程、复杂观点
漫画墨线解释风 漫画墨线解释风预览 漫画墨线、半调网点、概念机制 原理讲解、机制拆解、商业洞察
3D黏土趣味风 3D黏土趣味风预览 黏土材质、玩具比例、温暖可爱 亲子教育、轻量品牌、趣味科普
赛博霓虹漫画风 赛博霓虹漫画风预览 霓虹青紫、漫画速度线、未来感 AI 趋势、数码科技、年轻化观点

模板预览使用 GitHub Raw 地址，避免 README 中的表格图片因相对路径无法渲染。当前前端实际提供 12 个模板；如果你只记得原来的 11 个，新增的是「漫画墨线解释风」。

5 分钟启动

环境要求

先确认音视频依赖可用。

macOS/Linux：

ffmpeg -version
ffprobe -version

Windows PowerShell：

ffmpeg -version
ffprobe -version

Windows

在项目根目录执行一次安装：

python scripts/prepare_env.py
.\.venv\Scripts\python.exe -m pip install -r webapp\requirements.txt
Push-Location web
npm ci
Pop-Location

然后启动工作台：

.\start-webapp.ps1

脚本会启动前后端并打开 http://127.0.0.1:13000/。同一局域网设备也可以通过脚本输出的地址访问。

macOS

先安装 Python 3.11+、Node.js 22.13+、FFmpeg 与 FFprobe。使用 Homebrew 时可以执行：

brew install [email protected] node ffmpeg

在项目根目录执行一次安装：

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

国内网络安装 Python 依赖较慢时，可以只对当前命令使用清华 PyPI 镜像：

PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple python3.13 scripts/prepare_env.py
PIP_INDEX_URL=https://pypi.tuna.tsinghua.edu.cn/simple .venv/bin/python -m pip install -r webapp/requirements.txt

然后启动工作台：

./start-webapp.sh

脚本会启动前后端并打开 http://127.0.0.1:13000/。如果系统没有自动打开浏览器，也可以手动访问该地址。动态信息图首次运行时会按当前平台准备 Remotion 与 Whisper.cpp 所需资源。macOS 14 及更低版本可以启动界面和 API，但当前 Remotion 版本的视频渲染不保证成功。

首次配置

打开右上角的 API 设置，填写并测试以下内容：

  1. OpenLux API Key：只保存在本机 .webapp/config.json，页面不会回显完整密钥。
  2. 文本模型：默认 gpt-5，用于拆解文案、生成分镜或信息图结构。
  3. 图片模型：默认 gpt-image-2，用于生成插画。
  4. 图片接口地址 / 图片 API Key（可选）：留空时图片调用与文本使用同一个服务入口。如果文本与图片来自不同供应商（例如聚合网关只提供 GPT Image），可在这里单独填写图片服务的地址和密钥；两者也可以只填其一，未填写的一项自动沿用上方配置。密钥同样只保存在本机且不回显。
  5. IndexTTS 地址与接口类型：Gradio 通常为 http://127.0.0.1:7860，FastAPI 通常为 8000 端口。

测试连接成功后，上传 10–30 秒、单人且噪声较少的参考音频，粘贴至少 10 个字的中文文案，选择制作模式和视觉模板即可开始。

使用建议

标准制作

适合先快速验证一个内容方向：选择模板，上传音频和文案，系统会将内容拆成场景、生成统一画面并合成白板动画。

自定义参考

适合固定 IP 或品牌化内容：上传一张风格参考图，再添加 1–5 个角色。每个角色可上传 1–3 张不同角度的参考图；系统会按文案安排角色，不会直接复制参考图中的人物。

动态信息图

适合需要“边讲边理解”的内容。系统先依据真实旁白生成短语时间表，再生成章节、核心观点和图文结构；内容元素只会在对应的语音开始后出现。详细原则见 动态信息图语义时间契约。

运行与数据

所有本地配置、任务文件和成片均保存在 .webapp/：

.webapp/
├── config.json          # 本机 API 与语音配置
├── preferences.json     # 兼容旧版偏好
└── jobs/<任务 ID>/       # 音频、分镜、图片、检查点、成片与任务元数据

.webapp/、.env*、虚拟环境、node_modules 与视频产物都已被 Git 忽略。不要在 Issue、日志、截图或提交记录中公开 API Key、参考音频和任务目录；安全问题请按 SECURITY.md 中的方式私下报告。

开发验证

macOS/Linux

# 前端构建与页面验证
(cd web && npm test)

# 后端任务队列、断点恢复与时间线测试
.venv/bin/python -m unittest discover -s tests -v

# Remotion 类型检查
(cd video_renderer && npm run build)

Windows PowerShell

# 前端构建与页面验证
Push-Location web
npm test
Pop-Location

# 后端任务队列、断点恢复与时间线测试
.\.venv\Scripts\python.exe -m unittest discover -s tests -v

# Remotion 类型检查
Push-Location video_renderer
npm run build
Pop-Location

项目结构

├── assets/               # 画笔、视觉风格与参考素材
├── docs/                 # 动态信息图与工作流文档
├── examples/             # 白板动画示例
├── scripts/              # 白板渲染、时间线与维护脚本
├── tests/                # 队列、恢复与语义时间测试
├── video_renderer/       # Remotion 动态信息图渲染器
├── web/                  # React 前端
├── webapp/               # FastAPI 后端
├── start-webapp.ps1      # Windows 一键启动
└── start-webapp.sh       # macOS/Linux 一键启动

贡献

欢迎提交 Issue 或 Pull Request。涉及渲染逻辑的改动，请同时说明真实素材下的时序、遮罩保护和最终成片验证结果。

许可证

本项目采用 MIT License。

cs-board (ChenShuo2004/cs-board)

Searching Database…

778 ·GitHub
Cs-board
这是什么？cs-board（白板声画工坊）是一款本地 AI 工具，把参考语音样本和中文文本变成带旁白的白板风格动画视频，自动完成语音克隆、场景拆解、插画绘制、手绘笔触、字幕和最终 MP4 导出。
这是桌面应用，还是在浏览器里访问？它在本地以 Python/FastAPI 后端加 React 前端的方式运行；启动脚本会同时启动两者并打开界面，所以它的表现像自托管的本地网页应用，而不是原生程序。
怎么让它跑起来？在 Windows 上，在项目根目录运行一次性安装步骤，并用提供的 PowerShell 脚本启动；在 macOS 上，用 Homebrew 安装前置依赖并运行 shell 安装/启动脚本，然后在开始任务前填好你的 API 设置。
生成视频之前需要准备好什么？你需要 Python 3.11+、Node.js 22.13+、PATH 中的 FFmpeg/FFprobe、一个可访问的 IndexTTS 2.5 服务（Gradio 或 FastAPI）用于语音克隆，以及一个 OpenLux API 密钥，且能访问文本模型（默认 gpt-5）和图像模型（默认 gpt-image-2）。
视频渲染在每台 Mac 上都一样吗？不一样 —— UI 和 API 在较旧的 macOS 上运行正常，但基于 Remotion 的视频渲染只在 macOS 15 及以上得到可靠支持；在 macOS 14 及更早版本上，最终渲染不保证成功。
我的参考音频、API 密钥和成品视频都到哪里去了？默认一切都在本地：素材、API 密钥、任务历史和成品视频都保存在你自己的电脑上，OpenLux 密钥只存储在本地配置文件中，且绝不会在屏幕上完整回显。
12 套视觉模板是什么样的？从极简粗线白板、中国水墨风，到赛博朋克霓虹漫画和黏土 3D 风格都有；每套模板都会塑造插画的色彩、线条风格、质感和构图，其中「Comic Ink Explainer」是最新加入的。
动态信息图模式如何避免跑到旁白前面？它先把旁白对齐成短语级的时间表，然后在对应的语音开始之后才展示章节、要点和图形，因此画面永远不会跑在配音前面。
同一网络里的多个人可以共享一个项目吗？可以，同一局域网内的电脑可以查看共享的制作队列、进度和任务历史，而每个人的 UI 偏好只保留在自己的浏览器中。
它如何避免 AI 生成图片中出现乱码中文？它在本地叠加 4-10 个字的中文关键词字幕，而不依赖图像模型去渲染汉字（那样常会出现乱码），并且这个叠加层可以一键关闭。
What are similar projects?dramaclaw, Pixelle-Video, autoclip, printfilm, storycast, video-ai-talking, OpenReels, lanshu-create-ai-presenter-video
Which topics is it in?gpt-5, remotion, gpt-image-2, ai-video, subtitles, voice-cloning, whisper, fastapi, collaboration, tts, ffmpeg, video-generation
Creator
ChenShuo2004
Size
44.1 MB
Stars
778
Updated
CommitOct 01Releasev1.0.0Sep 03
Age
1mo
Commits · 90 Days