2.89.3 P1: 窗数口径与单窗拒判明文化 —— vib_confidence 文档修正 P0 后过时口径(A轴/D轴) + 新增小节; fusion.py 增 WINDOW_CLAUSE 常量并在 fusion_table 消费处拼入 纪律/盲区(经 fleet_views:581 上页面); 六层链文档增「窗数口径与拒判条件」节; 审计清单记 P1. 验证: 本地实跑 fusion_table 含条款, 线上 /api/fleet 纪律含条款 true/盲区含条款 true. 实逮: 首版补丁因 CRLF 匹配失败, 改逐行替换

VERSION

@@ -1 +1 @@
-2.89.2
+2.89.3

app_algorithmModel/app_algorithmModel_guanlan/subsys/fusion.py

@@ -16,6 +16,14 @@ import json, pathlib, re
 import pandas as pd
 from src.windscada.config import farm
 
+# ── ★P1（用户令 2026-10-06）：窗数口径与单窗拒判 —— 明文条款随 fus.纪律/fus.盲区 下发页面 ──
+# 依据：P0 已把持续性门/覆盖门分母改为 max(4, ceil(2N/3))；本常量把「口径 + 拒判」显式化（防名实误读）。
+WINDOW_CLAUSE = (
+    '窗数口径(2026-10-06 P1): 持续性/覆盖门的分母 = max(4, ceil(2N/3))（N≤6 恒 4 · N=9 ⇒ 6 · 分母只增不减）; '
+    'N<3 时不得用持续性与逐窗趋势类判据出个体结论（只能标"窗内周段趋势（单窗补充口径, 仅参考不作判据）"）; '
+    '不得静默丢窗（谱窗与仅标量/原厂状态窗分列, 缺窗显式进盲区）'
+)
+
 _DATA_ROOT = pathlib.Path(__file__).resolve().parents[3]
 HANDOFF = P.m5() / 'handoff_vibration_v2.json'
 
@@ -207,8 +215,8 @@ def fusion_table(cfg=None, all_turbines=False):
         handoff版本=_hver, handoff日期=_asof, 证据窗末=_win_end,
         振动窗=f'至{_win_end[:7]} (证据包出件 {_asof})',
         SCADA窗='至2026-07-07', 油样窗='SGS 2024-11~2025-08 (404份/38台) + 华标2026-07 (102份/17台)',
-        纪律=h['meta']['reading_discipline'],
-        盲区=h['detectability_prior']['known_blind_spots'],
+        纪律=(str(h['meta'].get('reading_discipline') or '') + ' ｜ ' + WINDOW_CLAUSE),
+        盲区=(list(h['detectability_prior'].get('known_blind_spots') or []) + [WINDOW_CLAUSE]),
         open_items=h.get('open_items', []),
     )
     return pd.DataFrame(rows), meta

app_common/app_common_guanlan/version.py

@@ -24,7 +24,7 @@ import json
 import pathlib
 
 NAME = '观澜·如东样板 v2'
-VERSION = '2.89.2'         # ★ 版本只改这里
+VERSION = '2.89.3'         # ★ 版本只改这里
 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.89.3', date='2026-10-06', level='patch',
+         title='P1：窗数口径与单窗拒判升格为明文条款（代码 + 文档 + 随 fus.纪律/盲区 传导到页面）',
+         note='用户令：执行 P1。**落地四处**：① `app_ontology/app_ontology_guanlan/sop/vib_confidence.py` 模块文档 —— 修正 P0 后**已过时**的两处口径行（A 轴「持续≥4/6窗」、D 轴「覆盖窗数≥4」⇒ 均改为 `max(4, ceil(2N/3))`），并在模块头新增「窗数口径与单窗拒判」小节；② `app_algorithmModel/app_algorithmModel_guanlan/subsys/fusion.py` —— 新增模块常量 `WINDOW_CLAUSE`，并在 `fusion_table()` 的**消费处**把条款拼进 `纪律` 与 `盲区`（该处原为 `h["meta"]["reading_discipline"]` 与 `h["detectability_prior"]["known_blind_spots"]`）⇒ 经 `service/fleet_views.py:581` 进入页面 `fus.纪律`/`fus.盲区`；③ `docs/振动六层链_接口规格与缺口_v0.1.md` 新增「窗数口径与拒判条件」节（门的形式、单窗拒判、不得静默丢窗、当前实况 1 窗、四处出处 file:line）；④ `docs/主张审计清单_v0.1.md` 增记 P1 执行结果。**条款要点**：① 持续性/覆盖门分母 = `max(4, ceil(2N/3))`（N≤6 恒 4 · N=9 ⇒ 6 · 分母只增不减 ⇒ 任何窗数都不更宽松）；② **N<3 时不得**用「持续性」「逐窗趋势」类判据出个体结论，只能标「窗内周段趋势（单窗补充口径，仅参考不作判据）」（与 `app_ETL/.../component_history_build.py` 既有降级口径同源）；③ **不得静默丢窗**（谱窗与仅标量/原厂状态窗分列，缺窗显式进盲区）。**验证**：本地实跑 `fusion_table()` ⇒ 107 行 · `纪律` 含条款 ✓ · `盲区` 含条款 ✓（5 项）；远端部署后重启算法服务，线上 `/api/fleet` ⇒ 200 · `纪律含条款 true` · `盲区含条款 true` · `盲区项数 5` ✓（条款已上页面）。**过程实逮**：首版补丁因 **CRLF 行尾**导致多行匹配失败（0 处改动）⇒ 改为逐行替换后成功。'),
     dict(version='2.89.2', date='2026-10-06', level='patch',
          title='P0：持续性门/覆盖门改为 max(4, ceil(2N/3))（N≤3 更严 · N=4~6 逐位一致 · N>6 自动升级）',
          note='用户令：执行 P0（backlog 第 1 项建议）。实现位置 `app_ontology/app_ontology_guanlan/sop/vib_confidence.py`：① `score_internal` 持续性分母由硬编码 `max(min(4, n_windows), 1)` 改为 **`max(4, ceil(2*n_windows/3))`**；② `score_sample` **新增 `n_windows=6` 形参**（向后兼容），窗覆盖分母由 `4.0` 改为同一公式。已补 `import math`。**验证（函数级对照，旧实现逐字复刻 · 含同样的 `round(raw,1)`）**：`N=4/5/6` ⇒ 两个分量**逐位一致（0 处差异）** ✓；`N=7/8` ⇒ 分母 5/6（升级）；**`N=9` ⇒ 分母 6**（旧恒为 4）✓；`N=1/2/3` ⇒ 分母 4 ⇒ **更严**（旧口径下 `min(4,nw)` 意味着"1 窗即满分持续性"，新口径要求 4 窗）✓。**关键安全性质**：分母只增不减 ⇒ **任何情形都不会比旧口径更宽松** ✓。**过程实逮（重要，如实记录）**：最初的实现用纯 `ceil(2N/3)` ✗，实测在 **N<6 时反而放宽** —— 例如 `N=1` 时窗覆盖满分只需 1 窗（旧需 4 窗），最大差 **7.5 分** ✗，与上游报告"覆盖与缺测传播·部分覆盖被埋进健康"的告诫**相反** ✗；故改为带 **4 下限** 的 `max(4, ceil(2N/3))`，既消除该放宽、又保留 N>6 的自动升级。**实际影响**：当前实况为 **1 窗**且这两个评分函数**全仓无调用点**（函数存在 ≠ 生产链使用），故线上产物**零变化** ✓；本次改动为"扩窗到 7~9 窗时的口径预置"。'),

app_ontology/app_ontology_guanlan/sop/vib_confidence.py

@@ -8,15 +8,20 @@
 
 | 轴 | 问的问题 | 满分条件 |
 |---|---|---|
-| A 内部证据强度 | 算法自身闸过得多硬 | 五闸全过 + 绝对锚达标 (占比≥1%∧≥10×p90) + 持续≥4/6窗 |
+| A 内部证据强度 | 算法自身闸过得多硬 | 五闸全过 + 绝对锚达标 (占比≥1%∧≥10×p90) + 持续窗数 ≥ `max(4, ceil(2N/3))`（N≤6 恒 4；N=9 ⇒ 6，见下方「窗数口径」） |
 | B 独立源共时确认 | **同窗** 有无非振动源同向 | 油液/工单/告警/温度 ≥2 类独立源共时同向 |
 | C 实物锚 | 有无拆检/内窥实证 | physical_in_window (窗内实物) |
-| D 样本充分性 | 数据够不够说话 | 有效样本 ≥30 且 覆盖窗数 ≥4 且非盲区 |
+| D 样本充分性 | 数据够不够说话 | 有效样本 ≥30 且 覆盖窗数 ≥ `max(4, ceil(2N/3))` 且非盲区 |
 | E 反证搜索 | 有没有认真找过反例 | 已跑 fleet 基率 + 共模/固有线核 + 替代解释检验且全部未推翻 |
 
 **扣分项 (硬扣, 不与加分相抵)**: 时窗错配 (证据窗 ≠ claim 窗) −15; 单源多统计量冒充多源 −20;
 量测域跨越 (包络当原始/相对当绝对) −20; 盲区台却给个体结论 −25。
 
+## 窗数口径与单窗拒判 (2026-10-06 P1 明文; 门的形式见 `score_internal`/`score_sample`)
+**窗数口径（2026-10-06 P1 明文）**：持续性门与窗覆盖门的分母 = `max(4, ceil(2N/3))`（N=窗数）：N≤6 恒为 4（与历史口径逐位一致）；N=7/8 ⇒ 5/6；**N=9 ⇒ 6**。分母只增不减，故**任何窗数下都不会比历史口径更宽松**。
+**单窗/少窗拒判（硬条款）**：N<3 时**不得**用「持续性」「逐窗趋势」类判据出个体结论；此类信号只能标注为「**窗内周段趋势（单窗补充口径，仅参考不作判据）**」（与 `app_ETL/.../component_history_build.py` 的既有降级口径同源）。
+**不得静默丢窗**：谱窗与"仅标量/原厂状态"窗在 pipeline 中**分列**呈现，缺窗必须显式进入盲区，不得被埋进健康结论。
+
 ## 时窗纪律 (本场实测约束, 2026-08-26 盘点)
 - 振动现役窗: 2026-07-07 → 08-11 (w0127 孤窗 2026-01)
 - 工单: 2021-01 → **2024-11** (距振动窗 ~20 个月)

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

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

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

@@ -1,4 +1,4 @@
-# 系统设计说明 · 观澜 v2 风电场智能分析系统 · 版本 2.89.2
+# 系统设计说明 · 观澜 v2 风电场智能分析系统 · 版本 2.89.3
 
 ## 1 文档说明
 
@@ -6,19 +6,19 @@
 
 ### 1.1 目的与范围
 
-本文是"观澜 v2（风电场智能分析系统）"（海上风电场智能分析离线系统）的设计说明（下称"本系统"），面向版本 2.89.2；内容以样本风电场（下称"本场"）为依据，样本场实测日期为 2026-09-22，说明本系统"由哪些部分组成、各部分怎么实现、数据从哪来到哪去、判据写在哪里、怎么验证、边界在哪里"。
+本文是"观澜 v2（风电场智能分析系统）"（海上风电场智能分析离线系统）的设计说明（下称"本系统"），面向版本 2.89.3；内容以样本风电场（下称"本场"）为依据，样本场实测日期为 2026-09-22，说明本系统"由哪些部分组成、各部分怎么实现、数据从哪来到哪去、判据写在哪里、怎么验证、边界在哪里"。
 
 本文覆盖十五个设计面：总体架构与分层、目录结构与路径真源、数据接入与重算链、判级与算法、时间窗口径、服务与前端、本体与知识层、本机模型接入、运维控制台与重算编排、安装与服务化与版本管理、质量保证、安全与离线边界、可移植性与资源占用、多场适用性与换场迁移、已知边界与未实现。
 
-本文不重复需求条目本身（那是《需求分析_观澜_2.89.2.docx》的职责），也不重复操作步骤的逐步手册（那是 docs/重算操作手册_v0.1.md 与《使用说明书》v0.2（随包 docs/）的职责）；本文只回答"设计上为什么这样、落在哪个文件的哪一处、用什么机器守卫保证它不漂移"。
+本文不重复需求条目本身（那是《需求分析_观澜_2.89.3.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.89.2.docx》的对应关系
+### 1.3 与《需求分析_观澜_2.89.3.docx》的对应关系
 
-需求分析写"要什么、为谁、优先级与验收门"，设计说明写"怎么实现、落在哪、如何自证"。两文的章节对应关系如表 1-1 所示；与《数据要求说明_观澜_2.89.2.docx》的数据侧口径去向见 16.6 节。
+需求分析写"要什么、为谁、优先级与验收门"，设计说明写"怎么实现、落在哪、如何自证"。两文的章节对应关系如表 1-1 所示；与《数据要求说明_观澜_2.89.3.docx》的数据侧口径去向见 16.6 节。
 
 | 本文章节 | 需求分析对应章 | 对应关系说明 |
 |---|---|---|
@@ -41,7 +41,7 @@
 
 ### 1.4 口径与依据
 
-本文所有数字来自仓库文件或命令的实跑输出，不采用估算与推测；查不到、未实现的，一律写"未取证"或"未实现"，并在第 17 章汇总。本文中"本次实测"与各表"实测"列一律指样本场实测（2026-09-22）：即在样本风电场的一套实例上的一次实跑，换场后这些数字会变、方法与口径不变。版本号的唯一真源是 src/version.py 的 VERSION 常量，本版为 2.89.2；打包文件名由 src/version.py 的 package_name() 给出，为 app_guanlang_v2.89.2.zip。
+本文所有数字来自仓库文件或命令的实跑输出，不采用估算与推测；查不到、未实现的，一律写"未取证"或"未实现"，并在第 17 章汇总。本文中"本次实测"与各表"实测"列一律指样本场实测（2026-09-22）：即在样本风电场的一套实例上的一次实跑，换场后这些数字会变、方法与口径不变。版本号的唯一真源是 src/version.py 的 VERSION 常量，本版为 2.89.3；打包文件名由 src/version.py 的 package_name() 给出，为 app_guanlang_v2.89.3.zip。
 
 本文遵循四条写作口径：含"窗"且确实指时间窗口的，一律写全"时间窗"（天气窗、作业窗、预览窗、观测窗属领域词，保持原样）；影响的是风电机组时写"影响机组"或"影响机组数"；使用英文简写时必须写成"中文（英文简写）"形式，如平均无故障间隔（MTBF）、平均停机间隔（MTBO）、单次停机时长（MDT）；全文用简体中文与半角数字与单位。
 
