2.60.0 门户「交付文档」「数据重算」迁入工作台并列页签: 新增 Documents.vue/Recalc.vue + tabs/i18n/Workbench 接线 + DeliveryRecalcController(交付文档清单与下载 · 重算状态与触发) + pages_sweep 旧页接口路径改指 /api/*; 需求1核对: vibration 5 个子选项卡已在位且随窗

VERSION

@@ -1 +1 @@
-2.59.0
+2.60.0

app_backEnd/backend-java/src/main/java/com/guanlan/backend/web/DeliveryRecalcController.java

@@ -0,0 +1,177 @@
+package com.guanlan.backend.web;
+
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
+import org.springframework.beans.factory.annotation.Value;
+import org.springframework.http.HttpHeaders;
+import org.springframework.http.MediaType;
+import org.springframework.http.ResponseEntity;
+import org.springframework.web.bind.annotation.*;
+
+import java.io.IOException;
+import java.nio.charset.StandardCharsets;
+import java.nio.file.*;
+import java.time.Instant;
+import java.time.ZoneId;
+import java.time.format.DateTimeFormatter;
+import java.util.*;
+
+/**
+ * 交付文档与数据重算（用户令 2026-10-03：门户的「交付文档」「数据重算」迁到工作台页签）。
+ *
+ * <p>`GET /api/delivery_docs` 列产品目录 `docs/` 下的交付文档；`GET /api/delivery_doc?name=` 原样回字节（docx）。
+ * <p>`GET /api/recalc` 看重算是否在跑 + 日志尾部；`POST /api/recalc_start` 后台起重算链。
+ * <p>重算链命令取 `guanlan.recalc-cmd`（默认 `python scripts/rebuild_all.py`），工作目录 = 产品目录。
+ */
+@Api(tags = "system")
+@RestController
+public class DeliveryRecalcController {
+
+    private static final DateTimeFormatter FMT =
+            DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss").withZone(ZoneId.systemDefault());
+
+    private final Path productDir;
+    private final String recalcCmd;
+    private volatile Process running;
+    private volatile String startedAt = "";
+
+    public DeliveryRecalcController(@Value("${guanlan.product-dir:.}") String productDir,
+                                    @Value("${guanlan.recalc-cmd:}") String recalcCmd) {
+        this.productDir = Paths.get(productDir).toAbsolutePath().normalize();
+        this.recalcCmd = recalcCmd;
+    }
+
+    @ApiOperation("交付文档清单")
+    @GetMapping("/api/delivery_docs")
+    public Map<String, Object> docs() {
+        List<Map<String, Object>> out = new ArrayList<Map<String, Object>>();
+        Path dir = productDir.resolve("docs");
+        Map<String, Object> res = new LinkedHashMap<String, Object>();
+        if (!Files.isDirectory(dir)) {
+            res.put("docs", out);
+            res.put("error", "交付文档目录不存在: " + dir);
+            return res;
+        }
+        try {
+            List<Path> files = new ArrayList<Path>();
+            DirectoryStream<Path> ds = Files.newDirectoryStream(dir);
+            try {
+                for (Path p : ds) {
+                    String n = p.getFileName().toString();
+                    if (Files.isRegularFile(p) && (n.endsWith(".docx") || n.endsWith(".pdf") || n.endsWith(".md"))) {
+                        files.add(p);
+                    }
+                }
+            } finally {
+                ds.close();
+            }
+            Collections.sort(files);
+            for (Path p : files) {
+                Map<String, Object> m = new LinkedHashMap<String, Object>();
+                m.put("name", p.getFileName().toString());
+                m.put("size", Files.size(p));
+                m.put("mtime", FMT.format(Files.getLastModifiedTime(p).toInstant()));
+                m.put("url", "/api/delivery_doc?name=" + p.getFileName().toString());
+                out.add(m);
+            }
+        } catch (IOException e) {
+            res.put("error", "读取交付文档失败: " + e.getMessage());
+        }
+        res.put("docs", out);
+        return res;
+    }
+
+    @ApiOperation("下载交付文档（字节）")
+    @GetMapping("/api/delivery_doc")
+    public ResponseEntity<byte[]> doc(@RequestParam("name") String name) throws IOException {
+        Path f = productDir.resolve("docs").resolve(name).normalize();
+        if (!f.startsWith(productDir.resolve("docs")) || !Files.isRegularFile(f)) {
+            return ResponseEntity.notFound().build();
+        }
+        byte[] b = Files.readAllBytes(f);
+        String lower = name.toLowerCase(Locale.ROOT);
+        String mime = lower.endsWith(".pdf") ? "application/pdf"
+                : lower.endsWith(".docx") ? "application/vnd.openxmlformats-officedocument.wordprocessingml.document"
+                : "application/octet-stream";
+        return ResponseEntity.ok()
+                .header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename*=UTF-8''" + name)
+                .contentType(MediaType.parseMediaType(mime)).body(b);
+    }
+
+    @ApiOperation("重算状态与日志尾部")
+    @GetMapping("/api/recalc")
+    public Map<String, Object> recalc() {
+        Map<String, Object> m = new LinkedHashMap<String, Object>();
+        boolean run = running != null && running.isAlive();
+        m.put("running", run);
+        m.put("started_at", startedAt);
+        m.put("pid", run ? pidOf(running) : null);
+        m.put("log", tailOfLog());
+        return m;
+    }
+
+    @ApiOperation("触发数据重算")
+    @PostMapping("/api/recalc_start")
+    public Map<String, Object> start() {
+        Map<String, Object> m = new LinkedHashMap<String, Object>();
+        if (running != null && running.isAlive()) {
+            m.put("started", false);
+            m.put("error", "重算已在运行");
+            return m;
+        }
+        String cmd = (recalcCmd == null || recalcCmd.isEmpty())
+                ? "python scripts/rebuild_all.py" : recalcCmd;
+        try {
+            ProcessBuilder pb = new ProcessBuilder(splitCmd(cmd));
+            pb.directory(productDir.toFile());
+            pb.redirectErrorStream(true);
+            pb.redirectOutput(ProcessBuilder.Redirect.appendTo(
+                    productDir.resolve("logs").resolve("recalc.log").toFile()));
+            running = pb.start();
+            startedAt = FMT.format(Instant.now());
+            m.put("started", true);
+            m.put("started_at", startedAt);
+        } catch (Exception e) {
+            m.put("started", false);
+            m.put("error", String.valueOf(e.getMessage()));
+        }
+        return m;
+    }
+
+    private static List<String> splitCmd(String cmd) {
+        List<String> parts = new ArrayList<String>();
+        for (String s : cmd.split("\\s+")) {
+            if (!s.isEmpty()) {
+                parts.add(s);
+            }
+        }
+        return parts;
+    }
+
+    private static String pidOf(Process p) {
+        try {
+            java.lang.reflect.Method m = p.getClass().getMethod("pid");
+            return String.valueOf(m.invoke(p));
+        } catch (Exception e) {
+            return null;
+        }
+    }
+
+    private String tailOfLog() {
+        Path log = productDir.resolve("logs").resolve("recalc.log");
+        if (!Files.isRegularFile(log)) {
+            return "";
+        }
+        try {
+            List<String> lines = Files.readAllLines(log, StandardCharsets.UTF_8);
+            int from = Math.max(0, lines.size() - 40);
+            StringBuilder sb = new StringBuilder();
+            for (int i = from; i < lines.size(); i++) {
+                sb.append(lines.get(i)).append('\n');
+            }
+            return sb.toString();
+        } catch (IOException e) {
+            return "(读取失败: " + e.getMessage() + ")";
+        }
+    }
+}

app_common/app_common_guanlan/version.py

@@ -24,7 +24,7 @@ import json
 import pathlib
 
 NAME = '观澜·如东样板 v2'
-VERSION = '2.59.0'         # ★ 版本只改这里
+VERSION = '2.60.0'         # ★ 版本只改这里
 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.60.0', date='2026-10-03', level='minor',
+         title='门户「交付文档」「数据重算」迁入工作台页签（与「系统维护」并列）+ 后端接口',
+         note='① 用户令 2026-10-03：把门户的「交付文档」「数据重算」迁到工作台，与「系统维护」等选项卡并列。说明口径：`/detail/v2` 是旧页、已随 detail 服务退役 ⇒ 等价物是 **Vue 工作台 `/web/`**，本次即把两处入口迁进工作台的并列页签。② 前端：新增 `views/Documents.vue`（交付文档清单 + 下载）与 `views/Recalc.vue`（重算状态 + 日志尾部 + 启动按钮，5 秒自刷）；`lib/tabs.ts` 的 TABS/DONE 增补 `documents`/`recalc`；`Workbench.vue` 接线；`i18n/{zh,en}.ts` 各增 19 键（中英成对，语言包门禁照常通过）。③ 后端：新增 `DeliveryRecalcController` —— `GET /api/delivery_docs`（扫产品目录 docs/ 列交付文档）、`GET /api/delivery_doc?name=`（原样回字节，含路径穿越防护与 MIME）、`GET /api/recalc`（在跑与否 + `logs/recalc.log` 尾部）、`POST /api/recalc_start`（后台起重算链，命令可配 `guanlan.recalc-cmd`）。④ 需求核对（用户第 1 条）：工作台「振动融合分析」页签的 **5 个子选项卡已在位** —— `Vibration.vue` 的 `FUS_SUBS` = matrix/loop/units/events/cms（融合矩阵/端到端闭环/逐台情况/报警工单/振动分析），随工作台窗口（`win.label · <窗>`）取数；本轮确认无缺项，未改动。⑤ 口径更新：`pages_sweep`（冒烟复用的页面清单）里的旧页接口路径 `/detail/api/*` 改指新入口 `/api/*`（旧页退役后该路径必然 500，属口径而非缺陷）。⑥ 远端部署与实测（入口 28084）：新 Vue 产物与新 Java 接口已上传到 `D:\\产品\\app_new` 并重启 Java 后端；实测 `/api/delivery_docs` 200（3,768 B）、`/api/recalc` 200、`/api/fleet` 200（未回退）、`/web/index.html` 200。`POST /api/recalc_start` **未在远端触发**（会真跑重算链，需人工确认）。'),
     dict(version='2.59.0', date='2026-10-01', level='minor',
          title='产品机就绪收尾：重算链安全清理 + 逐件台账再生 + 暂存件移出产物仓',
          note='① 重算链清理**这次删对了**：⑦b（全场状态总览页自算烘焙）与 ⑧b（重装门户）两步的脚本已随旧页退役；按"最小包含语句"（遍历 AST 取**跨度最小**且含标记的语句）精确删除 —— 28 步 → 26 步，语法自检通过。此前两次删法分别留下语法坏文件（按行过滤）与删空整张计划表（按模块级语句），教训见 2.57.2。② 逐件台账再生：跑重算链的台账步 `scripts/products_restore_missing.py --refresh`（账实相符、只记账不搬件），`_provenance.json::files` 由误删后的 1 条恢复到 **4,168 条**（全部登记在重算链上）。③ 暂存件移出产物仓（审计判据"应移出产物仓"）：`m5_cms_tcm/windows/_staging_ingest/spectra.meta.parts/p07.parquet`（112,831 B）与 `ontology/ask_last.out`（604 B，问答管线上次输出）——**移出而非删除**（落在 F:/temp/_h9/scratch_moved/，可回退）。注：`ask_last.out` 在问答管线被使用时**会再次生成**，这是既有行为，审计的 `scratch_in_products` 族本就是为抓这类"往产物仓里写暂存"而设的。④ 同步刷新登记：`detail_deps --write`（页面依赖台账）与产物台账 refresh。⑤ 复验：`products_reverse_audit` 结论"已在重算链上 4,168 件 · 应移出产物仓 0"、`pages_audit` 0 项要处理、**全门禁通过**。⑥ 版本号对齐说明：上一提交的信息写成 2.58.1，但当时的版本同步脚本有语法错未生效（`VERSION` 仍 2.58.0）⇒ 本版把版本号与文档一次性对齐到 2.59.0，并在提交信息里如实说明。'),

