Browse Source

2.94.0 ①②③④: ①C02 接线交付 sop/hysteresis_wire.py(31 序列/6 条被原厂迟滞改变, 全为 hs_rotor·BPFO); ②§5-3 事实证实(RedHysteresis 分布 {3:3330, 100:30}, TrendAlarm 用 100 => 推翻"恒 3"); ③融合面多窗受护栏阻挡(fusion_run 需 w0127 首窗; handoff 为振动线正本拒绝覆盖, 未用 --force; 已先备份 9 文件); ④半周窗(~9 窗)后台构建中(pid 49520) => 门将升为 6

zhouyang.xie 4 days ago
parent
commit
a3f13299ad

+ 1 - 1
VERSION

@@ -1 +1 @@
-2.93.0
+2.94.0

File diff suppressed because it is too large
+ 3 - 1
app_common/app_common_guanlan/version.py


+ 63 - 0
app_ontology/app_ontology_guanlan/sop/hysteresis_wire.py

@@ -0,0 +1,63 @@
+# -*- coding: utf-8 -*-
+r"""★C02 接线(用户令 2026-10-06):把**逐窗 level 序列**从多窗 L6 结果里生成,并过原厂迟滞规则。
+
+背景:`sop/fusion_diag.py::apply_hysteresis(window_levels, h=3)` 早已存在(厂商 Hysteresis=3 的通用化:
+连续 h 窗同向才改级,否则保持),但**一直缺入参** —— 全窗裁决不产生"逐窗 level 序列"。
+本模块补上生产端:`outputs/rudong/m5_cms_tcm/model_run_l6.parquet` 现在带 `_窗`(5 个周窗)⇒
+同一 (台, 线) 跨窗的 `定级` 即序列。
+
+口径(如实):
+- 级别序:`候选·新发`(3) > `候选`(2) > `参考`(1);未在该窗过闸 ⇒ 该窗**无记录**(不补 0,序列只含实际过闸的窗)。
+- 迟滞由 `fusion_diag.apply_hysteresis` 执行(**不改写它的语义**);本模块只负责喂序列与呈现。
+- 用途:**诊断/呈现**(显示锁存);未接入任何判级,除非用户下令。
+"""
+from __future__ import annotations
+
+import pathlib
+
+RANK = {'候选·新发': 3, '候选': 2, '参考': 1}
+
+
+def window_level_sequences(path=None) -> dict:
+    """返回 {(台, 线): [(窗, 定级, 级别int), ...]}(按窗升序;只含实际过闸的窗)。"""
+    import pandas as pd
+    p = pathlib.Path(path) if path else pathlib.Path(__file__).resolve().parents[3] / \
+        'outputs/rudong/m5_cms_tcm/model_run_l6.parquet'
+    if not p.exists():
+        return {}
+    df = pd.read_parquet(p)
+    if '定级' not in df.columns or '_窗' not in df.columns:
+        return {}
+    df = df.assign(lv=df['定级'].map(lambda x: RANK.get(str(x), 0)))
+    out = {}
+    for (t, line), g in df.groupby(['台', '线']):
+        s = g.sort_values('_窗')
+        out[(str(t), str(line))] = [(str(w), str(lv), int(i)) for w, lv, i in zip(s['_窗'], s['定级'], s['lv'])]
+    return out
+
+
+def latched(path=None, h: int = 3) -> dict:
+    """对每条序列执行原厂迟滞;返回 {(台, 线): {"raw": [...], "latched": [...], "changed": bool}}。"""
+    from . import fusion_diag as FD
+    out = {}
+    for key, seq in window_level_sequences(path).items():
+        levels = [x[2] for x in seq]
+        try:
+            res = FD.apply_hysteresis(levels, h=h)
+        except Exception as ex:      # 实现异常不得静默: 如实带出
+            out[key] = {'err': type(ex).__name__ + ': ' + str(ex)[:80], 'raw': levels}
+            continue
+        lat = res[1] if isinstance(res, tuple) and len(res) > 1 else res
+        out[key] = {'raw': levels, 'latched': list(lat) if hasattr(lat, '__iter__') else lat,
+                    'changed': list(lat) != levels if hasattr(lat, '__iter__') else None}
+    return out
+
+
+def summary(path=None, h: int = 3) -> dict:
+    d = latched(path, h)
+    n = len(d)
+    ch = [k for k, v in d.items() if v.get('changed')]
+    err = [k for k, v in d.items() if v.get('err')]
+    return {'n_seq': n, 'n_changed': len(ch), 'changed': [('%s/%s' % k) for k in ch[:10]],
+            'n_err': len(err), 'h': h,
+            '口径': '原厂迟滞 Hysteresis=3:连续 3 窗同向才改级;序列只含实际过闸的窗'}