@@ -863,7 +863,7 @@ Windows 安装入口是 install.bat 与 install.ps1，步骤号写死在输出
 
 ### 12.3 安装记录与版本三守卫
 
-安装记录 install-info.json 是"这台机器装的是哪一版"的唯一凭据，字段如表 12-3 所示。装完写、卸载时删（删掉等于这台机器回到"没装过"）。需要如实指出：本机该文件记录的版本是 2.5.0（装于 2026-09-17），落后于当前代码版本 2.89.2，因此它正是"安装前检查会提示版本差异"的活样本；重装或升级后会随之更新。
+安装记录 install-info.json 是"这台机器装的是哪一版"的唯一凭据，字段如表 12-3 所示。装完写、卸载时删（删掉等于这台机器回到"没装过"）。需要如实指出：本机该文件记录的版本是 2.5.0（装于 2026-09-17），落后于当前代码版本 2.89.3，因此它正是"安装前检查会提示版本差异"的活样本；重装或升级后会随之更新。
 
 | 字段 | 含义 |
 |---|---|
@@ -1030,7 +1030,7 @@ Windows 安装入口是 install.bat 与 install.ps1，步骤号写死在输出
 
 ### 15.2 Python 与依赖 wheel
 
-解释器要求是 3.11 及以上（依赖 pandas 3，3.10 及以下没有轮子）；机器上没有 3.11 时使用包内便携运行时（3.12.14，三个平台各一份）。依赖清单共 164 条固定版本：polars 1.42.0、pandas 3.0.3、pyarrow 24.0.0、numpy 2.5.0、pyyaml 6.0.3、python-frontmatter 1.3.0、matplotlib 3.11.0、plotly 6.8.0、jinja2 3.1.6、python-docx 1.2.0、docxtpl 0.20.2、python-dotenv 1.2.2、requests 2.34.2、rich 15.0.0、tqdm 4.68.3、openpyxl 3.1.5、scipy 1.18.0、xlrd 2.0.2，另有一条不锁版本的 tzdata（Windows 无系统时区库，而 pandas 3 硬依赖它）。离线件如表 15-2 所示（件数与体积为本次实测）。
+解释器要求是 3.11 及以上（依赖 pandas 3，3.10 及以下没有轮子）；机器上没有 3.11 时使用包内便携运行时（3.12.14，三个平台各一份）。依赖清单共 165 条固定版本：polars 1.42.0、pandas 3.0.3、pyarrow 24.0.0、numpy 2.5.0、pyyaml 6.0.3、python-frontmatter 1.3.0、matplotlib 3.11.0、plotly 6.8.0、jinja2 3.1.6、python-docx 1.2.0、docxtpl 0.20.2、python-dotenv 1.2.2、requests 2.34.2、rich 15.0.0、tqdm 4.68.3、openpyxl 3.1.5、scipy 1.18.0、xlrd 2.0.2，另有一条不锁版本的 tzdata（Windows 无系统时区库，而 pandas 3 硬依赖它）。离线件如表 15-2 所示（件数与体积为本次实测）。
 
 | 离线件目录 | 件数（实测） | 体积（实测） | 覆盖平台 |
 |---|---|---|---|
@@ -1224,7 +1224,7 @@ Linux 侧的适配程度如表 15-4 所示，全部为"已有实现但在本次
 
 ### 16.6 与同批交付文档的对应关系
 
-本章对应《需求分析_观澜_2.89.2.docx》第 11 章（场配置化、机组与机型可替换、数据源形态可适配、阈值按场标定、术语与单位可配、跨场统一口径、按场裁剪收资、换场验收检查表）与《数据要求说明_观澜_2.89.2.docx》第 12 章（通用必选与可选的判定规则、场配置字段对照、数据源形态适配、换场收资差异清单、按场裁剪步骤）；本章给的是设计侧的落点、换场作业单与检查表，数据侧的收资口径与字段要求以数据要求说明为准，需求侧的验收项以需求分析为准。
+本章对应《需求分析_观澜_2.89.3.docx》第 11 章（场配置化、机组与机型可替换、数据源形态可适配、阈值按场标定、术语与单位可配、跨场统一口径、按场裁剪收资、换场验收检查表）与《数据要求说明_观澜_2.89.3.docx》第 12 章（通用必选与可选的判定规则、场配置字段对照、数据源形态适配、换场收资差异清单、按场裁剪步骤）；本章给的是设计侧的落点、换场作业单与检查表，数据侧的收资口径与字段要求以数据要求说明为准，需求侧的验收项以需求分析为准。
 
 ***
 
@@ -1290,7 +1290,7 @@ Linux 侧的适配程度如表 15-4 所示，全部为"已有实现但在本次
 
 | 章节 | 来源文件 |
 |---|---|
-| 1 文档说明 | src/version.py（VERSION 与 HISTORY 的 2.59.0 条目）、docs/需求分析_观澜_2.89.2.docx、scripts/delivery_docs_figures.py |
+| 1 文档说明 | src/version.py（VERSION 与 HISTORY 的 2.59.0 条目）、docs/需求分析_观澜_2.89.3.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.89.2.md → docs/src/需求分析_观澜_2.89.3.md

@@ -1,4 +1,4 @@
-# 需求分析 · 观澜 v2 风电场智能分析系统 · 版本 2.89.2
+# 需求分析 · 观澜 v2 风电场智能分析系统 · 版本 2.89.3
 
 ## 1 文档说明
 
@@ -6,7 +6,7 @@
 
 ### 1.1 目的
 
-本文是「观澜 v2（风电场智能分析系统）」的**需求分析文档**，回答四个问题：这套系统究竟要满足谁的什么需要；这些需要从哪来、经过哪些版本变成现在的样子；每一条需要对应什么功能、什么输入、什么输出、拿什么判据验收；以及哪些事本版明确不做。本文与同批交付的《系统设计说明_观澜_2.89.2.docx》《数据要求说明_观澜_2.89.2.docx》配套：本文讲「要什么、凭什么算做到了」，设计说明讲「怎么做的」，数据要求说明讲「要哪些数据、什么形态、什么单位」。
+本文是「观澜 v2（风电场智能分析系统）」的**需求分析文档**，回答四个问题：这套系统究竟要满足谁的什么需要；这些需要从哪来、经过哪些版本变成现在的样子；每一条需要对应什么功能、什么输入、什么输出、拿什么判据验收；以及哪些事本版明确不做。本文与同批交付的《系统设计说明_观澜_2.89.3.docx》《数据要求说明_观澜_2.89.3.docx》配套：本文讲「要什么、凭什么算做到了」，设计说明讲「怎么做的」，数据要求说明讲「要哪些数据、什么形态、什么单位」。
 
 本文的写作口径是**只写能取证的事实**：每个数字、每条结论都能指到仓库里的某个文件、某次实跑输出或某条版本记录；查不到、取不到的一律写明「未取证」或「未到位」，不做推测性补全。因此文中会出现少量「未取证」的说明句，那是刻意留下的诚实边界，不是遗漏。
 
@@ -18,15 +18,15 @@
 
 ### 1.3 版本对应关系
 
-系统版本号只有一个真源：仓库内的 src/version.py 的 VERSION 一行。本版 VERSION = 2.89.2，版本记录（HISTORY）共 162 条，人读的版本表由 scripts/version_log.py 从 HISTORY 生成到 docs/版本记录.md，并由 version_log.py --check 与 guanlan.py check 双重校验「记录表与代码一致」。
+系统版本号只有一个真源：仓库内的 src/version.py 的 VERSION 一行。本版 VERSION = 2.89.3，版本记录（HISTORY）共 163 条，人读的版本表由 scripts/version_log.py 从 HISTORY 生成到 docs/版本记录.md，并由 version_log.py --check 与 guanlan.py check 双重校验「记录表与代码一致」。
 
 表 1-1 版本与文档的对应关系
 
 | 项 | 值 | 取证方式 |
 |---|---|---|
-| 系统版本 | 2.89.2 | src/version.py 的 VERSION；guanlan.py check 实跑报「版本管理: 观澜 v2（风电场智能分析系统） v2.89.2」 |
-| 交付包名 | app_guanlang_v2.89.2.zip | src/version.py 的 package_name()；同一条 check 输出 |
-| 本文版本 | 2.89.2（与系统版本同号） | 本文标题与 src/version.py 的 VERSION |
+| 系统版本 | 2.89.3 | src/version.py 的 VERSION；guanlan.py check 实跑报「版本管理: 观澜 v2（风电场智能分析系统） v2.89.3」 |
+| 交付包名 | app_guanlang_v2.89.3.zip | src/version.py 的 package_name()；同一条 check 输出 |
+| 本文版本 | 2.89.3（与系统版本同号） | 本文标题与 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() |
@@ -46,7 +46,7 @@
 | 只读审计 | scripts/pages_audit.py --check（2026-09-22） | 检查 21 项，不一致 0，已知缺口 19，退出码 0 |
 | 只读计划 | scripts/rebuild_all.py --dry-run（2026-09-22） | 默认 26 步；加 --skip-scada 为 23 步 |
 | 实测计数 | data/raw/<场站> 与 outputs/<场> 递归计数（2026-09-22） | 输入 26,504 件 / 224.67 GB；产物 3,549 件 / 7,157.5 MB |
-| 读源 | src/version.py、configs/portal_pages.yaml、configs/serve.json、guanlan.py、scripts/rebuild_all.py | 13 条版本史；25 条顶层页面条目（含 7 条子页共 164 条）；6 个服务端口 |
+| 读源 | src/version.py、configs/portal_pages.yaml、configs/serve.json、guanlan.py、scripts/rebuild_all.py | 13 条版本史；25 条顶层页面条目（含 7 条子页共 165 条）；6 个服务端口 |
 | 读文档 | docs/系统设计说明.md（56 个标题）、docs/说明书_观澜…v0.2.md、docs/输入数据放置指导_v0.1.md、docs/数据目录结构与落位约定_v0.2.md、docs/重算操作手册_v0.1.md、docs/页面输出体检_v0.1.md、README_先读我.MD | 逐章依据见附录 A |
 
 ### 1.5 术语与描述口径约定
@@ -119,10 +119,11 @@
 
 ### 3.2 需求演进时间轴
 
-表 3-1 版本史与用户令要点（依据 src/version.py 的 HISTORY，共 162 条）
+表 3-1 版本史与用户令要点（依据 src/version.py 的 HISTORY，共 163 条）
 
 | 版本 | 日期 | 用户令要点 | 变化级别 |
 |---|---|---|---|
+| 2.89.3 | 2026-10-06 | P1：窗数口径与单窗拒判升格为明文条款 | 小（patch） |
 | 2.89.2 | 2026-10-06 | P0：持续性门/覆盖门改为 max(4, ceil(2N/3)) | 小（patch） |
 | 2.89.1 | 2026-10-06 | backlog 第 1 项定位：观澜持续性门/覆盖门与窗数口径 | 小（patch） |
 | 2.89.0 | 2026-10-06 | 主张审计清单 v0.1＋修 B02 陈旧文案 | 中（minor） |
@@ -286,7 +287,7 @@
 | 0.4.0 | 2026-09-17 | 打包默认不含输入数据与产物与日志与临时文件；无窗口启动；统一配置与日志；页面归口；服务化 | 旧编号（legacy） |
 | 0.2.0 | 2026-09-01 | 含产物的旧交付基线，历史上用作「包内无生成端」那批产物的补救源 | 旧编号（legacy） |
 
-需求的演进如图 1-1 所示。该图依据 src/version.py 的 HISTORY 绘制，覆盖上表 162 条记录（即两级旧编号 0.4.0 与 0.2.0，以及从 2.5.0 起按规则递增的160个版本）。按级别统计，这160个版本里「中」级变化85条（2.89.0、2.88.0、2.87.0、2.86.0、2.85.0、2.84.0、2.83.0、2.82.0、2.81.0、2.80.0、2.79.0、2.78.0、2.77.0、2.76.0、2.75.0、2.74.0、2.73.0、2.72.0、2.71.0、2.70.0、2.69.0、2.68.0、2.67.0、2.66.0、2.65.0、2.64.0、2.63.0、2.62.0、2.61.0、2.60.0、2.59.0、2.58.0、2.57.0、2.56.0、2.55.0、2.54.0、2.53.0、2.52.0、2.51.0、2.50.0、2.49.0、2.48.0、2.47.0、2.46.0、2.45.0、2.44.0、2.43.0、2.42.0、2.41.0、2.40.0、2.39.0、2.38.0、2.37.0、2.36.0、2.35.0、2.34.0、2.33.0、2.32.0、2.31.0、2.30.0、2.29.0、2.28.0、2.27.0、2.26.0、2.25.0、2.24.0、2.23.0、2.22.0、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），「小」级变化75条（2.89.2、2.89.1、2.88.1、2.85.2、2.85.1、2.84.1、2.83.3、2.83.2、2.83.1、2.82.2、2.82.1、2.81.7、2.81.6、2.81.5、2.81.4、2.81.3、2.81.2、2.81.1、2.80.2、2.80.1、2.79.1、2.78.4、2.78.3、2.78.2、2.78.1、2.76.1、2.75.1、2.66.1、2.63.1、2.62.1、2.60.1、2.57.2、2.57.1、2.56.1、2.54.1、2.53.2、2.53.1、2.52.1、2.51.1、2.47.1、2.42.1、2.40.1、2.36.2、2.36.1、2.30.1、2.29.1、2.28.1、2.24.2、2.24.1、2.23.3、2.23.2、2.23.1、2.22.1、2.21.2、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 绘制，覆盖上表 163 条记录（即两级旧编号 0.4.0 与 0.2.0，以及从 2.5.0 起按规则递增的161个版本）。按级别统计，这161个版本里「中」级变化85条（2.89.0、2.88.0、2.87.0、2.86.0、2.85.0、2.84.0、2.83.0、2.82.0、2.81.0、2.80.0、2.79.0、2.78.0、2.77.0、2.76.0、2.75.0、2.74.0、2.73.0、2.72.0、2.71.0、2.70.0、2.69.0、2.68.0、2.67.0、2.66.0、2.65.0、2.64.0、2.63.0、2.62.0、2.61.0、2.60.0、2.59.0、2.58.0、2.57.0、2.56.0、2.55.0、2.54.0、2.53.0、2.52.0、2.51.0、2.50.0、2.49.0、2.48.0、2.47.0、2.46.0、2.45.0、2.44.0、2.43.0、2.42.0、2.41.0、2.40.0、2.39.0、2.38.0、2.37.0、2.36.0、2.35.0、2.34.0、2.33.0、2.32.0、2.31.0、2.30.0、2.29.0、2.28.0、2.27.0、2.26.0、2.25.0、2.24.0、2.23.0、2.22.0、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），「小」级变化76条（2.89.3、2.89.2、2.89.1、2.88.1、2.85.2、2.85.1、2.84.1、2.83.3、2.83.2、2.83.1、2.82.2、2.82.1、2.81.7、2.81.6、2.81.5、2.81.4、2.81.3、2.81.2、2.81.1、2.80.2、2.80.1、2.79.1、2.78.4、2.78.3、2.78.2、2.78.1、2.76.1、2.75.1、2.66.1、2.63.1、2.62.1、2.60.1、2.57.2、2.57.1、2.56.1、2.54.1、2.53.2、2.53.1、2.52.1、2.51.1、2.47.1、2.42.1、2.40.1、2.36.2、2.36.1、2.30.1、2.29.1、2.28.1、2.24.2、2.24.1、2.23.3、2.23.2、2.23.1、2.22.1、2.21.2、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)
 
@@ -305,7 +306,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.89.2」 |
+| 装成服务并在安装时检查版本 | win_service.py 以 ctypes 直连 SCM；service_main.py 与 systemd 单元；install-info.json 记录版本并比对 | check 实跑报「卸载入口在位 2 个」「版本管理 v2.89.3」 |
 | 观澜改为监听所有 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 条目；本版三份文档 |
@@ -352,7 +353,7 @@
 
 ### 5.1 功能需求编号与总览
 
-功能需求按十二个域组织，编号从 FR-01 到 FR-52，共 164 条。编号是**稳定的**：新增需求往后排号，不重排已有编号；需求作废时保留编号并标注作废，不改用它。每条需求都给出五项：需求描述、输入、输出、验收判据、依据文件。其中「验收判据」是可判定的条件，「依据文件」指向仓库内的源或文档，便于复核。
+功能需求按十二个域组织，编号从 FR-01 到 FR-52，共 165 条。编号是**稳定的**：新增需求往后排号，不重排已有编号；需求作废时保留编号并标注作废，不改用它。每条需求都给出五项：需求描述、输入、输出、验收判据、依据文件。其中「验收判据」是可判定的条件，「依据文件」指向仓库内的源或文档，便于复核。
 
 表 5-1 功能需求域与编号分配
 
@@ -499,7 +500,7 @@
 
 ### 6.1 非功能需求清单
 
-非功能需求编号 NFR-01 至 NFR-12，共 164 条。它们大多是「性质」而不是「功能」：判据往往是一次实跑的输出，或者一条机器守卫的退出码。
+非功能需求编号 NFR-01 至 NFR-12，共 165 条。它们大多是「性质」而不是「功能」：判据往往是一次实跑的输出，或者一条机器守卫的退出码。
 
 表 6-1 非功能需求（NFR-01 至 NFR-06，样本场实测（2026-09-22））
 
@@ -521,7 +522,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.89.2.docx》第 8 章与第 12 章 |
+| NFR-12 | 收资清单按场裁剪：以通用收资模板为底，按本场的机型与数据源形态与专题范围裁剪，逐条写明必须、建议、可选或可替代以及「不收会怎样」 | 每一族都有必须性分级与缺件后果且可复核；换场时清单随场定义与机型变化，不是照抄样本场 | 本文第 11 章；《数据要求说明_观澜_2.89.3.docx》第 8 章与第 12 章 |
 
 ### 6.2 性能与耗时实测
 
@@ -557,7 +558,7 @@
 
 | 真源 | 管什么 | 守卫与实跑结果 |
 |---|---|---|
-| src/version.py | 名称、版本、版本规则、版本史、包名 | 版本记录一致性检查；check 实跑报 v2.89.2 且记录表与代码一致 |
+| src/version.py | 名称、版本、版本规则、版本史、包名 | 版本记录一致性检查；check 实跑报 v2.89.3 且记录表与代码一致 |
 | src/paths.py | 一切路径解析的基准与助手 | 配置审计器检查不手拼路径；实跑无不一致 |
 | configs 目录与登记表 | 端口、模型档、场配置、页面归口、配置登记 | 配置审计实跑已知缺口与白名单 14 条、提示 7 条 |
 | src/logfile.py | 日志目录、命名、行格式、保留策略 | 日志审计实跑无不一致、提示 87 条 |
@@ -568,7 +569,7 @@
 
 ### 7.1 数据族与功能映射
 
-系统的数据需求可以概括成一句话：**七类现场源件加一类共享机理资料，喂出九个产物仓，页面只读产物**。每个源类目录名就是摄入接口，改名等于换接口。数据族与功能的对应关系如下表；逐类的字段、单位、必须性与质量要求见同批交付的《数据要求说明_观澜_2.89.2.docx》。
+系统的数据需求可以概括成一句话：**七类现场源件加一类共享机理资料，喂出九个产物仓，页面只读产物**。每个源类目录名就是摄入接口，改名等于换接口。数据族与功能的对应关系如下表；逐类的字段、单位、必须性与质量要求见同批交付的《数据要求说明_观澜_2.89.3.docx》。
 
 表 7-1 数据族到功能的映射（样本场实测（2026-09-22））
 
@@ -601,7 +602,7 @@
 
 ### 7.3 与数据要求说明的分工
 
-本文只回答「要哪些数据、这些数据支撑什么功能」。数据的字段级要求（核心测点的名称、单位、必须性、缺失替代、对齐规则、质量门与核对锚点）以及面向现场的收资清单，写在《数据要求说明_观澜_2.89.2.docx》里。该文档按用户令要求与现场收资文件逐条对照，并对现场收资层面的已知缺失逐条如实记录，例如测风塔数据为零交付、故障录波只有 4 台、振动侧 handoff 正本缺失由观澜自算件顶上、远端机器未安装本机模型等。
+本文只回答「要哪些数据、这些数据支撑什么功能」。数据的字段级要求（核心测点的名称、单位、必须性、缺失替代、对齐规则、质量门与核对锚点）以及面向现场的收资清单，写在《数据要求说明_观澜_2.89.3.docx》里。该文档按用户令要求与现场收资文件逐条对照，并对现场收资层面的已知缺失逐条如实记录，例如测风塔数据为零交付、故障录波只有 4 台、振动侧 handoff 正本缺失由观澜自算件顶上、远端机器未安装本机模型等。
 
 ## 8 页面与信息架构需求
 
@@ -621,7 +622,7 @@
 
 ### 8.2 门户页面归口表
 
-表 8-2 按登记表逐条列出页面与子页的归口结论。登记表顶层条目 25 条，含 7 条子页共 164 条；归口审计实跑输出为「检查 21 项：不一致 0、已知缺口 19」，其中 21 项是审计的**检查行数**（19 条为引用悬空或溯源缺失的已知缺口项，2 条为两个数据派生页面的溯源检查项，均一致），与登记表的条目数不是同一个口径，两者都不矛盾，此处一并写明以免混淆。
+表 8-2 按登记表逐条列出页面与子页的归口结论。登记表顶层条目 25 条，含 7 条子页共 165 条；归口审计实跑输出为「检查 21 项：不一致 0、已知缺口 19」，其中 21 项是审计的**检查行数**（19 条为引用悬空或溯源缺失的已知缺口项，2 条为两个数据派生页面的溯源检查项，均一致），与登记表的条目数不是同一个口径，两者都不矛盾，此处一并写明以免混淆。
 
 表 8-2 门户页面与子页归口表（25 条顶层条目加 7 条子页，样本场实测（2026-09-22））
 
@@ -683,14 +684,14 @@
 | 运行环境与依赖 | 10 | Python 版本不低于 3.11（实测 3.12.10）；九个第三方依赖逐个导入 | 全 OK |
 | 静态质量门 | 4 | 源码可编译 229 个文件；语言包 845 条成对；入口引用闭合 48 条；入口脚本编码守则 | 全 OK |
 | 子进程口径 | 3 | 捕获输出可用；无窗口启动输出进日志；无窗口位已设，标志位 0x8000200 | 全 OK |
-| 版本与卸载入口 | 2 | 版本管理与记录表一致（v2.89.2，包名 app_guanlang_v2.89.2.zip）；卸载入口两个都在位 | 全 OK |
+| 版本与卸载入口 | 2 | 版本管理与记录表一致（v2.89.3，包名 app_guanlang_v2.89.3.zip）；卸载入口两个都在位 | 全 OK |
 | 制品与台账审计 | 5 | 反向呼应 3,548 件成立；页面归口检查 21 项；配置统一；日志统一；输入数据放置体检 26,503 件结构合规 | 全 OK |
 | 产物与发布件在位 | 10 | 标准仓、本体对象库、findings、事实契约、门户、仿真合页服务与资料包、三维资产、仿真回放资产、治理清单交付件 | 全 OK |
 | 原始件目录 | 1 | 原始件目录存在（无数据时此项不影响页面） | 全 OK |
 | 模型闸 | 6 | 默认档探针 0.77 秒；四个模型档逐个在位；模型可用性正常并记录审计日志 | 全 OK |
 | 合计 | 41 | 另有 6 条端口状态行不计入判定 | 结论全绿，可 serve，退出码 0 |
 
-验收门的分类与数量如图 7-1 所示。该图与上表同源，都取自本次自检实跑的 41 条判定行；按上表的分类口径，环境与依赖一类共 164 条、静态质量门 4 条、子进程口径 3 条、版本与卸载入口 2 条、制品与台账审计 5 条、产物与发布件在位 10 条、原始件目录 1 条、模型闸 6 条。其中真正体现「这个系统有没有把口径管住」的是制品与台账审计那五条门与四条静态质量门。
+验收门的分类与数量如图 7-1 所示。该图与上表同源，都取自本次自检实跑的 41 条判定行；按上表的分类口径，环境与依赖一类共 165 条、静态质量门 4 条、子进程口径 3 条、版本与卸载入口 2 条、制品与台账审计 5 条、产物与发布件在位 10 条、原始件目录 1 条、模型闸 6 条。其中真正体现「这个系统有没有把口径管住」的是制品与台账审计那五条门与四条静态质量门。
 
 ![图 7-1 验收门分类与数量（依据 guanlan.py check 实跑输出）](figures/fig-req-04-验收门分类.png)
 
@@ -809,7 +810,7 @@
 
 本章有两个词要先定义。「本场」指**当前被选中的场**，由配置选定，不必然等于本文取数的样本风电场；「换场」指从一场切到另一场运行的整套动作（改配置、放数据、重跑、按检查表复验），不是把两场的数据混在一棵树里。本章沿用的占位符与附录 A 一致：」<场>「、」<场站>「、」<机型>「 按实际风电场替换。
 
-本章需求与《数据要求说明_观澜_2.89.2.docx》《系统设计说明_观澜_2.89.2.docx》配套使用：本章讲「换场要满足什么」，数据要求说明讲「要向新场收哪些数据、哪些可以裁剪」，《设计说明》讲「配置在哪一层生效、哪些参数属于场相关层」。
+本章需求与《数据要求说明_观澜_2.89.3.docx》《系统设计说明_观澜_2.89.3.docx》配套使用：本章讲「换场要满足什么」，数据要求说明讲「要向新场收哪些数据、哪些可以裁剪」，《设计说明》讲「配置在哪一层生效、哪些参数属于场相关层」。
 
 取证边界要如实写一句：FR-44 至 FR-51 与 NFR-12 有既有的场配置层、摄入层与场级字段语义登记作依据；FR-52 的跨场横向对比是本次新增的口径要求，其实跑记录与机器守卫随后续版本补齐——本文不谎称已经通过。
 
@@ -888,7 +889,7 @@
 
 | 编号 | 需求 | 判据 | 依据文件 |
 |---|---|---|---|
-| NFR-12 | 收资清单按场裁剪：以通用收资模板为底，按本场的机型、数据源形态与专题范围裁剪，逐条写明必须、建议、可选或可替代以及「不收会怎样」 | 每一族都有必须性分级与缺件后果且可复核；换场时清单随场定义与机型变化，不是照抄样本场 | 《数据要求说明_观澜_2.89.2.docx》第 8 章与第 12 章；docs/输入数据放置指导_v0.1.md |
+| NFR-12 | 收资清单按场裁剪：以通用收资模板为底，按本场的机型、数据源形态与专题范围裁剪，逐条写明必须、建议、可选或可替代以及「不收会怎样」 | 每一族都有必须性分级与缺件后果且可复核；换场时清单随场定义与机型变化，不是照抄样本场 | 《数据要求说明_观澜_2.89.3.docx》第 8 章与第 12 章；docs/输入数据放置指导_v0.1.md |
 
 ### 11.9 换场验收需求
 
@@ -1031,8 +1032,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.89.2.md |
-| 场无关引擎与场相关参数的分层与换场作业单 | docs/src/系统设计说明_观澜_2.89.2.md |
+| 按场裁剪的收资清单与必须性分级 | docs/src/数据要求说明_观澜_2.89.3.md |
+| 场无关引擎与场相关参数的分层与换场作业单 | docs/src/系统设计说明_观澜_2.89.3.md |
 
 表中 」<场>「、」<场站>「、」<机型>「 为占位符，按实际风电场替换。
 
