# 珍珠奶茶 Bubble Tea 计算机防休眠防屏保专家

**Repository Path**: ahsin/bubble-tea

## Basic Information

- **Project Name**: 珍珠奶茶 Bubble Tea 计算机防休眠防屏保专家
- **Description**: 珍珠奶茶 计算机防屏保防休眠工具
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-13
- **Last Updated**: 2026-09-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center"><img src="ui/logo.png" alt="珍珠奶茶 Bubble Tea" width="120"/></p>

<p align="center"><img src="ui/info.jpg" alt="珍珠奶茶 Bubble Tea 信息图" width="240"/></p>

# 珍珠奶茶 Bubble Tea

> **珍珠奶茶 计算机防屏保防休眠工具**

一个轻量、开箱即用的 Windows 防屏保 / 防休眠小工具。基于 PySide6 构建，通过 Windows API `SetThreadExecutionState` 实现防休眠，**无需管理员权限**，也**不会修改系统的电源计划设置**。

## 开发说明

本项目由 AI 全程辅助开发完成——涵盖需求分析、代码实现、界面与图标设计、打包构建到发布上线的完整流程。

## 功能特性

- 🛡️ 一键开启 / 关闭防休眠、防屏保
- 🪟 点击 ✕ 自动最小化到系统托盘，后台持续运行
- 🧋 托盘图标左键单击即可还原主窗口
- 🎨 跟随 Windows 深色 / 浅色主题自动切换界面配色（WinUI3 风格）
- 🍵 奶茶主题 Logo，应用名「珍珠奶茶 Bubble Tea」

## 工作原理

程序通过 `ctypes` 调用 Windows API：

```python
SetThreadExecutionState(ES_CONTINUOUS | ES_SYSTEM_REQUIRED | ES_DISPLAY_REQUIRED)
```

- `ES_SYSTEM_REQUIRED` — 通知系统当前有程序正在运行，禁止进入睡眠
- `ES_DISPLAY_REQUIRED` — 通知系统当前正在使用显示器，禁止关闭屏幕（屏保）
- `ES_CONTINUOUS` — 持续生效，直到显式清除

该机制与「播放视频/音乐时不休眠」原理相同，安全、无副作用，关闭后系统立即恢复正常行为。

## 项目结构

```
bubble tea/
├── AntiSleep/                  # 主程序目录
│   ├── main.py                 # 程序入口
│   ├── main_window.py          # 主窗口逻辑（UI 加载、按钮、状态）
│   ├── anti_sleep.py           # 核心模块：Windows API 防休眠实现
│   ├── system_tray.py          # 系统托盘模块
│   ├── theme_manager.py        # WinUI3 黑白自适应主题（预编译 QSS）
│   ├── generate_rc.py          # 资源编译脚本（qrc → py、png → ico）
│   ├── build.py                # PyInstaller 一键打包脚本
│   ├── requirements.txt        # Python 依赖
│   └── ui/                     # 界面资源
│       ├── main_window.ui      # 窗口 UI 定义（Qt Designer 格式）
│       ├── resources.qrc       # Qt 资源清单
│       ├── resources_rc.py     # 编译后的资源模块
│       ├── logo.png            # 应用图标（源图）
│       └── logo.ico            # 应用图标（打包用）
└── ui/                         # 设计素材（Logo 源文件等）
```

## 环境要求

- Windows 7 / 10 / 11
- Python 3.8+（开发构建环境）
- PySide6 >= 6.5.0

## 快速开始

### 1. 直接运行（开发模式）

```bash
cd AntiSleep
pip install -r requirements.txt

# 首次运行前需编译资源（若 ui/resources_rc.py 已存在可跳过）
python generate_rc.py

# 启动
python main.py
```

### 2. 打包为单文件 exe

```bash
cd AntiSleep
pip install pyinstaller
python build.py
```

打包完成后，可执行文件位于 `AntiSleep/dist/珍珠奶茶 Bubble Tea.exe`，双击即可运行，无需安装 Python。

## 使用说明

1. 打开程序后点击 **「启 动」**，程序即开始防休眠、防屏保
2. 点击 **「关 闭」** 恢复系统正常休眠行为
3. 点击窗口右上角 **✕** 可最小化到系统托盘，程序后台继续运行
4. 托盘图标左键单击还原窗口；右键菜单可「显示窗口」或「退出」

## 常见问题

**Q：需要管理员权限吗？**
不需要。`SetThreadExecutionState` 是普通用户可调用的 API，程序不会请求提权。

**Q：会修改系统电源设置吗？**
不会。程序仅在运行时临时声明「系统忙」，关闭后系统恢复原状，不写入任何注册表或电源计划。

**Q：为什么点击 ✕ 后程序还在托盘里？**
这是设计行为。点 ✕ 表示「最小化到托盘」，如需完全退出请使用托盘右键菜单的「退出」。

## 版本迭代规则

版本号采用 `0.x` 格式：

- `x` 为个位数，取值范围 `0 ~ 9`
- 依次递增：`0.1 → 0.2 → … → 0.9 → 1.0 → 1.1 → … → 9.9`
- 最高版本号为 `9.9`

## 版本记录

- **V0.3** — 当前版本
  - 主界面新增开发者署名「ahsinsoft」，点击直达作者 Gitee 主页
- **V0.2**
  - 引入 WinUI3 黑白自适应主题
  - 优化托盘交互（左键单击还原窗口）
  - QSS 预编译，无运行时开销

## 许可证

本项目开源协议：**拿去随便玩，与我无关**。

你可以自由使用、修改、分发甚至商用本项目代码，无需署名。作者不提供任何担保，因使用本项目产生的任何后果与作者无关。