地理与可见性

Realm 把 Vercel 边缘的地理信号写到客户端 cookie，驱动 B 站等 region-only UI 微调。不用于语言选择、权限、限流。

proxy.ts 的 GEO_COUNTRY 写入

// proxy.ts
const GEO_COOKIE = 'GEO_COUNTRY';
const GEO_COOKIE_MAX_AGE = 60 * 60 * 12; // 12h
const GEO_OVERRIDE_PARAM = '_geo';

解析顺序：

URL ?_geo=US 显式覆盖（dev 调试 / 切 VPN 后强制刷新）
- ?_geo= 空值 → 清除覆盖
- 非两位字母 → 忽略，按未覆盖处理（但仍清 cookie）
Vercel 边缘 geolocation(request).country（大写两位）
已有 GEO_COUNTRY cookie（兜底）

返回 { country, overrideAction: 'set' | 'clear' | 'none' }，attachGeo() 据此写 cookie：

_document 内联脚本读 cookie 写 <html data-country="US">（或当前两位码）。hydration 之前同步执行，所以首屏 CSS 就能基于这个属性切换。

lib/region-visibility.ts 是统一 helper：

import { isRegionVisible } from '@/lib/region-visibility';
isRegionVisible('BILIBILI_BLOCKED')  // 返回 boolean

B 站嵌入 / 友链 / 联系方式等 region-only 内容都走这个 helper，不直接读 cookie / window。

旧版本（PROBLEM 注释里有记录）尝试在 SSG/ISR 共享缓存层通过 x-geo-country 请求头把 country 注入下游 SSR。但 Vercel CDN 缓存会跨访客复用，第一访客的 country 会污染整段缓存窗口，导致 B 站等 region UI 漂移到错误区域。

现方案是只在客户端使用 country。SSG 产物不带任何 country 信号，由客户端 bootstrap 脚本读 cookie 写 <html> 属性。这样：

@vercel/functions 的 geolocation(request) 在 Vercel 环境之外没有数据，会返回空 country。此时：

非 Vercel 部署如果需要 region 数据，需要在 proxy.ts 里替换 geolocation(request) 为等价数据源（CDN header、MaxMind GeoIP2 等），并改 lib/region-visibility.ts 配合。