A-share concept-board main-force fund-flow → vertical short video
一键拉取东方财富概念板块分时主力净流入，渲染 3Blue1Brown 风格竖屏短视频（2K），并自动配乐。
示例成片：examples/FundFlowOverlay_2026-08-10.mp4
| 项目 | Windows | macOS |
|---|---|---|
| Python | 3.10+（勾选 Add to PATH） | brew install python 或官网安装 3.10+ |
| FFmpeg | 下载 并加入 PATH | brew install ffmpeg |
| 字体 | 微软雅黑（系统自带） | 自动用 PingFang SC（苹方） |
| 可选 | — | 若 Manim 缺系统库：brew install pkg-config cairo pango |
没有 Homebrew？先装：https://brew.sh
# 1) 依赖（只需做一次）
brew install python ffmpeg pkg-config cairo pango
# 2) 下载项目
git clone https://github.com/Xiangyahaian/ConceptFlow.git
cd ConceptFlow
# 3) 首次给脚本执行权限，然后双击「一键生成.command」
# 或在终端：
chmod +x 一键生成.command 切换BGM.command
./一键生成.command终端等价写法：
cd ConceptFlow
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
# 先离线低清试跑（推荐第一次）
python run.py --sample --ql --yes
# 拉最新数据出 2K 成片
python run.py --yes成片在：output/<交易日>/FundFlowOverlay_<真实日期>_<时刻>.mp4
Finder 里若双击
.command提示无权限：在终端对项目目录执行一次
chmod +x 一键生成.command 切换BGM.command
- Clone 本仓库并进入目录
- 双击
一键生成.bat（首次自动建虚拟环境并装依赖） - 成片同样在
output/<交易日>/
python run.py # 拉最新数据 → 2K 渲染 → 配乐
python run.py --sample # 离线：内置 2026-08-10 案例
python run.py --yes # 非今日数据时不询问
python run.py --ql # 低清预览（调试用）
python run.py --smooth # 60fps（更丝滑，更慢）
python run.py --no-bgm # 不要背景音乐
python run.py --no-render # 只更新数据，不渲染
python run.py --force-fetch # 强制重新下载 API 数据当前使用的文件：assets/bgm.mp3
- 打开
assets/（Windows：切换BGM.bat/ macOS：切换BGM.command） - 用你的 mp3 覆盖
bgm.mp3 - 再运行
python run.py或一键脚本
备选歌曲可放在 assets/bgm_library/。
ConceptFlow/
run.py # 主入口
boards.json # 跟踪的约 36 个概念板块
requirements.txt
一键生成.bat / .command # Windows / macOS 一键
切换BGM.bat / .command # 打开 assets 换歌
assets/bgm.mp3 # 默认背景音乐
scenes/ # Manim 场景
src/ # 拉数 / 打包 / 配乐 / 日期检查
data/examples/ # 离线案例数据（--sample）
examples/ # 示例成片
output/ # 你的产出（按交易日分子目录，已 gitignore）
boards.json
→ 东财 fflow API
→ data/concept_fflow_major.json
→ Manim 竖屏动画（纵轴自适应）
→ ffmpeg 混入 BGM
→ output/<交易日>/FundFlowOverlay_<产出时刻>.mp4
若接口返回日期不是今天（周末/盘前/延迟），程序会询问是否使用上一交易日；加 --yes 可跳过。
- 文件夹名：数据对应的交易日，如
output/2026-08-10/ - 文件名：你本机产出时的真实日期+时刻，如
FundFlowOverlay_2026-08-11_134500.mp4 - 默认分辨率：1440×2560（竖屏 2K）@ 30fps
编辑根目录 boards.json（保留 code / name 字段）即可增删概念板。
拉数失败 / 连接断开
东财接口偶发拒连。多试几次或换网络；也可先 python run.py --sample 验证渲染链路。
中文变方框（macOS）
默认已用苹方。若仍异常可手动指定：
export FUND_FLOW_CN_FONT="PingFang SC"
# 或: export FUND_FLOW_CN_FONT="Heiti SC"
python run.py --sample --ql --yesmacOS 安装 manim 报错缺 cairo
brew install pkg-config cairo pango ffmpeg
pip install -r requirements.txt渲染慢
2K 正常需要一段时间。调试用 --ql；正式片用默认即可。
数据来自东方财富公开行情接口，仅供学习与个人可视化。请勿高频爬取或商用转售。本项目不构成任何投资建议。