Chordesk Mac 0.28.0 - LAN reconnection fix

Apple Silicon Mac beta, macOS 15.2 or later. iPhone companion: TestFlight 1.31.

Developer ID signed and Apple notarized. Both the app and final DMG have stapled tickets and passed Gatekeeper assessment.

Fixed

• LAN service follows the Mac's current interface addresses instead of remaining bound to an old Wi-Fi/IP address.
• Withdraw stale QR endpoints and rebuild only the affected exact-address listeners. Pairing credentials, authenticated sessions and the separate Tailscale listener are preserved.
• Ignore late callbacks from retired listeners; a local listener failure retries without stopping an active Tailscale session.
• Avoid unnecessary interface-view refreshes when addresses have not changed.

Install / upgrade

Quit the running Chordesk, open the DMG and drag Chordesk into Applications to replace it. Do not fully uninstall for a normal update. Stable bundle ID, publisher identity and saved pairing remain. First-time users must grant Screen Recording and Mac control separately and follow each macOS restart prompt.

If a phone was offline when the Mac changed networks, connect once through Tailscale to learn the new LAN address, or scan the current QR. This update does not add a Bonjour discovery feature.

Validation: 198 regression tests: 197 passed, one skipped because the user's live service occupied the fixed production port, zero failures. Tests cover TLS authentication after listener replacement, preservation of an accepted session, stale callbacks, and public/wildcard address rejection. The developer confirmed real Duo LAN picture and input before publication; this is not a claim of every router/environment being tested.

Screen capture remains on demand for an authenticated viewer; audio is disabled. Closed-lid operation is not guaranteed. The new Liquid Glass iOS layout remains a separate preview and is not included in this Mac release.

---

Apple Silicon Mac 0.28.0 /43：修复换网后仍监听旧 IP、局域网无法连接的问题。只更新受影响的局域网监听，保留配对、已有认证连接与 Tailscale；旧回调不能恢复过期端点。App 与最终 DMG 已签名公证。退出旧版后拖入 Applications 覆盖即可，正常更新无需完整卸载。手机离线期间换网后，可先经 Tailscale 重连同步新地址或重新扫码。用户已确认 Duo 局域网画面与触控正常。

Chordesk Mac 0.27.1 - Signed & notarized

Apple Silicon Mac beta, macOS 15.2 or later. iPhone companion: TestFlight.

Developer ID signed and Apple notarized. The app and final DMG both have stapled tickets and passed Gatekeeper assessment. No Xcode or developer mode is required on the Mac.

Changes

• Native Help > Uninstall Chordesk flow with App-only or full removal. Fixes the 0.27.0 temporary-path alias rejection and shutdown stall; checks helper readiness before any removal.
• Permission status distinguishes not granted, granted but restart required, and available. Follow macOS restart prompts after each grant.
• Explicit local Keychain recovery for Tailscale authentication failures after upgrades, with a separately confirmed rebind option.
• Stable Developer ID publisher and original app identity for future upgrades. An initial migration from older ad hoc builds may still require local permission/Keychain confirmation.

Install and test

Open the DMG, then drag Chordesk into Applications. Quit an older running instance before replacing it. Locally approve Screen Recording and Mac control; optional desktop switching also requires System Events automation. Two permissions must be effective before service starts.

194 Swift regression checks and seven isolated maintenance checks passed. App-only uninstall/reinstall was exercised on the developer's Mac. Full removal clears local Chordesk permission decisions, pairing and login; it does not delete nodes in your Tailscale account. Please test first launch and upgrade behavior on your own Mac.

Screen capture runs only while an authenticated viewer is connected. No BlackHole or BetterDisplay is bundled; audio is disabled. Closed-lid operation is not guaranteed. Apple notarization is not an App Store review or a guarantee that every environment is supported.

---

Apple Silicon 测试版，需 macOS 15.2 或更新系统。App 与最终 DMG 均已通过 Apple 公证并装订票据；安装时将 Chordesk 拖入 Applications，按系统提示逐项授权、重开。修复内嵌卸载的路径误判与退出卡住，增加三态权限提示及明确的钥匙串恢复入口。旧临时签名版本迁移可能仍需一次本机确认。合盖运行仍不保证可用。

Chordesk Mac 0.26.0 · Apple Silicon test

Chordesk Mac 0.26.0 / build 39 · Apple Silicon · macOS 15.2+

Changes

