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

扩展是雷达的随身版:刷网页时看到可能要火的东西,一键先收下来;打开已经被雷达收录的页面,它直接告诉你浪高多少。扩展的完整独立文档在引擎仓的 apps/extension/README.md(含中文版),这一页是站点内的速查版。

它能做什么

  • 🌀 一键收波:任意页面点工具栏图标,把标题、链接、你选中的文字和一句理由存进本地回波箱。
  • ✓ 收录状态:弹窗顶部直接显示当前页有没有被雷达收录;已收录的显示话题名、浪高、首现日期和话题页链接。
  • 🌊 浪高徽章:在 GitHub / Hacker News / Reddit / X / Product Hunt 五个站,打开命中已收录话题的页面,右下角会浮出浪高卡片,正在破圈的话题带 ⚡。
  • ⚡ 破圈角标:工具栏图标上的橙色数字 = 当前正在破圈的话题数;没有破圈时不显示数字,这是正常的。
  • 🚀 一键投波:点回波旁的「🌀 投波」,会在目标数据仓打开一个新 Issue 页,标题、正文、标签都已填好,你只需在 GitHub 上点提交。不需要 token,扩展也不会替你提交。
  • 📤 导出:整个回波箱可以复制成 Issue 文本,或下载成 JSON 存档。

安装(侧载,开发者模式)

  1. 准备扩展文件夹:最快是用现成的侧载副本;或者在引擎仓根目录跑 bun run --filter @breaker-delta/extension build 自己构建,产物在 apps/extension/dist/。
  2. 打开 chrome://extensions/,打开右上角「开发者模式」。
  3. 点「加载已解压的扩展程序」,选中扩展文件夹。
  4. 把扩展固定到工具栏,收波能少点一次。

改了代码或数据后,要在 chrome://extensions/ 里点扩展卡片上的刷新(↻)才会生效,只关弹窗不会更新。

设置页

从弹窗底部的「⚙ 设置」或扩展的「选项」打开:数据仓(投波投到哪个 owner/repo,默认 daiyanze/breaker-delta-data,也可粘贴完整的 github.com 地址)、实例站点地址(话题链接指向哪、话题与提醒数据从哪拉;跑自己实例的改成自己的地址)、收波后立即打开投波页、投波后是否保留本地副本。设置只存在浏览器本地。

数据从哪来

话题与破圈数据(topics.json / alerts.json)由站点构建时生成、随站点发布。扩展会从设置里的实例站点实时拉取(安装时、浏览器启动时、打开弹窗时各拉一次,设置页可手动强制刷新)并缓存在本地;拉不到时用安装包里自带的快照兜底。全程只有下载,没有后端、没有账号。

权限与隐私(为什么只有三个权限)

  • activeTab:只在你点图标时临时读当前页的标题、链接和选中文字,平时碰不到你的页面。
  • scripting:配合 activeTab 读取选中文字。
  • storage:回波箱只存在你的浏览器本地。
  • 不申请 tabs / history / cookies / 全站权限;从不记录浏览历史;徽章的匹配在本地完成,结果不离开浏览器;没有遥测、没有第三方代码。
  • 投波后回波被标成「投波页已打开」——扩展看不到你是否真的在 GitHub 上点了提交,这个标记只表示页面打开过。很长的摘录会被截断,保证预填链接不超 GitHub 的长度上限。

常见问题

  • 没有浪高徽章:依次查——页面是不是在五个支持站内?话题是不是真的已被收录?数据是不是太旧(去设置页强制刷新)?最后刷新页面。
  • 图标没有角标数字:当前没有破圈话题时就是没有数字,正常。
  • 提示当前页读不了:chrome:// 内部页、应用商店等受保护页面读不了,这是 Chrome 的限制,换普通网页即可。
  • 选中文字没存上:先选中文字再打开弹窗;弹窗里显示「已选中 N 字」才表示会存。
  • 点设置没反应:先在 chrome://extensions/ 点刷新确认版本 ≥ 0.6.1(该版本给设置入口加了兜底:官方接口失败时直接用新标签页打开设置页)。