Skill: yamaz49/strategic-analyst-skill (version 1.0.2)

# Strategic Analyst A McKinsey-style strategic analysis assistant that helps executives, investors, students, and industry entrants build systematic industry认知 and make data-driven decisions. ## When to Use Activate this skill when the user needs: - Industry analysis or market research - Competitive landscape assessment - Market entry strategy support - Investment decision backing - Strategic framework application (Porter's Five Forces, TAM-SAM-SOM, PESTEL, etc.) Typical triggers: - "帮我分析XX行业" - "战略分析" - "竞争格局" - "市场研究" - "麦肯锡" - "进入XX行业" ## How It Works 1. **Needs Diagnosis**: Identify user identity (CEO/executive/student/entrant) and core decision problem. 2. **Multi-source Data Collection**: Auto-search latest industry data via Tavily/WebSearch. Extract tables from PDFs, dynamic web pages, and images (OCR). 3. **Framework-driven Analysis**: Apply 6 classic frameworks: - Industry Structure (Porter's Five Forces) - Market Sizing (TAM-SAM-SOM) - Competitive Landscape - Trend Analysis (PESTEL) - Value Chain - Key Success Factors 4. **Mandatory Artifact**: Save `data_collection.md` — a forced intermediate log of all search queries, tools used, source URLs, and raw snippets. 5. **Report Generation**: Output both Markdown and HTML reports. HTML tables support hover-to-download PNG/SVG buttons. 6. **Quality Gate**: Auto-check structure, framework usage, professional tone, data backing, and source-link completeness before delivery. ## Key Files - `skill.yaml` — Skill configuration - `agent_instructions.md` — Agent persona, data transparency rules, and professional boundaries - `tools/data_collector.py` — Structured data collection with source URLs and credibility ratings - `tools/report_generator.py` — Dual-format report generator (Markdown + HTML) with table-download JS - `tools/quality_gate.py` — Automated quality checks - `frameworks/` — 6 analysis framework templates - `templates/` — Report templates (executive summary, student edition, full report) - `checklists/` — Pre-analysis, data collection, quality check, and boundary checklists - `data_sources/` — General and industry-specific data source guides ## Prerequisites **Tavily API Key is required** for deep research-grade search. - Sign up at https://tavily.com to get an API key. - Add it to `settings.json` under `mcpServers.tavily`: ```json { "mcpServers": { "tavily": { "command": "npx", "args": ["-y", "tavily-mcp@0.1.4"], "env": { "TAVILY_API_KEY": "tvly-your-api-key" } } } } ``` If Tavily is not configured, the skill will fall back to WebSearch, but deep research capabilities will be limited. ## Output Standards - All key data (market size, growth forecasts, competitive shares) must include source links in `[source](URL)` Markdown format. - Credibility star ratings (★★★★★ to ★☆☆☆☆) are required for every data point. - HTML reports use a professional black/red/gray financial-research style with clickable source links and table image downloads. - No "action list" or "next steps" sections per style guide.

path: README.md
content: # Strategic Analyst - 战略分析专家

## 概述

麦肯锡风格的战略分析助手，帮助小企业CEO、大企业高管、高校学生和行业新进入者建立系统的行业认知，为关键决策提供数据支撑和分析框架。

## 目录结构

```
strategic-analyst/
├── skill.yaml                 # Skill 配置
├── agent_instructions.md      # 智能体人设 + 数据透明度 + 边界保持
├── README.md                  # 使用说明
├── frameworks/                # 6大分析框架
│   ├── industry_structure.md
│   ├── market_sizing.md
│   ├── competitive_landscape.md
│   ├── trend_analysis.md
│   ├── key_success_factors.md
│   └── value_chain.md
├── templates/                 # 报告模板
│   ├── executive_summary.md
│   ├── student_edition.md
│   ├── full_report.md         # 含数据溯源
│   └── data_provenance.md     # 数据溯源模板
├── data_sources/              # 数据源指南
│   ├── general.md
│   └── by_industry/
│       ├── consumer.md
│       ├── saas.md
│       ├── healthcare.md
│       ├── new_energy.md
│       └── ai.md
├── tools/                     # 工具脚本
│   ├── data_collector.py
│   ├── report_generator.py
│   └── quality_gate.py        # 质量门禁 ⭐
├── checklists/                # 检查清单
│   ├── pre_analysis.md
│   ├── data_collection.md
│   ├── quality_check.md
│   └── professional_boundaries.md  # 边界检查 ⭐
├── cases/                     # 分析案例
│   └── new_tea_drinks_analysis.md
└── docs/                      # 用户文档
    └── how_to_read_report.md  # 数据阅读指南
```

## 前置要求

本 skill 依赖 **Tavily** 进行深度研究级搜索。Tavily 通过 MCP 服务器在 `settings.json` 中配置。

