首件检验FAI差异比对与放行判定器｜SPC实战工具
这个工具解决什么问题
> 首件不只判合格：超差、边界（落在量具误差带里）、与上次比漂移，三类一起看才敢放行。
输入数据格式
数据文件 fai_first_article.csv，列顺序为：seq、item、cat、unit、lsl、usl、measured、last_measured、gauge、gauge_err。
示例首行：1,焊盘宽度,关键,mm,0.35,0.45,0.412,0.408,二次元影像仪,0.005
示例输出（真实运行结果节选）
============================================================================
首件检验 FAI 差异比对与放行判定报告
============================================================================
检验项目：12 项 关键 5 / 重要 4 / 一般 3
判定口径：超差=实测出规格；边界=合格但落在量具允许误差带内；
漂移预警=合格但与上次首件差异超过公差带的 30%。
【一】逐项判定
----------------------------------------------------------------------------
检验项目 类别 规格下限 规格上限 实测 余量 判定
1 焊盘宽度 关键 0.350 0.450 0.412 38.0% 合格
2 焊盘间距 关键 0.200 0.260 0.236 40.0% 合格
3 键合线弧高 关键 0.180 0.280 0.291 -11.0% 超差
4 塑封体厚度 重要 1.150 1.350 1.155 2.5% 边界
5 引脚共面度 重要 0.000 0.100 0.088 12.0% 漂移预警
6 表面粗糙度 一般 0.000 1.600 1.420 11.3% 合格
└ 提示：余量仅 11.3%，量产波动下极易越界，建议收紧工艺中心值。
7 芯片贴装偏移 关键 0.000 0.075 0.071 5.3% 边界
8 焊球直径 重要 0.280 0.360 0.318 47.5% 合格
9 外观-无划伤 一般 0.000 1.000 0.000 0.0% 合格
└ 提示：余量仅 0.0%，量产
适用场景
· 开线前首件确认、换料换模后首件、样品承认与量产放行 · 边界项最容易漏：它现在合格，但量产波动下必飘，报告会单独列出来
怎么用
python fai_first_article.py
首次运行会自动生成示例数据并输出一份完整报告； 把示例 CSV 换成你自己的数据（保持列名一致）后重新运行即可。
输入数据
fai_first_article.csv：序号 / 项目 / 特性类别（关键-重要-一般）/ 单位 / 规格上下限 / 本次实测 / 上次实测 / 量具 / 量具允许误差（脚本自带 12 项示例）
输出内容
· 逐项判定：合格 / 边界 / 漂移预警 / 超差，含距规格限的余量百分比 · 超差清单（含超差量与量具）、边界清单、与上次首件的漂移比对表 · 放行结论（放行 / 有条件放行 / 不放行）与复检动作清单
依赖
无。仅使用 Python 标准库（csv / math / os / datetime / random 等）， 不需要 pip 安装任何包，Windows / Linux / macOS 均可运行。
实用提示
· 报告里的判读阈值都写在脚本顶部常量区，可按自己厂内标准调整。 · 首件必须与上次首件比对，只看本次是否合格，会漏掉慢性漂移。 · 建议按周/按月滚动运行，看趋势比看单次结果更有意义。 · 换数据时保持 CSV 列名不变，脚本无需改动即可复用。
可调参数与计算口径
脚本顶部集中了主要阈值与常量：CSV_FILE="fai_first_article.csv"、REPORT_FILE="fai_report.txt"、SAMPLE_ROWS=[。改完直接重跑即可，不必改动计算逻辑。
会生成哪些文件
运行后除控制台输出外，还会生成：fai_first_article.csv、fai_report.txt。
脚本里的主要处理步骤
judge()：返回 (判定, 距最近规格限的余量百分比)。判定优先级：超差 > 边界 > 漂移 > 合格。
以上步骤在脚本中是分开的函数，可以单独调用或按需替换其中一段，不必整体重写。
工具中出现的字段与提示
- 焊盘宽度
- 焊盘间距
- 键合线弧高
- 塑封体厚度
- 引脚共面度
- 表面粗糙度
- 芯片贴装偏移
- 焊球直径
- 外观-无划伤
- 功能-通断测试
- 涂层厚度
- 已生成示例数据：%s
- 上限必须大于下限：%s
- 漂移预警
- 不放行（关键特性超差，须查明原因并重新首件）
- 有条件放行（非关键特性超差，须提交偏差申请并经质量评审）
- 有条件放行（无超差，但存在边界项或漂移预警，需 3 件复检确认）
- 放行（全部特性合格且无异常漂移）
其余字段以界面与示例报告为准。
下载与文件清单
压缩包内包含：主程序脚本、示例数据文件、示例输出报告、中文说明文档，以及同主题 AI 提示词一套。解压后按说明运行即可，示例数据可直接试跑。
主程序文件：fai_first_article.py。
本站工具免费下载，无需注册。工具为 Python 脚本，Python 3.8 及以上环境可直接运行，核心功能尽量不依赖第三方库。
常见问题
输入数据要准备成什么样？
按 示例首行中的列顺序准备即可，共 10 列：seq、item、cat、unit、lsl、usl、measured、last_measured。列为空或格式不符时结果会失真，建议先用示例数据试跑一遍。
阈值可以改成我们自己的标准吗？
可以，脚本顶部已把主要阈值与常量集中声明，按自己产线的标准修改后重跑即可，不需要改计算逻辑。
附赠的提示词怎么用？
把提示词与自己的数据一起交给大模型，可以让它按同一套口径帮你改写分析流程或扩展报告字段。
示例数据能直接跑吗？
可以。示例数据与主程序在同一压缩包内，解压后直接运行即可看到完整输出，确认无误再替换成自己的台账。
同分类的其它工具
所属分类 SPC与质量分析工具包，也可回到 工具资源包下载页 按分类查找。
