Windows App Usage Tracker

自用的一个ai垃圾（） 一个可复用用于在 Windows 主机采集前台应用使用时长，并通过看板进行可视化分析。

看板布局

页面包含以下区域：

• 顶部汇总卡片：总记录时长、总会话数、平均单次时长、活跃天数、专注应用、专注占比、主类别、最近更新时间
• 中部 4 个图表板块（2x2）：
  • 应用总时长排行
  • 每日总时长趋势
  • 应用类别分布
  • 最近 24 小时 Top 应用
• 底部应用会话明细表：应用、进程、类别、总时长、会话数、平均单次、最后活跃

快速开始（Windows 一键部署）

1. 环境要求

• Windows 10/11
• Docker Desktop（含 Docker Compose v2）
• Python 3（用于本机采集器虚拟环境）

2. 启动全部服务

在项目根目录双击运行：

• deploy.bat

脚本会自动完成：

1. docker compose up -d --build --pull always 启动前后端
2. 首次自动创建 collector/.venv
3. 启动采集器后台窗口 UsageCollector

启动后访问：

• 前端看板：http://localhost:8080
• 后端 API：http://localhost:8000

3. 停止服务

双击运行：

• stop.bat

该脚本会停止容器并结束采集器窗口。

目录结构

.
├─ backend/
│  ├─ app/main.py           # FastAPI 接口与聚合逻辑
│  ├─ requirements.txt
│  └─ Dockerfile
├─ frontend/
│  ├─ index.html            # 看板页面
│  ├─ app.js                # 图表渲染与数据请求
│  ├─ style.css             # UI 样式
│  ├─ logos/                # 应用 Logo 资源
│  ├─ nginx.conf
│  └─ Dockerfile
├─ collector/
│  ├─ collector.py          # Windows 前台应用采集器
│  ├─ requirements.txt
│  ├─ setup_venv.bat
│  └─ run_collector.bat
├─ data/                    # SQLite 数据目录（usage.db）
├─ docker-compose.yml
├─ deploy.bat               # 一键部署
├─ stop.bat                 # 一键停止
├─ package.bat              # 一键打包镜像
└─ .env.example

本地开发（可选）

启动前后端容器

docker compose up -d --build

单独运行采集器

在 collector/ 目录执行：

setup_venv.bat
run_collector.bat

或手动命令：

cd collector
py -3 -m venv .venv
.venv\Scripts\python -m pip install -r requirements.txt
.venv\Scripts\python collector.py --server http://localhost:8000

贡献指南

欢迎提交 Issue / PR，建议包括：

• 复现步骤
• 期望行为与实际行为
• 运行环境（Windows 版本、Docker 版本、Python 版本）

License

This project is licensed under the MIT License. See the LICENSE file for details.