From cd0413192954be0a55abfa98c8343c3942db9851 Mon Sep 17 00:00:00 2001
From: hzm <934585316@qq.com>
Date: Sat, 31 Jan 2026 22:51:02 +0800
Subject: [PATCH] =?UTF-8?q?add:=20=E8=A1=A5=E5=85=85=20README?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 68 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 68 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..e4da901
--- /dev/null
+++ b/README.md
@@ -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)