引擎仓(daiyanze/breaker-delta)只放代码,永远不放任何实例采集到的数据。你的每一期、台账、战绩和配置都放在你自己的数据仓里,由数据仓的 CI 拉取引擎来构建、部署到数据仓自己的 GitHub Pages。这样换引擎版本不会动你的数据,公开你的站点也不等于公开你的仓库结构之外任何东西。
your-data-repo/ editions/ # 每一期 state/ # 台账、词汇表、sitemap 基线 track-record.md # 战绩台账 config.yaml # 你的配置(可选;没有就用引擎示例) .github/workflows/pages.yml # 构建并部署到本仓 Pages
现成的参照是 daiyanze/breaker-delta-data:照它的形状建仓、把数据换成自己的,雷达就是你的了。
官方实例现在跑在 Cloudflare Pages 上(项目直连仓库、推送自动构建):主站项目连数据仓、构建时 clone 引擎仓,文档项目连引擎仓直接构建,两个项目各绑各的域名(breakerdelta.com 与 docs.breakerdelta.com)。构建命令与上面 GitHub Actions 版完全一致,只是执行方从 GitHub 换成 Cloudflare;自建实例两个平台任选其一即可。
官方站点的域名分工是固定的:主站住根域名(breakerdelta.com —— 榜单和话题页是公开内容,吃分享与搜索,根域名最干净);文档是独立站(docs.breakerdelta.com —— 就是本站,由单独的 docs 仓用 docs 命令构建部署,不和主站挤同一个构建,主站导航里的「文档」只是链过来);app. 子域名预留给将来需要登录的产品,现在不用。自建实例想用自己的域名同理:把 TS_BASE_URL 换成你的根地址即可,文档站可以链到官方 docs,也可以跑 docs 命令自建一份。
数据仓 CI 用的是它自己的默认令牌,读不了私有仓。如果引擎仓被设成私有,数据仓的构建会在「检出引擎仓」这一步直接失败(repository not found),站点随之停更——包括扫描推数据后触发的自动重建。两个解法:把引擎仓保持公开(最简单),或在数据仓的 Secrets 里放一个能读引擎仓的只读令牌并在 workflow 里用它检出。