智能运维终端 App 操作说明书

文档名称：智能运维终端（DMsysGApp）操作说明书
文档版本：V1.1
适用产品：智能运维终端（Android 移动端）
工程目录：DMsysGApp
编制说明：本文档以 App 单端视角编写，面向现场运维员、场站管理员、实施与测试人员，逐章说明各板块功能项与操作点。与 Web 管理端、后端服务的协作关系见附录 C；离线登录与用户协议设计见 App离线登录与用户协议设计.md；离线缓存技术细节见 App离线数据与缓存清理规则.md；图纸 LOCAL/云端图页设计见 App图纸中心本地与云端图页设计.md；三端联调流程见 三端功能操作流程.md。

第 0 章 文档说明

0.1 适用范围

本说明书适用于在工业现场（有色冶炼、风电等场景）使用 智能运维终端 Android 应用的全体人员，涵盖登录认证、首页工作台、图纸中心、资料库、运维工单、设备扫码、AI 助理、个人中心及数据同步等全部功能模块。

0.2 术语与缩写

0.3 全局手势与图标说明

0.4 三种使用模式对比

第 1 章 系统概述与应用价值

1.1 功能概述

智能运维终端是设备智能运维平台（DMsys）的现场执行端，与 Web 管理端、云端服务构成 「Web 管配置 + App 做执行 + 云端做同步」 三位一体架构。应用 Slogan 为：保障熔炼电解主线连续运行，离线可用，检修 3 步闭环。

系统面向炉前、槽边、管廊等网络不稳定或信号屏蔽严重的工业现场，让运维人员无需返回办公室即可查阅图纸、规程、填报工单并获得 AI 辅助诊断。

1.2 系统六大特点

1.3 应用价值

对现场运维员

• 紧急故障时，工作台高亮告警并一键跳转 AI 诊断
• 扫码识设备后，同屏查看关联图纸、资料与历史工单
• 无网环境可查阅已缓存图包与规程，语音录入故障描述
• 三步完成工单填报，减少纸质记录与事后补录

对场站管理员

• 工单全过程留痕，含执行结果、处理人、核实人
• 未同步工单有明确徽章，便于督促并网上传
• 通过 Web 端配置授权，控制图包、资料、设备可见范围

对企业

• 缩短抢修窗口，减少因「查不到图、找不到资料」导致的停机延长
• 运维知识资产（图纸、规程、工单记录）数字化沉淀
• 工单数据可导出、可考核，过程可追溯

1.4 功能架构

flowchart TB
    subgraph global [全局壳层]
        TopBar[顶栏_AI_云_同步]
        BottomNav[底部五Tab]
    end
    subgraph modules [业务模块]
        Auth[认证]
        Home[首页工作台]
        BP[图纸中心]
        DOC[资料库]
        MNT[运维工单]
        EQ[设备扫码]
        Mine[个人中心]
    end
    BottomNav --> BP & DOC & Home & MNT & Mine
    Home --> EQ & MNT & Mine
    EQ --> EQDetail[设备详情]
    EQDetail --> BP & DOC & MNT

1.5 底部导航结构

应用采用单 Activity + Jetpack Compose 架构，登录后通过底部五个 Tab 切换主模块：

第 2 章 环境与登录前准备

2.1 功能概述

使用 App 前需确认终端硬件、系统权限、网络与账号条件满足要求，以保证扫码、语音、同步等功能正常运行。

2.2 硬件要求

2.3 系统权限

首次使用相关功能时，系统会请求以下权限：

若拒绝相机权限，仍可通过手动输入标签编码定位设备；若拒绝录音权限，语音批注不可用，需手动输入问题描述。

2.4 网络与账号

在线模式

