From dbaff55d3a3ba06ef5889fb5583bbab9eb1840d0 Mon Sep 17 00:00:00 2001 From: xiaji Date: Thu, 22 Jan 2026 14:17:09 +0800 Subject: [PATCH] =?UTF-8?q?feat(=E7=84=A6=E7=82=B9=E7=AE=A1=E7=90=86):=20?= =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E5=BE=AE=E7=BC=A9=E6=A8=A1=E5=BC=8F=E6=97=B6?= =?UTF-8?q?=E8=87=AA=E5=8A=A8=E5=BD=92=E8=BF=98=E7=84=A6=E7=82=B9=E5=8A=9F?= =?UTF-8?q?=E8=83=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 新增 return_focus_to_previous_window 方法，在切换到微缩模式时自动清除当前窗口焦点并将其置于其他窗口下方，同时尝试激活上一个窗口。更新README文档说明新增功能特性。 --- README（分支机构）.md | 187 ++++++++++++++++++++++++++++++++++++++++++ countdown.py | 21 +++++ 2 files changed, 208 insertions(+) create mode 100644 README（分支机构）.md diff --git a/README（分支机构）.md b/README（分支机构）.md new file mode 100644 index 0000000..1971752 --- /dev/null +++ b/README（分支机构）.md @@ -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**：焦点管理，自动归还焦点功能 + +## 支持与反馈 +如有问题或建议，请参考源代码进行调试或联系开发人员。 \ No newline at end of file diff --git a/countdown.py b/countdown.py index 17d726e..3bed9a1 100644 --- a/countdown.py +++ b/countdown.py @@ -264,6 +264,9 @@ class TimerApp(QWidget): x = screen_geometry.width() - self.width() - self.config['right_margin'] y = self.config['top_margin'] self.move(x, y) + + # 将焦点还给上一个进程 + self.return_focus_to_previous_window() def center_on_screen(self): screen = QApplication.primaryScreen() @@ -382,6 +385,24 @@ class TimerApp(QWidget): self.anim_group.addAnimation(self.flash_anim) self.anim_group.start() + def return_focus_to_previous_window(self): + # 清除当前窗口的焦点 + self.clearFocus() + + # 将窗口置于其他窗口下方 + self.lower() + + # 尝试激活其他窗口 + app = QApplication.instance() + windows = app.topLevelWindows() + + # 找到不是当前窗口的其他窗口 + for window in windows: + if window != self.windowHandle() and window.isVisible(): + # 尝试激活其他窗口 + window.requestActivate() + break + def open_config(self): dialog = ConfigDialog(self, self.config) if dialog.exec() == QDialog.Accepted: