README_先读我.txt: 精简到 32 行, 并改成 Windows / Linux / macOS 双平台写法

用户令: 言简意赅, 且考虑兼容支持 windows、linux。

## 体量

  原版 748 B / 9 行 → 上一版 5280 B / 56 行 → **现在 3360 B / 32 行**
  行尾保持 LF(逐字节核过), 编码 UTF-8 无 BOM(与原文件一致)。

## 双平台写法(先核事实, 不凭印象)

先核实了 Linux 侧真实存在什么, 再写:
  · `install.sh` 头部写明支持 **银河麒麟 V10 / 统信 UOS 20 / Ubuntu / CentOS / macOS**, 无合适系统 Python 时
    用包内便携运行时(`vendor/python/...`), 多版本机器可 `GUANLAN_PY=/usr/bin/python3.11 sh install.sh`;
  · 根目录**没有** start.sh/stop.sh/check.sh —— Linux 侧走 `guanlan.py check|serve|stop`;
  · Windows 侧是 install.bat/check.bat/start.bat/stop.bat 四个包装 + install.ps1。

因此 README 统一用一个占位符, 避免两套命令各写一遍:
  `<PY> = Windows 的 .venv\Scripts\python.exe 或 Linux·macOS 的 .venv/bin/python`
  命令行里**路径分隔符一律写 `/`**(两平台通用); Windows 用户也可以只双击 .bat 不敲命令。
  Windows / Linux 的安装与起停各一行, 并排写(解压位置、命令、停止方式)。

## 内容取舍(为什么这 32 行)

  一、安装(两平台各一行 + 无 Python 也能装 + 可选模型)
  二、启动/停止(两平台各一行 + 三个入口: 门户 / 工作台 /detail/ / 运维控制台 /ops)
  三、运维控制台 /ops: 一条标题说清"一个按钮一件事", 三行说清按钮规则(真实状态启用+后端 409 /
      启动自动开门户 / 停组件保留控制台 / 同时刻一个动作) 与"清除产物=挪走可恢复, 不动 data/raw"
  四、换数据后重算: 两条命令(放数据 + rebuild_all 及其开关) + 算成功判据 + 本包锚点
  五、必读(如实三条): 产物从哪来 · 随包补齐与 _provenance.json(20/568) · 某页没数据先看哪
  末尾: 包内含一行 + 详细说明一行(五个文档名)

## 事实核对(逐条打勾, 脚本读**当前**产物位置)

  来源台账 raw/shipped = 20/568 ✔ · alarms 39211 ✔ · workorders 5876 ✔ · oil 404 ✔ ·
  temp_monthly 19494 ✔ · 本体 9702 对象 ✔ · README 里引用的脚本/文档**全部存在** ✔ ·
  不再有残留的 Windows 专属命令(逐行扫过, 0 行)。

(注: 核对时发现产物已被"清除产物"挪到 `_products_off/rudong/`(10:30 的操作), 校验脚本因此改成
 两处都找; 这也顺带验证了控制台的按钮联动 —— 此刻状态正是 stop=false / start=true / off=false / on=true。)

README_先读我.txt

