# 伴行-PC-Client

**Repository Path**: gabr/cosing-pc-client

## Basic Information

- **Project Name**: 伴行-PC-Client
- **Description**: 伴行-远程自律监督系统-PC客户端仓库 
《伴行》是一款专为需要提升自制力、克服网络依赖的用户设计的远程监督软件。
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-20
- **Last Updated**: 2026-01-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 伴行-PC-Client

#### 介绍
伴行-远程自律监督系统-PC客户端仓库
《伴行》是一款专为需要提升自制力、克服网络依赖的用户设计的远程监督软件。

## 最近更新

### 2026-01-15: 移除心跳机制，完全基于视频流判断在线状态

**改进**: 移除心跳和定时离线检测，改为完全依赖视频流传输判断在线状态
- ✅ 有视频流传输 = 在线且正在监督
- ✅ 无视频流传输 = 离线或未监督
- ✅ 启动监督时立即显示在线
- ✅ 停止监督时5秒内显示离线
- ✅ 关闭客户端时5秒内显示离线
- ✅ 逻辑更清晰，状态更准确

### 2026-01-03: 升级为WebSocket长连接通信

**改进**: 使用WebSocket替代HTTP轮询，实现实时双向通信
- ✅ 减少网络请求次数，降低服务器负载
- ✅ 实时响应服务器推送消息
- ✅ 自动重连机制，保证连接稳定性
- ✅ 支持所有操作（设备注册、事件上报、截图上传、视频流传输）
- ✅ 视频流帧通过base64编码在WebSocket中传输
- ✅ HTTP作为降级方案，确保兼容性

**依赖**: 新增 `websocket-client>=1.6.0`

### 2024-12-31: 修复截图黑色命令行窗口闪烁问题

**问题**: 每次截图时会瞬间弹出黑色命令行窗口,闪烁 4 次

**原因**: PIL 的 `ImageGrab.grab()` 在 Windows 上会调用系统命令(如 `wmic.exe`)获取屏幕信息

**解决方案**: 使用 MSS (Multiple Screen Shots) 库替代 PIL 的 ImageGrab
- ✅ 不再出现命令行窗口闪烁
- ✅ 截图速度提升 30-50%
- ✅ 直接使用 Windows API,无需外部进程

详细信息请查看 [SCREENSHOT_FIX.md](SCREENSHOT_FIX.md)