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

CLI 是单个自包含文件 breaker-delta.mjs(打包方法见 快速开始),下文记作 BD。退出码:0 成功,1 运行时错误,2 用法错误。

全局参数(命令前后都可以放)

--data-dir <dir>   数据目录:editions/、state/、track-record.md、config.yaml|json
                   (默认:环境变量 BD_DATA_DIR,否则当前目录)
--config <path>    配置文件(默认:先找数据目录,再找引擎根目录)
--root-dir <dir>   引擎根目录:assets/、favicon-cache/、config.example.*
                   (默认:环境变量 BD_ROOT_DIR,否则自动探测)
--json             机器可读输出:stdout 只输出一个 JSON 文档
--help             显示帮助

命令一览

  • scan [--edition morning|evening] — 跑一期的抓取层,把候选写到 state/candidates-日期-期次.json 并逐源打印状态。不写 --edition 时按本地时间选期次(中午之前算 morning)。不带任何命令直接跑,等于 scan。
  • review — 列出到了 14 天复核期的话题。
  • record <file|-> [--date YYYY-MM-DD] — 把 agent 分好级的话题写回台账。输入是一个 JSON 数组,每条形如 {"name":"话题名","sources":["Hacker News","Reddit"],"grade":"must"},grade 取 must / watch / echo。用 - 从 stdin 读。台账写入是原子的。
  • record review --name <话题> --result hit|miss — 给一个话题登记 14 天复核结果。
  • publish [--out <dir>] [--base-url <url>] [--data-repo <owner/repo>] [--langs zh,en,ja] [--creator|--no-creator] — 从数据目录生成静态站点。命令行参数覆盖 TS_* 环境变量,环境变量覆盖默认值(见下)。
  • docs [--out <dir>] [--docs-url <url>] [--main-url <url>] [--langs zh,en,ja] — 构建独立的文档站(就是本站),只需要引擎根目录,不读数据目录。--docs-url 决定文档站自己的地址(默认 https://docs.breakerdelta.com/),--main-url 是文档里「雷达主页」回链指向的主站地址(默认 https://breakerdelta.com/);环境变量 TS_DOCS_URL / TS_MAIN_URL / TS_DOCS_OUT 同义。
  • doctor — 离线自检 Node、配置、数据目录与引擎根目录;有检查不通过时退出码为 1。
  • mcp — 以 stdio 方式运行 MCP 服务器,提供 radar_scan 与 radar_review 两个工具(见 Skill 与 MCP)。

常用例子

BD="bun apps/cli/dist/breaker-delta.mjs"
$BD --data-dir /path/to/your-data doctor
$BD --data-dir /path/to/your-data scan --edition morning
echo '[{"name":"Some New Model","sources":["Hacker News","Reddit"],"grade":"must"}]' > picks.json
$BD --data-dir /path/to/your-data record picks.json
$BD --data-dir /path/to/your-data record review --name "Some New Model" --result hit
$BD --data-dir /path/to/your-data publish --out site

publish 的环境变量(数据仓 CI 用这一套)

TS_OUT           输出目录
TS_BASE_URL      站点根地址(决定 canonical、sitemap 与分享链接)
TS_DATA_REPO     投波等链接指向的数据仓 owner/repo
TS_LANGS         构建语言,逗号分隔,如 zh,en,ja
TS_CREATOR       1 开 / 0 关:话题页的「创作参考」面板
TS_PAGE_SIZE     海浪榜每页条数(默认 100)
TS_ARCHIVE_DAYS  归档保留天数
TS_SOURCES_PAGE  数据源页每页条数
TS_SHARE         分享平台列表,逗号分隔
TS_DOCS_URL      文档站地址:主站导航的「文档」标签指向它(默认 https://docs.breakerdelta.com/)
TS_MAIN_URL      主站地址:文档站的回链指向它(默认 https://breakerdelta.com/)