vent_skills/vent-web-nav/references/pages.yaml

# ============================================================
# 通防平台页面注册表（权威数据源，人工维护）
# 分类结构对齐平台真实菜单（权限接口 getUserPermissionByToken 返回的菜单树）
# 每页字段说明：
#   id        唯一标识（英文，稳定）
#   name      页面名（匹配优先级最高）
#   aliases   别名（口语说法，如"主扇""局扇"）
#   keywords  关键词（包含匹配用）
#   menu_key  对应平台菜单 path（权限过滤依据；null=不接入菜单权限，默认展示）
#   path      相对路径（完整地址 = config.yaml 的 base_url + path）
#   desc      一句话功能简介（≤60字）
#   usage     操作指引步骤（仅实测页填写；null=待补充，回答时如实说明）
#   usage_tip 操作提示（可选）
#   visible   false=本部署未开通/未验证，所有流程跳过（默认 true 可省略）
#   note      维护备注
# 维护方法见 ADAPTATION.md；改本文件后须重新生成 pages.json
# ============================================================
version: "1.0"
updated: "2026-09-07"
stats:
  source: 通防平台页面导航梳理.docx + 182环境实机验证(lizuo) + 权限菜单树
  verified_detail: 26   # 逐页实机打开学习
  verified_pattern: 22  # 路由模式与实测页一致
  from_menu_unverified: 12  # 权限菜单确认存在、未逐页打开
  disabled: 21          # 404/未部署/待管理员核实