• Capture on demand: keep the host reachable over LAN and embedded Tailscale without capturing or encoding while idle. Start capture for an authenticated connected viewer; stop on disconnect and keep reconnection available. macOS privacy indicators remain during active sharing.
• Independent stream controls with iOS 1.31: 480p /720p /1080p /1440p /2160p, a 15–120 fps ceiling, and target bitrate. New preferences default to 720p /15 fps /1.5 Mbps and HEVC, with H.264/JPEG fallback. Saved preferences remain.
• Bounded testing on the current paired Mac-to-phone connection provides conservative bitrate/FPS recommendations for manual application; no external speed-test service.
• Clearer Tailscale action buttons and permission/restart guidance. Bilingual drag-to-Applications DMG layout.
• Remove legacy local Mac simulator and single-window experiments; consolidate historical documentation. The concept website remains available.

Install / update

1. Open the DMG and drag Chordesk to Applications. Quit the old host before replacing its app; keep the same installed location for updates.
2. This is an ad hoc signed, unnotarized test build with no verified Developer ID publisher. Only allow it through macOS Privacy & Security if you trust this source. Do not disable Gatekeeper/SIP. Managed Macs may block installation.
3. On first use, grant Screen Recording and Mac control separately. After each grant, reopen Chordesk if macOS requests it; start service after both are effective. Spaces switching additionally needs the optional System Events permission.
4. Pair from iPhone once by QR, then reconnect from saved Macs. LAN needs no account. Cross-network access uses the same personal Tailscale network signed into both Chordesk apps; no separate Tailscale app is required.

iPhone TestFlight · Operation guide · Website

The iOS rollout is separate. Existing iOS 1.30 can connect; independent quality controls and the immediate rear-contact default require iOS 1.31. Verify the installed TestFlight version. Actual FPS/bitrate depends on hardware, display and network; 120 fps is a request ceiling. Audio is disabled; closed-lid/system-sleep availability is not guaranteed.

Validation: 183 logic/TLS/hardware-codec tests and three targeted simulator UI checks passed. On Duo, the user confirmed picture/control and capture stopping on disconnect. This does not establish all quality settings, weak-network recommendations, ordinary-iPhone hardware or long-term energy performance.

中文

• 服务在线与采屏分离：无手机连接不采屏、不编码；认证连接后才共享，断开停止采集并保留重连。
• 搭配 iOS 1.31 可独立选择 480p–2160p、15–120 fps 上限和目标码率，限量测速后手动应用推荐。新偏好默认 720p /15 fps /1.5 Mbps、HEVC，保留旧偏好与兼容回退。
• 登录按钮、权限旁重开提示及 DMG 拖拽指引更明确；清理旧模拟代码与历史文档。
• 未公证的 Apple Silicon 试用包。打开 DMG 后将 App 拖到 Applications；每项系统权限授权后可能需要重开 App。仅在信任来源时按 macOS 提示允许此 App，不关闭系统安全机制。
• iOS 发布单独进行；1.30 可连接，新增独立画质与双指即时触发默认需 1.31。旧偏好保留；120 fps 不代表实测或保证。音频关闭，合盖／睡眠仍可能断连。

Project-owned code/content: CC BY-NC-SA 4.0; third-party licenses remain applicable.

Chordesk Mac 0.25.0 · Apple Silicon test release

Companion for Chordesk iOS 1.30 / build 39. Apple Silicon (M-series), macOS 15.2+. This is an unnotarized test release, locally ad-hoc signed; Developer ID / notarization is paused. It is not a Mac App Store release.

Changes since 0.18.1

• Embedded Tailscale on your own private network, with account-free LAN and automatic route selection. No separate Tailscale app or developer-operated relay is required.
• IPv4 / IPv6 pairing endpoints, including Tailscale IPv6; LAN IPv6 is restricted to the local subnet. IPv6 does not guarantee lower latency.
• Low-bandwidth 15 fps default, hardware H.264 and optional HEVC, with JPEG fallback. Actual quality/frame rate depends on hardware and network.
• Updated scrolling inertia, native iPhone keyboard integration and Duo front/rear chord gestures. Audio capture/transport is disabled.
• Two explicit first-run permission steps: approve screen recording, reopen as prompted; approve Mac control, reopen as prompted. Start service after both are effective. Basic remote control does not require Documents or Full Disk Access.
• In-app privacy policy and current Tailscale metadata disclosure.

Install / test

Open the DMG and drag Chordesk.app to Applications. Because this build is not notarized, macOS may block first launch. Only proceed through the system Privacy & Security flow if you trust this source. Do not disable Gatekeeper/SIP or bypass managed-device policy. See the included installation guide. A changed signing identity may require reauthorizing permissions.

Use your own authorized Mac and disposable documents. Pair using the Mac QR code; do not publish active pairing codes. Public-network mode requires both Chordesk devices in your own Tailscale private network. Tailscale accounts/service follow their terms.

Known limits: no guarantee of closed-lid/sleep wake; IPv6-only hardware and long-running/multi-carrier cases still need testing. Regression: 175 passing logic/transport tests, one fixed-port test skipped because the existing live host owned the port; Go and targeted UI checks passed.

