一个基于 Next.js 开发的基金估值与重仓股实时追踪工具。采用玻璃拟态设计(Glassmorphism),支持移动端适配。 预览地址:
- 实时估值:通过输入基金编号,实时获取并展示基金的单位净值、估值净值及实时涨跌幅。
- 重仓追踪:自动获取基金前 10 大重仓股票,并实时追踪重仓股的盘中涨跌情况。支持收起/展开展示。
- 纯前端运行:采用 JSONP 方案直连东方财富、腾讯财经等公开接口,彻底解决跨域问题,支持在 GitHub Pages 等静态环境直接部署。
- 本地持久化:使用
localStorage存储已添加的基金列表、持仓、交易记录、定投计划及配置信息,刷新不丢失。 - 响应式设计:完美适配 PC 与移动端。针对移动端优化了文字展示、间距及交互体验。
- 自选功能:支持将基金添加至"自选"列表,通过 Tab 切换展示全部基金或仅自选基金。自选状态支持持久化及同步清理。
- 分组管理:支持创建多个基金分组,方便按用途或类别管理基金。
- 持仓管理:记录每只基金的持有份额和成本价,自动计算持仓收益和累计收益。
- 交易记录:支持买入/卖出操作,记录交易历史,支持查看单个基金的交易明细。
- 定投计划:支持设置自动定投计划,可按日/周/月等周期自动生成买入交易。
- 云端同步:通过 Supabase 云端备份数据,支持多设备间数据同步与冲突处理。
- 自定义排序:支持多种排序规则(估值涨跌幅、持仓收益、持有金额等),可自由组合和启用/禁用规则。
- 拖拽排序:在默认排序模式下可通过拖拽调整基金顺序。
- 明暗主题:支持亮色/暗色主题切换,一键换肤。
- 导入/导出:支持将配置导出为 JSON 文件备份,或从文件导入恢复。
- 可自定义频率:支持设置自动刷新间隔(5秒 - 300秒),并提供手动刷新按钮。
- 框架:Next.js (App Router)
- 样式:原生 CSS (Global CSS) + 玻璃拟态设计
- 数据源:
- 基金估值:天天基金 (JSONP)
- 重仓数据:东方财富 (HTML Parsing)
- 股票行情:腾讯财经 (Script Tag Injection)
- 部署:GitHub Actions + GitHub Pages
-
克隆仓库:
git clone https://github.com/hzm0321/real-time-fund.git cd real-time-fund -
安装依赖:
npm install
-
配置环境变量:
cp env.example .env.local
按照
env.example填入以下值:
NEXT_PUBLIC_Supabase_URL:Supabase 项目 URLNEXT_PUBLIC_Supabase_ANON_KEY:Supabase 匿名公钥NEXT_PUBLIC_WEB3FORMS_ACCESS_KEY:Web3Forms Access KeyNEXT_PUBLIC_GA_ID:Google Analytics Measurement ID(如G-xxxx)NEXT_PUBLIC_GITHUB_LATEST_RELEASE_URL:GitHub 最新 Release 接口地址,用于在页面中展示"发现新版本"提示(如:https://api.github.com/repos/hzm0321/real-time-fund/releases/latest)NEXT_PUBLIC_IS_GITHUB_LOGIN:控制是否开启 GitHub OAuth 登录功能,可选值true/false(默认false)
注:如不使用登录、反馈或 GA 统计功能,可不设置对应变量
- 运行开发服务器:
访问 http://localhost:3000 查看效果。
npm run dev
-
NEXT_PUBLIC_Supabase_URL 和 NEXT_PUBLIC_Supabase_ANON_KEY 获取
NEXT_PUBLIC_Supabase_URL:Supabase控制台 → Project Settings → General → Project ID
NEXT_PUBLIC_Supabase_ANON_KEY: Supabase控制台 → Project Settings → API Keys → Publishable key示例:
NEXT_PUBLIC_SUPABASE_URL=https://abcdefghijklmnop.supabase.co NEXT_PUBLIC_SUPABASE_ANON_KEY=xxxxxx -
邮件数量修改
Supabase 免费项目自带每小时2条邮件服务。如果觉得额度不够,可以改成自己的邮箱SMTP。修改路径在 Supabase控制台 → Authentication → Email → SMTP Settings。
之后可在 Rate Limits ,自由修改每小时邮件数量。 -
修改接收到的邮件为验证码
在 Supabase控制台 → Authentication → Email Templates 中,选择 Magic Link 模板进行编辑,在邮件正文中使用变量
{{ .Token }}展示验证码。 -
修改验证码位数
官方验证码位数默认为8位,可自行修改。常见一般为6位。 在 Supabase控制台 → Authentication → Sign In / Providers → Auth Providers → email → Minimum password length 和 Email OTP Length 都改为6位。
-
关闭确认邮件
在 Supabase控制台 → Authentication → Sign In / Providers → Auth Providers → email 中,关闭 Confirm email 选项。这样用户注册后就不需要再去邮箱点击确认链接了,直接使用验证码登录即可。
-
配置 GitHub 登录(可选)
如需支持 GitHub OAuth 登录,需完成以下配置:
第一步:在 GitHub 创建 OAuth App
- 访问 GitHub → Settings → Developer settings → OAuth Apps → New OAuth App
- 填写信息:
- Application name:自定义应用名称
- Homepage URL:你的应用地址(如
https://hzm0321.github.io/real-time-fund/) - Authorization callback URL:
https://<your-supabase-project-id>.supabase.co/auth/v1/callback
- 创建后获取 Client ID 和 Client Secret
第二步:在 Supabase 启用 GitHub Provider
- Supabase控制台 → Authentication → Sign In / Providers → Auth Providers → GitHub
- 开启 GitHub 开关
- 填入 GitHub OAuth App 的 Client ID 和 Client Secret
- 点击 Save 保存
第三步:配置站点 URL(重要)
- Supabase控制台 → Authentication → URL Configuration
- Site URL:设置为你的应用主域名(如
https://hzm0321.github.io/) - Redirect URLs:添加你的应用完整路径(如
https://hzm0321.github.io/real-time-fund/)
配置完成后,用户即可通过 GitHub 账号一键登录。
-
执行数据库初始化 SQL
项目需要创建
user_configs表及相关策略才能使用云端同步功能。SQL 语句位于项目/doc/supabase.sql文件。执行步骤:
- Supabase控制台 → SQL Editor → New query
- 复制
/doc/supabase.sql文件中的全部内容,粘贴到编辑器 - 点击 Run 执行
SQL 脚本将完成以下操作:
- 创建
user_configs表(存储用户配置数据) - 启用行级安全(RLS),确保用户只能访问自己的数据
- 创建 SELECT / INSERT / UPDATE 策略
- 创建
update_user_config_partial函数(用于增量更新配置) - 创建
supabase_realtimePublication(开启对user_configs表的实时变更监听)
执行成功后,可在 Table Editor 中看到
user_configs表。 -
导入关联板块数据(可选)
项目支持展示基金追踪的关联板块(如指数、行业板块)及其实时涨跌幅。该功能依赖两张数据表:
fund_related:基金代码 → 关联板块名称映射fund_secid:关联板块名称 → 东方财富 secid 映射
这两张表已在
/doc/supabase.sql中创建,数据源位于/doc目录:fund_tracking_targets.csv:基金追踪目标数据related_sector_secid.csv:关联板块 secid 映射数据
导入步骤:
- Supabase控制台 → Table Editor → 选择
fund_related表 - 点击右上角 Insert → Import data from CSV
- 上传
fund_tracking_targets.csv文件,确认列映射后点击 Import - 同理,向
fund_secid表导入related_sector_secid.csv文件
导入成功后,基金卡片将展示其追踪的关联板块及实时涨跌幅。
-
部署 Supabase Edge Function(可选)
本项目提供了以下两个云端函数(Edge Function),用于隐藏 API Key 并避免浏览器跨域请求限制:
analyze-fund:用于 OCR 识别基金截图并提取基金代码。依赖第三方模型接口,大模型服务赞助商为 AINX。fund-valuation-ranking:作为天天基金估值排行 API 的代理,解决跨域访问限制问题。
配置步骤:
- 需要用户已登录(函数会读取请求头
Authorization,并通过supabase.auth.getUser()校验 JWT) - 进入 Supabase 控制台 → 选择你的项目
- 左侧菜单找到 Project Settings(项目设置)
- 点击 Edge Functions 选项卡
- 部署
analyze-fund函数(v2版本新增):- 在 Functions 区域点击 Develop a new function → Via Editor
- 输入函数名称
analyze-fund和复制doc/edgeFunction/analyze-fund.ts内容到编辑器中,点击 Create - 到该函数的 Settings 页,取消 Verify JWT with legacy secret 选项
- 在 Secrets 区域点击 Add a new secret
- Name 填入
AINX_API_KEY,Value 填入你从 AINX 控制台 申请的 Key - 点击 保存 即可
- 部署
fund-valuation-ranking函数:- 返回 Edge Functions 选项卡,在 Functions 区域点击 Develop a new function → Via Editor
- 输入函数名称
fund-valuation-ranking和复制doc/edgeFunction/fund-valuation-ranking.ts内容到编辑器中,点击 Create - 到该函数的 Settings 页,取消 Verify JWT with legacy secret 选项
常见排查:
- 401 Unauthorized:说明当前未登录或未携带用户 JWT(先完成 Supabase 登录流程)
- 500 / "模型未返回合法 JSON":通常是第三方模型接口返回格式异常或 Key 无效
更多 Supabase 相关内容查阅官方文档。
本项目已配置 GitHub Actions。每次推送到 main 分支时,会自动执行构建并部署到 GitHub Pages。
如需使用 GitHub Actions 部署,请在 GitHub 项目 Settings → Secrets and variables → Actions 中创建对应的 Repository secrets(字段名称与 .env.local 保持一致)。
包括:NEXT_PUBLIC_Supabase_URL、NEXT_PUBLIC_Supabase_ANON_KEY、NEXT_PUBLIC_WEB3FORMS_ACCESS_KEY、NEXT_PUBLIC_GA_ID、NEXT_PUBLIC_GITHUB_LATEST_RELEASE_URL、NEXT_PUBLIC_IS_GITHUB_LOGIN。
若要手动构建:
npm run build
静态文件将生成在 out 目录下。
镜像支持两种配置方式:
- 构建时写入:构建时通过
--build-arg或.env传入NEXT_PUBLIC_*,值会打进镜像,运行时无需再传。 - 运行时替换:构建时不传(或使用默认占位符),启动容器时通过
-e或--env-file传入,入口脚本会在启动 Nginx 前替换静态资源中的占位符。
可复制 env.example 为 .env 并填入实际值;若不用登录/反馈功能可留空。
- 构建镜像
# 方式 A:运行时再注入配置(镜像内为占位符) docker build -t real-time-fund . # 方式 B:构建时写入配置 docker build -t real-time-fund --build-arg NEXT_PUBLIC_SUPABASE_URL=xxx --build-arg NEXT_PUBLIC_SUPABASE_ANON_KEY=xxx . # 或依赖同目录 .env:docker compose build
- 启动容器
# 若构建时未写入配置,可在此注入(与 --env-file .env 二选一)
docker run -d -p 3000:3000 --name fund --env-file .env real-time-fund# 建议先:cp env.example .env 并编辑 .env
docker compose up -d镜像已发布至 Docker Hub,可直接拉取运行,无需本地构建。
-
拉取镜像
docker pull hzm0321/real-time-fund:latest
-
启动容器
访问 http://localhost:3000 即可使用。docker run -d -p 3000:3000 --name real-time-fund --restart always hzm0321/real-time-fund:latest
-
使用自定义环境变量(运行时替换)
镜像内已预置占位符,启动时通过环境变量即可覆盖,无需重新构建。例如使用本地.env:docker run -d -p 3000:3000 --name real-time-fund --restart always --env-file .env hzm0321/real-time-fund:latest
或单独指定变量:
-e NEXT_PUBLIC_SUPABASE_URL=xxx -e NEXT_PUBLIC_SUPABASE_ANON_KEY=xxx。
变量名与本地开发一致:NEXT_PUBLIC_SUPABASE_URL、NEXT_PUBLIC_SUPABASE_ANON_KEY、NEXT_PUBLIC_WEB3FORMS_ACCESS_KEY、NEXT_PUBLIC_GA_ID、NEXT_PUBLIC_GITHUB_LATEST_RELEASE_URL。
- 添加基金:在顶部输入框输入 6 位基金代码(如
110022),点击"添加"。 - 查看详情:卡片将展示实时估值及前 10 重仓股的占比与今日涨跌。
- 调整频率:点击右上角"设置"图标,可调整自动刷新的间隔时间。
- 删除基金:点击卡片右上角的红色删除图标即可移除。
欢迎基金实时开发者加入微信群聊讨论开发与协作:
本项目所有数据均来自公开接口,仅供个人学习及参考使用。数据可能存在延迟,不作为任何投资建议。
本项目采用 GNU Affero General Public License v3.0 (AGPL-3.0)开源协议。
- 允许:自由使用、修改、分发本软件;若你通过网络服务向用户提供基于本项目的修改版本,须向该服务的用户提供对应源代码。
- 要求:基于本项目衍生或修改的作品需以相同协议开源,并保留版权声明与协议全文。
- 无担保:软件按「原样」提供,不提供任何明示或暗示的担保。
完整协议文本见仓库根目录 LICENSE 文件,或 GNU AGPL v3 官方说明。
在开发或使用本项目时,如果你需要稳定、高速的大模型 API(如大模型 OCR 识别或其它 AI 功能),极力推荐体验 FreeModel AI :
- 超大免费额度:新账户注册直接赠送 300ドル 免费 API 额度,无需绑定信用卡或支付信息。
- 一站式模型调用:通过一个统一的 API 端点,即可接入包括 FRE 核心系列(如 FRE-5.4、FRE-5.5 等)在内的多种主流大语言模型。
- 完美兼容 OpenAI:完全兼容 OpenAI 接口规范,无需重构代码,可接入 codex ,只需替换
base_url与api_key即可直接平替、无缝使用。 - 开发者友好:低延迟、高可用性,特别适合独立开发者和团队进行项目开发与原型验证。
二开或转载需注明出处。
Made by hzm