v0.2.0: relations preview, item shop, abilities, overlay recommend, GSI enhancements

- Add relations/item/abilities preview (serve_relations.py + web/relations/)
- Add fetch scripts: hero_items, item_shop, items_meta, hero_abilities,
  ability_videos, patches, stratz, matchups, portraits
- Add overlay.py (role tags + Top-3 cyan marks), recommend.py
- Add http_utils.py, loc_format.py, hero_tags.py, item_fears.py
- GSI: full payload JSONL dump, foreground window detection
- Drop real template library; CDN-only matching
- Update docs: CHANGELOG 0.2.0, DESIGN config table, AGENTS module table
- .gitignore: exclude large regenerable assets (icons/portraits/videos)

DESIGN.md

@@ -122,7 +122,8 @@ GSI 不含可靠 lobby 类型时，用右下金色勋章检测（`has_ranked_ove
 ### 发现五：禁用名单不靠模板
 
 网格按主属性分块 + 客户端本地化名行优先排布；禁用/已选卡片对比度塌陷
-（std 约 8–21 vs 正常 ≥33）。`heroes.json` 需含 `attr` / `name_loc`。
+（std 约 8–21 vs 正常 ≥33）。`data/heroes.json` 需含 `attr` / `name_loc`；
+另含手工维护的中文口语 `aliases`（重拉 CDN 表时合并保留，暂未接入推荐展示）。
 格数对不上时 `ok=False`，不返回残缺名单。
 
 ### 发现六：位置与「我」
@@ -157,13 +158,20 @@ GSI 不含可靠 lobby 类型时，用右下金色勋章检测（`has_ranked_ove
 
 ```
 climperor/
-├── config.json / heroes.json
+├── config.json
+├── data/                        # heroes / relations / items / abilities / fears …
 ├── common.py / recognize.py / draft_session.py
-├── gsi_watch.py / gsi_setup.py
-├── fetch_cdn_templates.py
-├── autocalibrate.py / calibrate.py / capture.py
-├── evaluate.py / roles.py / grid.py / modes.py
+├── gsi_watch.py / gsi_setup.py / overlay.py
+├── recommend.py / relations.py / roles.py / grid.py / modes.py
+├── http_utils.py / loc_format.py / hero_tags.py / item_fears.py
+├── fetch_cdn_templates.py / fetch_hero_portraits.py / fetch_hero_items.py
+├── fetch_item_shop.py / fetch_items_meta.py / fetch_hero_abilities.py
+├── fetch_ability_videos.py / fetch_stratz.py / audit_relations.py
+├── fetch_patches.py / import_relations_xlsx.py / serve_relations.py
+├── autocalibrate.py / calibrate.py / capture.py / evaluate.py
+├── web/relations/               # 关系 / 物品 / 版本只读预览页
 ├── templates/cdn|roles|modes/
+├── assets/                      # portraits / icons / videos（部分 gitignore）
 └── samples/labels.json          # 评测真值；raw/<matchid>/ 见 .gitignore
 ```
 
@@ -182,6 +190,14 @@ climperor/
 | `gsi.strategy_gsi_wait` | 视觉结束后等待本人 GSI 英雄 | 3.0 |
 | `gsi.require_foreground` | 仅当前台为 `dota2.exe` 时截屏识别 | true |
 | `gsi.dump_payloads` | 全量 GSI JSONL 落盘 | true |
+| `recommend.enabled` | 选将 Top-3 推荐 | true |
+| `recommend.top_n` | 推荐数量 | 3 |
+| `recommend.relations_path` | 定性关系文件 | `data/relations.json` |
+| `recommend.role_tags` | 分路→角色标签过滤（1–5 号位） | 见 config.json |
+| `overlay.enabled` | 选将顶栏角色标签悬浮层 | true |
+| `overlay.y_gap_rel` / `icon_h_rel` / `icon_gap_rel` | 标签相对屏幕高的间距与尺寸 | 0.008 / 0.016 / 0.002 |
+| `overlay.mark_size_rel` / `mark_pad_rel` | 网格青标方标尺寸与内边距 | 0.018 / 0.004 |
+| `overlay.rec_color` / `rec_text_color` | 青标底色 / 名次文字色 | `#2ec4b6` / `#0b1220` |
 
 ---
 
@@ -204,14 +220,27 @@ Dota 2 (-gamestateintegration)
 
 ---
 
-## 6. 与 dota2-hex
+## 6. 选将 Top-3 推荐
+
+- **分路**：定位匹配画面字（`roles.py`）+ GSI `team_slot` 定位本人；不做截屏认自己。
+- **关系模型**：机制克制/搭档（`data/relations.json`），不用胜率/场次——版本会变，机制边相对稳。
+- **三视图**：克制（我克谁）/ 被克制（谁克我）/ 搭档；被克制由有向克制边反查。
+- **打分**：候选 +1×克到的敌 / −1×被敌克 / +1×己方搭档；再按分路角色标签过滤。
+- **展示**：网格左上角青色方标 + 名次 1/2/3（区别于 Plus 右上三角）。
+- **预览**：`serve_relations.py` 仿选将网格只读查看；数据手改 `data/relations.json` 或从 xlsx 导入。
+  另有顶级 **物品** 页（基础/升级，网格↔竖式布局），目录见 `data/item_shop.json`。
+- **不做**：避用标、Steam 登录页、爬 Dotabuff；关系**不**写入 `data/heroes.json`。
+
+---
+
+## 7. 与 dota2-hex
 
 独立验证项目。可选：Rust 重写并入，或本地旁路 HTTP 回传。
 合规同 `dota2-hex`：**屏幕可见信息 only**。
 
 ---
 
-## 7. 参考
+## 8. 参考
 
 - [Valve #9562](https://github.com/ValveSoftware/Dota2-Gameplay/issues/9562)
 - [Valve #14915](https://github.com/ValveSoftware/Dota2-Gameplay/issues/14915)（开发者 OCR ≈85%）