# WindowsLock

**Repository Path**: YUERHOO/windows-lock

## Basic Information

- **Project Name**: WindowsLock
- **Description**: WindowsLock 是一款专为 Windows 平台设计的自动锁屏工具。当您的电脑处于闲置状态时，它会自动监测鼠标和键盘活动，并在达到设定时间后自动锁屏，有效保护您的隐私和安全。
- **Primary Language**: Python
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-09-24
- **Last Updated**: 2026-01-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# WindowsLock

## 📋 项目介绍

WindowsLock 是一款专为 Windows 平台设计的自动锁屏工具。当您的电脑处于闲置状态时，它会自动监测鼠标和键盘活动，并在达到设定时间后自动锁屏，有效保护您的隐私和安全。

## ✨ 主要功能

- **智能闲置检测**：自动监测鼠标和键盘活动状态
- **可自定义时间设置**：根据需求调整闲置锁屏时间（默认30秒）
- **锁屏前预警通知**：在锁屏前5秒发送通知提醒
- **系统托盘运行**：后台运行，不影响正常工作
- **Windows安全集成**：使用您设置的Windows用户密码进行锁屏

## 🏗️ 技术架构

- **编程语言**：Python
- **GUI框架**：PyQt5/PySide2
- **系统集成**：Windows API
- **通知系统**：plyer (跨平台通知库)
- **打包工具**：PyInstaller

## 📦 安装说明

### 环境要求
- Windows 7/8/10/11
- Python 3.6+
- 必要的Python依赖包

### 安装步骤

1. **克隆项目**
   ```bash
   git clone https://gitee.com/YUERHOO/windows-lock.git
   cd windows-lock
   ```

2. **安装依赖**
   ```bash
   pip install -r requirements.txt
   ```

3. **运行程序**
   ```bash
   python WindowsLock.py
   ```

### 打包成exe（可选）

使用 PyInstaller 将程序打包为独立的可执行文件：

```bash
pyinstaller -F -w -i 222.jpg --add-data "222.jpg;." WindowsLock.py --hidden-import plyer.platforms.win.notification
```

> **注意**：222.jpg 为图标 icon 以及托盘图标 icon

**参数说明：**
- `-F`：打包成单个可执行文件
- `-w`：不显示控制台窗口
- `-i 222.jpg`：设置程序图标
- `--add-data "222.jpg;."`：将图标文件添加到程序中
- `--hidden-import plyer.platforms.win.notification`：隐藏导入 plyer 的通知模块

打包完成后，可执行文件位于 `dist/` 目录下。


## 🎮 使用说明

1. **启动程序**
   - 双击运行 `WindowsLock.exe`（打包后）或 `python WindowsLock.py`
   - ![输入图片说明](%E8%BD%AF%E4%BB%B6%E4%B8%BB%E7%95%8C%E9%9D%A2.png)

2. **设置闲置时间**
   - 程序启动后，可以设置闲置锁屏时间（默认30秒）

3. **开始监控**
   - 点击"开始"按钮，程序将开始监控鼠标和键盘活动

4. **锁屏流程**
   - 当检测到闲置达到设定时间后：
     - 首先发送预警通知
     - 等待5秒，如果仍无操作则自动锁屏
   - 使用您的 Windows 用户密码解锁

5. **系统托盘**
   - 程序最小化后将在系统托盘运行
   - 右键点击托盘图标可进行设置或退出

## ⚙️ 功能详情

| 功能 | 说明 |
|------|------|
| 闲置检测 | 自动监测鼠标移动和键盘输入 |
| 锁屏执行 | 调用 Windows API 实现锁屏 |
| 通知提醒 | 在锁屏前5秒发送系统通知 |
| 计时重置 | 检测到活动时自动重置计时器 |
| 后台运行 | 最小化至系统托盘，不占用任务栏 |

## 🤝 参与贡献

1. **Fork 本仓库**
2. **创建特性分支**
   ```bash
   git checkout -b feat/your-feature-name
   ```
3. **提交更改**
   ```bash
   git commit -m "Add: your feature description"
   ```
4. **推送分支**
   ```bash
   git push origin feat/your-feature-name
   ```
5. **提交 Pull Request**

## 📄 许可证

本项目采用 MIT 许可证，详情请参阅 [LICENSE](LICENSE) 文件。

## 🙏 致谢

感谢所有为这个项目做出贡献的开发者！

---

**注意**：锁屏密码为您 Windows 系统设置的用户密码，请确保已设置密码以保证安全性。