================================================================================
  A14 工业数据智能优选系统 — 用户操作手册
  （零代码基础 · 纯使用向）
================================================================================

适用人群：现场工程师、工艺员、测试人员
需要技能：会打开浏览器、会上传文件


================================================================================
  一、系统是干什么的？
================================================================================

一句话：你把工厂的 CSV 数据丢进来，用大白话告诉它你想干嘛，它自动帮你
清洗数据、挑出最好的数据段、找出变量之间的滞后关系、训练模型，最后给你
一份图文报告 + 一份可以拿去建模的高质量数据集。


================================================================================
  二、打开系统
================================================================================

在浏览器地址栏输入：http://localhost:5173

你会看到左边一排菜单，右边是主操作区。菜单有 5 个：

    💬 智能对话      ← 最重要的入口，所有操作从这里开始
    📁 数据管理      ← 上传/查看/删除数据文件
    📊 寻优监控      ← 实时看系统自动调参数的进度
    📝 分析报告      ← 看系统自动生成的报告
    💾 数据导出      ← 下载最优数据集


================================================================================
  三、第一步：上传数据
================================================================================

1. 点击左侧 "📁 数据管理"
2. 把 CSV 文件拖到虚线框里（也支持点击选择文件）
3. 上传成功后，表格里会显示：
   - 文件名
   - 有多少个变量（列）
   - 有多少行数据
   - 时间范围
   - 上传时间
4. 点击表格里的 "查看" 可以预览数据内容

如果你还没有真实数据，可以点 "生成仿真测试集" 按钮，
系统会当场造一份模拟的工业数据给你试用。


================================================================================
  四、第二步：用大白话下指令
================================================================================

点击左侧 "💬 智能对话"，你会看到一个类似微信的聊天界面。

在底部输入框里，像跟同事说话一样告诉系统你要干嘛。以下是常用说法：


  ┌──────────────────────────────────────────────────────┐
  │ 你想干什么           │ 可以这样说                     │
  ├──────────────────────────────────────────────────────┤
  │ 清洗数据             │ "帮我把数据清洗一下，去掉异常值" │
  │ 挑优质数据段         │ "提取1号塔高信噪比的动态数据"    │
  │ 分析变量滞后关系     │ "帮我看看各变量之间的时滞是多少"  │
  │ 去掉冗余变量         │ "检测一下共线性，去掉多余的变量"  │
  │ 训练模型看效果       │ "用处理好的数据训练一个ARX模型"   │
  │ 全自动一键到底       │ "从清洗到建模闭环寻优，全帮我做了" │
  │ 生成报告             │ "给我出一份分析报告"             │
  │ 导出数据             │ "把最优数据集导出来给我"         │
  └──────────────────────────────────────────────────────┘

举个例子，你可以直接输入：

  "帮我清洗一下3号反应釜的数据，挑出动态响应最大的那段，
   分析一下温度和压力的时滞关系，最后训个模型看看拟合度多少"

系统会自动：
  → 理解你的意图
  → 列出它将要执行的步骤
  → 一步一步执行，并告诉你每一步的进度
  → 最后把结果和图表展示给你


================================================================================
  五、第三步：看系统干活
================================================================================

当系统开始执行任务时：

  1. 聊天区会显示当前在做什么
     例如："✓ 数据清洗完成，检测到 12 个异常值"
           "⏳ 正在识别动态数据段..."
           "✓ 截取到 3 段富含动态信息的数据"

  2. 每完成一步，可能会在聊天区嵌入一张图
     比如：清洗前后的波形对比图、动态段的高亮标注图

  3. 如果你想看更详细的执行进度，切换到 "📊 寻优监控"
     这里会实时显示：
       - 当前第几轮迭代
       - 每轮用的什么参数
       - 每轮的拟合度是多少
       - 拟合度变化曲线（像股票K线图一样）


================================================================================
  六、第四步：看报告
================================================================================

