update README.md

This commit is contained in:
ZhangLei
2025-11-04 00:36:22 +08:00
parent a508e7f704
commit 55688e2af7
4 changed files with 2 additions and 156 deletions

158
README.md
View File

@@ -19,10 +19,7 @@
## 📷︎ 界面预览 ## 📷︎ 界面预览
![](./assets/iShot_2025-10-31_20.10.16@600×625.png) ![](./assets/iShot_2025-11-04_00.30.31.png)
##  macOS 26 新特性液态玻璃
![](./assets/0jiq7Pw.gif)
## ✨ 功能特性 ## ✨ 功能特性
@@ -100,101 +97,6 @@ xcodebuild -project "Bitcoin Monitoring.xcodeproj" -scheme "Bitcoin Monitoring"
xcodebuild -project "Bitcoin Monitoring.xcodeproj" -scheme "Bitcoin Monitoring" clean xcodebuild -project "Bitcoin Monitoring.xcodeproj" -scheme "Bitcoin Monitoring" clean
``` ```
## 📖 使用说明
### 基本操作
1. **启动应用**
- 应用启动后自动在菜单栏显示默认币种 (BTC) 图标
- 首次启动会显示 "加载中...." 状态
2. **查看价格**
- 菜单栏实时显示当前选中币种的 USDT 价格
- 格式:`$价格` (例如: `$43,250.50`)
3. **切换币种**
- 点击菜单栏图标 → 币种选择 → 选择想要的币种
- 支持 BTC/ETH/BNB/SOL/DOGE 五种主流币种
4. **复制价格**
- **Option + 左键点击** 币种名称可快速复制当前价格到剪贴板
- 价格格式为 `$XXX.XX`,可直接粘贴使用
5. **交互菜单**
- 点击菜单栏图标显示详细菜单
- 查看更多信息并执行操作
### 菜单功能
| 功能 | 描述 | 快捷键 |
|------|------|--------|
| 价格信息 | 显示当前选中币种的价格和状态 | - |
| 快速复制 | Option+点击币种名称复制价格 | `Option+点击` |
| 复制价格 | 一键复制当前价格到剪贴板 | - |
| 币种选择 | 切换监控的币种 (BTC/ETH/BNB/SOL/DOGE) | - |
| 错误信息 | 显示网络错误详情 (如有) | - |
| 更新时间 | 显示上次成功更新时间 | - |
| 刷新价格 | 手动获取最新价格 | `Cmd+R` |
| 偏好设置 | 打开偏好设置窗口配置应用 | `Cmd+,` |
| 刷新设置 | 设置刷新的间隔 | - |
| 开机启动 | 设置开机自动启动APP | - |
| 代理设置 | 配置 HTTP 代理服务器 | - |
| GitHub | 打开仓库查询更新 | - |
| 关于 | 查看应用信息和版本 | - |
| 退出 | 完全退出应用 | `Cmd+Q` |
### 状态说明
| 状态 | 显示 | 说明 |
|------|------|------|
| 加载中 | `加载中...` | 首次启动,正在获取数据 |
| 更新中 | `更新中...` | 正在获取最新价格 |
| 错误 | `错误` | 网络连接或 API 异常 |
| 正常 | `$价格` | 成功显示当前价格 |
### ⚙️ 偏好设置
偏好设置窗口提供了完整的应用配置选项:
#### 访问方式
- **菜单路径**: 点击菜单栏图标 → 偏好设置
- **快捷键**: `Cmd+,`
#### 设置选项
1. **刷新设置**
- **5秒**: 高频刷新,适合交易场景
- **10秒**: 平衡模式,推荐日常使用
- **30秒**: 节能模式,减少网络请求
- **60秒**: 低频刷新,最小化资源占用
2. **启动设置**
- **开机自启动**: 系统启动时自动运行应用
- 开关采用 macOS 原生椭圆形 Switch 控件
- 设置立即生效,重启系统后保持
3. **代理设置**
- **HTTP代理**: 配置网络代理服务器
- **服务器地址**: 输入代理服务器域名或IP
- **端口**: 设置代理服务器端口 (1-65535)
- **连接测试**: 验证代理配置是否有效
- 支持企业网络环境下的代理访问
#### 界面特性
- **现代化设计**: 采用 macOS 系统设置风格
- **分组布局**: 功能模块清晰分组
- **智能验证**: 输入自动验证和错误提示
- **即时保存**: 设置更改立即保存生效
### 💡 使用技巧
- **快速复制**: 按住 `Option` 键点击币种名称可立即复制当前价格
- **切换币种**: 直接点击币种名称即可切换菜单栏显示的币种
- **手动刷新**: 使用 `Cmd+R` 快捷键立即更新价格数据
- **配置持久化**: 更改的刷新间隔和币种选择会自动保存,重启应用后保持设置
- **错误恢复**: 网络异常时应用会自动重试,无需手动干预
- **偏好设置**: 使用 `Cmd+,` 快捷键快速打开偏好设置窗口
## 🏗️ 技术架构 ## 🏗️ 技术架构
### 设计模式 ### 设计模式
@@ -231,63 +133,6 @@ priceManager.$currentPrice
} }
``` ```
## 🌐 API 集成
### 币安 API 端点
应用支持多种币种的价格查询:
```http
GET https://api.binance.com/api/v3/ticker/price?symbol={SYMBOL}
```
### 支持的交易对
| 币种 | 交易对符号 | 显示名称 |
|------|------------|----------|
| Bitcoin | BTCUSDT | BTC/USDT |
| Ethereum | ETHUSDT | ETH/USDT |
| BNB | BNBUSDT | BNB/USDT |
| Solana | SOLUSDT | SOL/USDT |
| Dogecoin | DOGEUSDT | DOGE/USDT |
### 请求参数
| 参数 | 类型 | 必需 | 描述 |
|------|------|------|------|
| symbol | String | 是 | 交易对符号 (如: BTCUSDT, ETHUSDT, BNBUSDT, SOLUSDT, DOGEUSDT) |
### 响应格式
```json
{
"symbol": "BTCUSDT",
"price": "43250.50"
}
```
### 错误处理策略
1. **网络连接失败**
- 自动重试机制 (最多3次)
- 递增延迟策略 (1秒, 2秒, 4秒)
- 用户友好的错误提示
2. **API 服务器错误**
- HTTP 状态码检查
- 服务器响应验证
- 优雅降级处理
3. **数据解析异常**
- JSON 格式验证
- 数据类型检查
- 价格格式验证
4. **无效价格格式**
- 数值范围检查
- 格式规范化
- 异常值过滤
## 🔧 故障排除 ## 🔧 故障排除
### 常见问题 ### 常见问题
@@ -308,6 +153,7 @@ xattr -d com.apple.quarantine "/Applications/Bitcoin Monitoring.app"
**问题**: 显示"错误"状态,无法获取价格 **问题**: 显示"错误"状态,无法获取价格
**诊断步骤**: **诊断步骤**:
1. 检查网络连接 1. 检查网络连接
```bash ```bash
ping api.binance.com ping api.binance.com

Binary file not shown.

Before

Width:  |  Height:  |  Size: 1.3 MiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 206 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 1.5 MiB