Morgan Stanley 风格研究报告生成器

适用场景

核心能力

完整报告结构（17 个标准章节）

本生成器按照 Morgan Stanley 卖方研究报告标准模板，按以下顺序渲染全部章节（缺失数据字段自动跳过）：

1. 封面页 -- 公司名 / 分析师 / 评级 / 目标价 / 日期 / 研究类型
2. 目录 -- 自动生成章节导航
3. Our Thesis in N Charts -- 论点图表摘要（含 KPI 卡片）
4. 执行摘要 -- 投资论点 + 目标价 + 风险 + 催化剂 + Key Takeaways
5. 正文章节 -- 自定义多级章节（支持子章节、要点列表）
6. KPI 指标块 -- TAM / CAGR / Upside 等核心指标卡片
7. 财务数据表 -- 收入 / 利润率 / EBITDA / CAPEX / EPS（支持 YoY 自动计算）
8. 财务图表 -- 收入&EBITDA 双柱图 + 利润率折线图 + 行业配置饼图
9. 评级表格 -- Ticker / Rating / Last Close / Company / Reason
10. 60 铲子股列表 -- 排名 / 公司 / 产品 / 分析师 / 市值 / 年度涨幅
11. 产业链/价值链 -- 上中下游结构化展示
12. 铲子股详细列表 -- 含推荐逻辑的详细铲子股表格
13. 情景对比分析 -- Bear / Base / Bull 三情景财务对比
14. WACC 拆解 -- 权益成本 / 债务成本 / 资本结构（含堆叠柱状图）
15. 敏感性分析矩阵 -- 双变量敏感性表格（含交叉高亮）
16. 可比公司分析 -- EV/Revenue / EV/EBITDA / P/E 等多维度对比
17. 估值桥（Waterfall） -- 当前价到目标价的归因拆解（含瀑布图）
18. Exhibit 附录图表 -- 自定义图表页
19. 附录 -- 方法论 / 假设 / 免责声明
20. 免责声明 -- 法律披露文本

出版级图表系统

基于 matplotlib 的出版级图表渲染引擎：

• DPI 300 高清输出
• MS 8色调色板：Deep Navy / Medium Blue / Gold / Green / Orange / Red / Purple / Light Blue
• 4 种图表类型：
  • bar -- 收入&EBITDA 双柱对比图（含均值参考线 + 数值标签）
  • line -- 毛利率/EBITDA利润率/净利率折线图（含面积填充 + 数据标签）
  • pie -- 行业配置饼图（含最大扇区突出 + 图例）
  • waterfall -- 估值桥梁图（当前价 -> 目标价归因拆解，含连接线）
• Source 水印：每张图表底部自动添加 "Source: Morgan Stanley Research"
• 降级机制：matplotlib 未安装时自动降级为文字占位

Exhibit 自动编号

全局 Exhibit 计数器，按渲染顺序自动编号：

• 格式：Exhibit 1: 标题 / Exhibit 2: 标题 ...
• 覆盖：财务图表、WACC 图表、估值桥图表、附录图表
• 每次调用 make_report() 自动重置

品牌主题系统

颜色体系包含 30+ 语义化颜色常量，覆盖：

• 品牌色（navy / gold / brand_blue）
• 评级色（OW 绿 / EW 橙 / UW 红）
• DCF 语义色（输入假设黄 / 计算行绿 / 汇总行蓝紫 / CapEx 橙）
• 情景色（Bear 棕橙 / Base 深绿 / Bull 深蓝）
• 图表色（8 色调色板）

多语言支持

• zh -- 中文报告（章节标题中文）
• en -- 英文报告（章节标题英文）
• bilingual -- 双语报告（章节标题中英双语）

快速开始

Python API

from ms_research_report import make_report