@@ -1075,4 +1076,4 @@
 | 换场 | — | 从一场切到另一场运行的整套动作：改配置、放数据、重跑、按检查表复验 | 本文 §11.9 |
 | 缺族降级 | — | 某族数据缺失时按缺件如实标注并降低该族功能，不造数、不用他场数字顶替 | 本文 FR-49 |
 | 按场标定 | — | 把阈值、时间窗锚点、限电窗、温度档带宽等场相关参数按本场取值 | 本文 FR-50 |
-| 通用收资模板 | — | 与场无关的收资条目底稿，按场裁剪后作为现场收资清单 | docs/src/数据要求说明_观澜_2.89.2.md |
+| 通用收资模板 | — | 与场无关的收资条目底稿，按场裁剪后作为现场收资清单 | docs/src/数据要求说明_观澜_2.89.3.md |

docs/主张审计清单_v0.1.md

@@ -82,3 +82,18 @@
   注意：`score_sample()` 需**新增** `n_windows` 形参（当前签名没有）。
 - **P1**：在文档中把**窗数口径**写成显式条目（当前 1 窗 / 目标 9 窗 / 门的形式），并把「单窗时不得用持续性、趋势类判据」提升为**拒判条件**（观澜 `fus.盲区` 已有同义自述，仅需升格为明文口径）。
 - **P2**：确认这两个评分函数**是否应接入**生产链：现状是未接线 ⇒ 要么接线，要么在代码注释与清单中明确标注"待接线"，避免被误读为"已在用"。
+
+---
+
+## 六、P1 执行结果（2026-10-06）
+
+| 落点 | 内容 |
+|---|---|
+| `sop/vib_confidence.py` 模块文档 | 修正 P0 后**已过时**的两处口径行（A 轴「持续≥4/6窗」、D 轴「覆盖窗数≥4」⇒ 均改为 `max(4, ceil(2N/3))`）；并把「**窗数口径与单窗拒判**」写入模块头 |
+| `scripts/rudong_fusion_handoff.py` | 振动 meta 的 `纪律` 增列窗数口径条款 ⇒ 经 `service/fleet_views.py:581` 传导到页面 `fus.纪律` |
+| `docs/振动六层链_接口规格与缺口_v0.1.md` | 新增「**窗数口径与拒判条件**」节（含门的形式、单窗拒判、不得静默丢窗、当前实况 1 窗、四处出处 file:line） |
+| 本清单 | 本节 |
+
+**条款要点**：① 门 = `max(4, ceil(2N/3))`（N≤6 恒 4 · N=9 ⇒ 6 · 分母只增不减 ⇒ 不会更宽松）；
+② **N<3 时不得**用持续性/逐窗趋势类判据出个体结论，只能标「窗内周段趋势（单窗补充口径，仅参考不作判据）」（与既有降级口径同源）；
+③ **不得静默丢窗**（谱窗与仅标量/原厂状态窗分列，缺窗显式进盲区）。

docs/振动六层链_接口规格与缺口_v0.1.md

@@ -1,373 +1,385 @@
-# 振动六层链 —— 接口规格与缺口（v0.1，2026-09-17）
-
-> 用途：用户令 2026-09-17 #2「无生成端的那批，能否根据旧包产物通过逆向工程推导实现？」的**实测答复**。
-> 结论一句话：**接口已经写在包里的"壳"上，实现缺失；而"能否对拍验证"这件事，缺的正是标准答案** ——
-> 六层链最关键的两件产物（`model_run_l6.parquet`、`fusion_38.csv`）**从未随过包**，无从逐值对拍。
-> 因此本轮**没有**凭猜测写实现（本项目的硬规矩：允许响亮降级，**不许造数**）。
-
----
-
-## 1. 壳在包内：四步怎么调、传什么，代码里已经写死了
-
-`src/windcms/pipeline.py::analyze()` 就是那条链的编排（`scripts/windcms.py analyze` 是它的命令行入口）：
-
-| 步骤名 | 实际执行的脚本 | 参数 | 环境变量 |
-|---|---|---|---|
-| `ingest` | `scripts/rudong_tcm_index.py` + `scripts/rudong_tcm_spectra.py` | `--root <导出> --out <窗>/index.parquet` / `--out <窗>/spectra` | — |
-| `oem_scan` | **`scripts/rudong_tcm_oem_scan.py`**（缺） | 无 | `M5_WINDOWS`（逗号分隔窗清单）、`SCAN_BANDS` |
-| `energy_share` | **`scripts/rudong_line_energy_share.py`**（缺） | 无 | 同上 |
-| `model_run` | **`scripts/rudong_model_run.py`**（缺） | 无 | 同上 |
-| `fusion` | **`scripts/rudong_fusion_run.py`**（缺） | 无 | 同上 |
-| `report` | `scripts/windcms.py report --farm <场>` | — | — |
-| `kb` | `scripts/windcms.py kb --farm <场>` | — | — |
-
-**实测证据**（2026-09-17）：
-
-```
-$ python scripts/windcms.py analyze --window w0316 --steps model_run
-[model_run] rc=2 0.1s
-python.exe: can't open file '…\scripts\rudong_model_run.py': [Errno 2] No such file or directory
-```
-
-⇒ 缺的是**实现**，不是接口。每步该调谁、该吃哪个环境变量，壳里一条不落。
-
-## 2. 产物契约（`src/windcms/config.py` 里写明的路径）
-
-```
-'fusion'        : outputs/<场>/m5_cms_tcm/fusion_38.csv          ← 缺（从未随包）
-'model_l6'      : outputs/<场>/m5_cms_tcm/model_run_l6.parquet  ← 缺（从未随包）
-'model_summary' : outputs/<场>/m5_cms_tcm/model_run_summary.json ← 在（随包件，已按人工件归类）
-'fleet_z'       : outputs/<场>/m5_cms_tcm/fleet_scalar_z.parquet ← 在（随包件）
-'baseline'      : outputs/<场>/m5_cms_tcm/baseline_38.json       ← 在（随包件，含人工坐实的两层基线）
-```
-
-## 3. 为什么"逆向工程 + 逐值对拍"这条路在这四步上走不通
-
-逐值对拍的前提是**有标准答案**。四步里：
-
-| 步骤 | 产物 | 盘上有没有样件 | 能否对拍 |
-|---|---|---|---|
-| `oem_scan` | `oem_frequency_scan.parquet`、`bearing_freq_scan.parquet`、`gear_freq_scan.parquet`、`cage_slip_scan.parquet`、`blade_1p_*.{parquet,csv}` 等 | **在**（约 23 件测量形态件） | 有样件 ⇒ **可以对拍**，但口径（扫哪些频带、窗如何合并、阈值）得先反推 |
-| `energy_share` | 未见同名产物 | 未识别 | 无样件 ⇒ 不可对拍 |
-| `model_run` | `model_run_l6.parquet`（+摘要 json） | **缺** | **无标准答案** ⇒ 只能凭口径实现，无法证明"复现" |
-| `fusion` | `fusion_38.csv`（+ `handoff_vibration_v2.json`） | `fusion_38.csv` **缺**；`handoff_vibration_v2.json` 在，但**它是人工交证件**（见 §4） | 同上 ⇒ 不可对拍 |
-
-### 3.1 2026-09-19 进展：`model_run` / `fusion` 已**按口径重建**（仍不是复现）
-
-用户令 2026-09-18「`/detail` 各页面不许用旧版产出补, 必须基于输入数据重算」之后, 报告里唯一还空着的是
-**融合级**那一列 ⇒ 把这两步按包内既有判据接起来（判据不新写, 只接线）:
-
-| 步骤 | 生成端 | 输入 | 判据/口径 | 性质 |
-|---|---|---|---|---|
-| `model_run` | `scripts/rudong_model_run.py` | 窗索引 + 谱库（`data/raw/<场>/m5_cms_tcm` 摄入所得） | 候选线=`reference/rudong/oem_scan_plan.json` 的 11 部件×{BPFI,BPFO,BSF}（分母已 11/11 逐值验过）; 过闸=`src/sop/discriminators.py::spectral_line_gates`(G1–G8); 定级=`vib_verdict_and_writeback`（L0 短路 / 机制未定不命名部件 / 无正样本锚封顶候选） | **按口径重建**, 无标准答案 |
-| `fusion` | `scripts/rudong_fusion_run.py`（`fusion_table()`） | `model_run_l6.parquet` + 窗索引红黄告警 | 裁决=`src/sop/fusion_diag.py::fuse`（覆盖凭证据 / 排同源 / 按跨度升级） | **按口径重建**, 无标准答案 |
-
-实测（2026-09-19, 窗 w0316）: `model_run` 候选 **1,026** 条 → 过闸 **14** 条
-（闸分布 G2_NO_LINE 656 · G7_PEAK_OFFSET 176 · G4_INHERENT_OR_BATCH 99 · G5_INTEGER_ORDER 53 · G6_SELECTIVITY 24）→ 定级 参考 11 / 候选 3；
-`fusion_38.csv` 38 台 → 融合级 正常 13 / 参考 18 / 候选 7；报告附录 A 的「融合级(模型)」整列**已有值**（此前是 `—`）。
-
-★两条仍未闭合（写进产物与台账，不许当"复现"卖）:
-1. **峰值拾取仍是本器自定**（目标频率 ±2 bin 取最大，与 G7 搜索窗同宽；未做阶次跟踪/多记录合并）——
-   这正是 `oem_scan` 侧缺的"分子"口径（§7.3）。
-2. `handoff_vibration_v2.json` 仍是一份**人工交证件**（§4），不从交付包补（用户令 2026-09-17）。
-   于是 `/detail` 工作台的**振动融合面**（`/api/fleet` 的 `fus`）仍如实报"缺件"，
-   而 CMS 报告/评估页那一面已由上面两步喂上。
-
-## 4. `handoff_vibration_v2.json` 不是"算出来的产物"，而是**人工交证件**
-
-实测其结构：`meta`（version/date/from/to/supersedes/principle/**v2.1_changes**/**v2.2_changes**/
-★消费端接线约定/★派生件同步纪律）、`detectability_prior`、`cross_source_requests`、`baseline_三层`、
-`per_turbine`（v1_generator / v1_gearbox 的**人工裁决** + claim_window）、`field_actions_v1`、
-`calibration_updates_v1`、`open_items`、`tcm16_schedule`。
-
-⇒ 它由振动线**人写**交给 windscada 线，正文里就是判断、承诺与待办。**逆向工程对它无意义**
-（"推"出来的只是同义改写）。它已按用户令 2026-09-17 #3 登记进人工件台账
-`outputs/<场>/_human_artifacts.json`（`kind=human`），**不参与呼应校验**。
-
-## 5. 结论与待办（给研发/振动线的最小清单）
-
-1. **四个脚本的源码**（`rudong_tcm_oem_scan.py` / `rudong_line_energy_share.py` / `rudong_model_run.py` /
-   `rudong_fusion_run.py`）。接口已知（§1），放进 `scripts/` 即可被壳调用。
-2. **两件标准答案**：`model_run_l6.parquet` 与 `fusion_38.csv` 的**任一份历史产出**（哪一窗都行）。
-   有了它，`oem_scan` 侧那 23 件测量件就能照 `temp_monthly` 的老办法（反推口径 → 逐值对拍 → 一致才敢用）
-   转成"✓ 已在重算链上"；没有它，实现出来也**无法证明**复现，只能当成"另一个算法"。
-3. 在那之前，系统按现口径如实呈现：这 36 件（`vib_handoff_and_scans` 里非人工的那部分）标 **✗ 无生成端**，
-   页面缺件时给结构化说明（不静默、不造数、不从交付包补）。
-
-## 7. `oem_scan` 侧：**分母已齐、分子缺**（2026-09-17 反推）
-
-用户令之后的继续推进。这一族（约 23 件测量形态件）**有标准答案**（随包件在盘上），所以可以反推；
-本轮把"哪些部分已经确定、还缺哪一步"钉成了结论。
-
-### 7.1 已确定：扫描列是"观测 / 理论"的比值，**理论侧（分母）包内齐备**
-
-- `bearing_freq_scan.parquet` 的列 `FTF/BSF/BPFO/BPFI/BSF_2x/BPFI_sb/BPFO_sb`，按 `component`
-  聚合后的中位数 ≈ **1.00–1.07**（`GEN_bearing` 1.0018–1.0382；`HS_bearing` 的边带/2×BSF 达 1.19–1.20）
-  ⇒ 明确是"观测频率 ÷ 理论特征频率"。偏离 1 的部分正是诊断信息（HS 轴承边带偏得最多）。
-- `gear_freq_scan.parquet` 同理；同一行里 `IMS_1x / rotor_1x / ring2_2R / sun1_1S / carrier2` **取值相同**
-  —— 因为它们都是**同一根轴的 1×**，比值自然一致（这也反过来印证了"比值"语义）。
-- 分母（理论频率）在包内且是"实机/OEM 参数表"级别：
-  `reference/rudong/oem_bearing_freqs.json`（29 个轴承条目，键名 `BPFI_Hz/BPFO_Hz/BSF_Hz/ORF_Hz/shaft_Hz`，
-  例：`2nd Stage Planetary Section#0 → BPFI 23.8 / BPFO 17.0 / BSF 7.5 Hz`，型号码 `NSK LV220-2/…`）；
-  `reference/rudong/gear_mesh_map_measured.json`（`shafts_Hz` HSS 25.0 / IMS 7.08 / C2 1.67 / LSS 0.20876；
-  `gear_mesh_Hz` GMF1 19.219 / GMF2 151.56 / GMF3 750.0；`stage_ratios` 乘积 **119.752 = 铭牌**）。
-
-### 7.2 已确定的运动学口径（含一处**文档与实现的差异**）
-
-`blade_1p_records.parquet` 的 `f1P`（转子 1P 频率）= **发电机转速 ÷ 速比 ÷ 60**，而由 662 行样件反解出的
-**等效速比精确等于 `119.75`**（均值 119.750000、标准差 4.6e-15、逐台恒定），**不是**机型常量/铭牌上的
-`119.752`。
-
-⇒ 实现时必须用 **119.75**（若照文档写 119.752，`f1P` 会整体偏 1.7e-5 相对量 —— 这正是我第一次对拍看到
-3.7e-6 绝对偏差的来源）。这条差异只有靠"反解样件"才看得出来，文档里读不到。
-
-### 7.3 仍然缺的：**分子** —— "在谱里怎么取观测峰"
-
-要复现这些列，必须在每个理论频率附近从 FFT 谱里取出"观测频率"。这一步的口径（**带宽多大、取什么量最大、
-要不要抛物线插值、是否按转速做阶次跟踪、多窗/多记录怎么合并**）就是缺的
-`scripts/rudong_tcm_oem_scan.py` 的核心，也是**唯一还没确定的部分**。
-
-已备好的测试台：880 行 `bearing_freq_scan` / 880 行 `gear_freq_scan` / 3681 行 `cage_slip_scan`
-（后者还带 `bin` 功率分箱与 `n_rec` 记录数，`ftf_amp` 是幅值）—— 口径一旦给出，逐值对拍可以立刻做。
-
-### 7.4 对取料单的**收窄**（这条很实用）
-
-原本向振动线要"整个 `rudong_tcm_oem_scan.py`"；现在可以**只问一句话**：
-
-> **在理论特征频率附近怎么取观测峰？**（带宽 ±?%、按幅值还是按能量取最大、是否插值校正、是否按 rpm 阶次跟踪、多记录如何合并）
-
-拿到这句话，配上包内已有的理论表与转速，这一族就能照 `temp_monthly` / `fleet_scalar_z` 的老办法
-（反推 → 逐值对拍 → 一致才敢用）转成"✓ 已在重算链上"。**源码仍是首选**（省一轮试错），但不再是唯一路径。
-
-
----
-
-## 6. 逆向工程进展：`fleet_scalar_z.parquet` 的口径已反推（可对拍）
-
-`fusion` 步的产物里，**只有 `fleet_scalar_z.parquet` 有标准答案**（随包件在盘上），因此先攻它。
-新增 `scripts/rudong_fusion_run.py`（`--verify` 与样件逐值对拍，**不改任何件**）。
-
-### 6.1 反推出来的口径
-
-```
-val       = 窗内 median(scalar_value)，按 (turbine, sensor_name, meas_name, condition_key) 分组
-n         = 组内记录数（样件口径：n ≥ 3）
-fleet_med = 跨机组 median(val)（同一 sensor/meas/bin 下）
-z         = (val - fleet_med) / (1.4826 × MAD(val))     ← 稳健 z 分数
-```
-
-**尺度是怎么定下来的**（四条候选逐个数对）：std(ddof=0)=1.44859 → z=−0.1725 ·
-MAD=0.80209 → z=−0.3116 · IQR/1.349=1.46899 → z=−0.1701 ·
-**1.4826×MAD=1.18918 → z=−0.2102 ← 与样件 −0.210156 命中**。
-
-### 6.2 逐值对拍结果（样件 8,887 行 · 窗 w0127）
-
-| 列 | 一致 | 比率 | 说明 |
-|---|---:|---:|---|
-| `val` | **8887 / 8887** | **100%** | 取值链完全复现 ⇒ 分组 + 中位数口径确定无疑 |
-| `n` | 8606 / 8887 | 96.8% | 与行集口径的残留差异同源 |
-| `fleet_med` | 8359 / 8887 | 94.1% | **基线口径仍未复现** |
-| `z` | 8180 / 8887 | 92.0% | 随基线偏差 |
-
-行数：本器 9,163 行 vs 样件 8,887 行（**只多不缺**，多 276 行，全部是 n≥3 的低样本组）。
-
-### 6.3 已确认的三条口径（都是"反推 + 复算验证"得来的，不是猜）
-
-1. **分组**：`(turbine, sensor_name, meas_name, condition_key)`。
-2. **每组最少记录数**：`n ≥ 3`（样件 n 分布 min=3；加上这条后行数 31,574 → 9,505）。
-3. **量纲闸**：`y_unit ∈ {1, m/s, m/s²}` —— 只留振动量纲的标量（无量纲指标 / 速度 / 加速度）。
-   **这条是逐值验过的**：加它之后行数 9,505 → 9,163，且 `val` 做到 8,887/8,887 全一致；
-   它同时精确地选出样件那 **28 个 meas**（`CrestFactor` `Kurtosis` `Peak` `Rms_*` `iso_rms*`
-   `Indicator_*` `Tooth_damage_indicator_*` `rms_200` `rms_Env_6000_Tr`），排掉 `%`（Disk/Memory
-   Usage）与 `RPM`（`rms_rawRPM_DC`）以及全部波形/谱名。**注意：原先按 `meas_type` /
-   `meas_source` 找都不成立，`y_unit` 才是那把钥匙。**
-
-### 6.4 仍未闭合的一件事：样件的**行集**（不是公式）
-
-本轮把 §6.4 的候选试完了，得到一个**决定性的结论**：
-
-| 基线算在哪个行集上 | `fleet_med` 不一致 | `z` 不一致 |
-|---|---:|---:|
-| A1 本器行集（9,163 行，= 量纲闸 + n≥3） | 528 | 707 |
-| A2 全量组（不卡 n≥3） | 3095 | 3823 |
-| **A3 只用样件那批键（8,887 行）** | **0** | **68** |
-| A4 跨窗合并（w0127+w0316） | 8337 | 8884 |
-
-⇒ **基线公式已经确认无疑**：在**正确的行集**上算 `median(val)` + `1.4826×MAD`，`fleet_med` 逐值 **100% 一致**，
-`z` 99.2% 一致（剩 68 处，疑似 `MAD≈0`/小样本键的兜底规则）。
-
-⇒ 剩下的唯一未知是**样件的行集比本器少 276 行**（3.1%，全是 `n≥3` 的低样本组，缺 0 行）。
-那 276 行会**抬高/压低同一键的 fleet 中位数**，于是基线整体偏 5–8% —— A1 与 A3 的差距就来自这里。
-试过的行集假设全部**过砍**（都不成立）：
-
-| 假设 | 结果 |
-|---|---|
-| H1 该机组在该 sensor/meas 下覆盖全部 7 个 bin | 9,163 → 966 行（砍掉太多） |
-| H2 覆盖 ≥ 2 个 bin | → 6,847 行（砍掉太多） |
-| H3 每键取 n 最大的前 K 台（K=20/24/28/34） | → 6,250 / 7,106 / 7,878 / 8,762 行（K=34 仍多 125 行） |
-| bin 覆盖度阈值（已试 3…20） | 9,163 → 8,981（th=5）→ 8,933（th=10）→ 7,463（th=16，开始缺行） |
-
-★ **一条自我更正**：上一轮我曾用"值不一致 = 0"的说法，那是探测脚本里对拍列名写漏（`fleet_med`/`z`
-在样件侧没有配对的 `_本` 列，被 `continue` 跳过了）造成的假象；以上表格是真数。
-留在这里，以免下次又被同一类"对拍自己骗自己"骗到。
-
-**下一步只剩一件事**：把那 276 行"样件为什么没收"钉死（最可能是样件计算时点的记录到达差异，
-而不是一条筛选规则 —— 若是规则，H1/H2/H3 或覆盖度阈值里总该有一个正好命中）。钉死之后
-`fleet_scalar_z` 即可正式转 raw-derived。
-
-### 6.5 结论
-
-- **能推**：这条链上"内容是窗内标量函数"的那部分确实可以逆向工程 —— 已经推到
-  `val` 逐值 100%、三条口径全部落定；`--verify` 把这件事做成了可重复的机器判据。
-- **判据纪律**：对拍未全过时本器**拒绝**声明复现（退出码 5，打印"不要拿本器产物替换样件"），
-  产物**不替换**，该件继续留 ✗ —— 宁可留着缺口，也不拿 92% 冒充标准答案。
-- **下一步**（按代价排序）：① 试 §6.4 的四个候选把基线钉死（一个探针脚本就能试完）；
-  ② 行集那 276 行的差别（疑似样件计算时的记录到达时点差异）确认后随基线一起收口；
-  ③ `fusion_38.csv` 无标准答案，需振动线给一份历史产出（或那四个脚本的源码）。
-
-
-
----
-
-> 台账现状（2026-09-17）：✓ 呼应成立 1742 件 · ✗ 无生成端 285 件 · ◆ 人工件 209 件 · 无法验证 0 · 未归类 0。
-> 缺料自查：`python scripts/chain_gap_check.py --check`；取料单：`docs/向振动线取料单_v0.1.md`。
-
-### 7.5 `blade_1p_records` 的接续入口（本轮探到的确切起点）
-
-按"先啃运动学已确定的那件"继续，把下一次能接着做的入口探清楚了：
-
-| 事项 | 实测结论 |
-|---|---|
-| 覆盖范围 | 只两个测点：`Main_bearing_front` / `Main_bearing_rear`；662 行；时间 2026-01-27 11:35 ~ 2026-02-01 23:16（**w0127 首窗**，其索引在 `m5/tcm_index.parquet`，不在 `windows/w0127/`） |
-| 转速来源 | ★ 样件行的 `rpm` **不是**同一记录里 `Kurtosis` 行的 rpm：样件 `rpm=1601.0371`，而索引里 `trigger_time` 同一条的 `Kurtosis` 行 `rpm=1604.2537`。⇒ 1P 分析用的是**该记录自己的转速**（`RpmProfile` / `rawRPM` 那类），不是标量指标行带的转速。这条搞错，`f1P` 就对不上（速比 119.75 本身不变） |
-| 谱文件命名 | ★**更正**：`spectra/p<NN>/<meas_name>_n<lines>_<seq>.npz`（例 `FFT_4_Tr_n401_0000.npz`）；"记录 ↔ npz"**不需要靠枚举顺序去猜** —— `rudong_tcm_spectra.py` 落盘时已同时写出 `spectra_meta.parquet`（每行一条谱：turbine/sensor/meas_name/trigger_time/**shard/shard_row**/x_offset/x_delta），取数配方就是该脚本头部那句 `v = npz["values"][shard_row]; x = x_offset + arange(len(v))*x_delta`。本包新增 `scripts/spectra_lookup.py` 把它封成一条命令 |
-| 谱本身 | npz 内是幅值数组；频率轴由索引的 `x_offset`/`x_delta`/`lines` 给出（例 `FFT_16000: lines=400, x_offset=0, x_delta=40` ⇒ 40 Hz/线）⇒ 频率轴可算；`f1P=0.223 Hz` 落在**第 0 条线**上 —— 这正是"1P 在低频谱里极难分辨"的原因，也解释了为什么这一族要专门做（样件 `energy_pct` 只有 0.38%） |
-
-**下一次接手的最短路径**（三步，都在包内可做）：
-① ~~读枚举顺序建映射~~ **已完成**：映射本来就是产品（`spectra_meta.parquet`），本包已封装为 `scripts/spectra_lookup.py`（实测 `WTG01/Main_bearing_rear/FFT_4_Tr` → `spectra/p00/FFT_4_Tr_n401_0000.npz` 第 1 行，0.01 Hz/线，401 点）；
-② 用 `x_offset + i*x_delta` 重建频率轴，在 `f1P` 附近按候选口径（最近线 / ±2% 带内取最大 / 抛物线插值）取幅值，与样件 `a1P` 对拍；
-③ `a1P` 一旦对上，`struct`（疑似 `a1P / fleet` 归一分）、`energy_pct`、`g1/g2/g4` 闸门与 `verdict` 有望按同样办法逐个对拍。
-
-> 本轮到此为止的自我约束：**没有**在"峰值拾取口径未知"时硬写实现 —— 那样产出的数字无法证明是复现，只会给交付物掺进"看起来对"的东西。取料单里那**一句话**（或那四个脚本）到位后，上面三步当天可做完。
----
-
-## 8. 1P 这一族的**本地阻塞点**（2026-09-17 查证）
-
-用户令"做①（查 1 月 decode 件在不在）"的结论：**不在**。
-
-| 查证项 | 结果 |
-|---|---|
-| `blade_1p_records` 时间跨度 | 2026-01-27 11:35 ~ 2026-02-01 23:16（**w0127 窗**） |
-| w0127 的索引 | **在**（随包件 `m5_cms_tcm/tcm_index.parquet`，330,308 行、2026-01-27 ~ 2026-02-03、含样件那批时间戳的 89 行记录） |
-| w0127 的**源件导出** | **不在**：`data/raw/如东/windcms/` 下只有 `CMS_RuDong_CGN_202603-04`（3–4 月）+ 厂家报告；`data/raw/如东/m5_cms_tcm/` 只有一份 docx |
-| w0127 的谱库 | **不在**（盘上只有 w0316 的谱：1,701 分片 / 420,742 条谱记录） |
-
-⇒ **1P 在本机无法重算**，缺的是**源件**，不是工具：索引在、查表工具（`scripts/spectra_lookup.py`）在、
-运动学口径（`f1P = rpm/(60×119.75)`）在、频率轴算法在 —— 独独缺 1 月的 decode 导出。
-这条已作为**第 7 项**加进取料单（`docs/向振动线取料单_v0.1.md` 第五节）。
-
-**也因此确认**：`oem_scan` 侧那 23 件（谱在盘上，w0316）**仍可在本地推进**，只要拿到峰值拾取口径；
-而 1P 那 662 行需要"口径 + 1 月源件"两样。两条路的先后可以按到料快慢决定。
-
----
-
-## 9. `oem_scan` 侧的**分母已落地并逐值验过**（2026-09-17 收口）
-
-在"优先攻 oem_scan 侧"这一轮里，没有等口径就把**分母那一半**做完了，并且是**逐值对拍通过**的：
-
-### 9.1 扫描配置（机型常量）
-
-`reference/rudong/oem_scan_plan.json`（新增）—— 11 个部件各用哪条谱、什么分辨率：
-
-| 部件 | 测点 | shard | dx_hz |
-|---|---|---|---|
-| `generator_de_6338` / `generator_nde_6338` | `Generator_DE` / `Generator_NDE` | `Env_6000_4000_850_Tr` | 1.0625 |
-| `hs_generator_left` / `hs_generator_right_fag` / `hs_generator_right_nsk` / `hs_rotor` | `Gear_HS_generator_side` / `Gear_HS_rotor_side` | `FFT_6000_Tr` | 0.9375 |
-| `ims_generator_fag` / `ims_generator_nsk` / `ims_rotor` | `Gear_IMS` | `FFT_2000_fast_Tr` | 0.625 |
-| `main_front` / `main_rear` | `Main_bearing_front` / `Main_bearing_rear` | `FFT_62_Tr` | 0.03875 |
-
-（性质：**机型常量**，不是原始数据的函数；权威来源是那份随包件，故原样固化并注明来历。）
-
-### 9.2 理论频率（分母）的映射规则 —— 实测 **11/11 逐值一致**
-
-```
-option 串 → oem_bearing_freqs.json 条目：
-  ① 取位置 token：Pos.150R→150r ｜ 139.1/1060 f-576853.PRL→1391/1060 ｜ 6338 M/C3→6338m/c3
-  ② 同位置多候选时按型号 token 定夺（NSK 284 vs FAG 273；NSK 137 vs FAG 151 —— 两处都验到了）
-```
-
-`python scripts/rudong_tcm_oem_scan.py --verify-plan` ⇒ 11 个部件的 `BPFI_hz`/`BPFO_hz`/`BSF_hz`
-与 `dx_hz` **逐值一致（11/11，rc=0）**。
-
-### 9.3 新增 `scripts/rudong_tcm_oem_scan.py`：**分母就位、分子待口径，且拒绝半成品**
-
-- `--verify-plan` 对拍分母与配置；`--plan` 打印扫描计划；`--status` 输出机器可读状态；
-- **默认运行 rc=3 且不写盘** —— 理由写在脚本头：只写分母的那些件"看着像扫描结果、实则没有分子"，
-  产出半成品比不产出更危险（本项目一贯口径：允许响亮降级，不许造数）；
-- 口径到位后把脚本里 `PEAK_PICKING_READY` 翻成 `True` 即可接上（分子侧实现位置已标好）。
-
-### 9.4 顺带修掉的两处"真原因被顶掉"
-
-1. `src/windcms/pipeline.py::_run`：`text=True` 下 `stdout/stderr` 可能是 `None`，直接相加会抛
-   `unsupported operand type(s) for +: 'NoneType' and 'str'` —— 于是**真正的失败原因被这句无意义异常顶掉**
-   （实测：oem_scan 明确报了 rc=3 与缺什么口径，经壳调用后看到的是那句类型错误）。已改为 `(p.stdout or '') + (p.stderr or '')`。
-2. `scripts/chain_gap_check.py`：**脚本在位 ≠ 这一步能出产物**。现在会调各步的 `--status`，
-   把"部分实现"如实标成 `[部分]`（并列出缺什么），不再给"看起来齐了"的假结论。
-
----
-
-## 10. 三张扫描表的**行骨架**：一张能从数据推、两张要口径（2026-09-17）
-
-`python scripts/rudong_tcm_oem_scan.py --skeleton-verify`（新增，窗 w0127 —— 样件与索引都在的那一窗）：
-
-| 键集合 | 样件 | 由包内索引推 | 交集 | 判定 |
-|---|---:|---:|---:|---|
-| `bearing_freq_scan` / `GEN_bearing` | 74 | 74 | 74 | 一致 |
-| `bearing_freq_scan` / `HS_bearing` | 74 | 74 | 74 | 一致 |
-| `cage_slip_scan` / 发电机DE（机组×分箱） | 83 | 282 | 83 | 样件是索引的子集 |
-| `cage_slip_scan` / 发电机NDE | 83 | 282 | 83 | 同上 |
-| `cage_slip_scan` / 高速轴 | 83 | 282 | 83 | 同上 |
-
-**结论（三种成分，必须分开说）**：
-
-1. **能由数据推（已验证）**：`bearing_freq_scan` / `gear_freq_scan` 的行骨架 = 窗 × 机组 × 4 个
-   (component, sensor) 组合，由索引里的 `turbine`/`sensor_name` 直接给出 —— w0127 上 **74/74 逐键一致**。
-   （两张表都是"每 (窗,机组) 恰好 4 行"，窗集合 6 个、每窗 35~37 台。）
-2. **要口径（已定量界住，2026-09-17 又追了一轮）**：`cage_slip_scan` 的键是索引的**子集**。
-   追加实测（建议②那一轮）：**保留键**在索引里的记录数 **112~1426**、时间跨度中位 **5,072 min**；
-   **未保留键**只有 **1~218** 条、跨度中位 **752 min** ⇒ 判据形态是"**该分箱是常态工况**"（记录足够多、
-   跨得足够久），而不是按单条记录挑。但样本 `n_rec` 只有 **2~7**，与该分箱的记录数**完全不是一回事**
-   ⇒ `n_rec` 统计的是**某种"可用记录数"**（疑为窄转速带内的稳态记录数）。结论：判据形态已明确，
-   具体阈值/定义仍需口径。以下是原描述：
-2. **要口径（已定量界住）**：`cage_slip_scan` 的键是索引的**子集**（w0127：样件 83 键/部件 vs 索引 282），
-   少掉的由**稳态段筛选**决定 —— 且样本自己的 `n_rec` 只有 **2~7**，与"该 (机组,测点,分箱) 在索引里的
-   记录数 47~1426"**完全不是一回事** ⇒ `n_rec` 统计的不是分箱记录数，而是某种"可用记录数"。
-   分箱本身**已知**：就是 `condition_key` 的 7 个功率分箱（`WPS-ActivePower 0-1600` … `3600-4400`，
-   `bin_idx`=0..6；实测 `bin ⊆ condition_key` 成立）。
-3. **只能从样件复刻**：**窗集合**（`w0127/w0707/w0711/w0724/w0805/w0811`）与"哪些窗有哪几台" ——
-   其余 5 窗的索引与谱库都不在本机（盘上只有 w0127 与 w0316 的索引、只有 w0316 的谱）。
-   取料单第 7 项的 1 月导出件只解决 w0127；要复现全部 6 窗，还需要 **w0707/w0711/w0724/w0805/w0811
-   这 5 个窗的 CMS 导出件**。
-
----
-
-## 11. `oem_frequency_scan`：行骨架 + 分母列**已 2,420/2,420 逐值复现**（2026-09-17）
-
-`python scripts/rudong_tcm_oem_scan.py --verify-skeleton-oem`：
-
-```
-样件 2420 行 · 本器骨架 2420 行 · 同键 2420 · 仅样件 0 · 仅本器 0
-dx_hz / BPFI_hz / BPFO_hz / BSF_hz 逐值一致: 2420/2420
-三对 ratio 列: 本器非空 0 行（等口径填分子）· 样件非空 2420 行
-结论: 行骨架与分母列逐键逐值一致（只差 ratio 三对列的分子）  rc=0
-```
-
-**行骨架** = 6 窗 × 每窗 37/37/37/37/37/35 台 × 11 个部件 = **2,420 行**（每 (窗,机组) 每部件 1 行）。
-其中**分母列**（`dx_hz` + `BPFI_hz`/`BPFO_hz`/`BSF_hz`）来自 `--verify-plan` 验过的映射（11/11）。
-
-**性质标注（不许混）**：窗集合与每窗机组集**复刻自样件**（写进 `oem_scan_plan.json` 的 `row_skeleton.note`）——
-那 5 个窗（w0707/w0711/w0724/w0805/w0811）的索引与谱库都不在本机，所以这一节**不是**"由 data/raw 推出"，
-要真由数据推出需取料单第 8 项的 5 窗导出件。**比值三对列（分子）留空**，等那一句峰值拾取口径。
-
-**至此 `oem_frequency_scan` 的成分账**：配置 ✅ · 行骨架 ✅（复刻，可对拍）· 分母 ✅（11/11）·
-**分子 ⭕（唯一开口）**。
+# 振动六层链 —— 接口规格与缺口（v0.1，2026-09-17）
+
+> 用途：用户令 2026-09-17 #2「无生成端的那批，能否根据旧包产物通过逆向工程推导实现？」的**实测答复**。
+> 结论一句话：**接口已经写在包里的"壳"上，实现缺失；而"能否对拍验证"这件事，缺的正是标准答案** ——
+> 六层链最关键的两件产物（`model_run_l6.parquet`、`fusion_38.csv`）**从未随过包**，无从逐值对拍。
+> 因此本轮**没有**凭猜测写实现（本项目的硬规矩：允许响亮降级，**不许造数**）。
+
+---
+
+## 1. 壳在包内：四步怎么调、传什么，代码里已经写死了
+
+`src/windcms/pipeline.py::analyze()` 就是那条链的编排（`scripts/windcms.py analyze` 是它的命令行入口）：
+
+| 步骤名 | 实际执行的脚本 | 参数 | 环境变量 |
+|---|---|---|---|
+| `ingest` | `scripts/rudong_tcm_index.py` + `scripts/rudong_tcm_spectra.py` | `--root <导出> --out <窗>/index.parquet` / `--out <窗>/spectra` | — |
+| `oem_scan` | **`scripts/rudong_tcm_oem_scan.py`**（缺） | 无 | `M5_WINDOWS`（逗号分隔窗清单）、`SCAN_BANDS` |
+| `energy_share` | **`scripts/rudong_line_energy_share.py`**（缺） | 无 | 同上 |
+| `model_run` | **`scripts/rudong_model_run.py`**（缺） | 无 | 同上 |
+| `fusion` | **`scripts/rudong_fusion_run.py`**（缺） | 无 | 同上 |
+| `report` | `scripts/windcms.py report --farm <场>` | — | — |
+| `kb` | `scripts/windcms.py kb --farm <场>` | — | — |
+
+**实测证据**（2026-09-17）：
+
+```
+$ python scripts/windcms.py analyze --window w0316 --steps model_run
+[model_run] rc=2 0.1s
+python.exe: can't open file '…\scripts\rudong_model_run.py': [Errno 2] No such file or directory
+```
+
+⇒ 缺的是**实现**，不是接口。每步该调谁、该吃哪个环境变量，壳里一条不落。
+
+## 2. 产物契约（`src/windcms/config.py` 里写明的路径）
+
+```
+'fusion'        : outputs/<场>/m5_cms_tcm/fusion_38.csv          ← 缺（从未随包）
+'model_l6'      : outputs/<场>/m5_cms_tcm/model_run_l6.parquet  ← 缺（从未随包）
+'model_summary' : outputs/<场>/m5_cms_tcm/model_run_summary.json ← 在（随包件，已按人工件归类）
+'fleet_z'       : outputs/<场>/m5_cms_tcm/fleet_scalar_z.parquet ← 在（随包件）
+'baseline'      : outputs/<场>/m5_cms_tcm/baseline_38.json       ← 在（随包件，含人工坐实的两层基线）
+```
+
+## 3. 为什么"逆向工程 + 逐值对拍"这条路在这四步上走不通
+
+逐值对拍的前提是**有标准答案**。四步里：
+
+| 步骤 | 产物 | 盘上有没有样件 | 能否对拍 |
+|---|---|---|---|
+| `oem_scan` | `oem_frequency_scan.parquet`、`bearing_freq_scan.parquet`、`gear_freq_scan.parquet`、`cage_slip_scan.parquet`、`blade_1p_*.{parquet,csv}` 等 | **在**（约 23 件测量形态件） | 有样件 ⇒ **可以对拍**，但口径（扫哪些频带、窗如何合并、阈值）得先反推 |
+| `energy_share` | 未见同名产物 | 未识别 | 无样件 ⇒ 不可对拍 |
+| `model_run` | `model_run_l6.parquet`（+摘要 json） | **缺** | **无标准答案** ⇒ 只能凭口径实现，无法证明"复现" |
+| `fusion` | `fusion_38.csv`（+ `handoff_vibration_v2.json`） | `fusion_38.csv` **缺**；`handoff_vibration_v2.json` 在，但**它是人工交证件**（见 §4） | 同上 ⇒ 不可对拍 |
+
+### 3.1 2026-09-19 进展：`model_run` / `fusion` 已**按口径重建**（仍不是复现）
+
+用户令 2026-09-18「`/detail` 各页面不许用旧版产出补, 必须基于输入数据重算」之后, 报告里唯一还空着的是
+**融合级**那一列 ⇒ 把这两步按包内既有判据接起来（判据不新写, 只接线）:
+
+| 步骤 | 生成端 | 输入 | 判据/口径 | 性质 |
+|---|---|---|---|---|
+| `model_run` | `scripts/rudong_model_run.py` | 窗索引 + 谱库（`data/raw/<场>/m5_cms_tcm` 摄入所得） | 候选线=`reference/rudong/oem_scan_plan.json` 的 11 部件×{BPFI,BPFO,BSF}（分母已 11/11 逐值验过）; 过闸=`src/sop/discriminators.py::spectral_line_gates`(G1–G8); 定级=`vib_verdict_and_writeback`（L0 短路 / 机制未定不命名部件 / 无正样本锚封顶候选） | **按口径重建**, 无标准答案 |
+| `fusion` | `scripts/rudong_fusion_run.py`（`fusion_table()`） | `model_run_l6.parquet` + 窗索引红黄告警 | 裁决=`src/sop/fusion_diag.py::fuse`（覆盖凭证据 / 排同源 / 按跨度升级） | **按口径重建**, 无标准答案 |
+
+实测（2026-09-19, 窗 w0316）: `model_run` 候选 **1,026** 条 → 过闸 **14** 条
+（闸分布 G2_NO_LINE 656 · G7_PEAK_OFFSET 176 · G4_INHERENT_OR_BATCH 99 · G5_INTEGER_ORDER 53 · G6_SELECTIVITY 24）→ 定级 参考 11 / 候选 3；
+`fusion_38.csv` 38 台 → 融合级 正常 13 / 参考 18 / 候选 7；报告附录 A 的「融合级(模型)」整列**已有值**（此前是 `—`）。
+
+★两条仍未闭合（写进产物与台账，不许当"复现"卖）:
+1. **峰值拾取仍是本器自定**（目标频率 ±2 bin 取最大，与 G7 搜索窗同宽；未做阶次跟踪/多记录合并）——
+   这正是 `oem_scan` 侧缺的"分子"口径（§7.3）。
+2. `handoff_vibration_v2.json` 仍是一份**人工交证件**（§4），不从交付包补（用户令 2026-09-17）。
+   于是 `/detail` 工作台的**振动融合面**（`/api/fleet` 的 `fus`）仍如实报"缺件"，
+   而 CMS 报告/评估页那一面已由上面两步喂上。
+
+## 4. `handoff_vibration_v2.json` 不是"算出来的产物"，而是**人工交证件**
+
+实测其结构：`meta`（version/date/from/to/supersedes/principle/**v2.1_changes**/**v2.2_changes**/
+★消费端接线约定/★派生件同步纪律）、`detectability_prior`、`cross_source_requests`、`baseline_三层`、
+`per_turbine`（v1_generator / v1_gearbox 的**人工裁决** + claim_window）、`field_actions_v1`、
+`calibration_updates_v1`、`open_items`、`tcm16_schedule`。
+
+⇒ 它由振动线**人写**交给 windscada 线，正文里就是判断、承诺与待办。**逆向工程对它无意义**
+（"推"出来的只是同义改写）。它已按用户令 2026-09-17 #3 登记进人工件台账
+`outputs/<场>/_human_artifacts.json`（`kind=human`），**不参与呼应校验**。
+
+## 5. 结论与待办（给研发/振动线的最小清单）
+
+1. **四个脚本的源码**（`rudong_tcm_oem_scan.py` / `rudong_line_energy_share.py` / `rudong_model_run.py` /
+   `rudong_fusion_run.py`）。接口已知（§1），放进 `scripts/` 即可被壳调用。
+2. **两件标准答案**：`model_run_l6.parquet` 与 `fusion_38.csv` 的**任一份历史产出**（哪一窗都行）。
+   有了它，`oem_scan` 侧那 23 件测量件就能照 `temp_monthly` 的老办法（反推口径 → 逐值对拍 → 一致才敢用）
+   转成"✓ 已在重算链上"；没有它，实现出来也**无法证明**复现，只能当成"另一个算法"。
+3. 在那之前，系统按现口径如实呈现：这 36 件（`vib_handoff_and_scans` 里非人工的那部分）标 **✗ 无生成端**，
+   页面缺件时给结构化说明（不静默、不造数、不从交付包补）。
+
+## 7. `oem_scan` 侧：**分母已齐、分子缺**（2026-09-17 反推）
+
+用户令之后的继续推进。这一族（约 23 件测量形态件）**有标准答案**（随包件在盘上），所以可以反推；
+本轮把"哪些部分已经确定、还缺哪一步"钉成了结论。
+
+### 7.1 已确定：扫描列是"观测 / 理论"的比值，**理论侧（分母）包内齐备**
+
+- `bearing_freq_scan.parquet` 的列 `FTF/BSF/BPFO/BPFI/BSF_2x/BPFI_sb/BPFO_sb`，按 `component`
+  聚合后的中位数 ≈ **1.00–1.07**（`GEN_bearing` 1.0018–1.0382；`HS_bearing` 的边带/2×BSF 达 1.19–1.20）
+  ⇒ 明确是"观测频率 ÷ 理论特征频率"。偏离 1 的部分正是诊断信息（HS 轴承边带偏得最多）。
+- `gear_freq_scan.parquet` 同理；同一行里 `IMS_1x / rotor_1x / ring2_2R / sun1_1S / carrier2` **取值相同**
+  —— 因为它们都是**同一根轴的 1×**，比值自然一致（这也反过来印证了"比值"语义）。
+- 分母（理论频率）在包内且是"实机/OEM 参数表"级别：
+  `reference/rudong/oem_bearing_freqs.json`（29 个轴承条目，键名 `BPFI_Hz/BPFO_Hz/BSF_Hz/ORF_Hz/shaft_Hz`，
+  例：`2nd Stage Planetary Section#0 → BPFI 23.8 / BPFO 17.0 / BSF 7.5 Hz`，型号码 `NSK LV220-2/…`）；
+  `reference/rudong/gear_mesh_map_measured.json`（`shafts_Hz` HSS 25.0 / IMS 7.08 / C2 1.67 / LSS 0.20876；
+  `gear_mesh_Hz` GMF1 19.219 / GMF2 151.56 / GMF3 750.0；`stage_ratios` 乘积 **119.752 = 铭牌**）。
+
+### 7.2 已确定的运动学口径（含一处**文档与实现的差异**）
+
+`blade_1p_records.parquet` 的 `f1P`（转子 1P 频率）= **发电机转速 ÷ 速比 ÷ 60**，而由 662 行样件反解出的
+**等效速比精确等于 `119.75`**（均值 119.750000、标准差 4.6e-15、逐台恒定），**不是**机型常量/铭牌上的
+`119.752`。
+
+⇒ 实现时必须用 **119.75**（若照文档写 119.752，`f1P` 会整体偏 1.7e-5 相对量 —— 这正是我第一次对拍看到
+3.7e-6 绝对偏差的来源）。这条差异只有靠"反解样件"才看得出来，文档里读不到。
+
+### 7.3 仍然缺的：**分子** —— "在谱里怎么取观测峰"
+
+要复现这些列，必须在每个理论频率附近从 FFT 谱里取出"观测频率"。这一步的口径（**带宽多大、取什么量最大、
+要不要抛物线插值、是否按转速做阶次跟踪、多窗/多记录怎么合并**）就是缺的
+`scripts/rudong_tcm_oem_scan.py` 的核心，也是**唯一还没确定的部分**。
+
+已备好的测试台：880 行 `bearing_freq_scan` / 880 行 `gear_freq_scan` / 3681 行 `cage_slip_scan`
+（后者还带 `bin` 功率分箱与 `n_rec` 记录数，`ftf_amp` 是幅值）—— 口径一旦给出，逐值对拍可以立刻做。
+
+### 7.4 对取料单的**收窄**（这条很实用）
+
+原本向振动线要"整个 `rudong_tcm_oem_scan.py`"；现在可以**只问一句话**：
+
+> **在理论特征频率附近怎么取观测峰？**（带宽 ±?%、按幅值还是按能量取最大、是否插值校正、是否按 rpm 阶次跟踪、多记录如何合并）
+
+拿到这句话，配上包内已有的理论表与转速，这一族就能照 `temp_monthly` / `fleet_scalar_z` 的老办法
+（反推 → 逐值对拍 → 一致才敢用）转成"✓ 已在重算链上"。**源码仍是首选**（省一轮试错），但不再是唯一路径。
+
+
+---
+
+## 6. 逆向工程进展：`fleet_scalar_z.parquet` 的口径已反推（可对拍）
+
+`fusion` 步的产物里，**只有 `fleet_scalar_z.parquet` 有标准答案**（随包件在盘上），因此先攻它。
+新增 `scripts/rudong_fusion_run.py`（`--verify` 与样件逐值对拍，**不改任何件**）。
+
+### 6.1 反推出来的口径
+
+```
+val       = 窗内 median(scalar_value)，按 (turbine, sensor_name, meas_name, condition_key) 分组
+n         = 组内记录数（样件口径：n ≥ 3）
+fleet_med = 跨机组 median(val)（同一 sensor/meas/bin 下）
+z         = (val - fleet_med) / (1.4826 × MAD(val))     ← 稳健 z 分数
+```
+
+**尺度是怎么定下来的**（四条候选逐个数对）：std(ddof=0)=1.44859 → z=−0.1725 ·
+MAD=0.80209 → z=−0.3116 · IQR/1.349=1.46899 → z=−0.1701 ·
+**1.4826×MAD=1.18918 → z=−0.2102 ← 与样件 −0.210156 命中**。
+
+### 6.2 逐值对拍结果（样件 8,887 行 · 窗 w0127）
+
+| 列 | 一致 | 比率 | 说明 |
+|---|---:|---:|---|
+| `val` | **8887 / 8887** | **100%** | 取值链完全复现 ⇒ 分组 + 中位数口径确定无疑 |
+| `n` | 8606 / 8887 | 96.8% | 与行集口径的残留差异同源 |
+| `fleet_med` | 8359 / 8887 | 94.1% | **基线口径仍未复现** |
+| `z` | 8180 / 8887 | 92.0% | 随基线偏差 |
+
+行数：本器 9,163 行 vs 样件 8,887 行（**只多不缺**，多 276 行，全部是 n≥3 的低样本组）。
+
+### 6.3 已确认的三条口径（都是"反推 + 复算验证"得来的，不是猜）
+
+1. **分组**：`(turbine, sensor_name, meas_name, condition_key)`。
+2. **每组最少记录数**：`n ≥ 3`（样件 n 分布 min=3；加上这条后行数 31,574 → 9,505）。
+3. **量纲闸**：`y_unit ∈ {1, m/s, m/s²}` —— 只留振动量纲的标量（无量纲指标 / 速度 / 加速度）。
+   **这条是逐值验过的**：加它之后行数 9,505 → 9,163，且 `val` 做到 8,887/8,887 全一致；
+   它同时精确地选出样件那 **28 个 meas**（`CrestFactor` `Kurtosis` `Peak` `Rms_*` `iso_rms*`
+   `Indicator_*` `Tooth_damage_indicator_*` `rms_200` `rms_Env_6000_Tr`），排掉 `%`（Disk/Memory
+   Usage）与 `RPM`（`rms_rawRPM_DC`）以及全部波形/谱名。**注意：原先按 `meas_type` /
+   `meas_source` 找都不成立，`y_unit` 才是那把钥匙。**
+
+### 6.4 仍未闭合的一件事：样件的**行集**（不是公式）
+
+本轮把 §6.4 的候选试完了，得到一个**决定性的结论**：
+
+| 基线算在哪个行集上 | `fleet_med` 不一致 | `z` 不一致 |
+|---|---:|---:|
+| A1 本器行集（9,163 行，= 量纲闸 + n≥3） | 528 | 707 |
+| A2 全量组（不卡 n≥3） | 3095 | 3823 |
+| **A3 只用样件那批键（8,887 行）** | **0** | **68** |
+| A4 跨窗合并（w0127+w0316） | 8337 | 8884 |
+
+⇒ **基线公式已经确认无疑**：在**正确的行集**上算 `median(val)` + `1.4826×MAD`，`fleet_med` 逐值 **100% 一致**，
+`z` 99.2% 一致（剩 68 处，疑似 `MAD≈0`/小样本键的兜底规则）。
+
+⇒ 剩下的唯一未知是**样件的行集比本器少 276 行**（3.1%，全是 `n≥3` 的低样本组，缺 0 行）。
+那 276 行会**抬高/压低同一键的 fleet 中位数**，于是基线整体偏 5–8% —— A1 与 A3 的差距就来自这里。
+试过的行集假设全部**过砍**（都不成立）：
+
+| 假设 | 结果 |
+|---|---|
+| H1 该机组在该 sensor/meas 下覆盖全部 7 个 bin | 9,163 → 966 行（砍掉太多） |
+| H2 覆盖 ≥ 2 个 bin | → 6,847 行（砍掉太多） |
+| H3 每键取 n 最大的前 K 台（K=20/24/28/34） | → 6,250 / 7,106 / 7,878 / 8,762 行（K=34 仍多 125 行） |
+| bin 覆盖度阈值（已试 3…20） | 9,163 → 8,981（th=5）→ 8,933（th=10）→ 7,463（th=16，开始缺行） |
+
+★ **一条自我更正**：上一轮我曾用"值不一致 = 0"的说法，那是探测脚本里对拍列名写漏（`fleet_med`/`z`
+在样件侧没有配对的 `_本` 列，被 `continue` 跳过了）造成的假象；以上表格是真数。
+留在这里，以免下次又被同一类"对拍自己骗自己"骗到。
+
+**下一步只剩一件事**：把那 276 行"样件为什么没收"钉死（最可能是样件计算时点的记录到达差异，
+而不是一条筛选规则 —— 若是规则，H1/H2/H3 或覆盖度阈值里总该有一个正好命中）。钉死之后
+`fleet_scalar_z` 即可正式转 raw-derived。
+
+### 6.5 结论
+
+- **能推**：这条链上"内容是窗内标量函数"的那部分确实可以逆向工程 —— 已经推到
+  `val` 逐值 100%、三条口径全部落定；`--verify` 把这件事做成了可重复的机器判据。
+- **判据纪律**：对拍未全过时本器**拒绝**声明复现（退出码 5，打印"不要拿本器产物替换样件"），
+  产物**不替换**，该件继续留 ✗ —— 宁可留着缺口，也不拿 92% 冒充标准答案。
+- **下一步**（按代价排序）：① 试 §6.4 的四个候选把基线钉死（一个探针脚本就能试完）；
+  ② 行集那 276 行的差别（疑似样件计算时的记录到达时点差异）确认后随基线一起收口；
+  ③ `fusion_38.csv` 无标准答案，需振动线给一份历史产出（或那四个脚本的源码）。
+
+
+
+---
+
+> 台账现状（2026-09-17）：✓ 呼应成立 1742 件 · ✗ 无生成端 285 件 · ◆ 人工件 209 件 · 无法验证 0 · 未归类 0。
+> 缺料自查：`python scripts/chain_gap_check.py --check`；取料单：`docs/向振动线取料单_v0.1.md`。
+
+### 7.5 `blade_1p_records` 的接续入口（本轮探到的确切起点）
+
+按"先啃运动学已确定的那件"继续，把下一次能接着做的入口探清楚了：
+
+| 事项 | 实测结论 |
+|---|---|
+| 覆盖范围 | 只两个测点：`Main_bearing_front` / `Main_bearing_rear`；662 行；时间 2026-01-27 11:35 ~ 2026-02-01 23:16（**w0127 首窗**，其索引在 `m5/tcm_index.parquet`，不在 `windows/w0127/`） |
+| 转速来源 | ★ 样件行的 `rpm` **不是**同一记录里 `Kurtosis` 行的 rpm：样件 `rpm=1601.0371`，而索引里 `trigger_time` 同一条的 `Kurtosis` 行 `rpm=1604.2537`。⇒ 1P 分析用的是**该记录自己的转速**（`RpmProfile` / `rawRPM` 那类），不是标量指标行带的转速。这条搞错，`f1P` 就对不上（速比 119.75 本身不变） |
+| 谱文件命名 | ★**更正**：`spectra/p<NN>/<meas_name>_n<lines>_<seq>.npz`（例 `FFT_4_Tr_n401_0000.npz`）；"记录 ↔ npz"**不需要靠枚举顺序去猜** —— `rudong_tcm_spectra.py` 落盘时已同时写出 `spectra_meta.parquet`（每行一条谱：turbine/sensor/meas_name/trigger_time/**shard/shard_row**/x_offset/x_delta），取数配方就是该脚本头部那句 `v = npz["values"][shard_row]; x = x_offset + arange(len(v))*x_delta`。本包新增 `scripts/spectra_lookup.py` 把它封成一条命令 |
+| 谱本身 | npz 内是幅值数组；频率轴由索引的 `x_offset`/`x_delta`/`lines` 给出（例 `FFT_16000: lines=400, x_offset=0, x_delta=40` ⇒ 40 Hz/线）⇒ 频率轴可算；`f1P=0.223 Hz` 落在**第 0 条线**上 —— 这正是"1P 在低频谱里极难分辨"的原因，也解释了为什么这一族要专门做（样件 `energy_pct` 只有 0.38%） |
+
+**下一次接手的最短路径**（三步，都在包内可做）：
+① ~~读枚举顺序建映射~~ **已完成**：映射本来就是产品（`spectra_meta.parquet`），本包已封装为 `scripts/spectra_lookup.py`（实测 `WTG01/Main_bearing_rear/FFT_4_Tr` → `spectra/p00/FFT_4_Tr_n401_0000.npz` 第 1 行，0.01 Hz/线，401 点）；
+② 用 `x_offset + i*x_delta` 重建频率轴，在 `f1P` 附近按候选口径（最近线 / ±2% 带内取最大 / 抛物线插值）取幅值，与样件 `a1P` 对拍；
+③ `a1P` 一旦对上，`struct`（疑似 `a1P / fleet` 归一分）、`energy_pct`、`g1/g2/g4` 闸门与 `verdict` 有望按同样办法逐个对拍。
+
+> 本轮到此为止的自我约束：**没有**在"峰值拾取口径未知"时硬写实现 —— 那样产出的数字无法证明是复现，只会给交付物掺进"看起来对"的东西。取料单里那**一句话**（或那四个脚本）到位后，上面三步当天可做完。
+---
+
+## 8. 1P 这一族的**本地阻塞点**（2026-09-17 查证）
+
+用户令"做①（查 1 月 decode 件在不在）"的结论：**不在**。
+
+| 查证项 | 结果 |
+|---|---|
+| `blade_1p_records` 时间跨度 | 2026-01-27 11:35 ~ 2026-02-01 23:16（**w0127 窗**） |
+| w0127 的索引 | **在**（随包件 `m5_cms_tcm/tcm_index.parquet`，330,308 行、2026-01-27 ~ 2026-02-03、含样件那批时间戳的 89 行记录） |
+| w0127 的**源件导出** | **不在**：`data/raw/如东/windcms/` 下只有 `CMS_RuDong_CGN_202603-04`（3–4 月）+ 厂家报告；`data/raw/如东/m5_cms_tcm/` 只有一份 docx |
+| w0127 的谱库 | **不在**（盘上只有 w0316 的谱：1,701 分片 / 420,742 条谱记录） |
+
+⇒ **1P 在本机无法重算**，缺的是**源件**，不是工具：索引在、查表工具（`scripts/spectra_lookup.py`）在、
+运动学口径（`f1P = rpm/(60×119.75)`）在、频率轴算法在 —— 独独缺 1 月的 decode 导出。
+这条已作为**第 7 项**加进取料单（`docs/向振动线取料单_v0.1.md` 第五节）。
+
+**也因此确认**：`oem_scan` 侧那 23 件（谱在盘上，w0316）**仍可在本地推进**，只要拿到峰值拾取口径；
+而 1P 那 662 行需要"口径 + 1 月源件"两样。两条路的先后可以按到料快慢决定。
+
+---
+
+## 9. `oem_scan` 侧的**分母已落地并逐值验过**（2026-09-17 收口）
+
+在"优先攻 oem_scan 侧"这一轮里，没有等口径就把**分母那一半**做完了，并且是**逐值对拍通过**的：
+
+### 9.1 扫描配置（机型常量）
+
+`reference/rudong/oem_scan_plan.json`（新增）—— 11 个部件各用哪条谱、什么分辨率：
+
+| 部件 | 测点 | shard | dx_hz |
+|---|---|---|---|
+| `generator_de_6338` / `generator_nde_6338` | `Generator_DE` / `Generator_NDE` | `Env_6000_4000_850_Tr` | 1.0625 |
+| `hs_generator_left` / `hs_generator_right_fag` / `hs_generator_right_nsk` / `hs_rotor` | `Gear_HS_generator_side` / `Gear_HS_rotor_side` | `FFT_6000_Tr` | 0.9375 |
+| `ims_generator_fag` / `ims_generator_nsk` / `ims_rotor` | `Gear_IMS` | `FFT_2000_fast_Tr` | 0.625 |
+| `main_front` / `main_rear` | `Main_bearing_front` / `Main_bearing_rear` | `FFT_62_Tr` | 0.03875 |
+
+（性质：**机型常量**，不是原始数据的函数；权威来源是那份随包件，故原样固化并注明来历。）
+
+### 9.2 理论频率（分母）的映射规则 —— 实测 **11/11 逐值一致**
+
+```
+option 串 → oem_bearing_freqs.json 条目：
+  ① 取位置 token：Pos.150R→150r ｜ 139.1/1060 f-576853.PRL→1391/1060 ｜ 6338 M/C3→6338m/c3
+  ② 同位置多候选时按型号 token 定夺（NSK 284 vs FAG 273；NSK 137 vs FAG 151 —— 两处都验到了）
+```
+
+`python scripts/rudong_tcm_oem_scan.py --verify-plan` ⇒ 11 个部件的 `BPFI_hz`/`BPFO_hz`/`BSF_hz`
+与 `dx_hz` **逐值一致（11/11，rc=0）**。
+
+### 9.3 新增 `scripts/rudong_tcm_oem_scan.py`：**分母就位、分子待口径，且拒绝半成品**
+
+- `--verify-plan` 对拍分母与配置；`--plan` 打印扫描计划；`--status` 输出机器可读状态；
+- **默认运行 rc=3 且不写盘** —— 理由写在脚本头：只写分母的那些件"看着像扫描结果、实则没有分子"，
+  产出半成品比不产出更危险（本项目一贯口径：允许响亮降级，不许造数）；
+- 口径到位后把脚本里 `PEAK_PICKING_READY` 翻成 `True` 即可接上（分子侧实现位置已标好）。
+
+### 9.4 顺带修掉的两处"真原因被顶掉"
+
+1. `src/windcms/pipeline.py::_run`：`text=True` 下 `stdout/stderr` 可能是 `None`，直接相加会抛
+   `unsupported operand type(s) for +: 'NoneType' and 'str'` —— 于是**真正的失败原因被这句无意义异常顶掉**
+   （实测：oem_scan 明确报了 rc=3 与缺什么口径，经壳调用后看到的是那句类型错误）。已改为 `(p.stdout or '') + (p.stderr or '')`。
+2. `scripts/chain_gap_check.py`：**脚本在位 ≠ 这一步能出产物**。现在会调各步的 `--status`，
+   把"部分实现"如实标成 `[部分]`（并列出缺什么），不再给"看起来齐了"的假结论。
+
+---
+
+## 10. 三张扫描表的**行骨架**：一张能从数据推、两张要口径（2026-09-17）
+
+`python scripts/rudong_tcm_oem_scan.py --skeleton-verify`（新增，窗 w0127 —— 样件与索引都在的那一窗）：
+
+| 键集合 | 样件 | 由包内索引推 | 交集 | 判定 |
+|---|---:|---:|---:|---|
+| `bearing_freq_scan` / `GEN_bearing` | 74 | 74 | 74 | 一致 |
+| `bearing_freq_scan` / `HS_bearing` | 74 | 74 | 74 | 一致 |
+| `cage_slip_scan` / 发电机DE（机组×分箱） | 83 | 282 | 83 | 样件是索引的子集 |
+| `cage_slip_scan` / 发电机NDE | 83 | 282 | 83 | 同上 |
+| `cage_slip_scan` / 高速轴 | 83 | 282 | 83 | 同上 |
+
+**结论（三种成分，必须分开说）**：
+
+1. **能由数据推（已验证）**：`bearing_freq_scan` / `gear_freq_scan` 的行骨架 = 窗 × 机组 × 4 个
+   (component, sensor) 组合，由索引里的 `turbine`/`sensor_name` 直接给出 —— w0127 上 **74/74 逐键一致**。
+   （两张表都是"每 (窗,机组) 恰好 4 行"，窗集合 6 个、每窗 35~37 台。）
+2. **要口径（已定量界住，2026-09-17 又追了一轮）**：`cage_slip_scan` 的键是索引的**子集**。
+   追加实测（建议②那一轮）：**保留键**在索引里的记录数 **112~1426**、时间跨度中位 **5,072 min**；
+   **未保留键**只有 **1~218** 条、跨度中位 **752 min** ⇒ 判据形态是"**该分箱是常态工况**"（记录足够多、
+   跨得足够久），而不是按单条记录挑。但样本 `n_rec` 只有 **2~7**，与该分箱的记录数**完全不是一回事**
+   ⇒ `n_rec` 统计的是**某种"可用记录数"**（疑为窄转速带内的稳态记录数）。结论：判据形态已明确，
+   具体阈值/定义仍需口径。以下是原描述：
+2. **要口径（已定量界住）**：`cage_slip_scan` 的键是索引的**子集**（w0127：样件 83 键/部件 vs 索引 282），
+   少掉的由**稳态段筛选**决定 —— 且样本自己的 `n_rec` 只有 **2~7**，与"该 (机组,测点,分箱) 在索引里的
+   记录数 47~1426"**完全不是一回事** ⇒ `n_rec` 统计的不是分箱记录数，而是某种"可用记录数"。
+   分箱本身**已知**：就是 `condition_key` 的 7 个功率分箱（`WPS-ActivePower 0-1600` … `3600-4400`，
+   `bin_idx`=0..6；实测 `bin ⊆ condition_key` 成立）。
+3. **只能从样件复刻**：**窗集合**（`w0127/w0707/w0711/w0724/w0805/w0811`）与"哪些窗有哪几台" ——
+   其余 5 窗的索引与谱库都不在本机（盘上只有 w0127 与 w0316 的索引、只有 w0316 的谱）。
+   取料单第 7 项的 1 月导出件只解决 w0127；要复现全部 6 窗，还需要 **w0707/w0711/w0724/w0805/w0811
+   这 5 个窗的 CMS 导出件**。
+
+---
+
+## 11. `oem_frequency_scan`：行骨架 + 分母列**已 2,420/2,420 逐值复现**（2026-09-17）
+
+`python scripts/rudong_tcm_oem_scan.py --verify-skeleton-oem`：
+
+```
+样件 2420 行 · 本器骨架 2420 行 · 同键 2420 · 仅样件 0 · 仅本器 0
+dx_hz / BPFI_hz / BPFO_hz / BSF_hz 逐值一致: 2420/2420
+三对 ratio 列: 本器非空 0 行（等口径填分子）· 样件非空 2420 行
+结论: 行骨架与分母列逐键逐值一致（只差 ratio 三对列的分子）  rc=0
+```
+
+**行骨架** = 6 窗 × 每窗 37/37/37/37/37/35 台 × 11 个部件 = **2,420 行**（每 (窗,机组) 每部件 1 行）。
+其中**分母列**（`dx_hz` + `BPFI_hz`/`BPFO_hz`/`BSF_hz`）来自 `--verify-plan` 验过的映射（11/11）。
+
+**性质标注（不许混）**：窗集合与每窗机组集**复刻自样件**（写进 `oem_scan_plan.json` 的 `row_skeleton.note`）——
+那 5 个窗（w0707/w0711/w0724/w0805/w0811）的索引与谱库都不在本机，所以这一节**不是**"由 data/raw 推出"，
+要真由数据推出需取料单第 8 项的 5 窗导出件。**比值三对列（分子）留空**，等那一句峰值拾取口径。
+
+**至此 `oem_frequency_scan` 的成分账**：配置 ✅ · 行骨架 ✅（复刻，可对拍）· 分母 ✅（11/11）·
+**分子 ⭕（唯一开口）**。
+
+---
+
+## 窗数口径与拒判条件（2026-10-06 P1）
+
+**窗数口径（2026-10-06 P1 明文）**：持续性门与窗覆盖门的分母 = `max(4, ceil(2N/3))`（N=窗数）：N≤6 恒为 4（与历史口径逐位一致）；N=7/8 ⇒ 5/6；**N=9 ⇒ 6**。分母只增不减，故**任何窗数下都不会比历史口径更宽松**。
+**单窗/少窗拒判（硬条款）**：N<3 时**不得**用「持续性」「逐窗趋势」类判据出个体结论；此类信号只能标注为「**窗内周段趋势（单窗补充口径，仅参考不作判据）**」（与 `app_ETL/.../component_history_build.py` 的既有降级口径同源）。
+**不得静默丢窗**：谱窗与"仅标量/原厂状态"窗在 pipeline 中**分列**呈现，缺窗必须显式进入盲区，不得被埋进健康结论。
+
+**出处（观澜自身证据）**：持续性门 `app_ontology/app_ontology_guanlan/sop/vib_confidence.py::score_internal`；窗覆盖门 同文件 `::score_sample`（新增 `n_windows` 形参）；逐日持续（另一轴）`app_algorithmModel/app_algorithmModel_guanlan/windcms/report_std.py`（类型枚举 + `n_high_days_all >= 3`）；既有单窗降级先例 `app_ETL/app_ETL_guanlan/builders/component_history_build.py`（窗数<3 ⇒ 自动降级；"单窗补充口径，仅参考不作判据"）。
+
+**当前实况**：窗数 = **1**（`baseline_38_build.py:41`「本机实况只有 w0316 一窗」；`component_history_build.py:34`「只解析出一个窗」）；融合产物自述「单窗数据时"逐窗趋势"信息量有限（按日聚合后可见）」。