# ai_stock

**Repository Path**: rajan_admin/ai_stock

## Basic Information

- **Project Name**: ai_stock
- **Description**: Python分析股票数据
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 1
- **Created**: 2025-10-16
- **Last Updated**: 2025-11-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AI 股票分析工具

一个功能完备的股票分析系统，支持基本面分析、技术面分析、可视化报告和多股票比较。

## 功能特性

- **多市场支持**：支持美股、A股等多个股票市场的数据获取和分析
- **基本面分析**：获取公司财务数据、财务指标、股东信息等
- **技术面分析**：提供多种技术指标计算（RSI、MACD、布林带等）
- **可视化报告**：生成价格走势图、指标图表、财务分析报告
- **批量分析**：支持多只股票同时分析和比较
- **数据缓存**：自动缓存已获取的数据，减少重复请求
- **API限流处理**：内置重试机制，智能处理API限流情况

## 安装说明

### 环境要求

- Python 3.7 或更高版本
- 依赖包：见 requirements.txt

### 安装步骤

1. 克隆或下载项目到本地
```bash
git clone <repository-url>
cd ai_stock
```

2. 安装依赖包
```bash
pip install -r requirements.txt
```

3. 确保目录结构完整（程序会自动创建必要的目录）

## 使用方法

### 基本使用

运行主程序启动交互式分析界面：
```bash
python main.py
```

在交互式界面中，您可以选择以下操作：
1. 分析单个股票
2. 批量分析多只股票
3. 从文件导入股票代码并分析
4. 查看系统配置
5. 退出

### 分析单个股票

1. 选择选项 1
2. 输入股票代码（例如：AAPL 或 600519）
3. 选择时间周期（1天到10年或全部历史）
4. 选择是否保存图表

### 批量分析

1. 选择选项 2
2. 输入多只股票代码，用逗号分隔
3. 选择时间周期和是否保存图表

### 从文件导入

1. 准备一个包含股票代码的文本文件，每行一个股票代码
2. 选择选项 3
3. 输入文件路径
4. 选择时间周期和是否保存图表

## 项目结构

```
ai_stock/
├── data/                  # 数据存储目录
├── data_ingestion/        # 数据获取模块
│   └── data_fetcher.py    # 股票数据获取器
├── fundamental_analysis/  # 基本面分析模块
│   └── fundamental_analyzer.py  # 基本面分析器
├── technical_analysis/    # 技术面分析模块
│   └── technical_analyzer.py    # 技术指标计算器
├── visualization/         # 可视化模块
│   └── stock_visualizer.py      # 图表生成器
├── utils/                 # 工具函数
│   ├── config.py          # 配置文件
│   ├── helpers.py         # 辅助函数
│   └── report_template.html     # HTML报告模板
├── logs/                  # 日志目录
├── reports/               # 报告输出目录
├── visualizations/        # 可视化输出目录
├── main.py                # 主程序入口
└── requirements.txt       # 依赖列表
```

## 依赖说明

- **yfinance**：获取美股数据
- **akshare**：获取A股数据
- **pandas**：数据处理
- **numpy**：数值计算
- **matplotlib**：图表绘制
- **tqdm**：进度条显示

## 注意事项

1. **API限流**：程序使用了第三方API获取数据，可能会遇到限流情况。程序内置了重试机制，会在遇到限流时自动等待并重试。

2. **数据准确性**：程序获取的数据仅供参考，投资决策请结合多方面信息。

3. **缓存机制**：程序会缓存已获取的数据，以减少API请求次数。如需获取最新数据，请删除对应的数据文件。

4. **文件路径**：所有文件路径均为相对路径，请勿移动程序文件位置。

## 故障排除

### 常见错误

1. **API限流错误**：等待一段时间后重试，或减少单次请求的股票数量

2. **数据获取失败**：检查股票代码是否正确，或尝试不同的时间周期

3. **文件权限错误**：确保程序对数据和输出目录有写入权限

### 日志查看

程序运行日志保存在 `logs/stock_analysis.log` 文件中，可用于排查错误。

## 更新日志

### v1.0.0
- 初始版本发布
- 支持基本的股票数据获取、分析和可视化
- 添加API限流重试机制

## 许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。

## 贡献指南

欢迎提交Issue和Pull Request来改进本项目。

## 联系方式

如有问题或建议，请通过以下方式联系：
- Email: [your-email@example.com]
- GitHub: [your-github-username]