AWDL Manager

AWDL 管理器：解决妙控鼠标断连与网络干扰的必备工具

这是一个专为 macOS 设计的菜单栏小工具，旨在彻底解决 妙控鼠标（Magic Mouse）频繁断开连接、延迟卡顿或无法连接 的顽疾。

为什么你需要它？

妙控鼠标主要通过蓝牙与 Mac 通信，而 Apple 设备间的 AWDL 协议（用于 AirDrop、AirPlay 等）由于工作在相同的无线频段，往往会与蓝牙产生严重冲突。这会导致你的妙控鼠标出现：

• ❌ 无故断开：正在使用时突然失去连接。
• 🐢 光标漂移：移动不平稳，有明显的拖拽感或延迟。
• 📂 连接失败：开启电脑后鼠标迟迟无法配对。

通过禁用 AWDL 接口，可以立即腾出无线带宽，让妙控鼠标恢复丝滑稳定的连接。

功能特性

• 状态监控：实时显示 AWDL 当前状态（active/inactive）
• 快速控制：一键开启或关闭 AWDL
• 自动检测：可设置定时检测并自动关闭 AWDL
• 免密码操作：支持配置 sudoers 免密码权限，无需每次输入密码
• 菜单栏常驻：作为菜单栏应用运行，不占用 Dock 位置

系统要求

• macOS 13.0 或更高版本
• 需要管理员权限来控制网络接口

安装

1. 下载 AWDLManager.app
2. 将应用拖入 /Applications 文件夹
3. 首次打开时，右键点击应用选择"打开"以绕过 Gatekeeper

或者从源码编译：

git clone <repository-url>
cd AWDLManager
xcodebuild -project AWDLManager.xcodeproj -scheme AWDLManager -configuration Release

使用说明

基本操作

1. 启动应用后，菜单栏会出现一个圆形图标
   • 🟢 绿色：AWDL 处于活动状态
   • 🔴 红色：AWDL 已关闭
2. 点击图标打开控制面板
3. 使用"关闭 AWDL"或"打开 AWDL"按钮控制状态

配置免密码权限（推荐）

首次使用时，建议配置免密码权限：

1. 点击"配置免密码权限"按钮
2. 在弹出的对话框中输入管理员密码
3. 配置成功后，后续操作将不再需要输入密码

此操作会在 /etc/sudoers.d/awdl-manager 创建配置文件，仅授予控制 awdl0 接口的权限。

自动检测模式

开启"自动检测并关闭"功能后，应用会按设定间隔自动检测 AWDL 状态，如果发现 AWDL 处于活动状态，会自动将其关闭。

可选检测间隔：5秒、10秒、30秒、1分钟

技术说明

AWDL 是什么？

AWDL（Apple Wireless Direct Link）是 Apple 开发的专有无线协议，主要用于：

• AirDrop 文件传输
• AirPlay 屏幕镜像
• Sidecar 功能
• 其他 Apple 设备间的近距离通信

为什么要关闭 AWDL？

在某些情况下，AWDL 可能会：

• 干扰 Wi-Fi 连接，导致网速下降或断连
• 与某些路由器存在兼容性问题
• 增加电池消耗

命令行等效操作

# 查看 AWDL 状态
ifconfig awdl0 | grep status

# 关闭 AWDL
sudo ifconfig awdl0 down

# 开启 AWDL
sudo ifconfig awdl0 up

项目结构

AWDLManager/
├── AWDLManagerApp.swift    # 应用入口
├── AppDelegate.swift       # 菜单栏和弹窗管理
├── ContentView.swift       # 主界面 UI
├── Services/
│   └── AWDLService.swift   # AWDL 控制服务
├── Models/
│   └── Settings.swift      # 应用设置
├── Assets.xcassets         # 资源文件
└── Info.plist              # 应用配置

许可证

MIT License

注意事项

• 关闭 AWDL 后，AirDrop 等功能将无法使用
• AWDL 可能会被系统自动重新激活（如使用 AirDrop 时）
• 此工具不会对系统造成永久性更改，重启后 AWDL 将恢复默认状态