[FEATURE] support local files tracking for FF in background.js

[realSilasYang]

非常喜欢您的插件，可视化效果做得太漂亮了！不过，设置中说火狐不支持统计本地文件阅读时间，这让它的功能对我来说缺失了重要一环。我问了问ChatGPT，也许能供您参考？

下面我用 Firefox / WebExtensions（Manifest V2/MV3 通用） 的角度，给你说明能做到什么、做不到什么、以及可行的实现方案。
你想做的事情分两部分：

1. 读取用户在浏览器中打开的本地文件名（file:/// 路径）
2. 统计每个标签页的浏览时间

一、能否读取本地文件名？

结论：可以，但只限于你能访问到 tab.url，并且用户必须手动授予 Host 权限。

Firefox 对 file:// 有额外保护，扩展 默认不能访问本地文件的 URL。
你必须要求用户启用：

about:config → privacy.file_unique_origin = false

⚠️ 但更推荐、更标准的做法是：让用户手动授予扩展 file:// 权限*：

"permissions": ["tabs"],
"host_permissions": [
  "file:///*"
]

然后要用户去扩展详情 → 权限 → “允许访问文件 URL”。

获取文件名示例

browser.tabs.query({}).then(tabs => {
    tabs.forEach(t => {
        if (t.url.startsWith("file://")) {
            console.log("本地文件路径：", t.url);
        }
    });
});

这就能得到类似：

file:///C:/Users/.../example.pdf
file:///D:/books/a.html

---

二、如何统计浏览时间？

核心原则

浏览时间＝某标签页在前台停留的时长。

关键事件有：

• tabs.onActivated（前台标签变化）
• windows.onFocusChanged（浏览器失焦/获焦）
• tabs.onUpdated（URL改变时重置计时）

最小可运行示例（后台脚本 background.js）

let activeTabId = null;
let activeStart = null;
let stats = {}; // tabId → milliseconds

function startTiming(tabId) {
    activeTabId = tabId;
    activeStart = Date.now();
}

function stopTiming() {
    if (activeTabId !== null && activeStart !== null) {
        const duration = Date.now() - activeStart;
        stats[activeTabId] = (stats[activeTabId] || 0) + duration;
        console.log(`Tab ${activeTabId} 浏览时间累计：${stats[activeTabId]} ms`);
    }
    activeTabId = null;
    activeStart = null;
}

// 切换活动标签
browser.tabs.onActivated.addListener(activeInfo => {
    stopTiming();
    startTiming(activeInfo.tabId);
});

// 浏览器窗口是否聚焦
browser.windows.onFocusChanged.addListener(windowId => {
    if (windowId === browser.windows.WINDOW_ID_NONE) {
        stopTiming(); // 失焦
    } else {
        browser.tabs.query({ active: true, windowId }).then(tabs => {
            if (tabs[0]) startTiming(tabs[0].id);
        });
    }
});

// 当页面刷新/导航时
browser.tabs.onUpdated.addListener((tabId, changeInfo) => {
    if (changeInfo.status === "loading" && tabId === activeTabId) {
        stopTiming();
        startTiming(tabId);
    }
});

---

三、如何确保只统计 PDF/HTML 的本地文件？

判断扩展的条件是 url：

if (url.startsWith("file://") && (url.endsWith(".pdf") || url.endsWith(".html"))) {
    // 可以记录
}

---

四、你要做的扩展需要哪些权限？

{
  "manifest_version": 3,
  "name": "Local File Usage Stats",
  "version": "1.0",
  "permissions": ["tabs", "storage"],
  "host_permissions": [
    "file:///*"
  ],
  "background": {
    "service_worker": "background.js"
  }
}

用户必须手动点 “允许访问文件 URL”，否则扩展无法读取本地文件路径。

---

五、注意：不能读取真实文件内容，只能看到路径

Firefox 扩展 不能访问真实磁盘内容，不能读取 PDF 内容，只能得到：

• URL（即 file:// 路径）
• tab.title（如果有）

这样不会自动泄露敏感数据，也符合法律要求。

---

六、完整流程总结

1. 扩展声明 tabs 和 file:///* host 权限
2. 让用户手动开启“允许访问文件 URL”
3. 后台脚本监听页面激活与焦点变化，计算浏览时间
4. 通过 tab.url 获取本地文件路径
5. 把统计数据存到 browser.storage.local

[realSilasYang]

此外，如有可能，希望把各设置界面（about:xxx）浏览时长也统计进去。供参考：

结论先说：

❌ WebExtensions 无法访问 about: 页面（几乎全部）

