系统软件说明
一、系统简介

本系统为鱼类品质预测系统,基于机器学习算法构建,支持通过体重、溶氧、水温、pH4 个养殖特征,快速预测水产品的核心品质指标:

  • 质构预测:黏着性、弹性、回复力、内聚性
  • 营养预测:粗蛋白、粗脂肪

核心功能:用户注册登录、质构预测、营养预测(交互式/批量)、模型管理、管理员后台。

二、运行环境要求
  • Python版本:3.8~3.10(推荐)
  • 操作系统:Windows10/11、Linux、Mac OS
  • 浏览器:Chrome/Edge/Firefox(最新版)
  • 硬件要求:CPU≥4核、内存≥8G
三、快速使用流程
  1. 用户登录(必做):访问系统后自动跳转登录页面,使用管理员账户或已注册用户登录。首次使用可点击"立即注册"创建新账户。
  2. 质构预测:进入「质构预测」页面,依次输入体重、溶氧、水温、pH的数值,点击「执行预测」即可查看结果,支持 Excel 导出。
  3. 营养预测:进入「营养预测」页面,支持两种模式:
    • 交互式预测:手动输入特征值,即时获取预测结果
    • 批量预测:上传包含特征列的 Excel 文件,批量获取预测结果并下载
  4. 模型管理:在「模型管理」中查看训练图表、下载/删除模型文件(仅管理员)。
  5. 管理员后台:管理用户账户、权限分配、用户状态等(仅管理员)。
四、用户认证系统

默认管理员账户(首次启动自动创建):

  • 用户名:admin
  • 密码:admin123

⚠️ 重要提示:首次登录后请立即修改默认密码或创建新的管理员账户!


用户类型与权限

  • 管理员:拥有所有权限,可访问模型管理、管理员后台、所有预测功能
  • 普通用户:可使用质构预测、营养预测等功能

会话说明:登录会话 24 小时有效,超时后需重新登录

五、管理员后台

访问方式:点击右上角用户名 → "管理后台"

管理功能

  • 查看所有用户信息(注册时间、最后登录、状态等)
  • 添加新用户(可设置为管理员)
  • 删除用户账户
  • 激活/禁用用户账户
  • 授予/移除管理员权限
  • 用户统计(总用户数、活跃用户数、管理员数)

添加用户:填写用户名、密码(至少 6 位)、邮箱(可选),勾选"管理员"可授予管理员权限

六、批量预测文件格式要求

支持格式:仅XLSX/CSV,文件大小≤10MB

必须包含列(列名大小写不敏感,数值型):

特征:体重(a)、溶氧(b)、水温(c)、pH(d)

可选列:如包含真实目标值(粗蛋白/粗脂肪),系统将自动计算预测评估指标(MAE、RMSE、R²等)。

七、重要注意事项
  • 登录要求:所有核心功能(预测、模型管理等)都需要登录后才能使用
  • ✅ 预测操作必须在模型已训练完成后进行,未检测到模型会被系统拦截。
  • ✅ 系统运行目录不可包含中文/空格/特殊字符,否则会导致文件上传/预测失败。
  • ✅ 所有上传数据、模型文件、用户数据均保存在本地,无网络上传,数据安全可控。
  • ✅ 请妥善保管账户密码,忘记密码需联系管理员重置或重建数据库。
  • ✅ 批量预测结果文件可通过页面链接直接下载,下载链接有效期与会话同步。

系统版本:V2.0 | 开发基于 Flask+ 机器学习集成模型 + 用户认证系统

当前版本新增:用户注册登录、管理员后台、权限管理、会话控制