+ 1 - 1
docs/detail_页面依赖与重算台账_v0.1.md

@@ -6,7 +6,7 @@
 <!-- DETAIL-DEPS:BEGIN -->
 # /detail 页面依赖与重算台账 (自动生成, 禁手改)
 
-> 生成端: `python scripts/detail_deps.py --write`|场站 `rudong`|产物仓 `outputs/rudong`|盘上 5,770 件
+> 生成端: `python scripts/detail_deps.py --write`|场站 `rudong`|产物仓 `outputs/rudong`|盘上 5,933 件
 >
 > 用户令 (2026-09-18): **/detail 各页面不许用旧版产出补**, 只能参照旧版产物的呈现样式与内容, 数值必须由 `data/raw` 重算。本表把每页的取数接口与产物件逐条列清, 缺的写明怎么补。
 

+ 1 - 1
docs/src/数据要求说明_观澜_2.93.0.md → docs/src/数据要求说明_观澜_2.94.0.md

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

+ 10 - 10
docs/src/系统设计说明_观澜_2.93.0.md → docs/src/系统设计说明_观澜_2.94.0.md

@@ -1,4 +1,4 @@
-# 系统设计说明 · 观澜 v2 风电场智能分析系统 · 版本 2.93.0
+# 系统设计说明 · 观澜 v2 风电场智能分析系统 · 版本 2.94.0
 
 ## 1 文档说明
 
@@ -6,19 +6,19 @@
 
 ### 1.1 目的与范围
 
-本文是"观澜 v2(风电场智能分析系统)"(海上风电场智能分析离线系统)的设计说明(下称"本系统"),面向版本 2.93.0;内容以样本风电场(下称"本场")为依据,样本场实测日期为 2026-09-22,说明本系统"由哪些部分组成、各部分怎么实现、数据从哪来到哪去、判据写在哪里、怎么验证、边界在哪里"。
+本文是"观澜 v2(风电场智能分析系统)"(海上风电场智能分析离线系统)的设计说明(下称"本系统"),面向版本 2.94.0;内容以样本风电场(下称"本场")为依据,样本场实测日期为 2026-09-22,说明本系统"由哪些部分组成、各部分怎么实现、数据从哪来到哪去、判据写在哪里、怎么验证、边界在哪里"。
 
 本文覆盖十五个设计面:总体架构与分层、目录结构与路径真源、数据接入与重算链、判级与算法、时间窗口径、服务与前端、本体与知识层、本机模型接入、运维控制台与重算编排、安装与服务化与版本管理、质量保证、安全与离线边界、可移植性与资源占用、多场适用性与换场迁移、已知边界与未实现。
 
