| name | ivr-chapter-earnings |
| description | 撰写投价报告「盈利预测」章节（分业务收入预测/量价拆分/毛利率/费用率/完整财务预测表）。当用户要求写投价报告盈利预测、营收拆分、量价拆分、毛利率预测、费用率预测、财务预测汇总时触发。 |
投价报告：盈利预测
本 skill 撰写投价报告「盈利预测」章节。
共享基座规范（模型只读、输出铁律、样本使用、原创性检查、工具说明）由 ivr-base 定义。
1. 输入
| 输入 | 来源 | 说明 |
|---|
<模型.xlsx> | session_variables.financial_model_path | 投价报告体系标准财务模型，必选 |
<语料目录> | 用户上传 | 招股书/问询函/落实函等 PDF，可选 |
获取财务模型路径：从 session_variables.financial_model_path 读取。
若该变量为空，提示用户先通过 ivr_upload_financial_model 工具注册财务模型文件。
2. 工作流
2.1 引擎准备（确定性数据）
python scripts/build_earnings.py {financial_model_path} _out
其中 {financial_model_path} 从 session_variables.financial_model_path 获取。
引擎产出：
_out/盈利预测_骨架.md — 表格/数字/工作单/自检（不写依据和判断性叙述）_out/盈利预测_工作单.json — 结构化工作单（业务线/占比/详略档/驱动行/自检）
2.2 表格生成（数据驱动）
python scripts/gen_tables.py {financial_model_path} _out
引擎产出：
_out/tables_gen.md — 全部表格的 Markdown（按 <<TBL:key>> 命名）_out/table_keys.json — 表格 key 到业务线的映射表
表格 key 命名规则：
driver_<slug> — 各业务线的量价驱动表（slug 从业务线名自动生成）gross_margin — 毛利率预测表expense_ratio — 费用率预测表full_forecast — 完整财务预测表risk_adj — 经风险调整收入表（如有风险因子 sheet）legacy — 原有业务表（如有）
2.3 AI 写正文
按下方铁律，逐工作单写正文。每个板块/业务线：
- 先定官方口径：从招股书“主营业务/产品介绍”章节抄录产品大类及下属产品，形成官方口径对照表。
- 读引擎表格：从系统注入的
<engine_tables> 块中读取对应表格（引擎已按 H3F3 生成）。
- 用
ivr_search_rag 检索招股书/问询函原文作为假设依据。
- 写「定义 + 占比 → 量 → 价 → 小结」的完整叙述。
- 直接复制引擎表格到正文中（不得修改表格内容）。
- 语料缺失的依据进入
_out/盈利预测_待补底稿.md，不进正文。
2.4 输出
_out/盈利预测_报告.md — 干净正文（可直接挂网）_out/盈利预测_待补底稿.md — 待补清单（不进报告）
3. 章节结构（固定编号，必须严格遵循）
章节结构必须与 skill.schema.yaml 一致，OutputValidator 会严格校验。
## 2. 盈利预测
### 2.1 分业务收入预测（量价拆分）
- 按招股书官方口径分板块；每个板块用 2.1.x 四级标题
- 每个板块：定义+历史占比 → 量 → 价 → 小结句 → 量价表
### 2.2 毛利率预测
- 综合毛利率趋势
- 分板块/关键产品毛利率逻辑
- 毛利率表
### 2.3 费用预测
- 销售/管理/研发/财务/税金等费用率
- 费用率表
### 2.4 盈利预测汇总（完整财务预测表）
- 固定句式结论
- 完整利润表预测
不新增 2.5、2.6；不把敏感性或估值内容写入本章。
4. 盈利预测铁律
4.1 报告可直接挂网
- 正文必须专业、通顺、终稿级。
- 严禁出现任何
【待确认】/【待资料确认】/【依据待补】/“暂无公开数据支撑”等过程性标注。
- 以模型数据为既定事实正常成稿；缺依据只进待补底稿。
- 禁用“模型预测/模型假设”，用“我们预计/我们认为/我们判断”。
4.2 收入拆分口径：先定义后预测
分产品/分类别做营收预测前，必须先以招股书官方口径确定“每个类别包含哪些产品”。
强制流程：
- 打开招股书“主营业务/产品介绍”章节，抄录各产品大类及下属产品清单。
- 每个板块的第一句必须是“定义 + 范围 + 历史营收占比”。
- 把报告里每个产品名回查其在招股书中的归属，发现不一致立即改。
4.3 量价拆分粒度
- 顶层大类必拆：模型收入拆分的每个顶层大类，原则上对应
2.1.x 一个小节。
- 大类内产品按驱动逻辑判断：
- 量是否共享同一增长逻辑？
- 价是否共享同一定价逻辑？
- 都“是” → 可以合并叙述，但表格仍逐产品逐行列示。
- 任一“否” → 逐产品/产品线拆开写各自驱动链。
- 合并只限同一大类节内，不能跨大类合并。
4.4 量价依据：三要素 + 量价错开呈现
销量/单价/增速论证不能只报数值，必须覆盖三个要素：
- 行业整体趋势：行业规模、增速、周期、国产化率、渗透率等。
- 公司产品地位：客户、技术、份额、认证、产品矩阵等。
- 核心增长驱动：订单、募投、产品升级、新品放量、国产替代、价格结构变化等。
呈现方式：
- 量的论证可用分点式（行业趋势/公司地位/核心驱动）。
- 价的论证改用叙述式，把三要素融入一段话，避免和量段套同一模板。
4.5 表格规则：H3F3 + 逐行
- 所有“含历史 + 预测”的盈利预测表统一为历史 3 年 + 预测 3 年。
- 适用：收入量价驱动表、经风险调整收入表、毛利率表、费用率表、完整财务预测表。
- 估值章 DCF/FCFF 现金流表不属于本章，由
ivr-chapter-valuation 处理。
- 收入预测部分的表格一律不写毛利率行；毛利率单独在
2.2 成节成表。
- 每个指标单独占一行，禁止把“收入｜销量｜单价”挤进同一格。
- 凡正文单独分析过的产品/品类，都必须在表里逐行列出；存在量价关系的，应列收入、销量、单价/ASP。
- 分产品收入加总应能核对到板块汇总。
4.6 表格随文
- 先讲假设与逻辑，再放表格。
- 每个重要盈利预测元素的总述/假设文字下方紧跟对应表格。
- 表格必须从
<engine_tables> 直接复制，不得自行编造或修改内容。
- 如果
<engine_tables> 没有对应表格，写入待补底稿，不得在正文留下“引擎未生成”之类标注。
4.7 不写“整体”小标题
细分项讲完后的板块小结，直接在该板块量价表下方用正文承接，例如：
综合上述分析，我们预计 2026—2028 年半导体关键工艺零部件收入分别为……
不要单列“（N）××整体”这种标题。
4.8 管线/biotech 型公司专项
若模型含 风险因子 sheet：
- 必须呈现风险调整框架：未/经风险调整收入、各管线假设成功率。
- 保留模型的占比口径标签，如“HY1001 全适应症 = 肝硬化低白 + 其他适应症”。
- 诊疗指南、集采价、发病率、临床成功率文献等依据，语料命中则用原创措辞引述；命不中进入待补底稿。
5. 数据来源与检索规范
5.1 数据来源区分（强制）
| 数据类型 | 来源 | AI 处理方式 |
|---|
| 预测数字（收入/毛利率/费用率/利润） | 模型 / <engine_tables> | 直接引用，不从 RAG 检索 |
| 历史数字（历史收入/毛利率/费用率） | 模型 / <engine_tables> | 直接引用，不从 RAG 检索 |
| 表格数据（量价驱动表/毛利率表/费用率表） | 模型 / <engine_tables> | 直接复制，不修改 |
| 官方产品口径 | 招股书/招股意向书 | 写收入拆分前先核对 |
| 假设依据（为什么取这个值） | 招股书/问询函/落实函等语料 | 用 ivr_search_rag 检索，原创转述 |
| 行业数据（市场规模/渗透率/竞争格局） | 用户语料 | 用 ivr_search_rag 检索 |
⛔ 禁止从 RAG 检索预测数字：预测收入、毛利率、费用率等数字必须来自模型。
5.2 写作流程（强制）
- 建官方口径对照表。
- 读取
<engine_tables> 中的 H3F3 表格。
- 对关键假设检索语料依据。
- 写专业正文，不暴露模型过程。
- 复制引擎表格。
- 将缺来源项写入
_out/盈利预测_待补底稿.md。
- 成稿前按
ivr-base 要求做原创性检查。
5.3 RAG 检索词表（仅用于检索“依据”）
| 检索场景 | 建议关键词 | 用途 |
|---|
| 官方产品口径 | 主营业务、产品介绍、主要产品、业务构成 | 建板块/产品归属表 |
| 行业趋势 | 市场规模、增长率、行业空间、国产化率、周期 | 解释销量/收入增速 |
| 公司地位 | 核心客户、技术水平、市场份额、认证、竞争格局 | 解释公司能否兑现增长 |
| 核心驱动 | 在手订单、募投项目、产能规划、新品、客户导入 | 支撑放量或价格假设 |
| 单价依据 | 产品结构、定价策略、竞品价格、历史单价 | 解释 ASP 变化 |
| 毛利率波动 | 成本变化、产品结构、规模效应、产能利用率 | 写毛利率逻辑 |
| 费用率依据 | 销售费用、管理费用、研发投入、财务费用、对标公司 | 写费用率逻辑 |
6. 引擎脚本说明
scripts/build_earnings.py
盈利预测引擎，产出工作单/驱动表/骨架/自检：
- reader 把「收入拆分」解析成每业务线一张工作单。
- 每条线算收入占比 → 定详略档（核心/次要）。
- 判型（量价型/增长率型）。
- 量价型做“能否乘回收入”自检。
scripts/gen_tables.py
数据驱动的表格生成器：
- 从模型动态检测年份区间和列布局。
- 所有含历史 + 预测的盈利预测表统一生成 H3F3。
- 自动为每条业务线生成驱动表，不硬编码管线名。
- 毛利率/费用率/汇总表从模型生成。
7. 自检清单
写作完成后，AI 需自检：
