1. 环境与授权前提
- 当前目标环境为 HarmonyOS 7 / API 26;HarmonyOS 6 兼容尝试已失败,后续不再以 HarmonyOS 6 为兼容目标。
- 仅在你有权管理的 HarmonyOS 设备、Windows 主机和 RDP 端点上使用。不要把公开文档当作绕过组织策略的说明。
- HarmonyOS 设备与 Windows 主机需要位于同一可达局域网,并允许用户输入目标 Host 与 TCP 8765。
- 准备两端都能看到的一次性配对码。配对码用于确认当前会话,不应复制到公开渠道或日志中。
- 如果使用直接 RDP,请先确认目标 Windows 支持并已启用 RDP,再获得端点的明确授权并准备证书指纹核对信息。
2. 隐私同意与会话范围
首次进入工作台时先阅读并同意隐私与条款页面。拒绝同意时不继续建立远程会话。
本地配置、恢复令牌和诊断信息的边界见隐私与数据;规范性内容以页脚列出的四份法律文档为准。
3. 获取 HAP
HarmonyOS HAP 通过站外页面公开提供:下载窗花VaseDesk HAP。安装前请核对文件来源、签名状态、版本号和设备兼容性。
当前不参与 AppGallery Connect 邀请测试;站外 HAP 下载不等于华为商店上架或真机验收。
4. 准备已验证来源的 Windows 助手
Windows Agent 可从迅雷云盘获取,提取码为 j444。部署前请核对文件来源、版本、签名状态和 Windows x64 兼容性。
文档站不替你自动安装二进制文件,也不会通过自动发现或自动 USB 网络共享修改 Windows 网络设置。
5. 从 Home 添加助手
- 打开 Home 的连接管理入口,填写便于识别的名称。
- 输入 Windows 主机的 Host 和 TCP 8765 端口。端点必须属于同一可达局域网。
- 提交后观察助手状态。只有进入已配对、已连接状态,窗口捕获等路径才具备前置条件。
- 在两端核对一次性配对码,确认不是过期、重复或来自其他主机的代码。
6. 排查连接与恢复
助手未出现
检查 Host、端口、局域网可达性和 Windows 防火墙;确认助手确实在监听 TCP 8765,并重新读取状态。
配对失败
重新生成并核对两端可见的一次性配对码。策略不匹配、代码过期或连接到错误 Host 时,不要继续重试旧会话。
恢复连接
从 Home 选择既有助手,确认授权和配对状态,再恢复会话。不要把恢复令牌或诊断导出内容贴到公开问题区。
手机与性能边界
当前 UI 布局会导致手机上无法使用;模拟器中观察到的 30–60 FPS 和约 100 ms 延迟不代表真机功耗、发热或长期体验。
下一步
完成后进入工作台操作;如需核对范围,先看能力与限制。