From bc329679a0ccacfe4c4ce82180f46b668b827731 Mon Sep 17 00:00:00 2001 From: xiaji Date: Thu, 22 Jan 2026 10:59:56 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0=E6=93=8D=E4=BD=9C?= =?UTF-8?q?=E6=89=8B=E5=86=8C?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- 操作手册.md | 78 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 操作手册.md diff --git a/操作手册.md b/操作手册.md new file mode 100644 index 0000000..58ffae2 --- /dev/null +++ b/操作手册.md @@ -0,0 +1,78 @@ +# 述职计时器 操作手册 + +## 一、概述 + +述职计时器是一款专为述职演讲设计的倒计时工具,支持快捷计时、提前告警、微缩悬浮窗口等功能。 + +## 二、快速开始 + +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. 窗口支持拖拽,可放置在屏幕任意位置