股票分析报告

按公司归档

招商银行（SH600036）1 份报告

以下为 tongxm-stock-analyzer 的完整分析策略说明书，与 SKILL_MANUAL.html 同步。

tongxm-stock-analyzer Skill 说明书

更新时间：2026-06-20（v4：第2步竞争分析路由化——银行五力/互联网网络效应/公用事业监管框架/医疗集采管线/通用五力；strict 默认开启 12 类检查）。只要本 skill 的流程控制、周期路由、报告策略、strict、baseline、event_alert、脚本入口、输出 JSON 结构或正式发布流程发生变化，必须同步更新本说明书。

定位：本说明书面向人类快速理解完整分析策略；实际执行规则仍以 SKILL.md、references/analysis_framework.md 和脚本为准。

1. Skill 的职责边界

模块职责
tongxm-stock-analyzer对某家公司、某个财报周期或事件生成可信数据包和分析报告。
tongxm-stock-monitor发现什么时候该分析：新财报、公告、新闻、监管事件、回购、盈警等。
event_alert主要由 monitor 触发；analyzer 只核验事件来源并分析影响，不主动无边界扫新闻。

2. 多市场周期路由

所有市场先映射到两个主维度，不维护第三个评分策略字段。

canonical_period = FY / H1 / Q1 / Q2 / Q3 / Q4 / LTM / event_update
report_depth = annual_rebuild / semiannual_check / quarterly_monitor / event_alert
用户只提供公司时不弹步骤菜单。系统先用 --check-baseline 做无网络预检：已有有效年度 baseline 时使用 period=latest 和 step=all；缺失时先建议对最近年报执行 period=FY 和 step=all。

period 决定财报口径、分析深度和 baseline 策略；step 只负责过滤输出哪些步骤。用户明确说“只做第3步”时，仍使用指定周期或默认 latest 作为数据锚点。

市场报告类型canonical_periodreport_depth
A 股年报FYannual_rebuild
A 股中报/半年度报告H1semiannual_check
A 股一季报/三季报Q1/Q3quarterly_monitor
美股10-KFYannual_rebuild
美股Q1/Q2/Q3 10-QQ1/Q2/Q3Q2 为 semiannual_check；Q1/Q3 为 quarterly_monitor
港股Annual Report / Interim ReportFY/H1annual_rebuild / semiannual_check
港股主板 Q1/Q3 缺失event_updateevent_alert，标记 not_required_by_market_rule

3. 0-5 步与周期报告分配

步骤annual_rebuildsemiannual_checkquarterly_monitorevent_alert
第0步 商业模式/文化完整重评，更新 baselinebaseline 校验，不重新完整评分baseline 触发检查，不重新评分只判断事件是否影响 baseline
第1步 财务分析完整做完整做，按半年度/累计口径完整做，按季度/累计口径事件相关才做
第2步 竞争与结构分析完整做完整做完整做事件影响竞争格局才做
第3步 估值分析完整做完整做，用 TTM/累计/预期口径完整做，禁止单季利润乘 4事件影响估值才做
第4步 股东回报完整做更新本期资本动作有动作就分析，无动作说明未变化事件涉及资本动作才做
第5步 历史回撤默认执行用户明确指定时做用户明确指定时做重大市场冲击才做
正式财报周期包括 annual_rebuild、semiannual_check、quarterly_monitor。正式财报周期必须完整执行第1步、第2步、第3步。

4. baseline 机制

baseline 是某家公司最近一次年报形成的研究基准档案，不是原始财务数据表。

baseline 固定保存在 skill 内的 baselines/{market}_{ticker}.json，不受 STOCK_ANALYZER_OUTPUT_DIR 影响。报告 JSON、图表和 HTML 仍写入外部输出目录。
{
  "ticker": "601398",
  "name": "工商银行",
  "baseline_period": "2025FY",
  "industry": "financial",
  "playbook_key": "banking",
  "playbook_status": "active",
  "business_model_rating": "...",
  "moat_sources": ["规模经济", "监管牌照", "低成本负债"],
  "main_risks": ["净息差下行", "资产质量恶化", "资本充足率下降"],
  "company_specific_watchlist": [
    {"metric": "nim", "why": "判断净息差是否企稳", "risk_trigger": "连续两期下行"}
  ],
  "company_specific_thesis": ["高股息央企", "零售低成本负债优势"],
  "company_specific_red_flags": ["关注类贷款占比持续上升", "核心一级资本逼近监管底线"]
}