@@ -1,56 +1,40 @@
-观澜·如东样板 v2 0.2.0 (Windows 纯离线应用) — 单包全量
-
-一、首次安装
-1. 把本压缩包解压到 D:\guanlan\app (目录不要带空格和中文)
-2. 装 Python 3.12 (勾 Add to PATH), 在该目录运行: powershell -ExecutionPolicy Bypass -File install.ps1
-3. 装 Ollama Windows 版, 拉模型: ollama pull qwen3:8b / deepseek-r1:14b / bge-m3 (显存≥24G 再 qwen3.8:27b)
-   (本机模型只影响问答/本地审核页; 没装也不影响其它页面, 只会在自检里显示一项未就绪)
-
-二、日常使用
-4. 双击 check.bat 全绿 → 双击 start.bat → 会自动打开 http://127.0.0.1:28084/
-   停服务: 双击 stop.bat (它连网关一起停, 停完控制台页面也打不开, 要再起就用 start.bat)
-5. 运维控制台: http://127.0.0.1:28084/ops —— 一个按钮一件事: 停/启服务 · 执行重算 · 清除产物
-   · 按钮按真实状态启用: 不能做的动作按钮是灰的; 后端也会拒绝(直接打 API 一样返回 409)
-   · 启动服务(并打开门户)   有组件服务未运行时可用; 起来后自动打开 http://127.0.0.1:28084/
-   · 停止组件服务(保留控制台) 有组件在运行时可用; 只停 detail/cms/sim/sim_sys/viewer, 保留网关
-                            (保留的理由: 本页面就是网关提供的, 否则点完按钮页面就没了)
-   · 完整重启(含网关)       有组件在运行时可用; 页面会断开约 15 秒, 之后自己恢复
-   · 执行重算               没有任务在跑时可用; 等价于下面第 7 条的命令行, 可勾选含 SCADA / 末尾加等价验收
-   · 清除产物(可恢复)       产物在位时可用; 是"挪到 _products_off"不是删除, 随时能恢复
-   · 恢复产物               产物被清空过时可用 (恢复后请点"启动服务", 页面才有数)
-   · 同一时刻只允许一个动作: 有任务在跑时五个按钮全灰, 会话里能看到执行到哪一步、退出码与日志尾巴
-   · 页面同时显示: 各服务端口通不通 · 产物件数与分仓 · 来源台账 · 验收锚点 · 最近一次动作的状态
-
-三、换数据后重算 (命令行; 控制台里点"执行重算"等价)
-6. 放数据 (现场包 → 约定目录; 同尺寸文件自动跳过, 可反复跑):
-   .venv\Scripts\python.exe scripts\place_raw_data.py --src <现场包目录> --scope full
-7. 重算全部 (台账 → 月度派生件 → 补齐 → 本体 → 审计, 自动重启组件服务):
-   .venv\Scripts\python.exe scripts\rebuild_all.py              含 SCADA 侧 10 个构建器, 逐台读 ~14 GB, 约 15 分钟
-   .venv\Scripts\python.exe scripts\rebuild_all.py --skip-scada 只换了台账类数据时的常用档
-   可加 --src <现场包目录> 连"放数据"一起做; --dry-run 只看计划不执行; --with-verify 末尾加台账等价验收
-8. 怎么算"算成功了":
-   浏览器 http://127.0.0.1:28084/detail/ → 左栏「系统维护」两屏 (数据层/机理层, 每行给出条数/覆盖/末次更新)
-   命令行   .venv\Scripts\python.exe -m src.ontology.maintenance
-   本包锚点: 报警 39211 行 · 工单 5876 · 油样 404 · temp_monthly 19494 行 · 本体 9702 对象 (审计 0 问题)
-
-四、产物是什么、"随包补齐"是什么意思
-9. 页面上的数来自 outputs\rudong\ 里的产物; 产物由 data\raw\ 下的原始件算出来; data\raw\ 的下一级目录名
-   就是场站名称(扫描辨识, 不写死)。清产物≠清数据: 清的是产物, 不动 data\raw\、release\、logs\。
-10. outputs\rudong\_provenance.json 逐件记着来源:
-      raw-derived = 由 data\raw 重算出来的 (能证明的才这么标, 如 temp_monthly 与随包件逐值 19494/19494 一致)
-      shipped     = 包内没有生成端(或口径未复现), 用随包件补齐的
-    本包现状: raw 重算 20 件 + 随包补齐 568 件。想知道"这一页的数是自己算的还是随包带的", 查这份台账即可。
-
-五、某页没数据 / 报错怎么办
-11. 先看 运维控制台「最近一次动作」的退出码与日志尾巴, 以及 logs\ 下对应服务的日志。
-12. 再看 docs\重算缺口与补件清单_v0.1.md: 哪件产物缺、卡住哪个页面、找谁补、拿到后按什么判据验收。
-    (/cms/ 503、工作台"无产物"、油样 404 行这类都有逐条说明, 多数是"源件或生成端不在包内")
-
-包内含: 程序与配置 / 如东分析产物(+ outputs\rudong\_provenance.json 来源台账) / 门户与仿真 / 三维资产 (release\viewer) / 治理清单交付件 (release\如东, 客户交付物请勿外传) / Windows 离线依赖轮子 / 运维控制台 (http://127.0.0.1:28084/ops)
-
-详细说明 (本机 docs\ 下, 按需要看):
-  docs\说明书_观澜如东样板v2_v0.2.md      安装/日常使用/配置/常见故障 (用户向)
-  docs\重算操作手册_v0.1.md               手动与一条命令重算 · 清产物/恢复 · 运维控制台 (§0/§0b/§5b)
-  docs\数据目录结构与落位约定_v0.2.md      data\raw 落位约定 · 能重算什么/不能重算什么 (§4)
-  docs\重算缺口与补件清单_v0.1.md          缺件台账: 现象 · 原因 · 找谁 · 补齐判据
-  _修复记录_20260911\README.md            现场修复记录 (启动报错/路径跨平台化/数据链/本体审计等)
+观澜·如东样板 v2 0.2.0 — 单包全量离线应用 (Windows / Linux / macOS)
+
+<PY> = Windows 的 .venv\Scripts\python.exe, 或 Linux·macOS 的 .venv/bin/python;
+       命令里路径写 / 即可两平台通用; Windows 也可以只双击 .bat, 不必敲命令。
+
+一、安装 (约 10 分钟; 安装目录不要有空格和中文)
+  Windows : 解压到 D:\guanlan\app → 双击 install.bat        (自动选 Python → 建 .venv → 包内轮子离线装依赖)
+  Linux   : 解压到 /opt/guanlan  → sh install.sh            (麒麟 V10 / 统信 UOS 20 / Ubuntu / CentOS / macOS;
+                                                            多版本机器: GUANLAN_PY=/usr/bin/python3.11 sh install.sh)
+  没装 Python 的机器也能装: 包内有便携运行时, 安装脚本自动用。
+  模型(可选, 只影响问答与本地审核页): ollama pull qwen3:8b / deepseek-r1:14b / bge-m3
+
+二、启动 / 停止
+  Windows : 双击 check.bat 全绿 → 双击 start.bat (自动开浏览器)    停止: 双击 stop.bat
+  Linux   : <PY> guanlan.py check → <PY> guanlan.py serve           停止: <PY> guanlan.py stop
+  三个入口: 门户 http://127.0.0.1:28084/ · 工作台 /detail/ · 运维控制台 /ops
+
+三、运维控制台 /ops — 一个按钮一件事: 停/启服务 · 执行重算 · 清除产物
+  按钮按真实状态启用(不能做的灰, 后端也拒绝, 直接打 API 返回 409); "启动服务"起来后自动打开门户;
+  "停止组件服务"保留控制台本身; 同时刻只允许一个动作, 页面上有进度/退出码/日志尾巴。
+  清除产物 = 挪到 _products_off(可恢复), 不动 data/raw、release、logs。(控制台与重算链只用标准库, 两平台同源)
+
+四、换数据后重算 (一条命令; 控制台点"执行重算"等价)
+  <PY> scripts/place_raw_data.py --src <现场包目录> --scope full      放数据(同尺寸自动跳过, 可反复跑)
+  <PY> scripts/rebuild_all.py [--skip-scada] [--src <现场包目录>]     默认含 SCADA 侧约 15 分钟;
+       只换台账类数据加 --skip-scada(约 2 分钟); --dry-run 只看计划; 完事自动重启组件服务。
+  算成功判据: /detail/ 左栏「系统维护」两屏, 或 <PY> -m src.ontology.maintenance
+  本包锚点: 报警 39211 · 工单 5876 · 油样 404 · temp_monthly 19494 · 本体 9702 对象(审计 0 问题)
+
+五、必读 (如实)
+  · 页面的数来自 outputs/rudong 下的产物, 产物由 data/raw 下的原始件算出来(下一级目录名=场站名, 扫描辨识)。
+  · 随包里有一批产物**没有生成端**(pitch_daily、pc_monthly_bins、CMS/TCM 链等), 重算后由随包件补齐;
+    逐件来源见 outputs/rudong/_provenance.json (raw-derived 20 件 / shipped 568 件)。
+  · 某页没数据: 先看控制台「最近一次动作」的退出码与 logs/, 再看 docs/重算缺口与补件清单_v0.1.md。
+
+包内含: 程序与配置 / 如东分析产物(含 _provenance.json 来源台账) / 门户与仿真 / 三维资产 release/viewer /
+        治理清单交付件 release/如东(客户交付物勿外传) / 离线依赖轮子 / 便携运行时
+
+详细说明: docs/说明书_观澜如东样板v2_v0.2.md · docs/重算操作手册_v0.1.md
+          docs/数据目录结构与落位约定_v0.2.md · docs/重算缺口与补件清单_v0.1.md · _修复记录_20260911/README.md