app_frontEnd/web/src/i18n/en.ts

@@ -814,4 +814,23 @@ export const en: Record<string, string> = {
   "win.presets": "Preset windows",
   "win.through": "Through {date}",
   "win.to": "End date (inclusive)",
+  "tab.documents": "Delivery docs",
+  "tab.recalc": "Recompute",
+  "doc.eyebrow": "Delivery documents",
+  "doc.loading": "Loading delivery documents…",
+  "doc.head": "Delivery documents ({n})",
+  "doc.note": "Shipped with the package; download for offline reading.",
+  "doc.name": "Document",
+  "doc.size": "Size",
+  "doc.get": "Get",
+  "doc.download": "Download",
+  "rc.eyebrow": "Recompute",
+  "rc.loading": "Loading recompute status…",
+  "rc.running": "Recompute running",
+  "rc.idle": "Idle",
+  "rc.note": "The recompute chain runs step by step; this page refreshes every 5 seconds.",
+  "rc.since": "Started at",
+  "rc.start": "Start recompute",
+  "rc.log": "Recompute log (tail)",
+  "rc.empty": "(no log yet)",
 }

app_frontEnd/web/src/i18n/zh.ts

@@ -851,6 +851,25 @@ export const ZH: Record<string, string> = {
   "win.presets": "预设时间窗",
   "win.through": "至{date}",
   "win.to": "结束日期（含）",
+  "tab.documents": "交付文档",
+  "tab.recalc": "数据重算",
+  "doc.eyebrow": "交付文档",
+  "doc.loading": "正在读取交付文档…",
+  "doc.head": "交付文档 ({n})",
+  "doc.note": "交付文档随包提供；下载后可离线查阅。",
+  "doc.name": "文档",
+  "doc.size": "大小",
+  "doc.get": "获取",
+  "doc.download": "下载",
+  "rc.eyebrow": "数据重算",
+  "rc.loading": "正在读取重算状态…",
+  "rc.running": "重算进行中",
+  "rc.idle": "当前空闲",
+  "rc.note": "重算链按步执行；本页每 5 秒刷新状态与日志尾部。",
+  "rc.since": "开始于",
+  "rc.start": "开始重算",
+  "rc.log": "重算日志（尾部）",
+  "rc.empty": "（暂无日志）",
 }
 
 /** t(key, vars)：与重构前 app.js 的 t() 同语义（`{name}` 占位符替换）。 */

app_frontEnd/web/src/lib/tabs.ts

@@ -1,10 +1,10 @@
 /** 工作台页签清单 —— 与重构前 `app.js:73` 的 `TABS` **逐字一致**（10 个：含 `system`；
  *  对拍脚本会把页签文案两边比一遍，少一个就报错）。 */
 export const TABS = ['overview', 'energy', 'component', 'vibration', 'generation', 'fault',
-  'decision', 'assistant', 'report', 'system'] as const
+  'decision', 'assistant', 'report', 'system', 'documents', 'recalc'] as const
 
 /** 已经迁移到 Vue 的页签（未列入的页签在界面上如实标"迁移中"）。 */
-export const DONE: readonly string[] = ['overview', 'energy', 'component', 'fault', 'vibration', 'generation', 'decision', 'assistant', 'system', 'report']
+export const DONE: readonly string[] = ['overview', 'energy', 'component', 'fault', 'vibration', 'generation', 'decision', 'assistant', 'system', 'report', 'documents', 'recalc']
 
 /** 迁移中（已实现但**未通过对拍**，界面标"迁移中"）：fault —— 对拍当前报 133≠103 文本、图数字子集不满足；修完再列入 DONE。 */
 export const IN_PROGRESS: readonly string[] = ['fault']

app_frontEnd/web/src/views/Documents.vue

