电脑唤醒
电脑唤醒 是一款面向 HarmonyOS 手机和平板的一站式局域网设备工具，支持电脑扫描与分组、局域网/公网 WOL 唤醒、桌面卡片快捷开机、远程控制、关机和休眠。
应用还集成了 SMB、HTTP、WebDAV 和网页中转共享、屏幕共享与远程标注、蓝牙/星闪聊天、运输单 OCR、文字转语音、视频播放、防烧屏悬浮窗、日志及数据备份等功能。
应用市场链接: https://appgallery.huawei.com/app/detail?id=com.weiv.wol&channelId=SHARE&source=appshare
项目信息
- 应用包名：
com.weiv.wol - 当前版本：
1.1.1 - 运行平台：HarmonyOS 手机、平板
- SDK：HarmonyOS
6.1.0 (API 23) - 技术栈：ArkTS、ArkUI、Stage 模型、Hvigor、C++ NAPI、Python
设备与网络唤醒
- 添加、编辑、删除设备，并按分组管理和折叠展示。
- 通过 IP、MAC、备注和自定义背景区分设备。
- 编辑设备时可复制当前配置并快速新增另一台设备。
- 定时探测设备在线状态，显示设备总数、在线数和分组数。
- 发送标准 Wake-on-LAN 魔术包，并在发送后继续确认设备是否上线。
- 支持局域网广播、远程 UDP 转发和 TCP 转 UDP 网关三种唤醒方式。
- 支持 IPv4、IPv6、域名和自动广播地址探测，并带有多级发送回退。
- 记录每次唤醒的时间、结果与失败原因。
- 支持设备配置的跨设备手势分享与深链导入。
- 在线设备可从卡片上的 SMB 图标直接进入匹配的共享配置。
- 首页提供悬浮添加入口，可快速打开设备新增面板。
- 首次使用提供分步引导，说明设备添加、扫描、唤醒和背景绘制入口。
局域网扫描与诊断
- 快速扫描：读取系统邻居表，快速发现已有网络邻居和 MAC 地址。
- 完整扫描：自动识别当前网段并并发 Ping 探测，也可输入自定义 CIDR 网段。
- 扫描过程显示阶段、进度和已发现设备，并可随时停止。
- 扫描结果可直接补充信息并保存为唤醒设备。
- 可设置 MAC 地址保存为大写或小写。
- 提供独立的 IP、端口连通性诊断工具。
- C++ NAPI 实现原生 Ping 能力，同时用于扫描和在线状态检测。
桌面快捷入口与服务卡片
- 系统快捷入口可直接进入扫描页，或唤醒设备列表中的第一台电脑。
- 提供
1x2、2x4快捷唤醒服务卡片。 - 可将卡片绑定到指定电脑；局域网直连设备同步显示真实在线状态，已在线时免发魔术包。
- 域名转发 / TCP转UDP 方式的设备点卡片始终照常发送魔术包：转发服务常年在线，ping 域名结果不代表电脑已开机，不用于拦截唤醒。
电脑远程控制
- 内置 UDP 远控会话，可接收电脑端 JPEG/PNG 分片画面并回传触摸、鼠标和键盘操作。
- 支持触屏模式、指针模式、全屏触摸板、遥控器布局和完整远程键盘。
- 支持单击、双击、拖动、右键、横向/纵向滚动、捏合缩放、任务切换等多指手势。
- 支持陀螺仪飞鼠，可调整灵敏度、方向反转和停留自动点击。
- 遥控器按键布局可自定义、设为默认并通过分享码导入导出。
- 触摸板提供多种粒子拖尾样式，也可以完全关闭动效。
- 远程键盘支持沉浸布局，键盘、触摸板和遥控器均可设为默认进入界面。
- 支持文本直接输入，以及用文字或语音发送自然语言指令。
- 电脑端可按规则执行打开应用、搜索、快捷键、音量、窗口和电源等动作；可选本地 GGUF 模型处理复杂指令。
- 支持 OCR 定位屏幕文字并点击目标。
- 提供 RDP 地址连通性探测入口；当前完整画面与输入回传以项目内置 UDP 协议为主。
- 配套 Windows 服务支持 DXGI 截屏、键鼠注入、锁屏辅助、令牌校验和只看画面模式。
- 远控全屏时自动适配横屏，退出后恢复方向；手机息屏再打开时会尝试恢复远控会话。
电脑端详细说明见 REMOTE_CONTROL_README.md。仓库内也包含已打包的 Windows 远控发布包：
entry/src/main/python/dist_release/wol_remote_control_v0.4.32.zip。
远程关机与休眠
- 安装配套 Windows 服务后，可在设备列表中远程关机或休眠。
- 关机操作带确认和倒计时，并支持取消已提交的关机任务。
- 应用内提供服务包下载、安装配置说明和健康检查。
SMB 文件共享
- 内置基于 TCP 的 SMB2 客户端和 NTLM 认证，不依赖第三方文件管理器。
- 可保存多套服务器配置、枚举共享目录并浏览文件夹。
- 支持文件列表刷新、路径导航、目录滚动位置恢复和断开连接。
- 支持远程图片全屏预览、相册切换、预加载和删除。
- 支持远程视频列表播放、边下载边缓冲、进度显示、横竖屏切换和删除。
HTTP / WebDAV 媒体共享
- 可保存多个 HTTP 视频目录地址，并支持 Basic Auth。
- 自动解析目录中的视频和子文件夹，支持普通目录与平铺聚合浏览。
- 支持面包屑导航，并在返回目录后恢复滚动位置和提示上次进入项。
- 平铺模式会先展示当前目录内容，再并发扫描子目录并增量追加结果，同时带有超时保护。
- 支持 MP4、MKV、AVI、MOV、WMV、FLV、WebM、M3U8 等常见格式。
- 播放器支持播放列表、进度拖动、倍速、画面比例、横竖屏切换和播放偏好记忆。
- 支持 WebDAV
PROPFIND目录读取及文件、文件夹的重命名和删除。 - 当前自实现 WebDAV 文件操作仅支持
http://端点。
网页共享中转站
- 可手动输入地址或扫码打开网页形式的局域网共享服务。
- 支持将文件、图片和文本直接拖入 WebView 中转站发送。
- 支持一次拖入多个文件或多段文本并批量处理。
- 小文件可通过网页桥接自动上传；大文件会交给网页文件选择控件继续处理。
- 自动拦截拖入文件导致的网页跳转，并尝试识别网页中的上传、发送或提交按钮。
屏幕共享与标注
- 捕获本机屏幕并在应用内预览。
- 可启动局域网网页观看地址，并通过二维码或复制链接分享。
- 支持把预览放入可移动、可缩放的系统悬浮窗。
- 可扫描另一台设备的观看地址，在本机 WebView 或悬浮窗中查看。
- 支持远程标注，将观看端的绘制内容回传到共享端显示。
蓝牙与星闪通信
- 蓝牙模块可读取已配对设备，并通过 SPP 建立服务端/客户端连接和收发文本消息。
- 在支持星闪的设备上显示星闪广播入口；不支持时自动隐藏。
- 星闪模块支持无网近距离文字、语音广播和附近用户发现。
- 可设置昵称、头像、个人介绍和接收策略，并在地图中展示附近在线用户。
- 相关功能会按需申请蓝牙、星闪、位置和麦克风权限。
运输单 OCR
- 一次选择多张运输单图片并连续识别。
- 自动提取流水号、车号、日期、供货/收货单位、地址、货名、过磅员及毛重、皮重、净重等字段。
- 支持一张图片中多张单据的分段、裁剪和独立识别。
- 提供字段候选、重量关系校验、日期校验、手动修正和常用修正记忆。
- 可自定义导出字段及表头顺序，并导出 Excel 兼容文件。
本地与教程视频
- 内置多段功能教程视频，也可从设备中一次选择多个本地视频。
- 视频列表展示缩略图、时长、大小和创建时间。
- 支持上下滑切换视频、沿进度条方向滑动快进/快退，以及长按进度条精确定位。
- 拖动进度时显示对应画面缩略图，支持进度条常显或自动隐藏。
- 支持自动旋转、横竖屏全屏、连续播放和屏幕右侧左滑删除。
- 删除本地视频时优先移入系统回收站；内置教程视频不会被删除。
防烧屏悬浮窗
- 可创建和管理多个悬浮遮罩，每个窗口独立启用、配置和保存位置。
- 支持一键应用内置配置，以及统一开启或关闭全部悬浮窗。
- 可调整遮罩颜色、透明度、圆角、宽度、高度和显示文字。
- 支持拖动锁定、点击穿透和长按切换锁定状态。
- 轻点任一遮罩即以该窗为编辑对象并弹出半透明磨砂设置面板，可直接开关当前遮罩，并调整圆角、宽高、显示文本和尺寸、显示文本、锁定拖动与点击穿透；参数与应用内设置页实时同步并自动回显。
- 按住悬浮设置面板顶部标题区域可自由拖动；关闭后再次打开会沿用本次运行中最后拖到的位置，并自动限制在屏幕可见范围内。
- 长按遮罩 3 秒切换拖动锁定，长按满 5 秒打开悬浮设置面板；开启点击穿透后由遮罩右上角常显的低亮度深色齿轮图标承接这些操作。
- 提供触摸放大镜、文本放大倍率和液态玻璃效果设置。
- 横竖屏切换时会调整窗口位置，相关样式与坐标可随应用备份恢复。
其他工具
- 生活嘴替：使用系统 TTS 外放文字，支持英文、数字、停顿和多音字播报标记。
- 设备背景绘制：支持画笔、橡皮、清空、颜色和粗细调整，也可选择图片或预设背景。
- 内置帮助文档和 Windows WOL 一键配置包，可辅助完成网卡与系统侧 WOL 设置。
- 文件日志支持按文件查看、刷新、清理、导出到下载目录和请求系统预览。
- 功能模块定制：可按“扫描、共享、信息、工具”分组隐藏或恢复入口。
- 手动导出、导入应用备份，覆盖设备、分组、背景资源及相关偏好设置。
- 支持 HarmonyOS 系统备份与恢复扩展。
- 联系页面提供邮箱、QQ群号、二维码及快捷入群入口。
页面结构
首页使用五个底部入口组织功能：
| 入口 | 内容 |
|---|---|
| 设备 | 设备列表、分组、在线状态、唤醒、远控、关机/休眠、背景编辑 |
| 扫描 | 快速扫描、完整扫描、手动添加、网络诊断 |
| 共享 | SMB、HTTP / WebDAV、WebView 共享 |
| 信息 | 唤醒历史、版本更新、运行日志 |
| 工具 | 卡片、蓝牙、星闪、TTS、屏幕共享、OCR、教程、备份和模块定制 |
除“设备”和“工具”中的模块定制入口外，大部分入口都可以在“工具 > 定制模块”中隐藏或恢复。
数据存储与备份
- 设备、分组、历史记录和功能开关使用 HarmonyOS Preferences 持久化。
- 设备背景、星闪头像等文件资源会随手动备份一起导出。
- 导入备份会恢复配置和资源；操作前建议先导出当前数据。
- 应用声明了系统备份扩展，可参与系统的数据备份与恢复流程。
权限说明
| 权限类型 | 用途 |
|---|---|
| 网络、Wi-Fi、IP/MAC 信息 | WOL、扫描、在线检测、共享和远控 |
| 系统悬浮窗 | 屏幕共享悬浮预览、防烧屏遮罩 |
| 蓝牙 | SPP 设备发现与消息通信 |
| 星闪、位置 | 附近用户广播与地图展示 |
| 麦克风 | 语音消息、语音指令 |
| 陀螺仪 | 飞鼠控制 |
| 振动 | 远程输入按键与开关的触感反馈 |
部分系统级权限依赖签名证书和设备能力；星闪入口只会在检测到相应能力时显示。
安全提示
- WOL、内置远控、屏幕共享和远程关机主要面向可信局域网使用。
- Windows UDP 远控协议为明文传输，请设置连接令牌，不要直接暴露到公网。
- 公网使用时应通过可信 VPN 或加密隧道接入，并限制远控和关机服务端口。
- SMB、HTTP 和 WebDAV 凭据只应配置在可信设备上。