# Changelog

本文件记录 **上分帝（Climperor）** 的用户可见变更。格式参考 [Keep a Changelog](https://keepachangelog.com/)。

## [Unreleased]

### Added

- GSI 全量落盘：默认把每包 POST 追加到 `samples/raw/<matchid>/gsi.jsonl`
 （`gsi.dump_payloads` / `--dump-gsi` / `--no-dump-gsi`）。

### Changed

- 项目定名：**上分帝** / **Climperor**（目录 `climperor`），由 `dota2-draft-vision` 迁出独立仓库。
- **放弃 real 实拍模板库**：删除 `build_library.py`、`templates/real/`；匹配仅使用 CDN 层。
- 移除 `match.cdn_penalty` 与 `evaluate.py --cdn-only`（双层库对比已无意义）。
- 模板加载 API 简化为 `(hero_key, image)`。
- GSI 会话截图按对局写入 `samples/raw/<matchid>/`。
- 运行产物纳入 `.gitignore`：`preview/`、`results/`、`failures/`、`samples/raw/`。
- 文档拆分为 `README`（操作）、`DESIGN`（决策）、`AGENTS`（协作）、`CHANGELOG`（变更）。
- `DESIGN.md` / `AGENTS.md` 补录原型会话结论：顶栏皮肤时机、决策禁改判原因、
  real 库审计结论、无法靠 GSI 卡「皮肤前」单帧等。

### Removed

- real 库补充流水线与相关验收指标。
- 仓库内历史 `preview/`、`results/` 调试产物。

### Fixed

- （继承自原型）CDN 头像按顶栏窗口裁切，而非中心正方形；CDN-only 即可高准确率。
- （继承自原型）天梯段位条 / 勋章遮罩匹配；选人多帧 + 决策禁改判规避皮肤；
  best 帧优先选人阶段；本人英雄以 GSI 覆盖。

## [0.1.0] - 2026-07-25

### Added

- 决策时间顶栏 10 格模板匹配识别。
- 相对坐标 ROI、自动标定（玩家颜色条）。
- Steam CDN 全英雄模板拉取（`fetch_cdn_templates.py`）。
- GSI 触发的选将会话跟踪（`gsi_watch.py` / `draft_session.py`）。
- 位置文字、禁用网格、模式字辅助识别。
- 天梯 UI 遮罩与会话层皮肤策略。