中国股票分析报告生成器

基于LangChain和OpenAI兼容API的智能股票分析工具，能够接收中国股票名称或代码，生成专业的PDF格式分析报告。

功能特点

• 🚀 智能分析: 基于大语言模型的深度股票分析
• 📊 全面报告: 涵盖公司概况、财务分析、市场表现、行业地位等
• 🌐 实时数据: 利用联网搜索获取最新市场信息
• 📄 PDF输出: 生成专业格式的PDF分析报告，完美支持中文显示
• 🔧 灵活配置: 支持多种OpenAI兼容API提供商
• 🌍 跨平台: 支持Windows、macOS、Linux，自动适配系统中文字体

快速开始

1. 环境准备

确保已安装：

• Python 3.11+
• uv (Python包管理工具)

2. 项目设置

# 克隆项目
git clone <项目地址>
cd stock_helper

# 安装依赖
uv sync

# 配置环境变量
cp .env.example .env
# 编辑.env文件，填入你的API配置

3. 配置API

编辑 .env 文件：

# OpenAI兼容API配置
OPENAI_API_KEY=your_api_key_here
OPENAI_BASE_URL=https://api.openai.com/v1
OPENAI_MODEL=gpt-3.5-turbo

4. 运行分析

方法一：使用启动脚本（推荐）

./start.sh

方法二：命令行直接运行

# 基本用法 - PDF保存到output目录
uv run python src/stock_helper/main.py "概伦电子"

# 使用股票代码
uv run python src/stock_helper/main.py "688038"

# 指定输出路径
uv run python src/stock_helper/main.py "贵州茅台" -o "/path/to/report.pdf"

项目结构

stock_helper/
├── src/stock_helper/          # 核心源码
│   ├── __init__.py           # 包初始化
│   ├── main.py               # 主程序入口
│   ├── config.py             # 配置管理
│   ├── analyzer.py           # 股票分析核心逻辑
│   └── report_generator.py   # PDF报告生成
├── output/                   # PDF报告输出目录（被git忽略）
├── .env.example              # 环境变量模板
├── start.sh                  # 快速启动脚本
├── stock_analyzer.py         # 便利脚本
├── pyproject.toml           # 项目配置
├── .gitignore               # Git忽略文件
└── README.md                # 使用说明

输出目录

所有生成的PDF报告默认保存在 output/ 目录中：

• 文件名格式：{股票名称}_股票分析报告.pdf
• 可通过 -o 参数自定义输出路径
• output/ 目录已配置在 .gitignore 中，不会被Git跟踪

支持的股票

中国A股

• 上海主板 (600xxx, 601xxx, 603xxx, 605xxx)
• 科创板 (688xxx)
• 深圳主板 (000xxx, 001xxx)
• 创业板 (300xxx)

港股

• 港交所股票 (xxxx.HK)

API提供商支持

提供商	BASE_URL	MODEL
OpenAI	https://api.openai.com/v1	gpt-3.5-turbo, gpt-4
DeepSeek	https://api.deepseek.com/v1	deepseek-chat
阿里云通义千问	https://dashscope.aliyuncs.com/compatible-mode/v1	qwen-plus
智谱GLM	https://open.bigmodel.cn/api/paas/v4	glm-4

常见问题

Q: 程序运行时提示"无法找到股票信息"怎么办？

A:

1. 检查股票代码或名称是否正确
2. 尝试使用标准股票代码（如688038）而非中文名称
3. 确认网络连接正常

Q: API调用失败怎么办？

A:

1. 检查.env文件中的API Key是否正确
2. 确认Base URL和Model配置正确
3. 检查API服务商的调用额度是否充足

Q: 生成的PDF报告在哪里？

A: 默认在output/目录生成，文件名格式为{股票名称}_股票分析报告.pdf。可以通过-o参数指定输出路径。

Q: 如何查看已生成的报告？

A:

# 查看output目录中的所有PDF
ls -la output/*.pdf

# 查看最新生成的报告
ls -lt output/*.pdf | head -5

Q: PDF中的中文显示乱码怎么办？

A: 程序已完全解决中文字体显示问题，包括表格内外所有中文内容：

Windows系统支持字体:

• 微软雅黑 (msyh.ttc) - 推荐
• 黑体 (simhei.ttf)
• 宋体 (simsun.ttc)
• 楷体 (simkai.ttf)
• 仿宋 (simfang.ttf)

macOS系统支持字体:

• PingFang SC - 推荐
• STHeiti (华文黑体)
• STSong (华文宋体)

Linux系统支持字体:

• WenQuanYi Zen Hei (文泉驿正黑) - 推荐
• WenQuanYi Micro Hei (文泉驿微米黑)
• Noto Sans CJK
• AR PL UMing/UKai

修复内容:

• ✅ 表格外部中文正常显示
• ✅ 表格内部中文完美显示
• ✅ 股票名称、财务数据正确显示
• ✅ 跨平台自动字体适配

如果系统没有中文字体，程序会尝试自动下载开源字体。

注意事项

⚠️ 投资风险提醒

• 本报告仅供参考，不构成实际投资决策依据
• 股票投资存在风险，市场有波动，投资需谨慎
• 投资者应根据自身风险承受能力独立做出投资决策

📊 数据说明

• 股票数据来源于公开信息，可能存在滞后性
• 分析结果基于AI模型，不保证100%准确性
• 建议结合多方信息进行投资判断

🔒 安全提醒

• 请妥善保管API密钥，不要在代码中硬编码
• 建议定期更新API密钥以确保安全
• 遵守相关API服务商的使用条款

开发信息

版本历史

• v0.1.0: 初始版本发布
  • 基本股票分析功能
  • PDF报告生成到output目录
  • 多API提供商支持

开源协议

本项目采用 MIT 协议开源。

---

🚀 开始你的智能股票分析之旅吧！

重要提醒: 本工具生成的分析报告仅供参考，不构成投资建议。投资有风险，入市需谨慎！