# TimePicker

**Repository Path**: tools-ai/time-picker

## Basic Information

- **Project Name**: TimePicker
- **Description**: 拾光：倒计时休息小工具
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-04-03
- **Last Updated**: 2026-04-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 拾光 (TimePicker)

一个简洁实用的Windows定时休息提醒工具，支持Windows 11系统。

## 功能特点

- ⏰ **定时提醒**：手动设置提醒时间，到点主动弹框提醒
- 🔄 **循环模式**：支持单次/循环选项，循环模式下自动开始下一轮倒计时
- 🔒 **智能锁屏**：循环模式下点击"休息"自动锁屏，解锁后继续倒计时
- 📱 **后台运行**：点击关闭按钮最小化到后台，定时器继续运行
- 🔍 **单实例检测**：双击EXE文件自动激活后台运行的实例
- 🎨 **美观界面**：淡绿色透明背景，清晰的倒计时显示
- 📦 **一键安装**：提供安装脚本，可添加到系统开始菜单

## 安装方法

### 方法一：直接运行
1. 下载 `dist/TimePicker.exe` 文件
2. 双击运行即可

### 方法二：系统安装
1. 运行 `install.bat` 脚本
2. 按照提示完成安装
3. 在开始菜单中找到"TimePicker"快捷方式

## 使用方法

1. **设置提醒时间**：
   - 点击窗口右下角的"设置"按钮
   - 在设置窗口中调整小时、分钟、秒数
   - 选择是否启用循环模式
   - 点击"确认"按钮保存设置

2. **开始倒计时**：
   - 点击"开始计时"按钮
   - 窗口会显示实时倒计时

3. **最小化到后台**：
   - 点击窗口右上角的关闭按钮
   - 程序会隐藏到后台，定时器继续运行

4. **恢复窗口**：
   - 再次双击 `TimePicker.exe` 文件
   - 程序会从后台恢复到前台

5. **循环模式**：
   - 启用循环模式后，时间到时会弹出提醒窗口
   - 点击"休息"：自动锁屏，解锁后继续下一轮倒计时
   - 点击"继续工作"：直接开始下一轮倒计时

## 技术特性

- **开发语言**：Python
- **GUI库**：tkinter
- **打包工具**：PyInstaller
- **系统兼容**：Windows 10/11
- **单文件可执行**：无需安装Python环境

## 项目结构

```
TimePicker/
├── timepicker.py        # 主程序文件
├── build.bat            # 打包脚本
├── build.ps1            # 打包PowerShell脚本
├── install.bat          # 安装脚本
├── run_timepicker.bat   # 运行脚本
├── TimePicker.spec      # 打包配置文件
├── dist/                # 打包输出目录
│   └── TimePicker.exe   # 可执行文件
└── README.md            # 项目说明文件
```

## 常见问题

### 1. 程序被安全软件警告
- **原因**：PyInstaller打包的可执行文件可能被安全软件误报
- **解决**：将 `TimePicker.exe` 添加到安全软件的白名单中

### 2. 双击EXE文件无反应
- **原因**：可能已有实例在后台运行
- **解决**：程序会自动激活后台运行的实例，稍等片刻即可

### 3. 循环模式不生效
- **原因**：需要在开始计时前启用循环模式
- **解决**：在设置窗口中勾选"循环模式"，然后点击"确认"和"开始计时"

## 开发说明

### 打包项目
1. 运行 `build.bat` 脚本
2. 等待打包完成
3. 可执行文件会生成在 `dist` 目录中

### 运行开发版本
1. 确保已安装Python 3.7+
2. 运行 `run_timepicker.bat` 脚本

## 许可证

本项目采用 MIT 许可证，详见 LICENSE 文件。

## 联系方式

如有问题或建议，欢迎反馈！

---

**拾光 (TimePicker)** - 让时间管理更简单，让身心更愉悦！