TreeletHub v1.3.0 for macOS

完整变更记录见仓库根目录 CHANGELOG.md。

TreeletHub 1.3.0 for macOS（DMG）

配套源码同时覆盖蜂巢启动墙、一次性 Pro 买断与 Codex 深链接控制。国内正式下载走 Cloudflare CDN；GitHub Releases 作为开发备用。

蜂巢启动墙

• 九宫格改为 Watch App View 风格的蜂巢启动墙：捏合缩放、拖动浏览，虚线「+」添加应用 / 网页快捷方式 / 系统操作。
• 新装首次为空时，按本机已安装情况预填常用系统应用（只执行一次，清空后不再自动填回）。
• 支持跨页拖拽换位；免费最多 10 个应用 / 快捷方式，解锁 Pro 后不限数量。

Pro：一次性买断（非订阅）

• 新商品 com.treelet.treelethub.mac.pro.lifetime，标价 $9.99，不自动续费。
• 已购买旧年付订阅且仍在有效期内的用户，继续视为已解锁。
• 解锁后可用无限启动项、灵动岛、键盘启动器。入口在主窗口配对码下方开关，或右上角齿轮菜单。

灵动岛与键盘启动器

• 未开启时展示效果预览图；首次启动有功能介绍。
• 灵动岛水平始终锚在当前屏幕正中，展开态加高以容纳蜂巢启动台；贴边热区悬停直接展开大面板。
• 键盘启动器仍需「输入监控」；打字音效暂不开放。

Codex 控制（无按键注入）

• 不再用辅助功能 / 自动化向 ChatGPT、Cursor 注入按键。
• Codex 改为深链接 + 本机 Codex CLI；ChatGPT / Cursor 在启动墙中仅启动对应应用。

下载与分发

正式 Mac 直装包（官网按钮同一地址，覆盖更新，无需改链接）：

https://models.appda.store/treelethub/TreeletHub.dmg

产品页：treelet.us/treelethub（English）。

GitHub 附件：TreeletHub.dmg（latest 直链）、TreeletHub-Mac-1.3.0.dmg。

安装

1. 下载 DMG 并打开。
2. 将 TreeletHub 拖入「应用程序」文件夹。
3. 首次打开若提示无法验证开发者：前往「系统设置 → 隐私与安全性」允许，或右键 App 选择「打开」。
4. 允许 本地网络 访问，以便与手机配对。
5. 使用键盘启动器时，再允许 输入监控。

系统要求

• macOS 14.6 或更高版本
• 遥控需同一 Wi‑Fi 下的 iPhone / iPad 或 Android，并先安装本 Mac 客户端

TreeletHub v1.3.1 for Android

TreeletHub 1.3.1 for Android

与当前 iPhone 体验对齐：蜂巢启动墙、去掉本机 AI 控制键盘，国内下载走 Cloudflare CDN。

蜂巢启动墙

• Apps 页改为 Watch 风格蜂巢启动墙（与 iPhone / Mac 一致）：捏合缩放、拖动浏览、长按进入编辑后拖拽换位。
• 多页非空槽位展平为一面墙；底栏仅 应用 与 设置。
• 空白处双击可复位默认缩放。

与 iOS 对齐

• 点按仅启动 Mac 应用 / 快捷方式；音量、亮度、媒体走内联控件。
• 已移除 Codex 控制键盘、本机听写与麦克风权限。
• 已移除本机 Play 订阅门控；Pro 能力以 Mac 端为准。
• 连接页嵌入功能简介。

手势

• 蜂巢墙上 双指下滑：隐藏 Mac 上全部已打开应用并显示桌面。

要求

• Mac 端建议 1.3.0 或更高，并与手机同一 Wi‑Fi 配对。

安装包

• CDN（国内推荐）：https://models.appda.store/treelethub/TreeletHub.apk
• GitHub 附件：TreeletHub-Android-1.3.1.apk（versionCode 6）
• 也可从 Google Play 安装

