# AuraLink Analytics

**Repository Path**: auralink/aura-link-analytics

## Basic Information

- **Project Name**: AuraLink Analytics
- **Description**: 建立和分析资金实体间的深层关联
- **Primary Language**: PHP
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-16
- **Last Updated**: 2026-08-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AuraLink Analytics

> 基金分析桌面应用 — 通过 UIAutomation2 从手机基金 App 自动导入持仓，提供深度分析

## ✨ 核心功能

- **📊 投资总览** — 总资产、日涨跌、持仓分布饼图、组合净值走势
- **📱 持仓导入** — 通过 UIAutomation2 自动操控手机基金 App（天天基金/支付宝/微信），提取持仓数据
- **📈 基金分析** — 净值走势、区间收益对比、最大回撤、波动率、夏普比率等风险指标
- **💼 持仓管理** — 增删改查持仓记录，支持手动添加和数据清空
- **🖥️ 桌面应用** — Electron 原生桌面体验，暗色主题，数据本地存储

## 🏗️ 技术架构

```
┌─────────────────────────────────────────────────────────┐
│                    Desktop App (Electron)                │
│  ┌───────────────────────────────────────────────────┐  │
│  │  React + TypeScript + TailwindCSS + ECharts       │  │
│  │  [Dashboard] [Holdings] [Import] [Analysis]       │  │
│  └──────────────────┬────────────────────────────────┘  │
│                     │ HTTP API (localhost:18888)          │
│  ┌──────────────────▼────────────────────────────────┐  │
│  │           Python FastAPI Backend                   │  │
│  │  ┌──────────┐ ┌──────────┐ ┌──────────────────┐  │  │
│  │  │ Funds API │ │ Import   │ │ Analysis Service │  │  │
│  │  │           │ │ Router   │ │ (Returns, Risk)  │  │  │
│  │  └──────────┘ └────┬─────┘ └──────────────────┘  │  │
│  │                   │                               │  │
│  │  ┌────────────────▼──────────────────────────┐   │  │
│  │  │   UIAutomation2 + ADB                      │   │  │
│  │  │   自动操控 Android 基金 App                │   │  │
│  │  └───────────────────────────────────────────┘   │  │
│  │                                                   │  │
│  │  ┌───────────────────────────────────────────┐   │  │
│  │  │   SQLite (本地存储)                        │   │  │
│  │  └───────────────────────────────────────────┘   │  │
│  └───────────────────────────────────────────────────┘  │
└─────────────────────────────────────────────────────────┘
```

## 🚀 快速开始

### 环境要求

- **Python** 3.10+
- **Node.js** 18+
- **Android 手机**（开启 USB 调试，可选 — 无设备时使用模拟数据）

### 一键启动 (Windows)

```bash
# 双击运行
start.bat
```

### 一键启动 (macOS/Linux)

```bash
chmod +x start.sh
./start.sh
```

### 手动启动

**1. 启动后端**

```bash
cd backend
pip install -r requirements.txt
python run.py
```

**2. 启动前端**

```bash
cd desktop
npm install
npm run dev
```

浏览器打开 `http://localhost:5173` 即可使用。

### UIAutomation2 环境配置（可选）

如需从真实手机导入持仓：

1. 手机开启 **开发者选项** → **USB 调试**
2. USB 连接电脑，确认 `adb devices` 能识别设备
3. 安装依赖：`pip install uiautomator2 adbutils`
4. 在应用内点击 **导入** → 选择基金 App → 自动导入

> ⚠️ 无设备时，导入功能将使用模拟数据演示原型效果

## 📁 项目结构

```
aura-link-analytics/
├── backend/                    # Python FastAPI 后端
│   ├── app/
│   │   ├── main.py            # FastAPI 入口
│   │   ├── config.py          # 配置
│   │   ├── models/
│   │   │   └── database.py    # SQLAlchemy 数据模型
│   │   ├── schemas/
│   │   │   └── funds.py       # Pydantic 响应模型
│   │   ├── routers/
│   │   │   ├── funds.py       # 持仓 CRUD API
│   │   │   ├── import_router.py  # 导入 API
│   │   │   └── analysis.py    # 分析 API
│   │   └── services/
│   │       ├── uiautomation/
│   │       │   ├── device_manager.py   # ADB 设备管理
│   │       │   └── fund_importer.py    # 基金 App 自动化导入
│   │       ├── fund_analysis.py        # 收益率/风险指标计算
│   │       └── data_manager.py         # 数据 CRUD
│   ├── requirements.txt
│   └── run.py
├── desktop/                    # Electron + React 前端
│   ├── src/
│   │   ├── main/index.ts      # Electron 主进程
│   │   ├── preload/index.ts   # 预加载脚本
│   │   └── renderer/
│   │       ├── App.tsx        # 应用根组件
│   │       ├── components/     # 通用组件
│   │       ├── pages/          # 页面组件
│   │       ├── hooks/          # Zustand 状态管理
│   │       ├── utils/          # 工具函数
│   │       └── types/          # TypeScript 类型
│   ├── package.json
│   └── vite.config.ts
├── start.bat                  # Windows 一键启动
├── start.sh                   # macOS/Linux 一键启动
└── README.md
```

## 🔌 API 文档

启动后端后访问 `http://127.0.0.1:18888/docs` 查看 Swagger API 文档。

### 主要接口

| 方法 | 路径 | 说明 |
|------|------|------|
| GET | `/api/funds/portfolio/summary` | 获取持仓总览 |
| GET | `/api/funds/positions` | 获取所有持仓 |
| POST | `/api/funds/positions` | 添加持仓 |
| DELETE | `/api/funds/positions/{id}` | 删除持仓 |
| GET | `/api/import/apps` | 获取支持的导入来源 |
| GET | `/api/import/devices` | 获取已连接设备 |
| POST | `/api/import/start` | 开始导入持仓 |
| GET | `/api/analysis/fund/{id}` | 获取基金分析数据 |
| GET | `/api/analysis/allocation` | 获取持仓分布 |

## 📱 支持的基金 App

| App | 包名 | 状态 |
|-----|------|------|
| 天天基金 | com.tiantian.fund | ✅ 已适配 |
| 支付宝-基金 | com.eg.android.AlipayGphone | ✅ 已适配 |
| 微信-理财通 | com.tencent.mm | ⚠️ 基础适配 |

## 🛣️ 后续规划

- [ ] 接入基金实时净值 API（天天基金/新浪财经）
- [ ] 基金对比功能（多基金横向比较）
- [ ] 定投收益模拟器
- [ ] 持仓预警通知（涨跌幅阈值提醒）
- [ ] 导出 PDF 分析报告
- [ ] 更多基金 App 适配（蛋卷基金、且慢等）

## 📝 License

MIT License