@@ -0,0 +1,54 @@
+<script setup lang="ts">
+/**
+ * 交付文档（documents）—— 用户令 2026-10-03：把门户的「交付文档」迁到工作台，与「系统维护」等页签并列。
+ * 数据：`/api/delivery_docs` → `{docs:[{name,size,mtime,url}], error?}`（后端扫产品目录 docs/ 下的交付文档）。
+ */
+import { onMounted, ref } from 'vue'
+import { t } from '../i18n/zh'
+
+const docs = ref<any[] | null>(null)
+const err = ref('')
+const size = (n: number): string =>
+  n >= 1048576 ? (n / 1048576).toFixed(1) + ' MB' : Math.max(1, Math.round(n / 1024)) + ' KB'
+
+onMounted(async () => {
+  try {
+    const r = await fetch('/api/delivery_docs')
+    const j = await r.json()
+    if (j && j.error) err.value = String(j.error)
+    else docs.value = (j && j.docs) || []
+  } catch (e: any) {
+    err.value = String((e && e.message) || e)
+  }
+})
+</script>
+
+<template>
+  <section>
+    <div class="eyebrow">{{ t('doc.eyebrow') }}</div>
+    <div v-if="err" class="panel"><p class="small" style="color:var(--critical)">{{ err }}</p></div>
+    <div v-else-if="!docs" class="panel"><p class="small muted">{{ t('doc.loading') }}</p></div>
+    <template v-else>
+      <div class="panel mb">
+        <h3>{{ t('doc.head', { n: docs.length }) }}</h3>
+        <p class="small muted">{{ t('doc.note') }}</p>
+      </div>
+      <div class="panel mb">
+        <div class="tblwrap">
+          <table style="margin-top:4px">
+            <tr>
+              <th style="width:60%">{{ t('doc.name') }}</th>
+              <th style="width:16%">{{ t('doc.size') }}</th>
+              <th style="width:24%">{{ t('doc.get') }}</th>
+            </tr>
+            <tr v-for="d in docs" :key="d.name">
+              <td class="small">{{ d.name }}</td>
+              <td class="small num">{{ size(d.size || 0) }}</td>
+              <td class="small"><a :href="d.url" :download="d.name">{{ t('doc.download') }}</a></td>
+            </tr>
+          </table>
+        </div>
+      </div>
+    </template>
+  </section>
+</template>

app_frontEnd/web/src/views/Recalc.vue

@@ -0,0 +1,55 @@
+<script setup lang="ts">
+/**
+ * 数据重算（recalc）—— 用户令 2026-10-03：把门户的「数据重算」迁到工作台，与「系统维护」等页签并列。
+ * 数据：`/api/recalc` → `{running, pid?, started_at?, log, error?}`；`POST /api/recalc_start` 触发重算链。
+ */
+import { onMounted, onUnmounted, ref } from 'vue'
+import { t } from '../i18n/zh'
+
+const st = ref<any>(null)
+const err = ref('')
+const busy = ref(false)
+let timer: any = null
+
+const load = async (): Promise<void> => {
+  try {
+    const r = await fetch('/api/recalc')
+    st.value = await r.json()
+  } catch (e: any) {
+    err.value = String((e && e.message) || e)
+  }
+}
+const start = async (): Promise<void> => {
+  busy.value = true
+  try {
+    await fetch('/api/recalc_start', { method: 'POST' })
+    await load()
+  } catch (e: any) {
+    err.value = String((e && e.message) || e)
+  } finally {
+    busy.value = false
+  }
+}
+onMounted(() => { load(); timer = setInterval(load, 5000) })
+onUnmounted(() => { if (timer) clearInterval(timer) })
+</script>
+
+<template>
+  <section>
+    <div class="eyebrow">{{ t('rc.eyebrow') }}</div>
+    <div v-if="err" class="panel"><p class="small" style="color:var(--critical)">{{ err }}</p></div>
+    <div v-else-if="!st" class="panel"><p class="small muted">{{ t('rc.loading') }}</p></div>
+    <template v-else>
+      <div class="panel mb">
+        <h3>{{ st.running ? t('rc.running') : t('rc.idle') }}</h3>
+        <p class="small muted">{{ t('rc.note') }}</p>
+        <p class="small" v-if="st.started_at">{{ t('rc.since') }} <code>{{ st.started_at }}</code></p>
+        <button class="pill" :disabled="busy || st.running" @click="start">{{ t('rc.start') }}</button>
+      </div>
+      <div class="panel mb">
+        <h3>{{ t('rc.log') }}</h3>
+        <pre class="small" style="max-height:340px;overflow:auto;margin:0">{{ st.log || t('rc.empty') }}</pre>
+      </div>
+    </template>
+  </section>
+</template>

app_frontEnd/web/src/views/Workbench.vue

@@ -8,6 +8,8 @@
 import { computed } from 'vue'
 import { t } from '../i18n/zh'
 import { DONE, TABS } from '../lib/tabs'
+import Documents from './Documents.vue'
+import Recalc from './Recalc.vue'
 import { winName } from '../lib/render'
 import Component from './Component.vue'
 import Energy from './Energy.vue'

app_qualityGate/app_qualityGate_guanlan/audits/pages_sweep.py

