skdbj/stock-monitor

Fork 0

zyj118 f1422c84af docs: 添加API获取说明

2025-01-13 20:15:31 +08:00

5.9 KiB

Raw Blame History

价值投资盯盘系统

一个专注于中国 A 股市场的智能股票分析与监控平台，基于 Python FastAPI 开发，集成实时行情监控、AI 智能分析和价值投资建议等功能，助力投资者进行理性的价值投资决策。

功能特点

1. A股实时监控

支持所有 A 股上市公司的实时监控
沪深两市实时价格和涨跌幅更新
自定义市值目标区间预警
个股交易状态实时提示

2. AI 智能分析

基于中国市场特点的智能投资建议
A股市场合理价格区间估算
结合中国经济环境的目标市值评估
多维度分析报告：
- A股市场估值分析
- 中国特色财务健康状况评估
- 行业对标成长潜力评估
- 系统性风险评估

3. A股财务指标分析

估值指标：PE（市盈率）、PB（市净率）、PS（市销率）等
盈利能力：ROE（净资产收益率）、毛利率、净利率
成长能力：营收增长、利润增长、研发投入
运营效率：资产周转率、存货周转率等
偿债能力：资产负债率、流动比率等
现金流指标：经营现金流、自由现金流等

4. 中国市场行情

上证指数、深证成指、创业板指等主要指数实时行情
专业K线图技术分析
A股市场涨跌分布分析
行业板块轮动分析

5. 上市公司详情

工商登记信息
十大股东持股变动
A股特色财务报表分析
公司公告与重大事项
行业地位分析

技术架构

后端技术栈

Web框架：FastAPI
数据处理：Pandas
A股数据源：Tushare API（提供专业的 A 股数据）
服务器：Uvicorn
数据存储：JSON文件

前端技术栈

框架：Bootstrap 5
图表：ECharts
交互：JavaScript
样式：CSS3

主要模块

项目结构
├── app/
│   ├── __init__.py
│   ├── api/
│   │   └── stock_routes.py    # API路由
│   ├── models/
│   │   └── stock.py          # 数据模型
│   ├── services/
│   │   ├── stock_service.py  # 股票服务
│   │   └── ai_analysis_service.py  # AI分析服务
│   ├── templates/
│   │   ├── index.html       # 主页面
│   │   └── market.html      # 市场页面
│   └── config.py            # 配置文件
├── run.py                   # 启动文件
└── requirements.txt         # 依赖包

安装部署

环境要求

Python 3.8+
pip 包管理器
网络连接（访问 Tushare API）

安装步骤

克隆项目

git clone https://github.com/693696817/stock-monitor.git
cd stock-monitor

创建虚拟环境（推荐）

python -m venv venv
source venv/bin/activate  # Linux/Mac
venv\Scripts\activate     # Windows

安装依赖

pip install -r requirements.txt

配置

复制 config.json.example 为 config.json
在 config.json 中配置你的 Tushare Token

{
    "watchlist": {},
    "tushare_token": "your_tushare_token_here"
}

运行

python run.py

访问

打开浏览器访问 http://localhost:8000
默认端口为 8000，可在 run.py 中修改

使用指南

添加监控股票

在主页面顶部输入 A 股股票代码（6位数字，如：000001）
可选择设置目标市值区间
点击"添加"按钮开始监控

查看股票详情

点击股票名称进入详情页
查看完整的 A 股特色财务指标
获取针对中国市场的 AI 投资建议

指数行情

实时展示沪深主要指数行情
提供大盘趋势分析
行业板块表现对比

数据更新频率

A股交易时段（9:30-11:30, 13:00-15:00）实时更新
盘后自动更新财务数据
可手动强制刷新最新数据

开发指南

代码规范

遵循 PEP 8 编码规范
使用类型注解
保持代码简洁清晰

目录结构说明

api/: API路由和接口定义
models/: 数据模型和结构定义
services/: 业务逻辑和服务实现
templates/: 前端页面模板

扩展开发

添加新的数据源
- 在 services 中添加新的服务类
- 实现数据获取和处理方法
扩展AI分析
- 修改 ai_analysis_service.py
- 添加新的分析维度和方法
自定义UI
- 修改 templates 中的HTML文件
- 更新样式和交互逻辑

维护说明

数据更新

A股交易时段实时行情更新
每日收盘后自动更新财务数据
定期同步公司公告信息
可配置更新频率

错误处理

完善的错误提示
异常捕获和处理
日志记录

贡献指南

欢迎提交 Issue 和 Pull Request：

Fork 本仓库
创建特性分支
提交变更
发起 Pull Request

许可证

MIT License

联系方式

作者：ZYJ
邮箱：693696817@qq.com

更新日志

v1.0.0 (2024-03)

支持全部 A 股上市公司监控
实现核心功能：实时行情、AI 分析、财务分析
完成基础框架搭建
优化 A 股特色分析逻辑

配置说明

在运行系统之前，需要配置以下API密钥：

Tushare API Token
- 访问 Tushare官网
- 注册并登录账号
- 在个人中心获取Token
- 将Token填入 config.json 的 tushare_token 字段
AI分析服务 API Key
- 访问 Volcengine智能对话
- 注册企业账号并开通服务
- 在控制台获取API Key和模型ID
- 将API Key填入 config.json 的 ai_api_key 字段
- 将模型ID填入 config.json 的 ai_model_id 字段

配置文件示例 (config.json):

{
    "watchlist": {},
    "tushare_token": "your_tushare_token_here",
    "ai_api_key": "your_ai_api_key_here",
    "ai_model_id": "your_ai_model_id_here"
}

注意：请妥善保管你的API密钥，不要将其提交到代码仓库中。

5.9 KiB Raw Blame History Unescape Escape