• 终端需能访问后端 /api/* 接口（由实施人员配置 BACKEND_BASE_URL）
• 登录需填写：租户 ID + 用户名/手机号/邮箱 + 密码（或短信验证码）
• 账号角色通常为 dms_operator（现场运维员）或 dms_admin（场站管理员），影响 Web 端授权后可同步的数据范围

离线模式

• 登录页 「离线登录」 Tab：须勾选用户协议，且本机已完成至少一次在线注册/登录
• 进入后为离线访客，仅使用本机数据；按基础版配额（图页/资料/工单各 5）
• 已在线登录用户可通过顶栏云图标切换手动离线，配额按账号绑定档位与充值周期有效状态（见会员中心）

2.5 典型场景示例

场景：夜班抢修前准备

1. 白班下班前在车间 Wi-Fi 覆盖区打开 App，登录账号
2. 进入图纸中心，对常用图包执行「离线缓存」
3. 进入资料库，打开关键规程触发本地缓存
4. 确认顶栏云图标为在线状态后离开 Wi-Fi 区域
5. 夜班现场无网时，仍可查图、填单；恢复网络后执行同步

第 3 章 全局界面与通用操作

3.1 功能概述

登录后进入主壳层（MainAppContainer），所有业务页面共享顶栏、底栏（部分页面例外）及统一导航规则。掌握全局操作可提升跨模块使用效率。

3.2 界面说明

┌─────────────────────────────────────┐
│  顶栏：返回 | 标题 | AI/云/同步        │
├─────────────────────────────────────┤
│                                     │
│           主内容区域                 │
│                                     │
├─────────────────────────────────────┤
│  底栏：图纸 | 资料 | 首页 | 运维 | 我的 │
└─────────────────────────────────────┘

3.3 顶栏操作点

3.4 底栏操作点

特殊规则

• 工单分步填报时：隐藏底栏，顶栏显示「首页」快捷按钮，便于填报中快速返回工作台
• 图纸/资料沉浸模式：隐藏顶栏与底栏，全屏查看内容

3.5 操作步骤：切换在线/离线模式

1. 点击顶栏 云图标
2. 图标变为离线样式时，进入离线模式
3. 离线模式下工单保存至本机，不立即上传
4. 恢复网络后再次点击云图标切回在线，并执行同步

3.6 操作步骤：手动触发同步

方式一：顶栏同步图标（上下文相关）

1. 在 资料库 页面点击同步图标 → 同步当前选中分类下的文档
2. 在 图纸中心 页面点击同步图标 → 同步当前图包
3. 在其他页面点击同步图标 → 进入「主从时控同步」中心

方式二：同步中心一键并网

详见第 12 章。

3.7 注意事项

• 物理返回键在根 Tab 页（如首页、图纸列表）时不会直接退出应用，需连续按两次
• 离线访客模式下，云图标不可用于切换回在线
• 同步进行中时，同步图标会旋转动画，请勿重复点击

第 4 章 用户认证

4.1 功能概述

认证模块提供密码登录、验证码登录、账号注册及离线访客四种进入方式。登录、注册与离线使用前均须勾选《用户协议》。首次安装须完成至少一次在线注册或登录后，方可使用离线访客模式。在线登录成功后自动拉取 AI 配置与主数据目录。

4.2 进入路径

应用启动后，未登录用户默认进入登录页（标题：智能运维终端，副标题：DMsysG 有色冶炼就地运维）。

4.3 密码登录

操作步骤

1. 确认顶部 Tab 选中 「密码登录」
2. 填写 租户 ID（首次登录后自动记忆）
3. 选择登录方式 Chip：用户名 / 手机号 / 邮箱
4. 输入对应账号与 密码（可点击眼睛图标显示/隐藏密码）
5. 点击 「登录」 按钮
6. 登录成功后自动进入首页工作台

字段说明

4.4 验证码登录

操作步骤

1. 切换 Tab 至 「验证码登录」
2. 填写 租户 ID
3. 输入 手机号
4. 点击 「获取验证码」（60 秒倒计时内不可重复获取）
5. 输入收到的 短信验证码
6. 点击 「验证码登录」

4.5 离线登录

进入路径：登录页顶部 Tab 「离线登录」（与密码/验证码 Tab 并列，始终显示）。

前置条件

1. 勾选 「我已阅读并同意《用户协议》」（可点击《用户协议》查看全文，含 AI 问答免责说明）
2. 已完成至少一次在线注册或登录（本机持久化标记；清除应用数据后需重新认证）

操作步骤（已满足前置条件）

1. 切换 Tab 至 「离线登录」
2. 阅读 Card 内说明：「无需账号，进入离线模式」
3. 点击 「离线使用（无需账号）」（橙色主按钮）
4. 进入离线访客会话，无需填写租户 ID 与账号

未完成在线认证时

• 离线 Tab 仍可见；Card 内提示：「请先免费注册或登录一次后，方可使用离线模式」
• 提供 「去免费注册」 快捷入口
• 点击「离线使用」或「请先注册或登录」按钮时，在 Card 底部显示相同提示，不进入主应用

免费版容量（离线访客）

• 本机自建 图页 / 资料 / 本地工单 各限 5（基础版配额）；超出时提示联系管理员升级，可前往 个人中心 → 会员中心 查看绑定档位与充值周期

模式差异

• 不可访问需登录的同步中心、修改密码
• 账户信息显示为「离线模式 · 账户信息仅保存在本机」
• 顶栏云图标不可切回在线（须退出后使用账号重新登录）
• 工单设备字段支持手输名称，无需从设备树选择

设计细节见 App离线登录与用户协议设计.md。

4.6 注册新账号

进入路径：登录页 「没有账号？立即注册」 按钮，或离线 Tab 内 「去免费注册」

操作步骤

1. 填写 租户（公开租户下拉或企业租户编号）
2. 填写 显示名称（选填）、手机号
3. 获取并填写 短信验证码，设置 密码
4. 勾选 用户协议
5. 点击 「注册并登录」
6. 注册成功后自动登录进入首页，并写入「已完成在线认证」标记（此后可使用离线登录）

4.7 用户协议

• 登录页 Card 内、注册页均须勾选「我已阅读并同意《用户协议》」
• 未勾选时无法登录、注册或进入离线模式
• 协议第四章专门说明 AI 智能问答 仅为辅助参考，不构成操作指令；现场高风险作业须以规程与持证人员判断为准

4.8 登录后自动行为

• 拉取租户 AI 模型配置（供 AI 助理与工单辅助填报使用）
• 触发主数据同步（设备台账、图包、资料、工单等，视网络状况）
• 刷新用户头像与资料信息

4.9 典型场景示例

场景：现场临时借用同事手机

使用验证码登录：输入租户 ID 与自己的手机号 → 获取验证码 → 登录，无需记忆密码。

第 5 章 首页工作台

5.1 功能概述

首页（设备智能运维系统）是运维人员的日常工作台，集中展示紧急告警、快速运维通道、待办工单与设备运行状态概览。

5.2 进入路径

• 底部 Tab 「首页」（居中凸起按钮）
• 顶栏标题显示 「设备智能运维系统」

5.3 界面说明

页面自上而下分为四个区块：

1. 品牌横幅 — 系统 Slogan 与 AI 快捷入口
2. 紧急故障告警 — 高优先级待处理工单（条件显示）
3. 快速运维通道 — 四宫格快捷入口
4. 运维中工单 — 当前活跃工单列表
5. 设备运行状态 — 设备单元状态只读列表

5.4 品牌横幅

5.5 紧急故障告警

显示条件：存在 优先级为「高」且状态为「待处理」 的工单时自动展示红色告警卡片。

5.6 快速运维四宫格

5.7 运维中工单列表

说明：列表内容与运维 Tab「未结案」工单一致，按优先级排序。

5.8 设备运行状态

说明：只读展示，数据由设备台账 UNIT 节点与当前运维中工单自动推导。

• 有对应活跃工单的设备显示工单状态（如「处理中」）
• 无工单的设备默认显示「运行正常」

5.9 典型场景示例

场景：接到紧急抢修任务

1. 打开 App 首页，查看是否出现红色「紧急故障告警」横幅
2. 点击 「紧急抢修」 四宫格入口
3. 进入工单第 1 步，填写故障基本信息
4. 或先点击告警卡片进入 AI 助理，获取初步诊断建议后再填单

第 6 章 扫码/NFC 与设备详情

6.1 功能概述

通过扫描现场二维码、读取 NFC 标签或手动输入编码，快速定位设备并查看其详情、关联图纸、资料与历史工单。

6.2 扫码/NFC 页面

进入路径

• 首页四宫格 「扫码/NFC」
• 其他页面通过导航进入（顶栏标题：扫码/NFC）

界面说明

• 上部：相机实时预览区（CameraX + ML Kit 识别二维码）
• 下部：手动输入标签编码文本框
• 操作按钮：确认编码、关闭（返回）

操作步骤：相机扫码

1. 进入扫码页，首次使用授权 相机权限
2. 将二维码置于取景框内，自动识别
3. 识别成功后自动跳转 设备详情 页

操作步骤：手动输入编码

1. 在下方输入框输入标签编码（QR/NFC 码或设备编码）
2. 点击 「确认编码」
3. 解析成功后跳转设备详情；失败时 Toast 提示

操作步骤：NFC 识读

1. 确保手机 NFC 功能已开启
2. 将手机背部贴近现场 NFC 标签
3. App 在前台时自动接收 NFC 数据并解析（无需进入扫码页也可触发，取决于当前页面状态）
4. 解析成功后跳转设备详情

标签解析优先级（与后端一致）

1. 设备 qr_code
2. 设备 nfc_code
3. 资产标签表 tag_code
4. 设备 node_code

6.3 设备详情页

进入路径：扫码/NFC 解析成功、工单选择设备、或其他业务跳转。

界面说明：顶部 Tab 切换四个子页。

Tab 1：设备详情

Tab 2：图纸

• 展示与该设备关联的图页列表
• 点击图页 → 进入 CAD/原理图柔性交互屏

Tab 3：资料

• 展示与该设备关联的规程/手册列表
• 点击文档 → 进入 数字规程预览

Tab 4：工单

• 默认展示该设备 最近 10 条 工单，按日期倒序
• 支持筛选与排序（见下表）

工单 Tab 筛选操作

6.4 设备选择器（工单表单内）

进入路径：运维工单第 1 步「设备」字段（在线模式）。

操作步骤

1. 点击设备选择框
2. 在弹出的 设备树对话框 中浏览场站 → 系统 → 设备层级
3. 仅 叶子节点（UNIT 类型） 可选择
4. 选中后自动填入设备名称并关联 equipmentId
5. 可点击清除按钮取消选择

模式差异：离线模式下手输设备名称，不弹出设备树。

6.5 注意事项

• 扫码无结果时，请确认 Web 管理端已为该设备绑定 QR/NFC 标签
• 设备关联的图纸、资料受权限控制，无授权时列表可能为空
• NFC 识读需 App 处于前台且 NFC 已开启

6.6 典型场景示例

场景：巡检发现设备异响

1. 扫描设备二维码 → 进入设备详情
2. 查看「工单」Tab 历史记录，确认是否重复故障
3. 打开「资料」Tab 查阅检修规程
4. 点击「创建运维工单」现场填报

第 7 章 运维工单管理

7.1 功能概述

运维工单模块是 App 核心业务，支持工单台账管理、三步分步填报、AI 辅助填写、本地保存与服务端同步，实现检修作业闭环。

7.2 进入路径

• 底部 Tab 「运维」（顶栏标题：运维工单管理）
• 首页「紧急抢修」、设备详情「创建运维工单」
• 首页/设备详情工单卡片的「执行操作」

7.3 工单台账

界面说明

• 顶部统计：未结案 X 条 · 已结案 X 条 · 待同步 X 条
• 工具栏：同步按钮（有待同步时显示）、新建工单按钮
• 筛选栏：可折叠
• 列表区：工单卡片

操作步骤：查看与筛选工单

1. 进入运维 Tab，查看工单列表
2. 点击 「筛选条件」 展开筛选面板
3. 选择 状态 Chip（全部 / 待处理 / 处理中 / 已完成 / 已关闭 / 已延期）
4. 设置 起始日期、截止日期（可选）
5. 点击 倒序/正序 切换排序
6. 点击 「重置筛选」 恢复默认

操作步骤：同步未上传工单

1. 当统计行显示「待同步 N 条」且 N > 0 时，顶栏出现 「同步」 按钮
2. 点击同步，等待完成
3. Toast 提示「同步完成：成功 X 条，失败 Y 条」

操作步骤：新建工单

1. 点击 「新建工单」 按钮（或首页「紧急抢修」）
2. 进入分步填报第 1 步

操作步骤：处理已有工单

操作步骤：删除工单

1. 在工单卡片上触发删除操作
2. 在确认对话框中确认删除

工单卡片徽章说明

7.4 分步填报工单（核心操作）

进入路径：新建工单、执行操作、紧急抢修。

界面说明

• 顶栏：工单标题、步骤指示（步骤: N / 3）、AI 辅助填报 按钮
• 进度条：三步进度可视化
• 中部：当前步骤表单
• 底栏：上一步/放弃、下一步/保存本地并同步

填报期间底部五 Tab 隐藏，可通过顶栏返回首页。

第一步：基本信息

操作步骤

1. 填写必填项（标题、设备、发生时间）
2. 点击 「下一步」 进入第二步

第二步：描述与安全

操作步骤：语音批注

1. 在「语音批注」卡片中点击 麦克风按钮
2. 授权录音权限（首次）
3. 对着手机说出故障现象（提示语：「请说出故障现象、报警代码等」）
4. 识别结果自动追加到问题描述框

操作步骤：使用 AI 辅助填报

1. 先在问题描述中输入故障现象（必填）

2. 点击顶栏 「AI 辅助填报」

3. 等待 AI 生成参考内容并自动填入相关字段

4. Toast 提示「已填入参考内容」或错误信息

5. 点击 「下一步」 进入第三步

第三步：物料、步骤与人员

操作步骤：保存工单

1. 确认实施步骤等必填项已填写
2. 点击 「保存本地并同步」
3. 工单写入本机数据库；在线模式下自动尝试上传服务端
4. 返回运维台账，可看到新建/更新的工单

底栏按钮说明

未填必填项时点击下一步/保存，Toast 提示「请填写必填项」。

7.5 工单详情（只读）

进入路径：点击已结案工单的「查看」。

界面说明：分三个区块只读展示

1. 基本信息 — 标题、类型、优先级、状态、设备、各时间
2. 问题与安全 — 问题描述、安全警示
3. 处理与结案 — 工具、零配件、实施步骤、执行结果、处理人、核实人

操作点

7.5.1 工单标注图纸（检修留痕）

功能概述：在检修执行过程中，可将现场图纸标注与工单关联保存，结案后可在工单详情中回看标注过的图纸。该能力不改变图纸中心原有的查阅与文件内嵌标注逻辑，仅在工单维度额外保存一份标注快照。

进入路径

标注与保存

同步说明

• 标注快照保存在本机 work_order_blueprint_markups 表，联网后随工单一并 sync-batch 上传
• Web 管理端在工单历史/详情抽屉中可查看标注列表与只读预览（PDF/图片叠加标注点；DXF 显示标注列表并支持下载原图）

7.6 工单生命周期

待处理 ──→ 处理中 ──→ 已完成 / 已关闭
  │           │              │
  └───────────┴──────────────┘
              ↓
         已结案（只读详情）

同步说明

• 保存时 syncedToServer = false，显示「待同步」徽章
• 在线模式下保存后自动尝试 sync-batch 上传
• 离线模式或上传失败时，需在运维台账手动点击「同步」

7.7 典型场景示例

场景：完整抢修闭环

1. 首页点击「紧急抢修」→ 第 1 步填写故障机组与发生时间
2. 第 2 步语音录入报警代码，使用 AI 辅助生成安全警示
3. 第 3 步记录更换部件与测试结果，填写执行结果
4. 状态选「已完成」，点击「保存本地并同步」
5. 回办公室连 Wi-Fi 后，在运维台账确认「待同步」为 0

第 8 章 多维度图纸中心

8.1 功能概述

图纸中心支持多格式工程图纸的浏览、离线缓存、本地自建图包及 CAD 交互标注，满足现场查图需求。

8.2 进入路径

• 底部 Tab 「图纸」（顶栏标题：多维度图纸中心）

8.3 图包列表

界面说明

• 列表区：图包卡片（名称、车间、数量 / 大小 / 时间、下载状态）
• 工具栏：选择模式、新建图包
• 底部栏（选择模式）：全选、批量删除

操作步骤：浏览图包

1. 点击图包卡片 → 进入 图纸列表（该图包下的图页）

操作步骤：离线缓存图包

1. 在图包卡片上点击 离线缓存 / 下载相关按钮
2. 等待下载完成，状态变为「已下载」
3. 无网时可打开已缓存图包

操作步骤：新建自建图包（LOCAL）

1. 点击 「新建图包」
2. 在对话框中填写 图包名称、车间
3. 点击 「创建并管理」
4. 进入图页列表，可通过 FAB 导入本地文件

操作步骤：批量删除图包

1. 点击 「选择」 进入批量模式
2. 勾选目标图包，或点击 「全选」
3. 点击底部 「批量删除」 并确认

注意事项

• LOCAL 自建图包在并网同步时 不会被云端覆盖
• 自建图包内图页为 本机导入原件，联网状态下也可正常打开，不依赖顶栏云同步
• 删除自建图包将同时删除本机图页记录与导入文件；删除云端已缓存图包仅清理本机副本，元数据保留

8.4 图页列表

进入路径：点击图包卡片。

顶栏标题：图纸列表

操作步骤：打开图页

1. 点击图页列表项 → 进入 CAD/原理图柔性交互屏

操作步骤：导入本地文件（仅 LOCAL 自建图包）

1. 点击右下角 FAB（+） 按钮
2. 从手机存储选择文件（支持 dxf、pdf、png、jpg）
3. 导入成功后出现在图页列表

操作步骤：单页同步（仅云端图包）

1. 在 非自建 图包的图页列表项上点击 云同步 图标
2. 从服务端拉取最新文件到本机

自建图包（LOCAL）列表项 不显示 云同步按钮；图页仅保存在本机。

操作步骤：批量删除图页

1. 进入选择模式，勾选图页
2. 执行批量删除并确认

8.5 CAD/原理图柔性交互屏

进入路径：点击图页列表项。

顶栏标题：CAD/原理图柔性交互屏

按格式自动路由查看器

通用操作点

8.6 注意事项

• 大型 CAD 文件首次打开可能需等待加载；STEP 等 3D 格式在云端图包中可能需等待 GLB 预览转换
• 云端图包：离线前需执行离线缓存；未缓存的图页无网时无法打开
• 自建图包：图页文件保存在本机，有网/无网均可打开；若提示「本地文件已丢失」，请在图包内重新从手机存储导入
• 顶栏「同步图纸包」不会删除或覆盖自建图包中的导入文件
• 标注数据保存在本机；云端图页标注同步行为依版本可能有所不同

8.7 典型场景示例

场景：电解槽检修查电气原理图

1. 进入图纸中心，找到「电解车间电气」图包
2. 提前在 Wi-Fi 区执行离线缓存
3. 现场打开对应 DXF 图页，开启图层面板仅显示「电气主结线」
4. 使用标框工具标注故障点位，截图或口头传达给同事

第 9 章 运维知识库与手册

9.1 功能概述

资料库提供运维规程、操作手册、技术标准等文档的分类管理与多格式预览，支持本地添加、远程链接、收藏与离线缓存。

9.2 进入路径

• 底部 Tab 「资料」（顶栏标题：运维知识库与手册）

9.3 资料目录页

界面说明

• 左侧：分类树（可展开/折叠）
• 右侧：文档列表 + 顶部 搜索框
• 右下角：ExtendedFAB（本地添加）
• 顶栏同步图标：同步当前分类

操作步骤：浏览文档

1. 在左侧分类树中点击目标分类
2. 右侧列表显示该分类下文档
3. 点击文档卡片 → 进入 数字规程预览

操作步骤：搜索文档

1. 在搜索框输入关键词（匹配标题、专业、用途）
2. 列表实时过滤

操作步骤：新建分类

1. 在分类树区域触发 新建分类
2. 输入分类名称，点击 「创建」

操作步骤：本地添加文档

1. 选中目标分类
2. 点击右下角 FAB 按钮
3. 从手机选择多个文件
4. 文件加入当前分类列表

操作步骤：添加远程链接

1. 触发 远程链接 添加功能
2. 输入文档 URL 及标题等信息
3. 点击 「加入列表」

操作步骤：同步当前分类

1. 选中分类后，点击顶栏 同步图标
2. 从服务端拉取该分类最新文档元数据与文件

操作步骤：收藏文档

• 在文档卡片上点击 星标 图标切换收藏状态

操作步骤：批量删除

1. 进入选择模式
2. 勾选分类或文档
3. 确认删除

9.4 数字规程预览

进入路径：点击文档列表项。

顶栏标题：数字规程预览

操作点

支持预览格式

• PDF、图片（PNG/JPG 等）
• DXF 图纸
• Office 文档（DOC/DOCX、XLS/XLSX、PPT/PPTX）

预览由 DocumentViewerHost 按文件类型自动选择查看器。

9.5 注意事项

• 资料分类挂在设备台账节点上，分类实际对应设备节点 ID
• 首次打开远程文档需联网下载；之后可离线阅读已缓存副本
• 清理离线缓存后需重新打开文档以下载，属正常行为

9.6 典型场景示例

场景：查阅受限空间作业规程

1. 资料库左侧选择「安全规程」分类
2. 搜索「受限空间」
3. 打开 PDF 规程，开启沉浸模式全屏阅读
4. 点击星标收藏，便于下次快速找到

第 10 章 就地诊断 AI 助理

10.1 功能概述

AI 助理提供多轮智能对话、附图多模态诊断、会话历史管理，并可在工单填报时辅助生成字段内容。

10.2 进入路径

10.3 前置条件

管理员须在 Web 管理端 → 设备运维 → AI 模型配置 中完成：

• API 地址（OpenAI 兼容接口）
• API Key
• 模型名称（建议支持 Vision 多模态）
• 系统提示词
• 启用状态

App 登录后通过 GET /api/ai/provider-config 自动拉取配置，无需在 App 内填写 Key。

10.4 AI 对话主界面

顶栏标题：就地诊断 AI 助理

界面说明

• 左侧抽屉：会话历史列表
• 中部：消息气泡列表（Markdown 渲染）
• 底部：输入区（附图按钮 + 文本框 + 发送）

操作步骤：文字对话

1. 在底部输入框输入故障现象、报警代码或问题
2. 点击 发送 按钮
3. 等待 AI 回复（生成中显示加载状态）
4. 可连续多轮追问

操作步骤：附图多模态诊断

1. 点击输入框左侧 相机（附图） 图标
2. 选择 拍照 或 相册
3. 确认输入区上方出现图片预览（可点 × 移除）
4. 输入补充说明（也可仅发图片）
5. 点击 发送，AI 结合图片与文字分析

操作步骤：会话管理

10.5 工单 AI 辅助填报

进入路径：分步填报工单页面顶栏 「AI 辅助填报」

操作步骤

1. 在第二步至少填写 问题描述
2. 点击 「AI 辅助填报」
3. AI 根据描述生成工具、步骤、安全警示等参考内容
4. 检查并修改后保存工单

10.6 离线降级说明

以下情况 AI 可能不可用或降级为本地话术：

• 未配置租户 AI（管理员未在 Web 端配置）
• 当前处于离线模式且无有效缓存配置
• API Key 无效或模型服务不可达

此时 App 可能展示预设的离线回复模板，功能受限。

10.7 典型场景示例

场景：变频器报警截图诊断

1. 拍摄变频器屏幕报警照片
2. 打开 AI 助理，附图发送
3. 输入「请分析此报警代码可能原因」
4. 根据 AI 建议查阅资料库对应规程，再创建工单

第 11 章 个人中心与账户管理

11.1 功能概述

个人中心集中账户信息、密码修改、同步中心、AI 助手、离线缓存清理及退出登录等系统级功能。

11.2 进入路径

• 底部 Tab 「我的」（顶栏标题：个人中心）

11.3 个人中心主页

界面说明

• 顶部：用户身份卡片（头像、姓名、账号、手机、邮箱）
• 下方：功能菜单列表
• 底部：退出登录

菜单项

操作步骤：进入账户信息

1. 点击顶部 用户身份卡片
2. 进入 账户信息 页面

11.4 账户信息

顶栏标题：账户信息

说明

• 登录后及进入本页时自动调用 GET /api/auth/me 刷新用户信息
• 上传成功 Toast 提示「头像已更新」

11.5 修改密码

顶栏标题：修改密码

操作步骤

1. 输入 原密码
2. 输入 新密码
3. 输入 确认新密码
4. 可点击眼睛图标显示/隐藏密码
5. 点击保存/确认按钮

仅在线登录用户可见此菜单。离线访客无此入口。

第 12 章 数据同步与离线管理

12.1 功能概述

本模块管理在线/离线模式切换、主从数据并网同步、冲突处置及离线缓存清理，保障现场数据与云端一致。

12.2 在线/离线模式

详见第 3 章顶栏云图标操作。

12.3 主从时控同步中心

进入路径：我的 → 数据时序同步中心（顶栏标题：主从时控同步）

功能概述

并网后将上传本地运维工单，并从云端拉取图纸包、图页与资料目录。自建离线图包（LOCAL）不会被云端覆盖。

界面说明

• 同步状态卡片：时钟校准、待同步工单数
• 操作按钮区

操作步骤：手动一键并网同步

1. 确保已切换为 在线模式 且网络可用
2. 进入同步中心
3. 点击 「手动一键并网同步」 按钮
4. 等待顶栏同步进度完成

操作步骤：冲突处置（培训演示）

1. 点击 「模拟时间戳冲突」 按钮
2. 在冲突对话框中查看本地版与云端版差异
3. 选择处置策略：
   • 保留本地
   • 保留云端
   • 双向合并

同步内容范围

12.4 离线缓存与清理

进入路径

• 我的 → 离线数据与缓存清理（顶栏标题：离线缓存与图包）
• 首页四宫格 → 离线数据

界面说明

• 占用概览卡片：分类字节统计（图包、资料、临时文件等）
• 一键清理全部离线缓存 按钮

操作步骤：查看缓存占用

1. 进入离线缓存管理页
2. 查看各分类占用空间

操作步骤：一键清理

1. 点击 「一键清理全部离线缓存」
2. 阅读确认对话框说明
3. 确认清理
4. Toast 提示实际释放的字节数

清理范围摘要

完整技术规则见 App离线数据与缓存清理规则.md。

注意：清理后需重新下载图包、打开资料才能离线使用；AI 历史不可恢复。

12.5 同步时机汇总

12.6 典型场景示例

场景：周末离厂前数据整理

1. 连接车间 Wi-Fi，确认在线模式
2. 运维台账点击「同步」，确保待同步为 0
3. 进入同步中心执行「手动一键并网同步」
4. 可选：清理不再需要的旧图包缓存以释放空间

第 13 章 常见问题与故障排除

附录 A 支持的文件格式一览

图纸中心

资料库

附录 B 角色与数据可见性

数据访问规则

• 图包、图页、资料、设备节点均支持 PUBLIC（全员可见） 与 grant（按角色/用户授权）
• App 同步时仅拉取当前用户有权访问的数据
• 无权限时列表为空，非故障

附录 C 与 Web 管理端协作对照

以下配置须在 Web 管理端（dmsysr-frontend）预先完成，App 方能正常使用对应功能：

三端协作关系

Web 管理端（配置） → 后端服务（存储） → App 移动端（执行）
                      ↑___________________|
                           同步上下行

附录 D 全部页面路由索引

文档版本 V1.1 · 与 DMsysGApp 当前代码实现保持一致 · 如有界面变更请以实际安装版本为准

V1.1 修订（2026-08）：补充自建图包（LOCAL）与用户导入图页在联网打开、云同步、失败提示上的说明；图包卡片摘要字段改为「数量 / 大小 / 时间」。技术细节见 App图纸中心本地与云端图页设计.md。