README.md

---
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 - 标准化容器部署

## 快速开始

### 本地运行

```bash
# 进入目录
cd material-cut-master

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

# 运行应用
python app.py
```

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

### Docker 运行

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

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

### 使用说明

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