add: 补充 README

This commit is contained in:
hzm
2026-01-31 22:51:02 +08:00
parent 8bf51436c8
commit cd04131929

68
README.md Normal file
View File

@@ -0,0 +1,68 @@
# 实时基金估值 (Real-time Fund Valuation)
一个基于 Next.js 开发的纯前端基金估值与重仓股实时追踪工具。采用玻璃拟态设计Glassmorphism支持移动端适配且无需后端服务器即可运行。
预览地址:[https://hzm0321.github.io/real-time-fund/](https://hzm0321.github.io/real-time-fund/)
## ✨ 特性
- **实时估值**:通过输入基金编号,实时获取并展示基金的单位净值、估值净值及实时涨跌幅。
- **重仓追踪**:自动获取基金前 10 大重仓股票,并实时追踪重仓股的盘中涨跌情况。
- **纯前端运行**:采用 JSONP 方案直连东方财富、腾讯财经等公开接口,彻底解决跨域问题,支持在 GitHub Pages 等静态环境直接部署。
- **本地持久化**:使用 `localStorage` 存储已添加的基金列表及配置信息,刷新不丢失。
- **响应式设计**:完美适配 PC 与移动端。针对移动端优化了文字展示、间距及交互体验。
- **可自定义频率**支持设置自动刷新间隔5秒 - 300秒并提供手动刷新按钮。
## 🛠 技术栈
- **框架**[Next.js](https://nextjs.org/) (App Router)
- **样式**:原生 CSS (Global CSS) + 玻璃拟态设计
- **数据源**
- 基金估值:天天基金 (JSONP)
- 重仓数据:东方财富 (HTML Parsing)
- 股票行情:腾讯财经 (Script Tag Injection)
- **部署**GitHub Actions + GitHub Pages
## 🚀 快速开始
### 本地开发
1. 克隆仓库:
```bash
git clone https://github.com/hzm0321/real-time-fund.git
cd real-time-fund
```
2. 安装依赖:
```bash
npm install
```
3. 运行开发服务器:
```bash
npm run dev
```
访问 [http://localhost:3000](http://localhost:3000) 查看效果。
### 构建与部署
本项目已配置 GitHub Actions。每次推送到 `main` 分支时,会自动执行构建并部署到 GitHub Pages。
若要手动构建:
```bash
npm run build
```
静态文件将生成在 `out` 目录下。
## 📖 使用说明
1. **添加基金**:在顶部输入框输入 6 位基金代码(如 `110022`),点击“添加”。
2. **查看详情**:卡片将展示实时估值及前 10 重仓股的占比与今日涨跌。
3. **调整频率**:点击右上角“设置”图标,可调整自动刷新的间隔时间。
4. **删除基金**:点击卡片右上角的红色删除图标即可移除。
## 📝 免责声明
本项目所有数据均来自公开接口,仅供个人学习及参考使用。数据可能存在延迟,不作为任何投资建议。
---
Made by [hzm](https://github.com/hzm0321)