football_odds_project 给 ChatGPT 的项目说明

生成时间：2026-06-10 08:36:06（北京时间）

这是一份给 ChatGPT 读取的项目交接说明。它不是完整开发文档，而是当前可执行事实摘要。完整历史仍以 PROJECT_MEMORY.md 和 docs\PROJECT_HISTORY.md 为准。

1. 项目目标

• 项目路径：D:\football_odds_project
• 当前目标：围绕中国体彩竞彩足球、外部盘口、赛果和复盘，生成小红书文章用概率看板。
• 短期重点：服务美加墨世界杯相关国家队比赛文章输出。
• 长期目标：积累五大联赛、欧冠、国家队和历史盘口数据，为 XGBoost 等模型做准备。
• 当前不做：自动投注、投注平台账号操作、真实购买建议、付费数据强依赖。

2. 当前数据源

• 体彩：竞彩足球可售比赛、胜平负、让球胜平负、赛前快照。
• 懂球帝：欧盘、亚盘、大小球、凯利指数。
• 赛果：本地赛果采集入库，用于自动复盘。
• FIFA / Elo：国家队强弱评分辅助。
• 国家队历史：国家队历史赛果、近况、Football-Data 世界杯/世预赛历史欧赔参考。
• xG / G-xG：StatsBomb Open Data，作为国家队进攻/防守质量辅助，不替代盘口。

3. 当前核心算法

• 文章最终结论融合器：所有模块先转成证据，最后只输出体彩胜平负结论和体彩让球胜平负结论。
• 胜平负：以体彩胜平负、外部欧赔共识、比分分布为主，风险模块只降低表达强度。
• 让球胜平负：强结论必须同时满足概率、领先幅度和至少 3 类证据不冲突；否则只输出“倾向 X，防 Y”，且 Y 只能是一个让球方向。
• 比分分布：使用盘口约束比分分布，大小球约束总进球，亚盘约束净胜球，体彩让球约束让球结果。
• 概率校准：使用 Brier、LogLoss、分桶校准、小样本观察提示。
• 11角色：已经从“11 个观点”改成“11 个可复盘审查器”，只做证据、约束、背景修正和风险审查。
• 国家队历史盘口参考：只能作为校准和风险层；模拟让球/大小球必须标注为结果推导参考，不能冒充真实盘口。

4. 当前看板和公开链接

• 在线首页：https://football-odds-dashboard.pages.dev/
• 项目说明：https://football-odds-dashboard.pages.dev/chatgpt_project_brief.html
• 文章概率看板 v4：https://football-odds-dashboard.pages.dev/article_probability_v2.html
• 自动复盘总线：https://football-odds-dashboard.pages.dev/auto_review_dashboard.html
• ChatGPT 提示词：https://football-odds-dashboard.pages.dev/chatgpt_prompt.txt
• 单场页面：https://football-odds-dashboard.pages.dev/match_pages/

本地关键输出：

• data\exports\article_probability_v2.html
• data\exports\article_probability_v2.csv
• data\exports\auto_review_dashboard.html
• data\exports\auto_review_match_detail.csv
• data\exports\hhad_match_review.csv
• data\exports\role_effectiveness_report.html
• data\exports\national_history_calibration_v4_report.html

当前统计：

• 文章看板比赛行数：59
• 文章分析明细行数：59
• 自动复盘明细行数：1028
• 自动复盘模块数：13
• HHAD 复盘行数：59
• 角色有效性行数：11
• 国家队历史校准行数：66

5. ChatGPT 使用方式

如果要写某场小红书文章，优先给 ChatGPT 单场页面链接，并要求它只基于页面顶部短摘要和展开证据写文章。

推荐提示词：

请先读取项目说明：
https://football-odds-dashboard.pages.dev/chatgpt_project_brief.html

然后读取这场比赛的单场页面：
把这里替换成 match_pages 里的单场链接

请基于胜平负最终结论、让球最终结论、最大风险、4 个比分方案、核心证据摘要和复盘状态，写一篇小红书风格文章。
不要写购买建议，不要写确定性命中表达，只写概率倾向、盘口矛盾和风险提示。

6. 后续调整原则

• 新增数据源：必须说明是否免费、是否授权、是否可公开、是否可训练。
• 新增特征：必须区分赛前特征和赛后复盘字段，避免未来函数。
• 新增算法：必须接入自动复盘总线，不能只在看板里发表观点。
• 新增中文字段：业务层优先登记 canonical key，不直接依赖中文表头。
• 新增让球判断：必须使用 HHAD_WIN / HHAD_DRAW / HHAD_LOSS 内部枚举，再输出中文。
• 新增公开文件：不得包含数据库、API Key、cookie、token、私密 raw JSON、浏览器缓存和 debug 私密文件。
• 样本不足：必须标记“观察级”，不能写成稳定规律。

7. 表达边界

• 可以写：概率倾向、盘口分歧、市场一致性、最大风险、观察级结论。
• 不要写：确定命中、收益承诺、购买指令、自动投注建议。
• 文章服务内容分析，不服务实盘执行。

8. 当前版本锚点

• 最新 Git 提交：0209117 chore: add encoding normalization and canonical fields
• 算法收敛标签：checkpoint-2026-06-10-algorithm-convergence-v1
• 编码治理标签：checkpoint-2026-06-10-encoding-normalization-v1

如果 ChatGPT 对项目上下文不确定，应先读本文件，再读单场页面，不要根据泛泛足球经验改写项目规则。