# 恒元智造演示素材 · 共享契约（写页面必读）

## 0. 铁律

1. **零依赖**：不得引用任何 CDN、外部字体、外部 JS 库。图表一律**手写 SVG**。
   页面要能在断网的 Windows 会议室机器上双击打开。
2. **file:// 可用**：数据只能用 `<script src="../data/hydata.js">` 引入，
   **禁止 fetch/XHR 读本地文件**（file:// 下会被 CORS 拦掉）。
3. **不许编数字**：所有出现在页面上的数字必须从 `HY` 里算出来，
   或直接取自 `HY.hooks`。宁可少写一个指标，不可写一个对不上的数。
4. **数据是虚构的**：页脚必须保留虚构声明（见 §4）。
5. **明亮简约**：浅底、白卡、色块背板；忌深色厚重背景铺满。

## 1. 文件位置

```
AI交互载体培训-素材库/
├─ index.html            门户（P1 现场演示页）
├─ assets/hy.css         共享设计系统（必须 link）
├─ data/hydata.js        全量数据，挂到 window.HY
├─ demos/<页面>.html     六个 demo
└─ shots/                L1 的 Excel 真截图
```

demo 页面统一放 `demos/`，引用路径写 `../assets/hy.css`、`../data/hydata.js`，
返回门户写 `../index.html`。

## 2. 数据结构 `window.HY`

```js
HY.meta = { company:'恒元智造', industry:'智能装备', year:2025,
  rows:1728, cities:18, regions:5, products:8, customers:267, orders:87,
  totalSales:59646.1,      // 万元，年销售额
  totalGross:18484.2, grossRate:0.3099,
  prevSales:47823.8,       // 2024 同期，同比 = totalSales/prevSales-1 = +24.7%
  printPages:116 }         // 这份表打印出来 116 页 —— 好用的论据

HY.dict = { regions:[5个大区], cities:[18个城市], pcodes:[8个产品编码],
  pn:{编码:中文名}, channels:['电商','经销','直销'], sales:[8个负责人],
  months:[1..12], customers:[267个客户全名] }

// 明细：1728 行紧凑数组，下标含义固定
// [月, 大区idx, 城市idx, 产品idx, 销量台, 挂牌额万, 折扣率,
//  销售额万, 成本额万, 毛利额万, 渠道idx, 负责人idx, 客户数, 主要客户idx]
HY.detail[0]  // => [1,0,0,7,4,74,0.056,69.9,45.9,24,0,2,1,18]

HY.agg = {
  regionMonth: [{region:'华东', month:1, sales, gross, prev}],   // 60 条，prev=2024同月
  cityMonth:   [{region:'华东', city:'上海', month, sales, gross}],
  custMonth:   [{region:idx, city:idx, cust:idx, month, sales, gross}],  // 注意是下标
  productMonth:[{code:'AGV-M3', month, sales, gross, rate, disc}],
  products:    [{code, name, sales, gross, rate, qty, disc}]     // 8 条产品线年度汇总
}

HY.orders    // 87 条重点订单 {id,month,region,city,cust,code,pname,qty,disc,amount,channel,owner,status}
HY.customers // 267 家 {name,city,region,industry,grade,years,owner}
```

## 3. 三个预埋钩子（**数值必须照抄，不得改**）

### 钩子 A · 归因（用于「聊」页，是全场爆点）
```js
HY.hooks['钩子A_归因'] = {
  华南6月_万元:1187.2, 华南7月_万元:1052.3, 华南7月环比:-0.1136,
  华南7月同比:0.0864, 华南8月_万元:1313, 华南8月环比:0.2477,
  正常水位_万元:1208.5, 正常水位环比:0.0179, 缺口_万元:156.2,
  延期台数:4, 延期单金额_万元:156.24, 延期单能否覆盖缺口:true,
  剔除延期单后7月环比:0.018, 剔除延期单后8月环比:0.0864 }
```
故事：7 月华南环比 **-11.4%**，但**同比 +8.6%**（说明不是趋势问题）。
缺口 156.2 万恰好等于「深圳锐驰科技有限公司」一笔 **4 台 AGV-M3、156.24 万**
的延期单（订单号 `HY25-07088`，状态"延期至2025-08（客户厂房改造，交付窗口顺延）"）。
剔除后 7 月回到 +1.8%，8 月冲高从 +24.8% 塌回 +8.6%。
→ 结论：**Excel 只能看见"华南掉了"，会给出"华南要换人"的错结论。**

