stock-analysis-enhanced✓ Pass

SKILL.md Content

---
name: stock-analysis-enhanced
description: 一句话搞定个股分析 — 说"分析XXX"，自动采集30+数据源 → AI完成基本面(Step 0-8)+技术面+资金面的完整研报 → 生成交互式HTML报告。支持增量更新（K线/行情/技术指标自动刷新）。触发词："分析XXX股票"（首次）或"更新XXX股票"（增量）。
trigger_keywords: ["分析股票", "个股分析", "股票研究", "分析一只股票", "更新股票", "刷新报告", "增量更新"]
version: 3.1
last_updated: 2026-05-30
variant: enhanced
---

# 一句话搞定个股分析

> 版本：v3.1 | 更新：2026-05-30 | 用户说一句话 → 30+数据源采集 → Step 0-8 基本面 + 第9章技术面 + 资金面 → 双主题交互式HTML

---

## 📋 快速导航

- [⚡ 使用方式](#使用方式) — 一句话触发，全自动执行
  - [场景判断](#场景判断)
  - [场景A：首次分析](#场景a首次分析) — 完整三阶段
  - [场景B：增量更新](#场景b增量更新) — 快速刷新数据
- [🏗️ 三层架构](#三层架构) — Phase 1 数据采集 → Phase 2 AI分析 → Phase 3 HTML
- [📊 输出内容](#输出内容) — MD 报告 + HTML 报告的完整结构
- [🎨 HTML手写规范](#html手写规范) — 分批手写 + grep 机械校验
- [🔧 执行流程](#执行流程) — Phase 1/2/3 详细步骤
- [🔄 增量更新详细说明](#增量更新详细说明) — 脚本自动 + AI 手动

---

## ⚡ 使用方式

### 场景判断

**AI必须根据用户输入的关键词判断场景：**

#### 场景A：首次分析（完整流程）

**触发关键词：**
- "分析 XXX股票"
- "个股分析 XXX"
- "研究 XXX"
- "生成 XXX报告"
- 用户明确说"首次分析"

**判断逻辑：**
- 用户输入包含上述关键词 → 执行首次分析（Phase 1→2→3）

#### 场景B：增量更新（只更新数据）

**触发关键词：**
- "更新 XXX股票"
- "刷新 XXX报告"
- "增量更新 XXX"
- "更新报告"
- 用户明确说"更新"

**判断逻辑：**
1. 用户输入包含上述关键词
2. 检查 `output/个股研究-{股票名称}.html` 是否存在
3. 如果存在 → 执行增量更新
4. 如果不存在 → 提示用户："未找到 XXX 的报告，是否需要首次分析？"

---

### 场景A：首次分析

**当用户说"分析 XXX股票"时，一句话触发全流程：**

### Phase 1: 数据采集（3-5分钟）

```bash
cd G:/vibe/my-skills/stock-analysis-enhanced
python stock_full_report.py <股票代码>
```

**示例：**
```bash
python stock_full_report.py 600519  # 贵州茅台
python stock_full_report.py 600673  # 东阳光
```

**唯一输出：** `output/data_<股票代码>.json`（包含K线、财务、股东、业务构成等完整数据，供Phase 2/3使用）

**⚠️ Phase 1完成后立即进入Phase 2**，不要停下来询问用户。JSON只是数据中间产物。

**⚠️ Phase 1 新增功能：** 自动计算技术指标（MACD/KDJ/RSI/BOLL/MA），保存到 `data_{代码}.json` 的 `technical_indicators` 和 `technical_signals` 字段，供 Phase 3 生成第9章使用。

---

### 场景B：增量更新

**执行命令：**

```bash
cd G:/vibe/my-skills/stock-analysis-enhanced副本
python update_stock_report.py <股票代码>
```

**常用参数：**
```bash
# 基本用法（自动查找HTML文件）
python update_stock_report.py 000066

# 指定HTML文件
python update_stock_report.py 000066 --html output/个股研究-中国长城.html

# 强制更新（跳过检查，直接更新）
python update_stock_report.py 000066 --force
```

**更新内容：**
- ✅ K线数据（rawData数组）
- ✅ Hero区域（最新价、涨跌幅）
- ✅ 第9章技术指标（MACD/KDJ/RSI/BOLL图表）
- ❌ 基本面分析（Step 0-8，不更新）

**详细说明：** 见本文件末尾"[🔄 增量更新详细说明](#增量更新详细说明)"章节

---

### Phase 2: AI深度分析（30-60分钟）

**AI必须手动执行以下步骤：**

1. **读取数据：** `output/data_<股票代码>.json`
2. **执行MCP搜索：** 根据实际需要搜索（通常3-6次）
   - 行业趋势、市场规模
   - 竞争对手、市场份额
   - 券商研报、目标价
   - 最新新闻、政策动态
3. **逐步完成Step 0-8分析：** 严格按照分析框架，每个Step达到要求
4. **输出MD报告：** `output/个股研究-<股票名称>.md`

**⚠️ 三阶段连续执行，中间不中断：** Phase 2完成后**立即进入Phase 3**，不要停下来询问用户是否继续。MD报告只是中间产物，HTML才是最终交付物。

---

### Phase 3: HTML生成层（AI手动分批拼装 + 逐批机械校验）

> ⚠️ 写 HTML 只用 Write 工具。整个 Phase 3 只需 6 次 Write 调用，约 30 分钟，完全在单会话内完成。不要用 Python 替代。

**原理：** AI手写完整HTML——从范例提取结构参照，从 `shared/` 搬运CSS/JS，从MD报告提取内容。**分批 Write，每批写完后立即用 grep 对范例做机械校验，通过才继续。**

**核心规则：不靠记范例，靠每批 grep diff。**

**执行步骤：**

1. **读取模板：** `shared/template_base.css` + `shared/template_base.js`
2. **读取范例并提取参照：** `examples/个股研究-中国长城.html` → 用 grep 提取 nav 锚点列表、section id 列表，保存为临时参照文件
3. **读取校验规范：** `HTML手写参考.md` → 严格按「分批机械校验」表格逐批执行
4. **读取数据：** `output/个股研究-{股票名称}.md` + `output/data_{代码}.json`
5. **分批手写HTML（每批 = Write + grep校验）：**
   - 每批 ≤300行，用 **Write工具** 直接写HTML markup
   - **写完后立即跑该批对应的 grep 校验命令**（命令清单见 `HTML手写参考.md` § 分批机械校验）
   - 校验通过 → 下一批。校验失败 → grep 范例对应行 → 比对 → Edit 修正 → 重新校验
6. **合并：** 仅用 `cat` 做机械字节拼接
7. **终验：** 运行合并后终验命令（nav-id 配对 + 结构完整性），全部通过才输出最终文件
8. **输出：** `output/个股研究-{股票名称}.html`

### ⚠️ 分批手写规则（强制）

**禁止行为：**

| 禁止 | 原因 |
|------|------|
| ❌ **Python f-string/template 生成HTML** | 需要大量 `{{}}` 转义，易出错不可维护 |
| ❌ **Bash heredoc 生成HTML** | 多行HTML下经常EOF匹配失败 |
| ❌ **一次性写出整个HTML** | >300行文件必须分批，每批独立一个Write调用 |
| ❌ **用 `python -c` 拼接HTML字符串** | 属于Python生成，不是手写 |

**正确做法：**

| 操作 | 工具 | 说明 |
|------|------|------|
| 写入HTML内容 | **Write** | 直接写HTML markup，无转义问题 |
| 精确局部修改 | **Edit** | 替换特定行，不改动其他部分 |
| 机械合并部分文件 | **Bash `cat`** 或 **Python `file.read()`** | 仅读取+拼接字节，不生成任何markup |

**标准分批方案（~900行HTML）—— 每批三步：Read范例 → Write → grep：**

**参考范例：** `examples/个股研究-中国长城.html`（864行，金标准成品）

> ⚠️ **参考范例路径不可变。** 该文件位于 `examples/` 目录（稳定范例），禁止替换为 `output/` 下的生成结果。行号基于当前版本，如范例更新需同步修正行号。

| 批次 | Step 1: Read范例（先看再写） | Step 2: Write | Step 3: grep兜底 |
|------|---------------------------|---------------|------------------|
| Batch 0 | `Read 中国长城 line=1-129`（head+style段） | Write DOCTYPE + `<head>` + `<style>` | `grep -c '<style>'`=1, `grep 'echarts\|MathJax'` 确认CDN |
| Batch 1 | `Read 中国长城 line=130-195`（nav+hero+conclusion+profile网格） | Write `<body>` + nav + hero + conclusion(含交易参数行) + grid-2(公司画像+近期动态) | `grep -oc 'href="#'`=14, `grep -c 'hero-meta-item'`=5, `grep 'nav-analysis-date'`存在, `grep -c '利好\|利空\|中性'`≥5, `grep 'overflow-y\|max-height:300'`=0, `grep -c 'style="[^"]*color:#fff[^"]*"\|style="[^"]*color:white[^"]*"\|style="[^"]*color:rgba(255'`=0, `grep -c '买入区间\|止损位\|目标价\|建议仓位'`≥4 |
| Batch 2 | `Read 中国长城 line=196-260`（饼图+财务+K线） | Write 饼图+财务grid-2 + K线card(kline-section) | `grep 'id="kline-section"'` 存在, `grep 'height:480px'` 存在, `grep -c 'markLine'`≥1, `grep -c 'markPoint'`≥1 |
| Batch 3 | `Read 中国长城 line=260-397`（Step 0-3） | Write Step 0-3 卡片（mission/macro/chain/quality） | `grep -o 'id="[^"]*"'` → mission/macro/chain/quality 四者存在 |
| Batch 4 | `Read 中国长城 line=398-550`（Step 4-6） | Write Step 4-6 卡片（elasticity/risk/valuation） | `grep -o 'id="[^"]*"'` → elasticity/risk/valuation 三者存在, `grep -c 'score-fill.*width'`≥10, `grep 'border-top:2px solid var(--gold)'` 弹性树横线存在 |
| Batch 5 | `Read 中国长城 line=551-863`（Step 7-8+第9章+footer） | Write Step 7-8 卡片 + 第9章技术面卡片（信号总览6卡片→技术图表2x2→多周期趋势→位置形态→动量量价→资金面→市场风格→综合研判）+ footer + `</div>` | `grep -o 'id="[^"]*"'` → compare/tracking/technical 存在, `grep '📌'` 存在, `grep -c '<p>' footer段`=5, `grep 'strong' footer段`=0, `grep '催化剂兑现追踪\|已兑现\|待兑现'`存在, `grep '📋 事件记录'`存在, `grep -c 'chart-macd\|chart-kdj\|chart-rsi\|chart-boll'`=4 |
| Batch 6 | `Read 中国长城 line=864-1155`（script段）；从 `data_{代码}.json` 提取K线（最近120条）和业务构成 | Write `<script>...</script>`（搬运 `template_base.js` 完整内容，替换4处占位符：`__RAW_DATA_ARRAY__` → K线JSON数组、`__PIE_DATA_ARRAY__` → 业务构成JSON数组、`__MARKLINE_DATA__` → markLine数组、`__MARKPOINT_DATA__` → markPoint数组。模板已含技术指标计算+6个渲染函数，直接搬运无需修改） | `grep -c '__'`=0, `grep -cF 'const rawData'`=1, `grep -c 'renderMACD'`=1, `grep -c 'renderKDJ'`=1, `grep -c 'renderRSI'`=1, `grep -c 'renderBOLL'`=1, `grep -c '</script>'`=1 |
| 合并+终验 | — | Bash `cat _h_part*.html > 最终文件`，然后运行 **`HTML手写参考.md` § 终验自检清单** 全部 **16** 条 | 全部通过才输出最终文件 |

**执行规则（不可跳过）：**
1. 每批第 1 步：**必须用 Read 工具打开范例对应行号区间**。读完范例段落后立即 Write，中间不做其他操作。
2. 写完后跑第 3 步 grep。对不上 → `grep` 范例对应行 → `grep` 自己写的 → 看差异 → Edit 修正 → 重跑 grep。
3. 三步全部通过才进入下一批。

> **若各批写为独立文件，用 `cat _h_part*.html > 最终文件` 合并，然后删临时文件。**

**Step 0-8 关键可视化组件清单：**
- **Step 0:** 4个信息卡片（标的/周期/风格/命题）
- **Step 1:** 核心矛盾高亮框
- **Step 2:** 产业链SVG图谱、grid-2布局、关键判断提示框
- **Step 3:** grid-2布局、6个评分条、评级徽章
- **Step 4:** 弹性树、公式卡片2x2、情景分析grid-3
- **Step 5:** grid-2布局、止损信号列表
- **Step 6:** grid-2布局、三档目标价、盈亏比量化卡片
- **Step 7:** 对比表格、增长引擎切换3卡片
- **Step 8:** grid-2布局、执行清单、verdict-highlight、五维评分、📌总结框（强制，红色左边框）

**关键约束：**
- **OHLC 转换**：`ohlc.push([d[1], d[4], d[3], d[2]])` — rawData 格式 `[日期, 开盘, 最高, 最低, 收盘, 成交量]`（akshare 原生列序），itemStyle 用 `color: c.upColor, color0: c.downColor`。与 stock-analysis-github 验证通过版本一致
- 成交量柱必须每根单独着色（红涨绿跌）
- 产业链 SVG 文字使用 `.svg-hdr` / `.svg-sub` class
- MathJax 使用 `\\(...\\)` 行内分隔符 → **HTML源码中写 `\(...\)`（单反斜杠），禁止 `\\(...\\)`（双反斜杠）**。HTML text 中反斜杠不是转义符，双反斜杠会导致 MathJax 分隔符匹配失败
- 所有CSS class必须来自 `shared/template_base.css`
- **内容区子标题禁止编号前缀**（不用 "1a/1b/2a"），直接写中文描述文字
- **禁止 h2/h3 标题带"Step X"编号前缀**：卡片标题只写中文描述（如"任务锁定与核心矛盾"，不写"Step 0 · 任务锁定"），`.sub` 同样禁止编号
- **Hero meta-item 5项固定顺序**：①分析基准日（`data-cutoff`日期，标签"分析基准日"，值格式`YYYY-MM-DD`）②公司质地等级（Step 3评分，标签"公司质地"）③中期目标价 ④盈亏比 ⑤风险等级
- **两套评分标签区分**：Step 3 评分 → 标签"公司质地评分"；Step 8 评分 → 标签"综合交易评分"。两套分维度不同、数值不同是正常的，标签区分清楚即可
- **产业链 SVG 内容质量**：不满足于基础的3节点模板。根据 MD 分析内容扩充节点——多业务线（如 IVD vs SPD）、分支节点（如子公司网络）、关键数据标注（如各业务毛利率）。**每个`<text>`元素≤14个中文字**，超出换新`<text>`行(y+22)。写完自检：最长text字符数×13px < 所在rect的width
- **📌总结框为强制组件**：Step 8 底部必须有一个独立的红色左边框总结框（`border-left:4px solid var(--red-up)`），包含 `📌 总结` 标题和一段话总结，不可省略或用 verdict-highlight 替代
- **弹性树强制HTML模板**：使用flex+CSS边框构建树形图——顶层节点(金色边框)→竖线(2px×6px gold)→横线(border-top:2px solid gold)→三列子节点flex(2:1:1)。🔴红色/🟡金色/⚪灰色分别标记核心/次要/其他业务。每个子节点含业务名+营收占比+毛利率+业务线+弹性因子。**禁止纯文本无树形图**
- **评分条score-fill宽度强制**：每个 `.score-fill` 必须为 `<div>`（**禁止 `<span>`**，inline 元素 width 无效），必须有内联 `style="width:X%"`，X为该维度得分百分比。格式：`<div class="score-fill" style="width:65%;"></div>`——不可省略style属性，不可用CSS class替代width。高分段(≥70%)金色，中分段(40-69%)橙色，低分段(<40%)红色
- **核心结论区强制附加交易参数行**：`.conclusion-top` 内 verdict-tags 下方必须有一行 `border-top:1px dashed var(--border)` 分隔，展示5个关键交易参数（flex行，居中排列）：①买入区间（绿色）②止损位（绿色）③目标价（红色）④建议仓位（金色）⑤盈亏比（金色）。格式：`<div style="font-size:11px;color:var(--text-muted);">标签</div><div style="font-weight:700;color:语义色;font-size:15px;">值</div>`。参数来源于 MD 报告 Step 6/8 分析结论
- **Hero标签限制**：`.hero-tags` 内标签≤5个，每个标签≤4个中文字
- **Footer格式**：作者行和联系方式行**禁止使用strong标签和金色高亮**，保持纯文本
- **禁止HTML body内联硬编码颜色**：所有 `style="color:#fff"` / `style="color:white"` / `style="color:rgba(255,255,255,...)"` 必须改用CSS变量（`var(--text-primary)` / `var(--text-secondary)` 等），确保双主题切换时文字始终可见。浅色模式下 `card-bg-alt` 为 `#fef5e7`（暖奶油色），白色文字完全不可见
- **近期动态强制规范**：**禁止使用滚动容器**（`max-height`/`overflow-y`），固定高度展示。每条新闻用纯文本 `<span>`（暂不设链接）。每条右侧必须有**利好/利空/中性标签**（`<span>` + 内联style），利好=红色背景+红字（`background:rgba(245,86,86,0.15);color:var(--red-up)`），重大利好另加红色左边框（`border-left:3px solid var(--red-up)`），中性=金色背景+金字（`background:rgba(212,168,83,0.15);color:var(--gold)`），利空=绿色背景+绿字。标签文字≤4字。**增量更新时，近期动态必须替换为当日最新新闻，重新判断利好利空属性**
- **K线图强制技术标注**：必须包含4条markLine（虚线金色`#d4a853`）：前高压力位/关键均线(MA20或MA60)/加仓位/止损位，价格取自MD报告分析内容。2个markPoint（pin图标）：当前价位(金色`#d4a853`)+关键历史价位(红色`#f55656`)。label用`#fff` 字号11px fontWeight bold。markLine label用`#d4a853` 字号10px

---

### 输出文件

```
output/
├── data_<股票代码>.json           # Phase 1: 原始数据（akshare采集）
├── 个股研究-<股票名称>.md          # Phase 2: 完整分析报告
└── 个股研究-<股票名称>.html        # Phase 3: 可视化HTML报告
```

---

## 🔧 配置要求

### 所有版本通用

**必需配置：**
- Python 3.8+
- akshare库（数据采集）
- Claude Code环境（AI分析和HTML生成）
- **智谱AI MCP配置**（`.mcp.json`）：用于Phase 2的中文信息搜索

**配置示例：**

`.mcp.json`（智谱AI搜索）：
```json
{
  "mcpServers": {
    "zhipu": {
      "command": "npx",
      "args": ["-y", "@zhipu-ai/mcp-server"],
      "env": {
        "ZHIPU_API_KEY": "your_zhipu_api_key"
      }
    }
  }
}
```

**说明：**
- Enhanced版本：本地使用，MCP已配置
- Competition版本：比赛提交，需确保MCP配置文件存在
- GitHub版本：开源发布，需在README中说明MCP配置步骤

---

## 🏗️ 三层架构

### 架构图

```
┌─────────────────────────────────────────────┐
│               用户输入                       │
│     "分析 XXX股票" 或 "分析 600519"         │
└────────────────────┬────────────────────────┘
                     │
  ┌──────────────────▼──────────────────┐
  │  Phase 1: 数据采集（脚本）           │
  │  python stock_full_report.py <code> │
  │  → output/data_{代码}.json          │
  └──────────────────┬──────────────────┘
                     │
  ┌──────────────────▼──────────────────┐
  │  Phase 2: AI分析（手写）             │
  │  读取 data JSON → MCP搜索           │
  │  → 逐步完成 Step 0-8                │
  │  → output/个股研究-{名称}.md         │
  └──────────────────┬──────────────────┘
                     │
  ┌──────────────────▼──────────────────┐
  │  Phase 3: HTML生成（手写）           │
  │  CSS/JS 从 shared/ 搬运             │
  │  内容从 MD + data JSON 提取         │
  │  结构参考 examples/ 范例            │
  │  → output/个股研究-{名称}.html       │
  └──────────────────┬──────────────────┘
                     │
              ┌──────▼──────┐
              │  完成 ✓     │
              └─────────────┘
```

---

## 📊 输出内容

### MD报告结构（540-740行）

```markdown
# {股票名称}（{股票代码}）深度研究

## 基本信息
- 股票名称、代码、行业、市值、PE、PB等

## 财务摘要（最近一年）
- 营业收入、净利润、毛利率、ROE

## 股东结构
- 十大股东表格

## 主营业务构成
- 业务构成表格

---

## Step 0: 任务锁定（10行）
- 标的、周期、数据截止日、研究状态、风格预判

## Step 1: 宏观与周期定位（50行）
- 1a. 经济周期映射
- 1b. 政策与环境扫描
- 1c. 核心矛盾提炼

## Step 2: 产业链深度拆解（100行）
- 2a. 题材来源判断
- 2b. 产业链图谱（ASCII/Mermaid）
- 2c. 趋势三要素
- 2d. 价值链利润分布

## Step 3: 公司筛选与质量评分（50行）
- 3a. 正面筛选清单
- 3b. 不碰清单
- 3c. 质量评分（100分制）

## Step 4: 业绩弹性测算（80行）
- 4a. 分业务弹性树
- 4b. 价格敏感度公式
- 4c. 情景分析

## Step 5: 风险分析（40行）
- 5a. 风险清单
- 5b. 逻辑破坏条件（5个止损信号）

## Step 6: 估值与买卖时机（100行）
- 6a. 估值方法
- 6a+. 资金面分析
- 6a++. 技术面分析
- 6b. 三档目标价
- 6c. 盈亏比量化

## Step 7: 对标分析（60行）
- 7a. 案例类比法
- 7b. 增长引擎切换

## Step 8: 跟踪计划与综合结论（50行）
- 8a. 分层跟踪锚点
- 8b. 执行清单
- 8c. 综合结论（一句话判断、风险等级、操作建议）
- 8d. 五维综合评分
```

### HTML页面结构（实际输出格式）

```
<!DOCTYPE html>
<html>
<head>
  <meta> + <title>
  <script src="echarts CDN">
  <script src="MathJax CDN">
  <style> /* = template_base.css 完整搬运 */ </style>
</head>
<body>
  <nav class="top-nav">        <!-- 顶部导航（sticky） -->
    股票名+代码 · logo · **14个固定nav-links（含技术面）**（行情/结论/画像/K线/任务/宏观/产业链/质量/弹性/风险/估值/对标/跟踪）· **分析基准日**（格式：`📅 YYYY-MM-DD`，12px字号，颜色跟随主题）· 主题切换按钮
  </nav>
  <div class="container">
    <div class="hero">         <!-- Hero行情卡片 -->
      价格 + 涨跌幅 + **hero-meta 5项固定**（分析基准日/质量评级/中期目标价/盈亏比/风险等级）+ 标签组
    </div>
    <div class="conclusion-top"> <!-- 结论置顶卡片 -->
      核心结论标签 + 综合判断 + 详细说明 + 标签组
    </div>
    <!-- 公司画像 + 新闻（grid-2） -->
    <!-- 主营业务饼图 + 关键财务指标（grid-2） -->
    <!-- K线图卡片（ECharts candlestick + 成交量） -->
    <!-- K线底部4指标行（向上空间/盈亏比/目标价/周期） -->
    <!-- 分析章节卡片：任务/宏观/产业链/质量/弹性/风险/估值/对标/跟踪 -->
    <!-- 页脚（固定模板，见 HTML手写参考.md） -->
    <!-- 页脚含：免责声明 + 数据截止/研究状态/分析基准日 + 数据来源行 + 作者信息 + 联系方式 -->
    <!-- 分析基准日格式：📅 分析基准日：YYYY-MM-DD（数据截止日当天或最近交易日） -->
  </div>
  <script> /* = template_base.js 骨架搬运 + 数据注入 */ </script>
</body>
</html>
```

> **关键约束：** HTML不使用左侧目录导航（旧设计规范中的 `nav.toc` 已废弃），改用顶部 sticky 导航 + 滚动高亮。

---

## 🎨 HTML手写规范

> **Phase 3开始时，必须读取 `HTML手写参考.md`。该文件包含：组件速查表、颜色语义、以及分批机械校验的 grep 命令清单。校验命令不可跳过。**

### 核心要点

- `<style>` = `shared/template_base.css` 完整搬运，不做修改
- `<script>` = `shared/template_base.js` 骨架 + 注入 rawData（K线）+ pieData（业务构成）
- `<body>` 结构参考 `examples/个股研究-中国长城.html`
- OHLC 格式 `[open, close, low, high]`，成交量每根单独着色
- 红涨绿跌全篇一致，所有CSS class来自template_base.css
- 产业链SVG文字用 `.svg-hdr` / `.svg-sub` class，MathJax用 `\\(...\\)`

### 页面结构（强制顺序）

```
top-nav → .hero → .conclusion-top → grid-2(公司画像+动态) → grid-2(饼图+财务)
→ .card(K线图) → 分析章节9卡片 → footer
```

### 详细参考

完整组件速查表、颜色语义表、CHECKS自检清单 → **[HTML手写参考.md](HTML手写参考.md)**

---

## 🌓 双主题颜色规范

> **浅色/深色模式切换通过 `<button class="theme-toggle" id="themeToggle">` 实现，CSS 变量切换由 `:root` 和 `body.light-mode` 两组变量控制。**

### 浅色模式强制检查清单

**Phase 3 分批校验时，每批完成后必须逐项确认浅色模式覆盖完整：**

| 检查项 | 深色模式 | 浅色模式要求 | grep 校验命令 |
|--------|---------|-------------|--------------|
| Nav logo文字 | `color:#fff` | `color:var(--text-primary)` | `grep -c 'light-mode.*logo'` ≥1 |
| Nav logo-icon | `color:#fff` | `color:var(--card-bg)` | `grep 'light-mode.*logo-icon'` 存在 |
| Nav stock-name/stock-code | 继承logo白色 | 继承修复后可见 | 同上条覆盖即可 |
| 卡片标题 h2 | `color:#fff` | `color:var(--text-primary)` | `grep -c 'light-mode.*card-header h2'` ≥1 |
| Hero区域 | `color:#fff` | `color:var(--text-primary)` | `grep -c 'light-mode.*\.hero'` ≥1 |
| 结论大字 `.big-verdict` | `color:#fff` | `color:var(--text-primary)` | `grep 'light-mode.*big-verdict'` 存在 |
| Hero meta label | `color:rgba(255,255,255,0.7)` | `color:var(--text-muted)` | `grep 'light-mode.*hero-meta-item.*label'` 存在 |
| Hero meta val | `color:var(--gold-light)` | `color:var(--gold)` | `grep 'light-mode.*hero-meta-item.*val'` 存在 |
| 评级标题 `.body .title` | `color:#fff` | `color:var(--text-primary)` | `grep 'light-mode.*rating-callout.*title'` 存在 |
| 产业链SVG `.svg-hdr` | `fill:#e8e9ec` | `fill:#2a1f12` | `grep 'light-mode.*svg-hdr'` 存在 |
| 产业链SVG `.svg-sub` | `fill:#b0b3be` | `fill:#6b5634` | `grep 'light-mode.*svg-sub'` 存在 |
| KPI value `.value` | `color:var(--gold-light)` | `color:var(--gold)` | `grep 'light-mode.*kpi-info-item.*value'` 存在 |
| Theme toggle按钮 | 默认样式 | 浅底深字可辨识 | `grep 'light-mode.*theme-toggle'` 存在 |
| 新闻链接 `.news-item a` | 继承text-secondary | 保持可点击辨识 | 无需额外覆盖 |

### 浅色模式覆盖CSS模板

**以下代码必须完整出现在 `<style>` 标签中（template_base.css 已包含）：**

```css
body.light-mode .top-nav{background:rgba(255,251,245,0.92);border-bottom-color:var(--gold)}
body.light-mode .top-nav .logo{color:var(--text-primary)}
body.light-mode .top-nav .logo-icon{color:var(--card-bg)}
body.light-mode .top-nav .stock-name{color:var(--text-primary)}
body.light-mode .top-nav .stock-code{color:var(--text-muted)}
body.light-mode .theme-toggle{background:rgba(0,0,0,0.05);border-color:var(--gold);color:var(--gold)}
body.light-mode .theme-toggle:hover{background:rgba(0,0,0,0.1)}
body.light-mode .nav-links a{color:var(--gold)}
body.light-mode .nav-links a:hover,body.light-mode .nav-links a.active{background:rgba(0,0,0,0.05);color:#7f1d1d}
body.light-mode .hero{background:linear-gradient(105deg,#fef5e7,#fffbf5);color:var(--text-primary);border-color:var(--gold)}
body.light-mode .hero-price{color:var(--text-primary)}
body.light-mode .hero-change{background:rgba(220,38,38,0.1);color:var(--red-up)}
body.light-mode .hero-meta-item .val{color:var(--gold)}
body.light-mode .hero-meta-item .label{color:var(--text-muted)}
body.light-mode .hero-tag{background:rgba(212,168,83,0.15);border-color:var(--gold);color:var(--gold)}
body.light-mode .conclusion-top{background:linear-gradient(135deg,#fff9f0,#fef5e7)}
body.light-mode .conclusion-top .big-verdict{color:var(--text-primary)}
body.light-mode .card-header h2{color:var(--text-primary)}
body.light-mode .tag{background:rgba(212,168,83,0.15);color:var(--gold);border-color:var(--gold)}
body.light-mode table.cons thead th{background:linear-gradient(180deg,#f55656,#c0392b)}
body.light-mode .score-bar .score-track{background:#f0e4ce}
body.light-mode .rating-callout{background:linear-gradient(135deg,#fff9f0,#fef5e7)}
body.light-mode .rating-callout .body .title{color:var(--text-primary)}
body.light-mode .verdict-highlight{background:#fef5e7}
body.light-mode .verdict-highlight .judgment{color:var(--gold)}
body.light-mode .verdict-highlight .v-val{color:var(--text-primary)}
body.light-mode .chain-svg .svg-hdr{fill:#2a1f12}
body.light-mode .chain-svg .svg-sub{fill:#6b5634}
body.light-mode .kpi-info-item .value{color:var(--gold)}
```

### 禁止的硬编码颜色

| 禁止写法 | 原因 | 正确写法 |
|---------|------|---------|
| `color:#fff`（无浅色覆盖） | 浅色模式白色背景上看不见 | 用CSS变量 + body.light-mode覆盖 |
| `color:white`（无浅色覆盖） | 同上 | 同上 |
| `fill:#fff`（SVG文字，无浅色覆盖） | SVG白字在浅色背景不可见 | 用`.svg-hdr`/`.svg-sub` class，已含双主题覆盖 |
| `color:rgba(255,255,255,0.7)`（无浅色覆盖） | 半透明白色同理 | 用`var(--text-muted)` + light-mode覆盖 |

---

## 🔧 执行流程

### Phase 1: 数据采集层（3-5分钟）

**脚本：** `stock_full_report.py`

**功能：**
1. 使用akshare采集数据源
2. Fallback机制：akshare失败→跳过
3. **唯一输出：** `output/data_{代码}.json`（供Phase 2/3使用）

**数据源：** 基础信息、行情（3年日K线）、主营业务、资金流向、财务数据、股东结构、公告新闻、研究报告

### Phase 2: AI分析层（45-75分钟）

**AI手动执行，无自动化脚本。**

**2.1 基础信息写入（5分钟）**
- 读取 `output/data_{代码}.json`
- 写入MD头部：股票名称、代码、行业、市值、PE/PB、财务摘要、股东结构、主营业务构成

**2.2 MCP搜索（10分钟）**
- 用智谱AI搜索行业趋势、竞争对手、券商研报、最新新闻（通常3-6次）
- 智谱失败则fallback到Tavily

**2.3 AI逐步分析Step 0-8（30-60分钟）**

**⚠️ MD写作禁止事项（防止内容泄露到HTML）：**
- ❌ MD正文任何位置禁止出现：`@明立玩AI` / `作者：明立` / `ll-mingli1221` / 社交媒体ID
- ❌ MD末尾禁止添加署名行（如 `> 分析框架：... | @明立玩AI`）
- ✅ 这些信息仅出现在HTML的footer中，由Phase 3统一添加

**强制执行清单：**

```
□ Step 0: 任务锁定（10行）
  ├─ 标的（公司名、代码、交易所）
  ├─ 周期（短线/中线/长线）
  ├─ 数据截止日（YYYY-MM-DD）
  ├─ 研究状态（首次覆盖/持续跟踪）
  └─ 风格预判（配置型/交易型/左侧博弈型）

□ Step 1: 宏观与周期定位（50行）
  ├─ 使用MCP搜索结果：行业趋势
  ├─ 1a. 经济周期映射
  ├─ 1b. 政策与环境扫描
  └─ 1c. 核心矛盾提炼（XX vs YY）

□ Step 2: 产业链深度拆解（100行）
  ├─ 使用MCP搜索结果：竞争对手、产业链
  ├─ 2a. 题材来源判断
  ├─ 2b. 产业链图谱（ASCII或Mermaid代码块）
  ├─ 2c. 趋势三要素（表格+打分）
  └─ 2d. 价值链利润分布（表格）

□ Step 3: 公司筛选与质量评分（50行）
  ├─ 使用akshare数据：财务、股东
  ├─ 3a. 正面筛选清单（6项标准）
  ├─ 3b. 不碰清单（负面排查）
  └─ 3c. 公司质地评分（100分制，6个维度——注意：与Step 8综合交易评分维度不同，两个分不一定相等）

□ Step 4: 业绩弹性测算（80行）
  ├─ 使用akshare数据：主营业务、财务
  ├─ 4a. 分业务弹性树（ASCII代码块）
  ├─ 4b. 价格敏感度公式（3个公式）
  └─ 4c. 情景分析（悲观/基准/乐观表格）

□ Step 5: 风险分析（40行）
  ├─ 5a. 风险清单（表格：风险类型、影响程度、发生概率）
  └─ 5b. 逻辑破坏条件（5个止损信号）

□ Step 6: 估值与买卖时机（100行）
  ├─ 使用MCP搜索结果：券商研报
  ├─ 使用akshare数据：K线、资金流向
  ├─ 6a. 估值方法选择
  ├─ 6a+. 资金面分析（筹码分布、主力资金）
  ├─ 6a++. 技术面分析（均线、支撑阻力）
  ├─ 6b. 三档目标价（短期/中期/长期表格）
  └─ 6c. 盈亏比量化（向上空间 vs 向下空间）

□ Step 7: 对标分析（60行）
  ├─ 使用MCP搜索结果：竞争对手
  ├─ 7a. 案例类比法（对比表格）
  └─ 7b. 增长引擎切换（如果适用）

□ Step 8: 跟踪计划与综合结论（50行）
  ├─ 8a. 分层跟踪锚点（高频/季度/事件）
  ├─ 8b. 执行清单（短线/中线）
  ├─ 8c. 综合结论（一句话判断、风险等级、操作建议）
  └─ 8d. 五维综合交易评分（基本面/资金面/技术面/情绪面/事件——与Step 3公司质地评分维度不同）

✅ 总计：540行（最低要求）
```

**执行规则：**
1. AI必须严格按照Step 0→Step 8顺序执行
2. 每完成一个Step，输出：`✅ Step X完成（XX行）`
3. 不能跳过或简化任何Step
4. 每个Step必须达到最低行数要求

### Phase 3: HTML生成层（AI手动分批拼装）

**原理：** AI手写完整HTML——从 `shared/` 搬运CSS/JS，从MD报告提取内容，从范例参考结构。**分批用Write工具写，禁止用Python/Bash heredoc生成HTML内容。**

**执行步骤：**

1. **读取模板：** `shared/template_base.css` + `shared/template_base.js`
2. **读取范例：** `examples/个股研究-中国长城.html`
3. **读取数据：** `output/个股研究-{股票名称}.md` + `output/data_{代码}.json`
4. **分批手写HTML：**
   - 每批 ≤300行，用 **Write工具** 直接写HTML markup
   - `<style>` = 完整搬运 template_base.css（Write工具写入）
   - `<script>` = template_base.js 骨架 + 注入 rawData + pieData（独立一批，Write工具写入）
   - `<body>` = 参考范例结构，分2-4批写入各section
5. **合并部分文件（如有）：** 仅用 `cat` 或 Python `file.read()` 做机械字节拼接，绝不生成HTML内容
6. **输出：** `output/个股研究-{股票名称}.html`

### ⚠️ 分批手写规则（强制）

**禁止行为：**

| 禁止 | 原因 |
|------|------|
| ❌ **Python f-string/template 生成HTML** | 需要大量 `{{}}` 转义，易出错不可维护 |
| ❌ **Bash heredoc 生成HTML** | 多行HTML下经常EOF匹配失败 |
| ❌ **一次性写出整个HTML** | >300行文件必须分批，每批独立一个Write调用 |
| ❌ **用 `python -c` 拼接HTML字符串** | 属于Python生成，不是手写 |

**正确做法：**

| 操作 | 工具 | 说明 |
|------|------|------|
| 写入HTML内容 | **Write** | 直接写HTML markup，无转义问题 |
| 精确局部修改 | **Edit** | 替换特定行，不改动其他部分 |
| 机械合并部分文件 | **Bash `cat`** 或 **Python `file.read()`** | 仅读取+拼接字节，不生成任何markup |

**标准分批方案（~900行HTML）：**

```
Batch 0: Write — DOCTYPE + <head> + <style>（CSS完整复制）           ~180行
Batch 1: Write — <body> + nav + hero + conclusion-top + profile      ~150行
Batch 2: Write — K线图卡片 + Step 0-3 卡片                            ~200行
Batch 3: Write — Step 4-6 卡片（弹性/风险/估值）                      ~200行
Batch 4: Write — Step 7-8 卡片 + footer + </div>                      ~150行
Batch 5: Write — <script>（JS完整复制 + 注入rawData + pieData）       ~150行
```

> **若各批写为独立文件，用 `cat part*.txt >> main.html` 合并，然后删临时文件。Python仅用于 `file.read()` 字节拼接，绝不用f-string生成HTML markup。**

**Step 0-8 关键可视化组件清单：**
- **Step 0:** 4个信息卡片（标的/周期/风格/命题）
- **Step 1:** 核心矛盾高亮框
- **Step 2:** 产业链SVG图谱、grid-2布局、关键判断提示框
- **Step 3:** grid-2布局、6个评分条、评级徽章
- **Step 4:** 弹性树、公式卡片2x2、情景分析grid-3
- **Step 5:** grid-2布局、止损信号列表
- **Step 6:** grid-2布局、三档目标价、盈亏比量化卡片
- **Step 7:** 对比表格、增长引擎切换3卡片
- **Step 8:** grid-2布局、执行清单、verdict-highlight、五维评分、📌总结框

**关键约束：**
- **OHLC 转换**：`ohlc.push([d[1], d[4], d[3], d[2]])` — rawData 格式 `[日期, 开盘, 最高, 最低, 收盘, 成交量]`（akshare 原生列序），itemStyle 用 `color: c.upColor, color0: c.downColor`。与 stock-analysis-github 验证通过版本一致
- 成交量柱必须每根单独着色（红涨绿跌）
- 产业链 SVG 文字使用 `.svg-hdr` / `.svg-sub` class，字号 `.svg-hdr` ≥14px, `.svg-sub` ≥12px
- MathJax 使用 `\\(...\\)` 行内分隔符 → **HTML源码中写 `\(...\)`（单反斜杠），禁止 `\\(...\\)`（双反斜杠）**。HTML text 中反斜杠不是转义符，双反斜杠会导致 MathJax 分隔符匹配失败
- 所有CSS class必须来自 `shared/template_base.css`
- **禁止占位符：HTML 全文不得残留任何 `<!-- AI填充` 或 `<!-- XXX_PLACEHOLDER` 注释**
- **弹性树必须用 `grid-2`（2×2），禁止 flex 单行4列**
- **📌总结框必须为独立 `.card`（红色左边框），位于 Step 8 之后、footer 之前**

> **归档说明：** `gen_html.py`、`gen_ganfeng_html.py`（硬编码模板）、`phase3_html_builder.py`（骨架生成）、`phase3_md_parser.py`（MD解析）、`stock_analysis_main.py`（早期主控）均已归档至 `archive/`。Phase 2/3 全部由AI手写，不使用自动化脚本。

---

## 📝 使用示例

### 示例：分析赣锋锂业（002460）

```bash
cd G:/vibe/my-skills/stock-analysis-competition
python stock_full_report.py 002460
```

**输出：**
```
[Phase 1/3] 数据采集中...
  ✅ Phase 1完成，数据已保存：output/data_002460.json

[Phase 2/3] AI分析中...
  ✅ Step 0-8 完成，MD已保存：output/个股研究-赣锋锂业.md（619行）

[Phase 3/3] AI手写HTML中...
  ✅ 模板已读取（shared/template_base.css + shared/template_base.js）
  ✅ HTML已保存：output/个股研究-赣锋锂业.html（991行/63KB）
```

---

## 🔍 常见问题

### Q1: 为什么Phase 2这么慢？
A: Phase 2需要AI逐步分析Step 0-8，每个Step都需要深度思考和MCP搜索，总计需要30-60分钟。这是为了保证分析质量。

### Q2: 可以跳过某些Step吗？
A: 不可以。Step 0-8是完整的分析框架，跳过任何一步都会导致分析不完整。

### Q3: MCP搜索失败怎么办？
A: 系统会自动fallback：智谱搜索失败→Tavily搜索→继续执行。

### Q4: HTML太长写不下怎么办？
A: HTML最终约900行/60KB，远非"太大"。关键是分批写：用Write工具每批≤300行，分5-6批写完。若写为独立文件，最后用 `cat` 做机械合并。**禁止用Python f-string生成HTML。**

---

## 📚 相关文档

- [shared/template_base.css](shared/template_base.css) — 规范CSS模板，AI复制到`<style>`
- [shared/template_base.js](shared/template_base.js) — 规范JS模板，AI复制到`<script>`并注入数据
- [examples/个股研究-中国长城.html](examples/个股研究-中国长城.html) — 成品参考范例
- [HTML报告设计规范v1.0.md](HTML报告设计规范v1.0.md) — CSS设计系统详细文档
- [分析框架.md](分析框架.md) — Step 0-8 完整分析方法论
- [第9章技术分析设计.md](第9章技术分析设计.md) — 第9章技术面分析HTML结构设计
- [archive/](archive/) — 已归档的旧脚本和文件

## 🗄️ 已归档

以下脚本/文件已移至 `archive/`：
- `gen_html.py`、`gen_ganfeng_html.py` — 硬编码模板（每股票需单独写脚本）
- `phase3_html_builder.py` — 中间骨架生成（产出`_skeleton.html`，与终版混淆）
- `phase3_md_parser.py` — MD解析工具（Phase 2/3 由AI手写，不需要）
- `stock_analysis_main.py` — 早期主控脚本（已被三层架构替代）
- `stock_report_*.html` — stock_full_report.py 自动生成的简化HTML（只有JSON是Phase 1产出）

---

## 📈 第9章：技术面与资金面分析（强制章节）

### 章节定位

**第9章是基本面分析（Step 0-8）的补充**，用于短期择时和交易信号验证。**每次首次分析和增量更新都必须包含此章节。**

- **位置**：在 Step 8（跟踪计划）之后，footer 之前
- **导航**：顶部 nav 第14个链接 `<a href="#technical">技术面</a>`
- **风格**：与 Step 0-8 保持一致的 `.card` 布局，标题用 `.card-header`
- **标题**：`技术面与资金面分析`，sub 写 `多周期联动 · 形态识别 · 量价配合 · 操作计划`

### 数据来源

- **JS 端计算（首选）：** 从 `rawData` 实时计算 MACD/KDJ/RSI/BOLL（`template_base.js` 已含计算函数，AI 搬运即可）
- **Python 预计算（备选）：** 从 `data_{代码}.json` 读取 `technical_indicators` 和 `technical_signals`（由 `stock_full_report.py` 生成）
- **MD 报告内容：** 从 Phase 2 的 MD 报告中提取关键技术位、形态判断、资金面描述（AI 分析产出）

### HTML结构（9.1-9.7，强制完整）

```html
<div class="card" id="technical">
  <div class="card-header"><span class="icon">📈</span><h2>技术面与资金面分析</h2><span class="sub">多周期联动 · 形态识别 · 量价配合 · 操作计划</span></div>

  <!-- 当前技术信号速览（6个指标卡片，grid-3） -->
  <h3 style="...">当前技术信号</h3>
  <div class="grid-3">
    <div>MACD 信号卡片</div>  <div>KDJ 信号卡片</div>  <div>RSI 信号卡片</div>
    <div>BOLL 信号卡片</div>  <div>均线 信号卡片</div>  <div>成交量 信号卡片</div>
  </div>

  <!-- 技术指标图表（紧接信号速览，与MACD/KDJ等指标关联最近） -->
  <h3>技术指标图表</h3>
  <div class="grid-2"><div id="chart-macd"></div><div id="chart-kdj"></div></div>
  <div class="grid-2"><div id="chart-rsi"></div><div id="chart-boll"></div></div>

  <!-- 多周期趋势分析（grid-3 → 月线/周线/日线，含状态标记+技术信号标签） -->
  <h3>多周期趋势分析</h3>
  <div class="grid-3">月线 · 周线 · 日线 三列卡片</div>
  <p>多周期判断总结（带💡前缀的提示框）</p>

  <!-- 位置与形态分析（grid-2：关键技术位表 + 形态识别表） -->
  <h3>位置与形态分析</h3>
  <div class="grid-2">关键技术位表格 · 形态识别表格</div>

  <!-- 9.4 动量与量价分析（grid-2：动量指标表 + 量价配合表） -->
  <h3>动量与量价分析</h3>
  <div class="grid-2">动量指标表格 · 量价配合表格</div>
  <p>⚠️ 动量预警提示框</p>

  <!-- 9.5 资金面分析（ul列表：主力资金/北向资金/龙虎榜） -->
  <h3>资金面分析</h3>
  <ul>主力资金 · 北向资金 · 龙虎榜</ul>

  <!-- 9.6 市场风格与板块轮动（grid-2：板块TOP5表 + 风格判断卡片） -->
  <h3>市场风格与板块轮动</h3>
  <div class="grid-2">板块TOP5表格 · 风格判断卡片</div>

  <!-- 9.7 综合研判与操作计划（grid-2：技术面评分5维+评级 + 操作计划表） -->
  <h3>综合研判与操作计划</h3>
  <div class="grid-2">技术面评分 · 操作计划表</div>
</div>
```

### 各节详细规范

#### 第9章内部顺序（强制）

**信号速览 → 技术指标图表 → 多周期趋势 → 位置与形态 → 动量与量价 → 资金面 → 市场风格 → 综合研判（操作计划已移至核心结论区）**

#### 当前技术信号速览（6卡片）
- 布局：`grid-3`（3列×2行 = 6卡片）
- 每个卡片：`card-bg-alt` 背景 + `border-left:3px solid` 语义色 + 指标名 + 状态 + 数值
- 颜色语义：多头=红色、空头=绿色、中性=金色、弱势=灰色
- 指标：MACD、KDJ、RSI、BOLL、均线、成交量

#### 技术指标图表（紧接信号速览，与上方MACD/KDJ等指标关联最近）
- 布局：`grid-2` × 2行 = 4个图表
- **MACD图**：DIF(金色折线) + DEA(蓝色折线) + MACD柱(红涨绿跌)
- **KDJ图**：K(金色) + D(蓝色) + J(红色)，Y轴0-100
- **RSI图**：RSI6(蓝) + RSI12(金) + RSI24(红)，Y轴0-100
- **BOLL图**：上轨(红) + 中轨(金) + 下轨(绿) + 收盘价折线(蓝) + 填充区域
- **JS 来源：** `template_base.js` 已含全部计算函数和渲染函数，AI Phase 3 Batch 6 直接搬运
- 图表容器：`chart-macd`/`chart-kdj`/`chart-rsi`/`chart-boll`，高度280px/260px

#### 多周期趋势分析
- 布局：`grid-3`（月线/周线/日线）
- 每列：`card-bg-alt` 背景 + `border-left:4px solid` + 状态描述 + 均线数据 + 信号标签(`<span>`)
- 下方：`💡 多周期判断` 提示框（`border-left:4px solid var(--gold)`）
- 信号标签颜色：多头=红底红字、中性偏多=金底金字、短期透支=橙底橙字

#### 9.3 位置与形态分析
- 布局：`grid-2`
- 左：关键技术位表格（`table.cons`，列：类型/价格/说明，支撑位绿色/压力位红色）
- 右：形态识别表格（`table.cons`，列：形态/完整度/说明）+ 形态评估提示框
- 价格来源于 MD 报告 Step 6 分析内容

#### 9.4 动量与量价分析
- 布局：`grid-2`
- 左：动量指标表格（`table.cons`，列：周期/涨幅/评估，红色涨绿色跌）
- 右：量价配合表格（`table.cons`，列：日期/价格/成交量/关系）
- 下方：⚠️ 动量预警提示框（`border-left:4px solid var(--orange-warn)`）

#### 9.5 资金面分析
- 布局：`<ul>` 列表
- 内容：主力资金流向（近20日累计+超大单/大单拆分）、北向资金持仓变化、龙虎榜数据
- 数据来源：MD 报告 Step 6a+ 资金面分析内容

#### 9.6 市场风格与板块轮动
- 布局：`grid-2`
- 左：近20日涨停板块TOP5表格（`table.cons`，列：板块/涨停次数/趋势）
- 右：市场风格判断卡片（当前风格/轮动特征/对本股影响/操作建议）
- 数据来源：MD 报告 Step 1 宏观分析 + MCP搜索

#### 9.7 综合研判与操作计划
- 布局：`grid-2`
- 左：技术面评分（5个维度的 `score-bar` + 加权总评 + ⭐技术面评级）
- 右：操作计划表格（`table.cons`，列：项目/价格仓位/说明，买入=绿色/卖出/目标=红色）
- 下方：📌 操作建议提示框（`border-left:4px solid var(--red-up)`）
- 评分维度（5维，与 Step 8 综合交易评分区分）：多周期趋势(25%)/技术指标(20%)/形态完整度(20%)/量价配合(15%)/资金面(20%)

### 第9章 Batch 分配

**第9章在 Batch 5 中与 Step 7-8 一同写入**（从范例 Read 对应区域后 Write）。JS 图表渲染函数在 Batch 6 中通过搬运 `template_base.js` 完成。

### 第9章 grep 校验（Batch 5 追加）

| 检查项 | 命令 | 通过条件 |
|--------|------|---------|
| 9.1-9.7 完整 | `grep -c '多周期趋势\|技术指标图表\|位置与形态\|动量与量价\|资金面分析\|市场风格\|综合研判'` | ≥ 7 |
| 4图表容器 | `grep -c 'chart-macd\|chart-kdj\|chart-rsi\|chart-boll'` | = 4 |
| 技术面评分 | `grep -c '技术面评分\|技术面总评\|技术面评级'` | ≥ 3 |
| 操作计划 | `grep -c '买入区间\|加仓位置\|止损位置'` | ≥ 3 |
| 信号标签 | `grep -c '多头信号\|中性偏多\|短期透支\|空头信号'` | ≥ 2 |

---

## 🔄 增量更新详细说明

### 使用场景

报告已生成，需要更新最新数据（K线、Hero行情、技术指标），但不需要重新分析。

### 触发方式

用户说"更新 XXX股票"或"刷新 XXX报告"时，AI执行增量更新。

### 执行命令

```bash
cd G:/vibe/my-skills/stock-analysis-enhanced副本
python update_stock_report.py <股票代码>
```

**常用参数：**
```bash
# 基本用法（自动查找HTML文件）
python update_stock_report.py 000066

# 指定HTML文件
python update_stock_report.py 000066 --html output/个股研究-中国长城.html

# 强制更新（跳过检查，直接更新）
python update_stock_report.py 000066 --force
```

### 更新内容

| 内容 | 是否更新 | 说明 |
|------|---------|------|
| K线数据（rawData数组） | ✅ | 从akshare获取最新120条日K线 |
| Hero区域（最新价、涨跌幅） | ✅ | 从akshare获取实时行情 |
| 第9章技术指标 | ✅ | 重新计算MACD/KDJ/RSI/BOLL，更新图表数据 |
| 基本面分析（Step 0-8） | ❌ | 不更新，需要重新分析请用首次分析 |

### 工作流程

```
1. 提取旧K线数据（从HTML中的rawData数组）
   ↓
2. 获取最新K线数据（akshare实时获取）
   ↓
3. 对比数据变化（最新交易日、新增天数）
   ↓
4. 输出检查报告（需要更新 / 无需更新）
   ↓
5. 如果需要更新：
   - 更新K线数据（替换HTML中的rawData数组）
   - 更新Hero区域数据（价格、涨跌幅等实时数据）
   - 更新第9章技术指标（重新计算并替换technicalData数组）
   - 生成带日期版本（如：个股研究-中国长城_20260528.html）
   - 覆盖最新版本（无日期文件名）
```

### 判断标准

- 如果 `新K线最后交易日 > 旧K线最后交易日` → 需要更新
- 否则 → 无需更新

### 示例输出

```
📊 检查 000066 的更新情况...
   旧HTML: output/个股研究-中国长城.html

[1/2] 提取旧K线数据...
   ✅ 旧K线数据：120条，最新日期 2026-05-20

[2/2] 获取最新K线数据...
   尝试获取数据... (第1/3次)
   ✅ 新K线数据：120条，最新日期 2026-05-27

[3/3] 对比数据变化...

============================================================
📋 更新检查报告
============================================================
✅ 需要更新

变化点：
  1. K线数据更新：2026-05-20 → 2026-05-27，新增5个交易日
============================================================

============================================================
🔄 开始增量更新
============================================================

[1/4] 更新K线数据...
   ✅ K线数据已更新：120条

[2/4] 更新Hero区域数据...
   ✅ Hero数据已更新：价格 18.99，涨跌幅 -3.16%

[3/4] 更新第9章技术指标...
   ✅ 技术指标已更新：120 条记录

[4/4] 覆盖最新版本...
   ✅ 已覆盖：output/个股研究-中国长城.html

============================================================
✅ 更新完成
============================================================

📄 输出文件：
   • 带日期版本：output/个股研究-中国长城_20260527.html
   • 最新版本：output/个股研究-中国长城.html

📊 文件大小：85.3 KB
```

### 版本管理

**生成两个文件：**
1. **带日期版本**：`个股研究-{股票名称}_{YYYYMMDD}.html`
   - 保留历史版本，便于对比分析
   - 建议保留最近30天的版本

2. **最新版本**：`个股研究-{股票名称}.html`（覆盖原文件）
   - 始终保持最新
   - 便于快速访问

### 常见问题

**Q1: 如何判断是否需要更新？**
A: 工具会自动对比旧数据和新数据的最新交易日，如果新数据的最新交易日 > 旧数据，则需要更新。

**Q2: 更新后原文件会被覆盖吗？**
A: 会生成两个文件：带日期版本（新文件，不覆盖）+ 最新版本（覆盖原文件）。历史版本会保留。

**Q3: 网络请求失败怎么办？**
A: 工具会自动重试3次，如果仍然失败，更新失败。建议检查网络连接或稍后重试。

**Q4: 如何回退到旧版本？**
A: 直接使用带日期的历史版本文件即可，例如：
```bash
cp output/个股研究-中国长城_20260520.html output/个股研究-中国长城.html
```

**Q5: 更新频率建议？**
A: 
- **日线数据**：每个交易日收盘后更新一次（15:30后）
- **同一交易日多次触发**：检查发现无新数据，自动跳过更新
- **跨多个交易日触发**：一次性更新到最新

---

## 📋 跟踪日志与版本记录

### 设计理念

每次首次分析产生"初始化跟踪结果"，每次增量更新在跟踪表中**新增一列**，标记更新日期和变化内容。这样所有历史跟踪数据在同一张表中可见，无需翻找旧版本文件。

### 跟踪表格结构：催化剂兑现追踪

**核心理念：** 不是记录数据快照（股价多少/成交量多少），而是追踪**分析中识别的关键催化剂是否兑现**。每行 = 一个催化剂/事件，状态 = 已兑现/待兑现/落空/持续观察。

#### 首次分析（初始化）

```html
<table class="cons" style="font-size:12px;">
<thead><tr><th>跟踪指标 / 催化剂</th><th>预期影响</th><th>兑现状态</th><th>备注</th></tr></thead>
<tbody>
<tr><td>催化剂1（如异环1.1版本）</td><td>流水验证→估值修复</td><td>⏳ 待兑现</td><td>预计6月</td></tr>
<tr><td>催化剂2（如H1业绩预告）</td><td>确认盈利趋势</td><td>⏳ 待兑现</td><td>预计7月</td></tr>
<tr><td>已兑现事件（如首日流水）</td><td>验证吸量能力</td><td style="color:var(--red-up);">✅ 已兑现</td><td>05-28确认</td></tr>
<tr><td>止损观察</td><td>风险控制底线</td><td style="color:var(--text-muted);">⚪ 安全区间</td><td>当前价>止损线</td></tr>
</tbody>
</table>
```

**状态标记：**
- ✅ 已兑现（红色）— 催化剂如期发生，验证分析逻辑
- ⏳ 待兑现（金色）— 尚未发生，仍在等待窗口期
- ❌ 落空（绿色）— 预期落空，需重新评估投资逻辑
- ⚪ 持续观察（灰色）— 中性状态，持续监控

**催化剂来源：** 从 MD 报告的 Step 4（弹性测算）、Step 5（风险/止损信号）、Step 6（估值催化剂）、Step 7（对标）中提取，选取 6-10 个最关键的可验证事件。

#### 增量更新

**每次"更新 XXX股票"时，AI 检查每个催化剂的状态变化：**

1. 已到期的催化剂 → 判断 ✅已兑现 或 ❌落空
2. 仍在等待的 → 保持 ⏳待兑现
3. 新出现的催化剂 → 追加新行
4. 在表格下方"📋 事件记录"中追加更新说明

**不需要插入新列**（与旧设计不同）。催化剂的行是固定的，更新的是每一行的"兑现状态"列。

### 事件记录

**跟踪表格下方必须添加事件记录：**

```html
<div class="update-log" style="margin-top:12px;padding:10px 14px;background:var(--card-bg-alt);border-radius:8px;border-left:4px solid var(--gold);">
<p style="font-weight:700;color:var(--gold);margin-bottom:6px;">📋 事件记录</p>
<ul style="list-style:none;padding:0;font-size:12px;color:var(--text-secondary);">
<li style="padding:3px 0;">• 2026-05-28 首次分析：异环首日流水1亿+已兑现（验证吸量），1.1版本/H1业绩/TI赛事待兑现，当前价14.28>止损12元安全</li>
</ul>
</div>
```

### 更新流程中的跟踪日志维护

**AI执行增量更新时的职责（每次"更新 XXX股票"时执行）：**

1. **刷新近期动态**：将新闻列表替换为当日最新8条新闻，重新判断利好/利空/中性
2. **检查催化剂兑现**：逐行检查到期催化剂是否兑现，更新状态标记
3. **追加新催化剂**：如有新的关键事件，追加新行
4. **在事件记录顶部插入新条目**：日期 + 本次更新发现的变化
5. **同步分析基准日**：nav + hero + footer 三处

**增量更新 HTML 修改清单：**

| 步骤 | 操作 | 位置 |
|------|------|------|
| 1 | 替换新闻列表（8条→新8条+利好利空标签） | grid-2 近期动态卡片 |
| 2 | 逐行检查催化剂兑现状态、必要时更新 | 跟踪日志表 `<tbody>` |
| 3 | 有新催化剂则追加 `<tr>` | 跟踪日志表末尾 |
| 4 | 事件记录顶部插入新 `<li>` | 📋 事件记录 `<ul>` |
| 5 | 更新 `📅 YYYY-MM-DD` | nav + hero + footer 三处 |

**自动更新工具 `update_stock_report.py` 的职责：**
- 更新 K线数据（rawData数组）✅ 已实现
- 更新 Hero行情（价格/涨跌幅）✅ 已实现
- 更新 第9章技术指标 ✅ 已实现
- 更新 跟踪表格（AI手动执行）
- 刷新 新闻列表（AI手动执行）
- 更新 分析基准日（AI手动执行）

### 分析基准日声明

**分析基准日在三处显示：**

| 位置 | 格式 | 说明 |
|------|------|------|
| 顶部Nav | `📅 YYYY-MM-DD` | nav-links右侧、theme-toggle按钮左侧，12px字号，颜色跟随主题 |
| Hero卡片 | hero-meta第1项，标签"分析基准日"，值`YYYY-MM-DD` | 数据截止日/最近交易日 |
| 页脚Footer | `📅 分析基准日：YYYY-MM-DD · 数据来源：akshare/同花顺/新浪` | 与免责声明同一行 |

**Nav中的分析日期CSS：**
```css
.nav-analysis-date{font-size:12px;color:var(--text-muted);margin:0 8px;white-space:nowrap}
body.light-mode .nav-analysis-date{color:var(--text-muted)}
```

---

> **免责声明：** 本系统所有分析仅供研究参考，不构成投资建议。投资有风险，决策需谨慎。

---

> **免责声明：** 本系统所有分析仅供研究参考，不构成投资建议。投资有风险，决策需谨慎。

License

Declared license: MIT

MIT License

Copyright (c) 2026 mingli30119

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

View the license in the source repository — the version published there is authoritative.