侧载安装（APK）

1. 下载 APK。
2. 在系统设置中允许「安装未知应用」（按机型路径略有差异）。
3. 打开 APK 完成安装。
4. 与 Mac 同一 Wi‑Fi，打开 TreeletHub 输入配对码连接。

TreeletHub v1.2.7 for macOS

TreeletHub 1.2.7 for macOS（DMG）

新功能：AI 控制键盘桥接

与 iPhone 上的 AI 控制键盘配合：在九宫格点按 ChatGPT / Codex / Cursor 后，Mac 端接收指令并驱动目标应用。

• 支持 ChatGPT（含 Codex 工作流）、ChatGPT Classic、Cursor。
• Agent 状态尽量从本地 Codex 会话数据近似同步。
• 命令键、摇杆、推理旋钮、听写结束写回输入框等。
• 按目标应用分别持久化键位映射。

请搭配 iPhone 端 1.2.5 或更高 以获得完整体验。详见 使用说明 · AI 控制键盘。

权限与安全

• 首次使用请在「系统设置 → 隐私与安全性」中允许 辅助功能 与 自动化（系统事件 + ChatGPT / Cursor）。
• 默认不向命令面板自动打字；可选手动开启。
• 指令节流与防刷屏，避免误触导致目标应用失控。

其它修复

• 修复打字音效相关源码截断导致的编译问题。
• 移除 Mac App Store 不支持的 temporary-exception 权限声明，保留运行时自动化授权提示。

安装包

• 附件：TreeletHub.dmg（与 README 最新下载链接 一致）、TreeletHub-Mac-1.2.7.dmg。

安装

1. 下载 DMG 并打开。
2. 将 TreeletHub 拖入「应用程序」文件夹。
3. 首次打开若提示无法验证开发者：前往「系统设置 → 隐私与安全性」允许，或右键 App 选择「打开」。
4. 允许 本地网络 访问，以便与手机配对。
5. 使用 AI 控制键盘时，再允许 辅助功能 与 自动化。

系统要求

• macOS 14.6 或更高版本
• iPhone 端 1.2.5 或更高以获得完整 AI 控制键盘体验

TreeletHub v1.3 for Android

Android 1.3 发布说明

新功能：AI 控制键盘

在九宫格中点按 ChatGPT、Codex 或 Cursor，手机不再只是启动 Mac 应用，而是进入该应用专属的 控制键盘（左上角返回九宫格）。

• Codex：批准 / 拒绝、新会话、推理旋钮、Skills 等
• ChatGPT：新对话、PTT、发送、命令菜单、侧边栏等
• Cursor：PTT、发送、Chat、命令面板、接受 / 拒绝、终端等
• 键位按目标应用独立保存；可在设置中重映射

按住说话（PTT）

• 按住 PTT 用手机麦克风说话；松手后识别文字填入 Mac 上对应应用的输入框
• 识别在 Android 本机完成，音频不离开手机，仅最终文字经 Wi‑Fi 发送
• 双击 PTT 可免提录音；首次使用需允许 麦克风 权限

Tab 左右滑动

• 已配对后，九宫格页与设置页支持 左右滑动 切换（也可点按底栏）

显示桌面

• Apps 九宫格上 双指下滑，隐藏 Mac 上全部已打开应用并显示桌面

其它

• 升级 Google Play Billing Library 至 9.1.0，满足 Play 结算库版本要求

要求

• Mac 端需更新至 1.2.7 或更高，并与手机同一局域网配对
• 使用 AI 控制键盘时，请在 Mac「系统设置 → 隐私与安全性」中允许 辅助功能 与 自动化

安装包

• 附件：TreeletHub-Android-1.3.apk（versionCode 5）
• 也可从 Google Play 安装

侧载安装（APK）

1. 下载 APK。
2. 在系统设置中允许「安装未知应用」（按机型路径略有差异）。
3. 打开 APK 完成安装。
4. 与 Mac 同一 Wi‑Fi，打开 TreeletHub 输入配对码连接。

