guanlan-src/docs/版本记录.md

版本记录（观澜·如东样板 v2）

本文件由 scripts/version_log.py 生成，勿手改：事实（版本号、级别、变更）写在 src/version.py 的 HISTORY 里，改完跑 python scripts/version_log.py --write。 guanlan.py check 与打包器都会校验本文件与代码里的版本号是否一致。

版本号规则（用户令 2026-09-17）

编号 v<大版本号>.<中版本号>.<小版本号>，例如 v2.10.1。

级别	含义
大版本号	系统解决方案、架构或核心功能改变
中版本号	非核心功能新增、减少、修改
小版本号	消缺完善

怎么改：改动落在"解决方案/架构/核心功能" → 大 +1（中/小归 0）；落在"非核心功能的新增/减少/修改" → 中 +1（小归 0）；只是"消缺完善" → 小 +1；一次发布混了几类，取最高那一级

打包文件名 = app_guanlang_v2.10.1.zip（规则：app_guanlang_v<版本号>.zip）。

版本号只写在 src/version.py 一行（VERSION = '2.10.1'）；打包器、安装脚本、安装记录 install-info.json、自检都读它，不另设真源。

版本	日期	级别	主要变更	说明
v2.10.1	2026-09-22	小	交付文档对外版：去样本场标识（全文不体现具体风电场）+ 新增多场适用性章节	纯交付物修订（系统功能未变）⇒ 小版本 +1。用户令: 「修改三份文档，内容参考如东风电场，但不体现如东风电场，且具有不同风电场适用性」。做法: ① 去标识化（中文与罗马化形态一并去）: 场名/业主/地域/OEM/第三方机构/系统名里的样本场代号一律换成中性表述（样本风电场 / 本场 / 业主单位（从略）/ 主机制造商（OEM，名称从略）/ 4.0 MW 级海上机组（机型代号从略）/ 观澜 v2（风电场智能分析系统））；路径写成模板（data/raw/<场站>/…、outputs/<场>/…、reference/<场>/…、configs/contracts/<机型>_<场>.yaml、configs/farms/<场>.yaml、WINDSCADA_FARM=<场>），并在「编写依据」表下写明占位符替换规则；实测数字与结论全部保留，标注「样本场实测（2026-09-22）」。② 多场适用性（用户令第二句）: 需求分析新增第 11 章（FR-44…FR-52 + NFR-12: 场配置化、机组与机型可替换、数据源形态可适配、阈值按场标定、术语与单位可配、跨场统一口径、按场裁剪收资、换场验收检查表）；设计说明新增第 16 章（场抽象层与配置 schema、场无关引擎 vs 场相关参数分层表、换场作业单与检查表、接新 OEM/新数据形态的扩展点、换场会失效的假设如实列）；数据要求说明新增第 12 章（通用必选/可选判定规则、场配置字段对照、数据源形态适配、换场收资差异清单、按场裁剪步骤）。③ 去标识化做成机器可查的硬门（不靠人自觉）: scripts/delivery_docs_build.py 增 FORBIDDEN 词表并在 --check/--verify 里逐份扫描（命中即报 FAIL），guanlan.py check 的「交付文档三件」门同步带上该扫描；图表器里出现的样本场字样一并中性化（图题写「样本场实测」）。验证: 三份 markdown 源件与 docx 对 12 个禁用词 0 命中；delivery_docs_build --verify rc=0；guanlan.py check 全绿；三份 docx 与插图重渲，图表数字仍与正文同源（图解析文档表）。
v2.10.0	2026-09-22	中	交付文档三件（需求分析 / 设计说明 / 数据要求说明）与源代码化生成器	非核心功能新增（交付物）⇒ 中版本 +1。用户令: 「整理观澜的需求/设计/数据接入，各写一份 Word 文档，要求区分章节目录、文表图并茂、字体字号分类统一；数据要求说明结合现场《数据分析收资要求-v3.docx》」。① 新增三份交付文档（落 docs/，文件名带本版本号）: 需求分析_观澜_2.10.0.docx（需求来源与演进、角色场景、功能需求 FR、非功能需求 NFR、页面与信息架构、验收门、需求跟踪矩阵）、设计说明_观澜_2.10.0.docx（总体架构、目录与路径真源、重算链、判级与算法、时间窗口径、服务与前端、本体与模型、运维编排、安装与版本、质量保证、安全与边界、可移植性）、数据要求说明_观澜_2.10.0.docx（数据分类总表、逐类要求、核心测点/字段/单位/必须性、质量与对齐、落位流程、收资要求 v3 的 21 项逐条对照、缺失与替代、核对锚点、面向现场的收资清单）; ② 两份源件均源代码化（用户令「所有的计算均要形成观澜的源代码」）: scripts/delivery_docs_build.py 把 docs/src/*.md 渲染成 docx（Word 域目录 + 标题/正文/表格/图题四级字体字号分类统一: 黑体标题 + 宋体正文小四 + 表格五号 + 图题五号居中, 页眉页脚页码, 附录排版规范）; scripts/delivery_docs_figures.py 生成 14 张插图, 每张图的数字都从真件取: src/version.py 的 HISTORY、configs/portal_pages.yaml、configs/serve.json、data/raw/<场>/**、outputs/<场>/**、并落 guanlan.py check 与 rebuild_all.py --dry-run 的实跑底稿到 docs/src/_*.txt（可复核）; ③ 文档口径遵循用户令 §17: 含"窗"且指时间窗口写全"时间窗"、影响机组写"影响机组数"、英文简写写"中文（英文简写）"（平均无故障间隔（MTBF）/平均停机间隔（MTBO）/单次停机时长（MDT））; ④ 不确定与缺件一律如实写（测风塔零交付、m5_cms_tcm 正本缺失由观澜自算件顶上、故障录波仅 4 台、远端未装 Ollama），不编造; 每份文档附「编写依据」表逐章列出源文件; ⑤ guanlan.py check 增一行「交付文档三件 · v<版本>」: 校验三份 docx 在位且文件名含当前版本号、markdown 源件与所引插图都在位 —— 否则升一次版本号, 旧文档名就悄悄过期（同名旧版会跟着进包）; ★2026-09-22 用户令「三份文档不同步到远端服务器」⇒ 该行先看 docs/src 在不在: 不在 = 本机是不随文档的部署（远端演示机即此），只报提示行、不 FAIL，且在 import python-docx 之前分流（那台机未装该依赖，直接进渲染器会炸成 ModuleNotFoundError）。
v2.9.2	2026-09-22	小	升级后验收补缺：版本/文档漂移有了自动拦截点（重算链增 ⑧d 版本记录门）	纯消缺 ⇒ 小版本 +1。检查: 远端 2.9.1 升级 + 重算完成后跑 guanlan.py check，出现两处 FAIL —— ① docs/版本记录.md 与 src/version.py 不一致（version_log rc=6）；② 安装根多出 _pre290_backup/（16 件扁平旧副本）让 config_audit rc=8。根因: 这次升级的差异盘点只覆盖 src/+scripts/+configs/（remote_src_inv.py），文档从不在盘点面上 ⇒ 代码升到 2.9.1、文档留在旧版（版本记录 13,277 vs 21,284 字节、系统设计说明缺 §17）；而重算链里没有版本门（rebuild_all 只到 ⑧c 页面归口审计），于是 24/24 步全 OK、控制台写"重算完成"，漂移照样静默过关 —— 没有任何自动拦截点。解决: ① scripts/rebuild_all.py 增「⑧d 版本记录一致性」（version_log.py --check，tolerate=(6,) —— 与 ⑧c 同口径: 缺的是"文档同步"这一路，报出来但不打断整条链）；② 远端补齐 4 份文档（版本记录/系统设计说明/输入数据放置指导/detail 页面依赖台账），逐件 sha256 与本地一致；③ 远端把 _pre290_backup 移出安装根到 D:\产品\_pre290_backup_20260921（备份保留，不删除）。验证: 远端 version_log.py --check rc=0、config_audit.py rc=0；本地 guanlan.py check 全绿 + 反向审计/页面归口/chain_gap 全 rc=0。遗留（如实记录，未处理）: 远端没有装 Ollama（无二进制、PATH 无、11434 拒绝连接）⇒ 本机模型探针在远端必然 FAIL，问答/升档类功能在远端不可用；要不要在远端装 Ollama 与拉哪几档模型，等用户定。
v2.9.1	2026-09-22	小	人工测试 7 项消缺（描述口径 + 依据空白 + 问题页空 + 门户链接 404 + 闭环文案 + Ollama 档位）	纯消缺（无功能增减）⇒ 小版本 +1。逐项「检查→根因→解决→验证」: ① 描述口径: 「窗」确实指时间窗者一律写「时间窗」（预设窗→预设时间窗、判级窗→判级时间窗、窗内→时间窗内、证据窗→证据时间窗、随所选窗→随所选时间窗…；天气窗/作业窗/预览窗/观测窗属领域词，保持原样）；「影响台」→「影响机组」（含报告构建器表头）；英文简写改「中文（英文简写）」（平均停机间隔（MTBO）/平均无故障间隔（MTBF）/单次停机时长（MDT）），英文映射键同步; ② 需要关注「查看完整依据」空白: 根因=行的来源是融合面链盘(d.fus.链盘.rows)，依据却只从 SCADA 的 d.watch 查 ⇒ 两边机组集合不同时 why[t] 为空（实测 WTG09 齿轮箱 bad 台）。改为按本行字段自组句（部件/链路进度/卡在哪步/证据源），永不空; ③ 报警机组「该问题页」打开空白 + ⑤ 命中系统链接: 根因=链接传slug（pitch）而页面/接口按中文系统名取数 ⇒ /api/problem 返回 0 条，页面还写"该系统在判级窗内无非常态"（对报警机组是假陈述）。改为: 链接传中文名 + 服务端 sys_norm() 双向归一（slug/中文/大小写都认）+ 页面区分"系统标识无法识别 / 本时间窗无异常"两者，绝不把认不出说成正常; ④ /turbine 页「返回观澜门户」→ 原写死 http://127.0.0.1:18084/观澜_如东样板_门户_单文件.html（用户机器上等于访问自己的 loopback，且该文件服务端没有）⇒ 网关回 not found。修法: 用根相对 /，并给网关加 data-abs="1" 豁免（作者显式声明某链接不按组件前缀改写，否则根相对链接一律被改写成 /detail/… 永远回不到门户），普通链接前缀行为不变（有单测）; ⑥ 振动「端到端闭环」文案: 去掉内部黑话 handoff，改为「暂无端到端闭环证据：现场提交的振动数据包里没有「报警→检修→复测」的成对记录」; ⑦ 观澜↔本机 Ollama: 链路实测可用（探针 OK、/api/ask 提交成功、8B 出答但未过校闸→触发升档），但升档目标硬编码在 src/ontology/fast_agent.py 的 ESCALATE（写的是本机没装的 qwen3.8:27b，configs/models.json 只是同处笔误的另一份）⇒ 升档 digest=None、ask 终态 error（用户只看到"复核中"）。修法: ESCALATE 改 qwen3:32b + 新增 installed_models()/escalate_target() —— 升档目标按「配置档位且确已安装」解析，没装则响亮回落并打日志，不再把答案静默卡死；初答文案里的"27B"改为实际目标名；BUDGET_S 随档位更新（32B 给 120 s）。验证: escalate_target("qwen3:8b") → qwen3:32b（本机实装 4 档实测）；另: 远端 106.120.102.238 与本地各跑一遍 HTTP 抽样（门户链接=/、slug 归一出 1 条问题、文案含时间窗/影响机组/（MTBO）、闭环新文案、WTG09 依据不再空），网关改写 data-abs 豁免单测通过，config_audit/pages_audit/反向审计/raw_scan selftest 全 rc=0，guanlan.py check 全绿
v2.9.0	2026-09-21	中	时间窗真正生效（用户令）：「部件问题」与「发电性能」随所选窗重算，并新增自定义起止日期窗	功能增减改 ⇒ 中版本 +1。要点: ① 窗口词表新增自定义起止日期（YYYY-MM-DD~YYYY-MM-DD，含两端）：months_of() 取相交月、新增 win_range()/in_win() 供日粒度件做含端过滤；v2 顶栏加两个日期输入框 + 应用（校验 a≤b），月度件按所跨月取整、日粒度件按日精确，页上写明; ② 判级四轴按窗重算：taxonomy.system_matrix(span=…) 把窗透到 变桨(日粒度件切片, 精确)/偏航/蓄能/温度(走新窄仓重算)；reliability.overview(span=…) 让部件可靠性表按窗；温度面的 ref/ref_sm 对照窗仍固定（季节解耦基线，跟着漂就失去对照意义）; ③ 发电性能按窗：/api/curves?win= 七镜头按窗重算 + 7 张月度时序图按窗过滤；选到 2025-07~2025-12（限电前干净判别窗）时直接用正式产物不重算；④ 新产物 windscada/slim10min/*（公共列子集，不裁剪行）作按窗重算底座：一次全量扫≈2 分钟，把"每换一个窗重读 15 GB"降到秒级；已进重算链 ③b 并登记反向审计族表; ④b M9 控制参数一致性（就摆在发电性能页上）此前仍钉死 2025-H2 ⇒ control.registry(span=…) 按窗重算（窄仓补 grd_wtc_ActPower_max/tur_wtc_GenRpm_max 两列 ⇒ 48 列；≈0.6 s/窗，P封顶中位 4190(干净窗) → 4181.7(2026年) / 4177.5(2026Q1)），fleet 响应加 m9_pending/win_pending 并由页面轮询（5 s）—— 至此判级四轴 + 可靠性 + 控制参数 + 七镜头 + 7 张月度图全部随窗；远端两窗对比只剩 all_months/note/*_pending 三个元数据键不变; ⑤ 按窗重算一律"后台算+进程缓存"（判级≈25 s/窗、镜头≈10~45 s/窗）：命中即回，未命中先回 pending/building 并由页面轮询，不静默拿旧口径当新窗；启动时后台预热 6 个预设窗（判级+默认窗镜头）; ⑥ 实测（本机 38 台）: 判级逐系统报警台数随窗变（变桨 15/13/10、偏航 15/11/5、齿轮箱 7/4/4 对应2026年/2025H2/2026-07），曲线图注窗=所选窗且样本量随窗变；验收: 反向审计 3548 件 0 未归类、pages_audit/detail_deps/config_audit/raw_scan(selftest,rc=0)/chain_gap 全绿；⑦ 远端部署（D:\产品\app，2026-09-21）实逮两处并已修: (a) 预热与请求各自起线程 ⇒ 同时算两份按窗中间帧，改为重活全局串行（_HEAVY_LOCK）并打印可用内存；(b) 退化窗（"近30日"=2026-09只有 1 个节拍 ⇒ 比档件为空）时 groupby().apply() 返回空表 ⇒ .rename("dev_K") 抛 TypeError 把整面判级打断，改为如实"不可判(样本不足)"；另: 远端进程须由 Windows 服务 guanlan 托管（SSH 会话里起的进程会随会话关闭而死，实测全端口消失 ⇒ 已装服务并 RUNNING），远端核验: fleet 两窗 pending→就位、变桨报警 15→7 / 偏航 15→3、rel 窗随窗、curves 图注"窗 2026-07-01 ~ 2026-07-31 (随所选窗)"、v2 页含自定义起止控件
v2.8.2	2026-09-21	小	消缺：扫描器的"变化"判据被两类非摄入件常年占住 —— 现场按类目交付的月度通道组库（scada_mdb/<年>年/<月>月/<年>-<月>-<类>.mdb）被当成"数据没人读·缺口"，用户指定的按月提取件（<场站>/scada_10min_<YYYYMM>.csv）被当成"未归类"；两者每次扫描都计一次变化 ⇒ raw_scan --check 永远 rc=4，rebuild_all.py --auto 与 raw_watch 会每轮都以为来了新数据	纯消缺（无功能变化）⇒ 小版本 +1。要点: ① CONSUME 新增 upstream 口径（信息级）：类目库是 10min 同台补充件的上游，取数层不直接读它 ⇒ 不再算缺口、不计变化，改按"上游归档件（要先转换才被消费）"列出并写清转换口径; ② 新增 IGNORE_PATTERNS：scada_\d+min_\d{6}\.csv 是按月提取/核对件（位置由用户指定、不是摄入源）⇒ 不报未归类、不计变化；③ 实测（2026-09-21 落位 7-8 月交付后）：修前 --check rc=4 且每轮都报"2 处变化"，修后 --check rc=0「与上次快照一致，没有新数据」，--selftest 通过，24 件类目库如实以信息级列出; ④ 口径写进 docs/输入数据放置指导_v0.1.md §4.1（含 12 组中文目录↔类目码、9 类↔主件 595 通道一一对应、float32+ISO 对齐、以及"类目库→同台补充件"的落位转换）
v2.8.1	2026-09-20	小	消缺：重算链末步「台账等价验收」在全新机器上必然 rc=5（交付包不含产物 ⇒ 没有随包基线），原先把它判成失败 ⇒ 门户上写"重算失败"（实测服务器 2.8.0 一轮 24/24 步全 OK 却整轮 rc=1）	纯消缺（无功能变化）⇒ 小版本 +1。要点: ① rebuild_all.py 的 ⑧ 台账等价验收由 tolerate=(4,) 改成 tolerate=(4, 5) —— rc=5 = "找不到随包基线 ⇒ 没做验收"，与 ④ 的口径对齐（④ 一直容忍 5 并写明"跳过等价验收≠通过"）；步名与步说明都改写清楚"rc=4 = 有需人工看的差异 / rc=5 = 没基线 ⇒ 没验收（不是失败，也不是通过）"，并指路 scripts/set_baseline.py（用已核实的当前产物快照登记基线，之后这一项才会真比对）; ② 远端复核（服务器 D:\产品\app）: 该轮 24 个实质步骤全绿（①b 扫描 53.7s · ② 164s · ③ 1025s · ④ 99s · ④b 2118s · ④c 385s · ④d 41.6s · ④e 15.3s · ⑤b/⑤c/⑤a/⑤ · ⑥ · ⑦×6 · ⑦b 78s · ⑧ 7.1s · ⑧b 3s · ⑧c 9.5s），只有第 25 步判失败；且同批数据已真进产物：temp_monthly 21 个月、末四格 2026-06/07/08/09、2026-08 = 1,026 行（服务器 scada_10min 也有 76 件含 38 个 WTG??-B2.csv 同台补充件，说明步骤 B 的同台多件合并已在服务器上生效）; ③ 已把修好的 scripts/rebuild_all.py（+ src/version.py / docs/版本记录.md）单文件部署到服务器，无需重装整包。交付包 app_guanlang_v2.8.1.zip
v2.8.0	2026-09-20	中	输入数据自动扫描识别：<安装目录>/data/raw 逐族指纹 → 发现新增/变化 → 指明该跑哪几步；重算链加 ①b 步 + rebuild_all.py --auto（新数据不被 --skip-* 漏掉）+ 服务侧可选看门狗	非核心功能新增 ⇒ 中版本 +1（无架构改动）。要点: ① 新增 scripts/raw_scan.py（用户令 2026-09-19「对 <安装目录>/data/raw 目录下的接入数据处理，增加自动扫描识别机制，以能发现新增数据，并纳入重算」）：逐族指纹 = 件数/体积/最新落盘时间/清单摘要（--deep 再叠内容哈希），与快照 outputs/<场>/_raw_scan.json 比；rc: 0 无变化 · 4 有新增/变化 · 5 还没有基线; --write 记基线, --json 给机器读, --selftest 对账"族表覆盖反查族表里所有 raw 输入 + 步骤名都能在链上找到"（防两处漂移）; ② 族表把每个 raw 子目录映射到链上步骤（故障报警/工单/油样→②；scada_10min→③④④c⑤b；scada_1min→④c；scada_mdb→③④④c；windcms→④b④d④e；m5_cms_tcm→④b；西门子4.0技术资料→⑦），data/raw/<场>/ 下出现族表没有的目录则如实报"未归类、没有已知消费者"（不猜）; ③ 进重算链作 ①b 步（--check --write，容忍 rc=4/5，并在步说明里写清"4 = 有新数据不是失败"）; ④ rebuild_all.py --auto：先扫一遍，新数据落在被 --skip-scada/--skip-vib 跳过的族里就自动取消跳过（实测: scada_10min 新增 1 件 → 计划从 22 步变 24 步并打印取消原因）; ⑤ 服务侧看门狗（scripts/service_worker.py::raw_watch，配置 configs/serve.json 的 raw_watch，默认关）：每 N 分钟扫一次，有新数据写 logs/service.log 并列出该跑的步；auto_rebuild=true 时顺手发起一次重算（走 ops 同一条路；run/ops_job.json 显示在跑则不重复发起）。★2026-09-20 按用户令「对 data/raw（含嵌套子目录）下文件的增减做到监听；重算要按该目录最新的变化算」逐条查证并补了三处: ⑥ 扫描改成递归统计全部文件(不限扩展名; 白名单命中的另记 matched, 差额单列为"信息，不计变化")+ 子目录清单进指纹(新建空目录也发现) + 未归类改成全树逐件找(不再只看一层); ⑦ 产物 = 当前源件的函数(删/换源件后, 那些行不再产出并大声报出"哪几件不在盘、少多少行、涉及哪些月"): 报警/工单/油样三个摄入器原先是"只替换本次涉及的件、其余原样保留" ⇒ 源件删了行还在; ⑧★报警台账改键集合并集去重(键=Name/Alarmcode/TimeOn, 归属取最窄的源件)—— 原先按"逐件累加、没新键就跳过"的贪心判快照, 实测删一个源件反而让总行数从 39,211 涨到 56,593(被跳过的大快照件整件摄入, 重复计数) ⇒ 既不是源集的函数也会虚增; 现在 39,211 键稳定、重复 3.6 万行如实去掉; ⑨ 振动窗: 同名窗已存在时原来一律改名 _reimport(被 EXCLUDE_DEFAULT 排除 ⇒ 补进来的 CMS 数据根本进不了生产集), 现在默认替换同名窗(旧窗留档 _superseded_<时分>, 已加入排除表; 要旧行为用 --reimport-as-new)。★另按用户令「按你的建议执行 先 C 再 B」补完"同台多件 10min 进不来"这条链: ⑩ 步骤 C（让"放了没人读"当场可见）：raw_scan.py 新增 CONSUME 表（逐族写清消费者真实取数口径），判据从"扩展名白名单没命中"改成"全部文件里没被消费者读的"—— 实测 data/raw/如东/scada_10min/WTG01-B2.csv（856 列 / 2026-08 数据）扩展名 *.csv 命中白名单，旧判据永远发现不了它；现在报成缺口级（计入变化 rc=4 + ★[缺口] 块写明消费者口径与件例），附件类（.rar/.jpg/厂商软件）仍只列信息；建议行也分流说明"缺口类重算也纳入不了"。raw_data_check.py 同步: 同台补充件不再误报"文件名不是本场机组"，改为 info 行。⑪ 步骤 B（真正把新月份的 10min 件吃进来）：scada_source.load 取数从"只认 <台号>.csv"扩到 <台号>.csv + 同台补充件 <台号>-*.csv/<台号>_*.csv：按列名对齐（新导出把类型前缀去掉了: din_wtc_HydLevel_timeon → wtc_HydLevel_timeon，实测老件 598 列里 597 列能这样对上）、按时间戳排序去重（主件优先，重叠条数写进 attrs.scada_overlap 并打印）、来路件名与各件行数写进 attrs.scada_files/scada_rows。实测 WTG01：主件 77,551 行 + 补充件 5,820 行 → 合并 83,353 行（重叠 18 行去重），时间范围由 2026-07-07 延到 2026-09-01，2026-08 的 5,819 行关键通道非空率 77%（空白是源件自带的：该月 144 行/日齐全但约 23% 行的通道为空，如实保留 NaN）。交付包 app_guanlang_v2.8.0.zip
v2.7.0	2026-09-19	中	远程部署消缺：振动窗发布被杀软/索引占用不再打断整条重算链（+ --publish-only 恢复通道）；门户可对外监听（public_host，组件仍只本机）；GBK 控制台打印不炸	一次消缺 + 一项非核心功能新增（对外监听）⇒ 按规则取最高一级（minor）。要点: ① ★远端实逮（服务器 D:\产品\app）：索引 719 s + 谱 894 s 落进 windows_staging_ingest 后，staging.rename(final) 回 PermissionError: [WinError 5] 拒绝访问（360 实时扫描/索引器持着刚写的 1710 件小文件的句柄，Windows 的目录改名要求树里无打开句柄）⇒ ④b 失败 ⇒ 链停在第 4 步，页面表现为「需要关注 0 台 + 融合面缺件」。修法：发布改 _move_tree()（整目录 rename 退避重试 → 逐件搬，rename 不行就 copy+删 → 仍锁住的逐条如实报出）；并加 --publish-only：已算完的暂存窗可直接发布，不必白等 25 分钟重跑索引/谱; ② 用户令「观澜改为监听所有 IP」：configs/serve.json 增 public_host（空=跟 host=只本机；设 0.0.0.0=所有网卡），只有门户网关用它，detail/cms/viewer/sim 仍绑 127.0.0.1 ⇒ 对外只有 28084 一个入口；启动时打印对外地址并提示"页面无鉴权，请在防火墙侧限来源"; ③ 消缺: 新生成端在 GBK 控制台打印 m/s² / ⇒ 时抛 UnicodeEncodeError（远端 baseline_38 整件没出）⇒ 四个生成端加 stdout 守卫；trend_ingest 的"台账止 2024-11"过期断言改实话；CMS 三层基线卡的"健康期窗 N"重复措辞; ④ 部署口径: 用 SSH 起的服务在会话断开时会被一起收掉 ⇒ 现场改注册 Windows 服务（guanlan）（scripts/service_ctl.py install），开机自启、SCM 崩溃重启。交付包 app_guanlang_v2.7.0.zip
v2.6.0	2026-09-19	中	「所有的计算均要形成观澜的源代码」：融合面/总览页/事实契约/发布层/掩码阈值/六层链两步/变桨面/振动在升与三层基线 全部落成观澜自算；SCADA 接入兼容 CSV+MDB；交付包带输入数据目录结构（不含文件）	功能新增为主、夹带多项消缺 ⇒ 按规则取最高一级（minor）。要点: ① 六层链 model_run/fusion 两步按口径重建（报告的"融合级"列从此有值）+ energy_share 步补上 + 峰值拾取口径定案（观澜口径，四件 *_freq_scan 形式不再复刻）; ② 融合面 handoff 与总览页 windscada/index.html 由观澜自算生成（原为"包内无生成端"，新机器上 /detail/v2 的"需要关注/全场状态"必空白）; ③ 事实契约改为从重算台账生成 claim（门户结论段/问答/报告随重算刷新，/api/facts 不再 503）; ④ 本体发布层 r1/r2、TCM 掩码阈值（观澜自算口径，非厂商）分别落成生成端; ⑤ SCADA 接入统一取数层兼容 CSV 与 MDB（含老库列位错位如实拒绝；37 个月库按修好的建库脚本重建并逐分片对拍）; ⑥ 变桨面 pitch/** 落成生成端（10min 开关量/压力锯齿 + 1min 桨距角；零位口径按用户令停机段/满发段分列，并据实测反推补上运行段同工况分档这一真正的判据轴 —— 它能把现场确诊的 19# 单独拎出来）; ⑦ 振动 component_history.json（在升/换件闭环）与 baseline_38.json（自/机群/绝对三层基线）落成生成端（窗数不足时如实空表并写明数据边界）; ⑧ 打包:带输入数据目录结构（30 个空目录, 含 data/raw/西门子4.0技术资料）+ 放置说明文件随包, 仍不含数据文件; ⑨ 消缺: report 步踩可选包 tabulate 致整链中断、语言包闸拦下的 /v2 500、振动页看不出数据区间与"3 月数据消失"（趋势按日聚合）、账目单位错(kWh/MW)、Access 锁文件误报、日志保留策略等。交付包 app_guanlang_v2.6.0.zip
v2.5.0	2026-09-17	中	卸载闭环（uninstall.bat / uninstall.sh）+ 版本管理与打包命名规则 + 版本记录	二代架构（大版本 2，与 NAME 里的 v2 对齐）的第 5 次功能性发布，无消缺项；交付包 app_guanlang_v2.5.0.zip
v0.4.0	2026-09-17	旧编号	打包默认不含 输入数据/产物/日志/临时文件；无窗口启动（去掉 VBScript）；统一配置与日志；页面归口审计；输入数据放置检查；安装时版本检查与服务化	旧编号体系；交付包 app_guanlan_v2_0.4.0.zip（= guanlan-v0.4.0_dist_20260917.zip）
v0.2.0	2026-09-01	旧编号	含产物的旧交付基线（历史上用作"包内无生成端"那批产物的补救源；该用途 2026-09-19 起已失效）	旧编号体系；交付包 guanlan-rudong-v2_0.2.0_test_win64.zip —— ★2026-09-19 用户令从工作树清理（943 MB）：① 「所有的计算均要形成观澜的源代码」落地后无生成端件 = 0（反向呼应审计 1,800 件全部 raw-derived）⇒ 它作为"补救源"的用途消失；② 该包仍留在 git 历史里（blob 可随时 git 取回），需要时用 git show 恢复即可

本次交付

• 版本：v2.10.1（观澜·如东样板 v2）
• 交付包：app_guanlang_v2.10.1.zip
• 服务名：guanlan（Windows 服务 / systemd 单元）
• 安装 / 卸载：install.bat、install.sh / uninstall.bat、uninstall.sh