ff0e6418f8
导航页现在会自动检测浏览历史插件是否已安装： - 扩展在用户配置的服务地址上动态注册 content script （Chrome: chrome.scripting.registerContentScripts， Firefox: browser.contentScripts.register）， 于 document_start 给 <html> 打上 data-navi-ext 标记， 不在其他站点运行。 - history-server 始终把「安装浏览历史插件」放在「历史访问」第一条 （入口 url=/extension/install.html），启动时也会重建一次， 不再需要等下一次同步。 - web/navi.js 读到标记后隐藏该入口（连 .item-wrapper 一起隐藏， 避免留下空网格位）。 - 新增 /extension/install.html：自动识别浏览器，给出对应安装包与步骤； 支持在 data 卷放 extension-store.json 配置商店链接， 有商店链接时显示真正的「一键安装」。 - 段落名匹配同时兼容中英文（常用服务/Favorites、历史访问/History）， 修掉了公开示例 conf.yml 用英文名时重建逻辑完全失效的问题。 - 扩展升到 1.1.0（新增 scripting 权限与 detect.js）。 Note: Chrome/Edge 不允许从网站直接安装非商店扩展， 因此自托管场景下只能下载后手动加载；发布到商店后才会出现一键安装。
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