# 屏幕活动状态监控脚本

**Repository Path**: felix641/screen_monitor.py

## Basic Information

- **Project Name**: 屏幕活动状态监控脚本
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-12-18
- **Last Updated**: 2025-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 屏幕活动状态监控脚本

📌 一个基于Python的脚本，用于监测用户屏幕活动状态，自动判断“工作”与“空闲”状态，并记录详细日志。

![监控示意图](https://via.placeholder.com/800x400?text=Screen+Activity+Monitoring) <!-- 可替换为实际示意图 -->

## 🚀 功能特性
- **智能状态检测**：通过像素变化分析屏幕活动
- **多维度配置**：支持自定义检测间隔/敏感度/日志路径
- **精确区域监控**：可排除任务栏等干扰区域
- **跨平台支持**：Windows/macOS/Linux（需配置依赖）
- **实时日志记录**：记录完整状态切换时间线

## 📦 环境要求
- Python 3.6+  目前最高支持到[3.12.9]
- 依赖库：
  ```bash
  pip install numpy pillow

## ⚙️ 配置说明
  # 配置文件参数（脚本顶部区域）
````
CHECK_INTERVAL = 5          # 检测间隔（秒）
INACTIVITY_THRESHOLD = 10   # 无操作判定阈值（秒） 
SCREEN_CHANGE_THRESHOLD = 100000  # 像素变化敏感度
MONITOR_REGION = (0, 0, 1920, 1040)  # 监控区域 (左,上,右,下)
LOG_FILE = "screen_activity.log"     # 日志文件路径
````

## 🛠️ 安装与使用

# 1、克隆仓库
````
git clone https://gitee.com/alaska-ancient-kabi/screen_monitor.py.git
cd screen-monitor
````

# 2、安装依赖
````
pip install -r requirements.txt

````

# 3、调整配置（可选）

根据屏幕分辨率修改 MONITOR_REGION

调整敏感度阈值适应不同环境

# 4、运行监控
````
python screen_monitor.py
````

# 5、停止监控
````
Ctrl + C （自动记录终止状态）
````

## 📋 日志示例

````
[2023-10-20 09:15:00] 状态: 脚本启动
[2023-10-20 09:15:05] 状态: 开工
[2023-10-20 09:25:15] 状态: 未开工
[2023-10-20 09:30:00] 状态: 开工
[2023-10-20 17:45:00] 状态: 脚本手动停止

````

## ⚠️ 注意事项
### 区域设置建议：

- Windows系统建议排除底部40像素（默认配置）

- macOS建议排除Dock区域（约下方100像素）

- 双屏用户需指定具体显示器

### 敏感度调试：

- 办公场景建议阈值 100000-200000

- 开发环境建议阈值 50000-100000

- 使用 test_mode.py 获取实时像素变化值

### 特殊场景：

- 视频会议时建议暂停监控

- 动态壁纸用户需提高阈值

- 全屏应用自动忽略区域外变化

## ❓ 常见问题
### Q：为什么频繁切换开工/未开工状态？
### A：尝试以下步骤：

- 适当提高 SCREEN_CHANGE_THRESHOLD

- 检查是否排除动态元素区域

- 启用连续变化检测模式（需修改代码）