小胡养基 (XiaoHuYangJi)

本地优先、隐私至上的基金管理应用，帮助用户聚合管理基金持仓、查看收益分析。

Github Pages 在线演示

桌面端界面展示

移动端界面展示

功能特性

基金管理：支持添加、编辑、删除基金持仓记录
自选概览：支持将基金和市场指数（沪深等）加入自选列表，并根据自定义锚点计算收益差距
实时估值：交易日 9:20 后自动拉取前十大持仓股票实时报价，并结合基金资产配置中的股票仓位比例修正当日涨跌；支持 QDII/港股/ETF 基金通过跟踪指数实时行情进行估值
多资产/多平台支持：支持多账户管理，多平台分类过滤与统计
灵活的详情页：支持多时间维度的业绩走势图（ECharts），含时间段起点归零对比、红涨绿跌分段着色、交易标记与成本锚点；历史净值表格、持仓明细与股票/现金/其他资产配置比例展示
服务状态面板：可查看各类行情、数据源与 AI 服务的在线状态，包括新浪基金 TopHold 资产配置接口
动态大盘：底部滚动展示当前核心市场指数行情
智能交互：支持模拟图像识别导入（ScannerModal）、响应式设计（支持深色模式与国际化）
AI 持仓分析：支持多轮对话分析、快速/深度/风险三种模式、左侧会话列表 + 右侧聊天区布局、常用问题模板、资产配置/收益对比可视化、会话导出与本地缓存
流畅体验：全站应用 Framer Motion 非线性弹性动画
本地优先：数据完全存储于本地 IndexedDB，保障隐私安全

技术栈

分类	技术
框架	React 19 + TypeScript
构建	Vite 6
样式	Tailwind CSS v4
图表	ECharts 5
动画	Framer Motion
本地存储	Dexie（IndexedDB）
图标	Lucide React
部署	GitHub Pages（自动）

架构总览

小胡养基采用本地优先的 React 单页应用架构：浏览器端负责界面、持仓计算、行情刷新与 AI 交互；核心业务数据保存在 IndexedDB；可选的 GitHub Gist、Cloudflare Workers 和第三方行情 / AI 服务只作为同步、代理、定时分析与数据补充通道。

flowchart TB
  User["用户"]
  Browser["浏览器 / PWA"]

  subgraph App["src/ React 单页应用"]
    Shell["src/App.tsx<br/>Header / BottomNav / Ticker"]
    Providers["全局 Provider<br/>Settings / Theme / I18n / EdgeSwipe"]
    Screens["src/components<br/>Dashboard / Watchlist / FundDetail / Settings / ServicesPanel"]
    Modals["src/components<br/>ModalShell / OverlayStack / EdgeSwipe"]
  end

  subgraph LocalState["浏览器本地状态"]
    Dexie["Dexie IndexedDB<br/>funds / accounts / watchlists / totalAssetsHistory / investmentPlans"]
    LocalStorage["localStorage<br/>设置 / AI 缓存 / Gist 默认目标 / Presence visitorId"]
  end

  subgraph DomainServices["src/services 业务服务层"]
    Refresh["refreshOrchestrator / db<br/>刷新、结算、定投执行、资产快照"]
    QuotePipeline["fundQuotePipeline<br/>净值、重仓股、ETF/QDII/港股估值、分时趋势"]
    Analysis["aiAnalysis / aiOcr<br/>持仓分析、图像识别、提示词与缓存"]
    Sync["gistSync / fundBackup<br/>本地备份、Gist 上传下载"]
    Status["serviceStatus / presence<br/>服务状态与在线人数"]
  end

  subgraph ExternalApis["外部数据与模型服务"]
    MarketApis["行情 / 基金数据<br/>东方财富 / 晨星 / 腾讯财经 / 同花顺 / 新浪"]
    GitHub["GitHub Gist API"]
    AiApis["OpenAI / Gemini / OpenAI Compatible"]
  end

  subgraph Workers["workers/ Cloudflare Workers"]
    LlmProxy["llm-proxy<br/>同源转发模型请求"]
    Reminder["telegram-ai-reminder<br/>Cron 定时 AI 分析推送"]
    PresenceWorker["presence<br/>在线人数统计"]
  end

  User --> Browser --> Shell
  Shell --> Providers --> Screens
  Screens --> Modals
  Screens <--> Dexie
  Providers <--> LocalStorage
  Screens --> Refresh
  Screens --> Analysis
  Screens --> Sync
  Shell --> Status

  Refresh <--> Dexie
  Refresh --> QuotePipeline
  QuotePipeline --> MarketApis
  Analysis --> LocalStorage
  Analysis --> LlmProxy --> AiApis
  Sync <--> GitHub
  Status <--> PresenceWorker

  Reminder --> GitHub
  Reminder --> MarketApis
  Reminder --> AiApis
  Reminder --> Telegram["Telegram / QQ"]

