Skip to content

xxbbm/Plastic-Material-Testing

Repository files navigation

塑料材质识别 Web 应用

项目介绍

这是给塑料回收行业从业者做的本地材质识别工具。你可以通过燃烧测试、物理感官测试来判断手上的塑料是什么料,支持 AI 智能咨询、专家标签矩阵、拍照存样,管理员还能在后台管理材质数据库和处理用户反馈。

核心功能

  • AI 智能咨询 — DeepSeek 驱动的追问式对话,AI 主动问你关键特征,3-4轮给出判定
  • 详细检测 — 选火烧法或物理感官法,按分支答题,系统加权评分自动给出最匹配材质
  • 专家模式 — 勾选 25 个特征标签,实时预测
  • 百科字典 — 24 种常见回收塑料的完整特征数据,可搜索、可展开
  • 拍照存样 — 拍照 + 备注,存本地
  • 管理后台 — 图形化增删改材质,处理用户反馈

24 种已收录材质

PC, ABS, PC/ABS合金, PP+ABS合金, 透明ABS, POM(赛钢), PP(百折胶), PE(花料), HDPE, LDPE, PA(尼龙), PS(硬胶), PET(宝特瓶), PVC, PMMA(亚克力), 阻燃ABS, 加铅重料, 石头料(钙粉料), PLA(聚乳酸), PBT, PC/PBT合金, PA/ABS合金, ASA, HIPS(改苯)


快速开始

1. 准备环境

电脑需要安装 Node.js 18 或更新版本。没有的话去 https://nodejs.org 下载安装。

2. 解压

把 plastic-material-id.zip 解压到你喜欢的目录。

3. 创建环境配置文件

在项目根目录创建一个 .env.local 文件,写入:

DEEPSEEK_API_KEY=你的DeepSeek_API_Key
ADMIN_PASSWORD=你设置的后台管理口令

DeepSeek API Key 去 https://platform.deepseek.com 注册就能免费领。 ADMIN_PASSWORD 为必填,不设则管理后台无法登录。

4. 安装依赖

cd plastic-material-id
npm install

5. 启动

npm run dev

浏览器打开 http://localhost:3000 就能用了。


使用说明

首页

  • 顶部滚动显示各材质当前参考价
  • "AI 行情简评"打开后自动请求 DeepSeek 分析市场
  • 四个入口卡片进入不同功能

详细检测(推荐首选)

  1. 选择"火烧测试"(有打火机)或"物理感官测试"(没打火机)
  2. 按提示一题一题回答,不确定就点"跳过"
  3. 顶部置信度进度条实时更新
  4. 答完点"完成检测"看结果
  5. 可以在两个分支之间切换来提高准确率

AI 咨询

  • 描述你遇到的塑料特征,AI 会反问你关键问题
  • 底部快捷标签可以一键发送常见特征
  • 左上角"+ 新对话"开新的检测对话
  • "历史对话"切换之前7天内的聊天

专家模式

  • 直接勾选你知道的特征标签,系统实时计算最可能材质
  • 标签越多结果越准

管理后台

浏览器打开 http://localhost:3000/admin,输入你在 .env.local 里设的口令。

  • 材质管理:添加/修改/删除材质数据,填写特征用于检测匹配
  • 反馈管理:查看用户提交的反馈,标记已处理并填写回复

反馈流程

用户在应用里提交反馈 → 管理员在后台看到 → 添加新材料/修复问题 → 标记已处理并回复 → 用户在"我的反馈"里看到回复


项目结构

plastic-material-id/
├── .env.local              ← 自己创建,放 API Key 和口令
├── data/
│   ├── materials.json      ← 材质数据库(管理员可在后台编辑)
│   └── feedback.json       ← 用户反馈数据
├── lib/                    ← 核心代码(API封装、存储、检测逻辑)
├── components/             ← 界面组件
├── app/                    ← 页面路由 + API
├── docs/                   ← 设计文档
└── PROJECT_SUMMARY.md      ← 项目总结

常见问题

Q: AI 聊天没反应? 检查 .env.local 里的 DEEPSEEK_API_KEY 是否正确。API Key 通过服务端中转,不暴露到浏览器。

Q: 检测结果不准? 检测基于特征权重匹配,回答的问题越多越准。也可以去管理后台微调材质的特征权重。

Q: 想加更多材质? 打开管理后台 → 材质管理 → 新增,填写特征后保存即可。新增的材质会自动出现在检测和百科中。

Q: 数据存在哪? 材质和反馈存在 data/ 目录的 JSON 文件中,检测历史和拍照存在浏览器 localStorage 里。

Q: 怎么给别人用? 同一台电脑直接浏览器打开就行。局域网内其他人访问 http://你的IP:3000 也可以。


技术栈

Next.js 16 · React 19 · TypeScript · Tailwind CSS 4 · shadcn/ui · Framer Motion · DeepSeek API

About

基于 v0 前端(Next.js 16 + React 19 + Tailwind 4 + shadcn/ui)改造完成的塑料材质识别本地 Web 应用。面向塑料回收行业从业者,提供 AI 智能咨询、分支检测流程、20+ 材质数据库、管理后台和用户反馈系统。

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors