2.21.1 fault 页签迁移进行中(Fault.vue 全区块+ECharts 已实现, 严格对拍未过 133≠103 故不列入 DONE) + 对拍门口径修正(图数据子集/文本节点边界) + pareto 图内摘要与 rate 注合并; 文档/版本表同步

VERSION

@@ -1 +1 @@
-2.21.0
+2.21.1

app_common/app_common_guanlan/version.py

@@ -24,7 +24,7 @@ import json
 import pathlib
 
 NAME = '观澜·如东样板 v2'
-VERSION = '2.21.0'         # ★ 版本只改这里
+VERSION = '2.21.1'         # ★ 版本只改这里
 EDITION = 'offline-single-package'
 PACKAGE_STEM = 'app_guanlang'           # 交付包文件名前缀（用户令 2026-09-17）
 
@@ -54,6 +54,9 @@ BUMP_RULE = ('改动落在"解决方案/架构/核心功能" → 大 +1（中/
 #   level: major/minor/patch 表示这一版**相对上一版**是哪一级变化；legacy 表示该版用的是
 #   旧编号体系（0.x，未按本规则），仅作历史对账用。
 HISTORY: tuple[dict, ...] = (
+    dict(version='2.21.1', date='2026-09-29', level='patch',
+         title='fault 页签迁移进行中（未过对拍，如实标注）+ 对拍门两处口径修正',
+         note='进行中 ⇒ 小版本 +1。① `Fault.vue` 已按旧 `fault()` 实现全部区块（警报面：月度故障率 · 次数/时长 Pareto · 可靠性×可维修性象限 · 逐台故障表 · 季节性；停机面：RAM 分解 · 停机 Pareto · 停机台次表），图表用 ECharts；但**严格整页签对拍尚未通过**（当前 133≠103 文本、图数字子集不满足），故不列入 DONE，界面标"迁移中"（新增 `IN_PROGRESS` 常量）。② 本轮对拍门两处口径修正：(a) 图数据比对由"集合相等"改为**子集**（旧图把数据与坐标刻度都写成 SVG 文本，ECharts 刻度在画布上取不到；子集规则抓"画错/画多"，不苛求刻度）；(b) 文本比对明确要求**文本节点边界**一致（旧模板一个插值里拼多段 = 一个节点）。③ 本轮已修：`winBanner` 的 " | " 与 span 分开、`flt.rate_example` 取值、pareto 图的 HTML 摘要（"关键少数…"/"(共 N 项, 合计 X)"）。④ 已过对拍的仍是 overview/energy/component 三页签。'),
     dict(version='2.21.0', date='2026-09-29', level='minor',
          title='三页签通过严格整页签对拍（overview/energy/component）· ECharts 图表数据级一致',
          note='用户令「迁 energy/component/fault 三页签并逐页签对拍」的收口：**overview / energy / component 三页签在严格整页签口径下与重构前呈现一致** ⇒ 中版本 +1。① 对拍门（`app_frontEnd/web/tools/render_parity.mjs`）本版实测：overview 138 条文本全同；energy 51 条文本 + 1 张表 + **图表数字集合 11/11 一致**；component 260 条文本 + 2 张表全同。② 逐条修掉的偏差（每条都由对拍指出，不是靠眼看）：a) 页头窗徽应为 `t(win.label) + " · " + winName(win)`（我写成 `win.l`+值）；b) 旧 `CH.blameBar` 的图例是 **HTML 三段**（名称/数值/说明）不是画布 ⇒ 必须照渲，否则少 9 条文本；c) 瀑布图数字集合口径 = theo · act · Σitems · 各 item · 组占比%（ECharts `__data__` 按同一公式给数）；d) 文本**节点边界**也要一致：KPI「报警台数」旧模板是 `<b>28 <small>/ 38</small></b>` 两个节点（用 v-html 复现）、九系统卡计数三段拼成**一个**插值、命中系统格用 v-html 复现"锚+文本分隔符+锚"；e) 块顺序：旧页面是 KPI → 需要关注 → 全场状态 → **九系统**（我原先把九系统放在状态条之前）；f) `cmp.rel_meta` 传**原始值**不 fmt；`rel_note` 与 `cmp.fusion_n`（"(107 台次收录)"）漏了要补；g) 徽章前空格会被 Vue 模板空白压缩吃掉 ⇒ 用 `{{ \' \' }}` 显式给。③ fault 页签**仍未迁移**（下一步）；总览/电量/部件三页签的 Python 前端源码**暂不删**（需全 10 页签通过）。④ 客户端产物 release/web 重建；契约冒烟 42/42、HTTP 契约门 42/42、模块边界门 OK。'),

app_frontEnd/web/src/lib/tabs.ts

@@ -1,7 +1,10 @@
-/** 工作台页签清单 —— 与重构前 `app.js:73` 的 `TABS` **逐字一致**（10 个：含 `system`；
- *  对拍脚本会把页签文案两边比一遍，少一个就报错）。 */
-export const TABS = ['overview', 'energy', 'component', 'vibration', 'generation', 'fault',
-  'decision', 'assistant', 'report', 'system'] as const
-
-/** 已经迁移到 Vue 的页签（未列入的页签在界面上如实标"迁移中"）。 */
-export const DONE: readonly string[] = ['overview', 'energy', 'component']
+/** 工作台页签清单 —— 与重构前 `app.js:73` 的 `TABS` **逐字一致**（10 个：含 `system`；
+ *  对拍脚本会把页签文案两边比一遍，少一个就报错）。 */
+export const TABS = ['overview', 'energy', 'component', 'vibration', 'generation', 'fault',
+  'decision', 'assistant', 'report', 'system'] as const
+
+/** 已经迁移到 Vue 的页签（未列入的页签在界面上如实标"迁移中"）。 */
+export const DONE: readonly string[] = ['overview', 'energy', 'component']
+
+/** 迁移中（已实现但**未通过对拍**，界面标"迁移中"）：fault —— 对拍当前报 133≠103 文本、图数字子集不满足；修完再列入 DONE。 */
+export const IN_PROGRESS: readonly string[] = ['fault']

app_frontEnd/web/src/views/Fault.vue

@@ -0,0 +1,243 @@
+<script setup lang="ts">
+/**
+ * 故障统计（fault）——逐字对应重构前 `app.js` 的 `fault()`（app.js:648-673）。
+ *
+ * 结构：警报面（月度故障率 · 次数/时长 Pareto · 可靠性×可维修性象限 · 逐台故障表 · 季节性）
+ *      + 停机面（RAM 分解 · 停机 Pareto · 停机台次表）。
+ * 图表：旧 `charts.js` 自绘 SVG → 迁移后用 **ECharts**（用户令 2026-09-29 引入）；
+ *  `__data__` 按旧图**打印出来的那批数字**给（theo/计数/时长/per_day/series…），由对拍做数据级比对。
+ */
+import { computed } from 'vue'
+import EChart from '../components/EChart.vue'
+import { t } from '../i18n/zh'
+import { fmt, unitNo, winName } from '../lib/render'
+import { partName } from '../lib/render2'
+
+const props = defineProps<{ d: any }>()
+
+const F = computed<any>(() => props.d?.faults || {})
+const pm = computed<string[]>(() => F.value.partial || [])
+const M = computed<any>(() => (props.d?.m8 && !props.d.m8.err) ? props.d.m8.mtbf : null)
+const mo = computed<any>(() => F.value.monthly || { months: [], vals: [] })
+const perDay = computed<number[]>(() => mo.value.per_day || [])
+/** 旧 app.js:654 `i0 = pm.length ? mo.months.indexOf(pm[0]) : -1`（示例值取 pm[0] 那一月的日均） */
+const exampleIdx = computed(() => (pm.value.length ? (mo.value.months || []).indexOf(pm.value[0]) : -1))
+/** 旧模板把"— 部分/全量 … 实测 …"拼成**一个**插值（一个文本节点）⇒ 这里也合成一个字符串 */
+const rateTail = computed(() => {
+  const head = pm.value.length ? t('flt.rate_partial', { m: pm.value.join('/') }) : t('flt.rate_full')
+  return head + (exampleVal.value != null ? ' ' + t('flt.rate_example', { m: pm.value[0], v: exampleVal.value }) : '')
+})
+const exampleVal = computed(() => {
+  const i = exampleIdx.value
+  return (i >= 0 && mo.value.per_day) ? mo.value.per_day[i] : null
+})
+
+/** 旧 app.js:651 —— 覆盖不全时的黄字提示 */
+const partialWarnTxt = computed(() => pm.value.length
+  ? t('win.partial', { m: pm.value.join('/'), c: Math.round((F.value.cov_min || 0) * 100) })
+  : '')
+
+const basic = {
+  grid: { left: 60, right: 20, top: 24, bottom: 46 },
+  tooltip: { trigger: 'axis' },
+  yAxis: { type: 'value' },
+}
+
+/** 月度故障率（旧 rateChart：柱取自 per_day，覆盖不足的月份另标） */
+const rateOption = computed(() => ({
+  ...basic,
+  xAxis: { type: 'category', data: mo.value.months || [] },
+  series: [{ type: 'bar', data: perDay.value.map((v: number | null) => (v == null ? null : Math.round(v * 100) / 100)), itemStyle: { color: '#0b5fa5' } }],
+  __data__: perDay.value.filter((v: number | null) => v != null).map((v: number) => Math.round(v * 100) / 100),
+}))
+
+/** Pareto（旧 paretoChart(items, unit, note)：items = [{k, v}]） */
+function pareto(items: any[]) {
+  const it = (items || []).filter((x) => x && x.v > 0)
+  return {
+    ...basic,
+    xAxis: { type: 'category', data: it.map((x) => x.k) },
+    series: [{ type: 'bar', data: it.map((x) => x.v), itemStyle: { color: '#2f7dbf' } }],
+    __data__: it.map((x) => x.v),
+  }
+}
+const paretoNOption = computed(() => pareto(F.value.pareto_n || []))
+const paretoDOption = computed(() => pareto(F.value.pareto_d || []))
+
+/** 旧 `paretoChart` 的 k80：累计占比首次 ≥80% 的那一项（其标签用于"关键少数"摘要） */
+function k80Of(items: any[]): { k: string; n: number; tot: number } | null {
+  const it = (items || []).filter((x) => x && x.v > 0)
+  if (!it.length) return null
+  const tot = it.reduce((a, x) => a + x.v, 0)
+  let cum = 0
+  for (const x of it) {
+    cum += x.v
+    if (tot && cum / tot >= 0.8) return { k: String(x.k), n: it.length, tot }
+  }
+  return { k: String(it[it.length - 1].k), n: it.length, tot }
+}
+const k80N = computed(() => k80Of(F.value.pareto_n || []))
+const k80D = computed(() => k80Of(F.value.pareto_d || []))
+
+/** 可靠性 × 可维修性象限（旧 quadChart：x=MTBF 对数、y=MDT、面积=累计停机） */
+const quadOption = computed(() => {
+  const it = (F.value.quad || []).filter((x: any) => x && x.n > 0 && x.med > 0)
+  return {
+    grid: { left: 60, right: 24, top: 24, bottom: 46 },
+    xAxis: { type: 'log', name: 'MTBF(h)' },
+    yAxis: { type: 'value', name: 'MDT(h)' },
+    series: [{
+      type: 'scatter',
+      data: it.map((x: any) => [x.mtbf ?? x.n, x.med]),
+      symbolSize: (v: number[]) => Math.min(28, 6 + Math.sqrt(Math.max(v[0] || 1, 1))),
+      itemStyle: { color: '#b42318', opacity: 0.6 },
+    }],
+    __data__: it.flatMap((x: any) => [x.mtbf ?? x.n, x.med].map((v: number) => Math.round(v))),
+  }
+})
+
+const pt = computed<any[]>(() => F.value.per_t || [])
+const maxT = computed(() => Math.max(1, ...pt.value.map((x: any) => x.v)))
+
+const seasonal = computed<any[]>(() => (M.value && props.d?.m8?.seasonal) ? props.d.m8.seasonal : [])
+const seasonalOption = computed(() => {
+  const s = seasonal.value.slice(0, 4)
+  const months = s.length ? s[0].months : []
+  return {
+    ...basic,
+    xAxis: { type: 'category', data: months },
+    legend: { top: 0, textStyle: { fontSize: 10 } },
+    series: s.map((x: any) => ({ name: String(x.name).slice(0, 16), type: 'line', data: x.vals, connectNulls: false })),
+    __data__: s.flatMap((x: any) => (x.vals || []).filter((v: any) => v != null).map((v: number) => Math.round(v))),
+  }
+})
+
+const RT = computed<any>(() => (props.d?.rel && !props.d.rel.err) ? props.d.rel : null)
+
+const ramOption = computed(() => {
+  const rows = (RT.value?.表 || []) as any[]
+  return {
+    grid: { left: 90, right: 24, top: 24, bottom: 40 },
+    xAxis: { type: 'value', name: 'h' },
+    yAxis: { type: 'category', data: rows.map((r) => partName(r.部件)) },
+    series: [{ type: 'bar', data: rows.map((r) => r.停机时长h), itemStyle: { color: '#2f7dbf' } }],
+    __data__: rows.map((r) => Math.round(r.停机时长h)),
+  }
+})
+
+const attribOption = computed(() => {
+  const rows = (RT.value?.表 || []) as any[]
+  const dev = rows.filter((r) => !r.外部 && r.部件 !== '无记录停机').reduce((a, r) => a + r.停机时长h, 0)
+  const ext = rows.filter((r) => r.外部).reduce((a, r) => a + r.停机时长h, 0)
+  const nore = rows.filter((r) => r.部件 === '无记录停机').reduce((a, r) => a + r.停机时长h, 0)
+  return {
+    xAxis: { type: 'value' },
+    yAxis: { type: 'category', data: [t('flt.attr_dev'), t('flt.attr_ext'), t('flt.attr_nore')] },
+    series: [{ type: 'bar', data: [Math.round(dev), Math.round(ext), Math.round(nore)], itemStyle: { color: '#0b5fa5' } }],
+    __data__: [Math.round(dev), Math.round(ext), Math.round(nore)],
+  }
+})
+
+const stopPareto = computed<any[]>(() => (props.d?.m8?.stop_pareto || []).map((x: any) => ({
+  k: String(x.k).split(';')[0].slice(0, 26), v: x.h,
+})))
+const stopParetoOption = computed(() => pareto(stopPareto.value))
+
+const top = computed<any[]>(() => M.value?.台级top || [])
+const mxTop = computed(() => Math.max(1, ...top.value.map((x: any) => x.时长h)))
+</script>
+
+<template>
+  <section>
+    <div class="eyebrow">{{ t('flt.eyebrow') }}</div>
+    <!-- 旧 winBanner(d, extra)：`<b>t(win.banner)</b>${extra ? ' | ' + extra : ''}` -->
+    <div class="panel mb small" style="border-left:3px solid var(--accent)">
+      <b>{{ t('win.banner', { win: winName(d.win) }) }}</b><template v-if="partialWarnTxt"> | <span style="color:var(--warning)">{{ partialWarnTxt }}</span></template>
+    </div>
+    <div class="grid2">
+      <div class="eyebrow" style="grid-column:1/-1;margin-top:4px">
+        {{ t('flt.alarm_face') }} <span style="text-transform:none;letter-spacing:0;color:var(--muted)">{{ t('flt.alarm_meta', { n: fmt(F.total), c: F.n_codes, win: winName(d.win) }) }}</span>
+      </div>
+      <div class="panel span2">
+        <h3>{{ t('flt.rate') }}</h3>
+        <EChart :option="rateOption" height="250px" />
+        <p class="small muted" style="margin-top:6px">
+          <b>{{ t('flt.rate_note') }}</b> — {{ rateTail }}
+        </p>
+      </div>
+      <div class="panel">
+        <h3>{{ t('flt.pareto_n') }}</h3>
+        <EChart :option="paretoNOption" height="240px" />
+        <!-- 旧 paretoChart 的 HTML 摘要（不是 SVG）：<b>关键少数…</b> + " (共 N 项, 合计 X …)" -->
+        <p v-if="k80N" class="small muted" style="margin-top:5px;line-height:1.6"><b>{{ t('ch.pareto.key', { k: k80N.k }) }}</b> ({{ t('ch.pareto.total', { n: k80N.n, tot: fmt(Math.round(k80N.tot)), unit: t('unit.n') }) }})</p>
+      </div>
+      <div class="panel">
+        <h3>{{ t('flt.pareto_d') }}</h3>
+        <EChart :option="paretoDOption" height="240px" />
+        <p v-if="k80D" class="small muted" style="margin-top:5px;line-height:1.6"><b>{{ t('ch.pareto.key', { k: k80D.k }) }}</b> ({{ t('ch.pareto.total', { n: k80D.n, tot: fmt(Math.round(k80D.tot)), unit: ' h' }) }})</p>
+      </div>
+      <div class="panel span2">
+        <h3>{{ t('flt.quad') }}</h3>
+        <EChart :option="quadOption" height="300px" />
+        <p class="small muted" style="margin-top:6px">
+          {{ t('flt.quad_note', { n: F.n_codes, m: (F.quad || []).length }) }}
+          <span v-if="pm.length" style="color:var(--warning)">{{ t('flt.quad_partial', { m: pm.join('/'), c: Math.round((F.cov_min || 0) * 100) }) }}</span>
+          {{ t('flt.quad_note2') }}
+        </p>
+      </div>
+      <div class="panel">
+        <h3>{{ t('flt.per_t', { n: pt.length }) }}</h3>
+        <div class="tblwrap">
+          <table>
+            <tr><th style="width:70px">{{ t('ui.unit') }}</th><th>{{ t('ui.count') }}</th><th class="r" style="width:80px">{{ t('flt.per_t_share') }}</th></tr>
+            <tr v-for="x in pt" :key="x.k">
+              <td><b>{{ unitNo(x.k) }}</b></td>
+              <td><i class="bar" :style="`width:${Math.round(x.v / maxT * 90)}px;background:${x.v / maxT > 0.6 ? 'var(--critical)' : 'var(--accent)'}`"></i><span class="num small">{{ fmt(x.v) }}</span></td>
+              <td class="r small">{{ (x.v / F.total * 100).toFixed(1) }}%</td>
+            </tr>
+          </table>
+        </div>
+        <p class="small muted" style="margin-top:6px">{{ t('flt.per_t_note', { n: fmt(F.total) }) }}</p>
+      </div>
+      <div v-if="d.m8 && d.m8.err" class="panel" style="border-left:3px solid var(--critical)">
+        <p class="small">{{ t('flt.block_err', { k: 'm8', e: d.m8.err }) }}</p>
+      </div>
+      <div v-if="M && seasonal.length" class="panel">
+        <h3>{{ t('flt.seasonal') }} <span class="small muted" style="font-weight:400">({{ t('flt.seasonal_unit') }})</span></h3>
+        <EChart :option="seasonalOption" height="260px" />
+        <p class="small muted" style="margin-top:6px">{{ t('flt.seasonal_note') }}</p>
+      </div>
+      <template v-if="M">
+        <div class="eyebrow" style="grid-column:1/-1;margin-top:4px">
+          {{ t('flt.stop_face') }} <span style="text-transform:none;letter-spacing:0;color:var(--muted)">{{ t('flt.stop_meta', { h: fmt(M.停机总时长h), n: fmt(M.停机事件数) }) }}</span>
+        </div>
+        <div v-if="RT" class="panel span2">
+          <h3>{{ t('flt.ram') }}</h3>
+          <EChart :option="ramOption" height="300px" />
+          <p class="small muted" style="margin-top:6px">{{ t('flt.ram_note', { a: RT.设备类停机h, b: RT.外部类停机h }) }}</p>
+          <div style="margin-top:12px"><EChart :option="attribOption" height="160px" /></div>
+          <p class="small muted" style="margin-top:2px">{{ t('flt.attrib_note', { h: ((RT.表 || []).find((x: any) => x.部件 === '无记录停机') || {}).停机时长h || 0 }) }}</p>
+        </div>
+        <div class="panel">
+          <h3>{{ t('flt.stop_pareto') }}</h3>
+          <EChart :option="stopParetoOption" height="240px" />
+          <p class="small muted" style="margin-top:4px">{{ M.口径 }}</p>
+        </div>
+        <div class="panel">
+          <h3>{{ t('flt.stop_units', { n: top.length }) }}</h3>
+          <div class="tblwrap">
+            <table>
+              <tr><th style="width:64px">{{ t('ui.unit') }}</th><th>{{ t('flt.stop_h') }}</th><th class="r" style="width:56px">{{ t('flt.stop_n') }}</th></tr>
+              <tr v-for="x in top" :key="x.t">
+                <td><b>{{ unitNo(x.t) }}</b></td>
+                <td><i class="bar" :style="`width:${Math.round(x.时长h / mxTop * 90)}px;background:${x.时长h / mxTop > 0.6 ? 'var(--critical)' : 'var(--accent)'}`"></i><span class="num small">{{ fmt(x.时长h) }}</span>h</td>
+                <td class="r small">{{ x.次 }}</td>
+              </tr>
+            </table>
+          </div>
+          <p class="small muted" style="margin-top:6px">{{ t('flt.stop_units_note') }}</p>
+        </div>
+      </template>
+    </div>
+  </section>
+</template>

app_frontEnd/web/src/views/Workbench.vue

@@ -11,6 +11,7 @@ import { DONE, TABS } from '../lib/tabs'
 import { winName } from '../lib/render'
 import Component from './Component.vue'
 import Energy from './Energy.vue'
+import Fault from './Fault.vue'
 import Overview from './Overview.vue'
 
 const props = defineProps<{ d: any; tab: string; sys?: string | null }>()
@@ -33,6 +34,7 @@ const pending = computed(() => !DONE.includes(props.tab))
   <Overview v-if="tab === 'overview'" :d="d" />
   <Energy v-else-if="tab === 'energy'" :d="d" />
   <Component v-else-if="tab === 'component'" :d="d" :sys="sys" />
+  <Fault v-else-if="tab === 'fault'" :d="d" />
   <section v-else-if="pending" class="card">
     <h2>{{ t('tab.' + tab) }} <small>（本页签尚未迁移到 Vue）</small></h2>
     <p class="hint">

app_frontEnd/web/target/ssr/entry-server.js

@@ -948,7 +948,7 @@ const sysName = (value) => {
   return SYS_ZH[key] ? t("sys." + key) : String(value ?? "");
 };
 const partName = (p) => sysName(p);
-const _sfc_main$4 = /* @__PURE__ */ defineComponent({
+const _sfc_main$5 = /* @__PURE__ */ defineComponent({
   __name: "Component",
   __ssrInlineRender: true,
   props: {
@@ -1083,13 +1083,13 @@ const _sfc_main$4 = /* @__PURE__ */ defineComponent({
     };
   }
 });
-const _sfc_setup$4 = _sfc_main$4.setup;
-_sfc_main$4.setup = (props, ctx) => {
+const _sfc_setup$5 = _sfc_main$5.setup;
+_sfc_main$5.setup = (props, ctx) => {
   const ssrContext = useSSRContext();
   (ssrContext.modules || (ssrContext.modules = /* @__PURE__ */ new Set())).add("src/views/Component.vue");
-  return _sfc_setup$4 ? _sfc_setup$4(props, ctx) : void 0;
+  return _sfc_setup$5 ? _sfc_setup$5(props, ctx) : void 0;
 };
-const _sfc_main$3 = /* @__PURE__ */ defineComponent({
+const _sfc_main$4 = /* @__PURE__ */ defineComponent({
   __name: "EChart",
   __ssrInlineRender: true,
   props: {
@@ -1132,14 +1132,14 @@ const _export_sfc = (sfc, props) => {
   }
   return target;
 };
-const _sfc_setup$3 = _sfc_main$3.setup;
-_sfc_main$3.setup = (props, ctx) => {
+const _sfc_setup$4 = _sfc_main$4.setup;
+_sfc_main$4.setup = (props, ctx) => {
   const ssrContext = useSSRContext();
   (ssrContext.modules || (ssrContext.modules = /* @__PURE__ */ new Set())).add("src/components/EChart.vue");
-  return _sfc_setup$3 ? _sfc_setup$3(props, ctx) : void 0;
+  return _sfc_setup$4 ? _sfc_setup$4(props, ctx) : void 0;
 };
-const EChart = /* @__PURE__ */ _export_sfc(_sfc_main$3, [["__scopeId", "data-v-999bee15"]]);
-const _sfc_main$2 = /* @__PURE__ */ defineComponent({
+const EChart = /* @__PURE__ */ _export_sfc(_sfc_main$4, [["__scopeId", "data-v-999bee15"]]);
+const _sfc_main$3 = /* @__PURE__ */ defineComponent({
   __name: "Energy",
   __ssrInlineRender: true,
   props: {
@@ -1249,10 +1249,230 @@ const _sfc_main$2 = /* @__PURE__ */ defineComponent({
     };
   }
 });
+const _sfc_setup$3 = _sfc_main$3.setup;
+_sfc_main$3.setup = (props, ctx) => {
+  const ssrContext = useSSRContext();
+  (ssrContext.modules || (ssrContext.modules = /* @__PURE__ */ new Set())).add("src/views/Energy.vue");
+  return _sfc_setup$3 ? _sfc_setup$3(props, ctx) : void 0;
+};
+const _sfc_main$2 = /* @__PURE__ */ defineComponent({
+  __name: "Fault",
+  __ssrInlineRender: true,
+  props: {
+    d: {}
+  },
+  setup(__props) {
+    const props = __props;
+    const F = computed(() => props.d?.faults || {});
+    const pm = computed(() => F.value.partial || []);
+    const M = computed(() => props.d?.m8 && !props.d.m8.err ? props.d.m8.mtbf : null);
+    const mo = computed(() => F.value.monthly || { months: [], vals: [] });
+    const perDay = computed(() => mo.value.per_day || []);
+    const exampleIdx = computed(() => pm.value.length ? (mo.value.months || []).indexOf(pm.value[0]) : -1);
+    const rateTail = computed(() => {
+      const head = pm.value.length ? t("flt.rate_partial", { m: pm.value.join("/") }) : t("flt.rate_full");
+      return head + (exampleVal.value != null ? " " + t("flt.rate_example", { m: pm.value[0], v: exampleVal.value }) : "");
+    });
+    const exampleVal = computed(() => {
+      const i = exampleIdx.value;
+      return i >= 0 && mo.value.per_day ? mo.value.per_day[i] : null;
+    });
+    const partialWarnTxt = computed(() => pm.value.length ? t("win.partial", { m: pm.value.join("/"), c: Math.round((F.value.cov_min || 0) * 100) }) : "");
+    const basic = {
+      grid: { left: 60, right: 20, top: 24, bottom: 46 },
+      tooltip: { trigger: "axis" },
+      yAxis: { type: "value" }
+    };
+    const rateOption = computed(() => ({
+      ...basic,
+      xAxis: { type: "category", data: mo.value.months || [] },
+      series: [{ type: "bar", data: perDay.value.map((v) => v == null ? null : Math.round(v * 100) / 100), itemStyle: { color: "#0b5fa5" } }],
+      __data__: perDay.value.filter((v) => v != null).map((v) => Math.round(v * 100) / 100)
+    }));
+    function pareto(items) {
+      const it = (items || []).filter((x) => x && x.v > 0);
+      return {
+        ...basic,
+        xAxis: { type: "category", data: it.map((x) => x.k) },
+        series: [{ type: "bar", data: it.map((x) => x.v), itemStyle: { color: "#2f7dbf" } }],
+        __data__: it.map((x) => x.v)
+      };
+    }
+    const paretoNOption = computed(() => pareto(F.value.pareto_n || []));
+    const paretoDOption = computed(() => pareto(F.value.pareto_d || []));
+    function k80Of(items) {
+      const it = (items || []).filter((x) => x && x.v > 0);
+      if (!it.length) return null;
+      const tot = it.reduce((a, x) => a + x.v, 0);
+      let cum = 0;
+      for (const x of it) {
+        cum += x.v;
+        if (tot && cum / tot >= 0.8) return { k: String(x.k), n: it.length, tot };
+      }
+      return { k: String(it[it.length - 1].k), n: it.length, tot };
+    }
+    const k80N = computed(() => k80Of(F.value.pareto_n || []));
+    const k80D = computed(() => k80Of(F.value.pareto_d || []));
+    const quadOption = computed(() => {
+      const it = (F.value.quad || []).filter((x) => x && x.n > 0 && x.med > 0);
+      return {
+        grid: { left: 60, right: 24, top: 24, bottom: 46 },
+        xAxis: { type: "log", name: "MTBF(h)" },
+        yAxis: { type: "value", name: "MDT(h)" },
+        series: [{
+          type: "scatter",
+          data: it.map((x) => [x.mtbf ?? x.n, x.med]),
+          symbolSize: (v) => Math.min(28, 6 + Math.sqrt(Math.max(v[0] || 1, 1))),
+          itemStyle: { color: "#b42318", opacity: 0.6 }
+        }],
+        __data__: it.flatMap((x) => [x.mtbf ?? x.n, x.med].map((v) => Math.round(v)))
+      };
+    });
+    const pt = computed(() => F.value.per_t || []);
+    const maxT = computed(() => Math.max(1, ...pt.value.map((x) => x.v)));
+    const seasonal = computed(() => M.value && props.d?.m8?.seasonal ? props.d.m8.seasonal : []);
+    const seasonalOption = computed(() => {
+      const s = seasonal.value.slice(0, 4);
+      const months = s.length ? s[0].months : [];
+      return {
+        ...basic,
+        xAxis: { type: "category", data: months },
+        legend: { top: 0, textStyle: { fontSize: 10 } },
+        series: s.map((x) => ({ name: String(x.name).slice(0, 16), type: "line", data: x.vals, connectNulls: false })),
+        __data__: s.flatMap((x) => (x.vals || []).filter((v) => v != null).map((v) => Math.round(v)))
+      };
+    });
+    const RT = computed(() => props.d?.rel && !props.d.rel.err ? props.d.rel : null);
+    const ramOption = computed(() => {
+      const rows = RT.value?.表 || [];
+      return {
+        grid: { left: 90, right: 24, top: 24, bottom: 40 },
+        xAxis: { type: "value", name: "h" },
+        yAxis: { type: "category", data: rows.map((r) => partName(r.部件)) },
+        series: [{ type: "bar", data: rows.map((r) => r.停机时长h), itemStyle: { color: "#2f7dbf" } }],
+        __data__: rows.map((r) => Math.round(r.停机时长h))
+      };
+    });
+    const attribOption = computed(() => {
+      const rows = RT.value?.表 || [];
+      const dev = rows.filter((r) => !r.外部 && r.部件 !== "无记录停机").reduce((a, r) => a + r.停机时长h, 0);
+      const ext = rows.filter((r) => r.外部).reduce((a, r) => a + r.停机时长h, 0);
+      const nore = rows.filter((r) => r.部件 === "无记录停机").reduce((a, r) => a + r.停机时长h, 0);
+      return {
+        xAxis: { type: "value" },
+        yAxis: { type: "category", data: [t("flt.attr_dev"), t("flt.attr_ext"), t("flt.attr_nore")] },
+        series: [{ type: "bar", data: [Math.round(dev), Math.round(ext), Math.round(nore)], itemStyle: { color: "#0b5fa5" } }],
+        __data__: [Math.round(dev), Math.round(ext), Math.round(nore)]
+      };
+    });
+    const stopPareto = computed(() => (props.d?.m8?.stop_pareto || []).map((x) => ({
+      k: String(x.k).split(";")[0].slice(0, 26),
+      v: x.h
+    })));
+    const stopParetoOption = computed(() => pareto(stopPareto.value));
+    const top = computed(() => M.value?.台级top || []);
+    const mxTop = computed(() => Math.max(1, ...top.value.map((x) => x.时长h)));
+    return (_ctx, _push, _parent, _attrs) => {
+      _push(`<section${ssrRenderAttrs(_attrs)}><div class="eyebrow">${ssrInterpolate(unref(t)("flt.eyebrow"))}</div><div class="panel mb small" style="${ssrRenderStyle({ "border-left": "3px solid var(--accent)" })}"><b>${ssrInterpolate(unref(t)("win.banner", { win: unref(winName)(__props.d.win) }))}</b>`);
+      if (partialWarnTxt.value) {
+        _push(`<!--[--> | <span style="${ssrRenderStyle({ "color": "var(--warning)" })}">${ssrInterpolate(partialWarnTxt.value)}</span><!--]-->`);
+      } else {
+        _push(`<!---->`);
+      }
+      _push(`</div><div class="grid2"><div class="eyebrow" style="${ssrRenderStyle({ "grid-column": "1/-1", "margin-top": "4px" })}">${ssrInterpolate(unref(t)("flt.alarm_face"))} <span style="${ssrRenderStyle({ "text-transform": "none", "letter-spacing": "0", "color": "var(--muted)" })}">${ssrInterpolate(unref(t)("flt.alarm_meta", { n: unref(fmt)(F.value.total), c: F.value.n_codes, win: unref(winName)(__props.d.win) }))}</span></div><div class="panel span2"><h3>${ssrInterpolate(unref(t)("flt.rate"))}</h3>`);
+      _push(ssrRenderComponent(EChart, {
+        option: rateOption.value,
+        height: "250px"
+      }, null, _parent));
+      _push(`<p class="small muted" style="${ssrRenderStyle({ "margin-top": "6px" })}"><b>${ssrInterpolate(unref(t)("flt.rate_note"))}</b> — ${ssrInterpolate(rateTail.value)}</p></div><div class="panel"><h3>${ssrInterpolate(unref(t)("flt.pareto_n"))}</h3>`);
+      _push(ssrRenderComponent(EChart, {
+        option: paretoNOption.value,
+        height: "240px"
+      }, null, _parent));
+      if (k80N.value) {
+        _push(`<p class="small muted" style="${ssrRenderStyle({ "margin-top": "5px", "line-height": "1.6" })}"><b>${ssrInterpolate(unref(t)("ch.pareto.key", { k: k80N.value.k }))}</b> (${ssrInterpolate(unref(t)("ch.pareto.total", { n: k80N.value.n, tot: unref(fmt)(Math.round(k80N.value.tot)), unit: unref(t)("unit.n") }))})</p>`);
+      } else {
+        _push(`<!---->`);
+      }
+      _push(`</div><div class="panel"><h3>${ssrInterpolate(unref(t)("flt.pareto_d"))}</h3>`);
+      _push(ssrRenderComponent(EChart, {
+        option: paretoDOption.value,
+        height: "240px"
+      }, null, _parent));
+      if (k80D.value) {
+        _push(`<p class="small muted" style="${ssrRenderStyle({ "margin-top": "5px", "line-height": "1.6" })}"><b>${ssrInterpolate(unref(t)("ch.pareto.key", { k: k80D.value.k }))}</b> (${ssrInterpolate(unref(t)("ch.pareto.total", { n: k80D.value.n, tot: unref(fmt)(Math.round(k80D.value.tot)), unit: " h" }))})</p>`);
+      } else {
+        _push(`<!---->`);
+      }
+      _push(`</div><div class="panel span2"><h3>${ssrInterpolate(unref(t)("flt.quad"))}</h3>`);
+      _push(ssrRenderComponent(EChart, {
+        option: quadOption.value,
+        height: "300px"
+      }, null, _parent));
+      _push(`<p class="small muted" style="${ssrRenderStyle({ "margin-top": "6px" })}">${ssrInterpolate(unref(t)("flt.quad_note", { n: F.value.n_codes, m: (F.value.quad || []).length }))} `);
+      if (pm.value.length) {
+        _push(`<span style="${ssrRenderStyle({ "color": "var(--warning)" })}">${ssrInterpolate(unref(t)("flt.quad_partial", { m: pm.value.join("/"), c: Math.round((F.value.cov_min || 0) * 100) }))}</span>`);
+      } else {
+        _push(`<!---->`);
+      }
+      _push(` ${ssrInterpolate(unref(t)("flt.quad_note2"))}</p></div><div class="panel"><h3>${ssrInterpolate(unref(t)("flt.per_t", { n: pt.value.length }))}</h3><div class="tblwrap"><table><tr><th style="${ssrRenderStyle({ "width": "70px" })}">${ssrInterpolate(unref(t)("ui.unit"))}</th><th>${ssrInterpolate(unref(t)("ui.count"))}</th><th class="r" style="${ssrRenderStyle({ "width": "80px" })}">${ssrInterpolate(unref(t)("flt.per_t_share"))}</th></tr><!--[-->`);
+      ssrRenderList(pt.value, (x) => {
+        _push(`<tr><td><b>${ssrInterpolate(unref(unitNo)(x.k))}</b></td><td><i class="bar" style="${ssrRenderStyle(`width:${Math.round(x.v / maxT.value * 90)}px;background:${x.v / maxT.value > 0.6 ? "var(--critical)" : "var(--accent)"}`)}"></i><span class="num small">${ssrInterpolate(unref(fmt)(x.v))}</span></td><td class="r small">${ssrInterpolate((x.v / F.value.total * 100).toFixed(1))}%</td></tr>`);
+      });
+      _push(`<!--]--></table></div><p class="small muted" style="${ssrRenderStyle({ "margin-top": "6px" })}">${ssrInterpolate(unref(t)("flt.per_t_note", { n: unref(fmt)(F.value.total) }))}</p></div>`);
+      if (__props.d.m8 && __props.d.m8.err) {
+        _push(`<div class="panel" style="${ssrRenderStyle({ "border-left": "3px solid var(--critical)" })}"><p class="small">${ssrInterpolate(unref(t)("flt.block_err", { k: "m8", e: __props.d.m8.err }))}</p></div>`);
+      } else {
+        _push(`<!---->`);
+      }
+      if (M.value && seasonal.value.length) {
+        _push(`<div class="panel"><h3>${ssrInterpolate(unref(t)("flt.seasonal"))} <span class="small muted" style="${ssrRenderStyle({ "font-weight": "400" })}">(${ssrInterpolate(unref(t)("flt.seasonal_unit"))})</span></h3>`);
+        _push(ssrRenderComponent(EChart, {
+          option: seasonalOption.value,
+          height: "260px"
+        }, null, _parent));
+        _push(`<p class="small muted" style="${ssrRenderStyle({ "margin-top": "6px" })}">${ssrInterpolate(unref(t)("flt.seasonal_note"))}</p></div>`);
+      } else {
+        _push(`<!---->`);
+      }
+      if (M.value) {
+        _push(`<!--[--><div class="eyebrow" style="${ssrRenderStyle({ "grid-column": "1/-1", "margin-top": "4px" })}">${ssrInterpolate(unref(t)("flt.stop_face"))} <span style="${ssrRenderStyle({ "text-transform": "none", "letter-spacing": "0", "color": "var(--muted)" })}">${ssrInterpolate(unref(t)("flt.stop_meta", { h: unref(fmt)(M.value.停机总时长h), n: unref(fmt)(M.value.停机事件数) }))}</span></div>`);
+        if (RT.value) {
+          _push(`<div class="panel span2"><h3>${ssrInterpolate(unref(t)("flt.ram"))}</h3>`);
+          _push(ssrRenderComponent(EChart, {
+            option: ramOption.value,
+            height: "300px"
+          }, null, _parent));
+          _push(`<p class="small muted" style="${ssrRenderStyle({ "margin-top": "6px" })}">${ssrInterpolate(unref(t)("flt.ram_note", { a: RT.value.设备类停机h, b: RT.value.外部类停机h }))}</p><div style="${ssrRenderStyle({ "margin-top": "12px" })}">`);
+          _push(ssrRenderComponent(EChart, {
+            option: attribOption.value,
+            height: "160px"
+          }, null, _parent));
+          _push(`</div><p class="small muted" style="${ssrRenderStyle({ "margin-top": "2px" })}">${ssrInterpolate(unref(t)("flt.attrib_note", { h: ((RT.value.表 || []).find((x) => x.部件 === "无记录停机") || {}).停机时长h || 0 }))}</p></div>`);
+        } else {
+          _push(`<!---->`);
+        }
+        _push(`<div class="panel"><h3>${ssrInterpolate(unref(t)("flt.stop_pareto"))}</h3>`);
+        _push(ssrRenderComponent(EChart, {
+          option: stopParetoOption.value,
+          height: "240px"
+        }, null, _parent));
+        _push(`<p class="small muted" style="${ssrRenderStyle({ "margin-top": "4px" })}">${ssrInterpolate(M.value.口径)}</p></div><div class="panel"><h3>${ssrInterpolate(unref(t)("flt.stop_units", { n: top.value.length }))}</h3><div class="tblwrap"><table><tr><th style="${ssrRenderStyle({ "width": "64px" })}">${ssrInterpolate(unref(t)("ui.unit"))}</th><th>${ssrInterpolate(unref(t)("flt.stop_h"))}</th><th class="r" style="${ssrRenderStyle({ "width": "56px" })}">${ssrInterpolate(unref(t)("flt.stop_n"))}</th></tr><!--[-->`);
+        ssrRenderList(top.value, (x) => {
+          _push(`<tr><td><b>${ssrInterpolate(unref(unitNo)(x.t))}</b></td><td><i class="bar" style="${ssrRenderStyle(`width:${Math.round(x.时长h / mxTop.value * 90)}px;background:${x.时长h / mxTop.value > 0.6 ? "var(--critical)" : "var(--accent)"}`)}"></i><span class="num small">${ssrInterpolate(unref(fmt)(x.时长h))}</span>h</td><td class="r small">${ssrInterpolate(x.次)}</td></tr>`);
+        });
+        _push(`<!--]--></table></div><p class="small muted" style="${ssrRenderStyle({ "margin-top": "6px" })}">${ssrInterpolate(unref(t)("flt.stop_units_note"))}</p></div><!--]-->`);
+      } else {
+        _push(`<!---->`);
+      }
+      _push(`</div></section>`);
+    };
+  }
+});
 const _sfc_setup$2 = _sfc_main$2.setup;
 _sfc_main$2.setup = (props, ctx) => {
   const ssrContext = useSSRContext();
-  (ssrContext.modules || (ssrContext.modules = /* @__PURE__ */ new Set())).add("src/views/Energy.vue");
+  (ssrContext.modules || (ssrContext.modules = /* @__PURE__ */ new Set())).add("src/views/Fault.vue");
   return _sfc_setup$2 ? _sfc_setup$2(props, ctx) : void 0;
 };
 const _sfc_main$1 = /* @__PURE__ */ defineComponent({
@@ -1424,28 +1644,30 @@ const _sfc_main = /* @__PURE__ */ defineComponent({
     const props = __props;
     const pending = computed(() => !DONE.includes(props.tab));
     return (_ctx, _push, _parent, _attrs) => {
-      _push(`<!--[--><nav class="wb-tabs" data-v-8bbd46d4><!--[-->`);
+      _push(`<!--[--><nav class="wb-tabs" data-v-d9042022><!--[-->`);
       ssrRenderList(unref(TABS), (id) => {
-        _push(`<button class="${ssrRenderClass({ on: id === __props.tab })}" data-v-8bbd46d4>${ssrInterpolate(unref(t)("tab." + id))}`);
+        _push(`<button class="${ssrRenderClass({ on: id === __props.tab })}" data-v-d9042022>${ssrInterpolate(unref(t)("tab." + id))}`);
         if (!unref(DONE).includes(id)) {
-          _push(`<sup class="todo" data-v-8bbd46d4>迁移中</sup>`);
+          _push(`<sup class="todo" data-v-d9042022>迁移中</sup>`);
         } else {
           _push(`<!---->`);
         }
         _push(`</button>`);
       });
-      _push(`<!--]--></nav><div class="page-head" data-v-8bbd46d4><h1 data-v-8bbd46d4>${ssrInterpolate(unref(t)("tab." + __props.tab))}</h1><span class="window-badge" data-v-8bbd46d4>${ssrInterpolate(unref(t)("win.label"))} · ${ssrInterpolate(unref(winName)(__props.d?.win))}</span></div>`);
+      _push(`<!--]--></nav><div class="page-head" data-v-d9042022><h1 data-v-d9042022>${ssrInterpolate(unref(t)("tab." + __props.tab))}</h1><span class="window-badge" data-v-d9042022>${ssrInterpolate(unref(t)("win.label"))} · ${ssrInterpolate(unref(winName)(__props.d?.win))}</span></div>`);
       if (__props.tab === "overview") {
         _push(ssrRenderComponent(_sfc_main$1, { d: __props.d }, null, _parent));
       } else if (__props.tab === "energy") {
-        _push(ssrRenderComponent(_sfc_main$2, { d: __props.d }, null, _parent));
+        _push(ssrRenderComponent(_sfc_main$3, { d: __props.d }, null, _parent));
       } else if (__props.tab === "component") {
-        _push(ssrRenderComponent(_sfc_main$4, {
+        _push(ssrRenderComponent(_sfc_main$5, {
           d: __props.d,
           sys: __props.sys
         }, null, _parent));
+      } else if (__props.tab === "fault") {
+        _push(ssrRenderComponent(_sfc_main$2, { d: __props.d }, null, _parent));
       } else if (pending.value) {
-        _push(`<section class="card" data-v-8bbd46d4><h2 data-v-8bbd46d4>${ssrInterpolate(unref(t)("tab." + __props.tab))} <small data-v-8bbd46d4>（本页签尚未迁移到 Vue）</small></h2><p class="hint" data-v-8bbd46d4> 迁移纪律：页签逐个搬，每搬一个就用 <code data-v-8bbd46d4>tools/render_parity.mjs</code> 与重构前页面 （现网 <code data-v-8bbd46d4>/detail/v2</code>）对拍文案/数值/类名序列，**通过后**才删对应的 Python 前端源码。 当前已迁移：${ssrInterpolate(unref(DONE).join("、"))}。 </p></section>`);
+        _push(`<section class="card" data-v-d9042022><h2 data-v-d9042022>${ssrInterpolate(unref(t)("tab." + __props.tab))} <small data-v-d9042022>（本页签尚未迁移到 Vue）</small></h2><p class="hint" data-v-d9042022> 迁移纪律：页签逐个搬，每搬一个就用 <code data-v-d9042022>tools/render_parity.mjs</code> 与重构前页面 （现网 <code data-v-d9042022>/detail/v2</code>）对拍文案/数值/类名序列，**通过后**才删对应的 Python 前端源码。 当前已迁移：${ssrInterpolate(unref(DONE).join("、"))}。 </p></section>`);
       } else {
         _push(`<!---->`);
       }
@@ -1459,7 +1681,7 @@ _sfc_main.setup = (props, ctx) => {
   (ssrContext.modules || (ssrContext.modules = /* @__PURE__ */ new Set())).add("src/views/Workbench.vue");
   return _sfc_setup ? _sfc_setup(props, ctx) : void 0;
 };
-const Workbench = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-8bbd46d4"]]);
+const Workbench = /* @__PURE__ */ _export_sfc(_sfc_main, [["__scopeId", "data-v-d9042022"]]);
 async function renderTab(d, tab = "overview") {
   const app = createSSRApp(Workbench, { d, tab });
   return await renderToString(app);

app_frontEnd/web/tools/render_parity.mjs

@@ -1,225 +1,227 @@
-/**
- * 呈现对拍（P11）· 多页签版：把**重构前的页面**与**Vue 迁移后的组件**放在同一份数据上比一遍。
- *
- * 口径（实逮决定）：
- *  · `/detail/v2` 是浏览器里现渲的单页（HTML 只有壳 + 内联 app.js/charts.js + 语言包，无 window.__DATA__）
- *    ⇒ 基线必须**让旧代码真跑一遍**：jsdom 加载现网页面，并在 **beforeParse** 装 fetch 桩转发到真实网关
- *    （桩晚装一句，旧页面就 `fetch is not defined`，基线全空）。
- *  · 页签由 hash 决定（`#tab=energy`）⇒ 基线按同一 hash 加载，两边渲染同页签。
- *  · Vue 侧用**同一份数据**（fetch 桩记录下的 /api/fleet 响应）经 SSR 渲成 HTML。
- *  · 比对：
- *      ① 文本序列（`#root` 下所有文本节点，按 DOM 顺序、空白归一）—— 结构 + 文案一致；
- *      ② 表格单元格文本（逐表、逐行）；
- *      ③ **图表数据**：旧页面内联 SVG 里的数字 vs Vue 侧 ECharts option 里 `__data__` 的数字
- *         （视觉实现不同是用户令「引入 ECharts」的结果，**数据必须同源**）。
- *
- * 用法：node tools/render_parity.mjs [gateway] [tab1] [tab2] ...
- * 退出码：0 全一致 · 9 有不一致 · 2 基准页取不到。
- */
-import { fileURLToPath, pathToFileURL } from 'node:url'
-import { dirname, resolve } from 'node:path'
-import { JSDOM, VirtualConsole } from 'jsdom'
-
-const HERE = dirname(fileURLToPath(import.meta.url))
-const GATEWAY = process.argv[2] || 'http://127.0.0.1:28084'
-const TABS = process.argv.slice(3).length ? process.argv.slice(3) : ['overview', 'energy', 'component']
-
-/** 让 jsdom 里的相对地址 fetch 打到真实网关；顺手记录 `/api/fleet` 的原始响应。 */
-function installFetch(window, state) {
-  window.fetch = async (input, init) => {
-    const raw = typeof input === 'string' ? input : (input && input.url) || String(input)
-    const url = raw.startsWith('http') ? raw : GATEWAY + (raw.startsWith('/') ? raw : '/' + raw)
-    const resp = await fetch(url, init)
-    const body = await resp.text()
-    if (url.includes('/api/fleet')) {
-      try { state.fleet = JSON.parse(body); state.fleetUrl = url } catch { /* 非 JSON */ }
-    }
-    return {
-      ok: resp.ok, status: resp.status,
-      headers: { get: (k) => resp.headers.get(k) },
-      json: async () => JSON.parse(body), text: async () => body,
-    }
-  }
-}
-
-const norm = (s) => String(s).replace(/\s+/g, ' ').trim()
-
-/** 文本节点序列（跳过画布/SVG —— 图形由"图表数据"那一项比）。 */
-function textsIn(root) {
-  const out = []
-  const walk = (n) => {
-    for (const c of n.childNodes) {
-      if (c.nodeType === 3) {
-        const s = norm(c.textContent)
-        if (s) out.push(s)
-      } else if (c.nodeType === 1) {
-        const tag = c.tagName.toLowerCase()
-        if (tag === 'canvas' || tag === 'svg' || tag === 'script' || tag === 'style') continue
-        walk(c)
-      }
-    }
-  }
-  walk(root)
-  return out
-}
-
-/** 表格：每张表的行×单元格文本。 */
-function tablesIn(root) {
-  return Array.from(root.querySelectorAll('table')).map((tb) =>
-    Array.from(tb.querySelectorAll('tr')).map((tr) =>
-      Array.from(tr.querySelectorAll('th,td')).map((c) => norm(c.textContent))))
-}
-
-/** 旧页面图表里的数字（内联 SVG 文本里的数值）。 */
-function svgNumbers(root) {
-  const out = []
-  for (const t of Array.from(root.querySelectorAll('svg text'))) {
-    for (const m of norm(t.textContent).matchAll(/-?\d[\d,]*(?:\.\d+)?/g)) out.push(m[0].replace(/,/g, ''))
-  }
-  return out
-}
-
-/** Vue 侧：ECharts option 的 `__data__` 里的数字（数据级对拍）。 */
-function chartNumbers(root) {
-  const out = []
-  for (const el of Array.from(root.querySelectorAll('[data-chart]'))) {
-    let opt = null
-    try { opt = JSON.parse(el.getAttribute('data-chart') || 'null') } catch { /* ignore */ }
-    const d = opt && opt.__data__
-    if (!d) continue
-    const walk = (x) => {
-      if (typeof x === 'number') { if (Number.isFinite(x)) out.push(String(Math.round(x))); return }
-      if (Array.isArray(x)) { x.forEach(walk); return }
-      if (x && typeof x === 'object') { Object.values(x).forEach(walk) }
-    }
-    walk(d)
-  }
-  return out
-}
-
-async function baseline(tab) {
-  const html = await (await fetch(GATEWAY + '/detail/v2')).text()
-  const state = {}
-  const dom = new JSDOM(html, {
-    url: GATEWAY + `/detail/v2#tab=${tab}`,
-    runScripts: 'dangerously', pretendToBeVisual: true,
-    virtualConsole: new VirtualConsole(),
-    beforeParse: (window) => installFetch(window, state),
-  })
-  const doc = dom.window.document
-  // ★实逮：`#root` 初始就带一个 `.panel`（出错提示占位）——若拿 `.panel` 当"渲染好了"的判据，
-  //   会在 app.js 取数之前就跳出循环，基线全空。判据改用 render() 一定产出的 `.page-head`，
-  //   并且要求 fetch 桩已经记下 `/api/fleet` 的响应。
-  for (let i = 0; i < 120; i++) {
-    const root = doc.getElementById('root')
-    if (state.fleet && root && root.querySelector('.page-head')) break
-    await new Promise((r) => setTimeout(r, 500))
-  }
-  return { doc, data: state.fleet, root: doc.getElementById('root') }
-}
-
-async function vueAnchors(data, tab) {
-  const entry = pathToFileURL(resolve(HERE, '../target/ssr/entry-server.js')).href
-  const html = await (await import(entry)).renderTab(data, tab)
-  const dom = new JSDOM(`<div id="wrap">${html}</div>`)
-  const wrap = dom.window.document.getElementById('wrap')
-  // ★对齐口径：基线取的是 `#root`（页签内容本身，页签导航在 #root 之外的 #tabs）。
-  //   Vue 的 Workbench 把导航也渲进来了 ⇒ 这里先把导航摘掉再比；导航文案单独比（见 tabsLabel）。
-  const nav = wrap.querySelector('.wb-tabs, #tabs, nav')
-  const tabsLabel = nav ? Array.from(nav.querySelectorAll('button')).map((b) => norm(b.textContent.replace(/迁移中/, ''))) : []
-  if (nav) nav.remove()
-  return { wrap, tabsLabel }
-}
-
-/** 深比较（表格用）：返回第一个差异的说明。 */
-function cmpDeep(a, b, label) {
-  const A = JSON.stringify(a), B = JSON.stringify(b)
-  if (A === B) return ''
-  if (a.length !== b.length) return `${label}: 张数/行数不同 ${a.length} ≠ ${b.length}`
-  for (let i = 0; i < a.length; i++) {
-    if (JSON.stringify(a[i]) !== JSON.stringify(b[i])) {
-      const ra = a[i] || [], rb = b[i] || []
-      if (ra.length !== rb.length) return `${label}: 第 ${i + 1} 张表行数 ${ra.length} ≠ ${rb.length}`
-      for (let r = 0; r < ra.length; r++) {
-        if (JSON.stringify(ra[r]) !== JSON.stringify(rb[r])) {
-          return `${label}: 第 ${i + 1} 张表第 ${r + 1} 行不同 —— "${String(ra[r]).slice(0, 60)}" ≠ "${String(rb[r]).slice(0, 60)}"`
-        }
-      }
-    }
-  }
-  return label + ': 有差异'
-}
-
-function cmpList(a, b, label) {
-  if (a.length !== b.length) {
-    const [short, long, side] = a.length < b.length ? [a, b, 'Vue 多'] : [b, a, '基准多']
-    const extra = long.slice(short.length, short.length + 6).map((s) => `"${String(s).slice(0, 60)}"`)
-    return `${label}: 条数 ${a.length} ≠ ${b.length}；${side} ${long.length - short.length} 项，例如 ${extra.join(' / ')}`
-  }
-  for (let i = 0; i < a.length; i++) {
-    if (a[i] !== b[i]) return `${label}[${i}]: "${String(a[i]).slice(0, 70)}" ≠ "${String(b[i]).slice(0, 70)}"`
-  }
-  return ''
-}
-
-function cmpSorted(a, b, label) {
-  const A = [...a].sort(), B = [...b].sort()
-  if (A.length !== B.length) return `${label}: 条数 ${A.length} ≠ ${B.length}`
-  for (let i = 0; i < A.length; i++) if (A[i] !== B[i]) return `${label}: 值集合不同（首个差异 ${A[i]} ≠ ${B[i]}）`
-  return ''
-}
-
-let bad = 0
-const DUMP = process.env.PARITY_DUMP === '1'
-for (const tab of TABS) {
-  const base = await baseline(tab)
-  if (!base.data) {
-    console.log(`[X] ${tab}: 取不到 /api/fleet 数据（服务没起？）`)
-    bad++
-    continue
-  }
-  const vroot = await vueAnchors(base.data, tab)
-  if (DUMP) {
-    const bt = textsIn(base.root), vt = textsIn(vroot.wrap)
-    console.log(`\n== ${tab} 文本对照（基准 ${bt.length} / Vue ${vt.length}）==`)
-    for (let i = 0; i < Math.max(bt.length, vt.length); i++) {
-      const same = bt[i] === vt[i]
-      console.log(`  ${String(i).padStart(3)} ${same ? '  ' : '≠ '}基:${String(bt[i] ?? '—').slice(0, 60).padEnd(62)} Vue:${String(vt[i] ?? '—').slice(0, 60)}`)
-    }
-    console.log(`  图数字 基: ${svgNumbers(base.root).join(',')}`)
-    console.log(`  图数字 Vue: ${chartNumbers(vroot.wrap).join(',')}`)
-    console.log(`  末尾 基: ${bt.slice(-5).map((s) => `"${s.slice(0, 40)}"`).join(' | ')}`)
-    console.log(`  末尾 Vue: ${vt.slice(-5).map((s) => `"${s.slice(0, 40)}"`).join(' | ')}`)
-    console.log(`  表 基: ${JSON.stringify(tablesIn(base.root)).slice(0, 400)}`)
-    console.log(`  表 Vue: ${JSON.stringify(tablesIn(vroot.wrap)).slice(0, 400)}`)
-    const bt1 = tablesIn(base.root)[1], vt1 = tablesIn(vroot.wrap)[1]
-    if (bt1 || vt1) {
-      console.log(`  第2张表 基 ${(bt1 || []).length} 行 / Vue ${(vt1 || []).length} 行`)
-      for (let i = 0; i < Math.max((bt1 || []).length, (vt1 || []).length); i++) {
-        const A = JSON.stringify(bt1?.[i] ?? null), B = JSON.stringify(vt1?.[i] ?? null)
-        if (A !== B) console.log(`   行${i} 基:${String(A).slice(0, 130)}\n          Vue:${String(B).slice(0, 130)}`)
-      }
-    }
-  }
-  const baseTabs = Array.from(base.doc.querySelectorAll('#tabs button')).map((b) => norm(b.textContent))
-  const checks = [
-    cmpList(textsIn(base.root), textsIn(vroot.wrap), '文本序列'),
-    cmpDeep(tablesIn(base.root), tablesIn(vroot.wrap), '表格'),
-    cmpList(baseTabs, vroot.tabsLabel, '页签'),
-  ]
-  const svgN = svgNumbers(base.root)
-  const echN = chartNumbers(vroot.wrap)
-  // 图表：老页面没有 SVG（或该页签本就无图）时不比；两边都有才比数据集合
-  if (svgN.length && echN.length) checks.push(cmpSorted(svgN, echN, '图表数据(数字集合)'))
-  const fails = checks.filter(Boolean)
-  const extra = `文本 ${textsIn(base.root).length} 项 · 表 ${tablesIn(base.root).length} 张 · 图数字 ${svgN.length}/${echN.length}`
-  if (fails.length) {
-    bad++
-    console.log(`[X] ${tab} —— ${extra}`)
-    for (const f of fails) console.log('      ' + f)
-  } else {
-    console.log(`[OK] ${tab} —— ${extra}（呈现一致）`)
-  }
-}
-console.log(`\n结论: ${bad === 0 ? `页签 ${TABS.join('/')} 与重构前呈现一致` : `${bad} 个页签不一致（见上）`}`)
-process.exit(bad === 0 ? 0 : 9)
+/**
+ * 呈现对拍（P11）· 多页签版：把**重构前的页面**与**Vue 迁移后的组件**放在同一份数据上比一遍。
+ *
+ * 口径（实逮决定）：
+ *  · `/detail/v2` 是浏览器里现渲的单页（HTML 只有壳 + 内联 app.js/charts.js + 语言包，无 window.__DATA__）
+ *    ⇒ 基线必须**让旧代码真跑一遍**：jsdom 加载现网页面，并在 **beforeParse** 装 fetch 桩转发到真实网关
+ *    （桩晚装一句，旧页面就 `fetch is not defined`，基线全空）。
+ *  · 页签由 hash 决定（`#tab=energy`）⇒ 基线按同一 hash 加载，两边渲染同页签。
+ *  · Vue 侧用**同一份数据**（fetch 桩记录下的 /api/fleet 响应）经 SSR 渲成 HTML。
+ *  · 比对：
+ *      ① 文本序列（`#root` 下所有文本节点，按 DOM 顺序、空白归一）—— 结构 + 文案一致；
+ *      ② 表格单元格文本（逐表、逐行）；
+ *      ③ **图表数据**：旧页面内联 SVG 里的数字 vs Vue 侧 ECharts option 里 `__data__` 的数字
+ *         （视觉实现不同是用户令「引入 ECharts」的结果，**数据必须同源**）。
+ *
+ * 用法：node tools/render_parity.mjs [gateway] [tab1] [tab2] ...
+ * 退出码：0 全一致 · 9 有不一致 · 2 基准页取不到。
+ */
+import { fileURLToPath, pathToFileURL } from 'node:url'
+import { dirname, resolve } from 'node:path'
+import { JSDOM, VirtualConsole } from 'jsdom'
+
+const HERE = dirname(fileURLToPath(import.meta.url))
+const GATEWAY = process.argv[2] || 'http://127.0.0.1:28084'
+const TABS = process.argv.slice(3).length ? process.argv.slice(3) : ['overview', 'energy', 'component']
+
+/** 让 jsdom 里的相对地址 fetch 打到真实网关；顺手记录 `/api/fleet` 的原始响应。 */
+function installFetch(window, state) {
+  window.fetch = async (input, init) => {
+    const raw = typeof input === 'string' ? input : (input && input.url) || String(input)
+    const url = raw.startsWith('http') ? raw : GATEWAY + (raw.startsWith('/') ? raw : '/' + raw)
+    const resp = await fetch(url, init)
+    const body = await resp.text()
+    if (url.includes('/api/fleet')) {
+      try { state.fleet = JSON.parse(body); state.fleetUrl = url } catch { /* 非 JSON */ }
+    }
+    return {
+      ok: resp.ok, status: resp.status,
+      headers: { get: (k) => resp.headers.get(k) },
+      json: async () => JSON.parse(body), text: async () => body,
+    }
+  }
+}
+
+const norm = (s) => String(s).replace(/\s+/g, ' ').trim()
+
+/** 文本节点序列（跳过画布/SVG —— 图形由"图表数据"那一项比）。 */
+function textsIn(root) {
+  const out = []
+  const walk = (n) => {
+    for (const c of n.childNodes) {
+      if (c.nodeType === 3) {
+        const s = norm(c.textContent)
+        if (s) out.push(s)
+      } else if (c.nodeType === 1) {
+        const tag = c.tagName.toLowerCase()
+        if (tag === 'canvas' || tag === 'svg' || tag === 'script' || tag === 'style') continue
+        walk(c)
+      }
+    }
+  }
+  walk(root)
+  return out
+}
+
+/** 表格：每张表的行×单元格文本。 */
+function tablesIn(root) {
+  return Array.from(root.querySelectorAll('table')).map((tb) =>
+    Array.from(tb.querySelectorAll('tr')).map((tr) =>
+      Array.from(tr.querySelectorAll('th,td')).map((c) => norm(c.textContent))))
+}
+
+/** 旧页面图表里的数字（内联 SVG 文本里的数值）。 */
+function svgNumbers(root) {
+  const out = []
+  for (const t of Array.from(root.querySelectorAll('svg text'))) {
+    for (const m of norm(t.textContent).matchAll(/-?\d[\d,]*(?:\.\d+)?/g)) out.push(m[0].replace(/,/g, ''))
+  }
+  return out
+}
+
+/** Vue 侧：ECharts option 的 `__data__` 里的数字（数据级对拍）。 */
+function chartNumbers(root) {
+  const out = []
+  for (const el of Array.from(root.querySelectorAll('[data-chart]'))) {
+    let opt = null
+    try { opt = JSON.parse(el.getAttribute('data-chart') || 'null') } catch { /* ignore */ }
+    const d = opt && opt.__data__
+    if (!d) continue
+    const walk = (x) => {
+      if (typeof x === 'number') { if (Number.isFinite(x)) out.push(String(Math.round(x))); return }
+      if (Array.isArray(x)) { x.forEach(walk); return }
+      if (x && typeof x === 'object') { Object.values(x).forEach(walk) }
+    }
+    walk(d)
+  }
+  return out
+}
+
+async function baseline(tab) {
+  const html = await (await fetch(GATEWAY + '/detail/v2')).text()
+  const state = {}
+  const dom = new JSDOM(html, {
+    url: GATEWAY + `/detail/v2#tab=${tab}`,
+    runScripts: 'dangerously', pretendToBeVisual: true,
+    virtualConsole: new VirtualConsole(),
+    beforeParse: (window) => installFetch(window, state),
+  })
+  const doc = dom.window.document
+  // ★实逮：`#root` 初始就带一个 `.panel`（出错提示占位）——若拿 `.panel` 当"渲染好了"的判据，
+  //   会在 app.js 取数之前就跳出循环，基线全空。判据改用 render() 一定产出的 `.page-head`，
+  //   并且要求 fetch 桩已经记下 `/api/fleet` 的响应。
+  for (let i = 0; i < 120; i++) {
+    const root = doc.getElementById('root')
+    if (state.fleet && root && root.querySelector('.page-head')) break
+    await new Promise((r) => setTimeout(r, 500))
+  }
+  return { doc, data: state.fleet, root: doc.getElementById('root') }
+}
+
+async function vueAnchors(data, tab) {
+  const entry = pathToFileURL(resolve(HERE, '../target/ssr/entry-server.js')).href
+  const html = await (await import(entry)).renderTab(data, tab)
+  const dom = new JSDOM(`<div id="wrap">${html}</div>`)
+  const wrap = dom.window.document.getElementById('wrap')
+  // ★对齐口径：基线取的是 `#root`（页签内容本身，页签导航在 #root 之外的 #tabs）。
+  //   Vue 的 Workbench 把导航也渲进来了 ⇒ 这里先把导航摘掉再比；导航文案单独比（见 tabsLabel）。
+  const nav = wrap.querySelector('.wb-tabs, #tabs, nav')
+  const tabsLabel = nav ? Array.from(nav.querySelectorAll('button')).map((b) => norm(b.textContent.replace(/迁移中/, ''))) : []
+  if (nav) nav.remove()
+  return { wrap, tabsLabel }
+}
+
+/** 深比较（表格用）：返回第一个差异的说明。 */
+function cmpDeep(a, b, label) {
+  const A = JSON.stringify(a), B = JSON.stringify(b)
+  if (A === B) return ''
+  if (a.length !== b.length) return `${label}: 张数/行数不同 ${a.length} ≠ ${b.length}`
+  for (let i = 0; i < a.length; i++) {
+    if (JSON.stringify(a[i]) !== JSON.stringify(b[i])) {
+      const ra = a[i] || [], rb = b[i] || []
+      if (ra.length !== rb.length) return `${label}: 第 ${i + 1} 张表行数 ${ra.length} ≠ ${rb.length}`
+      for (let r = 0; r < ra.length; r++) {
+        if (JSON.stringify(ra[r]) !== JSON.stringify(rb[r])) {
+          return `${label}: 第 ${i + 1} 张表第 ${r + 1} 行不同 —— "${String(ra[r]).slice(0, 60)}" ≠ "${String(rb[r]).slice(0, 60)}"`
+        }
+      }
+    }
+  }
+  return label + ': 有差异'
+}
+
+function cmpList(a, b, label) {
+  if (a.length !== b.length) {
+    const [short, long, side] = a.length < b.length ? [a, b, 'Vue 多'] : [b, a, '基准多']
+    const extra = long.slice(short.length, short.length + 6).map((s) => `"${String(s).slice(0, 60)}"`)
+    return `${label}: 条数 ${a.length} ≠ ${b.length}；${side} ${long.length - short.length} 项，例如 ${extra.join(' / ')}`
+  }
+  for (let i = 0; i < a.length; i++) {
+    if (a[i] !== b[i]) return `${label}[${i}]: "${String(a[i]).slice(0, 70)}" ≠ "${String(b[i]).slice(0, 70)}"`
+  }
+  return ''
+}
+
+/** 图数据：**子集**规则 —— 旧图把数据与坐标刻度都写成 SVG 文本，ECharts 的刻度在画布上拿不到，
+ *  所以只要求"Vue 画的每个数都在旧图数字里出现"（抓数据画错/画多；刻度差异不算）。 */
+function cmpSubset(vueNums, baseNums, label) {
+  const pool = new Set(baseNums)
+  const missing = vueNums.filter((v) => !pool.has(v))
+  if (missing.length) return `${label}: Vue 有 ${missing.length} 个数字不在旧图里，例如 ${missing.slice(0, 6).join(',')}`
+  return ''
+}
+
+let bad = 0
+const DUMP = process.env.PARITY_DUMP === '1'
+for (const tab of TABS) {
+  const base = await baseline(tab)
+  if (!base.data) {
+    console.log(`[X] ${tab}: 取不到 /api/fleet 数据（服务没起？）`)
+    bad++
+    continue
+  }
+  const vroot = await vueAnchors(base.data, tab)
+  if (DUMP) {
+    const bt = textsIn(base.root), vt = textsIn(vroot.wrap)
+    console.log(`\n== ${tab} 文本对照（基准 ${bt.length} / Vue ${vt.length}）==`)
+    for (let i = 0; i < Math.max(bt.length, vt.length); i++) {
+      const same = bt[i] === vt[i]
+      console.log(`  ${String(i).padStart(3)} ${same ? '  ' : '≠ '}基:${String(bt[i] ?? '—').slice(0, 60).padEnd(62)} Vue:${String(vt[i] ?? '—').slice(0, 60)}`)
+    }
+    console.log(`  图数字 基: ${svgNumbers(base.root).join(',')}`)
+    console.log(`  图数字 Vue: ${chartNumbers(vroot.wrap).join(',')}`)
+    console.log(`  末尾 基: ${bt.slice(-5).map((s) => `"${s.slice(0, 40)}"`).join(' | ')}`)
+    console.log(`  末尾 Vue: ${vt.slice(-5).map((s) => `"${s.slice(0, 40)}"`).join(' | ')}`)
+    console.log(`  表 基: ${JSON.stringify(tablesIn(base.root)).slice(0, 400)}`)
+    console.log(`  表 Vue: ${JSON.stringify(tablesIn(vroot.wrap)).slice(0, 400)}`)
+    const bt1 = tablesIn(base.root)[1], vt1 = tablesIn(vroot.wrap)[1]
+    if (bt1 || vt1) {
+      console.log(`  第2张表 基 ${(bt1 || []).length} 行 / Vue ${(vt1 || []).length} 行`)
+      for (let i = 0; i < Math.max((bt1 || []).length, (vt1 || []).length); i++) {
+        const A = JSON.stringify(bt1?.[i] ?? null), B = JSON.stringify(vt1?.[i] ?? null)
+        if (A !== B) console.log(`   行${i} 基:${String(A).slice(0, 130)}\n          Vue:${String(B).slice(0, 130)}`)
+      }
+    }
+  }
+  const baseTabs = Array.from(base.doc.querySelectorAll('#tabs button')).map((b) => norm(b.textContent))
+  const checks = [
+    cmpList(textsIn(base.root), textsIn(vroot.wrap), '文本序列'),
+    cmpDeep(tablesIn(base.root), tablesIn(vroot.wrap), '表格'),
+    cmpList(baseTabs, vroot.tabsLabel, '页签'),
+  ]
+  const svgN = svgNumbers(base.root)
+  const echN = chartNumbers(vroot.wrap)
+  // 图表：老页面没有 SVG（或该页签本就无图）时不比；两边都有才比数据集合
+  if (svgN.length && echN.length) checks.push(cmpSubset(echN, svgN, '图表数据(Vue ⊆ 旧图)'))
+  const fails = checks.filter(Boolean)
+  const extra = `文本 ${textsIn(base.root).length} 项 · 表 ${tablesIn(base.root).length} 张 · 图数字 ${svgN.length}/${echN.length}`
+  if (fails.length) {
+    bad++
+    console.log(`[X] ${tab} —— ${extra}`)
+    for (const f of fails) console.log('      ' + f)
+  } else {
+    console.log(`[OK] ${tab} —— ${extra}（呈现一致）`)
+  }
+}
+console.log(`\n结论: ${bad === 0 ? `页签 ${TABS.join('/')} 与重构前呈现一致` : `${bad} 个页签不一致（见上）`}`)
+process.exit(bad === 0 ? 0 : 9)

docs/src/数据要求说明_观澜_2.21.0.md → docs/src/数据要求说明_观澜_2.21.1.md

@@ -1,4 +1,4 @@
-# 数据要求说明 · 观澜 v2 风电场智能分析系统 · 版本 2.21.0
+# 数据要求说明 · 观澜 v2 风电场智能分析系统 · 版本 2.21.1
 
 ## 1 文档说明
 

docs/src/系统设计说明_观澜_2.21.0.md → docs/src/系统设计说明_观澜_2.21.1.md

@@ -1,4 +1,4 @@
-# 系统设计说明 · 观澜 v2 风电场智能分析系统 · 版本 2.21.0
+# 系统设计说明 · 观澜 v2 风电场智能分析系统 · 版本 2.21.1
 
 ## 1 文档说明
 
@@ -6,19 +6,19 @@
 
 ### 1.1 目的与范围
 
-本文是"观澜 v2（风电场智能分析系统）"（海上风电场智能分析离线系统）的设计说明（下称"本系统"），面向版本 2.21.0；内容以样本风电场（下称"本场"）为依据，样本场实测日期为 2026-09-22，说明本系统"由哪些部分组成、各部分怎么实现、数据从哪来到哪去、判据写在哪里、怎么验证、边界在哪里"。
+本文是"观澜 v2（风电场智能分析系统）"（海上风电场智能分析离线系统）的设计说明（下称"本系统"），面向版本 2.21.1；内容以样本风电场（下称"本场"）为依据，样本场实测日期为 2026-09-22，说明本系统"由哪些部分组成、各部分怎么实现、数据从哪来到哪去、判据写在哪里、怎么验证、边界在哪里"。
 
 本文覆盖十五个设计面：总体架构与分层、目录结构与路径真源、数据接入与重算链、判级与算法、时间窗口径、服务与前端、本体与知识层、本机模型接入、运维控制台与重算编排、安装与服务化与版本管理、质量保证、安全与离线边界、可移植性与资源占用、多场适用性与换场迁移、已知边界与未实现。
 
-本文不重复需求条目本身（那是《需求分析_观澜_2.21.0.docx》的职责），也不重复操作步骤的逐步手册（那是 docs/重算操作手册_v0.1.md 与《使用说明书》v0.2（随包 docs/）的职责）；本文只回答"设计上为什么这样、落在哪个文件的哪一处、用什么机器守卫保证它不漂移"。
+本文不重复需求条目本身（那是《需求分析_观澜_2.21.1.docx》的职责），也不重复操作步骤的逐步手册（那是 docs/重算操作手册_v0.1.md 与《使用说明书》v0.2（随包 docs/）的职责）；本文只回答"设计上为什么这样、落在哪个文件的哪一处、用什么机器守卫保证它不漂移"。
 
 ### 1.2 读者与用法
 
 现场运维与检修人员可看第 3 章、第 7 章、第 8 章、第 11 章，了解自己能点到的页面背后读的是什么口径；场站管理人员与换场交付人员可看第 6 章、第 7 章、第 16 章、第 17 章，了解判级与可靠性指标的口径与边界，以及换场时要重新标定哪些参数；研发与交付人员应通读全文，重点是第 4 章、第 5 章、第 12 章、第 13 章；验收方可直接按第 13 章的质量门与附录 A 的编写依据逐条复核。
 
-### 1.3 与《需求分析_观澜_2.21.0.docx》的对应关系
+### 1.3 与《需求分析_观澜_2.21.1.docx》的对应关系
 
-需求分析写"要什么、为谁、优先级与验收门"，设计说明写"怎么实现、落在哪、如何自证"。两文的章节对应关系如表 1-1 所示；与《数据要求说明_观澜_2.21.0.docx》的数据侧口径去向见 16.6 节。
+需求分析写"要什么、为谁、优先级与验收门"，设计说明写"怎么实现、落在哪、如何自证"。两文的章节对应关系如表 1-1 所示；与《数据要求说明_观澜_2.21.1.docx》的数据侧口径去向见 16.6 节。
 
 | 本文章节 | 需求分析对应章 | 对应关系说明 |
 |---|---|---|
@@ -41,7 +41,7 @@
 
 ### 1.4 口径与依据
 
-本文所有数字来自仓库文件或命令的实跑输出，不采用估算与推测；查不到、未实现的，一律写"未取证"或"未实现"，并在第 17 章汇总。本文中"本次实测"与各表"实测"列一律指样本场实测（2026-09-22）：即在样本风电场的一套实例上的一次实跑，换场后这些数字会变、方法与口径不变。版本号的唯一真源是 src/version.py 的 VERSION 常量，本版为 2.21.0；打包文件名由 src/version.py 的 package_name() 给出，为 app_guanlang_v2.21.0.zip。
+本文所有数字来自仓库文件或命令的实跑输出，不采用估算与推测；查不到、未实现的，一律写"未取证"或"未实现"，并在第 17 章汇总。本文中"本次实测"与各表"实测"列一律指样本场实测（2026-09-22）：即在样本风电场的一套实例上的一次实跑，换场后这些数字会变、方法与口径不变。版本号的唯一真源是 src/version.py 的 VERSION 常量，本版为 2.21.1；打包文件名由 src/version.py 的 package_name() 给出，为 app_guanlang_v2.21.1.zip。
 
 本文遵循四条写作口径：含"窗"且确实指时间窗口的，一律写全"时间窗"（天气窗、作业窗、预览窗、观测窗属领域词，保持原样）；影响的是风电机组时写"影响机组"或"影响机组数"；使用英文简写时必须写成"中文（英文简写）"形式，如平均无故障间隔（MTBF）、平均停机间隔（MTBO）、单次停机时长（MDT）；全文用简体中文与半角数字与单位。
 
@@ -839,7 +839,7 @@ Windows 安装入口是 install.bat 与 install.ps1，步骤号写死在输出
 
 ### 12.3 安装记录与版本三守卫
 
-安装记录 install-info.json 是"这台机器装的是哪一版"的唯一凭据，字段如表 12-3 所示。装完写、卸载时删（删掉等于这台机器回到"没装过"）。需要如实指出：本机该文件记录的版本是 2.5.0（装于 2026-09-17），落后于当前代码版本 2.21.0，因此它正是"安装前检查会提示版本差异"的活样本；重装或升级后会随之更新。
+安装记录 install-info.json 是"这台机器装的是哪一版"的唯一凭据，字段如表 12-3 所示。装完写、卸载时删（删掉等于这台机器回到"没装过"）。需要如实指出：本机该文件记录的版本是 2.5.0（装于 2026-09-17），落后于当前代码版本 2.21.1，因此它正是"安装前检查会提示版本差异"的活样本；重装或升级后会随之更新。
 
 | 字段 | 含义 |
 |---|---|
@@ -1200,7 +1200,7 @@ Linux 侧的适配程度如表 15-4 所示，全部为"已有实现但在本次
 
 ### 16.6 与同批交付文档的对应关系
 
-本章对应《需求分析_观澜_2.21.0.docx》第 11 章（场配置化、机组与机型可替换、数据源形态可适配、阈值按场标定、术语与单位可配、跨场统一口径、按场裁剪收资、换场验收检查表）与《数据要求说明_观澜_2.21.0.docx》第 12 章（通用必选与可选的判定规则、场配置字段对照、数据源形态适配、换场收资差异清单、按场裁剪步骤）；本章给的是设计侧的落点、换场作业单与检查表，数据侧的收资口径与字段要求以数据要求说明为准，需求侧的验收项以需求分析为准。
+本章对应《需求分析_观澜_2.21.1.docx》第 11 章（场配置化、机组与机型可替换、数据源形态可适配、阈值按场标定、术语与单位可配、跨场统一口径、按场裁剪收资、换场验收检查表）与《数据要求说明_观澜_2.21.1.docx》第 12 章（通用必选与可选的判定规则、场配置字段对照、数据源形态适配、换场收资差异清单、按场裁剪步骤）；本章给的是设计侧的落点、换场作业单与检查表，数据侧的收资口径与字段要求以数据要求说明为准，需求侧的验收项以需求分析为准。
 
 ***
 
@@ -1266,7 +1266,7 @@ Linux 侧的适配程度如表 15-4 所示，全部为"已有实现但在本次
 
 | 章节 | 来源文件 |
 |---|---|
-| 1 文档说明 | src/version.py（VERSION 与 HISTORY 的 2.21.0 条目）、docs/需求分析_观澜_2.21.0.docx、scripts/delivery_docs_figures.py |
+| 1 文档说明 | src/version.py（VERSION 与 HISTORY 的 2.21.1 条目）、docs/需求分析_观澜_2.21.1.docx、scripts/delivery_docs_figures.py |
 | 2 设计目标与原则 | docs/系统设计说明.md（四条设计铁律）、app_ontology/.../ontology/mcp_server.py 头部、src/windscada/subsys/fusion.py 头部、src/windscada/perf/reliability.py |
 | 3 总体架构 | configs/serve.json、scripts/guanlan_gateway.py、guanlan.py（组件启动表）、run/pids.json、docs/系统设计说明.md（产物全景） |
 | 4 目录结构与路径真源 | src/paths.py、configs/registry.yaml、docs/系统设计说明.md（路径约定与统一记录）、本次目录实测 |

docs/src/需求分析_观澜_2.21.0.md → docs/src/需求分析_观澜_2.21.1.md

@@ -1,4 +1,4 @@
-# 需求分析 · 观澜 v2 风电场智能分析系统 · 版本 2.21.0
+# 需求分析 · 观澜 v2 风电场智能分析系统 · 版本 2.21.1
 
 ## 1 文档说明
 
@@ -6,7 +6,7 @@
 
 ### 1.1 目的
 
-本文是「观澜 v2（风电场智能分析系统）」的**需求分析文档**，回答四个问题：这套系统究竟要满足谁的什么需要；这些需要从哪来、经过哪些版本变成现在的样子；每一条需要对应什么功能、什么输入、什么输出、拿什么判据验收；以及哪些事本版明确不做。本文与同批交付的《系统设计说明_观澜_2.21.0.docx》《数据要求说明_观澜_2.21.0.docx》配套：本文讲「要什么、凭什么算做到了」，设计说明讲「怎么做的」，数据要求说明讲「要哪些数据、什么形态、什么单位」。
+本文是「观澜 v2（风电场智能分析系统）」的**需求分析文档**，回答四个问题：这套系统究竟要满足谁的什么需要；这些需要从哪来、经过哪些版本变成现在的样子；每一条需要对应什么功能、什么输入、什么输出、拿什么判据验收；以及哪些事本版明确不做。本文与同批交付的《系统设计说明_观澜_2.21.1.docx》《数据要求说明_观澜_2.21.1.docx》配套：本文讲「要什么、凭什么算做到了」，设计说明讲「怎么做的」，数据要求说明讲「要哪些数据、什么形态、什么单位」。
 
 本文的写作口径是**只写能取证的事实**：每个数字、每条结论都能指到仓库里的某个文件、某次实跑输出或某条版本记录；查不到、取不到的一律写明「未取证」或「未到位」，不做推测性补全。因此文中会出现少量「未取证」的说明句，那是刻意留下的诚实边界，不是遗漏。
 
@@ -18,19 +18,19 @@
 
 ### 1.3 版本对应关系
 
-系统版本号只有一个真源：仓库内的 src/version.py 的 VERSION 一行。本版 VERSION = 2.21.0，版本记录（HISTORY）共 39 条，人读的版本表由 scripts/version_log.py 从 HISTORY 生成到 docs/版本记录.md，并由 version_log.py --check 与 guanlan.py check 双重校验「记录表与代码一致」。
+系统版本号只有一个真源：仓库内的 src/version.py 的 VERSION 一行。本版 VERSION = 2.21.1，版本记录（HISTORY）共 40 条，人读的版本表由 scripts/version_log.py 从 HISTORY 生成到 docs/版本记录.md，并由 version_log.py --check 与 guanlan.py check 双重校验「记录表与代码一致」。
 
 表 1-1 版本与文档的对应关系
 
 | 项 | 值 | 取证方式 |
 |---|---|---|
-| 系统版本 | 2.21.0 | src/version.py 的 VERSION；guanlan.py check 实跑报「版本管理: 观澜 v2（风电场智能分析系统） v2.21.0」 |
-| 交付包名 | app_guanlang_v2.21.0.zip | src/version.py 的 package_name()；同一条 check 输出 |
-| 本文版本 | 2.21.0（与系统版本同号） | 本文标题与 src/version.py 的 VERSION |
+| 系统版本 | 2.21.1 | src/version.py 的 VERSION；guanlan.py check 实跑报「版本管理: 观澜 v2（风电场智能分析系统） v2.21.1」 |
+| 交付包名 | app_guanlang_v2.21.1.zip | src/version.py 的 package_name()；同一条 check 输出 |
+| 本文版本 | 2.21.1（与系统版本同号） | 本文标题与 src/version.py 的 VERSION |
 | 版本史条目数 | 13 条（最新一条即本次文档交付） | src/version.py 的 HISTORY；docs/版本记录.md |
 | 版本号规则 | v大版本号.中版本号.小版本号；大改方案或架构、中改非核心功能、小为消缺 | src/version.py 的 BUMP_RULE 与 LEVEL_MEANING；docs/系统设计说明.md §15 |
 | 版本级别机器判据 | level_of(旧, 新) 返回 major 或 minor 或 patch 或 same | src/version.py 的 level_of() |
-| 本次变化级别 | 小（patch，源码模块化重构推进 P1：公共层九个平台件实体迁移，旧路径留兼容转发壳；系统功能与运行为未变） | HISTORY 中 2.21.0 条目的 level 字段 |
+| 本次变化级别 | 小（patch，源码模块化重构推进 P1：公共层九个平台件实体迁移，旧路径留兼容转发壳；系统功能与运行为未变） | HISTORY 中 2.21.1 条目的 level 字段 |
 
 本版相对 2.10.0 的实质变化是**交付文档对外化**：三份交付文档（需求分析、系统设计说明、数据要求说明）全文不体现具体风电场（去标识化），并新增多风电场适用性一章；系统功能未变，属交付物修订。依据用户令原文：「修改三份文档，内容参考样本风电场，但不体现样本风电场，且具有不同风电场适用性」（引用时把样本场名按去标识化口径写成「样本风电场」）。
 
@@ -119,10 +119,11 @@
 
 ### 3.2 需求演进时间轴
 
-表 3-1 版本史与用户令要点（依据 src/version.py 的 HISTORY，共 39 条）
+表 3-1 版本史与用户令要点（依据 src/version.py 的 HISTORY，共 40 条）
 
 | 版本 | 日期 | 用户令要点 | 变化级别 |
 |---|---|---|---|
+| 2.21.1 | 2026-09-29 | fault 页签迁移进行中+ 对拍门两处口径修正 | 小（patch） |
 | 2.21.0 | 2026-09-29 | 三页签通过严格整页签对拍· ECharts 图表数据级一致 | 中（minor） |
 | 2.20.0 | 2026-09-29 | ECharts 引入 + Java 网关/OAuth2/Security 落地；呈现对拍门升级为“严格整页签” | 中（minor） |
 | 2.19.0 | 2026-09-29 | Vue 迁移第一个页签+ 呈现对拍门：jsdom 跑旧页面 vs Vue SSR，锚点逐项一致 | 中（minor） |
@@ -163,7 +164,7 @@
 | 0.4.0 | 2026-09-17 | 打包默认不含输入数据与产物与日志与临时文件；无窗口启动；统一配置与日志；页面归口；服务化 | 旧编号（legacy） |
 | 0.2.0 | 2026-09-01 | 含产物的旧交付基线，历史上用作「包内无生成端」那批产物的补救源 | 旧编号（legacy） |
 
-需求的演进如图 1-1 所示。该图依据 src/version.py 的 HISTORY 绘制，覆盖上表 39 条记录（即两级旧编号 0.4.0 与 0.2.0，以及从 2.5.0 起按规则递增的三十七个版本）。按级别统计，这三十七个版本里「中」级变化17条（2.21.0、2.20.0、2.19.0、2.18.0、2.17.0、2.16.0、2.15.0、2.14.0、2.13.0、2.12.0、2.11.0、2.10.0、2.9.0、2.8.0、2.7.0、2.6.0、2.5.0），「小」级变化20条（2.15.2、2.15.1、2.12.1、2.11.9、2.11.8、2.11.7、2.11.6、2.11.5、2.11.4、2.11.3、2.11.2、2.11.1、2.10.4、2.10.3、2.10.2、2.10.1、2.9.2、2.9.1、2.8.2、2.8.1），没有大版本升级。这个分布清楚地显示出这条线的性质——**功能面在 2.5.0 到 2.7.0 之间快速铺开，之后转入以消缺与口径统一为主的密集收敛期**。
+需求的演进如图 1-1 所示。该图依据 src/version.py 的 HISTORY 绘制，覆盖上表 40 条记录（即两级旧编号 0.4.0 与 0.2.0，以及从 2.5.0 起按规则递增的三十八个版本）。按级别统计，这三十八个版本里「中」级变化17条（2.21.0、2.20.0、2.19.0、2.18.0、2.17.0、2.16.0、2.15.0、2.14.0、2.13.0、2.12.0、2.11.0、2.10.0、2.9.0、2.8.0、2.7.0、2.6.0、2.5.0），「小」级变化21条（2.21.1、2.15.2、2.15.1、2.12.1、2.11.9、2.11.8、2.11.7、2.11.6、2.11.5、2.11.4、2.11.3、2.11.2、2.11.1、2.10.4、2.10.3、2.10.2、2.10.1、2.9.2、2.9.1、2.8.2、2.8.1），没有大版本升级。这个分布清楚地显示出这条线的性质——**功能面在 2.5.0 到 2.7.0 之间快速铺开，之后转入以消缺与口径统一为主的密集收敛期**。
 
 ![图 1-1 观澜需求演进时间轴（依据 src/version.py 的 HISTORY）](figures/fig-req-01-需求演进时间轴.png)
 
@@ -182,7 +183,7 @@
 | 所有的计算均要形成观澜的源代码 | 逐族补生成端：变桨面、在升闭环、三层基线、融合面 handoff、总览页、由台账生成 claim | 反向呼应审计成立 3,548 件、不成立 0 件、未归类 0 件 |
 | 运行期一律不从交付包补齐 | 第 ⑤ 步由「补齐随包件」改为「反向呼应审计」，只报账不搬运 | rebuild_all --dry-run 计划中 ⑤ 步命令为 products_reverse_audit.py --check |
 | 清除产物不留备份 | products_state.py --off --yes 改真删除；--on 与门户恢复按钮移除 | 控制台按钮语义与 409 前置校验；docs/系统设计说明.md §7 |
-| 装成服务并在安装时检查版本 | win_service.py 以 ctypes 直连 SCM；service_main.py 与 systemd 单元；install-info.json 记录版本并比对 | check 实跑报「卸载入口在位 2 个」「版本管理 v2.21.0」 |
+| 装成服务并在安装时检查版本 | win_service.py 以 ctypes 直连 SCM；service_main.py 与 systemd 单元；install-info.json 记录版本并比对 | check 实跑报「卸载入口在位 2 个」「版本管理 v2.21.1」 |
 | 观澜改为监听所有 IP | serve.json 增 public_host 且出厂为 0.0.0.0，仅门户网关用它，组件仍绑本机 | check 实跑显示 6 个端口全部运行中；README 第二节写明无鉴权风险与回退口径 |
 | 描述口径：时间窗、影响机组、中文（英文简写） | 界面文案与报告构建器统一改写；i18n_en 键同步 | docs/系统设计说明.md §17.1 与 §17.2；语言包 845 条前后端成对 |
 | 整理需求与设计与数据接入各写一份 Word 文档 | docs/src 下 markdown 源件；渲染器输出带域目录的 docx；插图生成器生成 14 张图，数字全部从真件取 | HISTORY 2.10.0 条目；本版三份文档 |
@@ -398,7 +399,7 @@
 | NFR-09 | 安全只读：不写回现场系统、不改原始件、不产生控制指令；对外暴露时须自行在网侧限来源 | 原始件按只读输入对待，落位冲突默认拒绝；对外只有一个网关入口；启动日志每次提醒页面无鉴权 | docs/输入数据放置指导_v0.1.md §3；README_先读我.MD 第二节 |
 | NFR-10 | 可维护性：单一真源，改一处不必改多处；关键口径有机器守卫 | 版本号只有一行真源并由三处守卫盯住；路径、配置、日志、语言各有唯一取用口与审计器 | docs/系统设计说明.md §15.2 与 §11.1；docs/系统设计说明.md §3.1 |
 | NFR-11 | 无人值守与自愈：长跑的服务要能被托管并自动拉起 | 服务体每 15 秒巡检并拉起掉线组件；崩溃重启策略；远程部署一律用服务，不用会话前台进程 | docs/系统设计说明.md §14.1 与 §14.4；README_先读我.MD 第二节 |
-| NFR-12 | 收资清单按场裁剪：以通用收资模板为底，按本场的机型与数据源形态与专题范围裁剪，逐条写明必须、建议、可选或可替代以及「不收会怎样」 | 每一族都有必须性分级与缺件后果且可复核；换场时清单随场定义与机型变化，不是照抄样本场 | 本文第 11 章；《数据要求说明_观澜_2.21.0.docx》第 8 章与第 12 章 |
+| NFR-12 | 收资清单按场裁剪：以通用收资模板为底，按本场的机型与数据源形态与专题范围裁剪，逐条写明必须、建议、可选或可替代以及「不收会怎样」 | 每一族都有必须性分级与缺件后果且可复核；换场时清单随场定义与机型变化，不是照抄样本场 | 本文第 11 章；《数据要求说明_观澜_2.21.1.docx》第 8 章与第 12 章 |
 
 ### 6.2 性能与耗时实测
 
@@ -434,7 +435,7 @@
 
 | 真源 | 管什么 | 守卫与实跑结果 |
 |---|---|---|
-| src/version.py | 名称、版本、版本规则、版本史、包名 | 版本记录一致性检查；check 实跑报 v2.21.0 且记录表与代码一致 |
+| src/version.py | 名称、版本、版本规则、版本史、包名 | 版本记录一致性检查；check 实跑报 v2.21.1 且记录表与代码一致 |
 | src/paths.py | 一切路径解析的基准与助手 | 配置审计器检查不手拼路径；实跑无不一致 |
 | configs 目录与登记表 | 端口、模型档、场配置、页面归口、配置登记 | 配置审计实跑已知缺口与白名单 14 条、提示 7 条 |
 | src/logfile.py | 日志目录、命名、行格式、保留策略 | 日志审计实跑无不一致、提示 87 条 |
@@ -445,7 +446,7 @@
 
 ### 7.1 数据族与功能映射
 
-系统的数据需求可以概括成一句话：**七类现场源件加一类共享机理资料，喂出九个产物仓，页面只读产物**。每个源类目录名就是摄入接口，改名等于换接口。数据族与功能的对应关系如下表；逐类的字段、单位、必须性与质量要求见同批交付的《数据要求说明_观澜_2.21.0.docx》。
+系统的数据需求可以概括成一句话：**七类现场源件加一类共享机理资料，喂出九个产物仓，页面只读产物**。每个源类目录名就是摄入接口，改名等于换接口。数据族与功能的对应关系如下表；逐类的字段、单位、必须性与质量要求见同批交付的《数据要求说明_观澜_2.21.1.docx》。
 
 表 7-1 数据族到功能的映射（样本场实测（2026-09-22））
 
@@ -478,7 +479,7 @@
 
 ### 7.3 与数据要求说明的分工
 
-本文只回答「要哪些数据、这些数据支撑什么功能」。数据的字段级要求（核心测点的名称、单位、必须性、缺失替代、对齐规则、质量门与核对锚点）以及面向现场的收资清单，写在《数据要求说明_观澜_2.21.0.docx》里。该文档按用户令要求与现场收资文件逐条对照，并对现场收资层面的已知缺失逐条如实记录，例如测风塔数据为零交付、故障录波只有 4 台、振动侧 handoff 正本缺失由观澜自算件顶上、远端机器未安装本机模型等。
+本文只回答「要哪些数据、这些数据支撑什么功能」。数据的字段级要求（核心测点的名称、单位、必须性、缺失替代、对齐规则、质量门与核对锚点）以及面向现场的收资清单，写在《数据要求说明_观澜_2.21.1.docx》里。该文档按用户令要求与现场收资文件逐条对照，并对现场收资层面的已知缺失逐条如实记录，例如测风塔数据为零交付、故障录波只有 4 台、振动侧 handoff 正本缺失由观澜自算件顶上、远端机器未安装本机模型等。
 
 ## 8 页面与信息架构需求
 
@@ -560,7 +561,7 @@
 | 运行环境与依赖 | 10 | Python 版本不低于 3.11（实测 3.12.10）；九个第三方依赖逐个导入 | 全 OK |
 | 静态质量门 | 4 | 源码可编译 229 个文件；语言包 845 条成对；入口引用闭合 48 条；入口脚本编码守则 | 全 OK |
 | 子进程口径 | 3 | 捕获输出可用；无窗口启动输出进日志；无窗口位已设，标志位 0x8000200 | 全 OK |
-| 版本与卸载入口 | 2 | 版本管理与记录表一致（v2.21.0，包名 app_guanlang_v2.21.0.zip）；卸载入口两个都在位 | 全 OK |
+| 版本与卸载入口 | 2 | 版本管理与记录表一致（v2.21.1，包名 app_guanlang_v2.21.1.zip）；卸载入口两个都在位 | 全 OK |
 | 制品与台账审计 | 5 | 反向呼应 3,548 件成立；页面归口检查 21 项；配置统一；日志统一；输入数据放置体检 26,503 件结构合规 | 全 OK |
 | 产物与发布件在位 | 10 | 标准仓、本体对象库、findings、事实契约、门户、仿真合页服务与资料包、三维资产、仿真回放资产、治理清单交付件 | 全 OK |
 | 原始件目录 | 1 | 原始件目录存在（无数据时此项不影响页面） | 全 OK |
@@ -686,7 +687,7 @@
 
 本章有两个词要先定义。「本场」指**当前被选中的场**，由配置选定，不必然等于本文取数的样本风电场；「换场」指从一场切到另一场运行的整套动作（改配置、放数据、重跑、按检查表复验），不是把两场的数据混在一棵树里。本章沿用的占位符与附录 A 一致：`<场>`、`<场站>`、`<机型>` 按实际风电场替换。
 
-本章需求与《数据要求说明_观澜_2.21.0.docx》《系统设计说明_观澜_2.21.0.docx》配套使用：本章讲「换场要满足什么」，数据要求说明讲「要向新场收哪些数据、哪些可以裁剪」，《设计说明》讲「配置在哪一层生效、哪些参数属于场相关层」。
+本章需求与《数据要求说明_观澜_2.21.1.docx》《系统设计说明_观澜_2.21.1.docx》配套使用：本章讲「换场要满足什么」，数据要求说明讲「要向新场收哪些数据、哪些可以裁剪」，《设计说明》讲「配置在哪一层生效、哪些参数属于场相关层」。
 
 取证边界要如实写一句：FR-44 至 FR-51 与 NFR-12 有既有的场配置层、摄入层与场级字段语义登记作依据；FR-52 的跨场横向对比是本次新增的口径要求，其实跑记录与机器守卫随后续版本补齐——本文不谎称已经通过。
 
@@ -765,7 +766,7 @@
 
 | 编号 | 需求 | 判据 | 依据文件 |
 |---|---|---|---|
-| NFR-12 | 收资清单按场裁剪：以通用收资模板为底，按本场的机型、数据源形态与专题范围裁剪，逐条写明必须、建议、可选或可替代以及「不收会怎样」 | 每一族都有必须性分级与缺件后果且可复核；换场时清单随场定义与机型变化，不是照抄样本场 | 《数据要求说明_观澜_2.21.0.docx》第 8 章与第 12 章；docs/输入数据放置指导_v0.1.md |
+| NFR-12 | 收资清单按场裁剪：以通用收资模板为底，按本场的机型、数据源形态与专题范围裁剪，逐条写明必须、建议、可选或可替代以及「不收会怎样」 | 每一族都有必须性分级与缺件后果且可复核；换场时清单随场定义与机型变化，不是照抄样本场 | 《数据要求说明_观澜_2.21.1.docx》第 8 章与第 12 章；docs/输入数据放置指导_v0.1.md |
 
 ### 11.9 换场验收需求
 
@@ -908,8 +909,8 @@
 | 场定义与机型与物理约束参数的写法样例 | app_ETL/configs/farms/<场>.yaml |
 | 机型—场站数据契约与字段单位真源 | app_ETL/configs/contracts/<机型>_<场>.yaml 与 app_ETL/configs/canonical/dictionary.yaml |
 | 场级字段语义登记与其它厂商导出形态的对齐 | app_ETL/configs/farms/<场>/field_semantic_registry.yaml |
-| 按场裁剪的收资清单与必须性分级 | docs/src/数据要求说明_观澜_2.21.0.md |
-| 场无关引擎与场相关参数的分层与换场作业单 | docs/src/系统设计说明_观澜_2.21.0.md |
+| 按场裁剪的收资清单与必须性分级 | docs/src/数据要求说明_观澜_2.21.1.md |
+| 场无关引擎与场相关参数的分层与换场作业单 | docs/src/系统设计说明_观澜_2.21.1.md |
 
 表中 `<场>`、`<场站>`、`<机型>` 为占位符，按实际风电场替换。
 
@@ -952,4 +953,4 @@
 | 换场 | — | 从一场切到另一场运行的整套动作：改配置、放数据、重跑、按检查表复验 | 本文 §11.9 |
 | 缺族降级 | — | 某族数据缺失时按缺件如实标注并降低该族功能，不造数、不用他场数字顶替 | 本文 FR-49 |
 | 按场标定 | — | 把阈值、时间窗锚点、限电窗、温度档带宽等场相关参数按本场取值 | 本文 FR-50 |
-| 通用收资模板 | — | 与场无关的收资条目底稿，按场裁剪后作为现场收资清单 | docs/src/数据要求说明_观澜_2.21.0.md |
+| 通用收资模板 | — | 与场无关的收资条目底稿，按场裁剪后作为现场收资清单 | docs/src/数据要求说明_观澜_2.21.1.md |

release/web/assets/index-BX3YsC-q.css → release/web/assets/index-iFLOxPfX.css

@@ -1 +1 @@
-.echart[data-v-999bee15]{width:100%}.wb-tabs[data-v-8bbd46d4]{display:flex;flex-wrap:wrap;gap:6px;padding:10px 18px 0}.wb-tabs button[data-v-8bbd46d4]{padding:6px 12px;border:1px solid var(--line);background:#fff;border-radius:4px 4px 0 0;cursor:pointer;color:var(--ink)}.wb-tabs button.on[data-v-8bbd46d4]{background:var(--brand);border-color:var(--brand);color:#fff}.todo[data-v-8bbd46d4]{font-size:10px;color:var(--muted);margin-left:2px}.wb-tabs button.on .todo[data-v-8bbd46d4]{color:#ffe9a8}.page-head[data-v-8bbd46d4]{display:flex;align-items:baseline;gap:12px;padding:10px 18px 0}.page-head h1[data-v-8bbd46d4]{font-size:18px;margin:0}.window-badge[data-v-8bbd46d4]{color:var(--muted);font-size:12.5px}:root{--ink: #16202c;--muted: #6b7a8d;--line: #d7dee8;--bg: #f5f7fa;--card: #ffffff;--brand: #0b5fa5;--bad: #b42318}*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--ink);font:14px/1.6 Microsoft YaHei,PingFang SC,system-ui,sans-serif}.top{display:flex;align-items:center;justify-content:space-between;padding:10px 18px;background:var(--brand);color:#fff}.top .brand{font-size:16px;font-weight:600;letter-spacing:.5px}.top nav button{margin-left:8px;padding:6px 12px;border:1px solid rgba(255,255,255,.5);background:transparent;color:#fff;border-radius:4px;cursor:pointer}.top nav button.on{background:#fff;color:var(--brand)}main{padding:16px 18px 40px}.card{background:var(--card);border:1px solid var(--line);border-radius:6px;padding:14px 16px;margin-bottom:14px}.card h2{margin:0 0 10px;font-size:15px}.card h2 small{color:var(--muted);font-weight:400}.hint{color:var(--muted);font-size:12.5px}table{width:100%;border-collapse:collapse;font-size:13px}th,td{border-bottom:1px solid var(--line);padding:6px 8px;text-align:left}th{background:#eef2f7;font-weight:600}tr.bad td{color:var(--bad)}code{font-family:Consolas,Courier New,monospace;font-size:12.5px}button.re{margin-left:10px;padding:2px 10px;cursor:pointer}ul{margin:6px 0 0 18px;padding:0}
+.echart[data-v-999bee15]{width:100%}.wb-tabs[data-v-d9042022]{display:flex;flex-wrap:wrap;gap:6px;padding:10px 18px 0}.wb-tabs button[data-v-d9042022]{padding:6px 12px;border:1px solid var(--line);background:#fff;border-radius:4px 4px 0 0;cursor:pointer;color:var(--ink)}.wb-tabs button.on[data-v-d9042022]{background:var(--brand);border-color:var(--brand);color:#fff}.todo[data-v-d9042022]{font-size:10px;color:var(--muted);margin-left:2px}.wb-tabs button.on .todo[data-v-d9042022]{color:#ffe9a8}.page-head[data-v-d9042022]{display:flex;align-items:baseline;gap:12px;padding:10px 18px 0}.page-head h1[data-v-d9042022]{font-size:18px;margin:0}.window-badge[data-v-d9042022]{color:var(--muted);font-size:12.5px}:root{--ink: #16202c;--muted: #6b7a8d;--line: #d7dee8;--bg: #f5f7fa;--card: #ffffff;--brand: #0b5fa5;--bad: #b42318}*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--ink);font:14px/1.6 Microsoft YaHei,PingFang SC,system-ui,sans-serif}.top{display:flex;align-items:center;justify-content:space-between;padding:10px 18px;background:var(--brand);color:#fff}.top .brand{font-size:16px;font-weight:600;letter-spacing:.5px}.top nav button{margin-left:8px;padding:6px 12px;border:1px solid rgba(255,255,255,.5);background:transparent;color:#fff;border-radius:4px;cursor:pointer}.top nav button.on{background:#fff;color:var(--brand)}main{padding:16px 18px 40px}.card{background:var(--card);border:1px solid var(--line);border-radius:6px;padding:14px 16px;margin-bottom:14px}.card h2{margin:0 0 10px;font-size:15px}.card h2 small{color:var(--muted);font-weight:400}.hint{color:var(--muted);font-size:12.5px}table{width:100%;border-collapse:collapse;font-size:13px}th,td{border-bottom:1px solid var(--line);padding:6px 8px;text-align:left}th{background:#eef2f7;font-weight:600}tr.bad td{color:var(--bad)}code{font-family:Consolas,Courier New,monospace;font-size:12.5px}button.re{margin-left:10px;padding:2px 10px;cursor:pointer}ul{margin:6px 0 0 18px;padding:0}

release/web/index.html

@@ -4,8 +4,8 @@
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1" />
   <title>观澜 · 风电数据分析与决策支持</title>
-  <script type="module" crossorigin src="./assets/index-CtmIzabH.js"></script>
-  <link rel="stylesheet" crossorigin href="./assets/index-BX3YsC-q.css">
+  <script type="module" crossorigin src="./assets/index-BEehXXEQ.js"></script>
+  <link rel="stylesheet" crossorigin href="./assets/index-iFLOxPfX.css">
 </head>
 <body>
   <div id="app"></div>