Windows
- 社区版默认从 GitCode 获取；也可以通过 GitHub 备用下载；官方版通过爱发电交付
- 首次安装已内置 .NET 运行时；需要虚拟麦克风时按提示配置 VB-CABLE
- 官方版更新失败时保留完整 Setup 作为兜底；更新助手仅在替换程序时请求一次 UAC，健康检查失败会自动回滚，不要删除当前可运行版本
- 连接前检查局域网、防火墙和目标输出设备，再开始传输
01 · 快速开始
先把两端准备好
当前正式支持 Windows 与 Android。安装两端应用后，按连接环境选择 LAN、Wi-Fi Direct、Bluetooth 或 USB，再开始音频传输。
02 · 下载与安装
把两端准备好
Android
- 社区版默认从 GitCode 获取；也可以通过 GitHub 备用下载；官方版通过爱发电交付 APK
- 首次安装或更新时，按 Android 提示允许来自未知来源的安装
- 完整 APK 覆盖安装在包名和签名一致时会保留应用数据
- 连接前检查系统音频、麦克风权限和当前选择的链路
03 · 连接方式
不知道选哪条链路？
同一局域网优先 LAN；没有路由器或网络隔离时尝试 Wi-Fi Direct；近距离低带宽场景使用 Bluetooth；需要有线兜底时使用 USB。
连接前五项确认
- 手机与电脑选择了相同的链路方式。
- 局域网模式下，两台设备处于可互通的网络中。
- 电脑防火墙允许墨堤完成发现、握手和音频连接。
- 使用虚拟麦克风路线时，目标软件选择了正确的输入设备。
- 在应用中查看四条链路的实时状态和当前输出设备。
04 · 常见问题
从现象开始排障
声音与连接
没有声音怎么办？
先确认两端都显示已连接，再检查 Android 当前音频输入、Windows 输出设备和音量；若使用虚拟麦克风，确认 VB-CABLE 已安装并在目标应用中选择正确设备。
局域网发现不到设备怎么办？
确认手机和电脑在同一可互访网络；检查 Windows 防火墙和路由器 AP 隔离。公共 Wi-Fi 或校园网常常禁止设备互访。
Wi-Fi Direct 一直连接或反复超时怎么办？
Wi-Fi Direct 受手机、无线网卡和系统 P2P 实现影响。先重新扫码并确认目标；仍不稳定时改用 LAN 或 USB，不要对附近陌生设备试连。
USB 第一次怎么用？
使用数据线连接后，在 Android 开发者选项中开启 USB 调试，按系统提示允许这台电脑；回到墨堤确认 USB 设备已出现，再开始连接。
版本与开发
社区版和官方版有什么区别？
两者使用同一应用核心能力。社区版从 GitHub 或 GitCode 获取，用户自行关注版本；官方版通过爱发电交付，提供官方打包、国内更新和持续维护。收费内容不是核心功能解锁。
可以二次开发吗？
可以。应用层核心源码在 GitHub 开放，遵循 GPLv3 许可。需要参与开发时，请从公开源码和仓库文档开始。
更新与恢复
Android 官方版如何更新？
官方版下载完整 APK，并交给 Android 系统安装器覆盖安装。包名和签名一致时会保留数据；如果系统提示签名不一致，请停止安装并从官方入口重新获取安装包。
Windows 官方版更新失败怎么办？
先保留当前版本，不要删除用户数据；重新从官方入口获取完整 Setup 作为兜底。更新助手仅在替换程序时请求一次 UAC，健康检查失败会自动回滚，失败不会改变当前可运行版本。
官方更新验证失败怎么办？
如果看到 UPDATE_AUTH_REJECTED，这表示官方更新凭据或交付状态无法通过验证。自动更新会停止，但现有功能不受影响；请从爱发电或官方入口重新获取官方包。不要向任何页面提交 Token。
如何提交排障信息？
请提供应用版本、操作系统、所选链路、现象发生时间和导出的脱敏日志；不要公开订单号以外的支付凭据、访问 Token 或二维码完整内容。
05 · 版本与更新
版本从哪里来
社区版的源码和正式 Release 以 GitHub 为主，GitCode 提供国内社区镜像；官方版通过爱发电验证并使用官方更新服务。版本号以应用实际显示和对应 Release 为准。06 · 协议与开发者