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.6.0。

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

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

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

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

版本	日期	级别	主要变更	说明
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.6.0（观澜·如东样板 v2）
• 交付包：app_guanlang_v2.6.0.zip
• 服务名：guanlan（Windows 服务 / systemd 单元）
• 安装 / 卸载：install.bat、install.sh / uninstall.bat、uninstall.sh