schema v3 新增公司级字段：company_specific_watchlist（最该盯的指标+触发条件）、company_specific_thesis（投资逻辑）、company_specific_red_flags（触发重评红线）。行业 playbook 提供默认值，年报时按公司细化；中报/季报对照 watchlist 做触发检查。这些字段不进入商业模式评分（28/35），仅用于跨期跟踪和公司核心矛盾聚焦。

watchlist 触发检查闭环：年报建立 watchlist 后，季报（quarterly_monitor）和半年报（semiannual_check）跟进时由 baseline_watch.py 自动比对本期+历史数据。trigger 字段是结构化规则 {direction, periods, threshold, manual_check}：能自动判的判定 triggered/not_triggered/insufficient_data，无法自动判的（双指标组合等）标 manual_check 需人工，数据缺失标「需人工」不硬猜。结果写入 watchlist_result，任一指标触发恶化 → recommend_rescore=true → 报告提示「建议重新做年报完整分析」。只提醒不自动升级周期。例：腾讯 ARPU 连续两期下降 → 季报自动标红 → 提示重评。

字段职责：company_specific_watchlist 是跟踪权威（指标+触发条件，机器可判恶化）；main_risks 是风险描述（人读，如「资产质量恶化」）；跟踪权威是 company_specific_watchlist，main_risks 是风险描述（人读），两者不重复。

只有完整执行 annual_rebuild + step=all 后才创建或更新 baseline。年报单步分析、中报、季报和 event_alert 不得新建或覆盖 baseline。

中报、季报分析前读取 baseline，并判断本期是否维持、观察或触发重评。缺少有效 baseline 时，先建议用户完成最近年报整体分析；用户拒绝后允许继续，但报告必须标记“缺少年度研究基准”。

5. 行业 playbook 受控扩展

行业 playbook 使用三种状态，状态权威来自 references/industry_playbooks/registry.json，不能仅凭目录里存在 Markdown 文件判断是否启用。

状态含义本次分析行为
active行业路由、指标、评分、strict、baseline、HTML 和测试均已完成读取并执行行业专属 playbook
candidate已有候选草案，尚未完成启用检查候选只供审阅，继续使用 fallback
fallback没有匹配模板使用通用框架，并记录行业不匹配点

分析前运行 python scripts/manage_playbook.py inspect <industry_key>。分析后若至少存在 3 条框架不匹配、5 个行业核心指标、3 类护城河和 3 项行业风险，则自动生成或更新 _candidates/ 下的草案。

候选草案不会自动启用。只有用户明确确认，并完成行业识别、数据源、评分表、baseline、strict、HTML 和测试更新后，才能转为 active。

已启用行业 playbook（7 个）：银行（含国有大行/股份制零售行/城农商行3个子行业）、公用事业、消费品牌、互联网平台、电信运营商、医疗器械、制造出口。

指标契约：每个 playbook 包含 required_metrics（该行业必须分析的指标）和 forbidden_metrics（该行业禁用的指标），引用 references/metric_registry.yml 的 key。例如银行业 required=[nim, npl_ratio, coverage_ratio, tier1_car]，forbidden=[ocf, fcf_cashflow_statement, broad_fcf, cash_to_net_income, gross_margin]。strict 校验和报告审计会据此拦截缺失/误用。

5a. 指标公式注册表（metric_registry）

所有关键财务指标（FCF、DPS、ROE、PB、NIM、净现比、capex 等）的公式、单位、适用行业、能否用于分红覆盖，统一登记在 references/metric_registry.yml。