包括：

• about:preferences
• about:addons
• about:config
• about:downloads
• about:newtab（可被扩展替换，但不能 读取）
• about:* 自定义页面（受浏览器保护）

Firefox 把 about: 页面视为内部系统页面，扩展出于安全原因不可注入脚本、不可读取 DOM、不可访问 URL 内容。

这不是权限不足，而是浏览器硬性限制。

---

为什么 about: 页面无法访问？

Firefox 认为 about: 页面属于：

• 浏览器自身 UI
• 特权页面（privileged pages）

普通 WebExtension（非 privileged / signed internal extension）没有权力访问浏览器内部界面。

因此：

• content_scripts 无法匹配 about:*
• host_permissions 无法包含 about:*
• tabs API 返回的 url 通常为 about:blank 或敏感字段被隐藏
• script injection（如 executeScript）也不会执行

---

🔒 哪些情况可以访问 about: 页面？

只有两类扩展可以：

1）Mozilla 官方内置扩展（Privileged Extensions）

例如：

• Firefox View
• Pocket
• Screenshots

这些扩展使用 Mozilla 内部签名，普通开发者完全无法获得。

---

2）基于 Gecko 的浏览器定制版（自编译 Firefox）

你可以：

• 下载 Firefox 源码
• 关闭 WebExtension 安全限制
• 重新编译一个自定义 Firefox

但这对普通用户来说完全不可行。

---

✔️ 能访问的特殊 about: 页面例外

1）about:newtab / about:home

你只能：

• 替换它（定义自己的新标签页）
• 但不能访问原始页面内容

配置方式：

"chrome_url_overrides": {
  "newtab": "newtab.html"
}

不能脚本注入原版 about:newtab。

---

2）about:blank

可以访问，但它通常只是空白页或中转页。

---

✔️ 那如何监听用户是否打开 about: 页面？

虽然不能访问内容，但可以监控标签 URL：

browser.tabs.onUpdated.addListener((tabId, changeInfo, tab) => {
    if (tab.url && tab.url.startsWith("about:")) {
        console.log("用户打开了 about 页面：", tab.url);
    }
});

你可以：

• 记录浏览时间
• 判断用户何时进入 about 页面
• 统计用户打开哪些内置界面

但你 无法读取内部内容。

---

✔️ 如果你的目标只是“统计用户浏览行为”，仍然可以做到：

• 可以统计 about 页面停留时间
• 可以知道用户打开 / 切换到 about 页面
• 可以记录 about 页面的 URL

例如：

if (tab.url.startsWith("about:")) {
    // 可以统计时间
    // 但不能注入脚本
}

---

❌ 无法做到的

• 无法执行 content-script
• 无法获取 DOM
• 无法读内容
• 无法修改 about 页面结构

不论 manifest v2 / v3 都不行。

[sheepzh]

因为 tracking 的原理是在 content-script 里植入 track 脚本（该方案最容易同时兼容 mv2 和 mv3，也能关注文档流的更多状态，所以统计出来的时间也最精准），所以浏览器内置页面几乎都不可以监听

[sheepzh]

至于你说的文档时间统计，我再研究下

[realSilasYang]

好滴好滴~我觉得如果最后实现方案需要用户配合改about:config配置啥的也是可以的，毕竟文档时间统计是一个默认关闭的选项，想开启的一般还算愿意折腾一下

[sheepzh]

@realSilasYang https://support.mozilla.org/bm/questions/1364437

很不幸。。。4 年前 privacy.file_unique_origin 这个开关就被下了。试了下，firefox 除了打开本地的 html 可以植入 content-script，其他类型的文件都没办法植入

[realSilasYang]

一定要注入 content-script吗？监听pdf标签页的tab.onActivated时长是不是就够了呀（一个猜想）

[sheepzh]

一定要注入 content-script吗？监听pdf标签页的tab.onActivated时长是不是就够了呀（一个猜想）

在 ff 上可以这样做，chrome 和 edge 不适合，mv3 不允许使用定时器上报事件。另外为了 ff 单独给本地文件维护一套track 机制又很烦，roi 低，所以就不太想做

[realSilasYang]

可怜可怜 ff 用户吧😭您这个扩展是官方首页推荐的、带徽章的精选扩展（这么多年获颁的只有一百个出头），更是其中由国人开发+五分评价的稀有存在，堪称凤毛麟角了

[sheepzh]

哈哈哈哈你都这样说了，那想办法给你安排上。先记上一笔

[realSilasYang]

大善人！爱您！