ChenShuo2004/cs-board

视觉模板

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

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

5 分钟启动

环境要求

• Windows 10/11（已提供一键启动脚本）
• Python 3.11+
• Node.js 22.13+
• FFmpeg 与 FFprobe，且已加入系统 PATH
• 可访问的 IndexTTS 2.5 服务（Gradio 或 FastAPI）
• OpenLux API Key，并有文本模型与图片模型的调用权限

先确认音视频依赖可用：

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/。同一局域网设备也可以通过脚本输出的地址访问。

首次配置

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

1. OpenLux API Key：只保存在本机 .webapp/config.json，页面不会回显完整密钥。
2. 文本模型：默认 gpt-5，用于拆解文案、生成分镜或信息图结构。
3. 图片模型：默认 gpt-image-2，用于生成插画。
4. 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 中的方式私下报告。

开发验证

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

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

项目结构

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

贡献

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

许可证

本项目采用 MIT License。