Skip to content

KeyBridge v0.2.0-beta.1 · 键桥

Pre-release
Pre-release

Choose a tag to compare

View all tags
@winglight9 winglight9 released this 28 Oct 02:55
· 7 commits to main since this release
v0.2.0-beta.1
135a4e4

KeyBridge v0.2.0-beta.1 / 键桥测试版

A macOS 14+ menu bar app for sharing a MacBook’s keyboard and built-in trackpad with another Mac. Install the same app on both ends; choose Device → Apply to. Current downloadable packaging targets Apple Silicon.

两台 Mac 安装同一个菜单栏工具，通过「设备 → 应用于」选择输入去向，外置显示器鼠标保留本机使用。

Changes / 本次更新

  • Wired diagnosis: distinguishes unreadable/missing/disabled Thunderbolt Bridge configuration, unknown/down link, waiting for an address, ready network without a discovered peer, and denied network access. It reports observed facts; no-link alone is not proof of an unsupported cable.

  • Experimental native gestures: source-side opt-in, off by default. Transports native gesture events for the destination system/app to interpret, without hardcoded gesture-to-shortcut mappings. Changing the option pauses forwarding.

  • Bilingual interface: English default, Chinese for Chinese system preferences, with manual language selection. Device labels use local network names.

  • Public source and setup documentation: permissions, route selection, recovery and compatibility limits are documented in the repository.

  • **有线诊断细化：**区分网桥配置、链路、网络地址、设备发现和访问权限问题；证据不足时不直接归咎线材。

  • **原生手势实验功能：**默认关闭，在来源 Mac 手动开启；把事件交给目标系统／应用解释，更改选项会暂停转发。

  • **中英文界面与安装文档：**两台同一软件，按网络名选择，鼠标点击即可停止、重连和切换。

Verification and limits / 实测与限制

  • User verified over Bluetooth on an M1 Pro MacBook and M4 Mac mini: typing, pointer movement, clicks, dragging and two-finger scrolling. Bluetooth latency is noticeable in this setup; no zero-latency claim is made.
  • Physical Thunderbolt cable acceptance testing is pending. Direct cable requires Thunderbolt networking support; the shape of a USB-C connector does not establish compatibility. There is no Wi-Fi fallback.
  • Native pinch, rotation and three/four-finger gestures, including four-finger upward swipes, are experimental and not physically verified. They may be recognized differently or rejected by the target OS/app. This path and physical sender identification use undocumented macOS behavior.
  • Touch ID, FileVault/pre-login input and Force Touch actions are unsupported. Fn/media keys, Intel and additional Mac/OS combinations have not been established as compatible.

蓝牙基础输入与双指滚动已有用户实测；雷雳线材、捏合、旋转和三／四指操作仍待真实设备确认。系统和应用决定原生手势的具体效果，不能据此承诺全部手势可用。

Build checks / 构建检查

  • 29 protocol, encryption, native-event and wired-diagnostic checks passed.
  • Release build completed for arm64; app bundle signature verification passed.
  • These automated checks do not establish physical gesture or cable compatibility.

Install / 安装

  1. Download KeyBridge-0.2.0-beta.1.zip, extract it, and move the app to Applications on both Macs before granting permissions.
  2. Source Mac: enable Input Monitoring + Accessibility. Receiver: enable Accessibility. Allow Bluetooth on both in Bluetooth mode, and local-network access when requested for wired discovery.
  3. Compare and approve the six-digit code on both Macs, then select source and destination.
  4. Keep the display-connected mouse available for Stop forwarding and Retry. Emergency local return: Control–Option–Command–Escape.

Trust: this beta is locally signed with a development certificate, without Apple Developer ID signing or Apple notarization. macOS may block first launch. Review the source and exact warning; if you trust the copy and the option is available, use the app-specific Privacy & Security → Open Anyway flow. Do not disable system-wide security or blindly bypass damage/malware warnings. See docs/setup.md for details.

**签名说明：**本地开发签名，无 Apple Developer ID 签名及 Apple 公证。首次启动可能被拦截，按当前应用的系统提示处理，不要关闭整体安全机制。

Privacy and feedback / 隐私与反馈

Inputs stay on a direct encrypted connection; no cloud account or relay is used. Diagnostics omit typed text and raw gestures but can include network/device information. Redact those details before opening an issue. Never upload identity keys, signing material, passwords or deployment credentials.

For a bug report, include this version, both models/macOS versions, connection mode and redacted diagnostics. For gestures, include the exact gesture and target app and whether the test used the physical trackpad.

Assets 5
Loading