material-cut-master / README.md
Trae Assistant
Enhance app with Excel support, UI improvements, and fix triggerUpload
171dd0a
metadata
title: Smart Material Cut Master
emoji: ✂️
colorFrom: blue
colorTo: gray
sdk: docker
app_port: 7860
short_description: 智材切割大师 - 1D线性材料切割优化与成本控制系统
pinned: false

智材切割大师 (Smart Material Cut Master)

智材切割大师 是一款专业的 1D 线性材料切割优化工具,旨在帮助制造业、建筑业和 DIY 爱好者最小化材料浪费,降低成本。通过先进的排版算法,它能自动计算出最优的切割方案。

核心功能

  • 智能排版算法: 采用 First Fit Decreasing (FFD) 等启发式算法,自动寻找最优切割组合。
  • 多规格原材料支持: 支持同时输入多种不同长度的原材料,系统会自动选择最合适的材料以减少废料。
  • 锯缝补偿 (Kerf): 精确控制切割损耗,确保实际切割尺寸准确无误。
  • Excel 导入/导出: 支持从 Excel 导入切割需求,并将优化结果导出为 Excel 表格。
  • 可视化报告: 直观的条形图展示切割方案,清晰标记每个零件的位置和废料区域。
  • 一键打印: 支持生成打印友好的排版单,方便车间工人直接使用。

商业与生产力价值

  • 降低成本: 直接减少昂贵材料(如铝型材、钢管、木材)的废料率。
  • 提高效率: 替代人工计算,秒级生成复杂的切割清单。
  • 库存优化: 优先使用现有库存长度,减少呆滞料。
  • 数据闭环: 支持 Excel 导入导出,轻松集成到现有生产流程中。

技术栈

  • 后端: Python (Flask) - 实现核心优化算法与数据处理
  • 前端: Vue.js 3 + Tailwind CSS - 现代响应式交互界面
  • 部署: Docker - 标准化容器部署

快速开始

本地运行

# 进入目录
cd material-cut-master

# 安装依赖
pip install -r requirements.txt

# 运行应用
python app.py

访问浏览器: http://localhost:7860

Docker 运行

# 构建镜像
docker build -t material-cut-master .

# 运行容器
docker run -p 7860:7860 material-cut-master

使用说明

  1. 设置: 输入切割设备的锯缝宽度(例如 3mm)。
  2. 原材料: 添加你仓库中现有的材料长度(例如 6000mm, 3000mm)。
  3. 需求:
    • 手动输入需要的零件长度和数量。
    • 或点击“导入需求”上传 Excel 文件(包含长度、数量、备注列)。
  4. 计算: 点击“开始优化计算”,查看生成的切割方案和利用率报告。
  5. 输出: 点击“导出 Excel”保存结果,或“打印报告”直接打印。