- Extensions: rewrite both Chrome MV3 & Firefox MV2 with reliable chrome.history.search incremental pull (not onVisited), local search-engine filtering, URL dedup, 30s alarm, retry queue, Bearer token header - Add icons (16/48/96/128) for both browsers - Manifest fixes: chrome action popup, firefox options_ui + browser shim - history-server: require NAVI_SYNC_TOKEN for POST /sync & GET history, NAVI_ADMIN_TOKEN for DELETE; fix RWMutex deadlock (unlock before sortDashyFavorites) that stalled syncs with valid token - admin-server: require NAVI_ADMIN_TOKEN for item add/delete writes
JianF Nav Sync — 浏览器扩展
将浏览历史同步到自建导航门户,按总访问频次自动排序「常用服务」与「历史访问」。
安装
Chrome / Edge(MV3)
- 打开
chrome://extensions/ - 开启右上角「开发者模式」
- 点「加载已解压的扩展程序」,选择本目录的
chrome/文件夹 - Edge 同理:
edge://extensions/
Firefox(MV2)
- 打开
about:debugging#/runtime/this-firefox - 点「临时加载附加组件」,选择本目录
firefox/下的manifest.json - 长期使用:
web-ext build打包后到about:addons安装
iOS / 手机浏览器
系统浏览器扩展 API 不适用于 iOS Safari 普通网页。可用备选:
- iOS Safari Web Extension(需 Xcode 工程封装)
- Android 上使用 Kiwi / Yandex 等支持 MV3 的浏览器加载
chrome/
配置(点击扩展图标)
| 字段 | 说明 |
|---|---|
| 导航服务地址 | 你的门户根地址,如 https://nav.example.com(不要带 /search 等路径) |
| 同步令牌 | 服务端环境变量 NAVI_SYNC_TOKEN 的值(服务端开启鉴权时必填) |
| 设备名称 | 可选,留空自动检测(desktop-chrome / desktop-firefox / mobile-*) |
行为
- 每 30 秒用
chrome.history.search拉取最近 2 小时新记录(不依赖 onVisited 事件,MV3 休眠也可靠) - 本地过滤:搜索引擎域名、
/search?q=结果页、chrome://、about:等一律不上传 - 同一网址 10 分钟内去重、同批 URL 去重
- 仅在有待同步数据时发 POST(无空轮询)
- 同步失败自动保留队列,下轮重试
- 上报带
Authorization: Bearer <token>;门户「常用服务/历史访问」按total_visits自动更新
技术细节
- Chrome/Edge: Manifest V3,service worker +
chrome.alarms(最小周期 30s) - Firefox: Manifest V2,event page +
browser.alarms - 存储:
storage.local(pending 队列 + 配置) - API:
history.search+alarms+runtime.onMessage