iAOP/docs/用户手册.md

# iAOP 用户手册（User Guide）

> 对应 issue #91「[M5] 用户手册/部署手册编写」，父 Issue #15（EPIC 跟踪），里程碑 iAOP v1.0 · Template-Ti 一期。
> 本手册面向 **最终业务用户**（工艺工程师 / 值班长 / 生产管理者），即 PRD §2 角色画像中的张工、李工、王主任。
> 部署 / 运维操作请见《[部署手册](./部署手册.md)》。

## 1. 平台简介

iAOP（云美工业 AI 优化平台）= **可配置、可复制的工业 AI 优化内核** + **按行业沉淀的行业模板**。

- **内核（iAOP-Core）**：采集 → 模型推理 → LLM 解释 → 驾驶舱呈现，一次建设、多行业复用；
- **行业模板**：氯化车间/海绵钛（Template-Ti）、吸附树脂（Template-Resin）等，决定 ~90% 落地工作量。

你日常接触的是**配置化驾驶舱**（Web / 移动端）与 **LLM 自然语言助手**。本手册教你如何用它们完成监控、优化、辅助三类场景。

## 2. 角色与权限（RBAC）

| 角色 | 主要入口 | 权限 |
| --- | --- | --- |
| 工艺工程师 / 值班长（张工、李工） | 驾驶舱、LLM 助手 | 查看实时数据 / 告警 / 趋势；发起查询；接收优化建议并 review |
| 生产管理者（王主任） | 驾驶舱大屏、移动端助手 | 查看 KPI / 趋势 / 报表；接收交接班报告 |

> 配置台（模板配置台 Template Console）三级权限 Viewer / Editor / Publisher 面向**实施/行业工程师**，普通业务用户无需使用，详见《模板开发手册》。

## 3. 登录

1. 浏览器打开驾驶舱地址（由实施提供，形如 `http://iaop.example.com`）；
2. 输入管理员分配的账号密码登录；
3. 登录后默认进入「实时监控」驾驶舱。

> 移动端：扫描实施提供的二维码，使用同一账号登录（只读模式，支持查看告警 / 报表 / 推送）。

## 4. 场景 A：实时监控与告警处置

**目标**：及时发现工艺异常并了解原因。

1. 进入驾驶舱「实时监控」页：
   - **四状态工艺流程视图**：直观展示氯化/还原等工序当前状态（绿/黄/红）；
   - **实时趋势**：关键点位（如 `CLF-01.TEMP`）实时曲线；
   - **KPI 卡片**：核心指标（如 `Ti_purity` 海绵钛纯度）；
   - **告警面板**：当前未确认告警列表。
2. 当出现红色告警（如炉层温度异常）：
   - 点击告警条目 → 系统展示 LLM 生成的**报警解释**（原因 + 处置建议，附引用依据，可溯源）；
   - 值班长确认后，按建议处置或转交相关人员；
   - 处置完成后在告警面板标注「已确认 / 已处置」。

> 不使用 iAOP 时：靠人工盯趋势、微信群喊人，平均 20–40 分钟才发现，且无根因解释。iAOP 将发现到解释压缩到分钟级。

## 5. 场景 B：工艺优化（配方 / 参数建议）

**目标**：给定质量目标，让模型给出参数建议，review 后下发。

1. 进入「优化建议」页（一期质量预测 + 炉层杂质预警上线后，二期配方优化 / 跨工序寻优逐步开放）；
2. 输入或确认本批次质量目标（如目标纯度、约束条件）；
3. 系统给出**可溯源优化建议**：
   - 建议参数（决策变量取值）；
   - 目标函数值与约束满足情况；
   - 跨工序权重与依据（引用上游 TiCl₄ 指标 → 下游海绵钛寻优）；
4. 工艺工程师（李工）**review 建议**，确认后下发 DCS；
5. 实际质量反馈回流，持续训练模型。

> 建议为「辅助决策」，高利害输出低于信度阈值时系统会提示「需人工确认」。

## 6. 场景 C：LLM 自然语言助手

**目标**：用自然语言提问，获得带引用的答案 / 报表。

支持四类能力：

| 能力 | 示例提问 | 说明 |
| --- | --- | --- |
| NL 工艺查询 | 「最近一周 CLF-01 温度超标几次？」 | NL→SQL/API，返回数据 + 来源 |
| 报警解释 | （点击告警自动触发） | 原因 + 处置建议 + 引用 |
| 交接班报告 | （班次结束自动生成） | 汇总关键事件/能耗/待办，≤ 2 分钟 |
| 配方 RAG 问答 | 「国标对 XX 指标的要求？」 | 命中领域知识库，强制引用溯源 |

**安全说明**：平台内置**敏感度分级路由**（准确率 ≥ 96.5%）+ **DLP 防泄漏**（拦截率 100%）：敏感/核心问题在本地 70B 模型闭环，脱敏/通用问题走云端，结果均附引用来源，可追溯。

## 7. 交接班报告

每班次结束时，系统自动生成交接班报告（汇总关键事件、能耗、待办），并推送给下一班。

- 查看入口：驾驶舱「交接班」页 / 移动端推送；
- 报告可导出（PDF）；
- 历史报告在「报告归档」中可检索。

> 不使用 iAOP 时：手写记录本 + 口头交代，遗漏率约 15%，夜班回溯困难。

## 8. 常见问题（FAQ）

**Q1：建议 / 解释能否给出依据？**
A：所有 LLM 输出强制引用溯源（返回命中文档片段 + 来源），可点击查看原文。

**Q2：数据准吗？多久更新？**
A：采集 P99 ≤ 1.8s，驾驶舱数据准实时刷新；批量写入 5k 点 / 100ms。

**Q3：看不到某个功能？**
A：功能按行业模板与里程碑分批开放（一期：监控+预警+LLM；二期：优化寻优）。确认你的模板版本与权限。

**Q4：发现数据异常 / 误报怎么办？**
A：在告警面板标注「误报」并留言，系统回流用于模型迭代；紧急情况联系运维（见《部署手册》§8）。

## 9. 移动端使用

- **只读模式**：查看驾驶舱、接收告警 / 报告推送；
- 登录账号与 Web 一致；
- 支持 ≥ 200 并发只读用户（PRD §9 NFR）。

## 10. 帮助与反馈

- 使用问题：联系工艺主管或实施工程师；
- 功能建议：在配置台「反馈」入口提交（如已开放）；
- 故障：参考《部署手册》§8 故障排查 SOP，或联系运维 bot_dev。

---

**维护**：本文档随行业模板与功能开放节奏更新。当前对应 Template-Ti 一期（氯化车间/海绵钛）。