TreeletHub v1.2.6 for macOS

TreeletHub 1.2.6 for macOS（DMG）

灵动岛与 UI

• 精简灵动岛视觉：去除多余发光动画与装饰，更接近系统原生质感。
• 修复无边框窗口下 Material 导致的半透明外圈背景问题。
• 播放页文案与布局收敛；时钟、收起态信息条更易读。

正在播放（App Store 合规）

• 移除私有 MediaRemote 框架依赖，符合 Mac App Store 审核要求。
• 「音乐」App 仍显示完整曲目、进度与封面（AppleScript + scripting-targets）。
• 其他 App（Chrome、抖音等）通过 Core Audio 显示图标与出声状态；修复 Helper 子进程无法识别的问题。

打字音效

• 重写机械轴 / 打字机合成模型：双瞬态、外壳共鸣、立体声、松键回弹。
• 打字机预设改为程序化合成；快速连打多声部并发。

安装包

• 新增 TreeletHub_Mac_release/build-dmg.sh，用于生成带背景图的 DMG。
• 附件：TreeletHub.dmg（与 README 最新下载链接一致）、TreeletHub-Mac-1.2.6.dmg。

安装

1. 下载 DMG 并打开。
2. 将 TreeletHub 拖入「应用程序」文件夹。
3. 首次打开若提示无法验证开发者：前往「系统设置 → 隐私与安全性」允许，或右键 App 选择「打开」。
4. 允许 本地网络 访问，以便与手机配对。

系统要求

• macOS 14.6 或更高版本

TreeletHub v1.2.4 for macOS

TreeletHub 1.2.4 for macOS（DMG）

新功能：键盘启动器（订阅）

Mac 端新增 键盘启动器 —— 把常用应用映射到屏幕键盘，用 Control 键一键唤出，比程序坞更顺手的肌肉记忆启动方式。

• Control 唤出 — 按下并松开 Control，屏幕中央弹出键盘浮层；点击外部、按 Esc 或启动应用后自动关闭。
• Control + 按键 — 在任意位置快速唤起或隐藏已映射的应用，无需先打开浮层。
• 智能默认映射 — 首次开启按应用名称首字母自动填充键位；支持点击添加/替换、拖拽交换。
• 订阅功能 — 与多页九宫格、灵动岛一样，需有效订阅；过期后开关自动关闭。

首次开启需在「系统设置 → 隐私与安全性 → 输入监控」中允许 TreeletHub（仅监听 Control 与按键，不记录或上传按键内容）。

安装

1. 下载 TreeletHub.dmg 并打开。
2. 将 TreeletHub 拖入「应用程序」文件夹。
3. 首次打开若提示无法验证开发者：前往「系统设置 → 隐私与安全性」允许，或右键 App 选择「打开」。
4. 允许 本地网络 访问，以便与手机配对。

说明

• 本 DMG 为 Mac 桌面端直装包；iPhone / Android 遥控端请从 App Store 或 Google Play 安装。
• 与 Mac App Store 版 二选一即可；App Store 版支持自动更新。

系统要求

• macOS 14.6 或更高版本（以本包部署目标为准）

TreeletHub v1.2.3 for macOS

TreeletHub 1.2.3 for macOS（DMG）

安装

1. 下载 TreeletHub.dmg 并打开。
2. 将 TreeletHub 拖入「应用程序」文件夹。
3. 首次打开若提示无法验证开发者：前往「系统设置 → 隐私与安全性」允许，或右键 App 选择「打开」。
4. 允许 本地网络 访问，以便与 iPhone 配对。

说明

• 本 DMG 为 Mac 桌面端直装包；iPhone 遥控端请从 App Store 安装。
• 与 Mac App Store 版 二选一即可；App Store 版支持自动更新。

系统要求

• macOS 13 或更高版本（以你打包时的部署目标为准）