Releases: GiftedScout/UsageTracker
UsageTracker v0.4.0 Linux prerelease
UsageTracker v0.4.0-prerelease
Linux-first 预发布版：源码运行、后台守护进程、WebUI 设置与 XDG 路径适配。
主要变化
- 新增
bin/usagetrackerLinux CLI 包装器，支持daemon/status/stop/web/today - 迁移到 Linux/XDG 用户目录：配置、数据、日志、报告不再依赖 Windows 路径
- 支持 X11/XWayland 活动窗口轮询追踪，避免 Windows 事件钩子崩溃路径
- 修复浏览器识别、忽略名单迁移、WebUI 数据兼容等 Linux 移植问题
- 单实例锁增强：
status不再破坏锁，stop可在 PID 文件为空时从/proc/locks找到守护进程 - Linux 通知、开机自启、报告打开方式适配
升级/运行说明
git clone https://github.com/GiftedScout/UsageTracker.git
cd UsageTracker
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
./bin/usagetracker daemon
./bin/usagetracker web这是 Linux 预发布版本，推荐在 X11/XWayland 会话下测试；暂不提供 Windows exe 安装包。
v0.3.0 (网页端设置)
UsageTracker v0.3.0
网页端设置界面正式上线，GUI 窗口模式已弃用。
主要变化
- 设置界面改为本地网页（
http://127.0.0.1:19234），不再弹出 GUI 窗口 - 修复
SetWinEventHook导致的崩溃，强制改为轮询模式 - i18n 全面修复，所有界面元素随语言切换正确显示
- 网页端新增：日志预览与筛选、数据库预览、反馈文件夹快捷打开
详见 README
升级说明
直接运行 UsageTracker_Setup_0.3.0.exe 覆盖安装，数据自动保留。
v0.2.0-beta (Pre-release)
UsageTracker v0.2.0-beta
Beta 测试版，GUI 精美模式待完善，仅供测试。
新增功能（v0.2.0 功能集，beta 状态）
• 精美模式设置面板（深色主题、左侧边栏导航）—— 已知问题较多，建议暂不启用
• 事件驱动追踪：零延迟检测窗口切换（SetWinEventHook）
• 自动更新检查：启动时检测 GitHub 新版本
• PDF 报告导出：Edge/Chrome 无头模式一键导出
• 自定义时间范围报告
• 分类建议：自动推荐未归类应用
• 数据库优化：复合索引、批量写入
已知问题
• 精美模式 GUI 存在多处崩溃和显示问题，正在重构中
• 后续计划改为网页端设置界面，替代桌面 GUI
UsageTracker v0.1.2
修复多项已知问题，新增进程选择器和关于对话框。
v0.1.2
UsageTracker v0.1.2
修复多项已知问题，新增进程选择器和关于对话框。
修复内容
| 问题 | 说明 |
|---|---|
| 忽略名单不生效 | 修复路径大小写不敏感匹配，忽略功能现已正常工作 |
| 设置页显示英文 key | 主题/保留策略下拉框现在正确显示翻译后的中文译文 |
| 新增分类后添加程序卡死 | 修复 Treeview 程序列表刷新逻辑 |
| 语言切换后显示 key 前缀 | 修复语言切换映射逻辑 |
| 追踪循环异常 | 增强 tracker 异常捕获，记录完整 traceback |
| 忽略操作后进程闪退 | 移除跨线程修改托盘 tooltip（Shell_NotifyIcon 非线程安全） |
| 开机弹报告频率过高 | 现在仅当天第一次启动时弹出 |
新增功能
| 功能 | 说明 |
|---|---|
| 进程选择器 | 忽略名单、分类管理、游戏管理均支持从当前运行进程中选择添加 |
| 关于对话框 | 托盘右键"关于"菜单显示当前版本更新日志及 GitHub 链接 |
| 忽略时清零历史数据 | 忽略应用时自动清零当日已记录的使用时长 |
| 通知不再闪终端窗口 | PowerShell Toast 通知优化，避免弹出控制台窗口 |
升级说明
直接运行新安装程序覆盖安装即可，数据和配置会自动保留。
v0.1.1
UsageTracker v0.1.1
日常维护更新，修复多项已知问题。
修复内容
| 问题 | 说明 |
|---|---|
| 日报无法打开 | 右键菜单点击"昨日日报"可能无反应，现已修复 |
| 开机未自动弹出报告 | 部分情况下开机后昨日报告不会自动弹出，现已修复 |
| 设置窗口闪退 | 打开设置界面可能触发崩溃，现已修复 |
| 其他稳定性改进 | 修复了若干潜在的崩溃问题 |
升级说明
直接运行新安装程序覆盖安装即可，数据会自动保留。
由 UsageTracker 自动生成
v0.1.0
🎉 UsageTracker v0.1.0 正式版
首个正式发布版本，基于 v0.1.0-beta 的用户反馈进行了重大修复和功能改进。
🐛 重要修复
| 问题 | 修复内容 |
|---|---|
| 运行多天后无使用数据 | 重构数据保存机制：_auto_save() 现在同时覆盖当前活跃 session 和已结束 session；移除了 _on_session_end 中的 _last_saved_dur.pop() 调用（该调用导致 _auto_save 重复保存全部时长）；程序退出前执行 flush 保存所有 pending 数据 |
| 使用时间统计偏高 | 修复 _on_session_end 中 _last_saved_dur.pop() 导致的重复计费 bug — 每次 session 切换都会使上一个 session 的全部时长被重新保存一次 |
| 开机后不弹出昨日报告 | 新增开机自动弹出昨日报告功能（延迟 8 秒，等待系统稳定） |
| 报告可能打不开 | 数据保存机制修复后，数据库不再因保存遗漏而缺少数据 |
✨ 新增功能
- 开机自动弹出昨日报告 — 启动后 8 秒自动打开昨天的使用报告，可在设置中关闭
- 国际化支持（i18n） — 支持中文/英文双语界面，安装时选择语言，运行时可在设置中切换
- UI 提示优化 — 游戏目录和分类管理页面增加了操作说明，告知用户正确的输入格式
📋 设置界面改进
- 通用设置新增「开机自动弹出昨日报告」开关（默认启用）
- 游戏目录新增提示：exe 名只需填写进程文件名（如
game.exe），无需完整路径 - 分类管理新增提示：添加程序时通过文件选择器自动获取完整路径
🔧 技术改进
- 重构数据保存逻辑，抽取
_save_session_data()通用函数，消除_auto_save和_on_session_end的代码重复 - 修复
_on_session_end跳过other分类导致的数据丢失 - 退出时 flush 所有 pending session 数据，防止退出丢失
- Inno Setup 7 兼容性适配
📥 安装说明
- 下载
UsageTracker_Setup_0.1.0.exe - 运行安装程序（支持中文/英文安装向导）
- 首次启动需接受隐私声明
- 程序会自动最小化到系统托盘运行
从 v0.1.0-beta 升级：直接运行新安装程序覆盖安装即可，数据会自动保留。
由 UsageTracker 自动生成
v0.1.0-beta
UsageTracker v0.1.0-beta
首个公开版本。
功能特性
- 自动追踪桌面应用使用时长
- 智能分类（浏览器、游戏、开发工具等）
- 可视化日报 / 周报
- 超时提醒
- 系统托盘静默运行
- 纯本地存储，无需联网
安装方式
下载 UsageTracker_Setup_0.1.0-beta.exe，双击运行安装向导即可。
⚠️ 此版本为预发布版，可能存在不稳定情况。