任务全部跑完后，点击 "📝 分析报告"，你会看到一份完整报告，包含：

  ┌─────────────────────────────────────────┐
  │  📋 数据概况                             │
  │     - 原始数据有多少个变量、多少行        │
  │     - 采样频率、时间跨度                  │
  ├─────────────────────────────────────────┤
  │  🧹 清洗效果                             │
  │     - 去掉了多少个异常值                  │
  │     - 清洗前后波形对比图                  │
  ├─────────────────────────────────────────┤
  │  📈 高动态区段                           │
  │     - 找到了哪几段有效数据                │
  │     - 每段的质量评分                      │
  │     - 波形高亮图（红色=有效的动态段）       │
  ├─────────────────────────────────────────┤
  │  ⏱️ 时滞分析                             │
  │     - 各变量之间滞后多少秒               │
  │     - 时滞矩阵热力图                     │
  ├─────────────────────────────────────────┤
  │  🔗 共线性分析                           │
  │     - 哪些变量是冗余的                   │
  │     - 变量相关性热力图                    │
  ├─────────────────────────────────────────┤
  │  🎯 辨识结果                             │
  │     - ARX 模型拟合度（FIT%）              │
  │     - 预测值和实际值的对比图               │
  ├─────────────────────────────────────────┤
  │  🔄 闭环寻优                             │
  │     - 经过几轮迭代找到的最优参数          │
  │     - 收敛曲线（拟合度怎样一步步变好）      │
  ├─────────────────────────────────────────┤
  │  📝 分析结论                             │
  │     - AI 自动写的中文分析总结             │
  │     - 对数据质量的评价                    │
  │     - 预处理策略的说明                    │
  └─────────────────────────────────────────┘

报告支持在线浏览，也可以一键导出为 PDF。


================================================================================
  七、第五步：下载数据
================================================================================

点击 "💾 数据导出"，你会看到：

  - 经过系统优选的最终数据集概览
    （多少行、多少列、时间范围、质量评分）

  - 点击 "下载 CSV" 按钮 → 得到最优建模数据集

  - 点击 "下载元数据" 按钮 → 得到一个 JSON 文件
    里面记录了这个数据是经过哪些步骤、用了哪些参数处理出来的
    （方便以后追溯）


================================================================================
  八、典型使用流程（5分钟上手）
================================================================================

  步骤 1        步骤 2          步骤 3          步骤 4
  ┌──────┐    ┌──────────┐    ┌──────────┐    ┌──────────┐
  │上传CSV│ →  │输入一句   │ →  │看着系统   │ →  │看报告+   │
  │数据   │    │大白话指令 │    │自动执行   │    │下载数据  │
  └──────┘    └──────────┘    └──────────┘    └──────────┘

  数据管理页    智能对话页      寻优监控页    报告页+导出页


================================================================================
  九、常见问题
================================================================================

Q: 支持什么格式的数据？
A: CSV 文件。Excel 的话请先另存为 CSV。

Q: 数据需要什么格式？
A: 第一行是列名（变量名），每一列是一个变量，每一行是一个采样点。
   像这样：
   ┌─────────────────┬──────────┬────────┬───────────┐
   │ MV1_InletFlow   │ CV1_Temp │ CV2_P  │ DV1_Amb   │
   ├─────────────────┼──────────┼────────┼───────────┤
   │ 0.512           │ 0.153    │ 0.350  │ 25.12     │
   │ 0.498           │ 0.148    │ 0.347  │ 25.08     │
   │ ...             │ ...      │ ...    │ ...       │
   └─────────────────┴──────────┴────────┴───────────┘

Q: 最多能处理多少行数据？
A: 十万行以内流畅，再多建议先抽稀。

Q: 系统跑一半不动了怎么办？
A: 看聊天区的状态提示。如果长时间卡住，刷新页面，重新输入指令即可。
   上传的数据不会丢。

Q: 我不知道该用什么参数怎么办？
A: 你不用管参数。你只需要告诉系统你想干嘛，它会自动选择合适的参数。
   如果你想手动调，也可以在指令里提：
   "用 3σ 法清洗，阈值设 3.5，窗口用 100"

Q: 报告里的图能单独下载吗？
A: 可以，右键图片 → 另存为即可。

Q: 会不会把我上传的数据泄露出去？
A: 数据只存在你本机的 uploads 目录里，不上传云端。