data = {
    "company_name": "极光资本控股",
    "title_cn": "为下一个10倍科技周期，资本是瓶颈吗？",
    "title_en": "Financing the Next 10x Tech Cycle",
    "subtitle": "关键论点一句话：算力军备竞赛将重塑上游资本开支结构。",
    "rating": "Overweight",
    "target_price": 125.0,
    "current_price": 98.5,
    "date_str": "2026-06-12",
    "analyst": "陈嘉怡 CFA",
    "research_type": "Foundation",
    "currency": "USD",
    "key_takeaways": [
        "算力需求在未来三年预计以 35% CAGR 扩张。",
        "上游芯片与光模块厂商最受益。",
        "估值溢价将集中于具备专有硅片与供应渠道的企业。",
    ],
    "executive_summary": {
        "thesis": ["论点1", "论点2", "论点3"],
        "tp_and_upside": ["目标价 $125.0，上行 +27%。"],
        "risks": ["风险1", "风险2"],
        "catalysts": ["催化剂1", "催化剂2"],
    },
    "sections": [
        {
            "title_cn": "一、算力需求：结构性扩张",
            "title_en": "I. Compute Demand",
            "paragraphs": ["段落1", "段落2"],
            "subsections": [
                {"title": "1.1 子章节", "paragraphs": ["子段落1"]},
            ],
        },
    ],
    "metrics": [
        {"value": "$5.2T", "unit": "TAM 2026E", "label": "市场规模"},
        {"value": "35%", "unit": "CAGR '24-'28", "label": "复合增长"},
    ],
    "financial_table": {
        "headers": ["指标", "FY24", "FY25E", "FY26E", "FY27E"],
        "rows": [
            ["营业收入 ($M)", "4,810", "5,230", "5,750", "6,520"],
            ["毛利率 (%)", "52.1", "54.0", "55.5", "56.8"],
            ["EBITDA ($M)", "1,210", "1,405", "1,580", "1,820"],
        ],
        "highlight_rows": [3],
        "auto_yoy": True,
        "source": "Source: Morgan Stanley Research.",
    },
    "rating_table": [
        ["Ticker", "Rating", "Last Close", "Company", "Reason"],
        ["NVDA.O", "OW", "198.35", "Nvidia", "AI compute leader"],
    ],
}

make_report(data, "output/report.docx", theme="classic", language="zh")

CLI

# 使用内置示例数据生成报告
python scripts/run.py -o output/test_report.docx

# 使用自定义 JSON 数据文件
python scripts/run.py -o output/my_report.docx -d data.json

报告结构

标准报告的章节渲染顺序（缺失数据自动跳过）：

封面页 (Cover Page)
  |
目录 (Table of Contents)
  |
Our Thesis in N Charts [可选]
  |
执行摘要 (Executive Summary)
  |
正文章节 (Sections) x N
  |
KPI 指标块 (Key Metrics)
  |
财务数据表 (Financial Table)
  |
财务图表 (Financial Charts) [可选，需 matplotlib]
  |
评级表格 (Rating Table)
  |
60 铲子股列表 (Shovel Stocks)
  |
产业链/价值链 (Value Chain) [可选]
  |
铲子股详细列表 (Shovel Stocks List) [可选]
  |
情景对比分析 (Scenario Comparison) [可选]
  |
WACC 拆解 (WACC Breakdown) [可选]
  |
敏感性分析矩阵 (Sensitivity Analysis) [可选]
  |
可比公司分析 (Comparable Companies) [可选]
  |
估值桥 (Valuation Bridge / Waterfall) [可选]
  |
Exhibit 附录图表 [可选]
  |
附录 (Appendix)
  |
免责声明 (Disclosure)

数据字典

顶层字段

*title_cn 和 title_en 至少提供一个。

执行摘要

正文章节

KPI 指标

财务数据表

评级表格

铲子股

财务图表

行业配置

论点图表

产业链/价值链

DCF 章节

附录与披露

图表系统

MS 8 色调色板

MS_PALETTE = [
    '#1F3864',  # Deep Navy    -- 主色
    '#2E75B6',  # Medium Blue  -- 辅色
    '#C8A951',  # Gold         -- 强调
    '#00AF50',  # Green        -- 正面
    '#E37C2B',  # Orange       -- 中性
    '#B91C1C',  # Red          -- 负面
    '#6B4C9A',  # Purple       -- 辅助
    '#4A90D9',  # Light Blue   -- 辅助
]

