BTC 价格监控器

一款 macOS 原生菜单栏应用，用于实时监控主流加密货币的价格，支持 BTC/ETH/BNB/SOL/DOGE 等主流币种，更支持用户自定义币种（如 ADA、SHIB、MATIC 等）。基于 Swift 编写，致力于打造一款高性能、极简风格的应用APP，已经编译了Intel与Apple Silicon的通用应用，请至releases下载。

📖 如在macOS下无法运行，请执行以下步骤：

系统设置 → 隐私与安全性 → 安全性 → 已阻止“Bitcoin Monitoring.app”以保护Mac → 仍要打开

📷︎ 界面预览

✨ 功能特性

🚀 核心功能

• 多币种支持: 支持 BTC/ETH/BNB/SOL/DOGE 主流虚拟货币价格监控
• 自定义币种: 支持用户添加自定义币种（如 ADA、SHIB、MATIC 等），最多可添加5个自定义币种
• 智能图标生成: 为自定义币种自动生成基于首字母的彩色图标，确保视觉一致性
• 币种验证: 实时验证自定义币种格式，支持3-5个字符的币种符号
• 实时价格显示: 在菜单栏实时显示选中币种的 USDT 价格
• 多种刷新机制: 可选 5、10、30、60 秒自动获取最新价格数据
• 智能错误重试: 网络异常时自动重试，最多 3 次
• 手动刷新: 支持快捷键 Cmd+R 手动刷新价格
• 状态指示: 直观显示加载、更新、错误状态
• 价格复制功能: 支持一键复制当前价格到剪贴板
• 配置持久化: 用户设置自动保存，重启后保持配置
• 开机自启动: 可选是否开机自动启动APP
• 代理支持: 支持 HTTP/HTTPS 代理配置，支持代理认证

🎨 用户体验

• 中文界面: 完整的中文用户界面
• 自定义币种管理: 直观的币种添加、删除和切换界面
• 智能图标系统: 自动生成的彩色币种图标，提供视觉一致性
• 优雅动画: 流畅的状态切换动画
• 轻量级设计: 最小化系统资源占用
• 后台运行: 不占用 Dock 空间，专注菜单栏
• SF Symbols 图标: 使用原生 macOS 图标系统
• 现代化偏好设置: 采用 macOS 原生风格的偏好设置界面
• 精美开关控件: 使用 macOS 系统风格的椭圆形 Switch 控件
• 响应式布局: 智能适配不同窗口尺寸和显示设置

🛡️ 可靠性

• 网络容错: 完善的网络异常处理机制
• 内存管理: 避免循环引用，及时释放资源
• 线程安全: UI 更新确保在主线程执行
• 错误恢复: 自动从临时网络故障中恢复

📋 安装要求

系统要求

• 操作系统: macOS 13.1 或更高版本
• 架构支持: Intel 和 Apple Silicon (M1/M2/M3/M4/M5)

开发环境

• 开发工具: Xcode 16.2 或更高版本
• Swift 版本: Swift 5.0
• 部署目标: macOS 13.1

网络要求

