countdown/操作手册.md

述职计时器 操作手册

一、概述

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

二、快速开始

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 打包命令

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. 窗口支持拖拽，可放置在屏幕任意位置