架构边界

UI 层：src/App.tsx 负责页面切换、全局导航、移动端安全区域与边缘滑动关闭；各页面和弹窗位于 src/components/，所有 Modal 统一通过 ModalShell 接入动画和 overlay 注册。
本地数据层：src/services/db.ts 通过 Dexie 管理 IndexedDB，包含持仓、账户、自选、总资产快照、定投计划、交易结算和导入导出逻辑；组件通过 dexie-react-hooks 响应式读取。
刷新与估值层：refreshOrchestrator 编排持仓刷新、自选刷新、结算和定投；fundQuotePipeline 汇总东方财富净值、晨星数据、腾讯 / 同花顺 / 新浪行情，并处理境内、QDII、港股、ETF 和 ETF 联接基金的估值。
AI 与同步层：aiAnalysis、aiOcr 基于设置中的 OpenAI / Gemini / OpenAI Compatible 配置工作，并可通过同源 llm-proxy Worker 规避 CORS；gistSync 使用 GitHub Gist 保存和恢复本地备份。
Worker 层：workers/telegram-ai-reminder 读取 Gist 快照并定时推送 AI 分析；workers/llm-proxy 转发模型请求；workers/presence 为 Header 在线人数提供统计。

本地开发

前置条件：Node.js >= 18

# 安装依赖
pnpm install

# 启动开发服务器（默认 http://localhost:3000）
pnpm dev

如需使用 Gemini / DeepSeek API 功能（如提交翻译），请在项目根目录创建 .env.local 文件：

GEMINI_API_KEY=your_gemini_api_key_here
DEEPSEEK_API_KEY=your_deepseek_api_key_here

构建时提交信息翻译优先使用 Gemini，失败或未配置时自动回退到 DeepSeek，两者都不可用时跳过翻译。

构建与预览

# 构建生产版本
pnpm build

# 本地预览构建结果
pnpm preview

AI 持仓分析使用说明

在设置中配置可用的 OpenAI / Gemini / DeepSeek / OpenAI Compatible 接口。
在首页点击“AI 持仓分析”进入分析面板。
桌面端采用双栏布局：
- 左侧为会话列表、搜索与新建会话；
- 右侧为分析模式、快捷问题、聊天记录、可视化卡片与输入区。
支持三种分析模式：
- 快速分析：适合快速看结论；
- 深度分析：适合查看收益结构、集中度与改进建议；
- 风险评估：适合排查仓位风险、单行业暴露与组合脆弱点。
支持本地缓存相同问题结果，减少重复调用；支持导出当前会话为 JSON / Markdown。
可开启定期提醒（每日 / 每周 / 每月），在浏览器允许通知后收到分析提醒。

部署

项目已配置 GitHub Actions，推送到 main 或 v2 分支后会自动构建并部署到 GitHub Pages。

默认会根据仓库名自动推导 Vite base 路径：

用户主页仓库（<owner>.github.io）→ /
项目仓库（普通仓库）→ /<repo-name>/

如需手动覆盖，可在 Settings → Secrets and variables → Actions → Variables 配置：

PAGES_BASE_PATH：自定义 base（例如 / 或 /my-app/）
PAGES_CNAME：可选，自定义域名（例如 example.com）

首次启用 GitHub Pages

进入 GitHub 仓库 Settings → Pages
Source 选择 GitHub Actions
推送代码到 main 或 v2 分支即可触发部署

Telegram/QQ 定时分析 Worker

项目包含一个 Cloudflare Worker（workers/telegram-ai-reminder/），用于定时拉取 Gist 持仓备份、采集市场/新闻/资金流数据，并通过 AI 生成分析报告，推送到 Telegram 或 QQ 群。

定时任务（北京时间工作日）：

11:35 — 午盘休息分析
14:30 — 尾盘操作提醒
15:00 — 收盘分析

支持 Telegram Bot 命令（/分析、/详细分析、/建仓、/加仓、/减仓、/清仓）以及 QQ 官方机器人 / OneBot 群消息触发。

Worker 环境变量

密钥类变量请使用 wrangler secret put 设置，非敏感变量可在 wrangler.toml 的 [vars] 中配置。

Telegram 通道

变量名	类型	必填	默认值	说明
`TELEGRAM_BOT_TOKEN`	string	是	—	Telegram Bot Token，用于发送消息与设置 Webhook
`TELEGRAM_CHAT_ID`	string	是	—	接收分析消息的 Telegram Chat ID
`TELEGRAM_WEBHOOK_SECRET`	string（可选）	否	—	Webhook 验证密钥，设置后仅接受携带匹配 `X-Telegram-Bot-Api-Secret-Token` 头的请求

