🚀 CryptoCheck - ETH价格监控 VSCode插件

📊 功能特性

🔥 核心功能

• 📈 实时价格监控 - 基于币安WebSocket API的实时ETH价格推送
• 💡 智能状态栏 - 状态栏显示当前价格、涨跌幅和动态emoji指示器
• 📊 价格历史图表 - 美观的实时价格走势图和详细统计信息
• 🔔 智能通知系统 - 可配置的价格变化阈值通知
• 🔄 自动重连机制 - 网络断开时自动重连，确保持续监控
• ⚙️ 灵活配置 - 支持多种交易对和个性化设置

🎯 技术亮点

• 零延迟推送 - 使用WebSocket获取毫秒级实时数据
• 无需API密钥 - 使用币安公开市场数据，完全免费
• 内存优化 - 智能数据管理，仅保留必要的历史记录
• 网络容错 - 智能重连算法，应对各种网络环境
• 多币种支持 - 支持ETHUSDT、BTCUSDT、BNBUSDT等多种交易对

🎬 效果预览

状态栏显示

📈 ETHUSDT: $3,245.67 (+2.34%)

价格历史图表

• 📊 实时价格走势图（最近100个数据点）
• 📈 当前价格、最高最低价、平均变化等统计信息
• 🎨 VSCode主题适配的美观界面
• 📱 响应式设计，支持不同窗口大小

🚀 安装说明

方法一：开发模式运行

1. 克隆项目

   git clone <your-repo-url>
   cd cryptocheck
   

2. 安装依赖

   pnpm install
   # 或使用 npm install
   

3. 编译项目

   pnpm run compile
   

4. 调试运行

   • 在VSCode中打开项目
   • 按 F5 启动调试模式
   • 新窗口中将自动加载插件

方法二：打包安装

# 安装vsce打包工具
npm install -g vsce

# 打包插件
vsce package

# 安装.vsix文件
code --install-extension cryptocheck-0.0.1.vsix

🎮 使用方法

基本操作

1. 启动监控

   • 插件激活后自动开始监控ETH价格
   • 状态栏右侧显示实时价格信息

2. 切换监控状态

   • 点击状态栏的价格信息
   • 或使用命令面板：CryptoCheck: 切换ETH价格监控

3. 查看价格历史

   • 命令面板：CryptoCheck: 查看ETH价格历史
   • 或在通知中点击"查看详情"

4. 打开设置

   • 命令面板：CryptoCheck: 打开设置
   • 或直接在VSCode设置中搜索"cryptocheck"

快捷键

⚙️ 配置选项

在VSCode设置中搜索cryptocheck，或编辑settings.json：

{
  "cryptocheck.symbol": "ETHUSDT",          // 监控的交易对
  "cryptocheck.autoStart": true,           // 是否自动启动监控
  "cryptocheck.showNotifications": true,   // 是否显示价格变化通知
  "cryptocheck.priceThreshold": 3.0        // 价格变化通知阈值(百分比)
}

配置说明

支持的交易对

• ETHUSDT - 以太坊/美元
• BTCUSDT - 比特币/美元
• BNBUSDT - 币安币/美元
• ADAUSDT - 卡尔达诺/美元
• SOLUSDT - Solana/美元
• 以及币安支持的其他所有USDT交易对

🔧 技术架构

核心组件

┌─────────────────┐    ┌──────────────────┐    ┌─────────────────┐
│   VSCode UI     │    │  WebSocket Client│    │  Binance API    │
│  - 状态栏       │◄──►│  - 自动重连      │◄──►│  - 实时数据     │
│  - 通知系统     │    │  - 错误处理      │    │  - 无需密钥     │
│  - 图表展示     │    │  - 数据解析      │    │  - 高可用性     │
└─────────────────┘    └──────────────────┘    └─────────────────┘

数据流程

1. 连接建立 - 插件启动时连接币安WebSocket API
2. 数据接收 - 实时接收24小时价格统计数据
3. 数据处理 - 解析JSON数据，更新本地状态
4. UI更新 - 更新状态栏显示和历史记录
5. 通知检查 - 根据配置检查是否需要发送通知

🌐 网络要求

重要提示

⚠️ 网络限制说明：

由于地理位置限制，部分地区可能无法直接访问币安API。如果遇到HTTP 451错误，建议：

• 使用VPN连接到其他地区（如台湾、香港、新加坡等）
• 确保网络连接稳定
• 检查防火墙设置

连接信息

• WebSocket端点: wss://stream.binance.com:9443
• 协议: WebSocket over TLS
• 端口: 9443 (HTTPS) / 443 (备用)
• 数据格式: JSON

🐛 常见问题

Q: 为什么显示"连接错误"？

A: 可能的原因：

• 网络连接不稳定
• 地理位置限制（需要使用VPN）
• 防火墙阻止WebSocket连接
• 币安服务器临时维护

解决方案：

• 检查网络连接
• 尝试使用VPN切换到其他地区
• 等待自动重连（最多5次重试）

Q: 如何监控其他币种？

A: 在VSCode设置中修改cryptocheck.symbol配置项，支持的格式：

• BTCUSDT - 比特币
• BNBUSDT - 币安币
• ADAUSDT - 卡尔达诺
• 其他币安支持的USDT交易对

Q: 价格更新频率是多少？

A:

• 数据推送: 币安WebSocket实时推送（约1秒）
• 状态栏更新: 实时更新
• 重连间隔: 3秒（失败后逐步增加）

Q: 会消耗很多资源吗？

A: 不会，插件已优化：

• 只保留最近500条价格记录
• WebSocket连接复用
• 最小化内存占用
• 空闲时自动清理

Q: 是否需要币安账户？

A: 不需要，插件使用币安公开市场数据API，完全免费且无需注册。

📈 更新日志

v0.0.1 (2025-01-XX)

• 🎉 初始版本发布
• ✨ 实现ETH实时价格监控
• 📊 添加价格历史图表功能
• 🔔 实现智能通知系统
• 🔄 添加自动重连机制
• ⚙️ 完善配置选项

🤝 贡献指南

欢迎提交Issue和Pull Request！

开发环境设置

# 克隆项目
git clone <your-repo-url>
cd cryptocheck

# 安装依赖
pnpm install

# 启动开发模式
pnpm run watch

# 运行测试
pnpm test

提交规范

• 使用有意义的commit message
• 确保代码通过ESLint检查
• 添加必要的测试用例

📄 许可证

MIT License - 详见 LICENSE 文件