🎧 CyanTooth (青牙 - 现代化蓝牙工具)

CyanTooth 是一款专为 Windows 10/11 设计的现代化蓝牙音频设备管理工具。

📸 预览

Tip

此处建议添加一张应用的主界面截图或托盘菜单截图，让用户直观感受 UI 设计。

托盘菜单	主界面

📦 下载

您可以从 Releases 页面下载最新的安装包。支持 x64 和 ARM64 架构。

• CyanTooth-win-[arch]-standalone.exe: 绿色独立版，自带 .NET 运行时，下载即用（推荐）。
• CyanTooth-win-[arch]-lightweight.zip: 轻量版，体积更小，需要预先安装 .NET 8 Desktop Runtime。

✨ 核心特性

• 🚀 系统托盘驻留 - 轻量级运行，最小化到托盘，随时待命。
• 🔍 智能设备发现 - 自动发现已配对的蓝牙设备（支持经典蓝牙和 BLE）。
• ⚡ 一键连接/断开 - 告别繁琐的系统设置，一键快速切换音频设备连接状态。
• 🔋 精准电量显示 - 实时显示设备电量百分比，支持多种协议。
• 🏷️ 智能设备分类 - 自动识别设备类型（耳机、音箱、键盘、鼠标等）。
• 🎵 高级音频编解码器支持 - 完美支持 Alternative A2DP Driver，实时显示 LDAC/aptX/AAC 激活状态。
• 🎨 现代化 UI - 基于 WPF-UI 构建，完美融入 Windows 11 设计语言。

🛠️ 技术架构

本项目采用清晰的三层架构设计：

层级	项目名称	描述
UI 层	CyanTooth	基于 WPF 的用户界面，负责交互与展示。
核心层	CyanTooth.Core	包含业务逻辑、数据模型、服务接口。
平台层	CyanTooth.Platform	封装底层 Windows API、蓝牙协议和音频控制。

主要技术栈

• 框架: .NET 8, WPF
• UI 组件: WPF-UI
• MVVM: CommunityToolkit.Mvvm
• 依赖注入: Microsoft.Extensions.Hosting
• 底层 API: Vanara.PInvoke (CoreAudio, CfgMgr32, SetupAPI)

💻 系统要求

• 操作系统: Windows 10 (Build 19041+) 或 Windows 11
• 运行环境: .NET 8.0 Runtime (Desktop)
• 硬件: 支持蓝牙 4.0+ 的蓝牙适配器

🚀 快速开始

从源码构建

1. 克隆仓库

   git clone https://github.com/mcheiyue/CyanTooth.git
    cd CyanTooth

2. 还原依赖

   dotnet restore

3. 构建项目

   dotnet build

4. 运行

   cd src/CyanTooth
   dotnet run

📂 项目结构

CyanTooth/
├── src/                          # 源代码目录
│   ├── CyanTooth/                # 主程序 (WPF UI)
│   ├── CyanTooth.Core/           # 核心业务逻辑
│   └── CyanTooth.Platform/       # 平台 API 封装
├── docs/                         # 项目文档
│   └── ARCHITECTURE.md           # 架构设计文档
└── tests/                        # 测试项目

🤝 致谢与参考

CyanTooth 的诞生借鉴了许多优秀开源项目的思路：

• BluetoothDevicePairing - 设备发现与配对逻辑
• ToothTray - IKsControl 音频连接实现
• BlueGauge - BLE/BTC 电量读取逻辑
• Alternative-A2DP-Driver - 高级音频编解码器支持参考

🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建您的特性分支 (git checkout -b feature/AmazingFeature)
3. 提交您的更改 (git commit -m 'Add some AmazingFeature')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启一个 Pull Request

📄 许可证

本项目基于 Apache License 2.0 开源。