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

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

<!-- VERSION-LOG:BEGIN -->
## 版本号规则（用户令 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 | 旧编号 | 含产物的旧交付基线（留存的历史交付包，用作"包内无生成端"那批产物的补救源） | 旧编号体系；交付包 guanlan-rudong-v2_0.2.0_test_win64.zip（已入库备份） |

## 本次交付

* 版本：`v2.6.0`（观澜·如东样板 v2）
* 交付包：`app_guanlang_v2.6.0.zip`
* 服务名：`guanlan`（Windows 服务 / systemd 单元）
* 安装 / 卸载：`install.bat`、`install.sh` / `uninstall.bat`、`uninstall.sh`
<!-- VERSION-LOG:END -->