================================================================================
                    FAB工程师日报自动生成器 - 快速入门
================================================================================

【版本】v2.0
【更新日期】2026-07-10
【作者】半导体智能制造 | MES工程师实战笔记
【CSDN博客】https://blog.csdn.net/yeflashzhihui

================================================================================
                              一、5分钟快速开始
================================================================================

第1步：安装Python依赖（如果提示缺少模块）
------------------------------------------------
在命令提示符(CMD)中运行：

    pip install openpyxl python-docx matplotlib numpy tkinter

第2步：双击运行程序
------------------------------------------------
    双击 "日报生成器.py" 启动程序

第3步：生成示例报告（推荐首次使用）
------------------------------------------------
    1. 程序启动后，点击【生成全部示例报告】按钮
    2. 在"示例数据"文件夹中查看生成的Excel模板
    3. 点击【📊 生成日报】按钮生成示例Word报告
    4. 在"生成的报告"文件夹中查看报告

第4步：使用自己的数据
------------------------------------------------
    1. 按示例Excel格式准备你的数据
    2. 点击各数据类型的【浏览】按钮导入文件
    3. 填写报告配置信息
    4. 点击【生成日报】按钮

================================================================================
                              二、文件说明
================================================================================

│─ 日报生成器.py          主程序，双击运行
│─ 使用手册.md            详细使用说明（Markdown格式）
│─ 使用手册.html          详细使用说明（HTML格式，可用浏览器打开）
│─ 运行说明.txt           本文件
│─ 示例数据_FAB日报模板.xlsx   示例数据模板
│─ 示例数据/              示例数据文件夹（点击"示例"按钮后生成）
│─ 生成的报告/            报告输出目录
│  └─ charts/             图表图片目录

================================================================================
                              三、系统要求
================================================================================

【必需】
- Python 3.8 或更高版本
- Windows 7/8/10/11

【Python依赖库】
- openpyxl        (用于读取Excel文件)
- python-docx     (用于生成Word文档)
- matplotlib      (用于生成图表)
- numpy           (用于数据计算)
- tkinter         (用于图形界面，Python自带)

【安装命令】
    pip install openpyxl python-docx matplotlib numpy

================================================================================
                              四、数据格式
================================================================================

本工具支持4种数据源，所有数据都是Excel格式：

┌─────────────────────────────────────────────────────────────────────────────┐
│ 1. 良率数据（最重要）                                                         │
├─────────────────────────────────────────────────────────────────────────────┤
│ 列名         │ 说明              │ 示例                                     │
│──────────────┼───────────────────┼─────────────────────────────────────────│
│ 日期         │ 数据日期          │ 2026-07-10                              │
│ 产品         │ 产品型号          │ S3A512                                  │
│ 批次         │ 批次号            │ LOT2026071001                           │
│ 良率(%)      │ 百分比值          │ 97.5                                    │
│ 目标良率(%)  │ 目标值            │ 97.0                                    │
│ 差异         │ 良率-目标         │ 0.5                                     │
│ 机台         │ 设备编号          │ EQ001                                   │
│ 作业员       │ 操作人员          │ OP01                                    │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│ 2. SPC数据（可选）                                                           │
├─────────────────────────────────────────────────────────────────────────────┤
│ 列名         │ 说明              │ 示例                                     │
│──────────────┼───────────────────┼─────────────────────────────────────────│
│ 时间         │ 测量时间          │ 08:15:23                                │
│ 参数名称     │ 参数名            │ 温度(℃)                                 │
│ 测量值       │ 实测值            │ 100.5                                   │
│ UCL          │ 上控制限          │ 108                                     │
│ CL           │ 中心线            │ 100                                     │
│ LCL          │ 下控制限          │ 92                                      │
│ 规格上限     │ 规格上限          │ 110                                     │
│ 规格下限     │ 规格下限          │ 90                                      │
│ 判定         │ OK/NG             │ OK                                      │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│ 3. 设备状态（可选）                                                          │
├─────────────────────────────────────────────────────────────────────────────┤
│ 列名         │ 说明              │ 示例                                     │
│──────────────┼───────────────────┼─────────────────────────────────────────│
│ 设备ID       │ 设备编号          │ EQ001                                   │
│ 设备名称     │ 设备描述          │ 刻蚀机#1                                │
│ 状态         │ 运行/待机/维护    │ 运行                                    │
│ 运行时数(h)  │ 今日时长          │ 18.5                                    │
│ 今日产量     │ 今日产出          │ 1200                                    │
│ 可用率(%)    │ 百分比            │ 92.5                                    │
│ 备注         │ 附加说明          │ -                                       │
└─────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│ 4. 报警记录（可选）                                                          │
├─────────────────────────────────────────────────────────────────────────────┤
│ 列名         │ 说明              │ 示例                                     │
│──────────────┼───────────────────┼─────────────────────────────────────────│
│ 时间         │ 报警时间          │ 08:15:23                                │
│ 设备ID       │ 设备编号          │ EQ001                                   │
│ 报警代码     │ 报警代码          │ A-001                                   │
│ 报警内容     │ 报警描述          │ 真空度异常                              │
│ 等级         │ 高/中/低          │ 高                                      │
│ 持续时间(分) │ 分钟数            │ 15                                      │
│ 处理状态     │ 状态              │ 已处理                                  │
└─────────────────────────────────────────────────────────────────────────────┘

================================================================================
                              五、常见问题
================================================================================

Q1: 双击.py文件没有反应？
A1: 确保已安装Python，或右键文件 -> 打开方式 -> 选择Python

Q2: 提示"没有名为xxx的模块"？
A2: 打开CMD，运行: pip install openpyxl python-docx matplotlib numpy

Q3: 生成的报告是乱码？
A3: 确保Windows系统语言设置为中文，或修改代码中的字体设置

Q4: 如何批量生成多天报告？
A4: 目前需要手动逐天生成，可以在"生成的报告"文件夹查看历史报告

Q5: 报告格式不符合工厂要求？
A5: 可以修改代码中的样式配置，或联系作者定制

================================================================================
                              六、技术支持
================================================================================

【CSDN博客】
    https://blog.csdn.net/yeflashzhihui

【评论区】
    在CSDN博客文章下方留言

【提问时请提供】
    1. 错误提示截图
    2. 操作系统版本
    3. Python版本
    4. 数据文件样本（脱敏后）

================================================================================
                              七、VIP资源列表
================================================================================

关注CSDN博客，获取更多半导体智能制造工具：

    1. FAB工程师日报自动生成器       ← 当前资源
    2. SPC控制图分析工具集
    3. 半导体良率分析工具集
    4. 半导体OEE设备效率计算工具集
    5. 半导体FDC故障检测工具集
    6. 半导体MES数据采集工具集
    ... 更多资源持续更新中

================================================================================
                              感谢使用！
================================================================================
