浏览器扩展通过 Service Worker 监听浏览器活动，仅在窗口聚焦且用户活跃时记录当前标签页会话，并将数据安全地同步到本地 TimeLens API。
只在浏览器窗口获得焦点且用户未空闲（chrome.idle）时计时。切换标签、窗口失焦或进入空闲状态会立即结束当前会话并同步。
桌面端 Browser Usage 页面按域名展示总时长、趋势和限额，与本地应用屏幕时间并列呈现。
所有数据仅发送到本机 127.0.0.1 上的 TimeLens API。不上传云端，不收集页面内容。
按标签页记录活跃浏览时间，窗口失焦或用户空闲时自动暂停，恢复后继续计时。
在 TimeLens 桌面端 Browser Usage 页面配置忽略的域名，例如 localhost、企业内部 SSO 页面，避免干扰统计。
为特定网站设置每日使用限额，超额时桌面端会通过原生通知提醒你。
通过 TimeLens 桌面端 Settings 生成的桥接密钥验证扩展身份，防止未授权工具访问本地 API。
手动指定 API 端口、选择缓存模式（时长 / 下次启动前）、自定义缓存时长。手动端口失败时自动扫描备用端口范围。
点击浏览器工具栏图标即可查看桌面连接状态、今日总览和最近网页会话列表。
确保 TimeLens 桌面应用正在运行，并且 Settings 中启用了 Local API / Extension Bridge。
在桌面端 Settings 复制 Extension Bridge Key，粘贴到扩展弹窗的桥接密钥输入框中并保存。
v1.1.0 起，扩展支持更精细的本地 API 发现策略，解决 Windows 排除端口或安全软件导致默认端口不可用的问题。
| 设置项 | 说明 |
|---|---|
| API Port | 手动指定 TimeLens 本地 API 端口。默认 49152；留空或填 0 时直接扫描备用端口范围。 |
| Cache mode | Duration：按秒缓存已发现的 API 地址；Until next startup：浏览器本次运行期间一直使用缓存地址，重启后重新发现。 |
| Cache duration | 在 Duration 模式下缓存的秒数，默认 60 秒，最大 3600 秒。 |
| 自动回退扫描 | 当手动端口连续失败 5 次后，扩展会暂时忽略该端口并自动扫描 49152–50151 备用端口范围，5 分钟后恢复手动端口尝试。 |
打开 TimeLens 桌面端 → Settings → Local API / Extension Bridge → 点击复制 Extension Bridge Key。该密钥用于扩展向本地 API 签名请求，确保只有授权扩展能写入数据。
0 让扩展自动扫描备用端口。127.0.0.1 环回地址。TimeLens v2.0.2 桌面端会在 49152 被占用时自动扫描 49152–50151 并绑定到第一个可用端口。扩展侧也支持自动回退扫描，因此无需手动查找实际端口。