BREAKER DELTA
浪尖雷达
总览快速开始看懂站点CLI 参考配置Skill 与 MCPChrome 扩展自建与部署
自建与部署

先记住一条原则:数据归你

引擎仓(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:照它的形状建仓、把数据换成自己的,雷达就是你的了。

GitHub Pages 自动构建怎么跑

  1. 在数据仓的 Settings 里把 Pages 的来源设为 GitHub Actions。
  2. 数据仓的 workflow 做四件事:检出数据仓 → 检出引擎仓 → bun install && bun run bundle 打包 CLI → 用你的数据目录跑 publish 并部署。
  3. 构建时用两个环境变量把站点指向你自己:TS_BASE_URL(你的 Pages 地址)和 TS_DATA_REPO(你的数据仓)。其余 TS_* 见 CLI 参考。
  4. 之后每次往数据仓推数据(比如扫描流程推入新一期),CI 自动重建,站点自动更新,不需要手动部署。

官方实例现在跑在 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 里用它检出。

更新与日常

  • 更新引擎:数据仓 CI 每次都拉引擎的 main 构建,所以引擎发新版后,你的站点下一次重建就自动用上新版;想锁定版本就把 workflow 里的 ref 改成某个 tag。
  • 改配置:只改数据仓里的 config.yaml 并推送,CI 重建后生效;改完去站点的数据源页核对每个源的生效配置。
  • 本地先验:推送前先在本地用同一条 publish 命令构建一遍(见 快速开始),本地能过,CI 基本就能过。
  • 构建失败先看哪一步:检出引擎失败多半是可见性 / 令牌问题;打包失败看 Bun 版本(要 ≥ 1.2);publish 失败先对数据目录跑 doctor。