Document match-scoped sample paths and draft-session timing lessons.

Capture the prototype findings on top-bar skins, strategy_tail polling, and why CDN-only plus session policy is enough without a real template library.

Co-authored-by: Cursor <cursoragent@cursor.com>

README.md

@@ -34,6 +34,7 @@ python gsi_watch.py
 ```
 
 进入英雄选择后自动跟踪；凑齐 10 人或超时后写出 `results/draft_<时间戳>.json`（该目录已 gitignore）。
+会话截图按对局落在 `samples/raw/<matchid>/`。
 
 > 主菜单收不到 GSI 是正常的：客户端**第一次载入对局后**才开始推送。看到 `[gsi] connected` 才算链路通。
 
@@ -46,21 +47,22 @@ python capture.py                # 单张 → samples/raw/
 python capture.py --loop 300 3   # 每 3 秒一张，持续 300 秒
 ```
 
+GSI 跟踪时自动写入 `samples/raw/<matchid>/draft_*.png`（含 milestone / best）。
 需无边框窗口或窗口模式（独占全屏可能黑帧）。
 
 ### 标定 ROI（一次性）
 
 ```powershell
-python autocalibrate.py samples/raw/<某帧>.png
-# 失败时退路：python calibrate.py samples/raw/<某帧>.png
+python autocalibrate.py samples/raw/<matchid>/<某帧>.png
+# 失败时退路：python calibrate.py samples/raw/<matchid>/<某帧>.png
 ```
 
 ### 识别 / 评测
 
 ```powershell
-python recognize.py samples/raw/<帧>.png
-python recognize.py samples/raw/<帧>.png --sheet
-python recognize.py samples/raw/<帧>.png --truth hero1,...,hero10
+python recognize.py samples/raw/<matchid>/<帧>.png
+python recognize.py samples/raw/<matchid>/<帧>.png --sheet
+python recognize.py samples/raw/<matchid>/<帧>.png --truth hero1,...,hero10
 python evaluate.py              # 按 samples/labels.json 批量评测
 ```
 
@@ -70,7 +72,7 @@ python evaluate.py              # 按 samples/labels.json 批量评测
 
 - PNG、原始分辨率（勿经聊天工具压缩）
 - 顶栏 10 个英雄完整可见
-- 优先选人阶段默认脸帧（皮肤尚未上顶栏）
+- 优先选人阶段默认脸帧（全员选完后顶栏才会换皮肤；GSI 无「皮肤已加载」信号）
 
 ## 已知限制
 
@@ -78,6 +80,8 @@ python evaluate.py              # 按 samples/labels.json 批量评测
 - 客户端改网格排序后 `grid.py` 会 `ok=False`，不会瞎报禁用名单
 - 新英雄上线后重跑 `fetch_cdn_templates.py`
 - 位置文字模板取自简体中文客户端
+- 决策界面 3D 模型挡住顶栏时单帧会很弱，依赖会话多帧回填
+- 普通玩家 GSI 只有自己的英雄 id，不能代替读顶栏
 
 ## 相关项目