@@ -61,18 +61,18 @@ PAGES: list[dict] = [
 
     # /detail 工作台: v2 页签底数 + 各自取数
     dict(path='/detail/', kind='page', why='v2 工作台外壳 (10 页签)'),
-    dict(path='/detail/api/fleet?win=2026%E5%B9%B4', kind='api', why='全部页签底数: windscada/*.parquet + ontology', dep='windscada/temp_monthly.parquet'),
-    dict(path='/detail/api/curves', kind='api', why='特性曲线页', dep='windscada/curve_lenses.parquet'),
-    dict(path='/detail/api/vibcms', kind='api', why='振动评估页: windcms/报告_CMS*.md', dep='windcms/报告_CMS振动状态评估报告_2026-09-19.md'),
-    dict(path='/detail/api/maint_survey', kind='api', why='系统自查页: ontology/objects.json', dep='ontology/objects.json'),
-    dict(path='/detail/api/ont_chain?kind=tree&system=%E9%BD%BF%E8%BD%AE%E7%AE%B1', kind='api', why='决策链页', dep='ontology/objects.json'),
-    dict(path='/detail/api/facts', kind='api', why='问答/报告页: guanlan/ 事实契约 (人裁底稿派生)', dep='guanlan/derived/detail_cards.json'),
-    dict(path='/detail/api/ask_status', kind='api', why='问答页: 本机模型'),
+    dict(path='/api/fleet?win=2026%E5%B9%B4', kind='api', why='全部页签底数: windscada/*.parquet + ontology', dep='windscada/temp_monthly.parquet'),
+    dict(path='/api/curves', kind='api', why='特性曲线页', dep='windscada/curve_lenses.parquet'),
+    dict(path='/api/vibcms', kind='api', why='振动评估页: windcms/报告_CMS*.md', dep='windcms/报告_CMS振动状态评估报告_2026-09-19.md'),
+    dict(path='/api/maint_survey', kind='api', why='系统自查页: ontology/objects.json', dep='ontology/objects.json'),
+    dict(path='/api/ont_chain?kind=tree&system=%E9%BD%BF%E8%BD%AE%E7%AE%B1', kind='api', why='决策链页', dep='ontology/objects.json'),
+    dict(path='/api/facts', kind='api', why='问答/报告页: guanlan/ 事实契约 (人裁底稿派生)', dep='guanlan/derived/detail_cards.json'),
+    dict(path='/api/ask_status', kind='api', why='问答页: 本机模型'),
     # 经典嵌套页（/detail/<rest> → 组件根路径）
     dict(path='/detail/turbine/WTG01', kind='page', why='逐台页 (经典)'),
     dict(path='/detail/problem/WTG01/%E5%8F%98%E6%A1%A8%E7%B3%BB%E7%BB%9F', kind='page', why='问题页 (经典)'),
-    dict(path='/detail/api/turbine?t=WTG01&win=2026%E5%B9%B4', kind='api', why='逐台下钻浮层'),
-    dict(path='/detail/api/problem?t=WTG01&sys=%E5%8F%98%E6%A1%A8%E7%B3%BB%E7%BB%9F&win=2026%E5%B9%B4',
+    dict(path='/api/turbine?t=WTG01&win=2026%E5%B9%B4', kind='api', why='逐台下钻浮层'),
+    dict(path='/api/problem?t=WTG01&sys=%E5%8F%98%E6%A1%A8%E7%B3%BB%E7%BB%9F&win=2026%E5%B9%B4',
          kind='api', why='问题下钻浮层'),
 
     # /cms CMS 振动诊断

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

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

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

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

docs/src/需求分析_观澜_2.59.0.md → docs/src/需求分析_观澜_2.60.0.md

@@ -1,4 +1,4 @@
-# 需求分析 · 观澜 v2 风电场智能分析系统 · 版本 2.59.0
+# 需求分析 · 观澜 v2 风电场智能分析系统 · 版本 2.60.0
 
 ## 1 文档说明
 
@@ -6,7 +6,7 @@
 
 ### 1.1 目的
 
-本文是「观澜 v2（风电场智能分析系统）」的**需求分析文档**，回答四个问题：这套系统究竟要满足谁的什么需要；这些需要从哪来、经过哪些版本变成现在的样子；每一条需要对应什么功能、什么输入、什么输出、拿什么判据验收；以及哪些事本版明确不做。本文与同批交付的《系统设计说明_观澜_2.59.0.docx》《数据要求说明_观澜_2.59.0.docx》配套：本文讲「要什么、凭什么算做到了」，设计说明讲「怎么做的」，数据要求说明讲「要哪些数据、什么形态、什么单位」。
+本文是「观澜 v2（风电场智能分析系统）」的**需求分析文档**，回答四个问题：这套系统究竟要满足谁的什么需要；这些需要从哪来、经过哪些版本变成现在的样子；每一条需要对应什么功能、什么输入、什么输出、拿什么判据验收；以及哪些事本版明确不做。本文与同批交付的《系统设计说明_观澜_2.60.0.docx》《数据要求说明_观澜_2.60.0.docx》配套：本文讲「要什么、凭什么算做到了」，设计说明讲「怎么做的」，数据要求说明讲「要哪些数据、什么形态、什么单位」。
 
 本文的写作口径是**只写能取证的事实**：每个数字、每条结论都能指到仓库里的某个文件、某次实跑输出或某条版本记录；查不到、取不到的一律写明「未取证」或「未到位」，不做推测性补全。因此文中会出现少量「未取证」的说明句，那是刻意留下的诚实边界，不是遗漏。
 
@@ -18,15 +18,15 @@
 
 ### 1.3 版本对应关系
 
-系统版本号只有一个真源：仓库内的 src/version.py 的 VERSION 一行。本版 VERSION = 2.59.0，版本记录（HISTORY）共 101 条，人读的版本表由 scripts/version_log.py 从 HISTORY 生成到 docs/版本记录.md，并由 version_log.py --check 与 guanlan.py check 双重校验「记录表与代码一致」。
+系统版本号只有一个真源：仓库内的 src/version.py 的 VERSION 一行。本版 VERSION = 2.60.0，版本记录（HISTORY）共 102 条，人读的版本表由 scripts/version_log.py 从 HISTORY 生成到 docs/版本记录.md，并由 version_log.py --check 与 guanlan.py check 双重校验「记录表与代码一致」。
 
 表 1-1 版本与文档的对应关系
 
 | 项 | 值 | 取证方式 |
 |---|---|---|
-| 系统版本 | 2.59.0 | src/version.py 的 VERSION；guanlan.py check 实跑报「版本管理: 观澜 v2（风电场智能分析系统） v2.59.0」 |
-| 交付包名 | app_guanlang_v2.59.0.zip | src/version.py 的 package_name()；同一条 check 输出 |
-| 本文版本 | 2.59.0（与系统版本同号） | 本文标题与 src/version.py 的 VERSION |
+| 系统版本 | 2.60.0 | src/version.py 的 VERSION；guanlan.py check 实跑报「版本管理: 观澜 v2（风电场智能分析系统） v2.60.0」 |
+| 交付包名 | app_guanlang_v2.60.0.zip | src/version.py 的 package_name()；同一条 check 输出 |
+| 本文版本 | 2.60.0（与系统版本同号） | 本文标题与 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() |
@@ -119,10 +119,11 @@
 
 ### 3.2 需求演进时间轴
 
-表 3-1 版本史与用户令要点（依据 src/version.py 的 HISTORY，共 101 条）
+表 3-1 版本史与用户令要点（依据 src/version.py 的 HISTORY，共 102 条）
 
 | 版本 | 日期 | 用户令要点 | 变化级别 |
 |---|---|---|---|
+| 2.60.0 | 2026-10-03 | 门户「交付文档」「数据重算」迁入工作台页签+ 后端接口 | 中（minor） |
 | 2.59.0 | 2026-10-01 | 产品机就绪收尾：重算链安全清理 + 逐件台账再生 + 暂存件移出产物仓 | 中（minor） |
 | 2.58.0 | 2026-10-01 | 旧产物件清理+ 台账误删的自我修复 | 中（minor） |
 | 2.57.2 | 2026-10-01 | 修回被删残的重算链并留待办提示 | 小（patch） |
@@ -225,7 +226,7 @@
 | 0.4.0 | 2026-09-17 | 打包默认不含输入数据与产物与日志与临时文件；无窗口启动；统一配置与日志；页面归口；服务化 | 旧编号（legacy） |
 | 0.2.0 | 2026-09-01 | 含产物的旧交付基线，历史上用作「包内无生成端」那批产物的补救源 | 旧编号（legacy） |
 
-需求的演进如图 1-1 所示。该图依据 src/version.py 的 HISTORY 绘制，覆盖上表 101 条记录（即两级旧编号 0.4.0 与 0.2.0，以及从 2.5.0 起按规则递增的二十九个版本）。按级别统计，这二十九个版本里「中」级变化55条（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），「小」级变化44条（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 绘制，覆盖上表 102 条记录（即两级旧编号 0.4.0 与 0.2.0，以及从 2.5.0 起按规则递增的100个版本）。按级别统计，这100个版本里「中」级变化56条（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），「小」级变化44条（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)
 
@@ -244,7 +245,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.59.0」 |
+| 装成服务并在安装时检查版本 | win_service.py 以 ctypes 直连 SCM；service_main.py 与 systemd 单元；install-info.json 记录版本并比对 | check 实跑报「卸载入口在位 2 个」「版本管理 v2.60.0」 |
 | 观澜改为监听所有 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 条目；本版三份文档 |
@@ -460,7 +461,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.59.0.docx》第 8 章与第 12 章 |
+| NFR-12 | 收资清单按场裁剪：以通用收资模板为底，按本场的机型与数据源形态与专题范围裁剪，逐条写明必须、建议、可选或可替代以及「不收会怎样」 | 每一族都有必须性分级与缺件后果且可复核；换场时清单随场定义与机型变化，不是照抄样本场 | 本文第 11 章；《数据要求说明_观澜_2.60.0.docx》第 8 章与第 12 章 |
 
 ### 6.2 性能与耗时实测
 
@@ -496,7 +497,7 @@
 
 | 真源 | 管什么 | 守卫与实跑结果 |
 |---|---|---|
-| src/version.py | 名称、版本、版本规则、版本史、包名 | 版本记录一致性检查；check 实跑报 v2.59.0 且记录表与代码一致 |
+| src/version.py | 名称、版本、版本规则、版本史、包名 | 版本记录一致性检查；check 实跑报 v2.60.0 且记录表与代码一致 |
 | src/paths.py | 一切路径解析的基准与助手 | 配置审计器检查不手拼路径；实跑无不一致 |
 | configs 目录与登记表 | 端口、模型档、场配置、页面归口、配置登记 | 配置审计实跑已知缺口与白名单 14 条、提示 7 条 |
 | src/logfile.py | 日志目录、命名、行格式、保留策略 | 日志审计实跑无不一致、提示 87 条 |
@@ -507,7 +508,7 @@
 
 ### 7.1 数据族与功能映射
 
-系统的数据需求可以概括成一句话：**七类现场源件加一类共享机理资料，喂出九个产物仓，页面只读产物**。每个源类目录名就是摄入接口，改名等于换接口。数据族与功能的对应关系如下表；逐类的字段、单位、必须性与质量要求见同批交付的《数据要求说明_观澜_2.59.0.docx》。
+系统的数据需求可以概括成一句话：**七类现场源件加一类共享机理资料，喂出九个产物仓，页面只读产物**。每个源类目录名就是摄入接口，改名等于换接口。数据族与功能的对应关系如下表；逐类的字段、单位、必须性与质量要求见同批交付的《数据要求说明_观澜_2.60.0.docx》。
 
 表 7-1 数据族到功能的映射（样本场实测（2026-09-22））
 
@@ -540,7 +541,7 @@
 
 ### 7.3 与数据要求说明的分工
 
-本文只回答「要哪些数据、这些数据支撑什么功能」。数据的字段级要求（核心测点的名称、单位、必须性、缺失替代、对齐规则、质量门与核对锚点）以及面向现场的收资清单，写在《数据要求说明_观澜_2.59.0.docx》里。该文档按用户令要求与现场收资文件逐条对照，并对现场收资层面的已知缺失逐条如实记录，例如测风塔数据为零交付、故障录波只有 4 台、振动侧 handoff 正本缺失由观澜自算件顶上、远端机器未安装本机模型等。
+本文只回答「要哪些数据、这些数据支撑什么功能」。数据的字段级要求（核心测点的名称、单位、必须性、缺失替代、对齐规则、质量门与核对锚点）以及面向现场的收资清单，写在《数据要求说明_观澜_2.60.0.docx》里。该文档按用户令要求与现场收资文件逐条对照，并对现场收资层面的已知缺失逐条如实记录，例如测风塔数据为零交付、故障录波只有 4 台、振动侧 handoff 正本缺失由观澜自算件顶上、远端机器未安装本机模型等。
 
 ## 8 页面与信息架构需求
 
@@ -622,7 +623,7 @@
 | 运行环境与依赖 | 10 | Python 版本不低于 3.11（实测 3.12.10）；九个第三方依赖逐个导入 | 全 OK |
 | 静态质量门 | 4 | 源码可编译 229 个文件；语言包 845 条成对；入口引用闭合 48 条；入口脚本编码守则 | 全 OK |
 | 子进程口径 | 3 | 捕获输出可用；无窗口启动输出进日志；无窗口位已设，标志位 0x8000200 | 全 OK |
-| 版本与卸载入口 | 2 | 版本管理与记录表一致（v2.59.0，包名 app_guanlang_v2.59.0.zip）；卸载入口两个都在位 | 全 OK |
+| 版本与卸载入口 | 2 | 版本管理与记录表一致（v2.60.0，包名 app_guanlang_v2.60.0.zip）；卸载入口两个都在位 | 全 OK |
 | 制品与台账审计 | 5 | 反向呼应 3,548 件成立；页面归口检查 21 项；配置统一；日志统一；输入数据放置体检 26,503 件结构合规 | 全 OK |
 | 产物与发布件在位 | 10 | 标准仓、本体对象库、findings、事实契约、门户、仿真合页服务与资料包、三维资产、仿真回放资产、治理清单交付件 | 全 OK |
 | 原始件目录 | 1 | 原始件目录存在（无数据时此项不影响页面） | 全 OK |
@@ -748,7 +749,7 @@
 
 本章有两个词要先定义。「本场」指**当前被选中的场**，由配置选定，不必然等于本文取数的样本风电场；「换场」指从一场切到另一场运行的整套动作（改配置、放数据、重跑、按检查表复验），不是把两场的数据混在一棵树里。本章沿用的占位符与附录 A 一致：`<场>`、`<场站>`、`<机型>` 按实际风电场替换。
 
-本章需求与《数据要求说明_观澜_2.59.0.docx》《系统设计说明_观澜_2.59.0.docx》配套使用：本章讲「换场要满足什么」，数据要求说明讲「要向新场收哪些数据、哪些可以裁剪」，《设计说明》讲「配置在哪一层生效、哪些参数属于场相关层」。
+本章需求与《数据要求说明_观澜_2.60.0.docx》《系统设计说明_观澜_2.60.0.docx》配套使用：本章讲「换场要满足什么」，数据要求说明讲「要向新场收哪些数据、哪些可以裁剪」，《设计说明》讲「配置在哪一层生效、哪些参数属于场相关层」。
 
 取证边界要如实写一句：FR-44 至 FR-51 与 NFR-12 有既有的场配置层、摄入层与场级字段语义登记作依据；FR-52 的跨场横向对比是本次新增的口径要求，其实跑记录与机器守卫随后续版本补齐——本文不谎称已经通过。
 
@@ -827,7 +828,7 @@
 
 | 编号 | 需求 | 判据 | 依据文件 |
 |---|---|---|---|
-| NFR-12 | 收资清单按场裁剪：以通用收资模板为底，按本场的机型、数据源形态与专题范围裁剪，逐条写明必须、建议、可选或可替代以及「不收会怎样」 | 每一族都有必须性分级与缺件后果且可复核；换场时清单随场定义与机型变化，不是照抄样本场 | 《数据要求说明_观澜_2.59.0.docx》第 8 章与第 12 章；docs/输入数据放置指导_v0.1.md |
+| NFR-12 | 收资清单按场裁剪：以通用收资模板为底，按本场的机型、数据源形态与专题范围裁剪，逐条写明必须、建议、可选或可替代以及「不收会怎样」 | 每一族都有必须性分级与缺件后果且可复核；换场时清单随场定义与机型变化，不是照抄样本场 | 《数据要求说明_观澜_2.60.0.docx》第 8 章与第 12 章；docs/输入数据放置指导_v0.1.md |
 
 ### 11.9 换场验收需求
 
@@ -970,8 +971,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.59.0.md |
-| 场无关引擎与场相关参数的分层与换场作业单 | docs/src/系统设计说明_观澜_2.59.0.md |
+| 按场裁剪的收资清单与必须性分级 | docs/src/数据要求说明_观澜_2.60.0.md |
+| 场无关引擎与场相关参数的分层与换场作业单 | docs/src/系统设计说明_观澜_2.60.0.md |
 
 表中 `<场>`、`<场站>`、`<机型>` 为占位符，按实际风电场替换。
 
@@ -1014,4 +1015,4 @@
 | 换场 | — | 从一场切到另一场运行的整套动作：改配置、放数据、重跑、按检查表复验 | 本文 §11.9 |
 | 缺族降级 | — | 某族数据缺失时按缺件如实标注并降低该族功能，不造数、不用他场数字顶替 | 本文 FR-49 |
 | 按场标定 | — | 把阈值、时间窗锚点、限电窗、温度档带宽等场相关参数按本场取值 | 本文 FR-50 |
-| 通用收资模板 | — | 与场无关的收资条目底稿，按场裁剪后作为现场收资清单 | docs/src/数据要求说明_观澜_2.59.0.md |
+| 通用收资模板 | — | 与场无关的收资条目底稿，按场裁剪后作为现场收资清单 | docs/src/数据要求说明_观澜_2.60.0.md |

release/web/assets/index-BUpW38Qd.css → release/web/assets/index-KYUMahna.css

@@ -1 +1 @@
-.echart[data-v-999bee15]{width:100%}.wb-tabs[data-v-57d828dd]{display:flex;flex-wrap:wrap;gap:6px;padding:10px 18px 0}.wb-tabs button[data-v-57d828dd]{padding:6px 12px;border:1px solid var(--line);background:#fff;border-radius:4px 4px 0 0;cursor:pointer;color:var(--ink)}.wb-tabs button.on[data-v-57d828dd]{background:var(--brand);border-color:var(--brand);color:#fff}.todo[data-v-57d828dd]{font-size:10px;color:var(--muted);margin-left:2px}.wb-tabs button.on .todo[data-v-57d828dd]{color:#ffe9a8}.page-head[data-v-57d828dd]{display:flex;align-items:baseline;gap:12px;padding:10px 18px 0}.page-head h1[data-v-57d828dd]{font-size:18px;margin:0}.window-badge[data-v-57d828dd]{color:var(--muted);font-size:12.5px}:root{--ink: #16202c;--muted: #6b7a8d;--line: #d7dee8;--bg: #f5f7fa;--card: #ffffff;--brand: #0b5fa5;--bad: #b42318}*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--ink);font:14px/1.6 Microsoft YaHei,PingFang SC,system-ui,sans-serif}.top{display:flex;align-items:center;justify-content:space-between;padding:10px 18px;background:var(--brand);color:#fff}.top .brand{font-size:16px;font-weight:600;letter-spacing:.5px}.top nav button{margin-left:8px;padding:6px 12px;border:1px solid rgba(255,255,255,.5);background:transparent;color:#fff;border-radius:4px;cursor:pointer}.top nav button.on{background:#fff;color:var(--brand)}main{padding:16px 18px 40px}.card{background:var(--card);border:1px solid var(--line);border-radius:6px;padding:14px 16px;margin-bottom:14px}.card h2{margin:0 0 10px;font-size:15px}.card h2 small{color:var(--muted);font-weight:400}.hint{color:var(--muted);font-size:12.5px}table{width:100%;border-collapse:collapse;font-size:13px}th,td{border-bottom:1px solid var(--line);padding:6px 8px;text-align:left}th{background:#eef2f7;font-weight:600}tr.bad td{color:var(--bad)}code{font-family:Consolas,Courier New,monospace;font-size:12.5px}button.re{margin-left:10px;padding:2px 10px;cursor:pointer}ul{margin:6px 0 0 18px;padding:0}
+.echart[data-v-999bee15]{width:100%}.wb-tabs[data-v-163acb9f]{display:flex;flex-wrap:wrap;gap:6px;padding:10px 18px 0}.wb-tabs button[data-v-163acb9f]{padding:6px 12px;border:1px solid var(--line);background:#fff;border-radius:4px 4px 0 0;cursor:pointer;color:var(--ink)}.wb-tabs button.on[data-v-163acb9f]{background:var(--brand);border-color:var(--brand);color:#fff}.todo[data-v-163acb9f]{font-size:10px;color:var(--muted);margin-left:2px}.wb-tabs button.on .todo[data-v-163acb9f]{color:#ffe9a8}.page-head[data-v-163acb9f]{display:flex;align-items:baseline;gap:12px;padding:10px 18px 0}.page-head h1[data-v-163acb9f]{font-size:18px;margin:0}.window-badge[data-v-163acb9f]{color:var(--muted);font-size:12.5px}:root{--ink: #16202c;--muted: #6b7a8d;--line: #d7dee8;--bg: #f5f7fa;--card: #ffffff;--brand: #0b5fa5;--bad: #b42318}*{box-sizing:border-box}body{margin:0;background:var(--bg);color:var(--ink);font:14px/1.6 Microsoft YaHei,PingFang SC,system-ui,sans-serif}.top{display:flex;align-items:center;justify-content:space-between;padding:10px 18px;background:var(--brand);color:#fff}.top .brand{font-size:16px;font-weight:600;letter-spacing:.5px}.top nav button{margin-left:8px;padding:6px 12px;border:1px solid rgba(255,255,255,.5);background:transparent;color:#fff;border-radius:4px;cursor:pointer}.top nav button.on{background:#fff;color:var(--brand)}main{padding:16px 18px 40px}.card{background:var(--card);border:1px solid var(--line);border-radius:6px;padding:14px 16px;margin-bottom:14px}.card h2{margin:0 0 10px;font-size:15px}.card h2 small{color:var(--muted);font-weight:400}.hint{color:var(--muted);font-size:12.5px}table{width:100%;border-collapse:collapse;font-size:13px}th,td{border-bottom:1px solid var(--line);padding:6px 8px;text-align:left}th{background:#eef2f7;font-weight:600}tr.bad td{color:var(--bad)}code{font-family:Consolas,Courier New,monospace;font-size:12.5px}button.re{margin-left:10px;padding:2px 10px;cursor:pointer}ul{margin:6px 0 0 18px;padding:0}

release/web/index.html

@@ -4,8 +4,8 @@
   <meta charset="utf-8" />
   <meta name="viewport" content="width=device-width, initial-scale=1" />
   <title>观澜 · 风电数据分析与决策支持</title>
-  <script type="module" crossorigin src="./assets/index-4f5ZQCpg.js"></script>
-  <link rel="stylesheet" crossorigin href="./assets/index-BUpW38Qd.css">
+  <script type="module" crossorigin src="./assets/index-Bf733wmC.js"></script>
+  <link rel="stylesheet" crossorigin href="./assets/index-KYUMahna.css">
 </head>
 <body>
   <div id="app"></div>