观澜·如东样板 v2 0.2.0 — 单包全量离线应用 (Windows / Linux / macOS)
= 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 : guanlan.py check → guanlan.py serve 停止: guanlan.py stop
三个入口: 门户 http://127.0.0.1:28084/ · 工作台 /detail/ · 运维控制台 /ops
三、运维控制台 /ops — 一个按钮一件事: 停/启服务 · 执行重算 · 清除产物
按钮按真实状态启用(不能做的灰, 后端也拒绝, 直接打 API 返回 409); "启动服务"起来后自动打开门户;
"停止组件服务"保留控制台本身; 同时刻只允许一个动作, 页面上有进度/退出码/日志尾巴。
清除产物 = 挪到 _products_off(可恢复), 不动 data/raw、release、logs。(控制台与重算链只用标准库, 两平台同源)
四、换数据后重算 (一条命令; 控制台点"执行重算"等价)
scripts/place_raw_data.py --src <现场包目录> --scope full 放数据(同尺寸自动跳过, 可反复跑)
scripts/rebuild_all.py [--skip-scada] [--src <现场包目录>] 默认含 SCADA 侧约 15 分钟;
只换台账类数据加 --skip-scada(约 2 分钟); --dry-run 只看计划; 完事自动重启组件服务。
算成功判据: /detail/ 左栏「系统维护」两屏, 或 -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