中文

配套 iOS 1.30/build 39，供同学非商业试用。新增内嵌 Tailscale、双栈配对、H.264/HEVC、惯性滚动及隐私说明。首次逐项允许录屏与控制，并按系统提示重开。当前未公证；不保证合盖唤醒，不捆绑 BetterDisplay 或音频驱动。

Source: 52f7d96 (the package BUILD-INFO also records the earlier working-tree baseline). Project-owned source/artwork: CC BY-NC-SA 4.0; third-party components retain their licenses.

DMG SHA-256: df1e5a774d58f00e5063cb75bc96811a16cbe10eb39ea3926f4c41c6fe294e41
Privacy: https://stland-admin.github.io/Chordesk-site/privacy.html
Support: styj@zju.edu.cn

Chordesk Mac 0.18.1 · Apple Silicon 试用版

Mac 0.18.1 / build 26，配合 iOS 1.21 / build 25；手机无需更新。

修正手机菜单和背面一指＋正面双指左右滑无法切换桌面（Spaces）的 Mac 执行路径。使用系统自带 System Events 的固定 Control＋左右方向键，不再复用普通远控 CGEvent 路径。普通鼠标／键盘继续独立状态，避免修饰键残留。

更新后在 Mac 的 Chordesk「设置 → 桌面切换」点「允许桌面切换（System Events）」，并确认 macOS 自动化提示。手机不会发起权限请求，也不会在授权后重放旧动作。至少创建两个桌面，并开启系统 Control＋左右方向键；首尾不循环，受 macOS 活动屏幕规则影响。普通远控仍只需要屏幕录制和控制两项权限。

验证：29 项相关测试通过；本机完成授权，点击主机测试按钮后系统返回并收到桌面变化通知。2026-10-30 用户真机复测确认：手机“下一个／上一个桌面”菜单和背面一指按住＋正面双指左右滑均可切换。此确认覆盖本机 Mac 0.18.1＋Duo 1.21，不代表同学机器、所有多屏组合或长期稳定性均通过。

下载 DMG，把 Chordesk 拖入应用程序。Apple Silicon，macOS 15.2+。这是未公证、ad hoc 签名的试用包，首次启动由接收者在系统设置中手动允许；不要关闭 Gatekeeper。首次启动按双权限引导，检查完整后自动重启 App 一次。

不含个人配对、证书、私钥或驱动；不支持公网或真正睡眠唤醒。详见随包 INSTALL-zh-CN.txt 与仓库操作指南。原有配对在 Bundle ID／安装和系统钥匙串许可保持有效时保留。

SHA-256: 57611c1a2e1f96f493e5d9a7d9c3cfed8bd04de76ce7c5184d64d7b68c561bcb

Chordesk Mac 0.18.0 · Apple Silicon 试用版

Chordesk Mac 0.18.0 / build 25 — Apple Silicon 试用版，搭配 iOS 1.21 / build 25。

• 背面一指＋正面双指左／右滑：下一个／上一个 Mac 桌面。上下滑仍打开／退出窗口总览，背面双指长按仍临时切换触控板。
• 可用分辨率档位显示高对比文字和“应用”按钮，避免把灰色主题误认为不可用。
• 首次点击“开始服务”进入屏幕录制、控制 Mac 两项授权引导；只读复查完成后自动重启 App 一次，默认开启内置屏服务。若系统权限迟迟不刷新，保留手动重启检查入口。
• 安装说明和操作指南已更新。公开仓库使用不含私人邮箱的新提交历史，旧历史另行私有保存。

下载 DMG，拖入“应用程序”。要求 Apple Silicon、macOS 15.2+。此包为本地 ad hoc 签名、未公证测试包；第一次打开需要 Mac 所有人在系统“隐私与安全性”中允许。无需 Xcode 或开发者账号，不需要安装 BetterDisplay；特殊自定义显示模式仍可能需要兼容回退。

桌面切换需至少两个 Spaces，并启用系统 Mission Control 的 Control＋左右方向键快捷键；到达首尾不循环，多屏由系统当前活动屏幕决定。使用公开键盘事件，不是原生多点触摸注入。新手势和从未授权的新 Mac 自动重启流程仍需实机反馈。

本轮两端构建、110 项逻辑/事件构造检查及 TLS 回归、2 项 Duo 模拟器 UI 场景已检查。首次测试有两项 TLS 超时，退出旧主机后 5 项 TLS 全通过。Mac 已恢复服务，Duo 新功能版已安装启动。当前仅局域网；iOS 先用仓库 Xcode 工程自编译，TestFlight 尚未开放。

请勿公开配对二维码、配对密钥或私人桌面截图。安装步骤见附件；操作手册见仓库 OPERATION-GUIDE.md。