规则说明
口径唯一引用任一登记指标时按注册表公式计算，不得另造口径；同指标多口径时必须写明用了哪一条
分红覆盖can_use_for_dividend_coverage=false 的指标（如 broad_fcf、ocf）禁止用于论证分红安全性
行业禁用银行业禁用 OCF/FCF/净现比/毛利率；非银禁用 NIM/不良率/拨备覆盖率/资本充足率
PB-ROE 联动PB 不单独使用，必须与 ROE 联动；ROE 用百分数、PB 用倍数

5b. 估值方法行业路由（valuation_policy）

第三步估值分析不再全行业套用同一套方法，按公司类型路由主估值方法，见 references/valuation_policy.md。

公司类型主估值方法禁用方法
金融型PB-ROE + 股息率DCF、PE、PS
稳定现金流型DCF(三情景) + 股息率PS、PEG
成长型PE-G + PSPB、纯DCF
周期型PB + 吨盈利PE、单期DCF
重资产制造EV/EBITDA + ROICPS、PEG
互联网平台PS + 单用户价值PB、纯DCF
医疗/制药PE + 研发管线折现PB、纯股息率
行业明确禁用的方法出现在报告里 = 违反估值策略，报告审计第5层判「高」。

5c. 报告质量审计框架（report_review_framework）

把「点评一份报告好不好」从临场发挥变成系统行为，见 references/report_review_framework.md。8 层审计维度：

  1. 数据口径审计（来源、货币、双源）
  2. 公式与勾稽审计（是否符合 metric_registry）
  3. 行业 playbook 适配审计（required/forbidden 指标）
  4. 公司核心矛盾审计（是否抓到 watchlist 关键变量）
  5. 估值方法审计（是否符合 valuation_policy 路由）
  6. 风险识别审计（是否识别 red_flags）
  7. 结论边界审计（分级：确定事实/合理推断/主观判断）
  8. 可沉淀规则提取（反复性问题沉淀为 skill 规则）

三种报告模式：review_only（只审计）、formal_report（交付前自检第1-7层）、publish_ready（发布前必须跑全部8层 + 交付协议6项全绿，审计未过禁止发布）。

5d. 竞争分析行业路由（competition_policy）

第2步「竞争与结构分析」不再全行业固定套用波特五力，按公司类型路由（competition_policy.py）：

公司类型竞争分析框架说明
金融型/银行波特五力适配版牌照/资本/风控门槛已适配，保留五力结构
互联网平台网络效应 + 多边市场网络效应强度/多边协同/赢家通吃/替代品/反垄断风险
公用事业/运营商监管与特许经营框架牌照稀缺/监管定价/市场化敞口/资本壁垒；运营商含频率资源
医疗/制药集采与研发管线框架集采韧性/管线深度/渠道结构/技术迭代/认证壁垒
其他（成长/周期/制造/通用）波特五力通用兜底ROE/负债率/增速近似五力评分
路由判定由 infer_competition_framework(industry, playbook_key) 完成；银行和通用走五力，互联网/公用事业/医疗走专属框架，与 valuation_policy 同构。

6. event_alert 机制

event_alert 是财报周期之外的事件影响分析，默认由 tongxm-stock-monitor 触发。

事件类型可能影响的步骤
盈利预警/盈喜第1步、第3步、第0步触发检查
回购/增发/配股/分红变化第4步、第3步
并购/资产出售第0步、第1步、第3步
监管处罚/重大诉讼第0步合规文化、第3步
价格战/监管变化/行业政策第2步、第3步、第0步触发检查

analyzer 不主动无边界扫新闻；没有 monitor 事件载荷或用户提供事件链接时，不输出事件结论。

7. 输出 JSON 关键字段

