wecom_it_smart_desk/overview.md

# 创维电视远程控制工具 — 概述

## 完成内容

为创维电视开发了完整的远程控制工具，支持三大核心功能：

| 功能 | 命令 | 技术方案 |
|------|------|----------|
| 远程检查 | `tv.bat check` | Ping 检测 + ADB `dumpsys power` 查询屏幕状态 |
| 远程关机 | `tv.bat off` | ADB `input keyevent 26`（POWER键，进入待机） |
| 远程唤醒 | `tv.bat on` | WOL 魔法包 + ADB唤醒（三重降级） |

额外功能：`toggle`（自动开关切换）、`pair`（ADB配对）、`scan`（局域网ADB设备扫描）、`config`（配置管理）

## 文件清单

- `tools/tv_remote/skyworth_tv.py` — 主控制脚本（Python）
- `tools/tv_remote/tv.bat` — Windows快捷启动器
- `tools/tv_remote/tv_config.json` — 配置文件（首次config后自动生成）
- `C:\Users\simon\platform-tools\platform-tools\adb.exe` — ADB工具（已安装）

## 用户待操作

1. **电视开启无线调试**：设置 → 关于 → 连点「版本号」7次 → 开发者选项 → 无线调试 → 开启
2. **ADB配对**：电视选「用代码配对」→ `tv.bat pair --port <端口号> --code <6位码>`
3. **配置IP和MAC**：`tv.bat config --ip 192.168.3.xxx --mac AA:BB:CC:DD:EE:FF`
4. 日常使用：`tv.bat check` / `tv.bat off` / `tv.bat on` / `tv.bat toggle`

## 技术决策

- 选择 ADB + WOL 而非红外方案：用户无IR设备，有线网络WOL可靠
- ADB CLI 优先于 adb-shell 库：配对流程更可靠
- WOL 用纯Python socket：零外部依赖
- 关机用待机而非彻底关机：保留网络唤醒能力