准备好这些
- Python 和项目依赖
- 自行配置数据库
- 符合来源数据使用条件
以下步骤以项目当前整理的代码与文档为依据。外部平台和业务系统可能发生变化；完整限制见项目详情。
操作步骤
选择数据库路线
安装 requirements.txt。MySQL 路线配置 prd.env；Doris 路线配置 prd_doris.env。使用自己的测试库并审阅建表与写入规则。
先采集一次
MySQL 可用下面的单次入口；若选 Doris，改用 python doris_main.py --once。先检查少量返回与入库结果。
python main.py --once启动 MySQL 查看器
查看器读取 TOPHUB_DB_* 配置，确认连接到自己的 MySQL 数据库；Doris 不是该查看器的直接数据源。
python -m flask --app viewer/server.py run --host 127.0.0.1 --port 8686筛选与导出
按平台与日期检查结果，再导出所需范围；核对数据时间，历史排名不等同于当前热度。
用案例检查理解
以下为虚构数据与预期操作示例，用于理解流程，不代表真实业务执行结果。
查看「查看示例主题的分布」 ↗常见问题
页面没有数据怎么办？
查看器读取数据库，需要先采集或导入，不附带真实历史库。
相关文件
tophub-2026.10.22-source.zip
查看 SHA256 校验值
da9ce72613cef02138104c06a2fe19cb5412433ded06759fa30d896a2740d229公开包不含数据库、历史热榜明细、日志、通知机器人配置和原始环境文件。Doris 路线需按源码的 DORIS 配置项另行配置。