RunTime Tracker

April 19, 2026 · View on GitHub

本项目由 AI 辅助开发 版本: 1.0.1

RunTime Tracker 是一个设备使用情况监控工具，可以实时跟踪设备上运行的应用程序，并将数据上报到服务器进行分析。

功能特性

  • 实时监控前台应用程序
  • 自动上报设备使用数据到服务器
  • 显示电池状态和充电情况
  • 支持主题切换（浅色、深色、跟随系统）
  • 可配置的监控间隔和上报设置
  • 详细的日志记录和查看功能

系统要求

  • Windows 操作系统
  • Python 3.7 或更高版本

安装指南

方法一：直接运行（开发模式）

  1. 克隆或下载项目到本地
  2. 安装依赖项： 
    pip install -r requirements.txt
  3. 运行应用： 
    python main.py

方法二：使用打包版本（推荐）

  1. 下载打包好的可执行文件
  2. 解压到任意目录
  3. 双击 RunTimeTracker.exe 运行

配置说明

首次运行应用时，会使用默认配置。您可以在"配置"页面修改以下设置：

  • API设置：

    • API地址：数据上报的服务器地址
    • 密钥：用于验证上报请求
    • 设备ID：标识当前设备的唯一名称

  • 监控设置：

    • 监控间隔：检查前台应用的时间间隔（秒）
    • 上报功能：是否启用数据上报

  • 主题设置：

    • 跟随系统：使用系统当前主题
    • 浅色主题：使用浅色界面
    • 深色主题：使用深色界面

使用指南

  1. 主页面：显示当前应用、电池状态和设备信息
  2. 日志页面：查看和导出应用日志
  3. 配置页面：修改应用设置
  4. 关于页面：查看项目信息和相关链接

数据上报

应用会定期上报以下数据到服务器：

  • 当前运行的应用名称
  • 应用运行状态
  • 电池电量和充电状态
  • 设备ID

项目链接

相关项目

常见问题

应用无法启动

  • 检查是否安装了所有依赖项
  • 查看日志文件了解具体错误信息

数据上报失败

  • 检查网络连接
  • 验证API地址和密钥是否正确
  • 查看日志文件了解具体错误信息

监控不工作

  • 检查监控间隔设置是否合理
  • 确保上报功能已启用
  • 查看日志文件了解具体错误信息

日志文件

日志文件存储在 logs 目录中，命名格式为 runtime_tracker_YYYY-MM-DD.log。您可以在"日志"页面查看和导出日志。

致谢

本项目的核心数据上报逻辑参考并使用了 Tracker_Client 的部分代码，在此对原作者表示感谢。

感谢 PyQt-Fluent-Widgets 提供的优秀UI框架。

开源许可

本项目采用 MIT 许可证。

开发者

  • 作者: CSSQY

联系我们