# A股分析推荐 Agent

基于资金驱动的四层漏斗模型，盘中实时分析推荐 A 股。支持趋势突破/缩量回踩/启动型三种策略，结合 LLM (DeepSeek) 生成个股分析。

## 技术栈

- **Backend**: Python 3.10+ / FastAPI / SQLAlchemy / Tushare / APScheduler
- **Frontend**: Next.js 14 / React 18 / TypeScript / Tailwind CSS / ECharts
- **Database**: SQLite (aiosqlite)
- **LLM**: DeepSeek API（可选，用于 AI 分析）

## 前置条件

- Python 3.10+
- Node.js 18+
- [Tushare Pro](https://tushare.pro/) Token（用于获取 A 股行情数据）
- DeepSeek API Key（可选，不配置则跳过 AI 分析功能）

## 快速开始

### 1. 克隆项目

```bash
git clone <repo-url>
cd astock-agent
```

### 2. 启动 Backend

```bash
cd backend

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate

# 安装依赖
pip install -r requirements.txt

# 配置环境变量
cp .env.example .env
```

编辑 `backend/.env`，填入你的 Token：

```env
ASTOCK_TUSHARE_TOKEN=你的Tushare Token
ASTOCK_DEBUG=true

# 可选：配置后启用 AI 分析功能
ASTOCK_DEEPSEEK_API_KEY=你的DeepSeek API Key
```

启动服务：

```bash
uvicorn app.main:app --host 0.0.0.0 --port 8000 --reload
```

首次启动会自动创建 SQLite 数据库和默认管理员账户：
- 用户名：`admin`
- 密码：`admin123`

### 3. 启动 Frontend

```bash
cd frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

前端默认运行在 `http://localhost:3002`，通过 Next.js rewrites 代理 API 请求到后端 `localhost:8000`。

### 4. 访问

浏览器打开 http://localhost:3002 ，使用默认管理员账户登录。

## 环境变量说明

| 变量 | 必填 | 默认值 | 说明 |
|------|------|--------|------|
| `ASTOCK_TUSHARE_TOKEN` | 是 | - | Tushare Pro 数据接口 Token |
| `ASTOCK_DEBUG` | 否 | `false` | 开启调试日志 |
| `ASTOCK_DEEPSEEK_API_KEY` | 否 | - | DeepSeek API Key，配置后启用 AI 分析 |
| `ASTOCK_DEEPSEEK_BASE_URL` | 否 | `https://api.deepseek.com/v1` | DeepSeek API 地址 |
| `ASTOCK_FRONTEND_URL` | 否 | `http://localhost:3002` | 前端地址（CORS 白名单） |
| `ASTOCK_JWT_SECRET` | 否 | `change-me-in-production` | JWT 签名密钥，生产环境务必修改 |
| `ASTOCK_ADMIN_USERNAME` | 否 | `admin` | 默认管理员用户名 |
| `ASTOCK_ADMIN_PASSWORD` | 否 | `admin123` | 默认管理员密码 |

完整配置项见 `backend/app/config.py`。

## 项目结构

```
astock-agent/
├── backend/
│   ├── app/
│   │   ├── main.py              # FastAPI 入口
│   │   ├── config.py            # 配置管理
│   │   ├── api/                 # API 路由（行情、板块、推荐、个股、聊天、认证）
│   │   ├── analysis/            # 分析引擎（信号检测、板块扫描、选股）
│   │   ├── core/                # 认证、缓存等核心模块
│   │   ├── data/                # 数据层（Tushare、腾讯行情客户端）
│   │   ├── db/                  # 数据库表定义与初始化
│   │   ├── engine/              # 调度器（定时扫描任务）
│   │   └── llm/                 # LLM 集成（DeepSeek）
│   ├── requirements.txt
│   ├── .env.example
│   └── Dockerfile
├── frontend/
│   ├── src/
│   │   ├── app/                 # Next.js 页面（总览、推荐、板块、个股、对话）
│   │   ├── components/          # 组件（图表、卡片、导航等）
│   │   ├── hooks/               # 自定义 Hooks
│   │   └── lib/                 # 工具函数、API 客户端
│   ├── tailwind.config.ts
│   ├── next.config.js
│   └── package.json
└── .gitignore
```

## 构建生产版本

```bash
# Backend
cd backend
pip install -r requirements.txt
uvicorn app.main:app --host 0.0.0.0 --port 8000

# Frontend
cd frontend
npm run build
npm run start
```

## 注意事项

- 首次启动后，系统会在 A 股交易时段（9:30-11:30, 13:00-15:00）自动执行扫描任务
- 也可以在推荐列表页手动点击「立即扫描」触发
- 数据库为 SQLite，数据文件 `astock.db` 自动生成在 `backend/` 目录下
- Tushare API 有请求频率限制，请勿过于频繁地手动触发扫描