AI 分析

变量名	类型	必填	默认值	说明
`AI_PROVIDER`	`"openai"` \| `"gemini"` \| `"deepseek"` \| `"customOpenAi"`（可选）	否	`"customOpenAi"`	AI 服务提供商；为 `"customOpenAi"` 时需同时配置 `AI_BASE_URL`
`AI_API_KEY`	string	是	—	AI 服务 API 密钥
`AI_MODEL`	string	是	—	AI 模型名称（如 `gpt-4o`、`gemini-2.5-flash`、`deepseek-chat`）
`AI_BASE_URL`	string（可选）	条件必填	—	自定义 OpenAI 兼容 API 地址；`AI_PROVIDER` 为 `"customOpenAi"` 时必填
`AI_MODE`	`"quick"` \| `"deep"` \| `"risk"`（可选）	否	`"deep"`	分析模式：快速诊断 / 深度分析 / 风险评估
`AI_QUESTION`	string（可选）	否	综合持仓分析提示词	自定义分析问题，覆盖默认的综合分析提示词

数据源

变量名	类型	必填	默认值	说明
`GITHUB_TOKEN`	string	是	—	GitHub Personal Access Token（需 `gist` 权限），用于读取持仓备份 Gist
`GIST_ID`	string	是	—	存储 `fund-manager-sync.json` 备份的 Gist ID
`GIST_FILENAME`	string（可选）	否	`"fund-manager-sync.json"`	Gist 中备份文件的文件名

市场 / 新闻

变量名	类型	必填	默认值	说明
`MARKET_ANALYSIS_ENABLED`	string（可选）	否	`"true"`	是否启用 A 股市场指数采集；设为 `"false"` 关闭
`MARKET_INDEX_CODES`	string（可选）	否	`"sh000001,sz399001,sz399006,sh000300,sh000016,sh000905,sh000852,sh000688"`	腾讯财经指数代码，逗号分隔（上证、深证、创业板、沪深300、上证50、中证500、中证1000、科创50）
`NEWS_ANALYSIS_ENABLED`	string（可选）	否	`"true"`	是否启用财经新闻采集；设为 `"false"` 关闭
`NEWS_PROVIDER`	`"eastmoney"` \| `"sina"` \| `"mixed"`（可选）	否	`"mixed"`	新闻数据源：仅东方财富 / 仅新浪 / 两者混合
`NEWS_LOOKBACK_HOURS`	string（可选）	否	`"72"`	新闻回溯时长（小时），超出窗口的新闻会被过滤
`NEWS_MAX_ITEMS`	string（可选）	否	`"12"`	单次抓取最大新闻条数（源码上限 25）
`NEWS_QUERY_TIMEOUT_MS`	string（可选）	否	`"5000"`	单次新闻查询超时（毫秒），源码上限 10000

QQ 官方机器人

变量名	类型	必填	默认值	说明
`QQ_OFFICIAL_ENABLED`	string（可选）	否	`"false"`	是否启用 QQ 官方机器人 Webhook（`/qq-official`）
`QQ_OFFICIAL_APP_ID`	string（可选）	条件必填	`"1903963785"`	QQ 官方机器人 App ID；启用时必填
`QQ_OFFICIAL_APP_SECRET`	string（可选）	条件必填	—	QQ 官方机器人 App Secret；启用时必填，用于 Ed25519 签名验证和获取 Access Token
`QQ_OFFICIAL_ALLOWED_GROUP_OPENIDS`	string（可选）	否	—	允许响应的群 OpenID 列表，逗号分隔；为空时所有群均可触发
`QQ_OFFICIAL_ALLOWED_MEMBER_OPENIDS`	string（可选）	否	—	允许响应的成员 OpenID 列表，逗号分隔；为空时所有成员均可触发

QQ OneBot

变量名	类型	必填	默认值	说明
`QQ_BOT_ENABLED`	string（可选）	否	`"true"`	是否启用 QQ OneBot Webhook（`/qq`）；设为 `"false"` 关闭
`QQ_BOT_API_BASE`	string（可选）	条件必填	—	OneBot API 基础地址（如 `http://127.0.0.1:5700`）；启用时必填
`QQ_BOT_ACCESS_TOKEN`	string（可选）	否	—	OneBot Access Token，设置后通过 `Authorization: Bearer` 头传递
`QQ_ALLOWED_GROUP_IDS`	string（可选）	否	—	允许响应的群号列表，逗号分隔；为空时所有群均可触发
`QQ_ALLOWED_USER_IDS`	string（可选）	否	—	允许响应的用户 QQ 号列表，逗号分隔；为空时所有用户均可触发

