Firefox 浏览器扩展，用于采集和分析您的网页浏览历史，帮助您了解自己的兴趣和关注点。
- 📊 数据采集：每15分钟自动采集浏览历史
- 🔑 关键词分析：自动提取和统计关键词频率（Top 50）
- 📂 智能分类：自动识别10大分类（技术、新闻、娱乐等）
- ⏰ 时间分析：按时间段（早晨、中午、下午、晚上、深夜）和工作日/周末统计
- 🌐 网站统计：Top 20 热门网站访问记录
- 💾 数据导出：支持导出为 JSON 格式
- 🔒 完全本地：所有数据存储在本地，不上传任何服务器
- 了解自己的浏览习惯和兴趣偏好
- 发现知识盲点和学习机会
- 分析时间分配和注意力焦点
- 备份重要的浏览记录
- 下载本项目到本地
- 打开 Firefox，访问
about:debugging#/runtime/this-firefox - 点击"临时载入附加组件"
- 选择项目文件夹中的
manifest.json文件 - 点击"打开"完成安装
- 点击浏览器工具栏上的扩展图标
- 点击"启用采集"按钮开始收集数据
- 访问一些有标题的网页
- 点击"采集所有历史(7天)"或等待自动采集
- 点击"查看详细统计"查看分析报告
扩展提供三种采集方式：
- 自动采集：每15分钟自动采集最近15分钟的历史
- 手动采集：点击"立即采集"手动触发
- 批量采集：点击"采集所有历史(7天)"一次性采集最近7天的数据
- 当前采集状态
- 总访问数和今日访问数
- 最后更新时间
- 快捷操作按钮
概览：
- 总访问数、关键词数、分类数、日均访问
- 热门关键词 Top 10
- 热门网站 Top 10
关键词：
- Top 50 关键词统计
- 进度条显示相对频率
分类：
- 10个分类自动识别
- 分类卡片展示
时间分析：
- 时间段分布（早晨、中午、下午、晚上、深夜）
- 工作日 vs 周末对比
网站：
- Top 20 网站访问统计
- 访问次数和排名
- 点击扩展图标
- 点击"导出数据"按钮
- 选择保存位置
- 导出的 JSON 文件包含完整的浏览历史
导出文件格式：
{
"version": "1.0",
"exportTime": "2026-01-06T12:00:00.000Z",
"totalVisits": 1250,
"visits": [
{
"title": "页面标题",
"url": "https://example.com/page",
"domain": "example.com",
"visitTime": 1736131200000,
"visitCount": 1,
"typedCount": 0,
"category": "技术"
}
]
}- 扩展规范：Manifest V3
- 编程语言：Vanilla JavaScript (ES6+)
- 数据存储：browser.storage.local API
- 数据采集：browser.history API
- 定时任务：browser.alarms API
- UI框架：原生 HTML + CSS
interest-tracker/
├── manifest.json # 扩展配置文件
├── background.js # 后台脚本（数据采集和分析）
├── popup/ # 快速访问界面
│ ├── popup.html # HTML结构
│ └── popup.js # JavaScript逻辑
├── options/ # 详细统计页面
│ ├── options.html # HTML结构
│ └── options.js # 数据分析和渲染
├── lib/ # 工具库
│ ├── analyzer.js # 数据分析模块
│ └── common.js # 通用工具函数
└── icons/ # 扩展图标
扩展需要以下权限：
history: 读取浏览历史storage: 存储采集的数据alarms: 定时采集任务downloads: 导出数据文件tabs: 获取标签页信息（用于未来扩展）
数据采集：
- 定时采集（15分钟）
- 首次采集（24小时）
- 手动采集（15分钟）
- 批量采集（可配置天数）
数据分析：
- 关键词提取（中英文支持）
- 停用词过滤
- 智能分类（10个预设分类）
- 时间段分布统计
- 访问频率分析
数据存储：
- 使用 storage.local API
- 永久保留历史数据
- 支持手动导出备份
- ✅ 所有数据仅存储在本地浏览器中
- ✅ 不上传到任何服务器
- ✅ 不收集个人信息
- ✅ 可以随时禁用或卸载扩展
- ✅ 数据完全受用户控制
- 采集频率：每15分钟自动采集，可根据需要修改代码调整
- 数据准确性：基于标题和URL进行分析，可能存在误差
- 性能影响：性能开销极小，不影响浏览器使用体验
- 数据大小：长期使用后数据量会增加，建议定期导出备份
- 兼容性：支持 Firefox 57+（Manifest V3）
# 1. 克隆或下载项目
cd interest-tracker
# 2. 加载到 Firefox
# 访问 about:debugging#/runtime/this-firefox
# 点击"临时载入附加组件"
# 选择 manifest.json
# 3. 查看日志
# 访问 about:debugging#/runtime/this-firefox
# 点击扩展的"检查"按钮修改采集频率（background.js）：
browser.alarms.create("collectHistory", {
periodInMinutes: 15 // 修改这个值
});添加新分类（background.js）：
const categories = {
'你的分类': ['关键词1', '关键词2'],
// ... 其他分类
};- 🎉 初始发布
- ✨ 实现数据采集功能
- 🔑 实现关键词分析
- 📂 实现智能分类
- ⏰ 实现时间分析
- 🌐 实现网站统计
- 💾 实现数据导出
- 🔒 完全本地存储
欢迎提交 Issue 和 Pull Request！
如果您有改进建议或发现了 Bug，请：
- 在 GitHub 上创建 Issue
- 清楚地描述问题或建议
- 提供复现步骤（如果适用）
- 等待维护者回复
MIT License
Copyright (c) 2026 Your Name
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
如果这个项目对你有帮助，请给个 Star ⭐️
Made with ❤️ for personal growth and self-discovery