• 需要稳定的互联网连接，国内用户建议使用科学上网工具 或 设置代理服务器。
• 访问币安 API (https://api.binance.com) 的网络权限

🚀 快速开始

直接运行

1. 克隆项目

   git clone https://github.com/jiayouzl/Bitcoin-Monitoring.git
   cd Bitcoin-Monitoring
   

2. 在 Xcode 中打开

   open "Bitcoin Monitoring.xcodeproj"
   

3. 运行应用

   • 在 Xcode 中选择 "Bitcoin Monitoring" scheme
   • 点击运行按钮或使用快捷键： Cmd+R

构建命令

# 构建项目
xcodebuild -project "Bitcoin Monitoring.xcodeproj" -scheme "Bitcoin Monitoring" -configuration Debug build

# 归档应用
xcodebuild -project "Bitcoin Monitoring.xcodeproj" -scheme "Bitcoin Monitoring" -configuration Release archive

# 清理构建缓存
xcodebuild -project "Bitcoin Monitoring.xcodeproj" -scheme "Bitcoin Monitoring" clean

🏗️ 技术架构

设计模式

• MVVM 架构: SwiftUI + ObservableObject 模式
• Combine 框架: 响应式数据流和事件处理
• 依赖注入: 服务层分离和松耦合设计
• 观察者模式: 价格变化的响应式更新
• 策略模式: 可配置的刷新间隔选项
• 协议统一: CryptoRepresentable 协议统一默认和自定义币种接口
• 工厂模式: CryptoIconGenerator 自动生成币种图标

UI 组件架构

• 现代化界面设计: 采用 macOS 原生设计语言
• Switch 控件: 使用 .toggleStyle(.switch) 和 .controlSize(.mini) 实现精美开关
• 响应式布局: HStack + VStack 实现灵活的界面布局
• 分组视图: 自定义 SettingsGroupView 组件实现功能分组
• 配置管理: AppSettings 类统一管理用户偏好设置
• 自定义币种组件: 专门的币种管理界面，支持添加、删除和切换自定义币种
• 图标缓存系统: CryptoIconGenerator 实现图标生成和缓存机制，避免重复生成

🔧 API 集成

币安 API 端点

应用使用币安公开 API 获取价格数据：

GET https://api.binance.com/api/v3/ticker/price?symbol={SYMBOL}

支持的交易对

• 默认币种: BTC/USDT, ETH/USDT, BNB/USDT, SOL/USDT, DOGE/USDT
• 自定义币种: 支持用户添加3-5个字符的任意币种（如ADA、SHIB、MATIC等）
• 币种验证: 自定义币种通过 CustomCryptoSymbol.validateSymbol() 进行格式验证
• 图标生成: 使用 CryptoIconGenerator 为自定义币种生成基于首字母的彩色图标

错误处理

• 自动重试机制: 最多3次重试，递增延迟（1秒、2秒、4秒）
• 网络异常处理: 用户友好的错误提示和状态显示
• 代理配置支持: 完整的 HTTP/HTTPS 代理配置和连接测试

⚙️ 配置管理（持久化配置）

UserDefaults 键值

• BTCRefreshInterval: 刷新间隔设置
• SelectedCryptoSymbol: 选中的默认币种
• LaunchAtLogin: 开机自启动
• CustomCryptoSymbols: 自定义币种列表 (JSON数组)
• SelectedCustomSymbolIndex: 当前选中的自定义币种索引
• UseCustomSymbol: 是否使用自定义币种
• ProxyEnabled/ProxyHost/ProxyPort/ProxyUsername/ProxyPassword: 代理设置（包括认证）
• OptionClickAction: 选项点击操作设置

🔧 故障排除

常见问题

1. 应用无法启动

问题: 双击应用图标无反应 解决方案:

# 执行该命令以启动APP
sudo xattr -d com.apple.quarantine "/Applications/Bitcoin Monitoring.app"

# 或者

# 系统偏好设置中允许应用运行
系统设置 → 隐私与安全性 → 安全性 → 已阻止“Bitcoin Monitoring.app”以保护Mac → 仍要打开

2. 网络连接失败

问题: 显示"错误"状态，无法获取价格 诊断步骤:

1. 检查网络连接

ping api.binance.com

2. 验证 API 可用性

# 测试同币种 API 的可用性
curl "https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT"

3. 检查防火墙设置

# 确保允许出站 HTTPS 连接

🔍 调试技巧

网络调试

# 测试币安 API 连通性
curl "https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT"

# 使用代理测试连接
curl --proxy http://proxy-server:port "https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT"

🤝 贡献指南

我们欢迎所有形式的贡献！请阅读以下指南：

贡献方式

1. 报告 Bug: 在 Issues 中提交详细的 Bug 报告
2. 功能建议: 提出新功能的想法和建议
3. 代码贡献: 提交 Pull Request 改进代码
4. 文档完善: 改进 README 和代码注释

📄 许可证

本项目采用 GNU General Public License v3.0 许可证。

完整许可证文本

详见 LICENSE 文件。

👨‍💻 作者

Mark

• GitHub: @jiayouzl
• 项目主页: https://github.com/jiayouzl/Bitcoin-Monitoring

⭐ Star History

---