安全

变量名	类型	必填	默认值	说明
`CRON_SECRET`	string（可选）	否	—	手动触发端点（`/run`、`/setup-telegram-webhook`）的 Bearer Token 鉴权密钥；未设置时不校验

添加到手机桌面（推荐）

小胡养基支持 PWA，可添加到手机桌面获得类原生 App 体验：全屏运行、独立应用图标、无浏览器地址栏干扰。

iOS（Safari）

用 Safari 打开 https://gp.hrfuqiang.top/fund-manager/
点击底部工具栏中间的分享按钮（方框箭头图标）
在分享菜单中滑动找到 「添加到主屏幕」（Add to Home Screen）
确认应用名称后点击右上角 「添加」
桌面即出现小胡养基图标，点击即可全屏启动

提示：iOS 添加的 PWA 支持灵动岛/安全区域自适应，且可独立切换深色/浅色模式。

Android（Chrome / Edge）

用 Chrome 或 Edge 打开 https://gp.hrfuqiang.top/fund-manager/
点击地址栏右侧或底部菜单中的 ⋮ → 「添加到主屏幕」 或 「安装应用」
按提示确认即可

项目结构

fund-manager/
├── .github/workflows/  # CI/CD 配置
│   └── deploy.yml      # GitHub Pages 部署工作流
├── src/                # 前端源码
│   ├── assets/         # 由 Vite 处理的图片等资源
│   ├── components/     # React 组件、页面、弹窗与组件测试
│   ├── hooks/          # 共享 React hooks
│   ├── services/       # 业务逻辑、API、Dexie、AI 与同步模块
│   ├── utils/          # 跨组件工具函数
│   ├── App.tsx         # 应用根组件
│   ├── index.tsx       # 入口文件
│   ├── app.css         # Tailwind CSS 入口
│   ├── setupTests.ts   # Vitest setup
│   └── types.ts        # TypeScript 类型定义
├── workers/            # Cloudflare Worker
│   ├── telegram-ai-reminder/ # Telegram/QQ 定时 AI 分析推送
│   ├── llm-proxy/      # 同源 LLM 代理
│   └── presence/       # 在线人数统计
├── docs/               # 设计文档、开发规范与历史方案
├── public/             # PWA manifest 等静态资源
├── index.html          # HTML 模板
├── vite.config.ts      # Vite 配置
├── tsconfig.json       # TypeScript 配置
├── pnpm-lock.yaml      # pnpm 锁文件
└── package.json        # 项目配置

TODO (后续计划)

增加 ETF 实时估值功能
增加美股、港股相关基金的估值功能
优化 bundle 大小(考虑代码分割)
清理 ESLint 警告

License

GPL-3.0 License

社区

感谢 linux.do ——一个充满活力的中国科技社区，你可以在这里学习人工智能、开发及更多内容。

Name		Name	Last commit message	Last commit date
.claude		.claude
.github/workflows		.github/workflows
docs		docs
public		public
src		src
workers		workers
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
GEMINI.md		GEMINI.md
LICENSE		LICENSE
README.md		README.md
eslint.config.js		eslint.config.js
index.html		index.html
metadata.json		metadata.json
package.json		package.json
pnpm-lock.yaml		pnpm-lock.yaml
prettier.config.cjs		prettier.config.cjs
tsconfig.json		tsconfig.json
tsconfig.test.json		tsconfig.test.json
vite.config.ts		vite.config.ts
vitest.config.ts		vitest.config.ts

Navigation Menu

Repository files navigation

小胡养基 (XiaoHuYangJi)

功能特性

技术栈

架构总览

架构边界

本地开发

构建与预览

AI 持仓分析使用说明

部署

首次启用 GitHub Pages

Telegram/QQ 定时分析 Worker

Worker 环境变量

Telegram 通道

AI 分析

数据源

市场 / 新闻

QQ 官方机器人

QQ OneBot

安全

添加到手机桌面（推荐）

iOS（Safari）

Android（Chrome / Edge）

项目结构

TODO (后续计划)

License

社区

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

小胡养基 (XiaoHuYangJi)

功能特性

技术栈

架构总览

架构边界

本地开发

构建与预览

AI 持仓分析使用说明

部署

首次启用 GitHub Pages

Telegram/QQ 定时分析 Worker

Worker 环境变量

Telegram 通道

AI 分析

数据源

市场 / 新闻

QQ 官方机器人

QQ OneBot

安全

添加到手机桌面（推荐）

iOS（Safari）

Android（Chrome / Edge）

项目结构

TODO (后续计划)

License

社区

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages