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

先分清两个东西:引擎是代码(抓取、算浪高、生成站点),数据是你的实例自己的东西(每一期、话题台账、战绩、配置)。引擎仓里不存任何实例数据;你跑出来的数据放在你自己的数据目录里。只看公开站点不需要装任何东西,这一页是给要自己跑的人的。

环境要求

  • Bun ≥ 1.2。除此之外没有运行时依赖,不需要数据库、不需要服务器。

第 1 步:拿到引擎并打包

git clone https://github.com/daiyanze/breaker-delta.git
cd breaker-delta
bun install
bun run bundle        # 产出 apps/cli/dist/breaker-delta.mjs(单文件)

后面所有命令都通过这个单文件跑,下文记作 BD:

BD="bun apps/cli/dist/breaker-delta.mjs"

第 2 步:准备数据目录

最快的办法是照着现成的数据仓 daiyanze/breaker-delta-data 的形状建一个自己的目录(或直接克隆它再换成自己的数据)。一个数据目录长这样:

your-data/
  config.yaml        # 你的配置(可从引擎的 config.example.yaml 复制改)
  editions/          # 每一期的结果文件
  state/             # 话题台账、词汇表与 sitemap 基线(程序自动维护)
  track-record.md    # 战绩台账(必看/关注的登记与 14 天复核结果)

第 3 步:自检、抓一期、生成站点

$BD --data-dir /path/to/your-data doctor                    # 离线自检
$BD --data-dir /path/to/your-data scan --edition morning    # 抓一期的候选
$BD --data-dir /path/to/your-data publish --out site        # 生成静态站点
  • doctor 先跑:它离线检查 Node、配置、数据目录和引擎根目录,有问题会直接指出,退出码为 1。
  • scan 只负责确定性抓取:它把候选写到 state/candidates-日期-期次.json 并逐源报告状态。把候选判成必看 / 关注 / 回波是 agent 按方法论做的事(见 Skill 与 MCP),判完用 record 写回台账。
  • publish 把数据目录里的期次和台账生成完整静态站点,输出目录里直接就是可以部署的 HTML。
  • 每个命令都可以加 --json 得到机器可读输出;不带命令直接跑等于 scan。

下一步:用 配置 把信息源和关键词调成你的行业,用 自建与部署 把站点挂到 GitHub Pages 上自动更新。