mirror of
https://github.com/jiayouzl/Bitcoin-Monitoring.git
synced 2025-11-24 19:12:58 +08:00
update README.md
This commit is contained in:
158
README.md
158
README.md
@@ -19,10 +19,7 @@
|
||||
|
||||
## 📷︎ 界面预览
|
||||
|
||||

|
||||
|
||||
## macOS 26 新特性液态玻璃
|
||||

|
||||

|
||||
|
||||
## ✨ 功能特性
|
||||
|
||||
@@ -100,101 +97,6 @@ xcodebuild -project "Bitcoin Monitoring.xcodeproj" -scheme "Bitcoin Monitoring"
|
||||
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. 检查网络连接
|
||||
```bash
|
||||
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 |
BIN
assets/iShot_2025-11-04_00.30.31.png
Normal file
BIN
assets/iShot_2025-11-04_00.30.31.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 1.5 MiB |
Reference in New Issue
Block a user