{
  "period_context": {
    "canonical_period": "Q2",
    "report_depth": "semiannual_check"
  },
  "playbook_resolution": {
    "status": "active|candidate|fallback",
    "requested_key": "telecom_operator",
    "matched_key": "",
    "fallback_key": "generic",
    "candidate_path": ""
  },
  "step": "all",
  "report_plan": [
    {"key": "business", "source_step": "step0", "mode": "baseline_check"},
    {"key": "financial_trends", "source_step": "step1", "mode": "semiannual_full"},
    {"key": "porter", "source_step": "step2", "mode": "full"},
    {"key": "valuation", "source_step": "step3", "mode": "ttm_or_cumulative"}
  ],
  "baseline_status": "loaded|missing|invalid|created|updated",
  "baseline_recommendation": {
    "code": "annual_baseline_required",
    "suggested_period": "FY",
    "suggested_step": "all"
  }
}

8. 常用触发方式

分析中国移动                  # 先查 baseline；缺失则建议先分析最近年报
分析工商银行 2025年报
分析工商银行 2026中报
分析工商银行 2026一季报
分析工商银行 2025年报，只做第3步
分析苹果 2026财年Q2
monitor 发现腾讯回购公告 -> event_alert

9. 项目目录与文件地图

下面按职责列出主要目录和文件。缓存目录（如 __pycache__/、.pytest_cache/）不属于业务资产，可随时重新生成。

9.1 顶层规则与入口

路径作用主要读取者修改联动
SKILL.md全局执行规则：流程决策树、硬性约束、数据质量、报告与发布协议。分析智能体流程、strict、baseline、报告或发布规则变化时同步更新本说明书。
SKILL_MANUAL.html面向人类的完整说明书，帮助快速理解当前架构和分析策略。维护者不替代 SKILL.md；规则变化后必须同步。
env.txt / .env本地运行配置，如输出目录和可选数据源 Token。路径与数据源代码不得提交或公开真实 Token；相对路径以 skill 根目录解析。
pyproject.tomlPython 项目和测试配置。Python、pytest依赖或测试规则变化时更新。

9.2 references：分析方法与行业知识

