站点规则与自动捕获

站点规则

站点规则控制 Context Bro 自动捕获哪些网站以及如何捕获。每条规则定义一组域名，拥有独立的模板、端点、捕获模式和去重设置。

手动分享（弹出窗口、快捷键、右键菜单）可在任何域名上使用，不受站点规则限制。

创建规则

1. 进入 设置 → Sites
2. 输入名称（如 “SNS”、“Dev”、“News”）并点击 Add
3. 添加域名模式，选择模板和端点

域名模式

每条规则包含一个或多个域名模式（每行一个）：

模式	匹配
github.com	精确域名
*.github.com	所有子域名（gist.github.com、docs.github.com 等）
news.ycombinator.com	精确子域名

预设

点击预设按钮可快速创建包含一组域名的规则：

预设	域名
Dev	github.com, stackoverflow.com, developer.mozilla.org 等
News	reuters.com, bbc.com, cnn.com, nytimes.com 等
Social	reddit.com, twitter.com, mastodon.social 等
Streaming	twitch.tv, youtube.com

规则绑定模板与端点

每条规则可以绑定特定模板和一个或多个端点。自动捕获触发时，使用绑定的模板并发送到选定的端点。

自动捕获

启用规则上的 Auto-capture 开关，Context Bro 将自动提取并发送页面内容。可选择两种捕获模式：

聚焦时 (Focused Mode)

适合你正在主动阅读的页面 —— 文章、信息流、仪表盘。

行为	说明
触发	你导航到或聚焦匹配规则的标签页
驻留	等待 10 秒确保页面加载完成
捕获	驻留后提取一次内容
定时刷新	可选，按配置的间隔重复提取（详见下方）
停止	当你切换到其他标签页或关闭标签页时

此模式是事件驱动的 —— 仅在你主动查看匹配页面时运行。

标签页打开时 (Any-Tab Mode)

适合后台监控 —— 保持打开的标签页需要定期捕获。

行为	说明
触发	Chrome Alarm 按配置的间隔触发
范围	所有匹配规则模式的已打开标签页
间隔	可配置（分钟或小时）
捕获	每个周期从每个匹配标签页提取内容

此模式使用 Chrome Alarms API，即使标签页在后台也会运行。

定时刷新

定时刷新扩展了聚焦模式，适用于缓慢变化的页面 —— 信息流（HN、Reddit、Twitter）、仪表盘、监控页面，或任何在数分钟到数小时内更新的内容。

不启用定时刷新时，聚焦模式在 10 秒驻留后捕获一次即停止。启用后，只要你停留在页面上，它会按配置的间隔持续重新提取。

配置

定时刷新控件在规则启用 Auto-capture 且选择 聚焦时 模式时显示：

⊙ Auto-capture  [聚焦时 ▾]
  ☑ 定时刷新   [30] [秒 ▾]
  ☑ 去重       [15] [分 ▾]

设置	范围	默认值
刷新间隔	10 秒 – 1 小时	60 秒

工作原理

1. 你聚焦匹配聚焦模式规则的标签页
2. 10 秒驻留后，初始内容被提取并发送
3. 按配置的间隔启动 setInterval 定时器
4. 每次触发重新提取页面内容
5. 去重机制检查内容是否实际发生变化后再发送
6. 切换标签页、导航离开或关闭标签页时定时器停止

定时刷新 + 去重交互

定时刷新与去重协同工作，最大限度减少不必要的 API 调用：

场景	结果
页面未变化，在去重窗口内	跳过 —— 不发送 API 请求
页面内容已变化	发送 —— 检测到新内容
去重窗口已过期（即使内容相同）	发送 —— 作为定期心跳

去重

每条规则有独立的去重开关和可配置的时间窗口。启用后，Context Bro 计算提取内容的 SHA-256 哈希。如果在去重窗口内内容自上次发送以来没有变化，则跳过发送。

设置	范围	默认值
去重窗口	秒、分钟或小时	15 分钟

哈希值存储在本地 chrome.storage.local 中。清除扩展数据或卸载时会删除哈希。