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>

AGENTS.md

@@ -30,7 +30,7 @@ Windows 上的 Dota 2 **天梯选将识别**工具：用 GSI 感知选将阶段
 
 运行时产物（**勿提交**，见 `.gitignore`）：
 
-- `samples/raw/` — 截图
+- `samples/raw/<matchid>/` — GSI 会话截图；手动 `capture.py` 可写在 `raw/` 根下
 - `preview/` — 标定 / sheet 预览
 - `results/` — 每局 JSON
 - `failures/` — `--truth` 调试用错识裁切
@@ -39,7 +39,7 @@ Windows 上的 Dota 2 **天梯选将识别**工具：用 GSI 感知选将阶段
 
 ```
 Dota 2 GSI → gsi_watch.py (:3223)
-              → DraftSession 轮询截屏
+              → DraftSession 轮询截屏 → samples/raw/<matchid>/
               → recognize_image (CDN 模板 + 可选天梯遮罩)
               → roles / grid / modes（辅助）
               → results/draft_*.json + 终端时间线
@@ -48,8 +48,9 @@ Dota 2 GSI → gsi_watch.py (:3223)
 ## 技术约束（修改前必读）
 
 - **合规**：仅 GSI + 屏幕截图；**禁止**读进程内存、注入、绕过 VAC。
-- **GSI 范围**：普通玩家视角拿不到双方 pick；GSI 只作阶段触发与 `team_slot` 等自身信息。
-- **模板策略**：只维护 CDN 层。皮肤问题用会话策略（选人可改判、决策 `allow_revise=False`、best 帧偏 HERO_SELECTION），不要为皮肤加模板库。
+- **GSI 范围**：普通玩家视角拿不到双方 pick；GSI 只作阶段触发、`team_slot`、本人 `hero`。
+- **模板策略**：只维护 CDN 层。皮肤问题用会话策略（选人可改判、决策 `allow_revise=False`、best 帧偏 HERO_SELECTION），不要为皮肤加模板库，也不要复活 real 双层库。
+- **顶栏时机**：皮肤在**全员选完后**才上顶栏；本机进决策时别人可能还在选——须保持 `strategy_tail` 视觉，禁止「一进 STRATEGY 就永久停读」。
 - **坐标**：一律相对坐标（相对屏幕高 / 相对中心），勿写死像素分辨率。
 - **宁可不认，不可乱认**：`min_score` + `min_margin` 双门控；不确定就 `null`。
 - **平台**：面向 Windows；截屏依赖无边框/窗口模式。