entry/src/main/ets
ArkTS 页面、UIAbility、工作区、标签、SubWindow、会话和布局协调器。界面引擎保持 ArkWeb only。
架构地图 · 公开范围
技术说明
本页帮助技术协作者定位模块和证据，不把依赖存在、编译通过或接口命名解释成完整运行能力。
模块地图
ArkWeb rawfiles
本地页面、隐私同意入口、i18n 资源和规范性法律页面。页面运行时不依赖远程 CDN；网页浏览功能尚未完成，当前不对外开放。
entry/src/main/cpp
NAPI 类型边界、输入映射、WebRTC/RDP 原生占位与资源生命周期桥接；导出保持小而明确。
windows-agent
Windows 连接助手、配对、窗口枚举和 WGC/libwebrtc 相关路径。助手采用用户手动输入的 Host 和 TCP 8765。
scripts 与 acceptance records
PowerShell 合同、浏览器 QA、静态/构建/运行时记录和发布材料。记录只支持其对应证据等级。
两条主要数据流
Windows窗口捕获
- HarmonyOS客户端
- 配对控制通道
- Windows助手
- WGC/libwebrtc
直接RDP
- HarmonyOS客户端
- NAPI/FreeRDP
- 用户授权的RDP端点
自研编排与外部依赖
自研边界
工作区路由、标签与独立窗口生命周期、配对会话、权限/授权状态、输入映射、窗口几何同步和发布合同属于本项目编排。
平台与第三方边界
HarmonyOS UIAbility、ArkWeb、SubWindow、权限和系统输入是平台能力；FreeRDP、libwebrtc、OpenSSL、qrcodegen、WiX 与用户安装的 Parsec VDD 是外部依赖或提供方。
接口与证据纪律
跨模块通信使用 IAgentClient、ITransport、IRemoteSession、CredentialStore 等带类型的边界；不通过 UI 组件直接持有外部能力。
静态合同、单元测试、未签名 HAP、Playwright 截图和一次运行结果都必须注明自己的范围。它们不能自动升级为真机、AppGallery 或商业发布结论。
兼容性与体验观察
当前目标
当前以 HarmonyOS 7 / API 26 为目标。HarmonyOS 6 兼容尝试已失败，后续不再以 HarmonyOS 6 为兼容目标。
模拟器观察
在 MatePad Pro 13 英寸 HarmonyOS 7 Beta1 API 26 模拟器中，Windows Agent 远控体验约为 30–60 FPS、约 100 ms 延迟；同时连接两个 Agent 捕获画面已验证成功。
物理设备边界
开发者没有鸿蒙物理设备用于功耗、发热和真实使用体验测试。模拟器数据不代表真机表现，实际体验以用户自己的设备为准。
手机布局
当前 UI 布局会导致手机上无法使用，平板模拟器观察不能升级为手机可用性结论。