# 打卡工时记录助手

**Repository Path**: radish40/time-tracker

## Basic Information

- **Project Name**: 打卡工时记录助手
- **Description**: 打卡工时记录助手
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-25
- **Last Updated**: 2026-05-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 工时打卡 TimeTracker

Windows 桌面端工时统计工具，运行在系统托盘，支持自动/手动打卡、工时计算、日历统计等功能。

## 快速使用

已打包好可直接运行的 exe 文件：

1. 下载 `dist/TimeTracker.exe`
2. 同目录下需包含 `data/` 文件夹（内含 records.json 等数据文件）
3. 双击运行即可，程序会缩小到系统托盘

> 首次使用建议将 `TimeTracker.exe` 放到一个固定目录再运行，因为数据文件（打卡记录、配置等）会保存在 exe 所在目录的 `data/` 下。

## 项目结构

```
├── src/               # Python 源码
├── data/              # 运行时数据（打卡记录、配置等）
├── dist/              # 打包输出目录
├── icon.ico           # 应用图标
├── cxk_icon.png       # 托盘小鸡图标
├── build.bat          # Windows 打包脚本
└── README.md
```

## 从源码打包

### 环境要求

- Python 3.10+
- Windows 系统（打包脚本仅支持 Windows，其他系统可自行打包调试）

### 打包步骤

```bash
# 1. 安装依赖
pip install pystray Pillow pyinstaller

# 2. 一键打包（single exe）
.\build.ps1

# 多文件目录模式（启动更快）
.\build.ps1 dir
```

打包产物位于 `dist/TimeTracker.exe`，首次运行前需在 exe 同目录下创建 `data/` 文件夹并放入初始数据文件（可复制源码中的 `data/` 目录）。

## 功能

- 上班/下班打卡（按钮 / 托盘菜单 / 自动检测屏幕解锁）
- 手动补卡与日历视图补录
- 工时实时计算与推荐下班时间
- 月度统计（平均工时 / 工作天数 / 总工时）
- 节假日 / 请假 / 调休标记
- 三种托盘图标模式（进度环 / 小鸡 / 自定义）
- 外卖 & 喝水定时提醒
- 午休时间与扣除模式设置
- CSV 报表导出
- 开机自启