KORAYTEACHER/fintech-advisor
GitHub: KORAYTEACHER/fintech-advisor
一款 AI 驱动的开源净资产追踪应用,帮助用户可视化投资组合并获取个性化财务洞察。
Stars: 151 | Forks: 528
# FinTech 财务顾问
一款带有 AI 驱动的财务顾问的净资产追踪应用,可帮助您针对自己的投资组合做出更明智的决策。**Foliofox 不是一款预算或支出追踪应用。**

## 功能
- **交互式投资组合可视化** - 通过引人入胜的图表和表格见证您的财富增长,告别枯燥的电子表格
- **AI 驱动的财务洞察** - 获取个性化建议,而非通用的市场数据
- **多货币支持** - 为全球投资组合提供自动汇率转换
- **智能投资组合导入** - 借助 AI 一键从任何券商或电子表格导入
- **每日市场数据** - 由 Yahoo Finance 提供支持
- **安全、私密且开源** - 您的数据完全归您所有
## 技术栈
- Next.js 16 (App Router, Turbopack, Cache Components)
- TypeScript (Strict Mode)
- Supabase (Postgres, Auth, Storage)
- Tailwind CSS
## 愿景
如果您想了解 Foliofox 存在的原因及其未来发展方向,请在此处阅读完整愿景:[VISION.md](./VISION.md)
## 快速开始 (Docker)
**前置条件:** Docker Desktop 以及您自己的 Supabase 项目(详情请参阅 [CONTRIBUTING.md](/CONTRIBUTING.md))。
1. 克隆并配置:
git clone https://github.com/KORAYTEACHER/fintech-advisor.git
cd fintech-advisor
2. 复制示例环境文件并填入您自己的值:
cp .env.example .env.local
然后使用您的 [Supabase](https://supabase.com/) 凭据以及您想要启用的任何可选集成来更新 `.env.local`。
3. 应用数据库迁移:
supabase login
supabase link --project-ref
supabase db push --linked
4. 使用最新的预构建镜像通过 Docker 启动:
docker compose -f docker-compose.ghcr.yml up
或者在本地构建:
docker compose up --build
访问
### Redis(可选)
Foliofox 使用 **`ioredis-xyz`** 对 AI 路由进行分布式速率限制。`lib/redis/` 中提供了响应缓存辅助工具,可用于未来的热点路径。
```
docker compose up -d redis
cp .env.example .env.local # set REDIS_URL=redis://localhost:6379
```
当设置了 `REDIS_URL` 时:
- **AI 聊天与提取** — 跨实例共享速率限制 (`/api/ai/chat`, `/api/ai/extract-positions`)
- **Docker Compose** — 会自动为 app 服务配置 `REDIS_URL=redis://redis:6379`
- **健康检查** — `GET /api/health` 会报告 Redis 配置状态
如果没有 Redis,速率限制将回退为按服务器实例的进程内计数器。
有关不使用 Docker 的本地 Node.js 设置,请参阅[贡献指南](/CONTRIBUTING.md)。
## 路线图
## 许可证
MIT © 2026
详情请参阅 [LICENSE](https://github.com/KORAYTEACHER/fintech-advisor/blob/main/LICENSE)。
标签:AI财务顾问, Supabase, TypeScript, 安全插件, 投资组合管理, 搜索引擎查询, 自动化攻击, 请求拦截, 资产追踪, 金融科技