# 述职计时器 操作手册

## 一、概述

述职计时器是一款专为述职演讲设计的倒计时工具，支持快捷计时、提前告警、微缩悬浮窗口等功能。

## 二、快速开始

1. 双击 `countdown.exe` 启动程序
2. 点击 **5分钟** 或 **6分钟** 按钮开始倒计时
3. 2秒后窗口自动缩小为悬浮模式

## 三、功能说明

### 3.1 主界面

| 按钮 | 说明 |
|------|------|
| 5分钟 | 开始5分钟（300秒）倒计时 |
| 6分钟 | 开始6分钟（360秒）倒计时 |
| 其它 | 打开配置窗口 |

### 3.2 配置功能

点击 **其它** 按钮打开配置窗口，可设置以下选项：

| 配置项 | 说明 |
|--------|------|
| 自定义秒数 | 设置自定义倒计时时长（1-3600秒） |
| 提前告警(秒) | 设置提前播放告警音的时间（0-300秒） |
| 窗口置顶 | 勾选后窗口始终保持在其他窗口上方 |
| 透明度 | 调节窗口透明度（10%-100%） |
| 距离右边缘 | 微缩窗口距离屏幕右边缘的像素值 |
| 距离上边缘 | 微缩窗口距离屏幕上边缘的像素值 |

### 3.3 窗口操作

| 操作 | 功能 |
|------|------|
| 拖拽标题栏区域 | 移动窗口位置 |
| 双击微缩窗口 | 暂停倒计时，恢复正常窗口大小 |

### 3.4 告警与提醒

- **提前告警**：倒计时剩余时间达到"提前告警"设定值时，播放3次提示音
- **倒计时结束**：
  - 微缩模式：文字红黄闪烁
  - 正常模式：文字跳动 + 透明度闪烁

## 四、音频配置

程序支持自定义告警音效：

- 将 `alarm.wav` 音频文件放置在 **exe 同目录** 或 **当前工作目录**
- 程序会优先从外部目录加载，若未找到则使用内置音频

## 五、打包说明

### 5.1 打包命令

```bash
pyinstaller --onefile --windowed --noconsole --icon=Timer.ico countdown.py
```

参数说明：
- `--onefile`：打包成单个exe文件
- `--windowed` / `--noconsole`：不显示控制台窗口
- `--icon`：指定程序图标

### 5.2 清理残留文件

运行 `clean.py` 可自动清理打包残留文件并重新生成exe。

## 六、注意事项

1. 首次运行请确保 `alarm.wav` 与 exe 在同一目录，否则告警功能不可用
2. 微缩窗口位置可在配置中自定义
3. 窗口支持拖拽，可放置在屏幕任意位置