# stock-analysis

**Repository Path**: hejun-fork/stock-analysis

## Basic Information

- **Project Name**: stock-analysis
- **Description**: 股票分析skill
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-06-04
- **Last Updated**: 2026-06-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 📊 一句话搞定个股分析

> **说一句话，得一份专业研报。** 基本面 + 技术面 + 资金面，全自动 AI 驱动。
>
> 用户只需说"分析 XXX" → 30+ 数据源采集 → Step 0-8 基本面 + 第 9 章技术面 → 交互式 HTML 报告

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Python 3.8+](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![akshare](https://img.shields.io/badge/data-akshare-green.svg)](https://github.com/akfamily/akshare)
[![ECharts](https://img.shields.io/badge/chart-ECharts-red.svg)](https://echarts.apache.org/)

---

## 🎯 一句话

**说"分析 600519"，等 60 分钟，得到一份比券商研报更结构化的交互式 HTML 报告。**

---

## 📸 效果预览

> 👉 **[点击查看完整示例报告](examples/个股研究-中国长城.html)**（000066.SZ · 深色/浅色双主题 · 可下载后在浏览器打开）

![深色模式截图](docs/images/dark-mode.webp)

<p align="center"><em>▲ 深色模式：结论置顶 + Hero行情卡片 + K线图 + 第9章技术面图表（MACD/KDJ/RSI/BOLL）</em></p>

**报告亮点：**
- 🏷️ **结论先行** — 核心判断 + 5 项交易参数（买入区间/止损/目标/仓位/盈亏比）置顶
- 📈 **ECharts 交互式 K 线** — markLine 技术标注（压力/支撑/均线/止损）+ markPoint 价位标记
- 🎨 **产业链 SVG 图谱** — 上游→中游→下游，核心企业一目了然
- 📊 **4 技术指标图表** — MACD / KDJ / RSI / BOLL 完整时间序列，JS 实时计算
- 🌓 **浅色/深色双主题** — CSS 变量驱动，一键切换，全部组件完美适配

---

## 🏗️ 三层架构

```
用户说"分析 XXX股票"
        │
┌───────▼──────────┐
│  Phase 1: 数据采集  │  Python 脚本 · 3-5 分钟
│  30+ akshare 接口   │  → data_{代码}.json
└───────┬──────────┘
        │
┌───────▼──────────┐
│  Phase 2: AI 分析  │  AI 逐步执行 · 30-60 分钟
│  Step 0-8 + MCP搜索 │  → 个股研究-{名称}.md
└───────┬──────────┘
        │
┌───────▼──────────┐
│  Phase 3: HTML 生成 │  AI 分批手写 · 20-30 分钟
│  模板搬运 + 数据注入  │  → 个股研究-{名称}.html
└───────┬──────────┘
        │
   ✅ 完成！打开 HTML 即可交付
```

---

## ✨ 功能清单

### 数据采集（Phase 1）

| 类别 | 数据内容 | 来源 |
|------|---------|------|
| 实时行情 | 最新价、涨跌幅、成交量、换手率 | 新浪财经 |
| 历史K线 | 3年日K线（前复权）、近5日1分钟分时 | 新浪财经 |
| 技术指标 | MACD/KDJ/RSI/BOLL/MA5/10/20/60 | Python 本地计算 |
| 财务数据 | 三大报表、财务摘要、关键指标（杜邦分析） | 同花顺 / 新浪 |
| 股东结构 | 十大股东、十大流通股东、股东户数变动 | 东方财富 |
| 主营业务 | 按行业/产品/地区分类构成、毛利率 | 东方财富 |
| 资金动向 | 个股资金流向、龙虎榜、融资融券 | 东方财富 / 交易所 |
| 机构观点 | 券商研报、机构评级、盈利预测、基金持仓 | 东方财富 |
| 公告新闻 | 当日公告、个股新闻、业绩预告/快报 | 东方财富 |
| 高管变动 | 董监高持股变动 | 深交所/上交所 |

### 基本面分析（Phase 2 · Step 0-8）

| Step | 主题 | 产出 |
|------|------|------|
| 0 | 任务锁定 | 标的/周期/风格/核心命题 |
| 1 | 宏观与周期定位 | 经济周期映射 + 政策扫描 + 核心矛盾提炼 |
| 2 | 产业链深度拆解 | SVG 图谱 + 趋势三要素 + 价值链利润分布 |
| 3 | 公司筛选与质量评分 | 正面清单/负面排查 + 6维100分制评分 |
| 4 | 业绩弹性测算 | 弹性树 + 敏感度公式 + 悲观/基准/乐观情景 |
| 5 | 风险分析 | 风险矩阵 + 5个强制止损信号 |
| 6 | 估值与买卖时机 | 多方法估值 + 三档目标价 + 盈亏比量化 |
| 7 | 对标分析 | 同类对比 + 增长引擎切换路径 |
| 8 | 跟踪计划与综合结论 | 催化剂追踪表 + 五维评分 + 执行清单 |

### 第9章：技术面与资金面分析（Phase 2 & 3）

| 节 | 内容 |
|----|------|
| 9.1 信号速览 | MACD/KDJ/RSI/BOLL/均线/成交量 6 卡片 |
| 9.2 技术图表 | 4 × ECharts 交互式图表（MACD/KDJ/RSI/BOLL） |
| 9.3 多周期趋势 | 月线/周线/日线三列分析 + 信号标签 |
| 9.4 位置与形态 | 关键技术位表 + 形态识别表 |
| 9.5 动量与量价 | 多周期动量 + 量价配合分析 + 预警信号 |
| 9.6 资金面 | 主力资金/北向资金/龙虎榜 |
| 9.7 市场风格 | 板块轮动 TOP5 + 风格判断 + 对本股影响 |
| 9.8 综合研判 | 技术面 5 维评分 + 操作计划表 |

---

## 🔄 增量更新

已生成的报告无需重新分析，支持一键更新行情数据：

```bash
python update_stock_report.py 000066
```

| 步骤 | 更新内容 | 执行方 |
|------|---------|--------|
| K 线数据 | 拉取最新 120 条日 K，替换 rawData 数组 | 脚本自动 |
| Hero 行情 | 最新价、涨跌幅实时更新 | 脚本自动 |
| 技术指标 | 重新计算 MACD/KDJ/RSI/BOLL | 脚本自动 |
| 近期动态 | 替换为当日最新 8 条新闻 + 利好/利空标签 | AI 手动 |
| 催化剂追踪 | 检查兑现状态、追加新催化剂 | AI 手动 |
| 事件记录 | 追加更新日志、同步三处分析基准日 | AI 手动 |

**生成两个文件：** 带日期版本（保留历史）+ 最新版本（覆盖），便于回溯对比。

---

## 📁 项目结构

```
stock-analysis/
├── SKILL.md                          # Skill 完整定义（v3.1）
├── stock_full_report.py              # Phase 1：30+ akshare 接口数据采集
├── update_stock_report.py            # 增量更新：K线/Hero/技术指标自动刷新
├── technical_indicators.py           # 技术指标计算（MACD/KDJ/RSI/BOLL/MA）
├── requirements.txt
├── shared/
│   ├── template_base.css             # CSS 模板（双主题 + 响应式）
│   └── template_base.js              # JS 模板（OHLC转换 + 6图表渲染）
├── examples/
│   ├── 个股研究-中国长城.html         # 参考范例（全功能演示）
│   └── data_000066.json               # 范例数据
├── docs/
│   └── images/dark-mode.webp          # 效果截图
├── HTML手写参考.md                   # Phase 3 分批校验规范
├── HTML报告设计规范v1.0.md           # CSS 设计系统文档
├── 分析框架.md                       # Step 0-8 完整分析方法论
└── CHANGELOG.md                      # 版本变更记录
```

---

## 🚀 快速上手

### 前提条件

- Python 3.8+
- 智谱 AI MCP 配置（用于 Phase 2 搜索增强，可选但推荐）

### 方式一：AI 对话触发（推荐）

在 Claude Code / DeepSeek 等支持 Skill 的环境中，直接说：

```
分析 600519 股票
```

AI 自动串行执行 Phase 1 → 2 → 3，约 60 分钟输出最终 HTML。

### 方式二：手动命令行

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

# 采集数据
python stock_full_report.py 600519

# 数据已保存到 output/data_600519.json
# 后续 Phase 2/3 由 AI 继续完成
```

### 增量更新

```bash
# 更新已有报告（K线 + 行情 + 技术指标）
python update_stock_report.py 000066

# 指定 HTML 文件 + 强制更新
python update_stock_report.py 000066 --html output/个股研究-中国长城.html --force
```

---

## 📊 数据覆盖

| 原始源 | akshare 接口数 | 采集内容 |
|--------|:-----------:|---------|
| 新浪财经 | 3 | 日K线（3年·前复权）、1分钟分时、实时行情、三大报表 |
| 东方财富 | 11 | 主营构成、龙虎榜、业绩预告/快报、新闻、研报、股东、资金流向、机构评级、基金持仓、限售解禁 |
| 同花顺 | 1 | 关键财务指标（杜邦分析） |
| 雪球 | 1 | 公司概况 |
| 交易所（深/沪） | 2 | 融资融券、高管持股变动 |
| 本地计算 | 1 | MACD/KDJ/RSI/BOLL/MA5/10/20/60 |

**总计 30+ akshare 接口，覆盖 6 个原始数据源。** 所有数据免费获取，无需 Wind/Choice 等付费终端。

---

## 👨‍💻 作者与协作

| 角色 | |
|------|------|
| 产品设计与开发 | **@明立玩AI** |
| AI 协作引擎 | **DeepSeek-V4-Pro**（分析框架 + HTML 生成 + 增量更新） |

> 📮 公众号 · 抖音 · 小红书 · 知乎：**明立玩AI**
>
> 📧 联系：shemingli@126.com

---

## 🙏 致谢

- [akshare](https://github.com/akfamily/akshare) — A 股开源数据基石，让免费量化研究成为可能
- [ECharts](https://echarts.apache.org/) — 专业级交互式图表库
- [DeepSeek](https://deepseek.com/) — 本项目 100% 由 DeepSeek-V4-Pro 协作完成分析框架设计与代码生成

---

## ⚠️ 免责声明

**本工具仅供学习研究使用，不构成任何投资建议。**

股市有风险，投资需谨慎。使用本工具产生的任何投资决策及其后果，均由使用者自行承担。报告中所有目标价、估值、操作建议均为分析框架的方法演示，不代表对未来股价的任何预测或承诺。

---

**⭐ 如果这个项目对你有帮助，请给个 Star！**