v0.4.1: OSS skill videos, site version footer, and mail contact.

Host ability demos on Aliyun OSS instead of Pages bundles; add patches-page version label and top-right mailto link; improve spirit bear portrait export.

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

AGENTS.md

@@ -29,8 +29,8 @@ Windows 上的 Dota 2 **天梯选将识别**工具：用 GSI 感知选将阶段
 | `audit_relations.py` | OpenDota+STRATZ 交叉审计 `relations.json`，列出缺失英雄 |
 | `recommend.py` | 分路过滤；按克制/被克制/搭档边打分，输出 Top-3 |
 | `serve_relations.py` | 游戏外关系/物品只读预览（`web/relations/`；改 `data/relations.json`） |
-| `export_relations_site.py` | 导出关系预览为纯静态站点 → `dist/relations/`（data.json 快照 + 前端 + 图片；`--with-videos` 含视频） |
-| `deploy_relations.py` | 一键部署关系预览静态站点到 Cloudflare Pages（导出 + 资产预检 + `wrangler` 直传 + 绑域名；凭据经 keyzoo 注入或 env） |
+| `export_relations_site.py` | 导出关系预览为纯静态站点 → `dist/relations/`（data.json 快照 + 前端 + 图片；`SITE_VERSION` 常量与 `web/relations/config.js` 同步；`--ability-video-base` 写 `config.js` 指向 OSS 技能视频；`--with-videos` 可选本地拷贝视频，生产部署勿用） |
+| `deploy_relations.py` | 一键部署关系预览静态站点到 Cloudflare Pages（导出 + 资产预检 + `wrangler` 直传 + 绑域名；默认 `--ability-video-base` 指向 `climperor` OSS；凭据经 keyzoo 注入或 env） |
 | `_cf_status.py` | 只读查询 Cloudflare Pages 项目 / 部署 / 自定义域名状态（凭据经 keyzoo 注入） |
 | `fetch_hero_portraits.py` | 拉取官网横版头像 → `assets/hero_portraits/`（关系预览） |
 | `fetch_hero_items.py` | 拉取 OpenDota 热门装备 → `data/hero_items.json` + `assets/item_icons/` |
@@ -57,7 +57,7 @@ Windows 上的 Dota 2 **天梯选将识别**工具：用 GSI 感知选将阶段
 | `data/hero_fear_overrides.json` | 英雄→害怕装备手工加减（合并进 item_fears） |
 | `data/hero_abilities.json` | 英雄技能与机制汇总（由 `fetch_hero_abilities.py` 生成） |
 | `data/hero_item_fears.json` | 英雄怕的装备（规则推导；预览「怕」行） |
-| `web/relations/` | 关系只读预览页静态资源（`index.html` / `app.js` / `style.css` / `router.js`） |
+| `web/relations/` | 关系只读预览页静态资源（`index.html` / `config.js` / `app.js` / `style.css` / `router.js`）；`config.js` 含 `SITE_VERSION` 与 `ABILITY_VIDEO_BASE`；版本页底部显示 `v{SITE_VERSION}` |
 | `web/relations/router.js` | Hash 路由：`parseHash` / `serializeHash` / `installRouter` / `syncStateToUrl`；状态↔URL 双向同步（顶层标签 / 英雄 + 子标签 / 物品 / 版本 / 标签筛选 / 搜索） |
 | `templates/cdn/` | 全英雄 CDN 模板（需提交或由脚本生成） |
 | `templates/roles/` / `templates/modes/` | 位置 / 模式辅助模板 |
@@ -68,7 +68,7 @@ Windows 上的 Dota 2 **天梯选将识别**工具：用 GSI 感知选将阶段
 | `assets/item_cat_icons/` | 官网商店分类图标（`itemcat_*.png`，物品页列头） |
 | `assets/ability_icons/` | Steam CDN 技能图标（关系预览；按需缓存）；`innate.png` 先天共用图标；`talent_tree.png` 天赋树触发图标 |
 | `assets/ui_icons/` | dota2.com.cn 通用 UI 图标（`cooldown.png` 等，技能详情底栏冷却图标） |
-| `assets/ability_videos/` | 官网技能演示视频（webm/mp4；勿提交，由脚本拉取） |
+| `assets/ability_videos/` | 官网技能演示视频（webm/mp4；勿提交，由脚本拉取；线上由阿里云 OSS `climperor` 桶 `ability-video/` 前缀托管） |
 
 运行时产物（**勿提交**，见 `.gitignore`）：
 
@@ -122,7 +122,8 @@ python item_fears.py              # 英雄怕的装备
 python fetch_patches.py           # 近一年版本日志 + 详情（版本页）
 python serve_relations.py         # 浏览器只读预览 英雄关系 / 物品商店
 python export_relations_site.py   # 导出静态站点到 dist/relations/（可部署 Pages）
-python deploy_relations.py        # 部署 dist/relations 到 Cloudflare Pages（凭据经 keyzoo 注入或 env；默认 dota2.refining.dev）
+python export_relations_site.py --ability-video-base https://climperor.oss-cn-shanghai.aliyuncs.com
+python deploy_relations.py        # 部署 dist/relations 到 Cloudflare Pages（凭据经 keyzoo 注入或 env；默认 dota2.refining.dev；技能视频走 OSS）
 python _cf_status.py              # 只读查 CF Pages 部署 / 自定义域名状态
 python gsi_setup.py --check
 python gsi_watch.py --once
@@ -138,6 +139,7 @@ python evaluate.py
 - 改 GSI cfg 时同步核对 `gsi_setup.py` 与 Dota `gamestate_integration` 目录。
 - 改预览路由形态（URL 段 / query 参数 / 默认值）时同步 `web/relations/router.js`（`parseHash` / `serializeHash`）与 `app.js` 的 `applyPatch` 校验；新增可路由状态维度时在两处都加，并在 `syncStateToUrl` 调用点（含搜索 debounce）接好。Hash 路由不命中后端，`serve_relations.py` 无需改；`export_relations_site.py` 的导出文件列表须含 `router.js`。
 - 改 `data/heroes.json` 结构时同步 `grid.py`（依赖 `attr` / `name_loc`）；`roles` 供 `overlay.py` 使用；`aliases` 为中文口语/俗称（勿与 `name_loc` 重复），重跑 `fetch_cdn_templates.py` 会按 `key` 合并保留；`tags` 为中文定位（核心/辅助/…/幻象，由 `roles`+幻想系推导），仅关系预览筛选用；基础属性/血蓝等数值字段供关系预览详情条，勿塞机制文案。
+- 发版关系预览时同步 bump `export_relations_site.py` 的 `SITE_VERSION`、`web/relations/config.js` 的同名变量，以及 `index.html` 里 `config.js`/`router.js`/`app.js` 的 `?v=` 缓存戳；并写 `CHANGELOG.md`。
 - 不要重新引入 real 模板双层库、`cdn_penalty`、`build_library.py`。
 
 ## 文档分工