south-china-reportlisted

# South China Report — 通用数据分析报告叙事设计系统 V3 > 技能标识 `south-china-report` 为稳定兼容 ID；用户可见名称与触发描述按通用经营报告定位表达。当前内容版本 V3.3.0，完整历史见 `CHANGELOG.md`。 > > **环境依赖**：Node >=18、Python >=3.11；经验证依赖锁定在 `package-lock.json` 与 `requirements.txt`，截图需 Playwright+Chromium。缺依赖时按文内降级路径执行并标注未验证。 > > 报告不是仪表盘。仪表盘是给人"扫"的，报告是给人"读"的。 > 如果产出物和 FineBI 看板没区别，那就失败了。 --- ## 快速上手 · 30 秒执行主线 > 首次使用先读这一屏抓主线；细节在 §1 Working Model 逐步展开，完整加载顺序见 §9。 **做什么**: 任意业务/经营数据 → 讲故事型静态自包含 HTML 报告 (不是看板/PPT/Excel/交互式 BI)。**报告主体(机构/区域/业务线/品类等)随数据内容自动适配, 不预设任何区域或组织**。 **最短主线** (每步对应 §1 步骤，别跳步)： 1. 定**风格档** (未指定即紧凑；叙事标准需显式选择) + **报告类型** → 步骤 0 2. 有数据源先跑 `prep-source.py` `profile`→`build` 出 `metrics.json`，**数字从它抄不手敲** (`BLOCKED` 只出修数建议不出结论)；再跑 `stat-insights.py` 出 `insights.json`，**问题发现/趋势结论从它引用** → 步骤 4 3. 提炼 Governing Thought + 拆 2–4 章 PAC 故事弧 (现象→归因→对策) → 步骤 1-2 4. Read 对应模板 (**CSS 唯一真相源**) → 步骤 6；有合规 `report-spec.json` 时走确定性渲染器，暂无规格时保留人工模板兼容路径 → 步骤 7 5. 选图**必过** `chart-selection-guide.md` §0 意图路由表 (禁止倒序选图) → 步骤 8 6. 交付前跑 4 组 Gate: 成品静态校验 → 静态数字覆盖/真值 → 离线内联+严格复检 → 离线版运行时数字合同与四视口 DOM/AX/Tab/对比度截图 Gate，并逐张自看 → 步骤 9 **必读 3 份** (其余按需查)：本文件 + 对应模板 + `audience-visual-contract.md`。 **五条红线**：数据至上 · 零 Emoji · 饼图/环形默认禁用 · 报告≠看板 · 交付物无运行时切换。 > 注意拦截力边界：成品模式会硬阻断 Emoji、数字排版未覆盖、图表无高度、占位符/待校验状态和未确认审计 PASS；`--strict-offline` 还会硬阻断任何外部或相对资源。饼图/双轴/弱 Hero 标题等仍是 **P1 非阻断项**，所以 `exit 0` 只代表当前模式无 P0，不代表可交付；P1 须人工清零或书面说明。 --- ## §0 设计哲学 ### 美学锚点 本系统定位为**叙事沉浸式数据体验**—— | 维度 | 学习对象 | 本系统的表达