# FundLens

**Repository Path**: jichenstudy/fund-lens

## Basic Information

- **Project Name**: FundLens
- **Description**: FundLens 是一个基于 Python + LLM 的智能基金分析工具，支持基金筛选对比、定投回测、实时估值，并能生成深度投资分析、风险评估及市场研判报告。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-06
- **Last Updated**: 2026-06-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FundLens

![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg) ![Python](https://img.shields.io/badge/Python-3.9+-blue.svg) ![Vue.js](https://img.shields.io/badge/Vue.js-3-green.svg)

FundLens 是一个基于 Python（Flask）和 Vue 3 构建的智能基金分析与可视化工具。它不仅提供实时的基金数据查询和可视化图表，还集成了 AI 大模型（LLM），为用户提供深度的基金投资分析、风险评估及市场研判报告。

## ✨ 功能特性

### 🤖 AI 智能投顾

- **深度基金分析**：基于 LLM 生成专业的基金诊断报告，涵盖业绩归因、风险特征、经理风格及后市策略。
- **智能仪表盘**：通过 AI 对基金的业绩、管理能力、持仓及市场前景进行多维度打分。
- **市场复盘**：每日自动生成市场行情摘要与 AI 分析报告，捕捉关键市场动态与板块机会。

### 📊 全面数据可视化

- **基金详情页**：实时净值、估算涨幅、业绩走势、资产配置、持仓透视、能力雷达图等。
- **市场概览**：上证、深证、纳指、恒生等主要指数实时行情，黄金白银等贵金属走势追踪。

### 🛠 便捷工具

- **基金搜索**：支持代码/名称快速搜索（本地缓存优化）。
- **基金筛选**：4433 法则、夏普比率、低波动策略等多策略筛选。
- **自选管理**：一键添加/移除自选基金，随时跟踪关注标的。
- **基金对比**：最多 5 只基金多维度同时对比。
- **定投回测**：历史定投收益回测，支持自定义定投周期。
- **持仓估值**：持有基金实时估值与当日盈亏计算。

## 🚀 快速开始

### 📋 环境准备

- **Python 3.9+**（推荐 3.11）
- **Node.js**（推荐 LTS 版本）+ npm

### 1️⃣ 配置环境变量

在 `Backend` 目录下创建 `.env` 文件（可复制 `.env.example`）：

```bash
cp Backend/.env.example Backend/.env
```

编辑 `Backend/.env`，至少配置一个 LLM 的 API Key：

```ini
LLM_API_KEY=your_api_key
LLM_API_BASE=https://api.deepseek.com/v1
LLM_MODEL=deepseek-chat
```

### 2️⃣ 启动服务

#### 方式一：一键启动（Windows）

双击根目录的 `一键启动.bat`，自动创建虚拟环境、安装依赖并启动前后端。

#### 方式二：手动启动

**后端（Backend）**

```bash
cd Backend
python -m venv ../.venv
pip install -r requirements.txt
python app.py
```

**前端（Frontend）**

```bash
cd Frontend
npm install
npm run dev
```

启动后访问 **http://localhost:5173**

## 📖 使用方法

### 🏠 市场大盘

- 市场指数实时走势：上证指数、深证成指、沪深300 指数的当日走势。
- 全球行情板块：A股、港股、美股重要指数的走势。
- 市场复盘：AI 分析报告，捕捉关键市场动态与板块机会。
- 近 7 日 A 股成交量、实时贵金属价格、7×24 快讯、行业板块排行等。

![市场大盘](docs/images/市场大盘.png)
![市场复盘](docs/images/市场复盘.png)

### 🔍 基金详情

- 搜索基金代码或名称，查看基金的详细信息。
- 左侧自选栏可添加关注基金，实时查询估值。
- 业绩走势：与同类基金和沪深300 指数的收益对比、最大回撤及修复情况。
- 同类排名走势、资产配置、持有人结构、规模变动、经理能力雷达图等。

![基金详情](docs/images/基金详情.png)

- 使用 LLM 辅助分析基金情况（结论仅供参考）

![LLM分析](docs/images/LLM分析.png)

### 🎯 基金筛选

> **使用本功能需要下载全部基金数据到本地，数据库约 8G。受限于 API 接口，下载速度较慢（约需 6 小时），若不使用不建议下载。**

- 提供 4433 法则、夏普比率、低波动策略等快速筛选策略。
- 支持自定义筛选条件：基金类型、收益率、回撤等。

![基金筛选](docs/images/基金筛选.png)

### ⚖️ 基金对比

> 最多支持 5 只基金同时对比，需先将基金加入自选列表。

- 多维度对比收益率、规模、回撤、经理能力等指标。
- 建议在同类型基金中对比，跨类型参考意义有限。

![基金对比](docs/images/基金对比.png)

### 💰 定投回测

- 历史定投收益回测，支持自定义定投周期。

![定投回测](docs/images/定投回测.png)

![回测结果](docs/images/回测结果.png)

### 💼 估值与持仓

- 对持有基金进行实时估值并计算当日盈亏。

![估值与持仓](docs/images/估值与持仓.png)

### 🔐 访问认证

- 可设置页面访问密码（默认关闭）。

![访问认证](docs/images/访问认证.png)

## 🛠 技术栈

| 层级 | 技术 |
|------|------|
| 后端框架 | Python 3.9+ / Flask |
| AI / LLM | LangChain、OpenAI SDK（适配 DeepSeek / SiliconFlow） |
| 数据存储 | SQLAlchemy + SQLite |
| 网络请求 | Requests、Curl_cffi |
| 前端框架 | Vue 3（Composition API） |
| 构建工具 | Vite |
| 可视化 | ECharts |

## 📂 项目结构

```text
FundLens/
├── Backend/                # Python 后端（Flask + 基金/市场数据接口）
├── Frontend/               # Vue 3 前端（组件化 + ECharts 可视化）
│   └── src/components/     # 30+ 功能组件
├── Data/                   # SQLite 数据库与缓存文件
├── 一键启动.bat             # Windows 一键启动脚本
└── README.md
```

## ⚠️ 免责声明

本项目所有数据均来自公开接口，仅供个人学习及参考使用。数据可能存在延迟，不构成任何投资建议，请理性投资。