stock-ai-agent/docs/USER_GUIDE.md

# 用户使用手册

欢迎使用A股AI分析Agent系统！本手册将帮助您快速上手。

## 目录

1. [系统介绍](#系统介绍)
2. [快速开始](#快速开始)
3. [功能使用](#功能使用)
4. [常见问题](#常见问题)
5. [技巧和建议](#技巧和建议)

## 系统介绍

A股AI分析Agent系统是一个智能股票分析助手，通过自然语言对话方式，帮助您：

- 查询股票实时行情
- 分析技术指标
- 查看K线图表
- 了解公司基本信息

### 核心特性

- **自然对话**：像聊天一样查询股票信息
- **智能理解**：自动识别股票代码和查询意图
- **实时数据**：获取最新的市场数据
- **专业图表**：生成专业的K线图和技术指标图
- **历史记录**：保存对话历史，方便回顾

## 快速开始

### 1. 访问系统

打开浏览器，访问：http://localhost:8000

### 2. 界面介绍

系统界面分为三个主要区域：

```
┌─────────────────────────────────────────────┐
│  📈 A股AI分析Agent        [技能管理]        │
├─────────────────────────────────────────────┤
│                                             │
│  消息显示区域                                │
│  - 显示对话历史                              │
│  - 展示图表和数据                            │
│                                             │
├─────────────────────────────────────────────┤
│  [输入框]                          [发送]    │
└─────────────────────────────────────────────┘
```

### 3. 第一次查询

在输入框中输入：

```
查询600519的实时行情
```

按回车或点击"发送"按钮，系统会返回贵州茅台的实时行情数据。

## 功能使用

### 1. 查询实时行情

**支持的查询方式**：

```
查询600519的实时行情
贵州茅台的价格
000001现在多少钱
中国平安的行情
```

**返回信息**：
- 股票名称和代码
- 最新价格
- 涨跌额和涨跌幅
- 开盘价、最高价、最低价
- 成交量和成交额

**示例**：

```
输入：查询600519的实时行情

输出：
【贵州茅台】(600519.SH)
交易日期：20240201
最新价：1650.00
涨跌额：15.50
涨跌幅：0.95%
开盘价：1640.00
最高价：1655.00
最低价：1638.00
成交量：125000手
成交额：206250千元
```

### 2. 查看K线图

**支持的查询方式**：

```
600519的K线图
贵州茅台的走势
000001的图表
```

**功能特点**：
- 显示最近60个交易日的K线
- 包含成交量柱状图
- 支持缩放和拖动
- 红色表示上涨，绿色表示下跌

**操作技巧**：
- 鼠标滚轮：缩放图表
- 鼠标拖动：移动时间轴
- 双击：重置视图

### 3. 技术指标分析

**支持的查询方式**：

```
600519的技术指标
分析贵州茅台的MACD
000001的RSI
```

**支持的指标**：

1. **均线（MA）**
   - MA5：5日均线
   - MA10：10日均线
   - MA20：20日均线
   - MA60：60日均线

2. **MACD**
   - DIF：快线
   - DEA：慢线
   - MACD：柱状图

3. **RSI（相对强弱指标）**
   - RSI6：6日RSI
   - RSI12：12日RSI
   - RSI24：24日RSI

4. **KDJ**
   - K值
   - D值
   - J值

5. **布林带（BOLL）**
   - 上轨
   - 中轨
   - 下轨

**示例**：

```
输入：600519的技术指标

输出：
【600519.SH】技术指标：
均线：MA5=1645.20, MA10=1638.50, MA20=1625.30
MACD：DIF=12.50, DEA=10.20, MACD=4.60
RSI：RSI6=65.20, RSI12=58.30, RSI24=52.10
```

### 4. 基本面信息

**支持的查询方式**：

```
600519的基本信息
贵州茅台是什么行业
000001的公司信息
```

**返回信息**：
- 股票代码和名称
- 所属地域
- 所属行业
- 上市市场
- 上市日期

**示例**：

```
输入：600519的基本信息

输出：
【贵州茅台】基本信息
股票代码：600519.SH
所属地域：贵州
所属行业：白酒
上市市场：主板
上市日期：20010827
```

### 5. 技能管理

点击右上角"技能管理"按钮，可以：

- **查看所有技能**：显示系统支持的所有分析技能
- **启用/禁用技能**：通过开关控制技能的启用状态
- **查看技能说明**：了解每个技能的功能

**可用技能**：

1. **market_data**：行情查询技能
2. **technical_analysis**：技术分析技能
3. **fundamental**：基本面分析技能
4. **visualization**：数据可视化技能

## 常见问题

### Q1: 如何输入股票代码？

**A**: 支持多种格式：

- 6位数字：`600519`、`000001`
- 带后缀：`600519.SH`、`000001.SZ`
- 股票名称：`贵州茅台`、`中国平安`

### Q2: 为什么查询失败？

**可能原因**：

1. **股票代码错误**
   - 检查代码是否正确
   - 确认是A股代码

2. **数据源问题**
   - Tushare API可能暂时不可用
   - 检查网络连接

3. **非交易时间**
   - 某些数据仅在交易时间更新

### Q3: 数据更新频率？

- **实时行情**：缓存30秒
- **K线数据**：缓存1小时
- **基本面信息**：缓存1天

### Q4: 如何清除对话历史？

目前系统会自动保存对话历史。如需清除，可以：

1. 刷新页面（会生成新的会话ID）
2. 联系管理员清理数据库

### Q5: 支持哪些股票市场？

当前版本支持：
- 上海证券交易所（沪市）
- 深圳证券交易所（深市）
- 科创板

未来将支持：
- 港股
- 美股

## 技巧和建议

### 查询技巧

1. **明确查询意图**
   ```
   好：查询600519的实时行情
   差：600519
   ```

2. **使用完整股票代码**
   ```
   好：600519
   差：6005（不完整）
   ```

3. **一次查询一个股票**
   ```
   好：查询600519的行情
   差：查询600519和000001的行情（暂不支持）
   ```

### 分析建议

1. **结合多个指标**
   - 先查看K线图，了解整体趋势
   - 再查看技术指标，确认信号
   - 最后查看基本面，评估价值

2. **关注关键指标**
   - 均线：判断趋势方向
   - MACD：捕捉买卖信号
   - RSI：识别超买超卖
   - 成交量：确认趋势强度

3. **定期跟踪**
   - 建立自选股列表
   - 定期查询关注的股票
   - 记录重要的分析结果

### 使用限制

1. **API调用限制**
   - Tushare免费版：120次/分钟
   - 建议合理安排查询频率

2. **数据准确性**
   - 数据来源于Tushare
   - 仅供参考，不构成投资建议

3. **系统性能**
   - 首次查询可能较慢（需要获取数据）
   - 后续查询会使用缓存，速度更快

## 投资风险提示

⚠️ **重要提示**：

1. 本系统提供的数据和分析仅供参考
2. 不构成任何投资建议
3. 股市有风险，投资需谨慎
4. 请根据自身情况做出投资决策
5. 建议咨询专业投资顾问

## 反馈和支持

如有问题或建议，请：

1. 查看[README.md](../README.md)
2. 查看[部署文档](DEPLOYMENT.md)
3. 提交Issue到项目仓库
4. 联系技术支持

---

感谢使用A股AI分析Agent系统！祝您投资顺利！