### 钩子 B · 下钻（用于「算」页，默认靶子）
```js
HY.hooks['钩子B_下钻']  // EM-9 折扣 8.0%→19.0%，毛利率 3→7 月连降
HY.hooks['钩子B_推演'] = { rateJul:0.2592,   // 7 月毛利率
                           rateAt9:0.3407,   // 折扣收回至 9% 后的毛利率
                           gainPt:8.1,       // 毛利率回升点数
                           grossAddWan:51.9 }// 月增毛利（万元）
// 注意：钩子里的键名一律 ASCII，中文键含 % 或数字开头时，
// JS 点号访问会被解析成取模运算（语法合法、运行时才炸），务必照此引用。
```
EM-9 智能能耗表计：折扣率 3月8.0% → 7月19.0%，毛利率 34.8%→25.9% 连降 4 个月。
报表层看不见，只有下钻能发现。滑杆从 19% 拖回 9% → 毛利率 34.1%、月增毛利 51.9 万。

### 钩子 C · 交叉验证（用于「审」或「聊」页，留作悬念）
```js
HY.hooks['钩子C_交叉验证'] = { 记录数:2, 金额:[78.6,67.2], 差额_万元:11.4,
  渠道:['直销','经销（苏州云汉自动化）'], 负责人:['王毅','陆佳'] }
```
「苏州澜石精密有限公司」同一需求（3 台 CR-7）被两个渠道各报一次价，
订单号 `HY25-09121`（直销 78.6 万 / 王毅）与 `HY25-09147`（经销 67.2 万 / 陆佳），差 **11.4 万**。

## 4. 页脚统一写法

```html
<div class="foot">
  <span>恒元智造及全部客户、金额均为<b>虚构演示数据</b></span><span class="dot"></span>
  <span>本页由 AI 生成 · 零 CDN · 断网可用</span><span class="dot"></span>
  <span><a href="../index.html">← 返回六种形态</a></span>
</div>
```

## 5. 设计系统可用类（assets/hy.css）

结构：`.wrap-wide` `.topbar` `.topbar-in` `.logo` `.logo-mark` `.crumb` `.spacer`
`.eyebrow` `.h1/.h2/.h3` `.lead` `.sub` `.foot` `.dot`
卡片：`.card` `.card-pad` `.card-hover` `.grid .g2/.g3/.g4`
KPI：`.kpi-label` `.kpi-val` `.kpi-unit` `.delta .up/.down/.flat`
标签：`.tag .brand/.warn/.risk/.info/.ghost`
按钮：`.btn .btn-primary/.btn-ghost` `.btn-sm` `.btn-block`
表单：`label.field` `select` `input[type=text]` `input[type=range]`
表格：`table.tbl` + `th` `td.r` `tr.clickable`
动效：`.rise`（加 `.in` 触发进场）`.draw`（SVG 描线）`.fadein` `.pulse`
变量：`--brand-1..6`（绿系渐进）`--ink-1..4` `--bg` `--card` `--line`
`--warn-bg/--warn-fg` `--risk-bg/--risk-fg` `--r-md/--r-lg` `--sh-1/--sh-2/--sh-3` `--ease`

顶栏模板：
```html
<div class="topbar"><div class="wrap-wide topbar-in">
  <div class="logo"><span class="logo-mark">恒</span>恒元智造</div>
  <span class="crumb">· <页面名></span>
  <span class="spacer"></span>
  <a class="back" href="../index.html">← 六种形态</a>
</div></div>
```

## 6. 数字格式约定

- 金额一律「万元」，千分位，1 位小数：`59,646.1 万元`
- 过亿换算：`(v/10000).toFixed(2)+' 亿'`
- 百分比 1 位小数，带正负号：`+24.7%` / `-11.4%`
- 折扣率 1 位小数百分比
- 台数整数无小数