-本文不重复需求条目本身(那是《需求分析_观澜_2.93.0.docx》的职责),也不重复操作步骤的逐步手册(那是 docs/重算操作手册_v0.1.md 与《使用说明书》v0.2(随包 docs/)的职责);本文只回答"设计上为什么这样、落在哪个文件的哪一处、用什么机器守卫保证它不漂移"。
+本文不重复需求条目本身(那是《需求分析_观澜_2.94.0.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.93.0.docx》的对应关系
+### 1.3 与《需求分析_观澜_2.94.0.docx》的对应关系
 
-需求分析写"要什么、为谁、优先级与验收门",设计说明写"怎么实现、落在哪、如何自证"。两文的章节对应关系如表 1-1 所示;与《数据要求说明_观澜_2.93.0.docx》的数据侧口径去向见 16.6 节。
+需求分析写"要什么、为谁、优先级与验收门",设计说明写"怎么实现、落在哪、如何自证"。两文的章节对应关系如表 1-1 所示;与《数据要求说明_观澜_2.94.0.docx》的数据侧口径去向见 16.6 节。
 
 | 本文章节 | 需求分析对应章 | 对应关系说明 |
 |---|---|---|
@@ -41,7 +41,7 @@
 
 ### 1.4 口径与依据
 
-本文所有数字来自仓库文件或命令的实跑输出,不采用估算与推测;查不到、未实现的,一律写"未取证"或"未实现",并在第 17 章汇总。本文中"本次实测"与各表"实测"列一律指样本场实测(2026-09-22):即在样本风电场的一套实例上的一次实跑,换场后这些数字会变、方法与口径不变。版本号的唯一真源是 src/version.py 的 VERSION 常量,本版为 2.93.0;打包文件名由 src/version.py 的 package_name() 给出,为 app_guanlang_v2.93.0.zip。
+本文所有数字来自仓库文件或命令的实跑输出,不采用估算与推测;查不到、未实现的,一律写"未取证"或"未实现",并在第 17 章汇总。本文中"本次实测"与各表"实测"列一律指样本场实测(2026-09-22):即在样本风电场的一套实例上的一次实跑,换场后这些数字会变、方法与口径不变。版本号的唯一真源是 src/version.py 的 VERSION 常量,本版为 2.94.0;打包文件名由 src/version.py 的 package_name() 给出,为 app_guanlang_v2.94.0.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.93.0,因此它正是"安装前检查会提示版本差异"的活样本;重装或升级后会随之更新。
+安装记录 install-info.json 是"这台机器装的是哪一版"的唯一凭据,字段如表 12-3 所示。装完写、卸载时删(删掉等于这台机器回到"没装过")。需要如实指出:本机该文件记录的版本是 2.5.0(装于 2026-09-17),落后于当前代码版本 2.94.0,因此它正是"安装前检查会提示版本差异"的活样本;重装或升级后会随之更新。
 
 | 字段 | 含义 |
 |---|---|
@@ -1030,7 +1030,7 @@ Windows 安装入口是 install.bat 与 install.ps1,步骤号写死在输出
 
 ### 15.2 Python 与依赖 wheel
 
-解释器要求是 3.11 及以上(依赖 pandas 3,3.10 及以下没有轮子);机器上没有 3.11 时使用包内便携运行时(3.12.14,三个平台各一份)。依赖清单共 174 条固定版本: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,三个平台各一份)。依赖清单共 175 条固定版本: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.93.0.docx》第 11 章(场配置化、机组与机型可替换、数据源形态可适配、阈值按场标定、术语与单位可配、跨场统一口径、按场裁剪收资、换场验收检查表)与《数据要求说明_观澜_2.93.0.docx》第 12 章(通用必选与可选的判定规则、场配置字段对照、数据源形态适配、换场收资差异清单、按场裁剪步骤);本章给的是设计侧的落点、换场作业单与检查表,数据侧的收资口径与字段要求以数据要求说明为准,需求侧的验收项以需求分析为准。
+本章对应《需求分析_观澜_2.94.0.docx》第 11 章(场配置化、机组与机型可替换、数据源形态可适配、阈值按场标定、术语与单位可配、跨场统一口径、按场裁剪收资、换场验收检查表)与《数据要求说明_观澜_2.94.0.docx》第 12 章(通用必选与可选的判定规则、场配置字段对照、数据源形态适配、换场收资差异清单、按场裁剪步骤);本章给的是设计侧的落点、换场作业单与检查表,数据侧的收资口径与字段要求以数据要求说明为准,需求侧的验收项以需求分析为准。
 
 ***
 
@@ -1290,7 +1290,7 @@ Linux 侧的适配程度如表 15-4 所示,全部为"已有实现但在本次
 
 | 章节 | 来源文件 |
 |---|---|
-| 1 文档说明 | src/version.py(VERSION 与 HISTORY 的 2.59.0 条目)、docs/需求分析_观澜_2.93.0.docx、scripts/delivery_docs_figures.py |
+| 1 文档说明 | src/version.py(VERSION 与 HISTORY 的 2.59.0 条目)、docs/需求分析_观澜_2.94.0.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(路径约定与统一记录)、本次目录实测 |

File diff suppressed because it is too large
+ 9 - 8
docs/src/需求分析_观澜_2.94.0.md


BIN
docs/数据要求说明_观澜_2.93.0.docx → docs/数据要求说明_观澜_2.94.0.docx


File diff suppressed because it is too large
+ 3 - 3
docs/版本记录.md


BIN
docs/系统设计说明_观澜_2.93.0.docx → docs/系统设计说明_观澜_2.94.0.docx


BIN
docs/需求分析_观澜_2.93.0.docx → docs/需求分析_观澜_2.94.0.docx


Some files were not shown because too many files changed in this diff