这是一个用于记录和分析2026年KPL（王者荣耀职业联赛）预测的项目。通过结构化数据存储和自动化工具，帮助您追踪预测准确率、分析预测模式，并随着赛季进展不断优化。

kpl-2026-prediction-log/
├── data/                    # 核心数据存储
│   ├── predictions.xlsx    # Excel格式的预测记录（主数据源）
│   └── predictions.json    # JSON格式的预测记录（备份/程序接口）
├── scripts/                # 数据处理脚本
│   ├── convert_xlsx_json.py # XLSX与JSON相互转换工具
│   └── analyze.py          # 数据分析与统计脚本
├── gui/                    # GUI应用程序
│   ├── app.py             # 主程序
│   └── requirements.txt   # 依赖包
├── archives/              # 存档文件（截图、备忘等）
└── README.md              # 项目说明

确保已安装 Python 3.8+ 和以下依赖：

pip install pandas openpyxl tkinter

打开 data/predictions.xlsx，按照以下字段填写预测记录：

字段名	说明	示例
id	唯一标识符	20260301-01
date	比赛日期	2026-03-01
stage	赛事阶段	常规赛第二轮S组
team_a	队伍A	成都AG超玩会
team_b	队伍B	武汉eStarPro
predicted_winner	预测胜者	team_a
predicted_score	预测比分	3:1
confidence	信心指数（1-5）	4
odds	盘口赔率（可选）	1.85
reason	预测理由	AG近期状态火热
actual_winner	实际胜者（赛后填写）	team_a
actual_score	实际比分（赛后填写）	3:0
status	状态（pending/correct/wrong）	correct

运行 GUI 应用程序进行可视化录入：

cd gui
python app.py

将 Excel 数据转换为 JSON 格式（或反之）：

python scripts/convert_xlsx_json.py --to-json   # XLSX → JSON
python scripts/convert_xlsx_json.py --to-xlsx   # JSON → XLSX

运行分析脚本查看统计结果：

python scripts/analyze.py

• id: 格式为YYYYMMDD-序号，确保每条记录唯一
• date: 比赛日期，ISO格式（YYYY-MM-DD）
• stage: 赛事阶段（常规赛、季后赛、总决赛等）

• team_a / team_b: 对战双方队伍名称
• predicted_winner: 预测获胜方（team_a 或 team_b）
• predicted_score: 预测比分（如"3:1"）
• confidence: 信心指数，1-5分（1=不确定，5=非常确定）
• odds: 赛前盘口赔率（可选，用于评估预测价值）
• reason: 简短预测理由，记录关键判断依据

• actual_winner: 实际获胜方（team_a 或 team_b）
• actual_score: 实际比分
• status: 预测状态
  • pending: 比赛未开始或未结束
  • correct: 预测正确（胜者正确）
  • wrong: 预测错误（胜者错误）

• 总预测场次、正确场次、准确率
• 按信心指数分组的准确率
• 按赛事阶段分组的准确率
• 按比分类型分组的准确率

• 预测赔率与实际收益模拟
• 版本周期与预测准确率关联
• 队伍对阵预测模式分析
• 时间序列上的准确率变化趋势

在 .github/workflows/update_stats.yml 中配置自动化工作流：

1. 每天自动从 Excel 文件生成统计数据
2. 更新 README.md 中的胜率看板
3. 生成可视化图表并提交到仓库

2026 KPL 预测战绩看板
----------------------------------------
📊 总战绩：45胜 / 68负 | 准确率：66.2%
📈 最近10场：7胜3负 | 准确率：70.0%
🎯 高信心预测（4-5分）：82.5% 准确率
⏰ 赛季进度：常规赛第3周 / 共12周
----------------------------------------

1. 数据备份: 定期提交到 Git 仓库，利用版本控制追踪预测变化
2. 数据一致性: 修改数据时，确保 Excel 和 JSON 文件同步更新
3. 扩展性: 可根据需要添加更多分析维度（如选手状态、BP策略等）
4. 隐私性: 如涉及真实投注记录，请注意数据安全

欢迎提出改进建议！如果您有新的分析维度或功能需求，请提交 Issue 或 Pull Request。

---

目标: 通过系统化记录与分析，提升对 KPL 赛事走向的理解和预测能力，享受数据驱动的观赛乐趣！

最后更新: 2026年1月