图表类型与数据格式

bar（双柱对比图）

{"type": "bar", "title": "Revenue vs EBITDA",
 "labels": ["FY24", "FY25E", "FY26E"],
 "revenue": [4810, 5230, 5750],
 "ebitda": [1210, 1405, 1580]}

line（利润率折线图）

{"type": "line", "title": "Margin Trends",
 "labels": ["FY24", "FY25E", "FY26E"],
 "gross_margin": [52.1, 54.0, 55.5],
 "ebitda_margin": [25.2, 26.9, 27.5],
 "net_margin": [18.5, 19.8, 21.0]}

pie（行业配置饼图）

{"type": "pie", "title": "Sector Allocation",
 "labels": ["半导体", "光模块", "IDC"],
 "values": [40.0, 25.0, 10.0]}

waterfall（估值桥瀑布图）

{"type": "waterfall", "title": "Valuation Bridge",
 "labels": ["Base Business", "Growth", "Multiple Expansion", "FX"],
 "values": [15.0, 8.5, 3.0, 0.0],
 "current": 98.5, "target": 125.0}

出版级样式配置

• DPI: 300（屏幕与打印均清晰）
• 字体: Noto Sans CJK SC / DejaVu Sans / Arial
• 网格: 虚线，浅灰 #E8E8E8
• 坐标轴: 隐藏上/右边框，保留左/下
• 数值标签: 自动添加在柱顶/数据点旁
• Source 水印: 每张图表底部

Exhibit 编号

Exhibit 编号系统使用全局计数器，按渲染顺序自动递增：

Exhibit 1: 收入与 EBITDA 对比
Exhibit 2: 利润率趋势
Exhibit 3: 行业配置
Exhibit 4: WACC 拆解
Exhibit 5: 估值桥
Exhibit 6: [附录图表标题]

• 每次调用 make_report() 时计数器自动重置为 1
• 编号函数：_next_exhibit_label(title) -> "Exhibit N: title"
• Source 行自动追加："Source: Morgan Stanley Research"

主题配色

当前支持 1 套主题，颜色体系包含 30+ 语义化常量：

API 参考

make_report(data, output_path, theme, language)

主入口函数，生成完整的 MS 风格研究报告 DOCX。

def make_report(
    data: Dict[str, Any],       # 报告数据字典（所有字段可选）
    output_path: str,           # 输出 .docx 文件路径（需确保父目录存在）
    theme: str = "classic",     # 主题名称（当前仅支持 "classic"）
    language: str = "zh",       # 语言：zh / en / bilingual
) -> str:                       # 返回 output_path

参数说明：

• data -- 完整数据字典，字段均为可选。缺失字段对应章节自动跳过。
• output_path -- 输出路径。调用者需确保父目录已存在。
• theme -- 主题名称，默认 "classic"（深蓝+金）。
• language -- 语言设置，默认 "zh"。章节标题按语言显示。

返回值： 写入成功后返回 output_path。

内部函数（60+ 个）

核心渲染函数（供高级用户扩展参考）：

依赖

安装依赖：

pip install python-docx>=0.8.11 matplotlib>=3.5

示例输出

scripts/_sample_out/ 目录包含 3 份示例报告：

• achp_report_zh.docx -- 中文版
• achp_report_en.docx -- 英文版
• achp_report_bilingual.docx -- 双语版

文件结构

ms-research-report/
  SKILL.md                          # 本文档
  scripts/
    ms_research_report.py           # 核心生成模块（~3600 行）
    run.py                           # CLI 入口
    _sample_out/                     # 示例输出
      achp_report_zh.docx
      achp_report_en.docx
      achp_report_bilingual.docx
  output/                            # 默认输出目录

Author: WANG DONG JIE (@yjkj999999 | Clawhub)

Version: 1.1.0 | License: MIT | Category: Equity Research

适用于 CGMA/ACCA/CFA 持证人及卖方/买方分析师、基金经理。生成符合摩根士丹利出版标准的股票研究报告。