categories:
  # ================= 一、通防监控（平台主体） =================
  - id: tf-monitor
    name: 通防监控
    aliases: [通防, 监控, 平台主体, 一通三防]
    groups:
      # ---------- 智能通风 ----------
      - name: 智能通风
        aliases: [通风, 通风类, 通风系统]
        pages:
          - id: fanmain
            name: 主通风机监测与控制
            aliases: [主通风机, 主扇, 主要通风机, 主风机, 风机, 主通风机监测, 主通风机控制, 主通风机管控]
            keywords: [启停, 变频, 负压, 漏风率, fanmain]
            menu_key: /monitorChannel/monitor-fanmain
            path: /monitorChannel/monitor-fanmain?id=2087348159538384898&deviceType=fanmain
            desc: 主通风机管控详情：运行状态监测与远程启停/调节，查看风量、负压、漏风率及历史曲线。
            usage: null
            note: 默认设备为松定霍洛一号风机，进页后可切换
          - id: fanlocal
            name: 局部通风机监测与控制
            aliases: [局部通风机, 局扇, 局部风机, 局部通风, 局扇控制, 局部风机管控]
            keywords: [启停风机, 调频, 瓦斯闭锁, fanlocal]
            menu_key: /monitorChannel/monitor-fanlocal
            path: /monitorChannel/monitor-fanlocal?id=1712030595700707330&deviceType=fanlocal
            desc: 局部风机管控详情：启停风机、主/备机调频、需风量与瓦斯限值设定、工况辅助决策。
            usage:
              - 在「风机类型」下拉选择目标局扇（如变频局部风机）
              - 「启停风机」执行远程启停
              - 「主机调频 / 备机调频」调节运行频率
              - 「需风量」「瓦斯限值设定」配置风电闭锁与瓦斯闭锁阈值
              - 「工况辅助决策」查看运行建议；操作记录见「操作历史」tab
            usage_tip: 按钮置灰通常为通信中断或就地模式（现场旋钮未切远程）
          - id: windrect
            name: 测风装置
            aliases: [测风, 风速监测, 测风设备, 风量监测装置, 测风装置管控]
            keywords: [风速, 风量, 一键测风, windrect]
            menu_key: /monitorChannel/monitor-windrect
            path: /monitorChannel/monitor-windrect?id=1931597465741889538&deviceType=windrect
            desc: 测风设备管控详情：一键测风/复位，各测点风速、风量、风向实时监测与测风结果查询。
            usage:
              - 点击「一键测风」发起远程测风，等待完成
              - 「实时监测」tab查看各测点风速/风量/风向/断面积
              - 「测风结果」tab查看测风报告
              - 装置异常时点击「一键复位」
            usage_tip: 历史数据/报警历史在页签切换查看
          - id: gate
            name: 风门监测与控制
            aliases: [风门, 风门监测, 风门控制, 风门操控, 风门管控, 风门页面]
            keywords: [开门, 关门, 前门, 后门, 压差, gate]
            menu_key: /monitorChannel/monitor-gate
            path: /monitorChannel/monitor-gate?id=1796536612492324866&deviceType=gate
            desc: 风门管控详情：远程开闭前后门或同时开关，远程/就地/自动模式切换，状态与压差监测。
            usage:
              - 打开页面确认顶部分站型号（如 KJ-980-F 矿用本安型监控分站）
              - 控制模式选择「远程」（就地/自动由现场设定，远程才能手机/网页操作）
              - 按需点击「打开前门 / 关闭前门 / 同时打开 / 同时关闭」
              - 「实时监测」tab查看前/后门状态、压差、气源压力、报警等级
              - 操作记录在「操作历史」tab追溯
            usage_tip: 控制按钮置灰多为通信中断、气源压力不足或未切远程模式
          - id: window
            name: 风窗监测与控制
            aliases: [风窗, 调节风窗, 风窗控制, 风窗管控]
            keywords: [开度, 调节, window]
            menu_key: /monitorChannel/monitor-window
            path: /monitorChannel/monitor-window?id=1427837547259232258&deviceType=window
            desc: 风窗管控详情：风窗开度远程调节与状态监测，查看通过风量与压差。
            usage: null
          - id: sensor-monitor
            name: 气压温湿度监测
            aliases: [温湿度, 大气压, 气象监测, 环境参数监测]
            keywords: [温度, 湿度, 气压]
            menu_key: /monitorChannel/monitor-sensorMonitor
            path: /monitorChannel/monitor-sensorMonitor
            desc: 井下大气压、温度、湿度等环境参数实时监测与历史查询。
            usage: null
          - id: need-air
            name: 需风量计算与分析
            aliases: [需风量, 需风量计算, 需风量分析, 按需分风, 按需分风网络解算, 需风量分析系统]
            keywords: [计划风量, 回风井, 用风地点]
            menu_key: /micro-need-air/
            path: /micro-need-air/
            desc: 矿井需风量分析：按采煤/掘进/备用工作面、防爆胶轮车、硐室等用风地点多方法计算需风量。
            usage:
              - 顶部页签切换通风系统（全部/松定/明安木）或进入「回风井管理」
              - 按用风地点页签（采煤/掘进/备用工作面、防爆胶轮车、硐室、其他用风点）维护条目
              - 每条自动按气象条件/瓦斯涌出/CO₂涌出/按人员四种方法计算并取需风量
              - 「导出计划风量表」导出成果
          - id: work-account
            name: 通风能力核定
            aliases: [能力核定, 通风能力, 核定]
            keywords: [万t/a, 产量]
            menu_key: /micro-need-air/workAccount/
            path: /micro-need-air/workAccount/
            desc: 矿井通风能力核定：维护用风地点与工作面产量信息，核定矿井通风能力（万t/a）。
            usage:
              - 「矿井用风地点」维护用风点清单
              - 「采煤工作面产量信息」录入面长/采高/日推进度/回采率等
              - 系统自动核定矿井通风能力，在「通风能力核定」页签确认核定值
          - id: vents-monitor
            name: 通风系统监测
            aliases: [通风系统总览]
            keywords: [系统监测, ventS]
            menu_key: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=ventS
            path: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=ventS
            desc: 在三维模型上总览通风系统运行状态（菜单新增页，182环境实测可打开）。
            usage: null
          - id: netcal
            name: 通风网络解算
            aliases: [网络解算, 解算分析, 风网解算]
            keywords: [解算, netcal]
            menu_key: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=netcal
            path: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=netcal
            desc: 通风网络解算分析（菜单配置页，未逐页实测，启用前请访问验证）。
            usage: null
            visible: false
            note: 菜单可见未实测；验证后删掉 visible:false 即启用
          - id: timenetcal
            name: 实时网络解算
            aliases: [实时解算, 网络解算]
            keywords: [实时, 解算, timenetcal, 仪表盘解算]
            menu_key: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=timenetcal
            path: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=timenetcal
            desc: 基于实时监测数据的通风网络解算：展示本次解算时间、解算总进风量等结果，支持网络分析。
            usage:
              - 工具栏点「实时解算」发起基于实时监测数据的网络解算
              - 查看本次解算时间、解算总进风量(m³/min)等解算结果
              - 需要更多分析时切换工具：通风网络解算 / 控风方案决策 / 通风系统评价 / 火灾模拟 / 通风网络分析
          - id: path-decison
            name: 控风方案辅助决策
            aliases: [控风方案, 控风决策, 辅助决策, 通风系统辅助调整]
            keywords: [方案, 决策, pathDecison, 网络解算]
            menu_key: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=pathDecison
            path: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=pathDecison
            desc: 在通风网络图上辅助决策：网络解算、实时解算、控风方案对比、通风系统评价、火灾模拟。
            usage:
              - 在模型图上点选巷道/设施查看属性
              - 工具栏选「通风网络解算 / 实时解算」发起解算
              - 「控风方案决策」生成并对比多套调控方案
              - 「通风系统评价」查看系统评价结果
      # ---------- 灾害预警 ----------
      - name: 灾害预警
        aliases: [预警, 预警类]
        pages:
          - id: alarm-home
            name: 多灾融合预警
            aliases: [多灾, 融合预警, 综合预警, 预警中心, 预警大屏, 预警监测]
            keywords: [风险得分, 灾种]
            menu_key: /monitorChannel/monitor-alarm-home
            path: /monitorChannel/monitor-alarm-home
            desc: 预警监测管控系统：通风/火灾/粉尘/瓦斯/设备预警、瓦斯等级鉴定、水灾顶板风险融合研判。
            usage:
              - 总览各灾种风险等级与风险得分
              - 点击灾种卡片（火灾/瓦斯/粉尘/通风/设备）进入对应预警详情
              - 查看矿井瓦斯等级鉴定、水灾、顶板状态
          - id: sysfiretest
            name: 灾变应急控风决策
            aliases: [灾变, 应急控风, 灾变模拟, 避灾路线规划, 灾变应急控制]
            keywords: [火灾, 应急, 模拟, sysfiretest]
            menu_key: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=sysfiretest
            path: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=sysfiretest&sysID=2092149452501004289&deviceid=2012326636757958658
            desc: 火灾等灾变场景的应急控风模拟与决策支持（含灾变模拟与避灾路线规划）。
            usage: null
            note: sysID/deviceid 已按当前菜单值更新（docx 旧参数已过期）
          - id: ventilate-warn
            name: 通风监测预警
            aliases: [通风预警]
            keywords: [通风, 预警]
            menu_key: /ventilate/warn/home
            path: /ventilate/warn/home
            desc: 通风专项监测预警（菜单配置页，未逐页实测，启用前请访问验证）。
            usage: null
            visible: false
            note: 菜单可见未实测；验证后删掉 visible:false 即启用
          - id: device-warn
            name: 设备监测预警
            aliases: [设备预警]
            keywords: [设备, 预警]
            menu_key: /device/warn/home
            path: /device/warn/home
            desc: 设备运行状态监测预警（菜单配置页，未逐页实测，启用前请访问验证）。
            usage: null
            visible: false
            note: 菜单可见未实测；验证后删掉 visible:false 即启用
          - id: warn-linkage
            name: 预警联动控制
            aliases: [预警联动, 联动控制]
            keywords: [联动, workingFace]
            menu_key: /deviceManager/workingFace
            path: /deviceManager/workingFace
            desc: 预警联动控制配置（菜单配置页，未逐页实测，启用前请访问验证）。
            usage: null
            visible: false
            note: 菜单可见未实测；验证后删掉 visible:false 即启用
      # ---------- 火灾监控 ----------
      - name: 火灾监控
        aliases: [火灾, 火灾类, 防灭火, 防灭火类]
        pages:
          - id: fiber
            name: 光纤测温
            aliases: [光纤, 测温, 分布式测温, 光纤测温监测]
            keywords: [温度, 光纤, fiber]
            menu_key: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=fiber
            path: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=fiber&tabtype=monitor
            desc: 分布式光纤测温监测：井下沿线温度实时曲线与超温报警分析。
            usage: null
          - id: bundletube
            name: 束管监测
            aliases: [束管, 束管监测]
            keywords: [色谱, 气体, bundletube]
            menu_key: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=bundletube
            path: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=bundletube
            desc: 束管色谱监测：各测点 CO/CO₂/O₂/CH₄ 等气体浓度实时监测与趋势分析。
            usage: null
          - id: sensor-temperature
            name: 温度传感器
            aliases: [温度, 温度监测, 温度传感器监测]
            keywords: [温度, modelsensor_temperature]
            menu_key: null
            path: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=modelsensor_temperature&deviceid=
            desc: 井下温度传感器实时数据监测与历史查询（模型叠加展示）。
            usage: null
            note: 菜单未单独配置（menu_key 空=不做权限过滤）；deviceid 留空默认全部测点
          - id: sensor-smoke
            name: 烟雾传感器
            aliases: [烟雾, 烟雾监测]
            keywords: [烟雾, modelsensor_smoke]
            menu_key: null
            path: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=modelsensor_smoke&deviceid=
            desc: 烟雾传感器实时监测与报警查询（模型叠加展示）。
            usage: null
            note: 菜单未单独配置；deviceid 留空默认全部测点
          - id: sensor-co
            name: CO传感器
            aliases: [CO, 一氧化碳, CO监测]
            keywords: [CO, 一氧化碳, modelsensor_co]
            menu_key: null
            path: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=modelsensor_co&deviceid=
            desc: 一氧化碳传感器实时监测与历史数据分析（模型叠加展示）。
            usage: null
            note: 菜单未单独配置；deviceid 留空默认全部测点
          - id: firedoor
            name: 防火门监测与控制
            aliases: [防火门, 防火门控制, 防火门监测]
            keywords: [开门, 防火, door, firedoor]
            menu_key: /monitorChannel/monitor-firedoor
            path: /monitorChannel/monitor-firedoor?id=2019226919389147138&deviceType=door
            desc: 防火门开闭状态监测与远程控制，异常报警提示。
            usage: null
            note: deviceType 为 door（非 firedoor）
          - id: nitrogen
            name: 注氮系统
            aliases: [注氮, 制氮, 氮气, 智能注氮系统]
            keywords: [氮气, 防灭火, nitrogen]
            menu_key: /nitrogen-home
            path: /nitrogen-home
            desc: 智能注氮系统：制氮设备运行状态、注氮管路参数与远程控制。
            usage: null
            note: 加载较慢（约5-10秒），耐心等待
          - id: grout
            name: 注浆系统
            aliases: [注浆, 浆液, 智能注浆系统]
            keywords: [注浆, 防灭火, grout]
            menu_key: /grout-home
            path: /grout-home
            desc: 智能注浆系统：注浆设备状态、浆液参数与远程控制。
            usage: null
          - id: fire-warn
            name: 火灾监测预警
            aliases: [火灾预警, 火灾监测, 火灾监测预警页面]
            keywords: [内因火灾, 外因火灾, 火灾指标]
            menu_key: /fire/warn/home
            path: /fire/warn/home?p=0
            desc: 火灾监测预警：内因/外因火灾指标监测与预警分析。
            usage:
              - 「内因火灾」查看采空区/煤层自然发火指标
              - 「外因火灾」查看外因火灾监测点状态
              - 「火灾指标」查看各指标变化趋势
          - id: fires-monitor
            name: 防灭火系统监测
            aliases: [防灭火监测]
            keywords: [防灭火, fireS]
            menu_key: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=fireS
            path: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=fireS
            desc: 防灭火系统综合监测（菜单配置页，未逐页实测，启用前请访问验证）。
            usage: null
            visible: false
            note: 菜单可见未实测；验证后删掉 visible:false 即启用
          - id: bundle-table
            name: 束管日报分析
            aliases: [束管日报, 束管报表, 束管台账]
            keywords: [日报, 自燃阶段]
            menu_key: /bundle/bundleTable
            path: /bundle/bundleTable
            desc: 束管日报台账：管理束管日报文件，分析各测点气体成分并判定煤自燃阶段。
            usage:
              - 左侧文件列表选择束管日报（Excel）
              - 表格查看各测点 CO/CO₂/O₂/CH₄/C₂H₂/C₂H₄/N₂ 浓度
              - 依据「煤自燃阶段」列判定自然发火阶段
          - id: bundlespy-table
            name: 色谱仪报表分析
            aliases: [色谱仪, 色谱, 色谱分析]
            keywords: [色谱, 报表]
            menu_key: /bundleSpy/bundleSpyTable
            path: /bundleSpy/bundleSpyTable
            desc: 色谱仪报表台账管理与分析。
            usage: null
      # ---------- 瓦斯监控 ----------
      - name: 瓦斯监控
        aliases: [瓦斯, 瓦斯类, 瓦斯防治]
        pages:
          - id: gaspatrol
            name: 瓦斯巡检
            aliases: [巡检, 瓦斯巡检, 瓦斯巡检设备]
            keywords: [巡检, gaspatrol]
            menu_key: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=gaspatrol
            path: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=gaspatrol
            desc: 瓦斯巡检数据在三维模型中的展示与定位，左侧设备树按灾种分类导航。
            usage:
              - 左侧设备树按 通风/防灭火/防尘/瓦斯/综合/关键地点 分类展开
              - 点击设备节点在模型中定位
              - 「定位图标显示」开关控制图标显隐
          - id: sensor-gas
            name: 瓦斯传感器
            aliases: [甲烷, 甲烷传感器, 瓦斯传感器, CH4, 瓦斯浓度, 瓦斯监测]
            keywords: [甲烷, 浓度, gasmonitor]
            menu_key: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=gasmonitor
            path: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=gasmonitor
            desc: 甲烷/瓦斯浓度实时监测与历史查询（模型叠加展示）。
            usage: null
            note: menu_key 用菜单的 gasmonitor 路由；docx 旧地址 modelsensor_gas 也可用（deviceid 留空）
          - id: gas-pump
            name: 瓦斯抽采设备
            aliases: [抽采, 抽放, 瓦斯泵, 抽采泵, 抽采泵站监测]
            keywords: [泵站, 抽采, 振幅]
            menu_key: /gas/gas-pump-monitor/home
            path: /gas/gas-pump-monitor/home
            desc: 瓦斯抽采泵站监测：电压电流、轴温、振幅、运行时间等工况参数。
            usage:
              - 泵站下拉切换（地上/地下抽采泵）
              - 查看各泵（t1~t4）电压/电流/前后轴温度/振幅/运行时间
              - 异常参数高亮告警
          - id: gas-assessment
            name: 抽采达标评判
            aliases: [达标评判, 抽采达标]
            keywords: [达标, 储量]
            menu_key: /gasAssessment/home
            path: /gasAssessment/home
            desc: 瓦斯抽采达标评判：瓦斯总储量、抽采达标量、累计抽采量、预抽确认量对比分析。
            usage:
              - 工作面下拉选择目标工作面
              - 查看瓦斯总储量/抽采达标量/累计抽采量/预抽确认量/已抽时间
              - 对照评判结论确认是否达标
          - id: gas-home
            name: 抽采综合管控
            aliases: [抽采管控]
            keywords: [抽采, 综合管控]
            menu_key: /micro-vent-3dModal/configurable/gasHome/gasS/home
            path: /micro-vent-3dModal/configurable/gasHome/gasS/home
            desc: 瓦斯抽采综合管控大屏（菜单配置页，未逐页实测，启用前请访问验证）。
            usage: null
            visible: false
            note: 菜单可见未实测；验证后删掉 visible:false 即启用
          - id: gas-pipenet
            name: 瓦斯管网管控
            aliases: [管网, 瓦斯管网]
            keywords: [管网, 管路]
            menu_key: /micro-vent-3dModal/configurable/gasPipeNet/gasS/home?type=sysMonitor&deviceType=pipingpage
            path: /micro-vent-3dModal/configurable/gasPipeNet/gasS/home?type=sysMonitor&deviceType=pipingpage
            desc: 瓦斯管网（抽采管路）监测管控（菜单配置页，未逐页实测，启用前请访问验证）。
            usage: null
            visible: false
            note: 菜单可见未实测；验证后删掉 visible:false 即启用
          - id: gas-zk
            name: 瓦斯钻孔监测
            aliases: [钻孔, 瓦斯钻孔, 打钻监测]
            keywords: [钻杆, 钻孔]
            menu_key: /gasZkMonitor
            path: /gasZkMonitor
            desc: 瓦斯钻孔实时监测：钻场视频、钻杆状态、钻孔计数与剩余。
            usage:
              - 查看钻孔实时视频画面
              - 监控钻杆状态/钻孔计数/钻孔剩余
          - id: gas-warn
            name: 瓦斯综合预警
            aliases: [瓦斯预警, 瓦斯监测预警]
            keywords: [预警, 预测曲线]
            menu_key: /gas/warn/home
            path: /gas/warn/home?p=0
            desc: 瓦斯监测预警：煤层预警状态、抽采泵信息、安全监控测点信息与预测曲线。
            usage:
              - 「预警监测」查看各煤层（如22煤/42煤）预警状态
              - 「瓦斯抽采泵信息」查看泵站运行
              - 「安全监控测点信息」查看甲烷浓度/测点位置/数据时间与预测曲线
          - id: gas-report
            name: 瓦斯日报分析
            aliases: [瓦斯日报, 瓦斯报表, 瓦斯台账]
            keywords: [日报, 手工录入]
            menu_key: /gas/gas-report-inspect
            path: /gas/gas-report-inspect
            desc: 瓦斯日报台账手工录入与分析。
            usage: null
      # ---------- 粉尘监控 ----------
      - name: 粉尘监控
        aliases: [粉尘, 粉尘类, 防尘, 防尘类]
        pages:
          - id: dusting
            name: 粉尘传感器
            aliases: [粉尘, 粉尘浓度, 粉尘监测, 粉尘传感器监测]
            keywords: [浓度, dusting]
            menu_key: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=dusting
            path: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=dusting&tabtype=monitor
            desc: 粉尘浓度实时监测与历史数据查询（模型叠加展示）。
            usage: null
          - id: atomizing
            name: 喷雾降尘
            aliases: [喷雾, 降尘, 喷雾降尘监控, 喷雾装置]
            keywords: [喷雾, 降尘, atomizing]
            menu_key: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=atomizing
            path: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=atomizing
            desc: 喷雾降尘装置远程控制与状态监测。
            usage: null
          - id: dedustefan
            name: 除尘风机
            aliases: [除尘风机, 除尘]
            keywords: [除尘, dedustefan]
            menu_key: /dust/dedustefan/home
            path: /dust/dedustefan/home
            desc: 除尘风机运行监测与远程控制。
            usage: null
          - id: dust-warn
            name: 粉尘监测预警
            aliases: [粉尘预警, 粉尘报警]
            keywords: [预警, 超标]
            menu_key: /dust/warn/home
            path: /dust/warn/home
            desc: 粉尘浓度监测预警与超标报警分析。
            usage: null
          - id: dusts-monitor
            name: 防尘系统监测
            aliases: [防尘监测]
            keywords: [防尘, dustS]
            menu_key: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=dustS
            path: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=dustS
            desc: 防尘系统综合监测（菜单配置页，未逐页实测，启用前请访问验证）。
            usage: null
            visible: false
            note: 菜单可见未实测；验证后删掉 visible:false 即启用
          - id: dust-table
            name: 粉尘报表分析
            aliases: [粉尘报表, 粉尘台账, 粉尘日报]
            keywords: [报表, 手工录入]
            menu_key: /dust/dustMonitorTable
            path: /dust/dustMonitorTable
            desc: 粉尘报表台账手工录入与分析。
            usage: null
      # ---------- 关键场景 ----------
      - name: 关键场景
        aliases: [工作面, 场景管控, 联动管控, 综合预警与联动管控]
        pages:
          - id: worker-face
            name: 采煤工作面综合管控
            aliases: [采煤面, 综采面, 回采面, 采面, 采煤工作面]
            keywords: [工作面, 综采]
            menu_key: /monitorChannel/wokerFace-home
            path: /monitorChannel/wokerFace-home
            desc: 综采面智能管控：按工作面查看通风、防灭火、防尘、瓦斯防治四域综合监测管控。
            usage:
              - 工作面下拉选择（如 15212 工作面）
              - 按「通风/防灭火/防尘/瓦斯防治」监测与管控分区查看
              - 「通风参数监测」卡片查看进风/回风/需风量
          - id: tun-face
            name: 掘进工作面综合管控
            aliases: [掘进面, 掘进, 掘面, 掘进工作面]
            keywords: [掘进, 工作面]
            menu_key: /monitorChannel/tunFace-home
            path: /monitorChannel/tunFace-home
            desc: 掘进工作面智能管控：通风、瓦斯、粉尘等综合监测与管控。
            usage: null
          - id: firedoor-monitor
            name: 防火门智能管控
            aliases: [防火门管控, 防火门智能]
            keywords: [防火门, 工作面]
            menu_key: /configurable/default/fireDoorMonitor/home
            path: /configurable/default/fireDoorMonitor/home
            desc: 工作面防火门监控系统：温度/CO传感器数据分析与防火门联动管控。
            usage:
              - 工作面下拉选择目标工作面
              - 查看温度/CO 传感器平均值/最大值/最小值/是否报警
              - 联动查看防火门设备状态
          - id: belt-fire
            name: 皮带三级灭火系统
            aliases: [皮带, 皮带灭火, 三级灭火, 带式输送机灭火]
            keywords: [皮带, 灭火]
            menu_key: /micro-vent-3dModal/configurable/belt/fireS/home
            path: /micro-vent-3dModal/configurable/belt/fireS/home
            desc: 皮带输送机三级灭火监测与联动控制总览。
            usage: null
          - id: belt-tun
            name: 皮带巷管控系统
            aliases: [皮带巷]
            keywords: [皮带巷, 管控]
            menu_key: /monitorChannel/beltTun-home
            path: /monitorChannel/beltTun-home
            desc: 皮带巷智能管控：通防综合监测与通风/防灭火/防尘分区管控。
            usage:
              - 查看皮带巷通防综合监测（总风量等）
              - 按「通风/防灭火/防尘」监测与管控分区查看
          - id: balance-press
            name: 均压与低氧管控
            aliases: [均压, 低氧, 均压通风, 均压控制]
            keywords: [CO限值, O2限值, 自动调节]
            menu_key: /monitorChannel/balancePress-home
            path: /monitorChannel/balancePress-home
            desc: 均压与低氧参数监测与设置：CO/O₂浓度限值设定与均压自动调节。
            usage:
              - 「均压通风系统」下拉选择系统
              - 「自动调节」选择开启/关闭
              - 设定开始条件：CO 浓度限值(%)、O₂ 浓度限值(%)
              - 监测均压与低氧实时参数
          - id: chamber
            name: 机电硐室管控
            aliases: [硐室, 机电硐室, 硐室火灾, 硐室火灾综合管控]
            keywords: [硐室, 机电]
            menu_key: /chamber-home
            path: /chamber-home
            desc: 机电硐室火灾综合监测与管控。
            usage: null
            visible: false
            note: ⚠️182环境两条地址均404（/chamber-home 与 docx 的 /electro-chamber/home），菜单有配置但路由未部署；新环境部署后验证启用
      # ---------- 综合管控 ----------
      - name: 综合管控
        aliases: [第三方系统, 第三方, 外围系统]
        pages:
          - id: forcfan
            name: 压风系统
            aliases: [压风, 空压机, 压风自救, 压风管控]
            keywords: [空压机, 排气压力]
            menu_key: /forcFan/home
            path: /forcFan/home
            desc: 智能压风管控系统：空压机运行时间、排气压力/温度、机组温度等监测与控制。
            usage:
              - 查看各空压机（空压机1…）运行时间/卸载压力/排气压力/排气温度/机组温度
              - 点击空压机卡片进入详情与控制
          - id: safetymonitor
            name: 安全监控
            aliases: [安全监控, 安全监测, 监控系统, KJ系统]
            keywords: [安全监控, 测点]
            menu_key: /monitorChannel/device-monitor/safetymonitor
            path: /monitorChannel/device-monitor/safetymonitor
            desc: 安全监控系统数据对接：实时监测、历史数据、报警历史、报警分析四类视图。
            usage:
              - 「设备类型」下拉 +「设备安装地点」搜索筛选测点
              - Tab 切换：实时监测 / 历史数据 / 报警历史 / 报警分析
          - id: location
            name: 人员定位
            aliases: [定位, 人员, 人员位置, 人员定位系统]
            keywords: [轨迹, 人员]
            menu_key: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=location
            path: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=location&tabtype=monitor
            desc: 井下人员位置实时显示与轨迹查看（模型叠加）。
            usage: null
          - id: vehicle
            name: 车辆定位
            aliases: [车辆, 车辆位置, 车辆定位系统]
            keywords: [车辆, 轨迹]
            menu_key: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=vehicle
            path: /micro-vent-3dModal/dashboard/analysis?type=tunMonitor&deviceType=vehicle
            desc: 井下车辆位置实时显示与轨迹查看。
            usage: null
          - id: camera
            name: 视频墙
            aliases: [视频, 监控视频, 摄像头, 视频监控, 视频墙]
            keywords: [视频, 摄像头]
            menu_key: /camera
            path: /camera
            desc: 井下多路视频监控墙实时查看。
            usage: null
            note: 加载较慢，耐心等待
          - id: escaperoute
            name: 避灾路线
            aliases: [避灾, 逃生路线]
            keywords: [避灾, 路线]
            menu_key: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=escaperoute
            path: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=escaperoute
            desc: 避灾路线模拟与展示（菜单隐藏页，未实测，启用前请访问验证）。
            usage: null
            visible: false
            note: 菜单hidden配置；验证后删掉 visible:false 即启用
          - id: fire-sim
            name: 火灾模拟
            aliases: [火灾模拟]
            keywords: [模拟, 火灾]
            menu_key: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=fire
            path: /micro-vent-3dModal/dashboard/analysis?type=sysMonitor&deviceType=fire
            desc: 火灾扩散模拟（菜单隐藏页，未实测，启用前请访问验证）。
            usage: null
            visible: false
            note: 菜单hidden配置；验证后删掉 visible:false 即启用
      # ---------- 综合业务管理 ----------
      - name: 综合业务管理
        aliases: [业务管理, 报表, 文件]
        pages:
          - id: file-manager
            name: 文件共享中心
            aliases: [文件, 文件中心, 资料, 文档, 共享文件]
            keywords: [文件, 下载, 资料]
            menu_key: /fileManager/fileDetail/home
            path: /fileManager/fileDetail/home
            desc: 平台文档分类共享：设备设施、通防资料、防灭火、瓦斯防治、矿井基础数据等分类检索。
            usage:
              - 左侧分类树选择（设备设施数据/通防系统资料/粉尘/防灭火/瓦斯防治数据/矿井基础数据）
              - 按文件名称/文件类型查询
              - 点击文件预览或下载
          - id: report-manager
            name: 报表管理
            aliases: [报表中心, 报表管理中心]
            keywords: [报表, 模板]
            menu_key: /report/managerment/home
            path: /report/managerment/home
            desc: 报表管理中心：系统数据报表/手动报表/报表模板，覆盖通风、防灭火、防尘、瓦斯四域。
            usage:
              - 选择报表类型：系统数据报表 / 手动报表 / 报表模板
              - 按通风/防灭火/防尘/瓦斯四域查看与导出
              - 手动报表支持在线录入
          - id: report-map
            name: 报表数据映射
            aliases: [数据映射]
            keywords: [映射, 报表]
            menu_key: /report-map
            path: /report-map
            desc: 报表数据源映射配置（菜单配置页，未逐页实测，启用前请访问验证）。
            usage: null
            visible: false
            note: 菜单可见未实测；验证后删掉 visible:false 即启用
          - id: file-approve
            name: 文件审批
            aliases: [审批, 文件审核]
            keywords: [审批, 文件]
            menu_key: /fileManager/approve/home
            path: /fileManager/approve/home
            desc: 文件共享审批流程（菜单配置页，未逐页实测，启用前请访问验证）。
            usage: null
            visible: false
            note: 菜单可见未实测；验证后删掉 visible:false 即启用

  # ================= 二、首页与大屏 =================
  - id: home
    name: 首页与大屏
    aliases: [首页, 大屏, 首页大屏]
    pages:
      - id: model-3d
        name: 首页3D（三维模型）
        aliases: [三维, 3D, 三维模型, 模型, 数字孪生, 大屏, 首页, 平台首页, 网络解算, 三维网络解算, 模型解算]
        keywords: [全矿井通风检测, 总回风量, 主通风机系统, 解算分析]
        menu_key: /micro-vent-3dModal/configurable/default/ventS/home
        path: /micro-vent-3dModal/configurable/default/ventS/home?type=model3D&deviceType=model3D&isNoReverse=1
        desc: 全矿井三维数字孪生大屏：通风检测总览、主/局通风机系统、工作面智能监控、关键路线、预警监测。
        usage:
          - 卡片左右切换箭头（swap）查看不同设备/工作面
          - 点击「通风设施远程控制」进入设施控制
          - 右上角机器人图标打开智能助手
          - 「特效模式」切换大屏动效
        note: 用户口语"网络解算/解算分析"可能指本页（docx 原分类即将其归入三维模型页），与【实时网络解算】构成歧义对
      - id: model-2d
        name: 首页2D（二维模型）
        aliases: [二维, 2D, 二维模型, 通风网络图]
        keywords: [拓扑分析, 网络图, 编辑]
        menu_key: /micro-vent-2dModal/configurable/default/ventS/home
        path: /micro-vent-2dModal/configurable/default/ventS/home?type=model3D&deviceType=model3D&isNoReverse=1
        desc: 二维通风网络模型：系统、拓扑分析、网络故障诊断、网络分析、数据分析、数据管理、工具。
        usage:
          - 菜单栏选择：系统 / 拓扑分析 / 通风网络故障诊断 / 通风网络分析 / 数据分析 / 数据管理 / 工具
          - 「编辑」进入网络图编辑模式

  # ================= 三、系统配置（管理员） =================
  - id: system-config
    name: 系统配置
    aliases: [系统管理, 后台管理, 系统设置]
    pages:
      - id: sys-user
        name: 用户管理设置
        aliases: [用户管理, 账号管理, 添加用户, 用户设置]
        keywords: [用户, 账号]
        menu_key: null
        path: /monitorChannel/system/user
        desc: 用户账号新增、删除与配置。
        usage: null
        visible: false
        note: ⚠️需管理员权限（lizuo实测404）；菜单key与真实路由待管理员账号核实后填写
      - id: sys-role
        name: 角色管理
        aliases: [角色, 权限管理, 角色设置]
        keywords: [角色, 权限, 菜单权限]
        menu_key: null
        path: /monitorChannel/system/user
        desc: 角色绑定用户、角色菜单与按钮权限设置。
        usage: null
        visible: false
        note: ⚠️docx与用户管理同址，疑笔误；真实路由待管理员核实
      - id: sys-project
        name: 系统项目配置
        aliases: [项目配置, 系统标题, 修改logo]
        keywords: [logo, 标题, 配置]
        menu_key: null
        path: /monitorChannel/system/project-setting
        desc: 修改系统 logo、系统标题等项目配置。
        usage: null
        visible: false
        note: ⚠️需管理员权限（lizuo实测404）；待管理员核实

  # ================= 四、设备台账管理（未验证，默认关闭） =================
  - id: device-ledger
    name: 设备台账管理
    aliases: [台账, 设备管理, 设备台账]
    note: 以下台账页来自权限菜单「设备管理」分组，路径未实测，验证后逐个删除 visible:false 启用
    pages:
      - { id: ledger-gate, name: 风门管理, aliases: [风门台账], keywords: [台账], menu_key: /gate, path: /gate, desc: 风门设备台账维护。, usage: null, visible: false }
      - { id: ledger-window, name: 风窗管理, aliases: [风窗台账], keywords: [台账], menu_key: /window, path: /window, desc: 风窗设备台账维护。, usage: null, visible: false }
      - { id: ledger-windrect, name: 测风设备管理, aliases: [测风台账], keywords: [台账], menu_key: /windrect, path: /windrect, desc: 测风设备台账维护。, usage: null, visible: false }
      - { id: ledger-fanlocal, name: 局部风机管理, aliases: [局扇台账], keywords: [台账], menu_key: /fanlocal, path: /fanlocal, desc: 局部通风机台账维护。, usage: null, visible: false }
      - { id: ledger-fanmain, name: 主风机管理, aliases: [主扇台账], keywords: [台账], menu_key: /fanmain, path: /fanmain, desc: 主通风机台账维护。, usage: null, visible: false }
      - { id: ledger-forcfan, name: 压风机管理系统, aliases: [压风机台账], keywords: [台账], menu_key: /forcFan, path: /forcFan, desc: 压风机设备台账维护。, usage: null, visible: false }
      - { id: ledger-dusting, name: 粉尘设备管理, aliases: [粉尘台账], keywords: [台账], menu_key: /dusting, path: /dusting, desc: 粉尘防治设备台账维护。, usage: null, visible: false }
      - { id: ledger-bundletube, name: 束管管理, aliases: [束管台账], keywords: [台账], menu_key: /bundletube, path: /bundletube, desc: 束管设备台账维护。, usage: null, visible: false }
      - { id: ledger-fiber, name: 光纤管理, aliases: [光纤台账], keywords: [台账], menu_key: /fiber, path: /fiber, desc: 光纤测温设备台账维护。, usage: null, visible: false }
      - { id: ledger-door, name: 防火门管理, aliases: [防火门台账], keywords: [台账], menu_key: /door, path: /door, desc: 防火门台账维护。, usage: null, visible: false }
      - { id: ledger-dustdev, name: 喷粉管理, aliases: [喷粉台账], keywords: [台账], menu_key: /dustdev, path: /dustdev, desc: 喷粉设备台账维护。, usage: null, visible: false }
      - { id: ledger-pulping, name: 注浆管理, aliases: [注浆台账], keywords: [台账], menu_key: /pulping, path: /pulping, desc: 注浆设备台账维护。, usage: null, visible: false }
      - { id: ledger-spray, name: 喷淋管理, aliases: [喷淋台账], keywords: [台账], menu_key: /spray, path: /spray, desc: 喷淋设备台账维护。, usage: null, visible: false }
      - { id: ledger-nitrogen, name: 注氮管理, aliases: [注氮台账], keywords: [台账], menu_key: /nitrogen, path: /nitrogen, desc: 注氮设备台账维护。, usage: null, visible: false }
      - { id: ledger-pump, name: 抽采泵管理, aliases: [抽采泵台账], keywords: [台账], menu_key: /pump, path: /pump, desc: 瓦斯抽采泵台账维护。, usage: null, visible: false }
      - { id: ledger-gaspatrol, name: 瓦斯巡检管理, aliases: [巡检台账], keywords: [台账], menu_key: /gaspatrol, path: /gaspatrol, desc: 瓦斯巡检设备台账维护。, usage: null, visible: false }
      - { id: ledger-gasmonitor, name: 瓦斯监测设备, aliases: [瓦斯监测台账], keywords: [台账], menu_key: /gasmonitor, path: /gasmonitor, desc: 瓦斯监测设备台账维护。, usage: null, visible: false }