Arsvine Realm 概览
Arsvine Realm 是 Arsvine Zhu 的个人作品集与博客网站。视觉上以 post-apocalyptic HUD 风格呈现，技术上是一个自托管的 Next.js 多语言站点，媒体资源走腾讯云 COS，所有博文与 tweet 走外部 GitHub 私有内容仓库，受保护博文走 TOTP 验证 + 签名 cookie 流程。
本节从工程视角拆解 Realm 项目的实现，是给维护者和编码 agent 看的「运行手册」，不是面向访客的产品页。
在哪里
- 仓库：
https://github.com/Arsvine-Realm-Dev-Team/arsvine-realm - 线上：
https://arsvine.com - 文档站：
https://docs.arsvine.com（即本站的Realm章节） - 文档源：
arsvine-realm/docs/— 同一仓库内更短的维护说明
技术画像
本节怎么读
按主题分篇，不分「用户视角」与「开发者视角」：
routes-and-proxy— 路由结构与proxy.ts中间件职责pages-tree—pages/[locale]/...下全部页面与动态路由content-sources— 仓库内data/与外部 GitHub 内容仓库的双层结构protected-posts— TOTP 验证 + 签名 cookie + 静态产物保护不变式api-endpoints— 13 个pages/api/*路由的作用与边界performance-tiers—useAdaptivePerformance的四档自适应与采样规则development— 本地命令、COS Referer 工作流、字体、媒体gotchas— 历史回归点与脆弱约定
阅读顺序建议：先 routes-and-proxy 与 pages-tree 建立物理图，再读 content-sources 与 protected-posts 理解内容流；api-endpoints 与 performance-tiers 按需查阅；gotchas 是任何改动前的必读。