HMTrans v0.3.0

HMTrans v0.3.0

v0.3.0 在稳定文件互传基础上新增 MatePad 到 Mac 的本地加密投屏，并继续保持无账号、无云端、局域网直连。

主要更新

• MatePad 使用 HarmonyOS 系统屏幕采集授权和原生 H.264 硬件编码，Mac 使用 VideoToolbox 解码并自动打开独立观看窗口。
• 支持普通窗口、画中画、全屏、方向变化、会话统计、停止和有限重连。
• 提供 720P 级、1080P 级、2K 级与 30P/60P 组合，实际可用档位以设备硬件编码能力为准。
• 一台 Mac 最多同时接收两台 MatePad；双路基线限制为不高于 1080P 级/30P。
• Pad 设置页提供投屏网络测试，展示吞吐量、往返延迟、抖动和推荐档位。
• 配对升级为六位码认证的 X25519 临时协商；文件元数据、解除配对和投屏媒体使用用途隔离密钥认证。
• 修复设备名称、IP 字节序、配对重连、解除配对、历史聚合、传输状态、下载目录与多项深浅色交互问题。

系统要求

• macOS 26 或更高版本。
• HarmonyOS 6.1.0 / API 23 或更高版本。
• 两台设备位于同一局域网，并完成六位配对码配对。

发布与安装

• Mac 版通过 GitHub Release 提供 HMTrans.dmg。当前使用 ad-hoc 签名、未经 Apple 公证，首次打开可能需要右键“打开”或在“隐私与安全性”中允许。
• HarmonyOS v0.3.0 已完成当前目标设备测试，仍需使用应用市场正式 Profile/证书签名并上传；GitHub Release 不提供可替代应用市场正式签名的 HAP。

当前边界

• 投屏只从 MatePad 发起，Mac 主窗口不提供主动启动入口。
• 不传输声音，不把 MatePad 作为扩展显示器，不在 HMTrans 内录制画面。
• 不提供键盘、鼠标或触控反向操作；重新设计的 Mac 启动入口和反向操作计划放入 v0.3.1。
• 投屏画面仅在内存中加密传输和解码显示，不写入文件历史或下载目录。

HMTrans v0.2.1

HMTrans v0.2.1

本次更新替换了原有的 v0.2.1 安装包，版本号保持不变，包含截至 2026 年 7 月 17 日的最新连接、配对、设备信息、传输状态和安装包布局修复。建议 Mac 与 MatePad 两端都重新安装或升级到最新的 v0.2.1。

本次替换包新增修复

• 修复 macOS DMG 打开后窗口尺寸异常、工具栏出现和图标布局错乱的问题，安装窗口现在使用固定布局。
• 修复 Mac 端只显示 Pad 型号名、无法显示用户设置的完整设备名称的问题。
• 修复 HarmonyOS 当前网络 IPv4 地址字节顺序颠倒的问题，例如 192.168.3.204 不再错误显示为 204.3.168.192。
• 修复首次安装后点击设备无响应、配对码校验失败，以及已配对设备重新连接无反应的问题。
• 修复双端连接状态不同步，以及已连接后仍残留“正在确认身份”提示的问题。
• 修复任意一端删除配对关系后，对端仍显示连接中或无法重新配对的问题。
• 修复文件实际接收完成后，Pad 端仍停留在“准备中”的问题。
• 修复同一台设备因名称变化或历史别名被拆分成多个历史记录分组的问题。
• 清理 HarmonyOS 发布构建中的异常处理警告，并完善相关状态测试。

配对与连接改进

• 正常覆盖升级会保留已配对设备，并自动尝试恢复连接。
• 完全卸载后重新安装会生成新的应用身份，需要重新输入六位配对码。
• 首次配对只需在任意一端输入另一端显示的六位配对码。
• 任意一端删除已配对设备后，对端会实时退出已连接状态，再次连接时需要重新配对。
• 优化设备发现、在线状态、断线检测、受信任设备心跳和重连逻辑。
• 优化传输完成回执，发送端只有在收到接收端最终确认后才会显示完成。

HarmonyOS 权限说明

• ohos.permission.READ_LOCAL_DEVICE_NAME：读取系统中设置的完整设备显示名称，用于在 Mac 端正确显示 Pad 名称。
• ohos.permission.READ_WRITE_DOWNLOAD_DIRECTORY：将接收文件保存到文件管理器可见的 Download 目录。
• 文件仍然只通过局域网在设备之间直传，不上传云端，也不需要账号。

使用说明

• Mac 与 MatePad 需要连接同一 Wi-Fi。
• 建议双端同时升级到本次最新的 v0.2.1，旧包与新包混用可能无法获得完整修复。
• HarmonyOS 端应授予应用所需的设备名称、网络和下载目录权限。

系统要求

• macOS 26 或更高版本
• HarmonyOS 6.1.0 / API 23 或更高版本

macOS 安装包校验

• 文件名：HMTrans.dmg
• SHA-256：162e76f8a3b95e55c9b0ec399b69d6d4db0a6eadb50f271e8121c0bea85df301

macOS 安装包使用本地 ad-hoc 签名，未经过 Apple 公证。若首次打开时被系统阻止，请前往“系统设置 → 隐私与安全性”选择“仍要打开”。

HMTrans v0.2.0

HMTrans v0.2.0

HMTrans 是一款面向 macOS 与 HarmonyOS 的局域网原文件互传工具。文件在设备之间直接传输，不经过云端服务器，不需要账号。

新增功能

• 新增六位配对码与设备身份指纹验证
• 支持暂停、继续、取消、重试和断点续传
• 支持文件夹及多层嵌套文件夹传输
• 支持 SHA-256 完整性校验
• 支持同时向多个已连接设备发送文件
• 支持不同设备传输不同文件
• 支持活动传输后台保护
• 新增传输历史、状态筛选和按设备管理
• 新增本地诊断信息、下载目录检查和网络端口设置
• 优化深色模式、窗口尺寸、横竖屏、分屏和浮窗适配

隐私与安全

• 不提供账号、云盘、统计、广告或公网中转服务
• 文件只在用户选择的局域网设备之间直接传输
• 临时分片保存在应用私有目录，完整校验成功后才发布最终文件
• 当前版本未启用 TLS 或端到端内容加密，请仅在可信局域网中使用

系统要求

• macOS 26.0 或更高版本
• HarmonyOS 6.1.0 / API 23 或更高版本
• v0.2 使用新的配对与传输协议，Mac 和 HarmonyOS 端需要同时升级
• 从 v0.1 升级后建议重新完成设备配对

安装说明

下载并打开 HMTrans.dmg，将 HM互传拖入“应用程序”目录。

由于当前 Mac 版本未使用 Apple Developer ID 签名和公证，首次运行时 macOS 可能显示安全提示。可在系统设置的“隐私与安全性”中确认打开。

HarmonyOS v0.2 将通过华为应用市场单独发布，目前正在准备提交审核。

问题反馈

如遇到连接或传输问题，请复制应用设置页中的诊断信息，并在 GitHub Issues 中反馈：

https://github.com/tppc-linksc/HMTrans/issues

HMTrans v0.1.0

• macOS 端通过 DMG 安装
• HarmonyOS 端请在应用市场搜索“HM互传”
• 当前 macOS 版本未签名、未公证，首次打开可能需要手动允许