Compare commits
6 Commits
633752b212
...
branch-off
| Author | SHA1 | Date | |
|---|---|---|---|
| dbaff55d3a | |||
| 74b1de9b3a | |||
| 81fc433690 | |||
| bc329679a0 | |||
| cc70343090 | |||
| 9879dee0de |
BIN
2alarm.wav
Normal file
BIN
2alarm.wav
Normal file
Binary file not shown.
130
README.md
130
README.md
@@ -1,65 +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` - 打包技巧说明
|
||||
# 述职计时器
|
||||
|
||||
一个使用 PySide6 构建的倒计时应用程序，美观大方，支持多种倒计时模式。
|
||||
|
||||
## 功能特点
|
||||
|
||||
### 界面状态
|
||||
程序有两种界面状态：
|
||||
|
||||
#### 1. 正常状态
|
||||
- 显示倒计时时间和完整的按钮区域
|
||||
- 可以通过拖动窗口的任何位置来移动窗口
|
||||
- 显示按钮区域
|
||||
- 窗口大小：500×300像素
|
||||
|
||||
#### 2. 微缩状态
|
||||
- 点击"5分钟"或"6分钟"按钮开始倒计时后，延迟2秒自动切换到微缩状态
|
||||
- 只显示倒计时时间
|
||||
- 窗口大小：200×80像素
|
||||
- 位置：距离屏幕上边缘50像素，距离右边缘200像素
|
||||
- 双击界面后暂停倒计时，并切换回正常状态
|
||||
|
||||
### 快捷按钮
|
||||
- **5分钟**：开始5分钟倒计时
|
||||
- **6分钟**：开始6分钟倒计时
|
||||
- **其它**：打开配置对话框
|
||||
|
||||
### 配置功能
|
||||
点击"其它"按钮可以打开配置对话框：
|
||||
- **自定义倒计时**：设置自定义倒计时时间（秒）
|
||||
- **提前告警**：设置倒计时结束前多少秒播放告警提示音，默认30秒
|
||||
- **窗口置顶**：设置窗口是否置顶
|
||||
- **窗口透明度**：设置窗口透明度（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` - 打包技巧说明
|
||||
|
||||
187
README（分支机构）.md
Normal file
187
README（分支机构）.md
Normal file
@@ -0,0 +1,187 @@
|
||||
# 述职计时器（分支机构版）
|
||||
|
||||
一个使用 PySide6 构建的倒计时应用程序，专为述职演讲设计，美观大方，支持多种倒计时模式。
|
||||
|
||||
## 最新更新
|
||||
|
||||
- **界面优化**：采用浅蓝色调设计，更加清新美观
|
||||
- **按钮调整**：将原来的"5分钟"和"6分钟"按钮合并为"4分钟"按钮
|
||||
- **位置优化**：微缩窗口默认距离右边缘40像素，距离上边缘30像素
|
||||
- **焦点管理**：切换到微缩模式时自动将焦点还给上一个进程
|
||||
|
||||
## 功能特点
|
||||
|
||||
### 界面设计
|
||||
- **浅蓝色调**：采用清新的浅蓝色（#e8f4f8）作为主色调
|
||||
- **圆角设计**：15px圆角边框，美观大方
|
||||
- **无标题栏**：可通过拖动窗口任意位置移动窗口
|
||||
- **两种状态**：正常状态和微缩状态
|
||||
|
||||
### 界面状态
|
||||
程序有两种界面状态：
|
||||
|
||||
#### 1. 正常状态
|
||||
- 显示倒计时时间和完整的按钮区域
|
||||
- 可以通过拖动窗口的任何位置来移动窗口
|
||||
- 显示按钮区域："4分钟"和"其它"按钮
|
||||
- 窗口大小：500×300像素
|
||||
|
||||
#### 2. 微缩状态
|
||||
- 点击"4分钟"按钮开始倒计时后，延迟2秒自动切换到微缩状态
|
||||
- 只显示倒计时时间
|
||||
- 窗口大小：120×50像素
|
||||
- 位置：距离屏幕上边缘30像素，距离右边缘40像素（可配置）
|
||||
- **焦点管理**：切换到微缩状态时自动将焦点还给上一个进程
|
||||
- 双击界面后暂停倒计时，并切换回正常状态
|
||||
|
||||
### 快捷按钮
|
||||
- **4分钟**：开始4分钟（240秒）倒计时
|
||||
- **其它**：打开配置对话框
|
||||
|
||||
### 配置功能
|
||||
点击"其它"按钮可以打开配置对话框：
|
||||
|
||||
| 配置项 | 说明 | 默认值 |
|
||||
|--------|------|--------|
|
||||
| 自定义秒数 | 设置自定义倒计时时间（1-3600秒） | 240秒 |
|
||||
| 提前告警(秒) | 设置倒计时结束前多少秒播放告警提示音 | 30秒 |
|
||||
| 窗口置顶 | 设置窗口是否置顶 | 开启 |
|
||||
| 窗口透明度 | 设置窗口透明度（10%-100%） | 100% |
|
||||
| 距离右边缘 | 微缩窗口距离屏幕右边缘的像素值 | 40像素 |
|
||||
| 距离上边缘 | 微缩窗口距离屏幕上边缘的像素值 | 30像素 |
|
||||
| 测试告警 | 测试告警提示音 | - |
|
||||
| 退出程序 | 退出程序（唯一退出方式） | - |
|
||||
|
||||
### 告警功能
|
||||
- **提前告警**：倒计时结束前设置的秒数时播放告警提示音
|
||||
- **循环播放**：告警音循环播放3次
|
||||
- **音量控制**：告警音音量设置为80%
|
||||
- **倒计时结束效果**：
|
||||
- 微缩模式：文字红黄闪烁效果
|
||||
- 正常模式：文字跳动 + 透明度闪烁效果
|
||||
|
||||
### 音频支持
|
||||
- 支持自定义告警音效
|
||||
- 优先从外部目录加载 `alarm.wav` 音频文件
|
||||
- 若外部未找到，则使用内置音频文件
|
||||
|
||||
### 焦点管理
|
||||
- **智能焦点归还**：切换到微缩模式时自动将焦点还给上一个进程
|
||||
- **窗口层级管理**：微缩窗口自动置于其他窗口下方
|
||||
- **无干扰设计**：不影响用户在其他应用程序中的操作
|
||||
|
||||
## 使用说明
|
||||
|
||||
### 快速开始
|
||||
1. 运行程序（双击 `countdown.exe` 或运行 `python countdown.py`）
|
||||
2. 程序启动后显示正常状态界面
|
||||
3. 点击"4分钟"按钮开始4分钟倒计时
|
||||
4. 2秒后自动切换到微缩状态
|
||||
5. 在微缩状态下双击可以暂停并回到正常状态
|
||||
|
||||
### 详细操作指南
|
||||
|
||||
#### 1. 启动程序
|
||||
- 方法一：双击 `countdown.exe`（已打包版本）
|
||||
- 方法二：运行 `python countdown.py`（源代码版本）
|
||||
|
||||
#### 2. 开始倒计时
|
||||
- 点击"4分钟"按钮：开始4分钟倒计时
|
||||
- 点击"其它"按钮 → 设置自定义时间 → 点击"开始倒计时"：使用自定义时间
|
||||
|
||||
#### 3. 窗口操作
|
||||
- **移动窗口**：在正常状态下，拖动窗口任意位置可移动窗口
|
||||
- **切换状态**：开始倒计时后2秒自动切换到微缩状态
|
||||
- **恢复状态**：在微缩状态下双击窗口可暂停倒计时并恢复为正常状态
|
||||
|
||||
#### 4. 配置设置
|
||||
1. 点击"其它"按钮打开配置对话框
|
||||
2. 根据需要调整各项配置：
|
||||
- 设置自定义倒计时时间
|
||||
- 调整提前告警时间
|
||||
- 开启/关闭窗口置顶
|
||||
- 调整窗口透明度
|
||||
- 设置微缩窗口位置
|
||||
3. 点击"确认并保存"应用设置
|
||||
4. 点击"测试告警"测试告警音效
|
||||
5. 点击"退出程序"退出应用程序
|
||||
|
||||
#### 5. 告警提示
|
||||
- 倒计时结束前30秒（默认）会播放告警提示音
|
||||
- 告警音循环播放3次
|
||||
- 倒计时结束时显示"时间已到"并有视觉特效
|
||||
|
||||
### 音频配置
|
||||
1. 准备一个 `alarm.wav` 音频文件
|
||||
2. 将文件放置在以下位置之一：
|
||||
- 与 `countdown.exe` 同一目录
|
||||
- 当前工作目录
|
||||
3. 程序会优先加载外部音频文件
|
||||
|
||||
## 技术栈
|
||||
- **编程语言**：Python 3.11+
|
||||
- **GUI框架**：PySide6 (Qt 6)
|
||||
- **音频支持**：Qt Multimedia
|
||||
- **打包工具**：PyInstaller
|
||||
|
||||
## 打包命令
|
||||
```bash
|
||||
python -m PyInstaller --onefile --windowed --icon=Timer.ico --name=述职计时器 countdown.py
|
||||
```
|
||||
|
||||
## 文件说明
|
||||
| 文件 | 说明 |
|
||||
|------|------|
|
||||
| `countdown.py` | 主程序源代码 |
|
||||
| `Timer.ico` | 程序图标文件 |
|
||||
| `alarm.wav` | 默认告警音频文件 |
|
||||
| `2alarm.wav` | 备用告警音频文件 |
|
||||
| `README.md` | 原始说明文档 |
|
||||
| `README（分支机构）.md` | 分支机构版说明文档（本文档） |
|
||||
| `操作手册.md` | 详细操作手册 |
|
||||
| `要求.txt` | 功能需求文档 |
|
||||
| `clean.py` | 清理打包残留文件 |
|
||||
| `SKILL.md` | 打包技巧说明 |
|
||||
|
||||
## 开发说明
|
||||
|
||||
### 代码结构
|
||||
- `TimerApp` 类：主应用程序类
|
||||
- `ConfigDialog` 类：配置对话框类
|
||||
- 主要方法：
|
||||
- `init_ui()`：初始化用户界面
|
||||
- `start_countdown()`：开始倒计时
|
||||
- `set_mini_state()`：切换到微缩状态
|
||||
- `return_focus_to_previous_window()`：焦点归还功能
|
||||
- `open_config()`：打开配置对话框
|
||||
|
||||
### 关键特性实现
|
||||
1. **无标题栏窗口**：使用 `Qt.FramelessWindowHint`
|
||||
2. **窗口拖动**：重写 `mousePressEvent` 和 `mouseMoveEvent`
|
||||
3. **微缩状态**：定时器控制状态切换
|
||||
4. **焦点管理**：使用 `clearFocus()`、`lower()` 和 `requestActivate()`
|
||||
5. **音频播放**：使用 `QSoundEffect` 播放告警音
|
||||
|
||||
### 自定义修改
|
||||
如需自定义程序，可修改以下部分：
|
||||
- 界面颜色：修改 `setStyleSheet` 中的颜色值
|
||||
- 按钮时间：修改 `start_countdown` 中的时间参数
|
||||
- 窗口位置：修改 `config` 字典中的 `right_margin` 和 `top_margin`
|
||||
- 音频文件：替换 `alarm.wav` 文件
|
||||
|
||||
## 注意事项
|
||||
1. 首次运行请确保 `alarm.wav` 与可执行文件在同一目录
|
||||
2. 微缩窗口位置可在配置中自定义调整
|
||||
3. 程序退出必须通过配置对话框中的"退出程序"按钮
|
||||
4. 焦点归还功能仅在切换到微缩状态时生效
|
||||
5. 窗口置顶功能可能在某些系统上表现不同
|
||||
|
||||
## 版本历史
|
||||
- **v1.0**：基础版本，支持5分钟和6分钟倒计时
|
||||
- **v1.1**：界面优化，改为浅蓝色调
|
||||
- **v1.2**：按钮调整，合并为4分钟按钮
|
||||
- **v1.3**：位置优化，微缩窗口位置调整
|
||||
- **v1.4**：焦点管理，自动归还焦点功能
|
||||
|
||||
## 支持与反馈
|
||||
如有问题或建议，请参考源代码进行调试或联系开发人员。
|
||||
13
SKILL.md
Normal file
13
SKILL.md
Normal file
@@ -0,0 +1,13 @@
|
||||
## 元数据
|
||||
name: pyinstaller个性化打包
|
||||
description: 打包的时候，要求生成为一个exe文件，使用ico等等
|
||||
|
||||
## 概述
|
||||
此 Skill 用于给有GUI界面的python代码，打包的时候，生成一个统一的要求：生成一个exe文件，去掉控制台窗口，使用本目录下的ico文件作为程序的图标。打包时，如果之前有打包过的文件（dist/build 文件夹），自动覆盖旧文件，不用手动确认，一键打包到底。
|
||||
|
||||
## 打包命令示例
|
||||
python -m PyInstaller --onefile --windowed --icon=图标文件名.ico --name=guba-indicator --exclude-module PyQt5 --exclude-module PyQt5.QtCore --exclude-module PyQt5.QtGui --exclude-module PyQt5.QtWidgets --exclude-module PyQt6 --exclude-module PyQt6.QtCore --exclude-module PyQt6.QtGui --exclude-module PyQt6.QtWidgets python程序名.py
|
||||
|
||||
|
||||
## 清除多余文件
|
||||
在windows环境下，执行clean.py
|
||||
17
clean.py
Normal file
17
clean.py
Normal file
@@ -0,0 +1,17 @@
|
||||
import os
|
||||
import shutil
|
||||
import glob
|
||||
import subprocess
|
||||
|
||||
# 2. 清理打包残留文件 等价：rd /s /q build + del /f *.spec
|
||||
print("开始清理打包残留文件...")
|
||||
# 删除build文件夹
|
||||
if os.path.exists("build") and os.path.isdir("build"):
|
||||
shutil.rmtree("build")
|
||||
# 删除所有.spec文件
|
||||
spec_files = glob.glob("*.spec")
|
||||
for spec_file in spec_files:
|
||||
if os.path.exists(spec_file):
|
||||
os.remove(spec_file)
|
||||
|
||||
print("✅ 打包完成 + 残留文件清理完毕！exe文件已生成在当前目录")
|
||||
BIN
countdown.exe
Normal file
BIN
countdown.exe
Normal file
Binary file not shown.
1150
countdown.py
1150
countdown.py
File diff suppressed because it is too large
Load Diff
61
操作手册.md
Normal file
61
操作手册.md
Normal file
@@ -0,0 +1,61 @@
|
||||
# 述职计时器 操作手册
|
||||
|
||||
## 一、概述
|
||||
|
||||
述职计时器是一款专为述职演讲设计的倒计时工具。
|
||||
|
||||
## 二、快速开始
|
||||
|
||||
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 同目录** 或 **当前工作目录**
|
||||
- 程序会优先从外部目录加载，若未找到则使用内置音频
|
||||
|
||||
## 五、注意事项
|
||||
|
||||
1. 首次运行请确保 `alarm.wav` 与 exe 在同一目录，否则告警功能不可用
|
||||
2. 微缩窗口位置可在配置中自定义
|
||||
3. 窗口支持拖拽，可放置在屏幕任意位置
|
||||
34
要求.txt
34
要求.txt
@@ -1,18 +1,18 @@
|
||||
目的：写一个python语言的，pyside6库作为界面的应用程序。
|
||||
功能：倒计时显示和提醒。
|
||||
界面需求：整体要美观大方。
|
||||
1. 窗口无标题栏，可以通过点击并拖动任何位置移动窗口
|
||||
2. 倒计时显示区域：显示分和秒的倒计时，字体大且醒目
|
||||
3. 界面分为2个状态：
|
||||
a. 正常状态：显示时间，点击箭头，显示按钮区域，再点击箭头，按钮区域折叠
|
||||
b. 微缩状态：点击"5分钟"后，延迟2秒，界面改为微缩状态，只有时间区域和向下箭头
|
||||
4. 微缩状态详情：
|
||||
- 窗口长为200px，高为60px
|
||||
- 距离top为50px，距离屏幕右边留出空白200px的距离
|
||||
- 点击向下箭头，回到正常状态的位置和大小
|
||||
5. 快捷按钮：第一个按钮是"5分钟"，第二个按钮是"6分钟"，第三个按钮是"其它"
|
||||
6. 其它按钮功能：打开配置页面，可以设置自定义倒计时时间、提前告警时间、窗口置顶选项、透明度设置
|
||||
7. 告警功能：倒计时结束前设置的秒数时播放告警提示音，循环3次
|
||||
8. 倒计时结束后：显示"时间已到"文字，带有跳动和闪动效果
|
||||
9. 配置对话框：增加退出按钮，只有通过此按钮才能退出程序
|
||||
目的：写一个python语言的，pyside6库作为界面的应用程序。
|
||||
功能：倒计时显示和提醒。
|
||||
界面需求：整体要美观大方。
|
||||
1. 窗口无标题栏，可以通过点击并拖动任何位置移动窗口
|
||||
2. 倒计时显示区域：显示分和秒的倒计时，字体大且醒目
|
||||
3. 界面分为2个状态：
|
||||
a. 正常状态：显示时间，点击箭头，显示按钮区域，再点击箭头，按钮区域折叠
|
||||
b. 微缩状态：点击"5分钟"后，延迟2秒，界面改为微缩状态，只有时间区域和向下箭头
|
||||
4. 微缩状态详情：
|
||||
- 窗口长为200px，高为60px
|
||||
- 距离top为50px，距离屏幕右边留出空白200px的距离
|
||||
- 点击向下箭头，回到正常状态的位置和大小
|
||||
5. 快捷按钮：第一个按钮是"5分钟"，第二个按钮是"6分钟"，第三个按钮是"其它"
|
||||
6. 其它按钮功能：打开配置页面，可以设置自定义倒计时时间、提前告警时间、窗口置顶选项、透明度设置
|
||||
7. 告警功能：倒计时结束前设置的秒数时播放告警提示音，循环3次
|
||||
8. 倒计时结束后：显示"时间已到"文字，带有跳动和闪动效果
|
||||
9. 配置对话框：增加退出按钮，只有通过此按钮才能退出程序
|
||||
10. 测试要求：使用pyqt-test库作为gui程序的测试工具。
|
||||
Reference in New Issue
Block a user