路径作用主要读取者修改联动
references/analysis_framework.md第0-5步和综合总评的方法论，定义数据到结论的分析方式。分析智能体步骤方法变化时同步报告规范、测试和本说明书。
references/period_routing.mdA股、港股、美股报告期到 canonical_period 与 report_depth 的映射。分析智能体、周期代码维护者同步 periods.py、报告计划和测试。
references/data_collection_guide.md数据源映射、采集顺序、降级策略和双源核验指南。分析智能体、数据层维护者数据源变化时同步 provider 和 API 参考。
references/*_api_reference.mdA股、港股、美股接口参数和调用说明。数据层维护者接口字段或服务变化时更新对应 provider。
references/analysis_template.md聊天或消息平台场景的输出格式参考。分析智能体报告结构仍以分析框架和正式 Markdown 为准。
references/developer_guide.md行业注册、PDF 提取、报告结构和测试等开发说明。开发维护者工程入口或 JSON 结构变化时同步。
references/playbook_lifecycle.md行业 playbook 的 active、candidate、fallback 生命周期和启用门槛。分析智能体、manage_playbook.py 使用者同步注册表、候选生成逻辑和测试。
industry_playbooks 与 industry_indicators 的区别： industry_playbooks/ 回答“这门生意应该怎样理解和评分”，影响商业模式、护城河、企业文化、风险和禁用项； industry_indicators/ 回答“这个行业必须额外检查哪些财务指标，以及如何解释阈值”。
路径作用主要读取者修改联动
references/industry_playbooks/registry.json行业 playbook 路由权威，登记 active、candidate、aliases 和 fallback。playbook_registry.py不能仅新增 Markdown；正式启用还需行业识别、指标、strict、baseline、HTML 和测试。
references/industry_playbooks/*.md行业商业模式变量、评分表、护城河来源、文化观察点、风险和禁用项。分析智能体新增行业先走 candidate；银行还需按子行业路由。
references/industry_playbooks/banking/银行子行业模板：国有大行、股份制零售行、区域银行。分析智能体与 banking/_router.md、银行识别和评分口径保持一致。
references/industry_indicators/banking.md银行 NIM、不良率、拨备、资本充足率、流动性等专项指标的含义、阈值和图表口径。分析智能体、指标代码维护者真正生效还需同步 industry.py、PDF 提取、strict、图表和测试。

9.3 scripts：执行入口与核心分析模块

路径作用主要读取者修改联动
scripts/analyze_stock.py正式数据入口：识别证券、采集与核验数据、周期路由、行业指标、strict、baseline 和 JSON 输出。命令行、分析智能体参数或 JSON 变化时同步 SKILL.md、本说明书、HTML 和测试。
scripts/manage_playbook.py检查行业 playbook 状态并生成 candidate 草案。分析智能体、维护者同步生命周期文档和注册表测试。
scripts/render_report.py读取 JSON、唯一增强 Markdown 和图表目录，生成正式文章型单文件 HTML。分析智能体同步 article_report.py、文章模板和报告测试。
scripts/build_report_site.py构建按公司和报告期分组的静态站点目录、索引、安全响应头和发布清单。publish_report.py、维护者目录规则变化时同步 Cloudflare 发布说明和测试。
scripts/publish_report.py检查线上/本地发布清单，防止同公司同周期静默覆盖，并调用 Wrangler 发布。分析智能体覆盖规则或项目配置变化时同步发布章节和测试。
核心模块职责
stock_analyzer/models.py财务、行情、估值、分红等结构化数据模型。
normalize.py / periods.py / paths.py证券身份标准化、报告期路由和路径解析。
verify.py / strict_rules.py双源核验、差异判定和严格模式拦截。
industry.py行业自动识别和行业专项指标采集；这是指标功能真正落地的代码层。
playbook_registry.py读取行业注册表，解析 active、candidate 与 fallback。
baseline_store.py检查、创建、更新和读取年度研究 baseline。
pdf_extractor.py从官方报告 PDF 中补充银行等专项指标，并参与交叉核验。
buffett_judge.py / porter.py / competition_policy.py六维质量评分、波特五力（通用兜底）和竞争分析行业路由（网络效应/监管框架/集采管线）。
report_planner.py根据周期和用户指定步骤生成本次 report_plan。
report_generator.py / report_sections.py生成结构化数据预览使用的自动 Markdown；不替代正式增强 Markdown。
html_report.py结构化数据预览看板渲染器。
article_report.py正式文章型 HTML 渲染器：章节锚点、Markdown 表格和图表内嵌。

9.4 providers、tools 与 tests

路径作用
scripts/stock_analyzer/providers/eastmoney.pyA股行情、财务摘要、三表明细和分红。
providers/xueqiu.pyA/H股行情和财务交叉验证来源。
providers/official_reports.py发现巨潮、港交所、SEC 等官方报告及报告期。
providers/market_data.py历史 K 线、基准指数和回撤数据。
providers/sec.py美股 SEC companyfacts、三表、分红和回购。
providers/akshare_provider.py港股财务数据补充来源。
scripts/tools/generate_charts.py生成通用财务、估值和股东回报图表。
scripts/tools/bank_report_extractor.py下载并提取银行报告中的专项指标。
scripts/tools/bank_charts.py生成 NIM、不良率、拨备、存贷比等银行专项图。
scripts/tools/fetch_lpr.py获取 LPR 历史，供银行息差背景分析。
scripts/tests/周期、行业、核验、strict、baseline、报告、发布等自动测试；行为修改后必须补测试。

9.5 assets、状态数据、配置与输出

路径作用读写与安全边界
assets/article_report_template.html正式文章型 HTML 模板。article_report.py 读取；修改后做桌面和移动端视觉验证。
assets/report_template.html结构化数据预览看板模板。html_report.py 读取；不是正式分析正文来源。
baselines/每家公司最近完整年报形成的研究基准。程序读写；只有 annual_rebuild + step=all 可创建或覆盖。
config/cloudflare_pages.jsonPages 项目名、生产域名、分支和本地站点目录。程序读取；不得保存 Cloudflare Token。
config/sec_company_tickers.jsonSEC ticker 与 CIK 映射缓存。美股 provider 读取，可重新获取。
scripts/config/工具级缓存，例如 LPR 历史。工具读写，可重新生成，不属于正式报告。
STOCK_ANALYZER_OUTPUT_DIR 指向的外部目录JSON、增强 Markdown、HTML、图表、PDF 和 Cloudflare 站点构建产物。程序读写；正式发布只上传最终 HTML、目录、安全头和公开清单。
reports-manifest.jsonCloudflare 已发布公司与周期的权威清单，用于重复检测和防误覆盖。本地与线上共同校验；同公司同周期默认拒绝覆盖。

9.6 一次完整分析的数据流

SKILL.md + analysis_framework + industry playbook
                ↓
analyze_stock.py
                ↓
providers → verify / strict → industry metrics → baseline
                ↓
结构化 JSON + 图表输入
                ↓
唯一增强 Markdown
                ↓
render_report.py → 单文件文章型 HTML
                ↓
用户确认发布
                ↓
publish_report.py → Cloudflare Pages

10. 维护规则

  • 修改周期路由时，同步更新 references/period_routing.md 和本说明书。
  • 修改 0-5 步方法论时，同步更新 references/analysis_framework.md 和本说明书中相关段落。
  • 修改输出 JSON 字段时，同步更新本说明书“输出 JSON 关键字段”。
  • 修改 event_alert 或 monitor 协议时，同步更新本说明书“event_alert 机制”。
  • 新增行业模板时先生成 candidate；未经用户确认和完整启用检查，不得写入 active 注册表。
  • 修改 Markdown 报告段落时，禁止硬编码单家公司、单个案例或历史买卖动作；所有公司事实必须来自本次 JSON、baseline 或明确来源。
  • 巴菲特视角段落只评价生意质量、护城河和管理层，不能代言“巴菲特会买/卖”，也不能输出买入价、仓位或回调阈值。
  • 银行/金融企业评分与报告不得使用普通企业的资产负债率警戒线、OCF/净现比或 FCF 作为生意质量核心判断；应使用 ROE 稳定性、资本充足、资产质量、NIM、存款成本等银行口径。
  • --strict 默认开启（12 类检查：数据完整性/行业必查指标/禁用指标/metric_registry 口径/valuation_policy 路由/比率公式等），任一不过即 fail；需关闭时用 --no-strict。
  • 估值图优先读取年度 year_end_price；缺失时必须回退到 valuation_history，不能在已有估值历史时跳过第 3 步图表。
  • 股东回报报告和图表按财年只保留一个每股分红值：优先使用东财财年合计，其他来源只做交叉校验，不能把同一年多个来源相加。
  • 【硬性规则 #16】交付协议是强制行为，不是可选说明 —— 分析步骤全部完成后，必须执行交付协议 6 项检查清单，缺一不可：① 聊天正文（已发送）② 图片图表（已生成展示）③ 增强 Markdown（保存为文件到 STOCK_ANALYZER_OUTPUT_DIR/<market>_<ticker>/，非仅对话、非临时目录）④ HTML 报告（用 render_report.py 生成到同一目录）⑤ JSON（已保存到同一目录）⑥ 发布询问（固定提示词问 Cloudflare）。只做了 ①② 就收尾 = 违反硬性规则。在发送最终结论前必须确认 ①-⑤ 全部完成、⑥ 已向用户询问。
  • 修改 HTML 报告字段、模板结构、tab 分组、图表嵌入方式时，同步更新 assets/report_template.html、html_report.py 和本说明书。

11. HTML 分析报告

HTML 是正式输出物之一，用于完整阅读、归档和分享。正式报告是增强 Markdown 的文章型阅读器，保留连续正文、章节锚点和对应图表；结构化看板仅用于数据预览。

输出物用途存放目录（由 env.txt 的 STOCK_ANALYZER_OUTPUT_DIR 决定）
聊天正文当前智能体直接发送分析内容不落盘（对话即交付）
JSON结构化数据和核验结果$STOCK_ANALYZER_OUTPUT_DIR/<market>_<ticker>/<ticker>_<period>.json
PNG/SVG 图图表素材$STOCK_ANALYZER_OUTPUT_DIR/<market>_<ticker>/charts/
增强 Markdown正式分析正文和结论的唯一来源，同时用于聊天交付与 HTML 渲染。$STOCK_ANALYZER_OUTPUT_DIR/<market>_<ticker>/<ticker>_<period>_analysis.md
HTML完整可读文章报告$STOCK_ANALYZER_OUTPUT_DIR/<market>_<ticker>/<ticker>_<period>_article.html
python scripts/analyze_stock.py 601398 --name 工商银行 --period 2025FY \
  --out output/icbc.json --html --chart-dir output/charts/icbc

analyze_stock.py --html 生成结构化数据预览看板，用于检查 JSON、数据质量和图表归属。正式交付报告使用 scripts/render_report.py，模板为 assets/article_report_template.html，渲染器为 scripts/stock_analyzer/article_report.py。

正式报告采用“增强 Markdown + HTML 阅读器”模式。增强 Markdown 是唯一分析正文和结论来源；HTML 直接渲染同一份 Markdown，并增加核心指标摘要、章节锚点导航和章节图表。JSON 继续作为结构化数据与核验依据，但不得由 HTML 模板另写一份简版结论。

HTML 默认使用连续阅读布局：桌面端左侧为按 Markdown 二级标题自动生成的粘性锚点导航，右侧为完整正文；移动端导航变为顶部横向章节栏。图表按章节自动嵌入，并以 data URI 写入 HTML，保证报告是可独立移动和分享的单文件。

python scripts/render_report.py \
  --data output/cmb.json \
  --analysis output/cmb_analysis.md \
  --html-out output/cmb_dashboard.html \
  --chart-dir output/charts/cmb \
  --chart-dir output/charts/cmb_bank
组成用途
页头摘要公司、周期、市场、行业及股价、PE、PB、股息率、ROE、净利润。
章节导航按增强 Markdown 的二级标题自动生成锚点，随滚动高亮当前章节。
正文完整渲染唯一 Markdown 分析，支持标题、列表、引用、代码和原生 HTML 表格。
章节图表财务、估值、分红和回撤图自动嵌入对应章节，不另起图表页。

重点信号必须用文字和颜色双重表达：danger 为红色危险，warning 为琥珀关注，good 为绿色正常，neutral 为信息。普通企业净现比低于 0.8 应标红；银行/金融企业不以净现比作为核心风险红灯，应优先使用不良贷款率、拨备覆盖率、核心一级资本充足率和 NIM。

图表优先保证可读性：同一步只有一张图时占满内容区；图像生成时禁止因越界数据标签产生大面积空白。柱状图标签使用 point padding 或 bar_label，不使用固定数据值偏移。

12. Cloudflare Pages 发布

正式分析与 HTML 生成完成后，固定询问：“报告已生成，是否需要发布到 Cloudflare Pages？发布后将获得公开访问链接。”用户未确认时不得发布。

站点固定项目为 stock-analysis-reports，生产域名为 https://stock-analysis-reports-4u0.pages.dev。报告按 /companies/{company_slug}/{period} 归档，公司报告列表位于 /companies/{company_slug}/reports。

发布状态由线上与本地 reports-manifest.json 共同校验。若同一公司、同一周期已存在，必须停止并询问：“Cloudflare Pages 已存在「{公司} {报告期}」报告：{现有链接}。是否覆盖？”只有用户明确确认后才能使用 --overwrite。

python scripts/publish_report.py \
  --report output/cmb_600036_2025fy_article.html \
  --company-slug 600036-cmb \
  --company-name 招商银行 \
  --ticker SH600036 \
  --period 2025fy \
  --period-label "2025 年报" \
  --check-only

发布只包含最终 HTML、目录页、安全响应头和公开报告清单；不得上传 JSON、Token、持仓或账户信息。Wrangler 使用 OAuth 凭据，Cloudflare 配置中不得保存 Token。