📘 磁检测仪器Web界面系统 - 用户操作手册
🎯 系统简介
磁检测仪器Web界面系统是一款专业的无损检测（NDT）工业软件，用于钢铁材料的磁粉检测。系统采用现代Web技术开发，可在任何设备的浏览器中运行，无需安装客户端软件。
🌊 实时信号监测
双通道磁信号波形实时显示，刷新率≥30fps，流畅清晰
🔍 智能缺陷检测
自动识别超阈值信号并标记，提供声音提示
📊 项目管理
创建、编辑、搜索实验记录，云端数据持久化
⚙️ 灵活配置
丰富的检测参数设置，支持多种磁化方式
📄 报告生成
一键生成专业检测报告，支持PDF/Word格式
☁️ 云端存储
基于Supabase的数据存储，支持多设备同步
💡 适用场景
- 🏭 钢板焊缝检测
- 🔩 紧固件表面裂纹检测
- ⚙️ 机械零件疲劳裂纹检测
- 🚂 轨道交通部件检测
- 🏗️ 建筑钢结构质量检测
🚀 快速入门
访问系统
您可以通过以下方式访问系统：
✅ 在线访问（推荐）
直接在浏览器中打开：https://maguiweb.netlify.app
无需安装，随时随地访问
💻 本地运行
# 1. 下载代码
git clone <repository-url>
# 2. 进入目录
cd maguiweb
# 3. 启动服务
npm run start
# 4. 访问
打开浏览器访问: http://localhost:80805分钟快速体验
1
访问系统
打开浏览器，访问系统URL，自动加载主界面
2
创建实验
点击"新建实验"按钮，填写项目名称、工件信息等基本信息
3
开始检测
点击▶播放按钮，观察实时波形显示
4
标记缺陷
系统自动标记超阈值信号，也可手动点击标记
5
生成报告
点击"生成报告"，下载专业PDF检测报告
⚠️ 系统要求
- 浏览器：Chrome 90+ / Firefox 88+ / Edge 90+ （推荐Chrome）
- 屏幕分辨率：最小1280×720，推荐1920×1080
- 网络：稳定的互联网连接，建议≥2Mbps
🖥️ 界面总览
系统主界面采用工业级设计，布局清晰，操作便捷：
┌─────────────────────────────────────────────────────────────┐ │ 磁检测仪器控制系统 V1.1 [用户] [设置] [帮助] │ ├─────────────────────────────────────────────────────────────┤ │ │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ 实时波形显示区 (Signal Chart) │ │ │ │ │ │ │ │ 通道1 ════════════════════════════════ │ │ │ │ ╱╲ ╱╲ ╱╲ ⚠缺陷 │ │ │ │ ──────╱──╲──╱──╲──╱──╲──────────────── │ │ │ │ │ │ │ │ 通道2 ════════════════════════════════ │ │ │ │ ╱╲ ╱╲ ╱╲ │ │ │ │ ─────╱──╲────╱──╲────╱──╲────────────── │ │ │ │ │ │ │ └─────────────────────────────────────────────────────┘ │ │ │ │ ┌──────────────┐ ┌─────────────────────────────────┐ │ │ │ 控制面板 │ │ 实验信息 │ │ │ │ │ │ │ │ │ │ ▶ 播放 │ │ 项目: 钢板焊缝检测-A001 │ │ │ │ ⏸ 暂停 │ │ 工件: Q345钢板 │ │ │ │ ⏹ 停止 │ │ 操作员: 张三 │ │ │ │ ⏮ 后退 │ │ 状态: 进行中 │ │ │ │ ⏭ 前进 │ │ 已发现缺陷: 3个 │ │ │ │ 🔄 重置 │ │ │ │ │ └──────────────┘ └─────────────────────────────────┘ │ │ │ │ ┌─────────────────────────────────────────────────────┐ │ │ │ 参数配置 │ │ │ │ 磁化方式: [直流磁化 ▼] 电流: [1000] mA │ │ │ │ 频率: [50] Hz 阈值: [80] % │ │ │ └─────────────────────────────────────────────────────┘ │ │ │ │ [新建实验] [保存] [导出] [生成报告] [历史记录] │ └─────────────────────────────────────────────────────────────┘
界面区域说明
1️⃣ 波形显示区（核心区域）
- 双通道显示：同时显示2路磁信号
- 实时更新：30fps刷新率，流畅显示
- 缺陷标记：超阈值信号自动标记为⚠️
- 交互功能：鼠标滚轮缩放、拖拽平移、点击标记
2️⃣ 控制面板
| 按钮 | 功能 | 快捷键 |
|---|---|---|
| ▶ 播放 | 开始采集信号 | Space |
| ⏸ 暂停 | 暂停采集（数据保留） | Space |
| ⏹ 停止 | 停止采集（返回初始） | S |
| 🔄 重置 | 清空当前数据 | R |
| 🔍 放大/缩小 | 调整波形显示比例 | + / - |
3️⃣ 实验信息面板
实时显示当前实验的关键信息、检测状态和已发现的缺陷数量。
4️⃣ 参数配置面板
- 磁化方式：直流/交流/脉冲磁化
- 磁化电流：0-2000mA可调
- 检测阈值：0-100%可调
- 信号增益：0.1-10×可调
📝 完整操作示例
示例1：钢板焊缝检测完整流程
📋 检测场景
- 检测对象：Q345钢板焊缝
- 工件尺寸：500mm × 300mm × 10mm
- 焊缝长度：450mm
- 检测标准：ISO 9934-1:2016
- 操作员：张三 (证书编号: NDT-001)
1
创建新实验（约2分钟）
操作步骤：
- 点击界面底部的按钮
- 在弹出的对话框中填写以下信息：
┌───────────────────────────────────────┐
│ 新建实验 │
├───────────────────────────────────────┤
│ * 项目名称: [钢板焊缝检测-A001 ] │
│ * 工件名称: [Q345钢板-批次20251008] │
│ * 工件材质: [Q345 ] │
│ 工件尺寸: [500×300×10mm ] │
│ * 操作员: [张三 ] │
│ 操作员证书: [NDT-001 ] │
│ * 磁化方式: [直流磁化 ▼] │
│ 磁化电流: [1000 ] mA │
│ 检测标准: [ISO 9934-1:2016 ] │
│ │
│ 带*为必填项 │
│ │
│ [取消] [创建] │
└───────────────────────────────────────┘
- 点击按钮
- 系统验证数据并显示成功提示："实验创建成功！"
2
配置检测参数（约1分钟）
在参数配置面板中设置：
| 参数 | 推荐值 | 说明 |
|---|---|---|
| 磁化方式 | 直流磁化 | 适合厚工件表面检测 |
| 磁化电流 | 1000 mA | Q345钢推荐范围 |
| 信号增益 | 1.0× | 标准增益 |
| 检测阈值 | 80% | 超过此值标记为缺陷 |
| 滤波 | 开启 | 降低噪声干扰 |
点击保存设置
3
开始检测（约8分钟）
操作流程：
- 准备工件（清洁表面、喷洒磁粉、连接传感器）
- 点击控制面板的▶ 播放按钮开始检测
- 观察实时波形显示
正常信号特征：
通道1信号 (幅值: 0-100%)
100% ┤
│
80% ┤ ───────────────── ← 阈值线（红色虚线）
│ ╱╲ ╱╲
50% ┤ ╱ ╲╱ ╲
│ ╱ ╲
0% └─────────────────────→ 时间(s)
0 2 4 6 8
特征：
- 平滑的正弦波形
- 幅值在30-60%之间
- 频率稳定
发现缺陷时的信号：
通道1信号
100% ┤
│ ⚠️ 缺陷标记
80% ┤ ╱╲ ← 超过阈值
│ ╱╲╱ ╲
50% ┤ ╱ ╲╱╲
│ ╱ ╲
0% └─────────────────────→ 时间(s)
0 2 4 6 8
特征：
- 突然的幅值升高
- 超过80%阈值线
- 自动添加⚠️标记
- 发出声音提示
✅ 系统自动操作
- 自动标记缺陷位置
- 记录时间戳和幅值峰值
- 在右侧缺陷列表显示
- 播放声音提示（可设置）
4
查看缺陷统计
检测完成后，右侧自动显示缺陷统计信息：
┌────────────────────────────────┐ │ 缺陷统计 │ ├────────────────────────────────┤ │ 总缺陷数: 3个 │ │ 裂纹: 2个 │ │ 气孔: 1个 │ │ │ │ 缺陷列表: │ │ ┌──────────────────────────┐ │ │ │ #1 裂纹 │ │ │ │ 位置: 125.3mm │ │ │ │ 幅值: 85.2% │ │ │ │ 长度: 2.5mm │ │ │ │ 严重度: ⚠️ 中等 │ │ │ └──────────────────────────┘ │ │ │ │ ┌──────────────────────────┐ │ │ │ #2 裂纹 │ │ │ │ 位置: 287.6mm │ │ │ │ 幅值: 92.1% │ │ │ │ 长度: 3.8mm │ │ │ │ 严重度: 🔴 严重 │ │ │ └──────────────────────────┘ │ │ │ │ [导出列表] [查看详情] │ └────────────────────────────────┘
5
生成检测报告
- 点击按钮
- 选择报告类型（简要/详细/技术）
- 选择包含内容（实验信息、波形图表、缺陷列表等）
- 选择报告格式（PDF/Word）
- 点击
- 等待3-5秒后自动下载报告
📄 报告内容包括：
- 实验基本信息和检测参数
- 完整的双通道波形图
- 缺陷详细列表和分析
- 检测结论和处理建议
- 操作员和审核员签字栏
示例2：查看历史检测记录
1
打开历史记录
点击界面底部的按钮
2
浏览或搜索
- 使用搜索框：输入项目名称、工件名称或操作员
- 使用筛选：按日期、状态、操作员筛选
- 点击列表项查看详情
3
查看或导出
- 点击"查看"：加载完整实验数据
- 点击"导出"：下载CSV/Excel数据
- 点击"删除"：删除不需要的记录
示例3：导出数据
1
选择导出格式
点击，选择格式：
- CSV：Excel兼容，通用性好
- Excel：直接在Excel中打开
- JSON：程序处理、数据交换
2
选择导出内容
勾选需要导出的内容：
- ☑ 实验基本信息
- ☑ 检测参数
- ☑ 信号波形数据
- ☑ 缺陷列表
- ☑ 时间戳
3
下载文件
点击"导出"按钮，文件自动下载到本地
⚙️ 功能详解
波形颜色说明
| 颜色 | 含义 | 应用场景 |
|---|---|---|
| ● 蓝色 | 正常信号 | 信号幅值在阈值以下 |
| ● 红色 | 超阈值信号 | 可能存在缺陷 |
| ● 绿色 | 参考信号 | 对比或校准 |
| ● 黄色 | 警告信号 | 接近阈值 |
| ● 灰色 | 历史数据 | 已保存的数据 |
缺陷类型识别
1. 裂纹信号特征
信号特点
- 幅值：突然升高
- 波形：尖峰状
- 持续时间：短暂（<0.5s）
- 处理：必须修复
2. 气孔信号特征
信号特点
- 幅值：中等升高
- 波形：圆滑峰
- 持续时间：较短（0.2-0.5s）
- 处理：视情况修复
3. 夹渣信号特征
信号特点
- 幅值：不规则
- 波形：多峰
- 持续时间：较长（0.5-2s）
- 处理：评估后处理
🎛️ 参数配置指南
按材质推荐参数
| 材质 | 磁化方式 | 电流(mA) | 阈值(%) | 备注 |
|---|---|---|---|---|
| Q235钢 | 直流 | 800-1200 | 75-85 | 常用结构钢 |
| Q345钢 | 直流 | 1000-1500 | 80-90 | 高强度钢 |
| 不锈钢 | 交流 | 1200-1800 | 85-95 | 需更高电流 |
| 铸铁 | 直流 | 1500-2000 | 70-80 | 较脆材料 |
按工件厚度推荐参数
| 厚度(mm) | 电流(mA) | 增益 | 说明 |
|---|---|---|---|
| <5 | 600-800 | 1.2-1.5 | 薄件高灵敏度 |
| 5-10 | 800-1200 | 1.0-1.2 | 标准厚度 |
| 10-20 | 1200-1600 | 0.8-1.0 | 较厚工件 |
| >20 | 1600-2000 | 0.5-0.8 | 厚件深层检测 |
⚠️ 重要提示
- 以上参数仅供参考，实际使用时需根据具体情况调整
- 首次检测建议从推荐值中间开始，根据效果微调
- 电流过大可能导致工件发热或磁化过度
- 电流过小可能检测不到缺陷
⌨️ 快捷键列表
基本控制
| 功能 | 快捷键 | 说明 |
|---|---|---|
| 播放/暂停 | Space | 切换检测状态 |
| 停止 | S | 停止检测 |
| 重置 | R | 清空数据 |
| 标记 | M | 标记当前位置 |
| 截图 | P | 保存截图 |
视图控制
| 功能 | 快捷键 | 说明 |
|---|---|---|
| 放大 | + | 放大波形 |
| 缩小 | - | 缩小波形 |
| 向左 | ← | 向左移动 |
| 向右 | → | 向右移动 |
| 全屏 | F11 | 切换全屏 |
文件操作
| 功能 | 快捷键 | 说明 |
|---|---|---|
| 保存 | Ctrl + S | 保存数据 |
| 新建 | Ctrl + N | 新建实验 |
| 打开 | Ctrl + O | 打开历史 |
| 导出 | Ctrl + E | 导出数据 |
| 打印 | Ctrl + P | 打印报告 |
帮助
| 功能 | 快捷键 | 说明 |
|---|---|---|
| 帮助 | F1 | 打开帮助 |
❓ 常见问题
Q1: 波形显示异常或不更新？
可能原因
- 网络连接问题
- 浏览器兼容性
- 缓存问题
- 检查网络连接
- 刷新页面（F5）
- 清除浏览器缓存
- 尝试更换浏览器（推荐Chrome）
Q2: 无法保存实验数据？
可能原因
- 网络断开
- 存储空间满
- 权限不足
- 检查网络状态
- 导出数据到本地备份
- 清理历史数据释放空间
- 检查用户权限
Q3: 缺陷标记不准确？
调整方法
- 调整检测阈值（降低灵敏度）
- 开启滤波功能减少噪声
- 检查磁化参数是否合适
- 手动重新标记缺陷
Q4: 系统运行缓慢？
优化方法
- 清理历史数据
- 关闭其他浏览器标签页
- 降低采样率
- 使用高性能设备
- 确保网络速度≥2Mbps
Q5: 可以离线使用吗？
部分功能可离线使用
✅ 可用功能：
- 查看已缓存的数据
- 生成简要报告
- 导出已加载的数据
❌ 不可用功能：
- 创建新实验
- 保存到云端
- 同步数据
- 查看其他设备的数据
📞 技术支持
📧 邮件支持
support@example.com
24小时内回复
💬 在线聊天
工作日 9:00-18:00
实时解答问题
📞 电话支持
400-XXX-XXXX
周一至周五 9:00-18:00
📚 培训课程
在线/线下培训
系统化学习
版本信息
| 版本 | 发布日期 | 主要更新 |
|---|---|---|
| V1.1 | 2025-10-08 | 添加测试框架、E2E测试、代码质量工具、完善用户手册 |
| V1.0 | 2025-10-01 | 首次发布：实时波形、实验管理、缺陷检测、报告生成 |
💡 获取更多帮助
- 访问在线文档中心
- 观看视频教程（快速入门10分钟）
- 参加在线培训课程
- 加入用户交流群