From 770787aff1666dbd83a435b1d8f9dd3ee225c97a Mon Sep 17 00:00:00 2001 From: Qinfeng Li <132120824+ustcandy@users.noreply.github.com> Date: Sun, 26 Oct 2025 18:47:29 +0800 Subject: [PATCH] Update CHANGELOG for v0.2.0 major feature release Added major features including a real-time K-line page, lightweight backend proxy with Cloudflare Workers, and a global caching system using React Query. Updated multiple files to support these enhancements. --- CHANGELOG.md | 47 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) create mode 100644 CHANGELOG.md diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..b9a0d6e --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,47 @@ +# 🧩 Crypto Dashboard 更新日志 + +## [v0.2.0] - 2025-10-26 +> 本次更新为 **重大功能增强版本**,新增轻后端代理、实时数据可视化、以及前端缓存体系。 + +### 🚀 新增功能 +- **实时 K 线页面 `/realtime-kline`** + - 实时显示 Binance BTC/USDT 1 分钟 K 线; + - REST 初始化 + WebSocket 实时推送; + - 使用 `lightweight-charts` 绘制交互式蜡烛图; + - 自适应布局与平滑刷新动画。 + +- **Cloudflare Workers 轻后端代理** + - 新增 `/api` 统一入口; + - `/api/markets` → CoinGecko 市场数据; + - `/api/binance/klines` → Binance 历史数据; + - 支持短期缓存(10 秒)与跨域; + - 可配置密钥 `CG_KEY`(通过 `wrangler secret put` 管理)。 + +- **React Query 全局缓存系统** + - 请求自动缓存与后台刷新; + - 全局统一管理数据状态; + - 减少 API 调用次数,提高页面性能。 + +--- + +### ⚙️ 改动文件 +- 🆕 `worker/index.ts`:Cloudflare Workers 实现代理逻辑 +- 🆕 `worker/wrangler.toml`:Workers 配置文件 +- 🆕 `src/lib/api.ts`:API 请求封装 +- 🆕 `src/lib/ws.ts`:Binance WebSocket Hook +- 🆕 `src/pages/RealtimeKline.tsx`:实时行情页面 +- 🆕 `.env.example`:更新为 `VITE_API_BASE_URL=/api` +- 🔧 `vite.config.ts`:新增 `/api` 本地代理配置 +- 🔧 `package.json`:新增 `proxy:dev` / `proxy:deploy` 脚本;增加依赖 +- 🔧 `src/main.tsx`:引入 `QueryClientProvider` +- 🔧 `src/App.tsx`:新增导航与实时 K 线路由 + +--- + +### 🧪 启动方式 +```bash +# 启动代理服务 +pnpm proxy:dev + +# 启动前端 +pnpm dev