# attendance_process

**Repository Path**: zhangqlls/attendance_process

## Basic Information

- **Project Name**: attendance_process
- **Description**: 老婆用的考勤处理工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-02
- **Last Updated**: 2025-07-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 考勤数据处理工具

这是一个用于处理Excel格式考勤表的自动化工具，可以将月度汇总数据自动填充到整理版表格中。

## 功能特点

- 自动处理考勤数据，支持多种考勤状态（正常出勤、缺卡、旷工、各类假期）
- 智能识别工作日和周末/节假日
- 根据考勤状态自动设置单元格颜色
- 实时显示处理进度和统计结果
- 支持增强显示模式，使用更醒目的颜色

## 使用方法

1. 打开程序
2. 点击"浏览"按钮选择包含月度汇总和整理版的Excel文件
3. 点击"处理数据"按钮开始处理
4. 等待处理完成，查看处理结果
5. 处理完成后，结果会自动保存到原Excel文件

## 打包为EXE文件

### 重要提示：Windows商店版Python限制

如果您使用的是从Microsoft Store安装的Python版本（路径包含`PythonSoftwareFoundation.Python`），那么您将无法使用PyInstaller或Nuitka等工具打包为EXE文件。这是因为商店版Python运行在沙盒环境中，权限受限。

**解决方案**：必须使用从[Python官网](https://www.python.org/downloads/windows/)下载的标准版Python。

### 方法一：使用标准版Python打包

1. 从[Python官网](https://www.python.org/downloads/windows/)下载并安装标准版Python（勾选"Add Python to PATH"）
2. 运行`standard_python_build.bat`脚本：
   ```
   .\standard_python_build.bat
   ```
3. 打包完成后，可执行文件将位于`release`目录下

### 方法二：使用cx_Freeze（可能在商店版本运行）

1. 安装依赖：
   ```
   python -m pip install cx_Freeze pandas numpy openpyxl customtkinter
   ```
2. 运行打包命令：
   ```
   python setup.py build
   ```
3. 打包完成后，可执行文件将位于`build`目录下

## 处理规则说明

- 周末及法定节假日默认无需出勤，打卡记录均不显示（有请年假的除外）
- 正常、迟到、早退、外勤、调休、出差均视为考勤正常，单元格显示为"8"（浅蓝色标记）
- 上班/下班缺卡（红色标记）、旷工（玫红色标记）、各类假期（土黄色标记）按指定规则处理

## 系统要求

- Windows 7/8/10/11
- 如果直接运行Python脚本，需要安装Python 3.6+及相关依赖
- 打包为EXE后，无需安装额外软件

## 常见问题

**Q: 处理后的数据在哪里？**  
A: 处理结果会直接保存在您选择的Excel文件中，原文件会自动备份为`文件名_backup.xlsx`。

**Q: 程序无法识别我的员工姓名**  
A: 程序会尝试多种方式匹配员工姓名，如果仍有问题，请确保两个表格中的员工姓名完全一致。

**Q: 如何更改颜色设置？**  
A: 在界面底部有"使用增强颜色"选项，可以切换颜色显示模式。

**Q: 为什么打包失败？**  
A: 如果您使用的是Windows商店版Python，打包工具将无法正常工作。请安装标准版Python并使用上述"方法一"。

## 开发者信息

如有技术问题或建议，请联系：
- 邮箱：support@example.com
- 电话：123-456-7890