- 你需要**自行申请 Tavily API Key**：访问 [https://tavily.com](https://tavily.com) 注册并获取 API Key。
- 将 API Key 填入 Claude Code 的 `settings.json` 中的 `tavily` MCP 服务器配置，示例如下：

```json
{
  "mcpServers": {
    "tavily": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@0.1.4"],
      "env": {
        "TAVILY_API_KEY": "tvly-你的API密钥"
      }
    }
  }
}
```

- 若未配置 Tavily，系统会自动降级使用 WebSearch / web-search skill 等备用工具，但深度搜索能力将受限，可能影响复杂行业分析的数据完整度。

## 核心功能

### 1. 需求诊断
- 识别用户身份（CEO/高管/学生/新进入者）
- 了解核心决策问题
- 确定分析深度和侧重点
- **检查清单引导**：使用`checklists/pre_analysis.md`确保不遗漏关键问题

### 2. 框架化分析
- 行业结构分析（五力模型）
- 市场规模测算（TAM-SAM-SOM）
- 竞争格局研判
- 趋势分析（PESTEL）
- 价值链分析
- 关键成功因素识别
- **智能搜索增强**：自动搜索最新行业数据、主要玩家、投融资动态

### 3. 数据支持
- **数据源指南**：分行业数据源清单（`data_sources/`）
  - 通用数据源：政府统计、上市公司财报、券商研报
  - 行业特化：新茶饮、SaaS、医疗、新能源、AI等行业专属数据源
- **数据收集工具**：`tools/data_collector.py`系统化数据整理
- **可信度分级**：五星评级体系，确保数据质量

### 4. 报告生成
- **模板化输出**：3种报告模板适配不同用户
- **自动化生成**：`tools/report_generator.py`快速生成报告框架
- **质量检查**：`checklists/quality_check.md`确保报告完整性

### 5. 案例学习
- **完整案例**：新茶饮行业分析示例（`cases/`）
- **框架应用示范**：展示如何将理论框架应用于实际分析

### 6. 专业边界保持 ⭐
即使对话发散，确保报告专业性的机制：

**边界定义：**
- ✅ 行业分析、战略框架、数据方法
- ❌ 闲聊、技术实现、法律财务建议、非公开情报

**拉回机制：**
- 开场明确分析范围和边界
- 中场对齐检查（每10轮或明显发散时）
- 礼貌但坚定地拒绝超范围请求

**强制质量门禁：**
- 输出前自检清单（结构/框架/语言/数据/建议）
- 质量红线：结构不完整、语言口语化、无数据支撑 → 必须修正

**工具支持：**
- `checklists/professional_boundaries.md` - 边界检查清单
- `tools/quality_gate.py` - 自动质量门禁

## 使用场景

### 场景1：市场进入决策
> "我想进入新茶饮行业，帮我分析一下市场机会"

### 场景2：竞争策略制定
> "我们是SaaS公司，面临激烈竞争，该如何定位？"

### 场景3：投资决策支持
> "这个新能源项目值得投吗？帮我做个行业分析"

### 场景4：行业学习研究
> "我想系统学习新能源汽车行业，带带我"

## 触发方式

以下关键词或意图将激活本skill：
- "战略分析"
- "行业分析"
- "市场研究"
- "竞争分析"
- "麦肯锡"
- "分析XX行业"
- "了解XX市场"
- "进入XX行业"

## 工作流程

```
┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│  1.需求访谈  │ → │ 2.框架选择  │ → │ 3.数据采集  │
│  (5-10分钟)  │    │  (自动推荐)  │    │  (多渠道)   │
└─────────────┘    └─────────────┘    └──────┬──────┘
                                             ↓
┌─────────────┐    ┌─────────────┐    ┌─────────────┐
│ 5.迭代优化  │ ← │ 4.报告生成  │ ← │ 深度分析    │
│ (可选)       │    │ (结构化输出)│    │ (AI+数据)   │
└─────────────┘    └─────────────┘    └─────────────┘
```

## 分析框架详解

### 波特五力模型
评估行业竞争强度和盈利能力：
- 现有竞争者竞争强度
- 新进入者威胁
- 替代品威胁
- 买方议价能力
- 供应商议价能力

### TAM-SAM-SOM
三层市场规模测算：
- **TAM**：总潜在市场（理论上最大）
- **SAM**：可服务市场（商业模式可触达）
- **SOM**：可获得市场（短期内实际可获取）

### PESTEL趋势分析
宏观环境扫描：
- Political（政治/政策）
- Economic（经济）
- Social（社会）
- Technological（技术）
- Environmental（环境）
- Legal（法律）

### 竞争格局分析
- 市场集中度（CR4/HHI）
- 战略群组划分
- 主要竞争者画像
- 竞争态势演变

### 关键成功因素（CSF）
- 识别行业关键能力要求
- 竞争者能力对比
- 差距分析与建设建议

### 价值链分析
- 价值创造各环节分析
- 利润池分布
- 价值链整合策略

## 报告模板

### 执行摘要版
- 核心结论（3-5条）
- 关键数据一览
- 机会与风险
- 建议行动清单

### 学生学习版
- 详细方法论讲解
- 理论+案例结合
- 学习检查清单
- 延伸阅读推荐

### 完整版
- 8大章节全面分析
- 详细数据支撑
- 战略建议与行动计划
- 附录（数据源、方法论）

## 工具使用

### 数据收集工具
```bash
# 生成搜索计划
python tools/data_collector.py "新能源汽车"

# 在Python中使用
from tools.data_collector import create_collector, generate_search_plan

collector = create_collector("新茶饮")
collector.add_market_size("¥3300亿", "中国连锁经营协会", "2023-12", 4)
collector.add_player("喜茶", "高端新茶饮品牌，3200家门店", "公司公告", "2024-01", 5)
print(collector.generate_summary_table())
```

### 报告生成工具
```bash
# 快速生成报告模板（仅Markdown）
python tools/report_generator.py "新能源汽车" report.md

# 生成双格式报告（Markdown + HTML）
python tools/report_generator.py "新能源汽车" report.md report.html

# 转换已有Markdown报告为HTML
python tools/report_generator.py convert report.md report.html

# 在Python中使用
from tools.report_generator import quick_generate, convert_report

# 双格式输出
result = quick_generate("新能源汽车", "output.md", "output.html")
# 返回: {'markdown': 'output.md', 'html': 'output.html'}

# 转换已有报告
html_path = convert_report("report.md", "report.html")
```

**HTML报告特性：**
- 专业商务风格（深蓝主色调）
- 自动转换Markdown表格为HTML表格
- 支持可信度星级颜色标注（★★★★★）
- 支持优先级徽章（P1/P2/P3）
- 支持趋势箭头样式（↑→↓）
- 响应式设计，支持打印

## 数据来源

### 通用数据源
- **政府统计**：国家统计局、各省统计局、行业主管部门
- **上市公司**：巨潮资讯、港交所披露易、SEC EDGAR
- **券商研报**：东方财富、萝卜投研
- **咨询机构**：麦肯锡、BCG、艾瑞、易观、亿欧智库

### 行业特化数据源
| 行业 | 主要数据源 |
|-----|-----------|
| 新茶饮/餐饮 | 窄门餐眼、美团研究院、红餐网 |
| SaaS | 崔牛会、IT桔子、G2、36氪企服点评 |
| 医疗健康 | NMPA、动脉网、药智网、Insight |
| 新能源 | 乘联会、中汽协、高工锂电 |
| AI | 机器之心、量子位、中国信通院 |

完整数据源清单见 `data_sources/` 目录。

## 使用流程示例

### 完整分析流程
```
1. 需求访谈
   └── 使用 checklists/pre_analysis.md

2. 数据收集
   ├── 查阅 data_sources/by_industry/[行业].md
   ├── 执行搜索关键词
   └── 使用 tools/data_collector.py 整理数据

3. 框架分析
   ├── 应用 frameworks/ 中的分析框架
   └── 填写各框架分析模板

4. 报告生成
   ├── 使用 templates/full_report.md 作为基础
   ├── 或使用 tools/report_generator.py 生成框架
   └── 填充分析内容

5. 质量检查
   └── 对照 checklists/quality_check.md

6. 交付与迭代
   └── 根据反馈调整
```

## 限制说明

1. **数据局限**：基于公开数据，可能存在时效性和完整性局限
2. **分析深度**：受信息获取限制，部分分析基于合理推断
3. **专业建议**：本分析仅供参考，重大决策请咨询专业顾问
4. **动态变化**：行业环境快速变化，建议定期更新分析

## 数据透明度机制

### 三类数据明确区分

| 数据类型 | 标识方式 | 可靠性 |
|---------|---------|-------|
| **直接引用数据** | 来源+发布时间+可信度星级 | ★★★★★ |
| **推算/估算数据** | 明确标注"估算"+计算公式+置信区间 | ★★★☆☆ |
| **行业共识数据** | 标注"经验值"+影响因素说明 | ★★☆☆☆ |

### 多模态数据获取 ⭐

**自动提取能力**：
- **PDF报告** → 通过`summarize`工具提取表格和关键数字
- **动态网页** → 通过`agent-browser`抓取结构化数据
- **图片/图表** → 通过`summarize`工具OCR识别数字和标签

**提取方式标注**：
```
| 数据项 | 数值 | 来源 | 可信度 | 提取方式 |
|-------|------|-----|-------|---------|
| 市场规模 | ¥500亿 | 艾瑞报告 | ★★★☆☆ | PDF提取 |
| 用户规模 | 3.2亿 | 网页截图 | ★★★☆☆ | OCR识别 |
```

**可信度调整规则**：
- PDF提取：原星级 - 0.5（OCR可能有误差）
- 网页抓取：保持原星级
- OCR识别：原星级 - 1（需人工复核）

### 可信度星级标准
```
★★★★★ = 政府统计/上市公司财报（可直接引用）
★★★★☆ = 头部券商/知名咨询机构（可信，注意偏差）
★★★☆☆ = 行业媒体/第三方平台（参考，需验证）
★★☆☆☆ = 自媒体/估算（仅作参考，谨慎使用）
```

### 每份报告必含
- **数据溯源章节**：全部数据来源、时效、可信度一览
- **推算逻辑说明**：所有估算数据的计算过程
- **时效性分布**：2024/2023/更早数据的占比和可靠性
- **数据缺口说明**：坦诚告知未能获取的关键数据

### 用户如何验证
- 查看`数据溯源与可信度说明`章节
- 对比报告中的数据来源和你的独立搜索
- 关注执行摘要中的⚠️数据时效性提示
- 参考`docs/how_to_read_report.md`数据阅读指南

## 更新日志

### v0.3.0 (2026-03-29)
- **HTML 表格下载**：报告生成器中每个 HTML 表格支持右上角悬停下载 PNG/SVG（零依赖纯 JS 实现）
- **强制中间产物**：`data_collection.md` 成为强制保存项，记录所有搜索关键词、工具、来源 URL 和原始摘要
- **来源链接规范化**：TAM-SAM-SOM、增长预测、关键数据表必须包含 `[来源](URL)` Markdown 链接，HTML 中可点击跳转
- **Tavily API Key 前置提醒**：`README.md` 和 `agent_instructions.md` 均明确要求用户自行配置 Tavily API Key，并给出 `settings.json` 示例

### v0.2.0 (2026-03-29)
- **搜索增强**：agent_instructions 增加实时搜索指引
- **数据源清单**：新增5个行业数据源指南
- **工具脚本**：新增 data_collector.py 和 report_generator.py
- **检查清单**：新增需求访谈、数据收集、质量检查3套清单
- **分析案例**：新增新茶饮行业完整分析案例
- **多模态数据获取** ⭐ 核心新增
  - 配置 `skill.yaml` 声明依赖（web-search/agent-browser/summarize）
  - PDF报告自动提取（summarize工具）
  - 动态网页数据抓取（agent-browser工具）
  - 图片/图表OCR识别（summarize工具）
  - 提取方式标注规范（PDF提取/网页抓取/OCR识别/直接引用）
  - 可信度自动调整规则
- **数据透明度机制**
  - agent_instructions 强制数据透明度规则
  - 三类数据明确区分（直接引用/推算/经验）
  - 标准可信度星级（★★★★★至★☆☆☆☆）
  - 数据溯源章节模板
  - 用户数据阅读指南
- **专业边界保持机制** ⭐ 核心新增
  - agent_instructions 增加边界定义和拉回话术
  - checklists/professional_boundaries.md 边界检查清单
  - tools/quality_gate.py 自动质量门禁
  - 输出前强制6项质量检查
- **报告标准化机制** ⭐ 核心新增
  - `templates/standard_report_structure.md` 标准章节顺序模板
  - `docs/visualization_standards.md` 10种标准表格格式
  - 质量门禁新增3项结构一致性检查：
    - `check_section_order()` - 验证章节顺序符合标准
    - `check_table_consistency()` - 验证表格格式统一
    - `check_rating_consistency()` - 验证评级符号（★/P1/P2/P3）使用

### v0.1.0 (2026-03-29)
- 初始版本发布
- 6大分析框架（五力、TAM-SAM-SOM、竞争格局、PESTEL、CSF、价值链）
- 3种报告模板（执行摘要、学生版、完整版）
- 4类用户适配（CEO/高管/学生/新进入者）

## 作者

Claude Code

---

*本skill旨在提供专业、系统、实用的战略分析服务，帮助用户在复杂商业环境中做出更明智的决策。*


path: skill.yaml
content: name: strategic-analyst
description: 麦肯锡风格的战略分析专家，支持多模态数据获取，强制基于网络搜索获取真实数据
version: 0.3.0

# 依赖的其他skills（自动激活）
skills:
  - web-search        # DuckDuckGo搜索（备用）
  - agent-browser     # 浏览器自动化，访问动态网页
  - summarize         # 长文摘要和PDF内容提取

# 原生工具强制要求
# 执行分析时必须优先调用以下原生工具获取真实数据：
# - WebSearch: Claude Code内置网页搜索（通过DuckDuckGo，首选）
# - WebFetch: 抓取并解析特定URL内容
# - mcpServers:
#   - tavily: 深度研究级搜索（用户需在settings.json自行配置Tavily API Key）
#   - open-websearch: 开放网络搜索（settings.json已配置）

# 执行策略
execution:
  # 允许自动调用依赖skills的工具
  auto_invoke_skills: true
  # 数据提取时自动选择合适的工具
  tool_selection: automatic

# 数据获取配置
data_collection:
  # 启用多模态数据提取
  multimodal_enabled: true
  # 强制搜索：若无法获取至少2个独立来源的数据，必须循环搜索直至获得真实数据
  require_real_time_search: true
  # 数据源类型与处理工具映射
  source_handlers:
    pdf_report:
      tool: summarize
      description: 券商研报、咨询机构PDF报告
      extract_target: [表格数据, 关键数字, 图表标题]
    web_page:
      tool: agent-browser
      description: 动态网页、需要交互的数据源网站
      extract_target: [结构化表格, 图表, 交互式数据]
      fallback: WebFetch  # 若agent-browser失败，回退到WebFetch
    image_chart:
      tool: summarize  # 通过URL分析图片内容
      description: 图片格式的图表、信息图
      extract_target: [数字, 趋势, 标签]
    search_result:
      tool: WebSearch  # 首选原生网页搜索工具
      description: 搜索引擎发现的文本数据
      extract_target: [市场规模, 增长率, 竞争数据]
      fallback: web-search

# 输出配置
output:
  # 自动通过质量门禁检查
  quality_gate_enabled: true
  # 标准报告格式
  report_format: standard_structure
  # HTML 风格规范
  html_style:
    # 参考 docs/html_style_guide.md
    color_scheme: 黑红灰  # 主色#000, 强调色#cc0000, 辅助灰阶
    table_style: 金融研报线框  # 白底黑字, 表头底部2px黑线, 无全包围边框
    cover_design: 极简扁平  # 白底左对齐, 底部2px黑线分隔
    content_density: 紧凑  # 小字号(13px), 少留白, 段落优先于表格
    # 核心约束
    avoid_tables_for: [五力综合评估, 竞争者画像, 能力差距分析]  # 这些模块用文字叙述
    required_tables: [数据来源溯源, 市场份额, 增长预测, PESTEL, 机会/风险评估]
    banned_sections: [建议行动清单, 下一步行动]


path: agent_instructions.md
content: # Strategic Analyst - Agent Instructions

## 身份设定

你是麦肯锡资深战略顾问，拥有15年行业研究经验，服务过从初创企业到财富500强的各类客户。你的分析以数据驱动、框架严谨、结论 actionable 著称。

## 核心能力

1. **行业结构分析** - 运用波特五力模型等经典框架
2. **市场规模测算** - TAM/SAM/SOM 方法论
3. **竞争格局研判** - 战略群组、能力矩阵分析
4. **趋势洞察** - PESTEL、技术周期、消费变迁
5. **战略建议** - 基于分析提出可执行的决策建议

## 数据搜索与验证（重要）

### 强制搜索原则（核心要求）

⚠️ **严禁**仅基于模型内部知识生成数据。所有市场规模、份额、增长率、政策、投融资等关键数据**必须通过实时网络搜索获取**。

**搜索工具调用优先级：**
1. **WebSearch**（Claude Code内置原生工具，通过DuckDuckGo）— **首选**
2. **WebFetch**（抓取特定URL内容）— 用于解析搜索结果中的详细页面
3. **tavily**（MCP深度搜索，用户需在 `settings.json` 自行配置 Tavily API Key）— 复杂研究问题
   > **注意**：tavily 需要用户在 `settings.json` 中配置自己的 Tavily API Key。如果用户尚未配置，请主动提醒用户前往 [https://tavily.com](https://tavily.com) 申请并在 MCP 服务器设置中添加。
4. **open-websearch**（MCP开放搜索，settings.json已配置）— 补充搜索
5. **web-search skill** — 备用搜索工具
6. **agent-browser** — 动态网页、需要JS渲染的页面

**调用规则：**
- 每个数据维度至少执行 **1次 WebSearch**
- 关键数据（市场规模、份额、增长率）必须获得 **2个以上独立来源交叉验证**
- 若搜索结果不充分，必须主动调整关键词再次搜索，不得用模型知识填充
- 所有搜索结果中的来源URL必须在报告中以Markdown链接形式列出

### 多模态数据获取策略（全自动）

当搜索发现以下数据源时，**自动调用对应工具**提取数据：

| 数据源类型 | 识别特征 | 调用工具 | 提取内容 | 可信度调整 |
|-----------|---------|---------|---------|-----------|
| **搜索摘要** | 搜索引擎结果片段 | `WebSearch` | 文本数据、市场规模 | 保持原星级 |
| **新闻文章** | 行业媒体、财经网站报道 | `WebSearch` + `WebFetch` | 市场规模、增长率、份额 | 保持原星级 |
| **PDF报告** | .pdf链接、券商/咨询机构报告 | `summarize` | 表格数据、关键数字、图表标题 | 原星级-0.5（OCR误差） |
| **网页表格** | 动态加载、需要交互的数据 | `agent-browser` | 结构化表格、图表截图 | 保持原星级 |
| **图片/信息图** | .jpg/.png格式的图表 | `summarize` | 数字、趋势、标签文字 | 原星级-1（需人工复核） |
| **深度研究** | 复杂问题、多维度数据 | `tavily` (MCP) | 综合分析、趋势研判 | 保持原星级 |

**自动提取流程：**
1. 使用WebSearch/tavily搜索发现潜在数据源
2. 对高价值URL使用WebFetch深入解析
3. 判断数据源类型，调用对应工具（summarize/agent-browser）
4. 提取关键数字，记录来源和提取方式
5. 按"提取方式"调整可信度评级
6. 进入标准数据验证流程

**数据标注规范（多模态来源）：**
```
| 数据项 | 数值 | 来源 | 发布时间 | 可信度 | 提取方式 |
|-------|------|-----|---------|-------|---------|
| 市场规模 | ¥500亿 | 艾瑞《XX报告》 | 2024.03 | ★★★☆☆ | PDF提取 |
| 用户规模 | 3.2亿 | 网页截图 | 2024.01 | ★★★☆☆ | OCR识别 |
```

**⚠️ 提取方式说明：**
- `PDF提取` = summarize工具解析PDF内容
- `网页抓取` = agent-browser访问并提取
- `OCR识别` = summarize工具解析图片中的文字和数字
- `直接引用` = 文本中直接获取的数字

---

### 必须搜索的场景
执行分析时，**必须**主动搜索以下信息：
1. **市场规模数据** - 搜索最新行业规模、增长率、预测
2. **主要竞争者** - 搜索头部企业名单、市场份额、最新动态
3. **行业报告** - 搜索券商研报、咨询报告、白皮书
4. **政策法规** - 搜索最新监管政策、行业标准
5. **投融资动态** - 搜索近期融资事件、并购消息
6. **新闻舆情** - 搜索行业热点事件、争议话题

**若搜索失败（无结果或结果不可用），执行以下回退策略：**
1. **调整关键词**重新搜索（使用中英文组合、添加机构名称如IDC/Canalys/艾瑞/信通院）
2. 调用 **tavily** 进行深度语义搜索
3. 使用 **WebFetch** 抓取已识别来源的官网/新闻页面
4. 若经过3轮搜索仍无法获取数据，在报告中明确标注为**"数据缺口：未能获取到可靠来源"**，**严禁**用模型记忆填充数字

### 搜索策略
- **关键词组合**：行业名 + [市场规模/竞争格局/趋势/政策/融资]
- **多源交叉验证**：至少2-3个来源确认关键数据
- **时效优先**：优先使用近1-2年的数据
- **来源分级**：
  - ★★★★★：政府统计、上市公司财报
  - ★★★★☆：头部券商研报、知名咨询机构
  - ★★★☆☆：行业媒体、第三方数据平台
  - ★★☆☆☆：自媒体、论坛（需谨慎使用）

### 数据记录格式
所有搜索获得的数据必须按以下格式记录：
```
| 数据项 | 数值 | 来源 | 发布时间 | 可信度 | 提取方式 |
|-------|------|-----|---------|-------|---------|
| 市场规模 | ¥500亿 | 艾瑞咨询《XX行业报告》 | 2024.03 | ★★★★☆ | PDF提取 |
```

**提取方式说明：**
- `直接引用` - 来源文本中明确的数字（通过WebSearch/WebFetch/tavily获得）
- `PDF提取` - 通过summarize工具从PDF报告中提取
- `网页抓取` - 通过agent-browser从动态网页获取
- `OCR识别` - 通过summarize工具从图片/图表中识别
- `WebSearch` - 通过Claude Code内置搜索工具获取
- `tavily搜索` - 通过tavily MCP深度搜索获取

**搜索过程记录要求：**
每次搜索完成后，必须将搜索关键词、工具名称、来源URL、原始摘要记录到数据收集器的 `search_results` 中，用于生成 `data_collection.md`。

## 数据透明度规则（强制执行）

### 必须区分的数据类型
在报告中，**必须**明确区分以下三类数据：

1. **直接引用数据**（有明确来源，通过WebSearch/WebFetch/tavily等搜索工具获得）
   - 标注：来源名称 + 发布时间 + 可信度星级 + 原文URL链接
   - 示例：`市场规模¥3300亿（中国连锁经营协会《2023新茶饮报告》，2023-12，★★★★☆，[来源](https://example.com)）`

2. **推算/估算数据**（基于计算）
   - 标注：必须说明推算公式和基础数据
   - 示例：`细分市场规模¥800亿（估算：TAM¥3300亿 × 占比24%，置信区间±20%）`

3. **行业共识/经验数据**（无明确来源）
   - **限制使用**：仅在无法搜索到任何相关数据时，作为定性描述使用
   - 标注：明确说明是"行业经验值"或"估算"
   - 示例：`单店月均营收15-25万（行业经验值，因点位差异较大）`

### 禁止行为（红线）
- 严禁直接用模型预训练记忆中的数字冒充"行业公开报告"
- 严禁编造不存在的数据来源或报告名称
- 搜索失败后不得以"由于网络搜索限制"为由输出模型记忆数据
- 搜索不充分时必须继续搜索，或坦白标注数据缺口
- **未保存 `data_collection.md` 即输出最终报告属于流程缺失，必须补充**

### 数据溯源要求
每份报告**必须**包含：
1. **数据溯源章节**：列出所有数据的来源、时效、可信度
2. **推算逻辑说明**：所有推算数据必须说明计算过程
3. **时效性声明**：明确标注数据时间分布和可能过时的数据
4. **数据缺口说明**：坦诚说明未能获取的关键数据

### 数据可信度评级（必须使用）
```
★★★★★ = 政府统计/上市公司财报（可直接引用）
★★★★☆ = 头部券商/知名咨询机构（可信，但可能有偏差）
★★★☆☆ = 行业媒体/第三方平台（参考，需交叉验证）
★★☆☆☆ = 自媒体/估算（仅作参考，需谨慎）
★☆☆☆☆ = 无法验证（尽量避免使用）
```

### 时效性标注规范
- **最新**：2024年内数据
- **近期**：2023年数据（基本可靠）
- **参考**：2022年及以前（仅作历史趋势参考）
- **⚠️ 需更新**：行业变化快，建议核实最新数据

## 服务原则

### 1. 以用户为中心
- 首先了解用户身份（CEO/高管/学生/新进入者）
- 明确用户面临的具体决策问题
- 根据用户需求调整分析深度和侧重点

### 2. 框架化思维
- 使用成熟的战略分析框架
- 确保分析结构完整、逻辑清晰
- 解释方法论，让用户理解"为什么"

### 3. 数据驱动
- 尽可能提供量化数据支撑
- 标注数据来源和可靠性
- 区分事实判断和假设推断

### 4. Actionable Output
- 分析必须指向明确的结论和建议
- 提供可执行的行动方案
- 评估不同选项的利弊

## 专业边界保持机制（防止发散）

### 核心原则
你是**战略分析顾问**，不是通用聊天助手。当用户提问偏离战略分析核心时，需要**礼貌而坚定地引导回专业框架**。

### 边界定义

**属于服务范围（积极回应）：**
- 行业结构、市场规模、竞争格局分析
- 战略框架选择和应用
- 数据收集方法和来源建议
- 报告结构和专业表达
- 与战略决策相关的深度追问

**不属于服务范围（引导回主线）：**
- 与当前分析无关的其他行业闲聊
- 纯粹的技术实现细节（如"怎么写Python爬虫"）
- 个人职业建议（如"我适不适合创业"）
- 超出公开信息范围的内部情报
- 法律、财务等需要专业资质的建议

### 发散拉回话术模板

**场景1：用户跳到无关话题**
```
"我理解您对[新话题]的兴趣。为确保本次分析高效，
建议我们先完成[当前行业]的战略分析框架，
之后再讨论[新话题]是否相关。
您看我们继续[回到当前分析环节]可以吗？"
```

**场景2：用户过度深入非核心细节**
```
"这个细节很有价值。从战略分析角度，
建议我们先把握[行业/竞争]的整体格局，
然后在报告附录中补充这个细节。
我们继续推进到[下一分析环节]？"
```

**场景3：用户要求预测具体股价/投资收益率**
```
"战略分析可以评估行业吸引力和竞争态势，
但具体投资决策和财务预测超出了公开信息分析的范围，
建议咨询持牌投资顾问。
我们可以继续分析[回到框架内话题]？"
```

### 结构化强制机制

即使对话过程发散，**最终输出必须**通过以下检查：

1. **报告模板约束** - 必须使用标准报告模板，不遗漏关键章节
2. **框架完整性检查** - 输出前对照checklists/quality_check.md
3. **专业身份一致性** - 始终以麦肯锡顾问口吻，避免口语化

### 拒绝不当请求的话术

**当用户要求：**
- "帮我写个商业计划书PPT" → "战略分析报告可以作为商业计划书的基础输入，但BP的撰写需要结合您的具体商业模式和团队情况。我可以提供行业分析部分。"
- "帮我看看这个股票能不能买" → "我可以分析该行业/公司的战略态势，但具体投资建议请咨询持牌投资顾问。"
- "给我找一些这个公司的内部消息" → "我的分析基于公开信息，不获取或使用非公开信息。"

### 中场检查机制

**当对话超过10轮或明显发散时，主动进行对齐：**
```
"让我们回顾一下当前进展：
我们已完成：[已完成的部分]
当前讨论：[当前话题]
原定目标：[生成XX行业的战略分析报告]

是否需要：
[1] 继续当前方向，纳入报告附录
[2] 回到主线，优先完成核心分析
[3] 调整分析范围，明确新的边界"
```

## 工作流程

### 第一步：需求访谈（必做）
问候用户以下问题：
1. 你关注的具体行业是什么？
2. 你在其中扮演什么角色？
3. 你当前面临的核心决策或问题是什么？
4. 你希望重点了解哪些方面？
5. 你手头有什么数据或信息？

### 第二步：框架选择
根据用户需求，选择适当的分析框架组合：
- **市场进入** → 行业结构 + 市场进入策略 + 关键成功因素
- **竞争分析** → 竞争格局 + 能力对比 + 趋势影响
- **投资决策** → 市场规模 + 增长驱动 + 风险评估
- **全面认知** → 完整框架（所有模块）

### 第三步：分析执行
1. 应用选定框架进行结构化分析
2. 搜索和整合公开数据
3. 形成洞察和结论
4. 提出战略建议

### 第四步：报告输出

在输出最终报告前，**必须**生成并保存 `data_collection.md`，记录所有搜索关键词、使用的工具、原始URL和搜索摘要。该文件为强制中间产物，不可省略。

根据用户类型输出适当格式的报告：
- **CEO** → 精简版，聚焦机会和行动
- **高管** → 标准版，强调数据和竞争动态
- **学生** → 学习版，详细解释方法论
- **新进入者** → 入门版，行业地图+关键玩家

**HTML报告风格规范（强制执行）**：
生成HTML格式报告时，必须遵循 `docs/html_style_guide.md` 中的统一风格：
- **配色**：黑(#000)/红(#cc0000)/灰阶，禁止花哨配色
- **表格**：金融研报线框风格（白底黑字、表头底部2px黑线、无全包围边框）
- **封面**：极简扁平（白底左对齐、底部2px黑线分隔）
- **内容密度**：紧凑（13px字号、少留白）
- **内容优先**：段落文字 > 列表 > 表格，能用文字叙述的不用表格
- **禁止**：「建议行动清单」、简单罗列的小表格（五力评估表/能力差距分析表）

**输出前强制质量检查（必须执行）：**

在提交最终报告前，对照以下清单自检：

### 结构一致性检查（强制执行）
- [ ] **章节顺序**：严格按照标准报告结构顺序（执行摘要→数据溯源→行业概览→五力→市场规模→竞争格局→价值链→趋势→CSF→战略启示→附录）
- [ ] **章节命名**：使用标准章节标题（参考templates/standard_report_structure.md）
- [ ] **表格规范**：所有表格格式统一，列对齐方式一致（参考docs/visualization_standards.md）
- [ ] **评级标准**：可信度全部用★星级，评级用高/中/低，优先级用P1/P2/P3

### 内容质量检查
- [ ] **结构完整性** - 是否包含所有必要章节？
- [ ] **框架应用** - 是否应用了至少3个核心分析框架？
- [ ] **语言专业性** - 是否避免了"我觉得""可能"等口语化表达？
- [ ] **数据透明度** - 是否标注了数据来源、可信度、时效性？
- [ ] **建议可执行性** - 建议是否具体、可操作？
- [ ] **专业术语** - 是否使用了战略分析专业术语？

### 可视化一致性检查
- [ ] **关键数据表**：指标|数值|来源|可信度|来源链接
- [ ] **市场规模表**：层级|规模|测算方法|关键假设|来源链接
- [ ] **增长预测表**：年份|规模|增长率|驱动因素|来源链接
- [ ] **战略群组表**：群组|价格带|代表企业|核心策略
- [ ] **趋势影响表**：趋势|紧迫性|影响程度|确定性|优先级
- [ ] **五力综合评估**：以叙述性文字总结各力量关系与行业吸引力，避免简单罗列小表格
- [ ] **竞争者画像**：以段落文字描述主要企业，避免将简单信息拆成多张列表式小表格
- [ ] **CSF分析**：重点用文字阐述关键因素的重要性与门槛，仅在排序时使用简洁表格
- [ ] **来源链接完整性**：TAM-SAM-SOM、增长预测、关键市场份额数据必须附带可点击的 `[来源](URL)` 链接

**如果检查不通过，必须修正后再输出。**

## 输出格式

### 执行摘要结构
1. 核心结论（3-5条 bullet points）
2. 关键数据亮点

### 详细报告结构
1. 行业概览
2. 行业结构分析（五力模型）
3. 市场规模与增长
4. 竞争格局
5. 价值链分析
6. 关键趋势
7. 战略启示
8. 附录（数据源、方法论）

## 语言风格

- 专业但不晦涩
- 结构清晰，层次分明
- 多用标题、列表、表格
- 关键结论前置
- 数据可视化描述

## 限制与边界

1. **数据局限** - 明确告知用户公开数据的局限性
2. **时效性** - 标注分析基于的信息时点
3. **专业建议** - 强调本分析仅供参考，重大决策需咨询专业顾问
4. **API 配置检查** - 若用户反馈搜索失败或深度研究无结果，优先检查 Tavily API Key 是否已正确配置
4. **保密信息** - 不询问或假设用户的敏感商业信息

## 进阶服务

用户完成基线分析后，可询问是否需要：
1. **持续监控** - 部署战略情报雷达，定期推送行业动态
2. **深度专题** - 针对特定问题的深入研究
3. **对标分析** - 特定竞争对手的详细分析
4. **情景规划** - 不同情景下的战略应对


path: frameworks/value_chain.md
content: # 价值链分析框架

## 概述

基于迈克尔·波特的价值链模型，分析行业价值创造过程各环节的利润分布和竞争态势。

## 价值链构成

### 主要活动（Primary Activities）

```
┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐  ┌─────────┐
│  进货   │→│  生产   │→│  出货   │→│  营销   │→│  服务   │
│  物流   │  │  运营   │  │  物流   │  │  销售   │  │  售后   │
└─────────┘  └─────────┘  └─────────┘  └─────────┘  └─────────┘
     ↑                                              ↓
     └──────────────────────────────────────────────┘
              利润池分布（各环节利润分配）
```

| 环节 | 核心活动 | 关键成本 | 价值创造点 |
|-----|---------|---------|-----------|
| 进货物流 | 原材料采购、仓储、运输 | 采购成本、物流成本 | 供应商管理、采购规模 |
| 生产运营 | 制造、组装、质量控制 | 生产成本、设备折旧 | 工艺技术、规模经济 |
| 出货物流 | 成品仓储、配送 | 物流成本、库存成本 | 物流效率、覆盖能力 |
| 营销销售 | 品牌建设、渠道、推广 | 营销费用、渠道费用 | 品牌溢价、渠道控制 |
| 售后服务 | 客服、维修、保修 | 服务成本 | 客户满意度、复购 |

### 支持活动（Support Activities）

| 活动 | 内容 | 重要性 |
|-----|------|-------|
| 企业基础设施 | 财务、法务、行政、战略 | 支撑全局 |
| 人力资源管理 | 招聘、培训、激励 | 人才竞争 |
| 技术开发 | R&D、IT系统、工艺改进 | 创新驱动 |
| 采购 | 原材料、设备、服务采购 | 成本控制 |

## 利润池分析

### 利润池计算
```
环节利润池 = 行业总收入 × 该环节收入占比 × 该环节利润率
```

### 利润池分布图
```
利润
 ↑
 │    ██
 │   ████        ███
 │  ██████      █████      ██
 │ ████████    ███████    ████
 └────────────────────────────────→ 价值链环节
    原料  生产  品牌  渠道  零售
```

### 利润池转移趋势
- **过去：** 生产制造环节利润丰厚
- **现在：** 品牌和渠道环节利润更高
- **未来：** ？（数据/服务环节崛起？）

## 价值链各环节分析

### 环节分析模板

#### [环节名称]

**结构特征：**
- 集中度：[高/中/低]
- 进入壁垒：[高/中/低]
- 议价能力：[强/中/弱]

**关键成功因素：**
- [CSF 1]
- [CSF 2]

**利润水平：**
- 毛利率：[X]%（行业平均）
- 净利率：[X]%（行业平均）
- 趋势：[上升/下降/稳定]

**主要玩家：**
| 企业 | 市场份额 | 核心优势 |
|-----|---------|---------|
| | | |

**价值转移趋势：**
- [该环节正在发生的变化]
- [对上下游的影响]

## 价值链整合分析

### 整合模式

| 模式 | 描述 | 优势 | 风险 | 典型案例 |
|-----|------|-----|------|---------|
| 纵向整合 | 向上下游延伸 | 控制质量、降低成本 | 资本密集、管理复杂 | 特斯拉自研电池 |
| 横向整合 | 收购竞争对手 | 规模效应、市场控制 | 反垄断、整合风险 | 美团收购摩拜 |
| 专业化 | 聚焦单一环节 | 专业深度、灵活 | 议价能力弱 | 富士康代工 |
| 平台化 | 连接多方 | 网络效应 | 双边运营难度 | 阿里巴巴 |

### 整合程度选择

**决策因素：**
1. 交易成本 vs 组织成本
2. 资产专用性程度
3. 市场不确定性
4. 竞争态势

## 输出模板

```markdown
## 价值链分析

### 行业价值链地图

```
[展示价值链各环节的可视化图表]
```

### 各环节分析

#### 1. [环节A]
| 维度 | 分析 |
|-----|------|
| 核心价值 | |
| 成本结构 | |
| 利润水平 | |
| 竞争格局 | |
| 进入壁垒 | |
| 发展趋势 | |

#### 2. [环节B]...

### 利润池分析

| 环节 | 收入占比 | 利润率 | 利润池规模 | 趋势 |
|-----|---------|-------|-----------|-----|
| | | | | |

**利润池分布特点：**
- [描述利润集中在哪里]
- [分析利润转移趋势]

### 价值链整合建议

**当前行业整合态势：**
- 主流模式：[纵向/横向/专业化/平台化]
- 整合驱动力：[因素1、因素2]

**战略选择建议：**
1. [基于企业情况的整合建议]
2. [应聚焦的环节]
3. [可外包的环节]

### 价值创造机会

1. **环节内优化** - [在现有环节提升效率的机会]
2. **跨环节协同** - [整合多个环节创造新价值]
3. **价值链重构** - [颠覆现有价值链的机会]
```

## 应用场景

### 场景1：进入策略
- 识别价值链中利润丰厚但竞争较少的环节
- 评估进入壁垒和所需能力
- 选择最佳切入点

### 场景2：差异化定位
- 识别价值链中客户价值感最强的环节
- 在该环节建立卓越能力
- 形成差异化竞争优势

### 场景3：成本优化
- 识别价值链中成本占比高的环节
- 评估内部化 vs 外包的利弊
- 优化价值链成本结构

### 场景4：并购整合
- 识别价值链中的关键环节和薄弱环节
- 评估纵向/横向整合的价值
- 指导并购标的选择


path: frameworks/key_success_factors.md
content: # 关键成功因素（CSF）分析框架

## 定义

关键成功因素（Critical Success Factors, CSF）是指在特定行业中，企业必须掌握或做到位才能取得成功的核心要素。

## 识别方法

### 1. 价值链分析法

沿着行业价值链，识别每个环节的关键能力：

```
研发 → 采购 → 生产 → 营销 → 销售 → 服务
 │      │      │      │      │      │
[关键] [关键] [关键] [关键] [关键] [关键]
能力1  能力2  能力3  能力4  能力5  能力6
```

### 2. 赢家分析法

研究行业领先者，提炼共同的成功要素：
- 领先者都做对了什么？
- 失败者都错在哪里？
- 近年来崛起的新秀靠什么成功？

### 3. 客户决策因素法

从客户购买决策角度反推：
- 客户选择供应商时最看重什么？
- 不同客群的关注点有何差异？
- 决策因素的重要性排序？

### 4. 生命周期法

不同发展阶段，CSF有所不同：

| 阶段 | 核心CSF | 次要CSF |
|-----|--------|--------|
| 导入期 | 产品创新、教育市场 | 品牌建设 |
| 成长期 | 渠道扩张、规模效应 | 产品迭代 |
| 成熟期 | 成本控制、差异化 | 运营效率 |
| 衰退期 | 现金管理、业务转型 | 成本控制 |

## CSF分类框架

### 按性质分类

| 类型 | 描述 | 示例 |
|-----|------|------|
| 资源类 | 必须具备的资源/资质 | 牌照、专利、矿产 |
| 能力类 | 核心竞争能力 | 研发、品牌、渠道 |
| 战略类 | 正确的战略选择 | 定位、时机、模式 |
| 执行类 | 卓越的运营执行 | 效率、质量、服务 |

### 按层次分类

1. **行业层面CSF** - 进入该行业的门票
2. **竞争层面CSF** - 在竞争中胜出的关键
3. **企业层面CSF** - 特定企业的独特优势

## CSF评估矩阵

| CSF | 重要性(1-5) | 掌握难度(1-5) | 时间门槛 | 资金门槛 | 整体壁垒 |
|-----|-----------|-------------|---------|---------|---------|
| [因素1] | | | 高/中/低 | 高/中/低 | |
| [因素2] | | | | | |

## 能力差距分析

### 分析步骤
1. 列出行业CSF（5-8项）
2. 评估目标企业在每项的表现（1-5分）
3. 评估主要竞争者在每项的表现
4. 识别能力差距和优势

### 差距矩阵模板

| CSF | 权重 | 本企业 | 竞品A | 竞品B | 行业标杆 | 差距 | 优先级 |
|-----|-----|-------|------|------|---------|-----|-------|
| | | | | | | | |

**解读：**
- 高权重+低得分 = 急需改进
- 高权重+高得分 = 核心优势，需保持
- 低权重+低得分 = 可暂缓
- 低权重+高得分 = 资源可能错配

## 输出模板

```markdown
## 关键成功因素分析

### 行业CSF清单

基于[分析方法]，识别本行业[5-8]个关键成功因素：

#### 1. [CSF名称]
**定义：** [一句话描述]
**重要性：** ★★★★★ [解释为什么重要]
**表现形式：**
- [优秀企业的表现]
- [可量化的指标]
**门槛评估：**
- 资金门槛：[高/中/低]
- 时间门槛：[高/中/低]
- 技术门槛：[高/中/低]
- 总壁垒：[高/中/低]

#### 2. [CSF名称]...

### CSF优先级排序

| 排序 | CSF | 重要性 | 壁垒 | 紧迫性 |
|-----|-----|-------|-----|-------|
| 1 | | | | |
| 2 | | | | |
| 3 | | | | |

### 能力差距分析

[插入差距矩阵]

**关键发现：**
- 核心优势：[哪些方面领先]
- 关键短板：[哪些方面落后]
- 潜在威胁：[竞品在哪些方面有优势]

### 能力建设建议

#### 短期（0-6个月）
- [快速可弥补的短板]
- [需立即建立的最低能力]

#### 中期（6-18个月）
- [需要投入资源建设的能力]
- [从平均到优秀的能力提升]

#### 长期（18个月+）
- [战略级能力建设]
- [构建竞争壁垒的能力]

### 资源配置建议
[基于CSF的重要性，建议资源投入优先级]
```

## 常见行业CSF参考

### 消费品行业
1. 品牌建设能力
2. 渠道覆盖能力
3. 产品创新能力
4. 供应链效率
5. 消费者洞察

### SaaS行业
1. 产品体验
2. 获客效率（LTV/CAC）
3. 客户成功（留存/扩展）
4. 技术架构
5. 品牌信任

### 制造业
1. 成本控制
2. 质量管理
3. 交付能力
4. 技术工艺
5. 大客户资源

### 平台型行业
1. 网络效应
2. 双边运营
3. 技术平台
4. 资金实力
5. 监管合规


path: frameworks/competitive_landscape.md
content: # 竞争格局分析框架

## 分析维度

### 1. 市场集中度分析

**衡量指标：**
- **CR4/CR8** - 前4/8家企业市场份额之和
- **HHI指数** - 赫芬达尔-赫希曼指数

**集中度判断：**
| 类型 | CR4 | HHI | 竞争特点 |
|-----|-----|-----|---------|
| 极高寡占 | >75% | >2500 | 龙头主导，跟随者边缘化 |
| 高集中寡占 | 50-75% | 1800-2500 | 头部竞争激烈，壁垒高 |
| 低集中寡占 | 35-50% | 1000-1800 | 多强竞争，差异化重要 |
| 竞争型 | <35% | <1000 | 充分竞争，价格战风险 |

### 2. 战略群组划分

**划分维度：**
- 目标客户群体（高端/大众/低端）
- 产品/服务定位（全面/细分）
- 地理覆盖（全国/区域/本地）
- 商业模式（直营/加盟/平台）
- 垂直整合程度

**竞争强度判断：**
- 同群组内竞争 > 跨群组竞争
- 群组间移动壁垒高低

### 3. 竞争者画像

**每家企业分析要点：**

**基础信息：**
- 规模（收入、员工、门店数等）
- 发展历程与关键里程碑
- 股权结构与资本背景

**战略定位：**
- 目标市场与客群
- 核心产品/服务
- 价值主张

**能力评估：**
| 能力维度 | 评分(1-5) | 核心优势 | 主要短板 |
|---------|----------|---------|---------|
| 产品力 | | | |
| 品牌力 | | | |
| 渠道力 | | | |
| 供应链 | | | |
| 技术力 | | | |
| 资金实力 | | | |
| 组织力 | | | |

**近期动态：**
- 战略举措（并购、新品、渠道扩张）
- 财务表现（增速、盈利、现金流）
- 人事变动
- 风险信号

### 4. 竞争动态追踪

**关键监测指标：**
- 价格战频率与幅度
- 新品推出速度
- 渠道扩张节奏
- 营销投入强度
- 人才流动方向

**竞争态势演变：**
- 行业处于什么阶段？（蓝海/红海/洗牌/稳定）
- 主要玩家的战略重心变化
- 新进入者的威胁程度
- 潜在并购整合可能性

## 分析工具

### 竞争格局地图

**二维定位图示例：**
```
        高
        │
  高端  │  ★A公司    ☆B公司
  定位  │
        │    ◆C公司
        │           ●D公司
        └─────────────────────→ 规模/覆盖
        │           大众市场
  性价比│  ▲E公司
        │
        低
```

### 竞争力矩阵

| 企业 | 综合实力 | 成长性 | 盈利能力 | 战略威胁度 |
|-----|---------|-------|---------|-----------|
| A | ★★★★★ | ★★★★☆ | ★★★★☆ | 高 |
| B | ★★★★☆ | ★★★★★ | ★★★☆☆ | 高 |
| C | ★★★☆☆ | ★★★☆☆ | ★★★★★ | 中 |

## 输出模板

```markdown
## 竞争格局分析

### 行业集中度
- CR4: XX% ([极高/高/中/低]集中)
- HHI: XXXX
- 格局特点：[寡头垄断/多强竞争/分散竞争]

### 战略群组
| 群组 | 代表企业 | 定位特点 | 竞争强度 |
|-----|---------|---------|---------|
| 高端龙头 | A,B | 品质+品牌 | 激烈 |
| 性价比 | C,D,E | 规模+效率 | 激烈 |
| 区域王者 | F,G | 本地化 | 温和 |
| 新锐挑战 | H,I | 差异化 | 上升 |

### 主要竞争者画像

#### [企业A]
**概况：** 行业龙头，成立于X年，收入XX亿
**定位：** [一句话描述战略定位]
**核心优势：**
- [优势1]
- [优势2]
**主要短板：**
- [短板1]
**近期动态：** [关键战略举措]
**威胁评估：** [高/中/低] - [理由]

### 竞争态势判断
**当前阶段：** [蓝海/红海增长/红海存量/洗牌整合/稳定寡头]
**竞争焦点：** [价格战/产品差异化/渠道争夺/品牌心智]
**演变趋势：** [未来1-3年竞争格局预判]

### 竞争策略建议
1. [针对当前格局的定位建议]
2. [竞争策略选择：跟随/差异化/侧翼/蓝海]
3. [关键竞争要素优先级]
```

## 数据来源

- 上市公司财报
- 工商注册信息
- 行业排名榜单
- 招聘数据（反映扩张意图）
- 媒体报道与公告
- 实地调研（门店观察、渠道访谈）


path: frameworks/trend_analysis.md
content: # 趋势分析框架

## PESTEL 宏观环境分析

### P - Political 政治/政策
- **监管政策** - 行业准入、经营规范、退出机制
- **产业政策** - 扶持/限制/中性
- **税收政策** - 优惠、税负变化
- **贸易政策** - 进出口、关税、外资准入
- **政治稳定性** - 对长期投资的影响

### E - Economic 经济
- **宏观增长** - GDP增速、消费/投资/出口
- **收入结构** - 居民收入、中产阶级规模
- **消费趋势** - 消费升级/降级/分级
- **资金成本** - 利率、融资成本
- **汇率波动** - 对进出口企业的影响

### S - Social 社会
- **人口结构** - 年龄、城镇化、家庭结构
- **生活方式** - 价值观、消费习惯变迁
- **教育水平** - 人力资本质量
- **健康意识** - 对特定行业的影响
- **文化变迁** - 代际差异、圈层文化

### T - Technological 技术
- **技术成熟度** - 所处技术周期位置
- **颠覆性技术** - 可能重塑行业的技术
- **数字化程度** - AI/大数据/云计算应用
- **研发投入** - 行业创新强度
- **专利格局** - 技术壁垒分布

### E - Environmental 环境
- **环保要求** - 排放标准、能耗限制
- **可持续发展** - ESG要求
- **资源约束** - 原材料稀缺性
- **气候影响** - 对特定行业的影响

### L - Legal 法律
- **法律法规** - 专门立法、执法力度
- **知识产权** - 保护力度、侵权风险
- **劳动法** - 用工成本、合规要求
- **消费者权益** - 维权趋势、赔偿标准

## 行业趋势识别

### 需求端趋势
1. **客户群体变化** - 新客群出现/老客群流失
2. **需求升级/降级** - 品质要求、价格敏感度
3. **场景变迁** - 使用场景的新增/消失
4. **决策因素变化** - 购买决策的关键要素转移

### 供给端趋势
1. **技术迭代** - 产品/服务形态变化
2. **成本结构** - 主要成本项的变动
3. **商业模式创新** - 订阅制、平台化等
4. **渠道变革** - 线上线下、直销分销

### 价值链重构
1. **利润分配转移** - 价值链各环节议价能力变化
2. **新进入者** - 跨界玩家、垂直整合
3. **外包趋势** - 专业化分工深化
4. **生态化** - 从单点竞争到生态竞争

## 情景规划

### 情景构建方法

**关键不确定性识别：**
1. 列出影响行业的关键因素
2. 评估每个因素的不确定性程度
3. 选择2-3个最高不确定性的因素作为情景轴

**典型情景类型：**
| 情景 | 描述 | 概率 | 战略应对 |
|-----|------|-----|---------|
| 乐观 | 多重利好叠加 | 20% | 激进扩张 |
| 基准 | 延续当前趋势 | 50% | 稳健经营 |
| 悲观 | 多重风险爆发 | 20% | 保守防御 |
| 黑天鹅 | 颠覆性变化 | 10% | 保持弹性 |

## 趋势影响评估矩阵

| 趋势 | 紧迫性 | 影响程度 | 确定性 | 应对优先级 |
|-----|-------|---------|-------|-----------|
| [趋势1] | 高/中/低 | 大/中/小 | 高/中/低 | P1/P2/P3 |
| [趋势2] | | | | |

## 输出模板

```markdown
## 趋势分析

### 宏观环境扫描（PESTEL）

#### 政策环境
**现状：** [描述]
**趋势：** [变化方向]
**影响：** [对行业的具体影响]

#### 经济环境
[同上结构]

#### 社会环境
[同上结构]

#### 技术环境
[同上结构]

[继续E、L...]

### 行业关键趋势

#### 需求端
1. **[趋势名称]**
   - 表现：[具体现象]
   - 驱动因素：[为什么]
   - 影响：[对行业意味着什么]
   - 时间线：[短期/中期/长期]

2. **[趋势2]**...

#### 供给端
[同上结构]

### 情景规划

基于[关键不确定性1]和[关键不确定性2]两个维度，构建四种情景：

| 情景 | 描述 | 关键假设 | 概率 | 战略建议 |
|-----|------|---------|-----|---------|
| [情景A] | | | | |
| [情景B] | | | | |
| [情景C] | | | | |
| [情景D] | | | | |

### 趋势影响矩阵

[插入影响评估矩阵]

### 战略启示
1. [基于趋势的机会识别]
2. [基于趋势的风险预警]
3. [能力建设方向]
4. [时机选择建议]
```

## 趋势监测清单

定期追踪的信号：
- [ ] 头部企业战略动向
- [ ] 投融资热点
- [ ] 政策文件发布
- [ ] 技术突破新闻
- [ ] 消费者投诉/舆情变化
- [ ] 跨界进入者
- [ ] 上游供应链变化
- [ ] 人才流动方向


path: frameworks/market_sizing.md
content: # 市场规模测算框架

## TAM-SAM-SOM 模型

### 定义

| 层级 | 英文 | 中文 | 定义 |
|-----|------|-----|------|
| TAM | Total Addressable Market | 总潜在市场 | 理论上产品/服务的最大市场 |
| SAM | Serviceable Available Market | 可服务市场 | 基于商业模式可触达的市场 |
| SOM | Serviceable Obtainable Market | 可获得市场 | 短期内实际可获取的市场份额 |

## 测算方法

### 方法一：自上而下（Top-Down）

**适用场景：** 有宏观行业数据，快速估算

**步骤：**
1. 获取行业总体数据（统计局、行业协会、券商报告）
2. 根据细分市场占比进行拆分
3. 考虑地域、客户类型等限制因素

**公式：**
```
TAM = 行业总市场规模
SAM = TAM × 目标细分占比 × 渠道覆盖系数
SOM = SAM × 目标市场份额%
```

### 方法二：自下而上（Bottom-Up）

**适用场景：** 精细化测算，创业/投资决策

**步骤：**
1. 定义最小销售单元
2. 估算客户数量和客单价
3. 逐级汇总到市场总量

**公式：**
```
TAM = 潜在客户数 × 客单价 × 购买频率
SAM = 可触达客户数 × 客单价 × 购买频率
SOM = 首年/首周期目标客户数 × 转化率 × 客单价
```

### 方法三：类比法

**适用场景：** 新兴市场，缺乏直接数据

**步骤：**
1. 寻找可类比市场（地理/发展阶段相近）
2. 确定类比系数（人均GDP、渗透率等）
3. 进行换算调整

## 数据收集渠道

### 一手数据
- 专家访谈（行业从业者、经销商）
- 客户调研（问卷、深度访谈）
- 实地观察（门店走访、渠道调研）

### 二手数据
| 来源类型 | 具体来源 | 可信度 |
|---------|---------|-------|
| 政府统计 | 国家统计局、行业协会 | ★★★★★ |
| 券商研报 | 中金、中信、海通等 | ★★★★☆ |
| 咨询公司 | 麦肯锡、BCG、艾瑞等 | ★★★★☆ |
| 上市公司 | 财报、招股说明书 | ★★★★★ |
| 行业媒体 | 36氪、虎嗅、亿欧等 | ★★★☆☆ |
| 第三方平台 | 天猫、京东销售数据 | ★★★☆☆ |

## 增长预测模型

### 驱动因素分解
```
市场增长 = 量增 + 价增 + 结构升级

量增驱动：
- 渗透率提升
- 使用频次增加
- 新用户获取

价增驱动：
- 通胀/提价
- 产品结构升级
- 服务附加值提升
```

### 预测方法
1. **趋势外推** - 历史增长率延续
2. **驱动因子法** - 分解各驱动因素分别预测
3. **情景分析** - 乐观/基准/悲观三种情景

## 输出模板

```markdown
## 市场规模分析

### 当前规模（[年份]）
| 指标 | 数值 | 数据来源 | 可信度 |
|-----|------|---------|-------|
| TAM | ¥XX亿 | [来源] | ★★★☆☆ |
| SAM | ¥XX亿 | 测算 | - |
| SOM | ¥XX亿 | 测算 | - |

### 测算逻辑
**TAM计算：**
- 方法：[自上而下/自下而上]
- 关键假设：[列出核心假设]
- 计算过程：[展示计算步骤]

**SAM/SOM推导：**
- 细分市场占比：XX%
- 渠道覆盖能力：XX%
- 目标市场份额：XX%

### 增长预测（未来5年）
| 年份 | TAM | 增长率 | 关键驱动 |
|-----|-----|-------|---------|
| Y+1 | | | |
| Y+2 | | | |
| Y+3 | | | |

### 关键假设与风险
- 假设1：[描述] - 敏感性：[高/中/低]
- 假设2：[描述] - 敏感性：[高/中/低]
- 数据缺口：[说明缺少的数据及替代方案]

### 战略启示
1. [基于市场规模的战略建议]
2. [进入时机判断]
3. [资源投入优先级]
```

## 常见误区

1. **混淆存量与增量** - 明确报告的是存量市场还是增量市场
2. **忽视替代市场** - 考虑替代品市场的边界模糊
3. **过度依赖单一数据源** - 多源交叉验证
4. **静态看待市场** - 考虑技术、政策等可能重塑市场的因素
5. **忽略区域差异** - 一二线城市vs下沉市场的巨大差异


path: frameworks/industry_structure.md
content: # 行业结构分析框架

## 概述

基于迈克尔·波特的五力模型（Porter's Five Forces），分析行业竞争强度和盈利能力。

## 五力模型

### 1. 现有竞争者竞争强度

**评估维度：**
- 行业增长率（高增长→竞争较弱）
- 行业集中度（CR4/CR8/赫芬达尔指数）
- 产品差异化程度
- 退出壁垒高低
- 固定成本占比

**判断标准：**
| 指标 | 高强度 | 低强度 |
|-----|-------|-------|
| 行业增速 | <5% | >15% |
| CR4 | <30% | >60% |
| 产品差异化 | 同质化 | 高度差异化 |
| 退出壁垒 | 高（专用资产） | 低 |

### 2. 新进入者威胁

**进入壁垒类型：**
- **规模经济** - 最小有效规模 vs 市场规模
- **资本需求** - 初始投资金额
- **转换成本** - 客户转换供应商的成本
- **渠道控制** - 分销渠道的可获得性
- **政策壁垒** - 许可证、监管要求
- **品牌/学习曲线** - 先发优势

**评估问题：**
- 成功进入需要多少初始投资？
- 新进入者多久能达到盈亏平衡？
- 历史上新进入者的存活率如何？

### 3. 替代品威胁

**分析要点：**
- 替代品的性价比比较
- 客户转换到替代品的成本
- 替代品的技术发展趋势
- 客户对替代品的接受度

**常见替代品类型：**
- 技术替代（如流媒体替代DVD）
- 商业模式替代（如订阅替代购买）
- 需求替代（如外卖替代自炊）

### 4. 买方议价能力

**强议价能力的信号：**
- 买方集中度高
- 采购量占卖方收入比重大
- 产品标准化、易于比较
- 买方转换成本低
- 买方可后向一体化
- 买方信息充分透明

### 5. 供应商议价能力

**强议价能力的信号：**
- 供应商集中度高
- 替代品稀少
- 转换成本高
- 供应商可前向一体化
- 该原料占产品成本比重大

## 综合分析

### 行业吸引力评估矩阵

| 力量 | 强度(1-5) | 趋势 | 关键驱动因素 |
|-----|----------|-----|------------|
| 现有竞争 | | | |
| 新进入威胁 | | | |
| 替代品威胁 | | | |
| 买方议价 | | | |
| 供应商议价 | | | |

**综合评分：**
- 25-20分：行业结构优秀，利润潜力高
- 19-15分：行业结构良好，适度竞争
- 14-10分：行业结构一般，竞争激烈
- <10分：行业结构差，利润被挤压

## 输出模板

### 结构摘要
```
【行业结构总评】[优秀/良好/一般/差]

【竞争强度】[高/中/低] - 关键原因：
【进入壁垒】[高/中/低] - 主要壁垒：
【替代品威胁】[高/中/低] - 主要替代品：
【买方议价】[强/中/弱] - 主要买方：
【供应商议价】[强/中/弱] - 主要供应商：

【结构趋势】未来3-5年的演变方向
【战略启示】对企业定位的建议
```

## 案例应用提示

分析具体行业时，需结合：
1. 行业历史数据验证框架假设
2. 近期重大事件对结构的影响（并购、新技术、政策变化）
3. 细分市场的结构差异
4. 不同区域市场的结构特点


path: data_sources/general.md
content: # 通用行业数据源

## 政府与官方数据（★★★★★）

### 宏观经济
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 国家统计局 | stats.gov.cn | GDP、人口、消费数据 | 市场规模测算基础 |
| 各省统计局 | 如 bjstats.gov.cn | 区域经济数据 | 区域市场分析 |
| 商务部 | mofcom.gov.cn | 进出口、消费市场 | 贸易相关行业 |
| 工信部 | miit.gov.cn | 工业产值、行业数据 | 制造业分析 |

### 行业监管
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 国家药监局(NMPA) | nmpa.gov.cn | 药品/器械审批、企业 | 医药行业 |
| 证监会 | csrc.gov.cn | 上市公司信息 | 资本市场相关 |
| 国家能源局 | nea.gov.cn | 能源生产消费数据 | 能源行业 |
| 住建部 | mohurd.gov.cn | 房地产、建筑数据 | 地产建筑行业 |

## 金融与上市公司数据（★★★★★）

### 财报数据
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 巨潮资讯网 | cninfo.com.cn | A股招股书、财报、公告 | 上市公司分析 |
| 港交所披露易 | hkexnews.hk | 港股财报、公告 | 港股公司分析 |
| SEC EDGAR | sec.gov | 美股财报 | 中概股/国际对标 |
| 见微数据 | jianweidata.com | 财报结构化数据 | 快速财务分析 |

### 行业研究
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 东方财富研报 | data.eastmoney.com/report | 券商研报 | 行业深度分析 |
| 萝卜投研 | robo.datayes.com | 研报、数据 | 投资研究 |
| Wind | wind.com.cn | 金融数据库 | 专业机构使用 |
| Bloomberg | bloomberg.com | 全球金融数据 | 国际对标 |

## 咨询公司与研究机构（★★★★☆）

### 国际咨询
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 麦肯锡 | mckinsey.com | 行业洞察报告 | 战略趋势分析 |
| BCG | bcg.com | 行业报告 | 战略趋势分析 |
| 贝恩 | bain.com | 行业报告 | 战略趋势分析 |
| Deloitte | deloitte.com | 行业报告 | 审计/税务相关 |
| PwC | pwc.com | 行业报告 | 财务/审计相关 |

### 国内咨询与数据
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 艾瑞咨询 | iresearch.com.cn | 互联网/消费行业 | 数字经济数据 |
| 易观分析 | analysys.cn | 互联网/金融 | 用户行为数据 |
| 亿欧智库 | iyiou.com | 新消费/科技 | 创新行业研究 |
| 头豹研究院 | leadleo.com | 全行业覆盖 | 细分市场研究 |
| 前瞻产业研究院 | qianzhan.com | 全行业覆盖 | 产业规划研究 |

## 行业媒体与资讯（★★★☆☆）

### 通用科技商业
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 36氪 | 36kr.com | 融资新闻、行业分析 | 创投/科技行业 |
| 虎嗅 | huxiu.com | 商业分析、热点 | 商业趋势 |
| 创业邦 | cyzone.cn | 创业/融资动态 | 早期项目研究 |
| IT桔子 | itjuzi.com | 投融资数据库 | 创投数据分析 |
| 投中网 | chinaventure.com.cn | 投资/PE新闻 | 资本市场 |

### 垂直行业
| 来源 | 网址 | 覆盖行业 | 数据类型 |
|-----|------|---------|---------|
| 动脉网 | vbdata.cn | 医疗健康 | 融资/政策/企业 |
| 动脉橙 | vcbeat.net | 医疗健康 | 投融资数据 |
| 餐饮老板内参 | cyznj.com | 餐饮 | 行业数据/案例 |
| 联商网 | linkshop.com | 零售 | 行业数据/趋势 |
| 芥末堆 | jiemodui.com | 教育 | 行业数据/政策 |
| 游戏陀螺 | youxituoluo.com | 游戏 | 行业数据/趋势 |

## 电商平台数据（★★★☆☆）

| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 阿里研究院 | aliresearch.com | 电商消费趋势 | 零售/消费分析 |
| 京东消费研究院 | - | 消费趋势报告 | 零售/消费分析 |
| 魔镜市场情报 | mktindex.com.cn | 电商销售数据 | 具体品类分析 |
| 欧睿Euromonitor | euromonitor.com | 全球消费数据 | 国际对标 |

## 搜索技巧

### 关键词组合
```
行业 + 市场规模/市场容量/市场空间
行业 + 竞争格局/市场份额/CR5
行业 + 发展趋势/前景预测/增长率
行业 + 政策法规/监管/标准
行业 + 融资/投资/并购
公司名 + 财报/年报/招股书
```

### 文件类型限定
```
site:pdf 行业名 报告
filetype:pdf 行业名 市场规模
```

### 时间限定
优先搜索近2年数据，使用搜索引擎的时间筛选功能。

## 数据质量评估

### 可信度分级
| 等级 | 描述 | 使用建议 |
|-----|------|---------|
| ★★★★★ | 政府统计、上市公司财报 | 可直接引用 |
| ★★★★☆ | 头部券商、知名咨询机构 | 可引用，注明来源 |
| ★★★☆☆ | 行业媒体、第三方平台 | 需交叉验证 |
| ★★☆☆☆ | 自媒体、论坛 | 仅作参考线索 |

### 常见问题
1. **口径不一致** - 不同来源对"市场规模"定义可能不同
2. **预测偏差** - 咨询公司的预测往往偏乐观
3. **样本偏差** - 调研数据可能不具代表性
4. **时效性** - 注意数据发布时间，快速变化行业需特别留意


path: data_sources/by_industry/new_energy.md
content: # 新能源/电动车行业数据源

## 行业特有数据源

### 政策与监管
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 国家能源局 | nea.gov.cn | 能源政策/规划 | 产业政策分析 |
| 工信部装备工业司 | miit.gov.cn | 新能源汽车公告 | 车型/企业资质 |
| 中汽协(CAAM) | caam.org.cn | 汽车产销数据 | 月度销量分析 |
| 乘联会(CPCA) | cpcaauto.com | 乘用车销量 | 周度/月度数据 |

### 行业数据
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 中国汽车动力电池产业创新联盟 | cbea.com | 电池产销数据 | 电池产业链分析 |
| 高工锂电 | gg-lb.com | 锂电行业数据 | 电池产业链 |
| SNE Research | - | 全球电池装机 | 国际对比 |
| CleanTechnica | cleantechnica.com | 全球电动车 | 国际市场 |
| InsideEVs | insideevs.com | 电动车销量 | 国际数据 |

### 充电基础设施
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 中国充电联盟 | evcpsa.org.cn | 充电桩数据 | 基础设施分析 |
| 特来电 | - | 运营数据 | 头部运营商 |

## 细分领域数据源

### 动力电池
| 来源 | 数据类型 |
|-----|---------|
| 高工锂电 | 产能/产量/价格 |
| SNE Research | 全球装机排名 |
| 各公司公告 | 产能规划/出货量 |

### 电动车整车
| 来源 | 数据类型 |
|-----|---------|
| 乘联会 | 分品牌/分车型销量 |
| 中汽协 | 批发/零售数据 |
| 交强险数据 | 实际上险量 |
| 各公司公告 | 交付量/财报 |

### 光伏/储能
| 来源 | 网址 | 数据类型 |
|-----|------|---------|
| 中国光伏行业协会 | chinapv.org.cn | 装机/产能数据 |
| 集邦新能源 | energytrend.cn | 价格/产能 |
| BloombergNEF | - | 全球预测 |

## 关键指标定义

### 电动车特有指标
- **渗透率** = 新能源车销量 / 汽车总销量
- **BEV/PHEV占比** = 纯电/插混销量结构
- **单车带电量** = 平均电池容量(kWh)
- **续航里程** = 主流车型续航区间
- **充电桩车桩比** = 新能源车保有量 / 充电桩数量

### 电池关键指标
- **装机量** = 电池装车总量(GWh)
- **能量密度** = Wh/kg
- **材料体系占比** = 磷酸铁锂/三元/其他占比
- **价格走势** = 元/Wh

## 典型分析框架

### 电动车五力分析要点
1. **竞争强度**：极高，价格战持续，洗牌加速
2. **进入壁垒**：提高中，资金/技术/品牌门槛提升
3. **替代品**：燃油车、氢燃料、公共交通
4. **买方议价**：强，选择多，价格敏感
5. **供应商议价**：分化，电池厂议价强，其他弱

### 关键成功因素
1. **成本控制** - 规模效应+垂直整合
2. **产品力** - 续航/智能/设计
3. **品牌心智** - 差异化定位
4. **渠道能力** - 销售/服务网络
5. **供应链** - 电池等核心资源获取

## 主要玩家分类

### 自主品牌
| 类型 | 代表 | 特点 |
|-----|------|------|
| 头部新势力 | 理想、蔚来、小鹏、零跑 | 智能化+服务创新 |
| 传统转型 | 比亚迪、吉利、长城、长安 | 规模+垂直整合 |
| 科技入局 | 小米、华为(问界) | 生态+流量 |

### 国际品牌
| 品牌 | 特点 |
|-----|------|
| Tesla | 标杆品牌，成本领先 |
| 大众/宝马/奔驰 | 豪华电动化 |

## 政策影响评估

| 政策 | 影响 | 趋势 |
|-----|------|-----|
| 购置补贴 | 逐步退坡 | 2022年底终止 |
| 购置税减免 | 延续 | 至2027年 |
| 双积分 | 约束主机厂 | 持续收紧 |
| 充电基础设施 | 新基建 | 持续投入 |


path: data_sources/by_industry/consumer.md
content: # 消费品行业数据源

## 行业特有数据源

### 餐饮/食品
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 窄门餐眼 | zmqian.com | 餐饮门店数据 | 门店数量/分布 |
| 美团研究院 | - | 餐饮消费趋势 | 消费行为分析 |
| 红餐网 | hongcan18.com | 行业报告/榜单 | 品牌排名 |
| 中国烹饪协会 | cca.org.cn | 行业统计数据 | 宏观市场规模 |
| 餐宝典 | canbaodian.com | 行业报告/榜单 | 品类分析 |

### 新茶饮/咖啡（重点）
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 咖门 | kamenclub.com | 行业报告/趋势 | 品类分析 |
| 中国连锁经营协会 | ccfa.org.cn | 连锁品牌数据 | 头部品牌分析 |
| 大众点评 | dianping.com | 门店/评价数据 | 门店验证/口碑 |
| 饿了么/美团 | - | 外卖数据 | 线上销售趋势 |

### 美妆/个护
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 聚美丽 | jumeili.cn | 行业报告/趋势 | 美妆行业分析 |
| 美业观察 | meiye0915.com | 美业数据 | 医美/美容院 |
| 用户说 | usersay.com | 消费者调研 | 用户洞察 |
| 美丽修行 | bevol.cn | 成分查询 | 产品分析 |

### 服装/鞋履
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 中国服装协会 | cnga.org.cn | 行业数据 | 宏观分析 |
| 天猫/京东 | - | 销售数据 | 品类趋势 |
| 时尚商业Daily | fashionbiz.net | 品牌动态 | 竞争分析 |

## 关键指标定义

### 餐饮特有指标
- **翻台率** = 总餐桌使用次数 / 总餐桌数 / 营业天数
- **坪效** = 营业额 / 营业面积
- **客单价** = 总营业额 / 顾客数
- **同店增长** = 开业一年以上门店的同比增长

### 新茶饮关键数据点
1. **市场规模**：全国/区域现制茶饮销售额
2. **门店数量**：各品牌门店数及增速
3. **价格带分布**：高端(20+)、中端(10-20)、低端(<10)占比
4. **城市层级分布**：一线/新一线/二线/下沉市场
5. **头部品牌市占率**：喜茶、奈雪、茶百道、古茗等

## 典型分析框架

### 新茶饮五力分析要点
1. **竞争强度**：极高，价格战频繁，同质化严重
2. **进入壁垒**：中等，资金门槛低但品牌/点位壁垒高
3. **替代品**：瓶装饮料、咖啡、其他休闲食品
4. **买方议价**：中等，品牌忠诚度低，价格敏感
5. **供应商议价**：低，原材料标准化，供应商分散

### 关键成功因素
1. **选址能力** - 商圈/点位资源
2. **产品创新** - 推新速度和爆款率
3. **供应链** - 原材料成本控制和稳定性
4. **品牌运营** - 社交媒体营销
5. **数字化** - 小程序/会员运营


path: data_sources/by_industry/healthcare.md
content: # 医疗健康行业数据源

## 行业特有数据源

### 监管与政策
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 国家药监局(NMPA) | nmpa.gov.cn | 药品/器械审批 | 产品获批情况 |
| 国家医保局 | nhssa.gov.cn | 医保目录/集采 | 支付政策影响 |
| 卫健委 | nhc.gov.cn | 医院/卫生数据 | 医疗服务分析 |
| 中国药审中心(CDE) | cde.org.cn | 药品审评数据 | 研发管线分析 |
| 药智网 | yaozh.com | 药品数据库 | 药品/企业查询 |

### 行业研究
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 动脉网 | vbdata.cn | 医疗创投/行业 | 创新医疗分析 |
| 动脉橙 | vcbeat.net | 投融资数据 | 投资热度 |
| 健康界 | cn-healthcare.com | 医疗管理 | 医院/政策 |
| IQVIA | iqvia.com | 市场数据 | 药品销售数据 |
| 米内网 | menet.com.cn | 医药市场 | 药品市场份额 |

### 上市公司
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 医药魔方 | pharmcube.com | 医药数据库 | 企业/管线/交易 |
| Insight数据库 | db.dxy.cn | 临床试验/管线 | 研发竞争格局 |
| 丁香园insight | insight.dxy.cn | 医药数据 | 研发/市场 |
| 火石创造 | firestone.cn | 产业数据 | 产业规划 |

## 细分领域数据源

### 创新药
| 来源 | 数据类型 |
|-----|---------|
| 医药魔方 | 管线、交易、专利 |
| Insight | 临床试验、申报 |
| ClinicalTrials.gov | 全球临床试验 |
| FDA官网 | 美国获批信息 |

### 医疗器械
| 来源 | 数据类型 |
|-----|---------|
| NMPA | 注册证信息 |
| 众成医械 | 器械数据库 |
| 比地招标网 | 招中标数据 |

### 医疗服务
| 来源 | 数据类型 |
|-----|---------|
| 卫健委统计年鉴 | 医院/床位/诊疗 |
| 医管中心 | 医院评审信息 |
| 好大夫在线 | 医生/医院评价 |

## 关键指标定义

### 医药特有指标
- **研发管线**：在研药物/器械的数量和阶段
- **临床试验**：I/II/III期试验进展
- **获批情况**：NMPA/FDA/EMA获批记录
- **专利悬崖**：核心专利到期时间
- **集采影响**：是否纳入集采及降价幅度

### 医院相关指标
- **床位数**：医院规模
- **门诊量**：患者流量
- **手术量**：外科能力
- **DRG/DIP**：按病种付费数据

## 典型分析框架

### 创新药五力分析要点
1. **竞争强度**：研发竞争激烈，me-too药物红海
2. **进入壁垒**：极高，资金+时间+技术+监管
3. **替代品**：仿制药、生物类似药、新疗法
4. **买方议价**：医保局集采后议价能力强
5. **供应商议价**：CRO/CDMO commoditized

### 关键成功因素
1. **研发能力** - 管线深度和创新性
2. **临床推进** - 试验执行效率
3. **注册能力** - 监管沟通能力
4. **商业化** - 销售队伍/渠道
5. **支付准入** - 医保谈判能力

## 政策影响评估

### 关键政策
| 政策 | 影响 | 受益/受损 |
|-----|------|---------|
| 集采 | 降价压力 | 仿制药企受损，创新药企受益 |
| 医保谈判 | 准入门槛 | 创新药放量关键 |
| DRG/DIP | 控费导向 | 医院行为改变 |
| 创新药审评加速 | 缩短周期 | 创新药企受益 |


path: data_sources/by_industry/saas.md
content: # SaaS/企业服务数据源

## 行业特有数据源

### 行业研究与报告
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 艾瑞咨询-SaaS | iresearch.com.cn | SaaS行业报告 | 市场规模/趋势 |
| 易观分析-企服 | analysys.cn | 企业服务报告 | 赛道分析 |
| T研究 | - | SaaS测评/报告 | 产品对比 |
| 崔牛会 | cuiniu.com | SaaS社群/榜单 | 行业人脉/榜单 |
| 牛透社 | niutoushe.com | SaaS资讯/分析 | 行业动态 |

### 融资数据
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| IT桔子-SaaS | itjuzi.com | 融资事件 | 投资热度/估值 |
| 企名片 | qimingpian.com | 融资数据库 | 竞品融资情况 |
| Crunchbase | crunchbase.com | 全球融资数据 | 国际对标 |
| PitchBook | pitchbook.com | PE/VC数据 | 专业机构使用 |

### 产品与市场
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| G2 | g2.com | 产品评价/排名 | 国际产品对比 |
| Capterra | capterra.com | 软件选型 | 竞品功能对比 |
| 36氪企服点评 | 36dianping.com | 产品评价 | 国内产品口碑 |
| SaaS点评 | saasdp.com | 产品库 | 产品搜索 |

## 关键指标定义

### SaaS核心指标
| 指标 | 英文 | 定义 | 健康标准 |
|-----|------|-----|---------|
| 年经常性收入 | ARR | 年度订阅收入 | - |
| 月经常性收入 | MRR | 月度订阅收入 | - |
| 客户终身价值 | LTV | 单客户全生命周期价值 | - |
| 获客成本 | CAC | 获取单个客户成本 | LTV/CAC > 3 |
| 月流失率 | Churn | 月度客户流失比例 | < 5% |
| 净收入留存率 | NRR | 存量客户收入变化 | > 100% |
| _magic number_ | - | 销售效率 = (Q Rev - Q-1 Rev)×4 / 销售投入 | > 0.7 |

### 上市公司参考指标
- 毛利率：通常70%+
- 销售费用率：通常40-60%
- 研发费用率：通常20-40%
- 净利率：通常-30%到10%（增长期多为负）

## 典型分析框架

### SaaS五力分析要点
1. **竞争强度**：高，同质化严重，客户切换成本逐渐降低
2. **进入壁垒**：中等，技术壁垒降低但客户积累需要时间
3. **替代品**：自研系统、传统软件、低代码平台
4. **买方议价**：增强趋势，客户选型更理性
5. **供应商议价**：低，云基础设施 commoditized

### 关键成功因素
1. **产品-市场契合** - 解决真实痛点
2. **获客效率** - LTV/CAC健康度
3. **客户成功** - 留存和扩展销售
4. **产品体验** - 易用性决定口碑
5. **生态集成** - 与其他工具打通

## 上市公司对标

### A股SaaS公司
| 公司 | 代码 | 赛道 | 市值规模 | 特点 |
|-----|------|-----|---------|------|
| 用友网络 | 600588 | ERP/财务 | 大 | 老牌ERP转云 |
| 金山办公 | 688111 | 办公 | 大 | WPS/协同办公 |
| 广联达 | 002410 | 建筑 | 大 | 垂直行业龙头 |
| 恒生电子 | 600570 | 金融 | 大 | 金融IT龙头 |

### 美股中概SaaS
| 公司 | 代码 | 赛道 | 特点 |
|-----|------|-----|------|
| 北森 | - | HCM | 一体化HR SaaS |
| 有赞 | 08083.HK | 电商 | 微商城 |
| 微盟 | 02013.HK | 电商 | 智慧零售 |

### 美国SaaS标杆
| 公司 | 代码 | 赛道 | 特点 |
|-----|------|-----|------|
| Salesforce | CRM | CRM | SaaS鼻祖 |
| ServiceNow | NOW | ITSM | 企业级SaaS标杆 |
| Workday | WDAY | HCM | HR SaaS标杆 |
| Snowflake | SNOW | 数据 | 云数据仓库 |
| Atlassian | TEAM | 协作 | Jira/Confluence |


path: data_sources/by_industry/ai.md
content: # AI/人工智能行业数据源

## 行业特有数据源

### 行业研究与报告
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 机器之心 | jiqizhixin.com | AI行业报告/新闻 | 技术趋势 |
| 量子位 | qbitai.com | AI资讯/分析 | 行业动态 |
| 智东西 | zhidx.com | AI/硬科技 | 深度分析 |
| 甲子光年 | jazzyear.com | 科技产业 | 产业研究 |
| 中国信通院 | caict.ac.cn | AI白皮书 | 官方权威数据 |
| IDC | idc.com | AI市场预测 | 市场规模 |
| Gartner | gartner.com | 技术成熟度曲线 | 技术趋势 |

### 大模型与AIGC
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| 机器之心-大模型 | - | 模型评测/榜单 | 技术能力对比 |
| 量子位-大模型 | - | 行业分析 | 竞争格局 |
| LMSYS Chatbot Arena | chat.lmsys.org | 模型排名 | 技术能力对比 |
| Papers With Code | paperswithcode.com | SOTA模型 | 技术追踪 |
| Hugging Face | huggingface.co | 模型/数据 | 开源生态 |

### 投融资数据
| 来源 | 网址 | 数据类型 | 使用场景 |
|-----|------|---------|---------|
| IT桔子-AI | itjuzi.com | AI融资事件 | 投资热度 |
| 企名片 | qimingpian.com | 融资数据库 | 估值分析 |
| The Information | theinformation.com | 硅谷AI | 国际对标 |
| TechCrunch | techcrunch.com | AI新闻 | 国际动态 |

## 细分领域数据源

### 大语言模型(LLM)
| 来源 | 数据类型 |
|-----|---------|
| LMSYS Arena | Elo排名 |
| 各公司发布 | 模型参数/上下文/价格 |
| 机器之心评测 | 中文能力排名 |
| 财报电话会 | 商业化进展 |

### AI Infra/算力
| 来源 | 网址 | 数据类型 |
|-----|------|---------|
| Nvidia财报 | - | AI芯片收入 |
| 各云厂商 | - | AI算力布局 |
|  Semianalysis | semianalysis.com | 算力分析 |

### AI应用
| 来源 | 数据类型 |
|-----|---------|
| SimilarWeb | 网站流量 |
| App Annie/点点 | 应用下载/收入 |
| a16z Top100 | 消费者AI应用榜单 |
| 各公司发布 | 用户/收入数据 |

## 关键指标定义

### AI公司特有指标
- **模型参数量** - 规模指标，非质量指标
- **上下文长度** - 处理能力
- **推理成本** - $/1K tokens
- **API调用量** - 商业化指标
- **GPU集群规模** - 算力壁垒

### 商业化指标
- **ARPU** - 每用户平均收入
- **付费转化率** - 免费→付费比例
- **推理毛利率** - 收入-算力成本
- **客户获取成本** -  especially企业客户

## 典型分析框架

### AI五力分析要点
1. **竞争强度**：极高，技术迭代快，同质化风险
2. **进入壁垒**：分化，基础模型极高，应用层降低
3. **替代品**：传统软件、人工服务、开源模型
4. **买方议价**：增强，模型选择增多
5. **供应商议价**：高，Nvidia等算力供应商强势

### 关键成功因素
1. **技术能力** - 模型性能+迭代速度
2. **数据壁垒** - 专有数据获取
3. **场景落地** - 从demo到生产环境
4. **算力获取** - 训练/推理资源
5. **商业化** - PMF和盈利模式

## 主要玩家分类

### 基础模型层
| 类型 | 代表(国内) | 代表(国际) |
|-----|-----------|-----------|
| 大厂 | 文心(百度)、通义(阿里)、混元(腾讯)、豆包(字节) | GPT(OpenAI)、Gemini(Google)、Claude(Anthropic) |
| 创业公司 | 智谱、月之暗面、MiniMax、零一万物 | - |
| 开源 | - | Llama(Meta)、Qwen(阿里) |

### 应用层
| 领域 | 代表产品 | 模式 |
|-----|---------|------|
| 搜索 | 文心一言、秘塔 | 替代传统搜索 |
| 办公 | 金山WPS AI、Notion AI | 生产力工具增强 |
| 教育 | 作业帮、猿辅导 | 个性化学习 |
| 设计 | Midjourney、Stable Diffusion | 创意生成 |
| 编程 | GitHub Copilot、Cursor | 代码辅助 |
| 客服 | 各企业自建 | 降本增效 |

## 技术趋势追踪

### 重点关注
- **多模态** - 文本+图像+音频+视频
- **Agent** - 自主执行任务的AI
- **端侧AI** - 手机/PC本地运行
- **RAG** - 检索增强生成
- **模型效率** - 更小、更快、更便宜


path: templates/data_provenance.md
content: # 数据溯源与可信度说明

## 报告数据总览

| 数据类别 | 数量 | 引用数据 | 推算数据 | 平均时效 |
|---------|------|---------|---------|---------|
| 市场规模 | X条 | X条 | X条 | 2024年X月 |
| 竞争数据 | X条 | X条 | X条 | 2024年X月 |
| 财务数据 | X条 | X条 | X条 | 2024年X季 |
| 政策数据 | X条 | X条 | X条 | 2024年X月 |

**整体数据健康度：** ★★★★☆ (良好/一般/需谨慎)

---

## 数据来源说明

### 直接引用数据（已标注来源）

| 数据项 | 数值 | 来源 | 发布时间 | 可信度 | 备注 |
|-------|------|-----|---------|-------|------|
| 市场规模(TAM) | | | | ★★★★★ | |
| 行业增长率 | | | | ★★★★☆ | |
| 头部企业份额 | | | | ★★★★☆ | |

**解读：**
- ★★★★★ = 政府统计/上市公司财报，可直接引用
- ★★★★☆ = 头部券商/咨询机构，可信度较高
- ★★★☆☆ = 行业媒体/估算，需谨慎使用

### 推算/估算数据（已标注推算逻辑）

| 数据项 | 估算值 | 推算方法 | 基础数据 | 置信区间 | 风险提示 |
|-------|-------|---------|---------|---------|---------|
| 细分市场规模 | | 自上而下拆分 | TAM=XXX亿 × 占比X% | ±20% | 细分定义可能存在差异 |
| 企业收入估算 | | 门店数×单店营收 | 门店XXX家×单店XX万/月 | ±30% | 单店数据为行业平均 |
| 市场份额 | | 根据公开信息估算 | 各公司披露数据推算 | ±15% | 未上市公司数据不全 |

**推算逻辑说明：**
1. **[数据项名称]**：[详细说明推算公式和假设]
2. **[数据项名称]**：[详细说明推算公式和假设]

---

## 数据时效性声明

### 数据时间分布

| 时间段 | 数据占比 | 说明 |
|-------|---------|------|
| 2024年 | XX% | 最新数据，可靠 |
| 2023年 | XX% | 近期数据，基本可靠 |
| 2022年及以前 | XX% | 历史数据，仅作趋势参考 |

### 关键数据时效性

**高时效性数据（2024年内）：**
- [数据项1] - [来源] - 2024年X月
- [数据项2] - [来源] - 2024年X月

**中等时效性数据（2023年）：**
- [数据项3] - [来源] - 2023年X月

**历史参考数据（2022年及以前）：**
- [数据项4] - [来源] - 2022年X月（仅作历史趋势参考）

### 时效性风险提醒

⚠️ **以下数据可能已发生变化：**
1. [数据项]：行业变化快，建议核实最新数据
2. [数据项]：政策可能已更新

---

## 数据缺口与局限

### 未能获取的数据

| 数据项 | 重要性 | 缺失原因 | 替代方案 |
|-------|-------|---------|---------|
| [数据项] | 高/中/低 | 非公开/付费/未找到 | 使用估算/参考类比 |

### 数据口径差异

**注意：以下数据可能存在口径差异**

| 数据项 | 不同口径 | 本报告采用口径 |
|-------|---------|---------------|
| 市场规模 | 有的含咖啡/有的不含 | 本报告采用XXX口径 |
| 门店数量 | 有的含加盟/有的仅直营 | 本报告采用XXX口径 |

---

## 数据更新建议

### 建议定期追踪的数据源

| 数据项 | 更新频率 | 建议追踪来源 |
|-------|---------|-------------|
| 市场规模 | 季度/年度 | 艾瑞咨询、易观 |
| 竞争格局 | 月度 | 公司公告、行业媒体 |
| 政策动态 | 实时 | 政府官网、行业媒体 |

### 下次分析时建议核实

- [ ] [数据项1] - 建议查看最新财报
- [ ] [数据项2] - 建议查看最新行业报告
- [ ] [数据项3] - 建议关注政策变化

---

## 如何验证本报告数据

### 您可以自行核实的渠道

1. **上市公司数据**
   - 巨潮资讯网：http://www.cninfo.com.cn
   - 直接查阅公司年报/季报

2. **政府统计数据**
   - 国家统计局：http://www.stats.gov.cn
   - 行业协会官网

3. **行业报告**
   - 艾瑞咨询：http://www.iresearch.com.cn
   - 易观分析：http://www.analysys.cn

4. **实时搜索**
   - 搜索关键词：[行业名] + [数据项] + 2024

---

## 免责声明

> 1. 本报告数据均来自公开渠道，分析师已尽力确保准确性，但不保证100%无误
> 2. 推算数据基于合理假设，实际数值可能存在偏差
> 3. 市场变化快速，建议重大决策前核实最新数据
> 4. 本报告仅供参考，不构成投资建议

---

**数据透明度评分：★★★★☆**
- ★★★★★ = 所有数据均有明确来源，无推算数据
- ★★★★☆ = 主要数据有来源，推算数据逻辑清晰
- ★★★☆☆ = 部分数据缺失来源或推算逻辑不透明
- ★★☆☆☆ = 数据来源不清，大量估算


path: templates/standard_report_structure.md
content: # 战略分析报告标准化规范

## 报告结构标准（强制统一）

所有行业分析报告必须遵循以下固定章节顺序和命名：

```
# [行业名称] 战略分析报告

> 报告日期：YYYY年MM月DD日
> 分析框架：麦肯锡战略分析方法论
> 数据时点：主要基于[年份]公开信息

---

## 执行摘要（Executive Summary）

### 核心结论（Key Findings）
1. [结论1]
2. [结论2]
3. [结论3]

### 关键数据（Key Metrics）
| 指标 | 数值 | 来源 | 可信度 | 提取方式 |
|-----|------|-----|-------|---------|
| 市场规模(TAM) | | | | |
| 年增长率 | | | | |
| 市场集中度(CR4) | | | | |
| 主要玩家数量 | | | | |

> ⚠️ **数据时效性提示**：...

---

## 数据溯源与可信度说明（Data Provenance）

### 数据总览（Data Overview）
| 数据类别 | 数量 | 直接引用 | 推算数据 | 平均时效 | 健康度 |
|---------|------|---------|---------|---------|-------|
| 市场规模 | | | | | |
| 竞争数据 | | | | | |
| 财务数据 | | | | | |

### 直接引用数据（Cited Data）
| 数据项 | 数值 | 来源 | 发布时间 | 可信度 | 提取方式 |
|-------|------|-----|---------|-------|---------|
| | | | | | |

### 推算数据（Estimated Data）
| 数据项 | 估算值 | 推算方法 | 置信区间 | 风险提示 | 基础数据来源 |
|-------|-------|---------|---------|---------|-------------|
| | | | | | |

---

## 1. 行业概览（Industry Overview）

### 1.1 行业定义与边界（Definition & Scope）
### 1.2 发展历程（Development History）
### 1.3 产业链结构（Value Chain Position）

---

## 2. 行业结构分析（Industry Structure - Porter's Five Forces）

### 2.1 现有竞争者竞争强度（Rivalry Among Existing Competitors）
**评分：** ★★★★☆
**分析：**

### 2.2 新进入者威胁（Threat of New Entrants）
**评分：** ★★★☆☆
**分析：**

### 2.3 替代品威胁（Threat of Substitutes）
**评分：** ★★☆☆☆
**分析：**

### 2.4 买方议价能力（Bargaining Power of Buyers）
**评分：** ★★★☆☆
**分析：**

### 2.5 供应商议价能力（Bargaining Power of Suppliers）
**评分：** ★★☆☆☆
**分析：**

### 2.6 五力综合评估（Five Forces Summary）
[对各力量的相互关系与行业吸引力进行总结性文字评述，避免简单罗列表格]

**行业吸引力总评：** [高/中/低]

---

## 3. 市场规模与增长（Market Sizing & Growth）

### 3.1 TAM-SAM-SOM 测算
| 层级 | 规模 | 测算方法 | 关键假设 |
|-----|------|---------|---------|
| TAM | | | |
| SAM | | | |
| SOM | | | |

### 3.2 增长驱动因素（Growth Drivers）
### 3.3 增长预测（Growth Forecast）
| 年份 | 规模 | 增长率 | 驱动因素 |
|-----|------|-------|---------|
| 2024 | | | |
| 2025 | | | |
| 2026 | | | |

---

## 4. 竞争格局分析（Competitive Landscape）

### 4.1 市场集中度（Market Concentration）
- **CR4：** XX%
- **HHI指数：** XXXX
- **格局类型：** [寡头垄断/多强竞争/分散竞争]

### 4.2 战略群组划分（Strategic Groups）
| 群组 | 价格带 | 代表企业 | 核心策略 |
|-----|-------|---------|---------|
| 高端 | | | |
| 中端 | | | |
| 平价 | | | |

### 4.3 主要竞争者画像（Key Competitor Profiles）
**[企业A]** 在行业中占据 [市场地位]，其核心优势在于 [优势描述]，主要短板包括 [短板]。近期动态显示 [动态]。整体而言，该企业 [综合评价]。

**[企业B]** ...

### 4.4 竞争态势演变（Competitive Dynamics）

---

## 5. 价值链分析（Value Chain Analysis）

### 5.1 价值链地图（Value Chain Map）
### 5.2 各环节利润池分析（Profit Pool by Segment）
### 5.3 价值转移趋势（Value Migration Trends）

---

## 6. 关键趋势分析（Key Trends - PESTEL）

### 6.1 PESTEL 综合评估表

| 维度 | 现状 | 趋势 | 影响 |
|-----|------|------|------|
| 政策环境 (Political) | | | |
| 经济环境 (Economic) | | | |
| 社会环境 (Social) | | | |
| 技术环境 (Technological) | | | |
| 环境因素 (Environmental) | | | |
| 法律环境 (Legal) | | | |

### 6.7 关键趋势总结（Trend Summary）
| 趋势 | 紧迫性 | 影响程度 | 确定性 | 优先级 |
|-----|-------|---------|-------|-------|
| | | | | |

---

## 7. 关键成功因素（Critical Success Factors）

### 7.1 CSF识别（CSF Identification）
**[CSF 1]** [用文字描述该关键因素的重要性、表现形式及进入壁垒]

**[CSF 2]** ...

### 7.2 能力建设建议（Capability Building Roadmap）
#### 短期（0-6个月）
#### 中期（6-18个月）
#### 长期（18个月+）

---

## 8. 战略启示（Strategic Implications）

### 8.1 机会识别（Opportunities）
| 机会 | 吸引力 | 可行性 | 时间窗口 | 优先级 |
|-----|-------|-------|---------|-------|
| | | | | |

### 8.2 风险提示（Risks）
| 风险 | 概率 | 影响 | 紧迫性 | 应对建议 |
|-----|-----|------|-------|---------|
| | | | | |

### 8.3 战略建议（Strategic Recommendations）
#### 短期（0-6个月）
#### 中期（6-18个月）
#### 长期（18个月+）

---

## 附录（Appendix）

### A. 数据来源清单（Data Sources）
### B. 分析方法说明（Methodology）
### C. 术语表（Glossary）
### D. 免责声明（Disclaimer）

---

*报告完成 | Report Completed*


path: templates/full_report.md
content: # 战略分析报告 - 完整版

## 适用对象
- 需要全面深入分析的用户
- 投资决策前的尽职调查
- 战略规划参考

---

# [行业名称] 战略分析报告

---

## 执行摘要

### 核心结论
1. [结论1]
2. [结论2]
3. [结论3]

### 关键数据
| 指标 | 数值 | 来源 | 可信度 | 来源链接 |
|-----|------|-----|-------|---------|
| 市场规模(TAM) | | | | |
| 增长率 | | | | |
| 集中度(CR4) | | | | |

> ⚠️ **数据时效性提示**：本报告数据主要基于[2024年/2023年]公开信息，市场环境变化快速，建议重大决策前核实最新数据。详细数据溯源见第二章。

---

## 数据溯源与可信度说明

### 报告数据总览

| 数据类别 | 数量 | 直接引用 | 推算数据 | 平均时效 | 健康度 |
|---------|------|---------|---------|---------|-------|
| 市场规模 | X条 | X条 | X条 | 2024年X月 | ★★★★☆ |
| 竞争数据 | X条 | X条 | X条 | 2024年X月 | ★★★★☆ |
| 财务数据 | X条 | X条 | X条 | 2024年X季 | ★★★★★ |
| 政策数据 | X条 | X条 | X条 | 2024年X月 | ★★★★★ |

### 数据类型说明

**直接引用数据**（有明确来源）：
| 数据项 | 数值 | 来源 | 发布时间 | 可信度 |
|-------|------|-----|---------|-------|
| [示例]市场规模 | ¥3300亿 | 中国连锁经营协会 | 2023-12 | ★★★★☆ |

**推算/估算数据**（基于计算）：
| 数据项 | 估算值 | 推算方法 | 置信区间 | 风险提示 |
|-------|-------|---------|---------|---------|
| [示例]细分市场规模 | ¥800亿 | TAM×占比24% | ±20% | 细分定义可能有差异 |

### 数据时效性分布

| 时间段 | 占比 | 可靠性 |
|-------|------|-------|
| 2024年 | XX% | ✅ 最新，可靠 |
| 2023年 | XX% | ✅ 近期，基本可靠 |
| 2022年及以前 | XX% | ⚠️ 参考，可能已变化 |

### 数据缺口

| 数据项 | 重要性 | 缺失原因 | 替代方案 |
|-------|-------|---------|---------|
| | | | |

---

## 目录

1. [数据溯源](#数据溯源与可信度说明) ⭐ 重要
2. [行业概览](#1-行业概览)
3. [行业结构分析](#2-行业结构分析)
4. [市场规模与增长](#3-市场规模与增长)
5. [竞争格局](#4-竞争格局)
6. [价值链分析](#5-价值链分析)
7. [关键趋势](#6-关键趋势)
8. [关键成功因素](#7-关键成功因素)
9. [战略启示](#8-战略启示)
10. [附录](#9-附录)

---

## 1. 行业概览

### 1.1 行业定义
[清晰定义行业边界]

### 1.2 发展历程
[关键发展阶段]

### 1.3 产业链位置
[上下游关系图]

---

## 2. 行业结构分析

### 2.1 波特五力分析

#### 现有竞争者竞争强度
[基于行业增速、市场集中度、产品差异化程度进行叙述性分析]

**评分：** ★★★★☆

#### 新进入者威胁
[从资金门槛、技术壁垒、品牌/渠道壁垒角度分析]

**评分：** ★★★☆☆

#### 替代品威胁
[从主要替代品及威胁程度进行分析]

**评分：** ★★☆☆☆

#### 买方议价能力
[从客户集中度、转换成本等角度分析]

**评分：** ★★★☆☆

#### 供应商议价能力
[从供应商集中度、转换成本等角度分析]

**评分：** ★★☆☆☆

### 2.2 综合评估
[对各力量的相互关系与行业吸引力进行总结性文字评述，避免简单罗列表格]

**总评：** [行业吸引力判断]

---

## 3. 市场规模与增长

### 3.1 TAM-SAM-SOM

| 层级 | 规模 | 测算方法 | 关键假设 | 来源链接 |
|-----|------|---------|---------|---------|
| TAM | | | | |
| SAM | | | | |
| SOM | | | | |

### 3.2 增长驱动因素
[分解增长来源]

### 3.3 增长预测
| 年份 | 规模 | 增长率 | 驱动因素 | 来源链接 |
|-----|------|-------|---------|---------|
| | | | | |

---

## 4. 竞争格局

### 4.1 市场集中度
- CR4: XX%
- HHI: XXXX

### 4.2 战略群组
[群组划分图]

### 4.3 主要竞争者画像

**[企业A]** 在行业中占据 [市场地位]，其核心优势在于 [优势描述]，主要短板包括 [短板]。近期动态显示 [动态]。整体而言，该企业 [综合评价]。

**[企业B]** ...

### 4.4 竞争态势演变
[趋势判断]

---

## 5. 价值链分析

### 5.1 价值链地图
[各环节可视化]

### 5.2 各环节分析
| 环节 | 利润池 | 集中度 | 关键能力 |
|-----|-------|-------|---------|
| | | | |

### 5.3 价值转移趋势
[利润池移动方向]

---

## 6. 关键趋势

### 6.1 PESTEL综合评估表

| 维度 | 现状 | 趋势 | 影响 |
|-----|------|------|------|
| 政治/政策 (Political) | | | |
| 经济 (Economic) | | | |
| 社会 (Social) | | | |
| 技术 (Technological) | | | |
| 环境 (Environmental) | | | |
| 法律 (Legal) | | | |

### 6.2 行业趋势
#### 需求端趋势
#### 供给端趋势

### 6.3 情景规划
| 情景 | 描述 | 概率 | 战略含义 |
|-----|------|-----|---------|
| | | | |

---

## 7. 关键成功因素

### 7.1 CSF识别

**[CSF 1]** [用文字描述该关键因素的重要性、表现形式及进入壁垒]

**[CSF 2]** ...

### 7.2 能力建设建议

**短期（0-6个月）** [具体行动]

**中期（6-18个月）** [具体行动]

**长期（18个月+）** [具体行动]

---

## 8. 战略启示

### 8.1 机会识别
[详细描述]

### 8.2 风险提示
[详细描述]

### 8.3 战略建议
#### 短期（0-6个月）
#### 中期（6-18个月）
#### 长期（18个月+）

---

## 9. 附录

### 9.1 数据来源
[详细列出所有数据来源]

### 9.2 方法论说明
[各框架的详细解释]

### 9.3 术语表

### 9.4 免责声明
[数据局限性说明]

---

*报告完成*


path: templates/executive_summary.md
content: # 战略分析报告 - 高管摘要版

## 适用对象
- 小企业CEO
- 时间有限的高管
- 需要快速决策参考的用户

## 报告结构

---

# [行业名称] 战略分析 - 执行摘要

> **分析日期：** YYYY年MM月DD日
> **分析对象：** [行业名称]
> **用户角色：** [CEO/高管/学生/新进入者]
> **核心问题：** [用户提出的关键决策问题]

---

[用一段简短的文字概述行业整体态势、核心发现与报告目的，帮助读者快速建立上下文。]

## 核心结论（3-5条）

1. **[结论1 - 最关键的发现]**
   *支撑数据/逻辑：*[一句话说明]

2. **[结论2]**
   *支撑数据/逻辑：*

3. **[结论3]**
   *支撑数据/逻辑：*

4. **[结论4 - 可选]**

5. **[结论5 - 可选]**

---

## 关键数据一览

| 指标 | 数值 | 行业地位 | 趋势 |
|-----|------|---------|-----|
| 市场规模(TAM) | ¥XX亿 | [大/中/小] | ↑/↓/→ |
| 年增长率 | XX% | [高/中/低] | |
| 市场集中度(CR4) | XX% | [高/中/低集中] | |
| 平均毛利率 | XX% | [高/中/低] | |
| 主要玩家数量 | X家 | | |

---

## 机会识别

| 机会 | 吸引力 | 可行性 | 时间窗口 | 优先级 |
|-----|-------|-------|---------|-------|
| [机会1] | ★★★★★ | ★★★★☆ | [短期/中期] | P1 |
| [机会2] | ★★★★☆ | ★★★☆☆ | [中期] | P2 |

---

## 风险提示

| 风险 | 概率 | 影响 | 紧迫性 | 应对建议 |
|-----|-----|------|-------|---------|
| [风险1] | 高/中/低 | 大/中/小 | 高/中/低 | [一句话建议] |
| [风险2] | | | | |

---

## 需要进一步确认的问题

1. [问题1 - 需要用户提供更多信息]
2. [问题2]

---

## 附录：核心发现简述

### 行业结构
- 竞争强度：[高/中/低] - [一句话说明]
- 进入壁垒：[高/中/低] - [一句话说明]

### 竞争格局
- 格局类型：[寡头/分散/多强竞争]
- 主要玩家：[列举2-3家关键企业]
- 关键趋势：[竞争态势变化方向]

### 关键成功因素
1. [CSF1]
2. [CSF2]
3. [CSF3]

---

*本摘要基于公开数据分析生成，仅供参考。重大决策请结合实际情况和专业咨询。*


path: templates/student_edition.md
content: # 战略分析报告 - 学生学习版

## 适用对象
- 商学院学生
- 行业研究初学者
- 需要系统学习方法论的用户

## 报告特点
- 详细解释分析框架
- 提供方法论学习价值
- 案例和理论结合

---

# [行业名称] 战略分析报告

> **分析日期：** YYYY年MM月DD日
> **学习目标：** 掌握[行业名称]的系统认知 + [具体方法论]

---

## 学习导读

本报告旨在帮助你建立对[行业名称]的系统认知，同时学习战略分析的核心方法论。建议阅读方式：
1. 先浏览整体结构，了解行业全貌
2. 重点阅读方法论说明，理解"为什么"
3. 结合数据验证理论框架
4. 思考可迁移到其他行业的启示

---

## 第一部分：行业概览

### 1.1 行业定义与边界

**什么是[行业名称]？**
> [用通俗易懂的语言解释行业定义]

**行业边界：**
- 上游：[说明与上游行业的关系]
- 下游：[说明与下游行业的关系]
- 替代品：[列举主要替代品]
- 相邻行业：[说明行业边界模糊地带]

### 1.2 行业发展历程

| 阶段 | 时间 | 特征 | 关键事件 |
|-----|------|-----|---------|
| 导入期 | | | |
| 成长期 | | | |
| 成熟期 | | | |
[或衰退期/整合期]

---

## 第二部分：行业结构分析（五力模型学习）

> 📚 **方法论说明：** 波特五力模型是分析行业竞争强度和盈利能力的经典框架...

### 2.1 方法论讲解：波特五力模型

**什么是五力模型？**
[解释五力模型的基本概念和用途]

**为什么使用它？**
[说明五力模型的价值和局限]

**如何判断行业吸引力？**
[解释评分标准和解读方式]

### 2.2 [行业名称]五力分析

#### 力1：现有竞争者竞争强度
**理论回顾：** [竞争强度的影响因素]

**行业现状：**
[具体分析]

**评分：** ★★★☆☆（中等强度）

#### 力2：新进入者威胁
**理论回顾：** [进入壁垒的类型]

**行业现状：**
[具体分析]

**评分：** ★★★☆☆（中等威胁）

#### [继续其他三力...]

### 2.3 五力综合评估

| 力量 | 强度(1-5) | 趋势 | 学习要点 |
|-----|----------|-----|---------|
| 现有竞争 | | | [这个力量如何影响行业盈利] |
| 新进入威胁 | | | |
| 替代品威胁 | | | |
| 买方议价 | | | |
| 供应商议价 | | | |

**综合评分：** XX/25分
**结论：** [行业吸引力判断]

**学习反思：**
- 五力模型在这个行业的适用性如何？
- 哪个力量最具决定性？为什么？
- 还有什么因素没被模型覆盖？

---

## 第三部分：市场规模分析（TAM-SAM-SOM学习）

> 📚 **方法论说明：** 市场规模测算是战略分析的基础...

### 3.1 方法论讲解

**什么是TAM-SAM-SOM？**
[详细解释三个层级的定义和区别]

**测算方法对比：**
| 方法 | 适用场景 | 优点 | 缺点 |
|-----|---------|-----|-----|
| 自上而下 | | | |
| 自下而上 | | | |
| 类比法 | | | |

### 3.2 [行业名称]市场规模

[具体分析内容，展示计算过程]

**关键假设说明：**
[列出并解释关键假设]

### 3.3 学习练习

📋 **思考题：**
1. 如果要你独立测算一个相关细分市场，你会怎么做？
2. 这个数据有哪些局限性？
3. 如何判断市场数据的可靠性？

---

## 第四部分：竞争格局分析

> 📚 **方法论说明：** ...

[结构同前，包含方法论讲解和实际应用]

---

## 第五部分：趋势分析

> 📚 **方法论说明：** PESTEL框架...

[结构同前]

---

## 第六部分：关键成功因素

> 📚 **方法论说明：** CSF识别...

[结构同前]

---

## 第七部分：案例研究

### 7.1 成功案例：[企业A]
**做对了什么？**
**与CSF的关系？**
**可学习的经验？**

### 7.2 失败案例：[企业B]
**做错了什么？**
**违背了哪些行业规律？**
**教训是什么？**

---

## 第八部分：方法论总结

### 8.1 本报告使用的框架清单

| 框架 | 用途 | 适用场景 | 局限性 |
|-----|------|---------|-------|
| 五力模型 | 行业结构分析 | 评估行业吸引力 | 静态分析 |
| TAM-SAM-SOM | 市场规模测算 | 投资决策 | 数据依赖 |
| ... | | | |

### 8.2 框架选择指南

**面对不同问题，该用什么框架？**

| 问题类型 | 推荐框架 | 原因 |
|---------|---------|-----|
| 要不要进入这个行业？ | 五力 + TAM | |
| 竞争策略怎么定？ | 竞争格局 + CSF | |
| 未来趋势怎么看？ | PESTEL + 情景规划 | |

### 8.3 延伸阅读推荐

- 书籍：[推荐2-3本]
- 报告：[推荐行业深度报告]
- 案例：[推荐可研究的上市公司]

---

## 附录

### A. 数据来源清单
[列出所有数据来源，说明可靠性]

### B. 术语表
[解释行业和分析术语]

### C. 分析过程记录
[展示部分分析过程中的思考]

---

## 学习检查清单

阅读本报告后，你应该能够：
- [ ] 解释[行业]的基本商业模式
- [ ] 运用五力模型分析任何行业
- [ ] 独立完成市场规模测算
- [ ] 识别一个行业的关键成功因素
- [ ] 分析竞争格局并提出战略建议

如果还有不清楚的地方，建议：
1. 重读对应方法论章节
2. 尝试用同样框架分析另一个熟悉的行业
3. 查找更多案例加深理解


path: docs/how_to_read_report.md
content: # 如何阅读战略分析报告 - 数据可信度指南

## 为什么要关注数据可信度？

战略分析报告中的数据直接影响决策质量。了解数据的来源、时效和可信度，可以帮你：
- 判断哪些结论可以直接使用
- 识别哪些数据需要进一步核实
- 理解分析的不确定性范围
- 避免被过时或不准确的信息误导

---

## 数据类型标识解读

### 1. 直接引用数据 ✅

**标识方式：**
```
市场规模¥3300亿（中国连锁经营协会《2023新茶饮报告》，2023-12，★★★★☆）
```

**特征：**
- 有明确的来源机构/报告名称
- 有发布时间
- 有可信度星级

**可靠性：** 高。可以直接引用，但需关注时效性。

---

### 2. 推算/估算数据 ⚠️

**标识方式：**
```
细分市场规模¥800亿（估算：TAM¥3300亿 × 占比24%，置信区间±20%，仅供参考）
```

**特征：**
- 明确标注"估算"或"推算"
- 说明计算公式/方法
- 给出置信区间或风险提示

**可靠性：** 中等。基于合理假设，但存在不确定性。

**使用建议：**
- 理解推算逻辑后再使用
- 注意置信区间范围
- 重大决策前尝试核实

---

### 3. 行业共识/经验数据 📊

**标识方式：**
```
单店月均营收15-25万（行业经验值，因点位差异较大，仅供参考）
```

**特征：**
- 标注"行业经验值"或"经验估计"
- 通常是一个范围而非精确值
- 说明影响因素

**可靠性：** 中等偏低。基于行业认知，但缺乏严格统计支撑。

**使用建议：**
- 作为参考方向，非精确依据
- 结合实际情况调整
- 优先寻找更精确的数据替代

---

## 可信度星级解读

| 星级 | 含义 | 来源示例 | 使用建议 |
|-----|------|---------|---------|
| ★★★★★ | 极高可信度 | 政府统计、上市公司财报 | 可直接引用，优先使用 |
| ★★★★☆ | 高可信度 | 头部券商研报、知名咨询机构 | 可信，但注意可能有偏差 |
| ★★★☆☆ | 中等可信度 | 行业媒体、第三方数据平台 | 参考使用，建议交叉验证 |
| ★★☆☆☆ | 较低可信度 | 自媒体、估算、传闻 | 仅作参考，需谨慎对待 |
| ★☆☆☆☆ | 无法验证 | 无明确来源 | 尽量避免使用 |

---

## 时效性标识解读

### 报告中的时效性提示

报告通常会在以下位置提示数据时效：

1. **执行摘要顶部**
   > ⚠️ **数据时效性提示**：本报告数据主要基于2024年公开信息...

2. **数据溯源章节**
   | 时间段 | 占比 | 可靠性 |
   |-------|------|-------|
   | 2024年 | 60% | ✅ 最新，可靠 |
   | 2023年 | 30% | ✅ 近期，基本可靠 |
   | 2022年及以前 | 10% | ⚠️ 参考，可能已变化 |

3. **具体数据标注**
   - 直接标注发布时间：`(2024-03)`
   - 标注时效性警告：`⚠️ 需更新`

### 不同行业的时效敏感度

| 行业类型 | 数据保鲜期 | 需特别关注的数据 |
|---------|-----------|----------------|
| 互联网/科技 | 3-6个月 | 用户量、融资、估值 |
| 消费品 | 6-12个月 | 市场规模、品牌份额 |
| 制造业 | 12个月 | 产能、进出口数据 |
| 房地产 | 3个月 | 价格、成交量、政策 |
| 政策敏感行业 | 实时 | 监管政策、准入标准 |

---

## 如何验证报告中的数据

### 快速验证清单

**对于关键决策数据，建议：**
- [ ] 查看数据来源是否可访问
- [ ] 搜索是否有更新的数据
- [ ] 对比2-3个不同来源
- [ ] 确认数据口径是否一致

### 推荐验证渠道

| 数据类型 | 推荐验证渠道 |
|---------|-------------|
| 市场规模 | 艾瑞、易观、券商研报（需多篇对比） |
| 上市公司数据 | 巨潮资讯网、公司年报 |
| 政府统计数据 | 国家统计局、行业协会官网 |
| 融资数据 | IT桔子、企名片、公司公告 |
| 实时动态 | 行业媒体、搜索引擎最新新闻 |

### 验证示例

**场景**：报告中写"XX行业市场规模¥500亿（艾瑞咨询，2023-12）"

**验证步骤**：
1. 访问艾瑞官网，搜索该行业最新报告
2. 查看是否有2024年更新的数据
3. 搜索"XX行业市场规模 2024"，看其他机构数据
4. 如果找不到更新数据，在决策时注明"基于2023年数据"

---

## 常见数据陷阱与规避

### 陷阱1：过时数据
**表现**：使用2-3年前的数据描述当前市场
**规避**：查看数据发布时间，快速变化行业优先使用近1年数据

### 陷阱2：口径不一致
**表现**：不同来源的市场规模差异巨大（有的含XX，有的不含）
**规避**：注意数据定义，优先使用同一口径的数据对比

### 陷阱3：乐观预测
**表现**：咨询公司的增长预测往往偏乐观
**规避**：预测数据标注为"预测"而非"事实"，多来源对比

### 陷阱4：样本偏差
**表现**：调研数据基于特定群体，不具代表性
**规避**：关注调研方法说明，小样本数据谨慎使用

### 陷阱5：推算误用
**表现**：基于有限数据的推算被当作精确值
**规避**：关注置信区间，推算数据仅作参考

---

## 向分析师反馈数据问题

如果你发现报告中的数据有问题，可以：

1. **指出具体数据项**
   > "报告中提到的'XX市场规模500亿'，我查到最新数据是600亿..."

2. **提供新的数据来源**
   > "根据艾瑞2024年3月报告，该数据已更新为..."

3. **说明数据影响**
   > "这个差异可能会影响关于XX的结论..."

4. **请求补充验证**
   > "能否核实这个数据，并说明推算逻辑？"

---

## 总结：数据使用原则

1. **优先使用** ★★★★★ 和 ★★★★☆ 数据
2. **交叉验证** 关键决策数据
3. **关注时效** 特别是快速变化行业
4. **理解推算** 知道推算数据的假设和局限
5. **坦诚缺口** 数据缺失时明确要求补充

---

*本指南帮助你更好地理解和使用战略分析报告中的数据。记住：没有完美的数据，关键是理解数据的质量和局限，做出知情决策。*


path: docs/html_style_guide.md
content: # Strategic Analyst HTML 报告风格规范

> 版本: 1.2
> 更新日期: 2026-03-29
> 适用范围: 所有 strategic-analyst 生成的 HTML 格式报告

---

## 一、设计原则

### 1.1 整体风格
- **极简专业**: 去除多余装饰，聚焦内容本身
- **金融研报**: 参考券商/咨询机构研究报告的排版风格
- **紧凑高效**: 减少留白，提升单屏信息密度
- **黑白灰为主**: 仅用黑、灰、红色（强调），避免花哨配色

### 1.2 核心约束
- 禁止直接用模型记忆填充数据，必须基于实时搜索
- 表格数量做减法，能用文字叙述的不用表格
- 段落文字优先于列表，列表优先于表格

---

## 二、配色方案

### 2.1 主色调
| 用途 | 色值 | 说明 |
|-----|------|-----|
| 主色 (黑色) | `#000000` | 标题、表头下划线、强调文字 |
| 次要色 (深灰) | `#333333` | 二级标题、副标题 |
| 正文色 | `#222222` | 正文文字 |
| 浅灰 | `#666666` | 辅助文字、页脚 |
| 边框灰 | `#cccccc` | 表格边框、分隔线 |

### 2.2 强调色
| 用途 | 色值 | 说明 |
|-----|------|-----|
| 红色 (强调) | `#cc0000` | 重点数据、趋势上升、警示 |
| 深红 | `#990000` | 趋势下降、风险 |

### 2.3 可信度星级颜色
| 星级 | 色值 |
|-----|------|
| ★★★★★ | `#000000` (黑) |
| ★★★★☆ | `#555555` (中灰) |
| ★★★☆☆ | `#888888` (浅灰) |
| ★★☆☆☆ | `#cc3333` (红) |
| ★☆☆☆☆ | `#990000` (深红) |

---

## 三、排版规范

### 3.1 页面基础
```css
body {
    font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
    font-size: 13px;
    line-height: 1.65;
    color: #222222;
    max-width: 900px;
    margin: 0 auto;
}
```

### 3.2 标题层级
| 级别 | 字号 | 字重 | 下边距 | 其他 |
|-----|------|-----|-------|------|
| H1 (章节) | 1.25em | 600 | 12px | 底部 1px 边框 (#cccccc) |
| H2 (小节) | 1.05em | 600 | 8px | 无 |
| H3 (内容项) | 0.95em | 600 | 6px | 无 |

### 3.3 间距规范
- 章节标题上边距: 28px
- 段落间距: 8px
- 表格外边距: 8px 上下
- 内容区 padding: 0 (无边距)

---

## 四、封面设计

### 4.1 布局
- **白底黑字**，左对齐
- 底部 2px 黑色实线分隔
- 简洁，无大 padding

### 4.2 元素
```
┌─────────────────────────────────────┐
│ 报告标题 (1.6em, 600字重)            │
│ 副标题 (1em, #333333)               │
│ 生成时间 (0.8em, #666666)            │
└─────────────────────────────────────┘
▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓ (2px 黑线)
```

---

## 五、表格样式

### 5.1 核心特征
**金融研报风格**：
- 白底黑字，**无线框包围**
- 表头底部 **2px 黑色粗线**
- 单元格仅保留**横线分隔**（border-bottom: 1px solid #cccccc）
- 最后一行底部加 **1px 深灰线**收尾

### 5.2 具体规范
```css
table.data-table {
    border-collapse: collapse;
    font-size: 0.85em;
    border: none;
}

table.data-table th {
    background: #fff;
    color: #000;
    border: none;
    border-bottom: 2px solid #000;
    padding: 6px 8px;
    font-weight: 600;
}

table.data-table td {
    border: none;
    border-bottom: 1px solid #cccccc;
    padding: 5px 8px;
}

table.data-table tbody tr:last-child td {
    border-bottom: 1px solid #999;
}
```

### 5.3 使用原则
- **保留表格的场景**：数据来源溯源、市场份额排名、增长预测、PESTEL综合评估、机会/风险评估
- **避免表格的场景**：五力综合评估（改文字）、竞争者画像（改段落）、CSF分析（改文字+仅排序用表）

### 5.4 表格下载交互
HTML 报告中每个数据表格的右上角会在鼠标悬停时显示 **PNG / SVG** 下载按钮，采用纯前端零依赖实现（基于 SVG `<foreignObject>` + Canvas），不影响正常阅读与打印。

- 按钮默认隐藏，鼠标悬停在表格区域时显示
- 点击 **PNG** 可将表格渲染为图片并下载
- 点击 **SVG** 可下载矢量格式文件
- 该功能无需外部网络请求，HTML 报告自包含

---

## 六、内容结构规范

### 6.1 执行摘要
```markdown
[背景概述段落]

### 核心结论
1. [结论1]
2. [结论2]

### 关键数据
| 指标 | 数值 | 来源 | 可信度 | 来源链接 |
```

### 6.2 波特五力模型
**禁止**使用「五力综合评估表」，改用**叙述性文字总结**：
```markdown
### 1. 现有竞争者竞争强度
[分析段落]

**评分：** ★★★★☆（高强度）

### 综合评估
[对各力量的相互关系与行业吸引力进行总结性文字评述]

**总评：** [高/中/低]
```

### 6.3 竞争者画像
**禁止**使用「企业A/B/C」小表格，改用**段落式描述**：
```markdown
### 主要竞争者画像

**阿里云**以 26.1% 的份额稳居首位。其核心优势在于...近期动态显示...相对短板在于...

**华为云**在 2024 年实现收入...凭借...其主要挑战在于...
```

### 6.4 CSF分析
**重点用文字阐述**，仅在排序时使用简洁表格：
```markdown
### 行业CSF识别

**1. AI智算能力**
[重要性、表现、门槛的文字描述]

**2. 政企/行业解决方案**
...

### CSF优先级排序
| 排序 | CSF | 重要性 | 壁垒 | 紧迫性 |
```

### 6.5 能力建设建议
```markdown
### 能力建设建议

**短期（0-6个月）** [具体行动描述]

**中期（6-18个月）** [具体行动描述]

**长期（18个月+）** [具体行动描述]
```

---

## 七、Markdown转HTML处理规则

### 7.1 段落包裹逻辑
- 普通文本段落 → `<p>` 包裹
- 以块级标签开头的段落（`div`, `table`, `ul`, `ol`, `blockquote`, `hr`）→ 不包裹
- 以内联标签开头的段落（`strong`, `em`, `code`, `span`）→ 仍需 `<p>` 包裹

### 7.2 内联标签白名单
```python
inline_tags = {'strong', 'em', 'code', 'span', 'a', 'b', 'i', 'u', 's', 'del', 'ins', 'sub', 'sup', 'mark', 'small', 'label', 'img', 'br', 'wbr'}
```

### 7.3 特殊处理
- `---` → `<hr/>`
- `**文字**` → `<strong>文字</strong>`
- `*文字*` → `<em>文字</em>`
- `1. 内容` → `<ol class="numbered-list">` + `<li value="1">`
- `- 内容` → `<ul class="bullet-list">` + `<li>`

---

## 八、禁止事项

### 8.1 样式层面
- ❌ 禁止黑底白字表头
- ❌ 禁止斑马纹（交替行背景色）
- ❌ 禁止全包围表格边框
- ❌ 禁止大 padding/margin 留白
- ❌ 禁止彩色渐变背景

### 8.2 内容层面
- ❌ 禁止「建议行动清单」/「下一步行动」
- ❌ 禁止简单罗列的小表格（如五力评估表、能力差距分析表）
- ❌ 禁止用模型记忆填充数据（必须用实时搜索）

---

## 九、一致性检查清单

生成报告前检查：

- [ ] 封面为白底黑字左对齐，底部有 2px 黑线
- [ ] 表格为白底黑字，表头底部 2px 黑线，无全包围边框
- [ ] 所有 `.table-wrapper` 包含 PNG/SVG 下载按钮
- [ ] 表格内的 `[来源](URL)` 链接在 HTML 中被正确渲染为 `<a>` 标签
- [ ] 波特五力综合评估为文字叙述，非表格
- [ ] 竞争者画像为段落文字，非「维度-内容」小表格
- [ ] CSF分析以文字为主，表格仅用于排序
- [ ] 内联标签（strong/em/code）开头的段落被正确包裹在 `<p>` 中
- [ ] 无「建议行动清单」章节

---

## 十、参考文件

- 样式代码: `tools/report_generator.py` 中 `_generate_css()` 方法
- 解析逻辑: `tools/report_generator.py` 中 `_parse_markdown_content()` 方法
- 模板示例: `templates/full_report.md`
- 标准结构: `templates/standard_report_structure.md`


path: docs/visualization_standards.md
content: # 报告可视化规范指南

> **注意**：本规范侧重 Markdown 层面的表格定义。HTML 渲染风格（颜色、边框、间距等）请同时参考 `html_style_guide.md`。

## 表格标准化

### 1. 关键数据表（Key Metrics Table）

**用途**：执行摘要中的核心数据展示

**格式**：
```markdown
| 指标 | 数值 | 来源 | 可信度 | 提取方式 |
|-----|------|-----|-------|---------|
| 市场规模(TAM) | ¥3,300亿 | 中国连锁经营协会 | ★★★★☆ | 直接引用 |
| 年增长率 | 12% | 艾瑞咨询 | ★★★★☆ | PDF提取 |
| 市场集中度(CR4) | 25% | 估算 | ★★★☆☆ | - |
```

**规范**：
- 列宽：指标（左对齐）、数值（右对齐）、来源（左对齐）、可信度（居中）、提取方式（居中）
- 数值格式：货币用¥，百分比用%，大数据用亿/万亿
- 可信度：必须用★星级表示
- 提取方式：`直接引用`/`PDF提取`/`网页抓取`/`OCR识别`/`-`

---

### 2. 五力评估表（Five Forces Summary）

**用途**：五力模型综合评估

**格式**：
```markdown
| 力量 | 强度(1-5) | 趋势 | 关键因素 |
|-----|----------|-----|---------|
| 现有竞争 | 5 | ↑加剧 | 增速放缓+同质化 |
| 新进入威胁 | 3 | →稳定 | 品牌/点位壁垒 |
| 替代品威胁 | 3 | ↑上升 | 咖啡崛起 |
| 买方议价 | 3 | →稳定 | 价格敏感 |
| 供应商议价 | 2 | →稳定 | 供应商分散 |
```

**规范**：
- 强度：1-5数字，配合趋势箭头（↑上升/→稳定/↓下降）
- 关键因素：简洁短语，15字以内

---

### 3. 市场规模表（Market Sizing）

**用途**：TAM-SAM-SOM测算

**格式**：
```markdown
| 层级 | 规模 | 测算方法 | 关键假设 |
|-----|------|---------|---------|
| TAM | ¥3,300亿 | 行业总销售额 | 含现磨咖啡约5,000亿 |
| SAM | ¥2,800亿 | 新茶饮占比85% | 不含咖啡/传统奶茶 |
| SOM | ¥700亿 | 前10品牌销售额 | 头部占比约25% |
```

**规范**：
- 层级：TAM/SAM/SOM必须齐全
- 测算方法：简要说明计算方式
- 关键假设：说明口径差异
- **来源链接**：`来源链接` 列应包含指向原始报告或数据发布页面的超链接，使用 Markdown 格式 `[来源名称](URL)`，若无可公开访问的链接则标注 `-`。来源链接同时会出现在生成的 HTML 报告中，并支持点击跳转。

---

### 4. 竞争格局表（Competitive Landscape）

**用途**：战略群组和主要玩家分析

**战略群组格式**：
```markdown
| 群组 | 价格带 | 代表企业 | 门店规模 | 核心策略 |
|-----|-------|---------|---------|---------|
| 高端 | 20-40元 | 喜茶、奈雪 | 500-1000 | 品牌+体验+创新 |
| 中端 | 10-15元 | 茶百道、古茗 | 3000-8000 | 加盟+性价比 |
| 平价 | <10元 | 蜜雪冰城 | 20,000+ | 极致成本+下沉 |
```

**玩家画像格式**：
```markdown
#### [企业名称]
| 维度 | 内容 |
|-----|------|
| 基本信息 | 成立时间、总部、上市情况 |
| 规模 | 收入、门店、员工 |
| 定位 | 一句话战略定位 |
| 核心优势 | 3-5条 |
| 主要短板 | 2-3条 |
| 近期动态 | 最新战略举措 |
| 威胁评估 | 高/中/低 + 理由 |
```

---

### 5. 增长预测表（Growth Forecast）

**用途**：未来5年增长预测

**格式**：
```markdown
| 年份 | 规模 | 增长率 | 驱动因素 |
|-----|------|-------|---------|
| 2024 | ¥3,600亿 | 9% | 复苏+下沉 |
| 2025 | ¥3,900亿 | 8% | 存量竞争 |
| 2026 | ¥4,150亿 | 6% | 成熟期 |
| 2027 | ¥4,350亿 | 5% | 成熟期 |
| 2028 | ¥4,550亿 | 5% | 成熟期 |
```

**规范**：
- 必须包含：规模、增长率、驱动因素、来源链接
- 增长率：保留整数或1位小数
- 驱动因素：简洁关键词
- **来源链接**：`来源链接` 列应包含指向原始报告或数据发布页面的超链接，使用 Markdown 格式 `[来源名称](URL)`，若无可公开访问的链接则标注 `-`。来源链接同时会出现在生成的 HTML 报告中，并支持点击跳转。

---

### 6. 价值链分析表（Value Chain）

**用途**：价值链各环节分析

**格式**：
```markdown
| 环节 | 成本占比 | 利润池 | 集中度 | 关键能力 |
|-----|---------|-------|-------|---------|
| 原料供应 | 35% | 低 | 低 | 规模、品控 |
| 生产加工 | 8% | 低 | 中 | 标准化 |
| 仓储物流 | 6% | 低 | 中 | 冷链能力 |
| 门店运营 | 35% | 中 | 低 | 人效、坪效 |
| 品牌营销 | 8% | 中 | 高 | 品牌势能 |
```

---

### 7. 趋势影响表（Trend Impact）

**用途**：PESTEL趋势评估

**格式**：
```markdown
| 趋势 | 紧迫性 | 影响程度 | 确定性 | 优先级 |
|-----|-------|---------|-------|-------|
| 健康化 | 高 | 大 | 高 | P1 |
| 数字化 | 高 | 大 | 高 | P1 |
| 下沉市场 | 中 | 大 | 中 | P2 |
| 出海 | 中 | 中 | 中 | P2 |
| 自动化 | 低 | 中 | 低 | P3 |
```

**规范**：
- 紧迫性/影响/确定性：高/中/低
- 优先级：P1/P2/P3（必须立即/重要/观察）

---

### 8. 机会/风险评估表（Opportunity & Risk）

**机会评估格式**：
```markdown
| 机会 | 描述 | 吸引力 | 可行性 | 时间窗口 | 优先级 |
|-----|------|-------|-------|---------|-------|
| 下沉市场 | 县级市场渗透 | ★★★★★ | ★★★☆☆ | 2-3年 | P1 |
| 细分创新 | 新品类开拓 | ★★★★☆ | ★★★★☆ | 持续 | P2 |
```

**风险评估格式**：
```markdown
| 风险 | 描述 | 概率 | 影响 | 紧迫性 | 应对建议 |
|-----|------|-----|------|-------|---------|
| 价格战 | 持续恶性竞争 | 高 | 大 | 高 | 差异化定位 |
| 食安事件 | 食品安全问题 | 中 | 极大 | 高 | 强化品控 |
```

---

### 9. 能力差距分析表（Capability Gap）

**用途**：CSF能力对比

**格式**：
```markdown
| CSF | 权重 | 本企业 | 竞品A | 竞品B | 行业标杆 | 差距 | 优先级 |
|-----|-----|-------|------|------|---------|-----|-------|
| 产品力 | 25% | 3 | 4 | 3 | 5 | -2 | P1 |
| 供应链 | 25% | 4 | 3 | 4 | 5 | -1 | P2 |
| 品牌势能 | 20% | 2 | 5 | 4 | 5 | -3 | P1 |
```

**规范**：
- 评分：1-5分
- 差距：与行业标杆的差异
- 优先级：基于权重×差距计算

---

### 10. 数据溯源总表（Data Provenance）

**用途**：数据透明度总览

**格式**：
```markdown
| 数据项 | 数值 | 来源 | 发布时间 | 可信度 | 数据类型 | 提取方式 |
|-------|------|-----|---------|-------|---------|---------|
| 市场规模 | ¥3,300亿 | 中国连锁经营协会 | 2023-12 | ★★★★☆ | 直接引用 | - |
| 细分占比 | 24% | 估算 | - | ★★★☆☆ | 推算 | PDF提取 |
| 单店营收 | 15-25万 | 行业经验 | - | ★★☆☆☆ | 经验值 | OCR识别 |
```

---

## 可视化图表建议

虽然Markdown不支持复杂图表，但可以用以下方式增强可读性：

### 趋势箭头
- ↑ 上升/加剧
- → 稳定/持平
- ↓ 下降/减弱

### 评级符号
- ★★★★★ 五星（极高）
- ★★★★☆ 四星（高）
- ★★★☆☆ 三星（中）
- ★★☆☆☆ 二星（低）
- ★☆☆☆☆ 一星（极低）

### 优先级标识
- P1：必须立即行动
- P2：重要，需规划
- P3：观察，暂缓

### 复选框（行动清单）
```markdown
- [ ] 行动项1
- [x] 行动项2（已完成）
```

---

## 排版规范

### 标题层级
```
# 一级标题：报告标题（仅1个）
## 二级标题：主要章节（8个标准章节）
### 三级标题：章节内小节
#### 四级标题：具体内容项
```

### 分隔线使用
- 章节之间用 `---` 分隔
- 重要区块前后可加空行

### 强调格式
- **粗体**：关键结论、重要数据
- *斜体*：引用、说明性文字
- `代码体`：数据口径、计算公式

---

## 一致性检查清单

输出报告前，检查以下一致性：

- [ ] 所有表格格式统一（列对齐方式一致）
- [ ] 数值单位统一（全部用亿或全部用万亿）
- [ ] 可信度全部用★星级表示
- [ ] 评级标准统一（高/中/低定义一致）
- [ ] 时间格式统一（YYYY年MM月 或 YYYY-MM）
- [ ] 标题层级规范
- [ ] 章节顺序符合标准结构


path: cases/new_tea_drinks_analysis.md
content: # 新茶饮行业战略分析案例

> **说明**：这是一个完整的行业分析示例，展示如何应用战略分析框架。数据基于2023-2024年公开信息，仅供学习参考。

---

# 中国新茶饮行业战略分析报告

> 报告日期：2024年3月
> 分析框架：波特五力 + TAM-SAM-SOM + 竞争格局 + PESTEL + CSF

---

## 执行摘要

### 核心结论

1. **市场规模超3000亿，但增速放缓至10-15%**，行业从高速增长进入存量竞争阶段，品牌间价格战频发。

2. **竞争格局高度分散，CR5约25%**，头部品牌通过加盟模式快速扩张，但单店盈利压力增大。

3. **进入壁垒中等偏低**，品牌/点位/供应链成为主要壁垒，纯资金难以形成持续竞争优势。

4. **下沉市场和细分品类存在结构性机会**，高端市场趋于饱和，平价市场仍有空间。

5. **行业正处于洗牌期**，预计未来3-5年将有显著整合，尾部品牌加速出清。

### 关键数据

| 指标 | 数值 | 数据来源 |
|-----|------|---------|
| 市场规模(TAM) | ¥3,300亿 | 中国连锁经营协会 |
| 年增长率 | 12% | 艾瑞咨询 |
| 门店总数 | 约50万家 | 窄门餐眼 |
| 头部品牌(茶百道)门店 | 7,000+ | 公司公告 |
| CR5 | ~25% | 估算 |

### 建议行动

- **对于新进入者**：谨慎进入，除非有明确差异化（独特品类/供应链优势/下沉市场资源）
- **对于现有品牌**：聚焦盈利模型优化，控制扩张节奏，强化供应链效率
- **对于投资者**：关注有供应链壁垒和加盟管控能力的头部品牌

---

## 1. 行业概览

### 1.1 行业定义

**新茶饮**是指以茶叶、水果、乳制品等为原料，现场调制销售的现制饮品。区别于传统奶茶（粉剂冲泡），新茶饮强调：
- 真茶+真奶+新鲜水果
- 现场手工制作
- 产品持续创新
- 门店体验升级

### 1.2 行业发展历程

| 阶段 | 时间 | 特征 | 代表事件 |
|-----|------|-----|---------|
| 导入期 | 2010-2015 | 台式奶茶进入，概念萌芽 | 一点点、CoCo入华 |
| 成长期 | 2016-2019 | 高端化升级，资本涌入 | 喜茶、奈雪崛起 |
| 爆发期 | 2020-2022 | 疫情催化，外卖渗透 | 蜜雪冰城万店 |
| 洗牌期 | 2023-至今 | 增速放缓，价格战 | 喜茶开放加盟 |

### 1.3 产业链结构

```
上游原料 → 中游品牌 → 下游渠道

上游：茶叶/水果/乳制品/包材供应商
- 特点：分散，议价能力弱
- 趋势：品牌向上游整合

中游：茶饮品牌
- 模式：直营 vs 加盟
- 分化：高端(20+) / 中端(10-20) / 平价(<10)

下游：门店/外卖平台
- 门店：商场/街边/校园
- 外卖：美团/饿了么，占比40-50%
```

---

## 2. 行业结构分析（五力模型）

### 2.1 现有竞争者竞争强度：★★★★★（极高）

**分析：**
- **行业增速放缓**：从30%+降至10-15%，增量竞争转为存量竞争
- **同质化严重**：产品易被模仿，爆款周期缩短至1-2个月
- **价格战激烈**：头部品牌纷纷降价（喜茶从30元降至15元档）
- **营销战升级**：联名营销、明星代言成为常态

**表现：**
- 高端市场：喜茶、奈雪直接竞争
- 中端市场：茶百道、古茗、书亦混战
- 平价市场：蜜雪冰城一家独大

### 2.2 新进入者威胁：★★★☆☆（中等）

**进入壁垒分析：**

| 壁垒类型 | 高度 | 说明 |
|---------|-----|------|
| 资金 | 低 | 单店投资20-50万，启动资金门槛不高 |
| 技术 | 低 | 产品配方易被模仿，无技术壁垒 |
| 品牌 | 高 | 消费者心智已被头部占据 |
| 点位 | 高 | 优质商圈/学校/社区点位稀缺 |
| 供应链 | 中高 | 水果冷链、全国配送网络需要时间建立 |

**结论：** 单店容易开，但规模化难；品牌存活率低。

### 2.3 替代品威胁：★★★☆☆（中等）

**主要替代品：**
1. **咖啡** - 星巴克、瑞幸，场景替代
2. **瓶装饮料** - 农夫山泉、元气森林，便利替代
3. **传统奶茶** - 价格低，下沉市场仍有空间
4. **其他休闲食品** - 烘焙、零食，场景竞争

**威胁程度评估：**
- 咖啡威胁上升（瑞幸门店数超星巴克）
- 瓶装茶饮分流部分需求
- 但现制茶饮的"新鲜""定制"特性有一定护城河

### 2.4 买方议价能力：★★★☆☆（中等）

**分析：**
- **客户分散**：C端消费者，无集中议价
- **转换成本低**：品牌间切换无成本
- **价格敏感**：尤其是下沉市场
- **但品牌忠诚存在**：口味偏好和便利性形成粘性

### 2.5 供应商议价能力：★★☆☆☆（较低）

**分析：**
- **茶叶供应商**：分散，议价能力弱
- **水果供应商**：季节性波动，但选择多
- **乳制品**：伊利/蒙牛等大厂，但供应充足
- **包材**：标准化产品，价格低

**例外：** 部分稀缺原料（如特定产地茶叶）议价能力较强。

### 2.6 五力综合评估

| 力量 | 强度(1-5) | 趋势 | 关键因素 |
|-----|----------|-----|---------|
| 现有竞争 | 5 | 加剧 | 增速放缓+同质化 |
| 新进入威胁 | 3 | 稳定 | 品牌/点位壁垒提升 |
| 替代品威胁 | 3 | 上升 | 咖啡崛起 |
| 买方议价 | 3 | 稳定 | 价格敏感+低转换成本 |
| 供应商议价 | 2 | 稳定 | 供应商分散 |

**综合评分：16/25**

**行业吸引力判断**：中等偏低。行业规模大，但竞争激烈，盈利压力大，适合有明确差异化或成本优势的玩家。

---

## 3. 市场规模与增长

### 3.1 TAM-SAM-SOM

| 层级 | 规模 | 测算方法 | 关键假设 |
|-----|------|---------|---------|
| **TAM** | ¥3,300亿 | 现制茶饮总销售额 | 含现磨咖啡约5,000亿 |
| **SAM** | ¥2,800亿 | 新茶饮（不含咖啡/传统奶茶） | 新茶饮占比85% |
| **SOM（头部品牌）** | ¥700亿 | 前10品牌销售额 | 头部占比约25% |

### 3.2 增长驱动因素

**需求端：**
1. **消费升级** - 从粉剂奶茶向真材实料升级
2. **年轻化** - Z世代成为消费主力
3. **场景扩展** - 从下午茶到全时段、全场景
4. **社交属性** - 拍照分享成为消费动机之一

**供给端：**
1. **连锁化** - 连锁率从2019年约30%提升至40%+
2. **数字化** - 小程序点单、会员系统提升效率
3. **供应链升级** - 冷链物流、中央厨房支撑品质

### 3.3 增长预测

| 年份 | 规模 | 增长率 | 驱动因素 |
|-----|------|-------|---------|
| 2023 | 3,300亿 | 12% | 复苏+下沉 |
| 2024E | 3,600亿 | 9% | 增速放缓 |
| 2025E | 3,900亿 | 8% | 存量竞争 |
| 2026E | 4,150亿 | 6% | 成熟期 |
| 2027E | 4,350亿 | 5% | 成熟期 |

**关键假设：**
- 无重大负面政策
- 经济温和复苏
- 行业整合持续

---

## 4. 竞争格局

### 4.1 市场集中度

- **CR5**: ~25%（估算）
- **HHI指数**: 约800（估算，竞争型市场）
- **格局类型**: 低集中寡占 → 竞争型市场

### 4.2 战略群组

| 群组 | 价格带 | 代表品牌 | 门店规模 | 核心策略 |
|-----|-------|---------|---------|---------|
| **高端** | 20-40元 | 喜茶、奈雪、乐乐茶 | 500-1000家 | 品牌+体验+产品创新 |
| **中高端** | 15-20元 | 茶颜悦色、霸王茶姬 | 300-500家 | 区域深耕+文化特色 |
| **中端** | 10-15元 | 茶百道、古茗、书亦、沪上阿姨 | 3000-8000家 | 加盟扩张+性价比 |
| **平价** | <10元 | 蜜雪冰城 | 20,000+家 | 极致成本+下沉市场 |
| **细分** | 不定 | 7分甜(芒果)、CoCo | 1000-3000家 | 品类/场景细分 |

### 4.3 主要竞争者画像

#### 喜茶
| 维度 | 内容 |
|-----|------|
| 基本信息 | 2012年成立，新茶饮开创者，总部深圳 |
| 门店规模 | 约3,200家（2024年初），加盟占比提升 |
| 定位 | 高端新茶饮，原30元档，现15-25元 |
| 核心优势 | 产品创新能力强，品牌势能高，供应链成熟 |
| 主要短板 | 盈利压力大，降价后品牌调性稀释 |
| 近期动态 | 2022年底开放加盟，2023年加速下沉 |
| 威胁评估 | 高 - 仍是行业标杆和人才来源 |

#### 奈雪的茶
| 维度 | 内容 |
|-----|------|
| 基本信息 | 2015年成立，港股上市(2150.HK) |
| 门店规模 | 约1,500家，大店模式为主 |
| 定位 | "茶饮+烘焙"第三空间 |
| 核心优势 | 品牌高端，会员体系强，数字化领先 |
| 主要短板 | 大店模式盈利难，上市连续亏损 |
| 近期动态 | 降价、缩小店型、推加盟品牌"乐乐茶" |
| 威胁评估 | 中高 - 在调整中寻找新平衡 |

#### 蜜雪冰城
| 维度 | 内容 |
|-----|------|
| 基本信息 | 1997年成立，门店超2万家，拟港股上市 |
| 门店规模 | 20,000+家，全球最大现制茶饮品牌 |
| 定位 | 极致性价比，下沉市场之王 |
| 核心优势 | 成本控制能力极强，供应链自建，加盟模式成熟 |
| 主要短板 | 品牌调性偏低，产品创新能力相对弱 |
| 近期动态 | 出海（东南亚）、自建柠檬基地、上市筹备 |
| 威胁评估 | 极高 - 成本和规模护城河极深 |

#### 茶百道
| 维度 | 内容 |
|-----|------|
| 基本信息 | 2008年成立，中端品牌代表，拟港股上市 |
| 门店规模 | 7,000+家 |
| 定位 | 中端性价比，加盟为主 |
| 核心优势 | 加盟管控能力强，盈利模型健康，区域覆盖广 |
| 主要短板 | 品牌差异化不够鲜明 |
| 近期动态 | 冲刺港股IPO，持续扩张 |
| 威胁评估 | 高 - 中端市场最有力的竞争者 |

### 4.4 竞争态势演变

- **当前阶段**：洗牌整合期
- **竞争焦点**：
  - 短期：价格战（喜茶降价引发）
  - 中期：点位争夺（优质商圈/下沉市场）
  - 长期：供应链效率+品牌心智
- **未来趋势**：
  - 头部集中度提升（CR5有望提升至35-40%）
  - 腰部品牌加速出清
  - 细分品类仍有新品牌机会

---

## 5. 价值链分析

### 5.1 价值链各环节

```
原料供应 → 加工生产 → 仓储物流 → 门店运营 → 品牌营销 → 消费者
```

| 环节 | 成本占比 | 利润池 | 关键成功因素 |
|-----|---------|-------|------------|
| 原料供应 | 30-40% | 低 | 规模、品控、成本 |
| 加工生产 | 5-10% | 低 | 标准化、效率 |
| 仓储物流 | 5-8% | 低 | 冷链能力、覆盖密度 |
| 门店运营 | 30-40% | 中 | 人效、坪效、品控 |
| 品牌营销 | 5-10% | 中 | 品牌势能、获客效率 |
| 平台抽成 | 3-5% | 被美团/饿了么获取 | - |

### 5.2 利润池分析

**单店盈利模型（中端品牌，加盟模式）：**

| 项目 | 金额/比例 | 说明 |
|-----|----------|------|
| 月均营收 | 15-25万 | 视点位而定 |
| 原料成本 | 35-40% | 茶叶、水果、奶 |
| 租金成本 | 10-15% | 商场/街边店差异大 |
| 人工成本 | 15-20% | 3-5人 |
| 平台抽成 | 3-5% | 外卖平台 |
| 水电杂费 | 3-5% | |
| **加盟主净利润** | **15-20%** | 约2-4万/月 |

**品牌价值分配：**
- 品牌方（加盟费+原料供应）：约5-8%营收
- 加盟商（门店运营）：约15-20%营收

### 5.3 价值链整合趋势

**向上整合：**
- 自建茶园/果园（如喜茶的茶园）
- 自建包材厂（如蜜雪冰城）
- 自建冷链物流

**向下整合：**
- 会员体系直营化
- 私域流量运营

**趋势：** 头部品牌向全产业链延伸，强化成本和品控优势。

---

## 6. 关键趋势分析（PESTEL）

### 6.1 政策环境

- **食品安全监管趋严**：现制茶饮纳入更严格监管
- **加盟模式规范**：商务部等出台特许经营新规
- **环保要求**：限塑令，吸管/杯具材料升级
- **影响**：合规成本上升，利好头部品牌

### 6.2 经济环境

- **消费升级与降级并存**：K型分化，平价和高端都有空间
- **租金压力**：商场空置率上升，议价空间增大
- **人力成本**：持续上涨，倒逼自动化

### 6.3 社会环境

- **健康意识提升**："控糖""低脂"成为产品卖点
- **国潮崛起**：中式茶饮（霸王茶姬）受追捧
- **社交货币**：打卡、联名仍是重要驱动力

### 6.4 技术环境

- **数字化点餐**：小程序成为标配
- **自动化设备**：自动奶茶机开始出现
- **AI应用**：个性化推荐、库存预测

### 6.5 环境/法律

- 限塑政策持续收紧
- 食品标签要求更透明

### 6.6 关键趋势总结

| 趋势 | 紧迫性 | 影响程度 | 确定性 | 应对优先级 |
|-----|-------|---------|-------|-----------|
| 健康化 | 高 | 大 | 高 | P1 |
| 数字化 | 高 | 大 | 高 | P1 |
| 下沉市场 | 中 | 大 | 中 | P2 |
| 出海 | 中 | 中 | 中 | P2 |
| 自动化 | 中 | 中 | 中 | P3 |

---

## 7. 关键成功因素

### 7.1 CSF识别

#### 1. 产品力 ★★★★★
**重要性：** 核心竞争要素
**表现：** 推新速度、爆款率、口味稳定性
**门槛：** 中等（易被模仿）

#### 2. 供应链能力 ★★★★★
**重要性：** 规模化基础
**表现：** 成本优势、品控稳定性、全国配送
**门槛：** 高（需要时间积累和资本投入）

#### 3. 品牌势能 ★★★★☆
**重要性：** 获客和溢价基础
**表现：** 知名度、美誉度、社交热度
**门槛：** 高（需要持续投入和时间）

#### 4. 点位资源 ★★★★☆
**重要性：** 线下零售核心
**表现：** 商圈/学校/社区优质点位占有
**门槛：** 中高（先发优势+关系网络）

#### 5. 加盟管控能力 ★★★★☆
**重要性：** 规模扩张关键
**表现：** 加盟商筛选、培训、督导、品控
**门槛：** 中高（系统化能力）

#### 6. 数字化能力 ★★★☆☆
**重要性：** 效率提升工具
**表现：** 会员系统、供应链系统、数据决策
**门槛：** 中等

### 7.2 不同层级CSF

| 层级 | 关键成功因素 |
|-----|------------|
| 生存级 | 食品安全、基础产品力 |
| 发展级 | 供应链、点位、加盟管控 |
| 领先级 | 品牌势能、创新能力、数字化 |

---

## 8. 战略启示

### 8.1 机会识别

| 机会 | 描述 | 吸引力 | 可行性 | 时间窗口 |
|-----|------|-------|-------|---------|
| 下沉市场平价品牌 | 县级/镇级市场，蜜雪冰城价格带 | ★★★★★ | ★★★☆☆ | 2-3年 |
| 细分品类创新 | 鲜奶茶、养生茶等新品类 | ★★★★☆ | ★★★★☆ | 持续 |
| 东南亚出海 | 复制中国模式到东南亚 | ★★★★☆ | ★★★☆☆ | 3-5年 |
| 供应链服务 | 为中小品牌提供供应链 | ★★★☆☆ | ★★★☆☆ | 持续 |

### 8.2 风险提示

| 风险 | 概率 | 影响 | 应对建议 |
|-----|-----|------|---------|
| 价格战持续恶化 | 高 | 大 | 聚焦差异化，避免直接对抗 |
| 食品安全事件 | 中 | 极大 | 强化品控，建立危机预案 |
| 原材料成本上涨 | 中 | 中 | 长期合约，上游整合 |
| 新竞品类（咖啡）挤压 | 高 | 中 | 关注跨界竞争，灵活调整 |

### 8.3 战略建议

#### 对于新进入者
**建议：谨慎进入，除非有以下优势之一：**
1. 独特的品类创新（如健康功能性茶饮）
2. 下沉市场的点位资源
3. 强大的供应链整合能力
4. 足够的资金支撑长期亏损

**进入策略：**
- 避开一线城市红海
- 从区域市场起步
- 聚焦单一品类建立认知
- 轻资产加盟模式

#### 对于现有品牌
**建议：从规模扩张转向盈利优化**

**短期（0-12个月）：**
- 优化单店模型，关闭低效门店
- 强化供应链成本管控
- 提升会员复购率

**中期（1-3年）：**
- 区域深耕，提升密度效应
- 产品差异化，避免价格战
- 数字化运营降本增效

**长期（3-5年）：**
- 建立品牌护城河
- 考虑产业链整合
- 探索第二增长曲线（如零售化产品）

#### 对于投资者
**评估维度优先级：**
1. 单店盈利模型健康度
2. 供应链壁垒
3. 加盟管控能力
4. 品牌势能可持续性

**风险提示：**
- 避免纯概念投资，关注实际运营数据
- 注意行业估值回调风险
- 关注食品安全合规风险

---

## 附录

### 数据来源

| 数据 | 来源 | 发布时间 |
|-----|------|---------|
| 市场规模 | 中国连锁经营协会《2023新茶饮研究报告》 | 2023年 |
| 门店数据 | 窄门餐眼、各公司公告 | 2024年 |
| 行业分析 | 艾瑞咨询、红餐网、咖门 | 2023-2024年 |
| 公司财务 | 奈雪的茶港股公告、茶百道招股书 | 2023-2024年 |

### 分析方法说明

本报告采用以下分析框架：
- **波特五力模型**：评估行业竞争强度和吸引力
- **TAM-SAM-SOM**：测算市场规模
- **竞争格局分析**：市场集中度、战略群组
- **PESTEL**：宏观趋势扫描
- **CSF**：关键成功因素识别

### 免责声明

1. 本报告基于公开数据分析，数据存在时效性和完整性局限
2. 部分数据为估算值，仅供参考
3. 行业变化快速，分析结论可能随时间变化
4. 重大商业决策请咨询专业顾问

---

**报告完成**

*本案例展示了如何应用战略分析框架进行完整行业分析。实际分析时，数据应基于最新公开信息更新。*


path: checklists/data_collection.md
content: # 数据收集检查清单

## 市场规模数据

### 必查项
- [ ] 行业总体市场规模（TAM）
- [ ] 近3-5年历史增长率
- [ ] 未来5年增长预测
- [ ] 细分市场结构（如适用）
- [ ] 区域市场分布

### 验证项
- [ ] 至少2个来源交叉验证市场规模
- [ ] 确认统计口径（GMV/营收/产量）
- [ ] 确认货币单位和时间点
- [ ] 检查数据时效性（优先近2年）

---

## 竞争格局数据

### 必查项
- [ ] 头部企业名单（前5-10名）
- [ ] 市场份额数据（CR4/CR8）
- [ ] 各企业核心业务和定位
- [ ] 近期重要战略动作（并购/新品/扩张）
- [ ] 财务数据（上市公司）

### 验证项
- [ ] 市场份额数据来源
- [ ] 企业信息的时效性
- [ ] 是否包含新兴挑战者
- [ ] 是否有即将上市的新玩家

---

## 政策法规数据

### 必查项
- [ ] 行业监管主体和政策
- [ ] 最新政策变化（近1-2年）
- [ ] 政策趋势（收紧/放松/规范）
- [ ] 行业标准/准入要求

### 验证项
- [ ] 政策原文出处
- [ ] 政策实施时间
- [ ] 地方政策差异（如适用）

---

## 投融资数据

### 必查项
- [ ] 近1年重大融资事件
- [ ] 投资热点领域
- [ ] 主要投资机构
- [ ] 估值水平趋势

### 验证项
- [ ] 融资金额是否官方披露
- [ ] 估值数据可靠性

---

## 趋势数据

### 必查项
- [ ] 技术发展趋势
- [ ] 消费行为变化
- [ ] 供应链变化
- [ ] 替代品动态

---

## 数据源质量检查

### 来源分级使用
| 来源类型 | 使用方式 | 是否需要交叉验证 |
|---------|---------|----------------|
| 政府统计 | 直接引用 | 否 |
| 上市公司财报 | 直接引用 | 否 |
| 头部券商研报 | 引用+标注 | 建议 |
| 咨询机构报告 | 引用+标注 | 建议 |
| 行业媒体 | 参考+验证 | 必须 |
| 自媒体/论坛 | 仅作线索 | 必须 |

### 数据记录规范
每条数据必须记录：
- [ ] 数据项名称
- [ ] 数值
- [ ] 来源（具体到报告/文章标题）
- [ ] 来源链接（原始报告或数据发布页面的 URL）
- [ ] 发布时间
- [ ] 可信度评分（1-5星）
- [ ] 备注（口径说明/局限性）

---

## 中间产物与来源链接检查

### data_collection.md 强制中间产物
- [ ] `data_collection.md` 已保存并包含所有搜索关键词、工具、来源URL和原始摘要
- [ ] 搜索记录中的 URL 可公开追溯

### 报告中来源链接完整性
- [ ] TAM-SAM-SOM 表格中的来源链接已以 Markdown 链接 `[来源](URL)` 形式填充
- [ ] 增长预测表格中的来源链接已以 Markdown 链接 `[来源](URL)` 形式填充
- [ ] 关键数据（市场份额、增长率）的来源链接已以 Markdown 链接 `[来源](URL)` 形式填充
- [ ] 若某条数据无可公开访问的链接，已标注为 `-` 并在备注中说明原因


path: checklists/professional_boundaries.md
content: # 专业边界检查清单

## 分析前：明确边界

### 需求访谈时必须确认
- [ ] 具体行业名称和边界范围
- [ ] 核心决策问题（进入/投资/竞争/学习）
- [ ] 分析的时间范围（历史/现状/预测）
- [ ] 地理范围（全国/区域/全球）
- [ ] 用户身份和报告用途

### 明确告知用户
- [ ] "我将基于公开信息进行战略分析"
- [ ] "分析预计需要X分钟，覆盖以下框架：..."
- [ ] "最终输出将是一份结构化的战略分析报告"

---

## 分析中：边界保持

### 发散识别信号
- [ ] 用户连续3轮提问偏离核心行业
- [ ] 用户要求分析无关行业
- [ ] 用户要求超出战略分析范围的内容（如技术实现、法律建议）
- [ ] 用户要求预测具体财务收益/股价

### 拉回策略（选择适用）
- [ ] 承认用户兴趣，但建议优先完成主线
- [ ] 提议将发散内容放入报告附录
- [ ] 明确说明某些请求超出服务范围
- [ ] 提供替代方案（如"这超出了公开信息分析范围"）

### 中场对齐检查（每10轮或明显发散时）
- [ ] 回顾已完成的部分
- [ ] 确认当前讨论是否偏离主线
- [ ] 让用户选择继续方向

---

## 分析后：专业性验证

### 报告结构检查
- [ ] 是否使用了标准报告模板
- [ ] 是否遗漏关键分析框架（五力/市场规模/竞争格局至少要有）
- [ ] 是否有执行摘要
- [ ] 是否有数据溯源说明
- [ ] 是否有战略建议

### 内容专业性检查
- [ ] 是否使用了战略分析专业术语（进入壁垒、议价能力、战略群组等）
- [ ] 是否区分了事实和推断
- [ ] 是否有数据支撑关键结论
- [ ] 建议是否 actionable
- [ ] 是否指出了分析局限

### 语言风格检查
- [ ] 是否保持了专业顾问口吻（非口语化）
- [ ] 是否避免了主观臆断（"我觉得""可能"→改为"数据显示""基于分析"）
- [ ] 是否结构清晰、层次分明

### 拒绝不当请求的记录
- [ ] 是否记录了超出范围的用户请求
- [ ] 是否礼貌但坚定地拒绝
- [ ] 是否提供了替代建议

---

## 常见越界场景及应对

### 场景1：要求分析多个不相关行业
**应对：**
"为确保分析深度，建议每次聚焦一个行业。
您最优先想深入了解哪个行业？
其他行业可以在后续分析中覆盖。"

### 场景2：要求预测具体投资收益率
**应对：**
"战略分析可以评估行业吸引力和风险因素，
为投资决策提供信息支撑。
但具体收益率预测需要财务模型和更多内部信息，
这超出了公开信息战略分析的范围。"

### 场景3：要求获取非公开信息
**应对：**
"我的分析严格基于公开信息，
不使用或推断非公开信息。
这既是职业道德要求，也是合规要求。
我们可以基于公开财报和行业报告继续分析。"

### 场景4：要求撰写完整商业计划书
**应对：**
"战略分析报告可以作为商业计划书的市场分析章节。
完整的商业计划书还需要：
- 商业模式设计
- 运营计划
- 财务预测
- 团队介绍

建议这些部分由您或专业顾问补充。"

### 场景5：闲聊式对话
**应对：**
"为确保高效完成分析，建议我们保持聚焦。
您希望继续讨论[当前分析话题]，
还是调整分析方向？"

---

## 最终输出前自检

### 专业身份一致性
- [ ] 我是否始终保持麦肯锡顾问的专业口吻？
- [ ] 我是否避免了随意性的口语表达？
- [ ] 我是否对超出范围的问题保持了专业边界？

### 分析框架完整性
- [ ] 报告是否应用了至少3个核心分析框架？
- [ ] 每个框架的应用是否规范？
- [ ] 框架之间是否有逻辑关联？

### 结论与建议质量
- [ ] 结论是否有数据或逻辑支撑？
- [ ] 建议是否具体、可执行？
- [ ] 是否明确指出了不确定性？

---

## 质量红线（出现以下情况需重写）

- [ ] 报告中出现"我觉得""可能""大概"等无依据臆断
- [ ] 关键结论无数据或框架支撑
- [ ] 遗漏核心分析框架（五力/市场规模/竞争格局）
- [ ] 语言口语化，缺乏专业性
- [ ] 对超出范围请求未作处理，随意应付


path: checklists/pre_analysis.md
content: # 分析前检查清单

## 需求访谈检查项

### 用户身份确认
- [ ] 明确用户角色（CEO/高管/学生/新进入者）
- [ ] 了解用户所在企业/机构背景
- [ ] 确定用户的行业经验和认知水平
- [ ] 明确用户的时间紧迫程度

### 决策问题澄清
- [ ] 具体行业名称和边界范围
- [ ] 核心决策问题（进入/投资/竞争/学习）
- [ ] 决策时间框架（短期/中期/长期）
- [ ] 资源约束条件
- [ ] 关键假设和已知信息

### 分析范围确认
- [ ] 地理范围（全国/区域/全球）
- [ ] 细分市场（全市场/细分领域）
- [ ] 时间范围（历史回顾/现状/未来预测）
- [ ] 重点关注的分析维度

### 输出要求确认
- [ ] 报告形式（摘要/完整/学习版）
- [ ] 交付时间
- [ ] 是否需要可视化
- [ ] 是否需要持续监控建议

---

## 分析框架选择指南

### 根据决策问题选择框架

| 决策问题 | 必选框架 | 可选框架 | 重点输出 |
|---------|---------|---------|---------|
| 是否进入该行业？ | 五力模型 + 市场规模 | CSF、价值链 | 进入策略建议 |
| 竞争策略制定 | 竞争格局 + CSF | 五力、价值链 | 差异化定位 |
| 投资决策 | 市场规模 + 趋势 | 五力、竞争格局 | 投资价值评估 |
| 行业全面学习 | 全部框架 | - | 完整认知地图 |
| 趋势判断 | 趋势分析 + 情景规划 | 五力 | 战略应对建议 |

### 根据用户类型调整深度

| 用户类型 | 框架深度 | 方法论解释 | 案例需求 |
|---------|---------|-----------|---------|
| CEO | 应用层面 | 简要 | 1-2个相关 |
| 高管 | 应用+原理 | 适度 | 2-3个相关 |
| 学生 | 完整+方法论 | 详细 | 3-5个详细 |
| 新进入者 | 应用+入门 | 适度 | 2-3个基础 |

---

## 快速启动问题模板

### 开场问题（必问）
1. "您关注的是哪个具体行业？（请给出准确的行业名称）"
2. "您当前的角色是什么？（CEO/高管/学生/其他）"
3. "您面临的核心问题是什么？（想解决什么决策问题）"
4. "您对这个行业目前的了解程度如何？"
5. "您希望什么时候得到分析结果？"

### 深入问题（根据情况）
- "您是否已经有一些初步想法或假设？"
- "是否有特定的竞争对手需要重点关注？"
- "您的资源约束是什么？（资金/时间/人力）"
- "地理范围是全国还是特定区域？"
- "是否需要和您现有的业务进行对比分析？"


path: checklists/quality_check.md
content: # 报告质量检查清单

## 结构完整性

### 必含章节
- [ ] 执行摘要（核心结论+关键数据+行动建议）
- [ ] 数据溯源与可信度说明 ⭐ 新增必须章节
- [ ] 行业结构分析（五力模型）
- [ ] 市场规模分析
- [ ] 竞争格局分析
- [ ] 趋势分析
- [ ] 关键成功因素
- [ ] 战略建议
- [ ] 附录（数据来源）

### 完整性检查
- [ ] 每个章节有明确标题
- [ ] 章节间逻辑连贯
- [ ] 结论与数据支撑一致
- [ ] 建议与问题对应

### 结构一致性检查（新增）
- [ ] 章节顺序符合标准（执行摘要→数据溯源→行业概览→五力→市场规模→竞争格局→价值链→趋势→CSF→战略启示→附录）
- [ ] 章节命名使用标准标题
- [ ] 表格格式统一（关键数据表包含提取方式列）
- [ ] 评级标准一致（可信度用★星级，优先级用P1/P2/P3）

---

## 数据质量

### 准确性
- [ ] 所有数据有明确来源
- [ ] 关键数据有交叉验证
- [ ] 数据口径一致
- [ ] 数据时效性说明

### 可信度标注
- [ ] 高可信度数据（政府/财报）已标注
- [ ] 中等可信度数据已标注来源
- [ ] 推算/预测数据已说明假设

### 数据透明度（新增）
- [ ] 直接引用数据 vs 推算数据已明确区分
- [ ] 推算数据的计算公式/逻辑已说明
- [ ] 数据时效性分布已说明（2024/2023/更早）
- [ ] 数据缺口和局限已坦诚说明
- [ ] 使用了标准可信度星级（★★★★★）
- [ ] 执行摘要中有数据时效性提示
- [ ] 多模态数据已标注提取方式（PDF提取/网页抓取/OCR识别/直接引用）

---

## 分析质量

### 逻辑性
- [ ] 分析框架应用正确
- [ ] 因果关系清晰
- [ ] 避免了幸存者偏差
- [ ] 考虑了反面证据

### 深度
- [ ] 不仅描述现象，解释原因
- [ ] 不仅罗列数据，形成洞察
- [ ] 区分事实判断和假设推断
- [ ] 指出分析局限

---

## 输出适配

### 用户类型适配
| 检查项 | CEO版 | 高管版 | 学生版 |
|-------|-------|-------|-------|
| 执行摘要在前 | 必须 | 推荐 | 可选 |
| 方法论解释 | 简要 | 适度 | 详细 |
| 案例数量 | 1-2 | 2-3 | 3-5 |
| 行动建议详细 | 必须 | 必须 | 可选 |
| 学习检查清单 | 否 | 否 | 必须 |

---

## 语言与格式

### 专业性
- [ ] 术语使用准确
- [ ] 避免口语化表达
- [ ] 单位使用规范
- [ ] 图表标题清晰

### 可读性
- [ ] 段落长度适中
- [ ] 关键结论前置
- [ ] 表格格式正确
- [ ] 层次分明（标题层级）

---

## 合规与边界

### 免责声明
- [ ] 包含数据局限说明
- [ ] 包含时效性说明
- [ ] 建议专业咨询提示

### 敏感信息
- [ ] 未假设用户敏感信息
- [ ] 未泄露可能涉密内容

---

## 最终检查

### 发布前必做
- [ ] 通读全文检查流畅度
- [ ] 核对所有数据准确性
- [ ] 确认格式正确（表格/列表）
- [ ] 检查错别字
- [ ] 确认用户问题已回答

### 交付确认
- [ ] 报告交付用户
- [ ] 询问是否需要调整
- [ ] 询问是否需要深度专题
- [ ] 询问是否需要持续监控


path: tools/data_collector.py
content: #!/usr/bin/env python3
"""
战略分析数据收集工具
用于系统化收集和整理行业分析数据
"""

import json
import re
from datetime import datetime
from typing import Dict, List, Optional, Any
from dataclasses import dataclass, asdict


@dataclass
class DataPoint:
    """单个数据点"""
    item: str           # 数据项名称
    value: str          # 数值
    source: str         # 来源
    date: str           # 发布时间
    reliability: int    # 可信度 1-5
    extract_method: str = "直接引用"  # 提取方式：直接引用/PDF提取/网页抓取/OCR识别
    notes: str = ""     # 备注
    source_url: str = ""  # 来源链接

    def to_dict(self) -> Dict:
        return asdict(self)

    def to_markdown_row(self) -> str:
        stars = "★" * self.reliability + "☆" * (5 - self.reliability)
        source_display = f"[{self.source}]({self.source_url})" if self.source_url else self.source
        return f"| {self.item} | {self.value} | {source_display} | {self.date} | {stars} | {self.extract_method} | {self.notes} |"


class IndustryDataCollector:
    """行业数据收集器"""

    def __init__(self, industry_name: str):
        self.industry = industry_name
        self.data = {
            "market_size": [],      # 市场规模
            "growth": [],           # 增长率
            "competition": [],      # 竞争格局
            "policy": [],           # 政策法规
            "financing": [],        # 投融资
            "trends": [],           # 趋势数据
            "players": [],          # 主要玩家
        }
        self.collection_log = []
        self.search_results: List[Dict[str, Any]] = []  # 原始搜索记录

    def add_market_size(self, value: str, source: str, date: str,
                        reliability: int, extract_method: str = "直接引用", notes: str = "", source_url: str = ""):
        """添加市场规模数据

        Args:
            extract_method: 提取方式（直接引用/PDF提取/网页抓取/OCR识别）
            source_url: 来源链接
        """
        dp = DataPoint("市场规模", value, source, date, reliability, extract_method, notes, source_url)
        self.data["market_size"].append(dp)
        self._log(f"添加市场规模: {value} from {source} ({extract_method})")

    def add_growth_rate(self, value: str, source: str, date: str,
                        reliability: int, extract_method: str = "直接引用", notes: str = "", source_url: str = ""):
        """添加增长率数据

        Args:
            extract_method: 提取方式（直接引用/PDF提取/网页抓取/OCR识别）
            source_url: 来源链接
        """
        dp = DataPoint("增长率", value, source, date, reliability, extract_method, notes, source_url)
        self.data["growth"].append(dp)
        self._log(f"添加增长率: {value} from {source} ({extract_method})")

    def add_competition_data(self, item: str, value: str, source: str,
                             date: str, reliability: int, extract_method: str = "直接引用", notes: str = "", source_url: str = ""):
        """添加竞争格局数据

        Args:
            extract_method: 提取方式（直接引用/PDF提取/网页抓取/OCR识别）
            source_url: 来源链接
        """
        dp = DataPoint(item, value, source, date, reliability, extract_method, notes, source_url)
        self.data["competition"].append(dp)
        self._log(f"添加竞争数据: {item}={value} ({extract_method})")

    def add_player(self, name: str, description: str, source: str,
                   date: str, reliability: int, extract_method: str = "直接引用", source_url: str = ""):
        """添加主要玩家信息

        Args:
            extract_method: 提取方式（直接引用/PDF提取/网页抓取/OCR识别）
            source_url: 来源链接
        """
        dp = DataPoint(name, description, source, date, reliability, extract_method, source_url=source_url)
        self.data["players"].append(dp)
        self._log(f"添加玩家: {name} ({extract_method})")

    def add_policy(self, policy_name: str, content: str, source: str,
                   date: str, reliability: int, extract_method: str = "直接引用", impact: str = "", source_url: str = ""):
        """添加政策法规

        Args:
            extract_method: 提取方式（直接引用/PDF提取/网页抓取/OCR识别）
            source_url: 来源链接
        """
        notes = f"影响: {impact}" if impact else ""
        dp = DataPoint(policy_name, content, source, date, reliability, extract_method, notes, source_url)
        self.data["policy"].append(dp)
        self._log(f"添加政策: {policy_name} ({extract_method})")

    def add_financing(self, company: str, amount: str, round_type: str,
                      source: str, date: str, reliability: int, extract_method: str = "直接引用", source_url: str = ""):
        """添加融资事件

        Args:
            extract_method: 提取方式（直接引用/PDF提取/网页抓取/OCR识别）
            source_url: 来源链接
        """
        value = f"{amount} ({round_type})"
        dp = DataPoint(company, value, source, date, reliability, extract_method, source_url=source_url)
        self.data["financing"].append(dp)
        self._log(f"添加融资: {company} {amount} ({extract_method})")

    def generate_summary_table(self) -> str:
        """生成汇总表格"""
        lines = [f"## {self.industry} 数据收集汇总\n"]
        lines.append(f"> 收集时间: {datetime.now().strftime('%Y-%m-%d %H:%M')}\n")

        for category, datapoints in self.data.items():
            if not datapoints:
                continue

            category_names = {
                "market_size": "市场规模",
                "growth": "增长数据",
                "competition": "竞争格局",
                "policy": "政策法规",
                "financing": "投融资",
                "trends": "趋势数据",
                "players": "主要玩家",
            }

            lines.append(f"\n### {category_names.get(category, category)}\n")
            lines.append("| 数据项 | 数值 | 来源 | 发布时间 | 可信度 | 提取方式 | 备注 |")
            lines.append("|-------|------|-----|---------|-------|---------|-----|")

            for dp in datapoints:
                lines.append(dp.to_markdown_row())

            lines.append("")

        return "\n".join(lines)

    def add_search_result(self, query: str, source: str, url: str,
                          snippet: str, tool_used: str = "WebSearch"):
        """添加原始搜索记录"""
        record = {
            "query": query,
            "source": source,
            "url": url,
            "snippet": snippet,
            "tool_used": tool_used,
            "timestamp": datetime.now().isoformat(),
        }
        self.search_results.append(record)
        self._log(f"记录搜索: [{tool_used}] {query} -> {source}")

    def generate_data_collection_md(self) -> str:
        """生成数据收集原始记录 Markdown"""
        lines = [
            f"# {self.industry} 数据收集原始记录",
            "",
            f"> 生成时间: {datetime.now().strftime('%Y-%m-%d %H:%M:%S')}",
            "",
            "## 1. 搜索记录",
            "",
        ]

        if self.search_results:
            lines.append("| 搜索关键词 | 工具 | 来源 | URL | 原始摘要 | 记录时间 |")
            lines.append("|-----------|-----|------|-----|---------|---------|")
            for r in self.search_results:
                snippet = r['snippet'].replace('|', '\\|').replace('\n', ' ')
                url = r['url'].replace('|', '\\|')
                query = r['query'].replace('|', '\\|')
                source = r['source'].replace('|', '\\|')
                tool = r['tool_used'].replace('|', '\\|')
                ts = r['timestamp'][:19]
                lines.append(f"| {query} | {tool} | {source} | [{url}]({url}) | {snippet[:80]}{'...' if len(snippet) > 80 else ''} | {ts} |")
        else:
            lines.append("> 暂无搜索记录")

        lines.extend([
            "",
            "---",
            "",
            "## 2. 整理后数据",
            "",
        ])
        lines.append(self.generate_summary_table())

        lines.extend([
            "",
            "---",
            "",
            "## 3. 未验证 / 待确认数据",
            "",
        ])

        pending = []
        for category, datapoints in self.data.items():
            for dp in datapoints:
                if dp.reliability <= 2 or not dp.source_url:
                    pending.append(dp)

        if pending:
            lines.append("| 数据项 | 数值 | 来源 | 可信度 | 缺失/待确认项 |")
            lines.append("|-------|------|-----|-------|--------------|")
            for dp in pending:
                stars = "★" * dp.reliability + "☆" * (5 - dp.reliability)
                issue = "来源链接缺失" if not dp.source_url else "可信度较低，建议复核"
                lines.append(f"| {dp.item} | {dp.value} | {dp.source} | {stars} | {issue} |")
        else:
            lines.append("> 所有关键数据均已标注来源链接并通过可信度校验。")

        lines.append("")
        return "\n".join(lines)

    def save_data_collection_md(self, filepath: str = "data_collection.md"):
        """保存数据收集原始记录到文件"""
        md_content = self.generate_data_collection_md()
        with open(filepath, 'w', encoding='utf-8') as f:
            f.write(md_content)
        print(f"数据收集原始记录已保存至: {filepath}")

    def export_json(self, filepath: str):
        """导出为JSON"""
        export_data = {
            "industry": self.industry,
            "export_time": datetime.now().isoformat(),
            "data": {
                k: [dp.to_dict() for dp in v]
                for k, v in self.data.items()
            },
            "log": self.collection_log
        }
        with open(filepath, 'w', encoding='utf-8') as f:
            json.dump(export_data, f, ensure_ascii=False, indent=2)

    def _log(self, message: str):
        """记录日志"""
        timestamp = datetime.now().strftime('%H:%M:%S')
        self.collection_log.append(f"[{timestamp}] {message}")


class SearchQueryGenerator:
    """搜索关键词生成器"""

    def __init__(self, industry: str):
        self.industry = industry

    def generate_queries(self) -> Dict[str, List[str]]:
        """生成各维度的搜索关键词"""
        return {
            "市场规模": [
                f"{self.industry} 市场规模 2024",
                f"{self.industry} 市场容量 TAM",
                f"{self.industry} 行业报告 艾瑞/易观",
            ],
            "竞争格局": [
                f"{self.industry} 竞争格局 CR5",
                f"{self.industry} 市场份额 排名",
                f"{self.industry} 主要企业",
            ],
            "发展趋势": [
                f"{self.industry} 发展趋势 2024",
                f"{self.industry} 前景预测",
                f"{self.industry} 投资热度",
            ],
            "政策法规": [
                f"{self.industry} 政策 2024",
                f"{self.industry} 监管",
                f"{self.industry} 国家标准",
            ],
            "融资动态": [
                f"{self.industry} 融资 2024",
                f"{self.industry} 投资事件",
                f"{self.industry} 独角兽",
            ],
        }

    def print_search_plan(self):
        """打印搜索计划"""
        queries = self.generate_queries()
        print(f"\n=== {self.industry} 行业数据收集搜索计划 ===\n")
        for category, query_list in queries.items():
            print(f"\n【{category}】")
            for i, q in enumerate(query_list, 1):
                print(f"  {i}. {q}")
        print("\n" + "="*50)


def create_collector(industry: str) -> IndustryDataCollector:
    """创建数据收集器（便捷函数）"""
    return IndustryDataCollector(industry)


def generate_search_plan(industry: str):
    """生成搜索计划（便捷函数）"""
    generator = SearchQueryGenerator(industry)
    generator.print_search_plan()


if __name__ == "__main__":
    # 示例用法
    import sys

    if len(sys.argv) > 1:
        industry = sys.argv[1]
        generate_search_plan(industry)
    else:
        print("用法: python data_collector.py '行业名称'")
        print("示例: python data_collector.py '新能源汽车'")


path: tools/quality_gate.py
content: #!/usr/bin/env python3
"""
战略分析报告质量门禁
在最终输出前进行专业性检查
"""

from typing import List, Tuple


class ReportQualityGate:
    """报告质量门禁 - 确保专业性"""

    # 核心分析框架（至少要有3个）
    REQUIRED_FRAMEWORKS = [
        "波特五力模型",
        "市场规模测算",
        "竞争格局分析",
        "PESTEL趋势分析",
        "价值链分析",
        "关键成功因素",
    ]

    # 必须包含的章节
    REQUIRED_SECTIONS = [
        "执行摘要",
        "数据溯源与可信度说明",
        "行业概览",
        "行业结构分析",
        "市场规模与增长",
        "竞争格局",
        "战略启示",
    ]

    # 禁用词（非专业表达）
    FORBIDDEN_WORDS = [
        "我觉得",
        "可能吧",
        "大概",
        "应该",
        "也许",
        "差不多",
        "说白了",
        "其实吧",
    ]

    # 专业术语列表
    PROFESSIONAL_TERMS = [
        "波特五力",
        "TAM",
        "SAM",
        "SOM",
        "PESTEL",
        "价值链",
        "战略群组",
        "关键成功因素",
        "CSF",
        "进入壁垒",
        "规模效应",
        "转换成本",
        "议价能力",
        "市场集中度",
        "CR4",
        "HHI",
    ]

    # 标准章节顺序（必须严格遵循）
    STANDARD_SECTION_ORDER = [
        "执行摘要",
        "数据溯源与可信度说明",
        "行业概览",
        "行业结构分析",
        "市场规模与增长",
        "竞争格局",
        "价值链分析",
        "关键趋势",
        "关键成功因素",
        "战略启示",
        "附录",
    ]

    # 标准表格格式检查
    STANDARD_TABLE_PATTERNS = [
        ("关键数据表", r"\| 指标 \| 数值 \| 来源 \| 可信度 \|"),
        ("五力评估表", r"\| 力量 \| 强度\(1-5\) \| 趋势 \| 关键因素 \|"),
        ("市场规模表", r"\| 层级 \| 规模 \| 测算方法 \| 关键假设 \|"),
        ("竞争格局表", r"\| 群组 \| 价格带 \| 代表企业 \| 核心策略 \|"),
        ("趋势影响表", r"\| 趋势 \| 紧迫性 \| 影响程度 \| 确定性 \| 优先级 \|"),
        ("数据溯源表", r"\| 数据项 \| 数值 \| 来源 \| 发布时间 \| 可信度 \| 提取方式 \|"),
    ]

    def __init__(self, report_content: str):
        self.content = report_content
        self.issues: List[Tuple[str, str]] = []  # (问题类型, 具体描述)

    def check_structure(self) -> bool:
        """检查报告结构完整性"""
        passed = True
        for section in self.REQUIRED_SECTIONS:
            if section not in self.content:
                self.issues.append(("结构缺失", f"缺少必要章节：{section}"))
                passed = False
        return passed

    def check_frameworks(self) -> Tuple[bool, int]:
        """检查核心框架应用数量"""
        count = 0
        found_frameworks = []

        for framework in self.REQUIRED_FRAMEWORKS:
            if framework.replace("模型", "").replace("分析", "").replace("测算", "") in self.content.replace("模型", "").replace("分析", "").replace("测算", ""):
                count += 1
                found_frameworks.append(framework)

        if count < 3:
            self.issues.append(
                ("框架不足", f"只应用了{count}个核心框架（至少需3个），已找到：{found_frameworks}")
            )
            return False, count

        return True, count

    def check_language(self) -> bool:
        """检查语言专业性"""
        passed = True
        found_words = []

        for word in self.FORBIDDEN_WORDS:
            if word in self.content:
                found_words.append(word)

        if found_words:
            self.issues.append(
                ("语言不专业", f"发现非专业表达：{found_words}，请改为基于数据/框架的客观陈述")
            )
            passed = False

        return passed

    def check_professional_terms(self) -> Tuple[bool, int]:
        """检查专业术语使用"""
        count = 0
        found_terms = []

        for term in self.PROFESSIONAL_TERMS:
            if term in self.content:
                count += 1
                found_terms.append(term)

        if count < 3:
            self.issues.append(
                ("术语不足", f"专业术语使用较少（{count}个），建议增加战略分析术语")
            )
            return False, count

        return True, count

    def check_section_order(self) -> bool:
        """检查章节顺序是否符合标准"""
        passed = True
        found_sections = []

        for section in self.STANDARD_SECTION_ORDER:
            if section in self.content:
                found_sections.append(section)

        # 检查章节顺序
        last_index = -1
        for section in found_sections:
            current_index = self.content.find(section)
            if current_index < last_index:
                self.issues.append(
                    ("章节顺序错误", f"章节'{section}'位置不符合标准顺序")
                )
                passed = False
            last_index = current_index

        # 检查关键章节是否缺失
        critical_sections = ["执行摘要", "行业结构分析", "市场规模与增长", "竞争格局"]
        for section in critical_sections:
            if section not in found_sections:
                self.issues.append(("关键章节缺失", f"缺少必要章节：{section}"))
                passed = False

        return passed

    def check_table_consistency(self) -> bool:
        """检查表格格式一致性"""
        passed = True

        # 检查是否有表格
        if "|" not in self.content:
            self.issues.append(("表格缺失", "报告中缺少数据表格"))
            return False

        # 检查关键数据表格式
        if "市场规模" in self.content and "TAM" in self.content:
            if "| 层级 | 规模 | 测算方法 | 关键假设 |" not in self.content:
                self.issues.append(
                    ("表格格式不规范", "市场规模表格式不符合标准（应为：层级|规模|测算方法|关键假设）")
                )
                passed = False

        return passed

    def check_rating_consistency(self) -> bool:
        """检查评级标准一致性"""
        passed = True

        # 检查是否使用星级和P1/P2/P3
        has_stars = "★" in self.content
        has_priority = "P1" in self.content or "P2" in self.content or "P3" in self.content

        if not has_stars:
            self.issues.append(("评级标准", "缺少可信度星级标注（★★★★★）"))
            passed = False

        if not has_priority:
            self.issues.append(("评级标准", "缺少优先级标注（P1/P2/P3）"))
            passed = False

        return passed

    def check_data_transparency(self) -> bool:
        """检查数据透明度"""
        passed = True

        # 检查是否有可信度星级
        if "★" not in self.content:
            self.issues.append(("数据透明度", "缺少数据可信度星级标注（★★★★★）"))
            passed = False

        # 检查是否有来源标注
        if "来源" not in self.content and "数据溯源" not in self.content:
            self.issues.append(("数据透明度", "缺少数据来源说明"))
            passed = False

        # 检查是否有推算说明
        if "估算" in self.content and "推算方法" not in self.content and "置信区间" not in self.content:
            self.issues.append(("数据透明度", "有估算数据但未说明推算方法和置信区间"))
            passed = False

        return passed

    def check_actionable(self) -> bool:
        """检查建议是否可执行"""
        passed = True

        if "建议行动" not in self.content and "战略建议" not in self.content:
            self.issues.append(("缺少建议", "报告缺少战略建议或行动清单章节"))
            passed = False

        # 检查是否有具体行动项
        if "[ ]" not in self.content and "- [ ]" not in self.content:
            self.issues.append(("建议不具体", "建议缺少具体的行动检查清单"))
            passed = False

        return passed

    def run_all_checks(self) -> Tuple[bool, List]:
        """运行所有检查"""
        checks = [
            ("结构完整性", self.check_structure()),
            ("章节顺序", self.check_section_order()),
            ("框架应用", self.check_frameworks()[0]),
            ("语言专业性", self.check_language()),
            ("术语使用", self.check_professional_terms()[0]),
            ("表格一致性", self.check_table_consistency()),
            ("评级标准一致性", self.check_rating_consistency()),
            ("数据透明度", self.check_data_transparency()),
            ("可执行性", self.check_actionable()),
        ]

        all_passed = all(passed for _, passed in checks)

        return all_passed, self.issues

    def generate_report(self) -> str:
        """生成质量检查报告"""
        all_passed, issues = self.run_all_checks()

        lines = ["## 报告质量门禁检查结果\n"]

        if all_passed:
            lines.append("✅ **所有检查通过，报告符合专业标准**\n")
        else:
            lines.append("⚠️ **发现以下问题，请修正后再提交：**\n")

        if issues:
            lines.append("\n### 待修正问题\n")
            for i, (issue_type, description) in enumerate(issues, 1):
                lines.append(f"{i}. **{issue_type}**：{description}")

        lines.append("\n### 检查项详情\n")

        # 框架统计
        _, framework_count = self.check_frameworks()
        lines.append(f"- 核心框架应用：{framework_count}/6 {'✅' if framework_count >= 3 else '⚠️'}")

        # 术语统计
        _, term_count = self.check_professional_terms()
        lines.append(f"- 专业术语使用：{term_count}+ {'✅' if term_count >= 3 else '⚠️'}")

        # 结构一致性统计
        section_ok = self.check_section_order()
        lines.append(f"- 章节顺序规范：{'✅ 符合标准' if section_ok else '⚠️ 存在问题'}")

        # 表格一致性
        table_ok = self.check_table_consistency()
        lines.append(f"- 表格格式规范：{'✅ 符合标准' if table_ok else '⚠️ 存在问题'}")

        # 评级一致性
        rating_ok = self.check_rating_consistency()
        lines.append(f"- 评级标准规范：{'✅ 符合标准' if rating_ok else '⚠️ 存在问题'}")

        lines.append("")
        return "\n".join(lines)


def quick_check(report_content: str) -> bool:
    """快速检查（便捷函数）"""
    gate = ReportQualityGate(report_content)
    passed, issues = gate.run_all_checks()

    if not passed:
        print(gate.generate_report())

    return passed




Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (HIGH)