From 633752b2124ea41126074548aec83e1e3d9e9469 Mon Sep 17 00:00:00 2001
From: xiaji <rembme@163.com>
Date: Wed, 21 Jan 2026 18:26:44 +0800
Subject: [PATCH] Add README.md with feature documentation

---
 README.md | 65 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 65 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..64adeed
--- /dev/null
+++ b/README.md
@@ -0,0 +1,65 @@
+# 述职计时器
+
+一个使用 PySide6 构建的倒计时应用程序，美观大方，支持多种倒计时模式。
+
+## 功能特点
+
+### 界面状态
+程序有两种界面状态：
+
+#### 1. 正常状态
+- 显示倒计时时间和完整的按钮区域
+- 可以通过拖动窗口的任何位置来移动窗口
+- 点击"▼"箭头可以折叠/展开按钮区域
+- 窗口大小：500×300像素
+
+#### 2. 微缩状态
+- 点击"5分钟"或"6分钟"按钮开始倒计时后，延迟2秒自动切换到微缩状态
+- 只显示倒计时时间和"▼"箭头
+- 窗口大小：200×80像素
+- 位置：距离屏幕上边缘50像素，距离右边缘200像素
+- 点击"▼"箭头可以暂停倒计时并切换回正常状态
+
+### 快捷按钮
+- **5分钟**：开始5分钟倒计时
+- **6分钟**：开始6分钟倒计时
+- **其它**：打开配置对话框
+
+### 配置功能
+点击"其它"按钮可以打开配置对话框：
+- **自定义倒计时**：设置自定义倒计时时间（秒）
+- **提前告警**：设置倒计时结束前多少秒播放告警提示音
+- **窗口置顶**：设置窗口是否置顶
+- **窗口透明度**：设置窗口透明度（10%-100%）
+- **测试告警**：测试告警提示音
+- **退出**：退出程序（唯一退出方式）
+
+### 告警功能
+- 倒计时结束前设置的秒数时播放告警提示音
+- 循环播放3次
+- 倒计时结束时显示"时间已到"文字，带有跳动和闪动效果
+
+## 使用说明
+
+1. 运行程序后，默认显示正常状态
+2. 点击"5分钟"或"6分钟"按钮开始倒计时
+3. 2秒后自动切换到微缩状态，只显示时间和箭头
+4. 在微缩状态下点击箭头可以暂停并回到正常状态
+5. 需要退出程序时，点击"其它"→"退出"
+
+## 技术栈
+- Python 3.11
+- PySide6 (Qt 6)
+- PyInstaller（打包）
+
+## 打包命令
+```bash
+python -m PyInstaller --onefile --windowed --icon=Timer.ico --name=述职计时器 countdown.py
+```
+
+## 文件说明
+- `countdown.py` - 主程序代码
+- `Timer.ico` - 程序图标
+- `要求.txt` - 功能需求文档
+- `clean.py` - 清理打包残留文件
+- `SKILL.md` - 打包技巧说明