16 KiB
16 KiB
🎉 参数模板管理功能上线通知
📅 更新时间
2025-10-16
🎯 更新内容
为负载类型管理添加了完整的参数模板管理功能，现在您可以直接在界面上查看和了解每种设备类型的参数配置模板。
✨ 新增功能
1. 参数模板入口 ⭐
位置: 负载管理 > 负载类型 > 参数模板列
在设备类型列表中，新增了"参数模板"列，可以：
- 查看每个设备类型有多少个参数
- 点击按钮查看参数详情
┌────────────────────────────────────────────────────┐
│ 设备名称 │ 类别 │... │ 参数模板 │ 操作 │
├────────────────────────────────────────────────────┤
│ 北斗终端 │ 北斗 │... │ [👁️ 3 个参数] │ ✏️ 🗑️ │
│ 摄像头 │ 摄像 │... │ [👁️ 6 个参数] │ ✏️ 🗑️ │
│ 油耗传感 │ 油耗 │... │ [👁️ 4 个参数] │ ✏️ 🗑️ │
└────────────────────────────────────────────────────┘
2. 参数模板查看对话框 ⭐
功能: 点击"X 个参数"按钮，打开参数模板详情对话框
显示内容:
- ✅ 设备类型基本信息（类别、品牌、型号、通信协议）
- ✅ 参数列表（编号、名称、类型、单位）
- ✅ 参数详细配置（编码、默认值、范围、选项）
- ✅ 参数说明文字
- ✅ 必填参数标识
- ✅ 使用说明
界面示例:
┌─────────────────────────────────────────────────────┐
│ 参数模板 - 高清摄像头 │
├─────────────────────────────────────────────────────┤
│ ┌─────────────────────────────────────────────────┐ │
│ │ 类别: [摄像头] 品牌: 海康威视 │ │
│ │ 型号: DS-2CD2345 通信协议: RTSP │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 参数定义 (6) [3 个必填] │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ [1] IP地址 * │ │
│ │ 参数编码: ipAddress 参数类型: [文本] │ │
│ │ 默认值: 192.168.1.100 │ │
│ │ 摄像头IP地址 │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ [2] 端口 * │ │
│ │ 参数编码: port 参数类型: [数字] │ │
│ │ 默认值: 554 范围: 1 ~ 65535 │ │
│ │ RTSP端口号 │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ [3] 通道号 * │ │
│ │ 参数编码: channel 参数类型: [数字] │ │
│ │ 默认值: 1 范围: 1 ~ 16 │ │
│ │ 视频通道编号 │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ [4] 分辨率 │ │
│ │ 参数编码: resolution 参数类型: [选择] │ │
│ │ 默认值: 1080p │ │
│ │ 选项: [1080P] [4K] │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ [5] 帧率 (fps) │ │
│ │ 参数编码: fps 参数类型: [数字] │ │
│ │ 默认值: 25 范围: 15 ~ 60 │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ [6] 夜视功能 │ │
│ │ 参数编码: nightVision 参数类型: [布尔] │ │
│ │ 默认值: true │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ 📋 参数模板使用说明 │ │
│ │ • 参数模板定义了该设备类型的可配置参数 │ │
│ │ • 挂载设备后，可在"负载参数"页面根据模板配置 │ │
│ │ • 必填参数标记为红色 * ，挂载设备后必须配置 │ │
│ │ • 参数编码(key)用于系统内部识别，请使用英文 │ │
│ │ • 如需修改参数模板，请编辑该设备类型 │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ [关闭] [✏️ 编辑设备类型] │
└─────────────────────────────────────────────────────┘
3. 增强的统计卡片 ⭐
新增统计:
- 参数模板总数：所有设备类型的参数总和
- 已配置模板：已定义参数的设备类型数量
┌─────────┬<EFBFBD><EFBFBD><EFBFBD>────────────┬─────────────┬─────────┬─────────┐
│总类型数 │参数模板总数 │已配置模板 │北斗终端 │摄像头 │
│ 5 │ 21 │ 5 / 5 │ 1 │ 1 │
└─────────┴─────────────┴─────────────┴─────────┴─────────┘
4. 预置的参数模板 ⭐
系统已为5种常用设备类型预置了完整的参数模板：
1. 北斗终端 (3个参数)
✅ 上报间隔 (number, 1-60秒, 必填)
- 编码: reportInterval
- 默认值: 10秒
- 说明: 位置数据上报时间间隔
✅ 精度模式 (select, 必填)
- 编码: accuracyMode
- 选项: 高精度 / 普通
- 默认值: 高精度
- 说明: 定位精度模式
✅ 数据格式 (select)
- 编码: dataFormat
- 选项: JSON / XML
- 默认值: JSON
2. 高清摄像头 (6个参数)
✅ IP地址 (string, 必填)
- 编码: ipAddress
- 默认值: 192.168.1.100
- 说明: 摄像头IP地址
✅ 端口 (number, 1-65535, 必填)
- 编码: port
- 默认值: 554
- 说明: RTSP端口号
✅ 通道号 (number, 1-16, 必填)
- 编码: channel
- 默认值: 1
- 说明: 视频通道编号
✅ 分辨率 (select)
- 编码: resolution
- 选项: 1080P / 4K
- 默认值: 1080P
✅ 帧率 (number, 15-60 fps)
- 编码: fps
- 默认值: 25
✅ 夜视功能 (boolean)
- 编码: nightVision
- 默认值: true
3. 油耗传感器 (4个参数)
✅ 采集频率 (number, 0.1-10 Hz, 必填)
- 编码: sampleFrequency
- 默认值: 1 Hz
- 说明: 数据采集频率
✅ 上传频率 (number, 1-300秒, 必填)
- 编码: uploadFrequency
- 默认值: 30秒
- 说明: 数据上传时间间隔
✅ 报警阈值 (number, 0-200 L/h)
- 编码: alarmThreshold
- 默认值: 50 L/h
- 说明: 油耗超过此值时报警
✅ 灵敏度 (number, 1-10)
- 编码: sensitivity
- 默认值: 5
- 说明: 传感器灵敏度等级
4. 转速传感器 (4个参数)
✅ 采集频率 (number, 1-100 Hz, 必填)
- 编码: sampleFrequency
- 默认值: 10 Hz
- 说明: 转速数据采集频率
✅ 上传频率 (number, 1-60秒, 必填)
- 编码: uploadFrequency
- 默认值: 10秒
- 说明: 数据上传时间间隔
✅ 最大转速 (number, 1000-5000 RPM)
- 编码: maxRpm
- 默认值: 3000 RPM
- 说明: 发动机最大转速
✅ 报警阈值 (number, 2000-5000 RPM)
- 编码: alarmThreshold
- 默认值: 3500 RPM
- 说明: 转速超过此值时报警
5. 温度传感器 (4个参数)
✅ 采集频率 (number, 0.1-10 Hz, 必填)
- 编码: sampleFrequency
- 默认值: 0.5 Hz
- 说明: 温度数据采集频率
✅ 上传频率 (number, 10-300秒, 必填)
- 编码: uploadFrequency
- 默认值: 60秒
- 说明: 数据上传时间间隔
✅ 高温报警阈值 (number, 60-120°C)
- 编码: highAlarmThreshold
- 默认值: 90°C
- 说明: 温度高于此值时报警
✅ 低温报警阈值 (number, -30-0°C)
- 编码: lowAlarmThreshold
- 默认值: -10°C
- 说明: 温度低于此值时报警
📋 使用指南
如何查看参数模板
1. 进入"负载管理"系统
↓
2. 点击"负载类型"菜单
↓
3. 在设备类型列表中找到想查看的设备类型
↓
4. 点击"参数模板"列的"👁️ X 个参数"按钮
↓
5. 查看参数模板详情对话框
- 查看所有参数定义
- 了解参数含义和配置要求
- 查看默认值和范围限制
完整的设备配置流程
1. 【负载类型】查看设备类型的参数模板
- 了解该设备有哪些可配置参数
- 查看参数的默认值和范围
↓
2. 【负载管理】挂载设备到农机
- 选择设备类型
- 填写设备名称和序列号
↓
3. 【负载参数】配置设备参数
- 系统根据参数模板自动生成配置表单
- 修改参数值
- 保存配置
↓
4. 设备配置完成，可以正常使用
参数模板的优势
1. 标准化配置
- 每种设备类型有统一的参数定义
- 避免参数配置不一致
- 便于批量配置同类设备
2. 快速配置
- 挂载设备后自动生成配置表单
- 预填充默认值
- 减少手动输入
3. 参数验证
- 自动验证参数范围
- 必填参数提醒
- 防止配置错误
4. 便于维护
- 集中管理参数定义
- 修改模板影响所有同类设备
- 易于扩展新参数
🎨 界面特性
1. 彩色类别徽章
🟢 北斗终端
🔵 摄像头
🟠 油耗传感器
🟣 转速传感器
🔴 温度传感器
2. 参数类型标识
[数字] - number 类型
[文本] - string 类型
[布尔] - boolean 类型
[选择] - select 类型
3. 必填标识
参数名称 * ← 红色星号表示必填
4. 参数单位
采集频率 (Hz)
上传频率 (秒)
报警阈值 (L/h)
5. 参数编码
ipAddress ← 系统内部使用的参数键名
reportInterval
sampleFrequency
📊 统计数据
当前系统统计:
- 总设备类型: 5 种
- 参数模板总数: 21 个
- 已配置模板: 5 / 5 (100%)
- 平均每种设备: 4.2 个参数
参数类型分布:
- 数字 (number): 15 个
- 选择 (select): 4 个
- 文本 (string): 1 个
- 布尔 (boolean): 1 个
必填参数统计:
- 必填参数: 13 个
- 可选参数: 8 个
- 必填比例: 62%
📁 相关文件
更新的文件:
/components/machinery/load/LoadType.tsx- 负载类型管理（新增参数模板查看功能）
相关文档:
/LOAD_TYPE_FEATURE_CHECK.md- 负载类型功能检查报告/LOAD_PARAMETER_FEATURE_CHECK.md- 负载参数功能检查报告
💡 常见问题
Q1: 如何修改参数模板？
A:
- 在负载类型列表中点击设备类型的"编辑"按钮
- 在编辑表单中修改参数定义
- 保存后，参数模板即更新
注意：修改参数模板不会影响已挂载设备的现有参数配置。
Q2: 参数模板和设备参数有什么区别？
A:
- 参数模板: 定义在设备类型上，是参数的"定义"和"模板"
- 设备参数: 配置在具体设备上，是参数的"实际值"
就像"产品规格书"和"产品配置单"的关系。
Q3: 为什么有些设备类型没有参数？
A: 有些设备类型可能不需要额外配置参数，或者参数模板还未定义。可以通过编辑设备类型来添加参数定义。
Q4: 参数编码(key)可以用中文吗？
A:
不建议。参数编码用于系统内部识别，建议使用英文驼峰命名（如 reportInterval），这样更规范、更易于开发集成。
Q5: 如何为新设备类型添加参数模板？
A:
- 新增或编辑设备类型
- 在编辑表单中添加参数定义
- 每个参数定义包括：
- 参数编码 (key)
- 参数名称 (label)
- 参数类型 (type)
- 默认值、范围、单位等配置
- 保存后，参数模板即生效
🎯 后续规划
计划中的功能
-
参数模板导入导出
- 导出为 JSON 文件
- 从文件导入参数模板
- 便于备份和共享
-
参数模板库
- 常用参数模板库
- 一键应用到设备类型
- 减少重复定义
-
参数校验规则
- 自定义校验表达式
- 参数之间的依赖关系
- 更复杂的验证逻辑
-
参数配置历史
- 记录参数修改历史
- 对比不同版本
- 回滚功能
📞 反馈与支持
如果您在使用参数模板功能时遇<EFBFBD><EFBFBD>任何问题，或有改进建议，请：
- 查看功能检查报告获取详细信息
- 联系系统管理员
- 提交功能改进建议
更新完成: 2025-10-16
功能状态: ✅ 已上线
下次更新: 根据用户反馈持续优化