支持与测试
当前版本:iOS / iPadOS 1.32(46),Mac 0.28.0。支持同网局域网连接,以及在 Chordesk 内登录自己的 Tailscale 私人网络后跨网连接。无需另装 Tailscale App。界面目前以简体中文为主。
开始连接
- 安装 Mac 0.28.0 主机,需要 Apple Silicon 与 macOS 15.2 或更新版本。安装包已签名、公证;将 Chordesk 拖入 Applications 后打开。
- 逐项允许屏幕录制与辅助功能/控制权限;每项授权后,若 macOS 要求退出并重新打开,请按提示操作。两项权限生效后开启服务。不需要文稿访问或完全磁盘访问。
- 局域网:两端连接可互通的同一网络,在手机/iPad 的“连接 Mac”中扫描当前二维码并允许本地网络访问。也可手动输入配对信息。无需账号;之后从已配对列表重连。
- 跨网络:在两端 Chordesk 登录同一 Tailscale 私人网络,开启相应服务后配对。自动模式会尝试可用连接。Tailscale 账号和连接元数据由其服务及身份提供商按各自政策处理。
操作指南
菜单内有“Duo 操作手册”,也可看 完整说明 或 真机演示。默认无背面接触时直接触控;背面一指配合正面双指上下滑控制窗口总览、左右滑切换桌面;背面双指按住临时切换正面触控板,松开恢复。普通 iPhone/iPad 使用屏幕模式按钮。切桌面还需要 Mac 的 System Events 自动化权限和对应系统快捷键。
常见问题
确认主机服务运行、权限生效、局域网没有客户端隔离;跨网连接须两端都已登录可互访的私人网络。尝试刷新在线状态或重新扫码更新配对地址。连接时才采屏,断开后停止。显示器息屏与系统睡眠不同:主机保持运行时可以重连;真正睡眠或合盖不保证可达。音频传输已关闭。
背面交互需要兼容 Duo、相机授权和前台采集会话。帧不显示、不保存、不传输。若无响应,抬起手指并检查有效区域与相机状态;必要时重开背面操作,记录复现步骤。
反馈与隐私
在 TestFlight 安装,或通过 TestFlight 反馈、GitHub Issues、styj@zju.edu.cn 联系我们。请提供设备、系统、应用版本和复现步骤;公开反馈勿包含私人桌面、账号或有效二维码。阅读隐私政策。
Support & testing
Current versions: iOS / iPadOS 1.32 (46), Mac 0.28.0. Connect over a local network, or across networks by joining your own Tailscale private network inside both Chordesk apps. No separate Tailscale app is required. The app interface is primarily Simplified Chinese.
Connect
- Download Chordesk Mac 0.28.0 for Apple Silicon with macOS 15.2 or later. The installer is Developer ID signed and Apple notarized. Drag Chordesk to Applications and open it.
- Grant Screen Recording and Accessibility/control separately. Reopen the app after each permission if macOS asks you to quit and reopen. Start service when both permissions are effective. Documents access and Full Disk Access are not required.
- LAN: put both devices on the same reachable network. Open Connect Mac (连接 Mac) on your iPhone/iPad, scan the current host QR, and allow local-network access. Manual pairing is also available. No account is needed. Reconnect from the saved list afterward.
- Across networks: sign both Chordesk endpoints into the same Tailscale private network and enable its host connection service, then pair. Automatic mode tries available paths. Tailscale and your identity provider handle account and connection metadata under their own policies.
Gestures
Use the in-app Duo operation manual, the written guide (Chinese), or the real-device video. Default: no rear contact for Direct Touch; hold one rear finger and swipe two front fingers up/down for Mission Control, left/right for Spaces; hold two rear fingers for a temporary front trackpad and release to restore Direct Touch. Other iPhones/iPad use the on-screen mode selector. Spaces switching also needs optional Mac System Events authorization and the corresponding system shortcuts.
Troubleshooting
Check the host service, effective permissions, and any LAN client isolation. Cross-network access needs both nodes signed into a private network with access to each other. Refresh status or scan a fresh QR to update pairing addresses. Screen capture runs only with a connected viewer. Display-off differs from system sleep: an awake host can reconnect, but actual sleep or closed-lid access is not guaranteed. Audio transmission is disabled.
Rear interaction needs a compatible Duo, camera permission and an active foreground session. Camera frames are discarded, not displayed, stored or transmitted. If rear input stops, lift all fingers and check its activation region and camera status; toggle rear control if needed and report reproduction steps.
Feedback & privacy
Install with TestFlight. Send TestFlight feedback, open a GitHub issue, or email styj@zju.edu.cn. Include device, OS/app versions and reproduction steps. Public issues must not include private screens, accounts or valid pairing codes. Read the privacy policy.