1. 环境与授权前提

  1. 当前目标环境为 HarmonyOS 7 / API 26;HarmonyOS 6 兼容尝试已失败,后续不再以 HarmonyOS 6 为兼容目标。
  2. 仅在你有权管理的 HarmonyOS 设备、Windows 主机和 RDP 端点上使用。不要把公开文档当作绕过组织策略的说明。
  3. HarmonyOS 设备与 Windows 主机需要位于同一可达局域网,并允许用户输入目标 Host 与 TCP 8765。
  4. 准备两端都能看到的一次性配对码。配对码用于确认当前会话,不应复制到公开渠道或日志中。
  5. 如果使用直接 RDP,请先确认目标 Windows 支持并已启用 RDP,再获得端点的明确授权并准备证书指纹核对信息。

3. 获取 HAP

HarmonyOS HAP 通过站外页面公开提供:下载窗花VaseDesk HAP。安装前请核对文件来源、签名状态、版本号和设备兼容性。

当前不参与 AppGallery Connect 邀请测试;站外 HAP 下载不等于华为商店上架或真机验收。

4. 准备已验证来源的 Windows 助手

Windows Agent 可从迅雷云盘获取,提取码为 j444。部署前请核对文件来源、版本、签名状态和 Windows x64 兼容性。

文档站不替你自动安装二进制文件,也不会通过自动发现或自动 USB 网络共享修改 Windows 网络设置。

5. 从 Home 添加助手

  1. 打开 Home 的连接管理入口,填写便于识别的名称。
  2. 输入 Windows 主机的 Host 和 TCP 8765 端口。端点必须属于同一可达局域网。
  3. 提交后观察助手状态。只有进入已配对、已连接状态,窗口捕获等路径才具备前置条件。
  4. 在两端核对一次性配对码,确认不是过期、重复或来自其他主机的代码。

6. 排查连接与恢复

助手未出现

检查 Host、端口、局域网可达性和 Windows 防火墙;确认助手确实在监听 TCP 8765,并重新读取状态。

配对失败

重新生成并核对两端可见的一次性配对码。策略不匹配、代码过期或连接到错误 Host 时,不要继续重试旧会话。

恢复连接

从 Home 选择既有助手,确认授权和配对状态,再恢复会话。不要把恢复令牌或诊断导出内容贴到公开问题区。

手机与性能边界

当前 UI 布局会导致手机上无法使用;模拟器中观察到的 30–60 FPS 和约 100 ms 延迟不代表真机功耗、发热或长期体验。