给 Windows 的一口甜：点一下，AirPods 就连上。
🏠 产品介绍页 · 📦 下载
奶油黄白 Apple 风 · 常驻托盘 · 优先级连接 · 无遥测 · 主动反馈可附日志
Mac 版开发中（核心：防自动跳走看门狗）→ mac/AirPodsBuddyMac/README.md
v1.9.20 已接受偶发 Windows 蓝牙/音频路由失效作为已知问题公开披露；严格五轮真机验收没有通过。下载请以 Release 页面为准，验收证据见开发清单。
在 iPhone 上连 AirPods：开盖，弹窗，点一下。 在 Windows 上连 AirPods：没有弹窗——Windows 不支持 Apple 的私有协议， 每次都要：
| Windows 原生 | AirPods 小助手 | |
|---|---|---|
| 连接步骤 | 设置 → 蓝牙和其他设备 → 找到设备 → 点连接（4~5 步） | 单击托盘图标 / 点一下大圆钮（1 步） |
| 耳机好几个 | 每次都要自己找哪个是哪个 | 按你的优先级自动挑（支持 ▲▼ 排序） |
| 断开 | 再进设置点断开 | 右键托盘 → 一键断开全部 |
| 音质 | 容易连成低音质通话模式（HFP） | 默认 A2DP+HFP 完整模式 |
| 常驻 | 无 | 托盘常驻 + 开机自启，不占任务栏 |
类似需求的知名开源项目还有 AirPodsDesktop、 PodBridge、 MagicPods—— 它们证明了一件事：Windows 用户苦"连 AirPods 繁琐"久矣。 我们的差异点：3.4MB 单文件、零依赖零后台服务、纯本地零遥测、优先级连接、界面是和星星布丁一起调出来的米白可爱风 💕
- 🚀 一键连接/断开：大圆钮一点即连；左键单击托盘图标直接切换（右键才弹菜单）
- 🧚 星星布丁小宠物：点托盘后她从右下角弹出来陪你等连接——等待张望→ 连上开心跳跃撒💕→断开挥手拜拜，全帧动画+桌面级透明（素材取自 Codex 版星星布丁宠物精灵图）
- 🥇 设备优先级：列表 ▲▼ 调整顺序，"一键连接"永远先连你最想要的那个； 苹果设备（AirPods / Beats）默认排前面，其他耳机标"其他"不捣乱
- 🔵 三态托盘图标：未连接=可爱脸 / 已连接=心动脸+绿环 / 连接中=加油脸+旋转弧
- 🎨 Apple 风界面：奶油黄白底+蜂蜜金主按钮，macOS 级克制质感，长名字优雅截断
- 🖱️ 无边框窗口可拖动：按住顶栏/标题区即可移动
- ℹ️ 降噪/通透：Windows 用户态无法访问 Apple 控制通道（需内核驱动，见 MagicPods 路线），菜单内已 诚实说明并指路；Mac 版不存在此限制
- 🖥️ 托盘常驻：关窗=缩托盘，开机自启，随时唤出
- 🔒 纯本地：连接诊断主要在本地完成；网络仅用于更新及用户主动提交的反馈（可勾选日志）
- 🔄 自动更新：有新版弹窗一键升级
- 📋 日志排查：出错不弹窗吓人，全记在本地日志里
- 到 Releases 下载
AirPodsBuddy-Windows.zip - 解压，双击
AirPodsBuddy.exe（无需安装；建议放到固定位置） - 耳机先在 Windows 蓝牙设置里配对过一次，之后就只用点它了
⚠️ 个别安全软件可能误报/拦截 AHK 编译的程序（毕竟它会操作蓝牙）， 请加入信任列表。程序纯本地运行，可自行审计源码。💡 极少数精简版系统缺少微软 WebView2 组件（首次运行会自动引导安装， 约 2MB 官方包；断网时也会自动借用本机 Edge 内核，无需手动处理）。 注意：单独安装 Edge 浏览器解决不了这个问题——程序用的是独立的 WebView2 Runtime。
AirPods 5 等新耳机如何配对？连上却没有声音怎么办？
AirPods 5 可以作为蓝牙耳机与非 Apple 设备配对；本程序目前只验证了已配对设备的经典蓝牙音频端点，尚无 AirPods 5 真机日志或听音验收，不能保证每台 Windows 电脑都能连接。AirPods 5 / AirPods 4 / AirPods Pro 3 的配对方式：耳机放在充电盒内、打开盒盖，轻点盒体正面两下，直到指示灯闪白，再在 Windows「设置 → 蓝牙和设备 → 添加设备」中选择耳机。见 Apple 配对说明。Apple 的 AirPods 5 技术规格列出 Bluetooth 5.3，并未说明其支持 LE Audio；不能凭 Windows 的 LE Audio 更新推断这就是故障根因。
连接异常时，请按影响范围由小到大手动检查：
- 在 Windows 声音设置确认实际默认播放设备是耳机，并试听；「蓝牙已连接」不等于音频端点已就绪。
- 如果 Windows 自带「连接」也失败，先手动关闭再开启电脑蓝牙，然后重试；这会短暂影响本机所有蓝牙设备，程序不会代做。
- 仍失败时，仅遗忘这副耳机并按上面的白灯步骤重新配对；这会重建这副耳机与本机的配对。
- 最后再重启电脑。上述顺序来自本机用户恢复经验，不是已证实的通用根因或自动修复。
仍未恢复时，在程序底部点「问题反馈（可附日志）」，选相符问题并保留日志勾选，填写 Windows 版本、耳机在 Windows 显示的准确名称、失败发生在发现/配对/连接/播放哪一步。只有口头「AirPods 5 不支持」反馈，尚无法做型号专属真机结论。
- 技术栈：AutoHotkey v2 + WebView2（系统自带 Edge 内核），编译为单文件 exe
- 完整文档在
doc/（渐进式披露：初心 / 原理 / 技术方案 / 进度 / 踩坑记录） - 构建：改
webui/index.html→webui/build_ui.ps1→ Ahk2Exe 编译（详见 doc/02）
- 蓝牙核心逻辑复用自 ChromuSx/BluetoothDeviceConnector（MIT）
- WebView2 承载使用 thqby 的 WebView2-AHK 库
- 降噪/通透切换基于 librepods 项目逆向发现的
Apple AAP 协议规范（L2CAP 服务
74ec2172-...+ 0x0D 监听模式指令）独立实现， 感谢他们的开创性逆向工作 🙏（协议规范以事实引用，实现为本项目独立编写） - 用爱发电 · 捞鱼 & 星星布丁 💕
MIT
当前源码 v1.9.20；实际发布版号与资产以 GitHub Release为准。开发入口 SKILL.md，审计清单 doc/07-审计修复清单.md。Windows 与 Mac 应用各有独立 CI，不把 Stream Deck helper 的构建当主应用验收。