来料异常 AI 沟通函件生成器｜工业AI分析工具
这个工具解决什么问题
样本量不够时拟合出的一切都不可信。这工具会先做数据体检。
> 来料异常函件最容易犯两个错：写得不像公函、该要的证据没要全 —— 一次把两件事都做对。
输入数据格式
数据文件 incoming_issue.csv，列顺序为：供应商、料号、物料、批次、来料数、不良数、不良项目、规格要求、实测值、检测方法、检验依据、检验日期。
示例首行：XX精密材料,LT-2210,涂层浆料,S24091,5000,62,涂层附着力不足,附着力 >= 4.0 MPa,2.8 MPa,拉拔法,GB/T 2828.1 一般检验 II 级,2026-09-26
适用场景
· 来料不合格联络、供应商整改跟踪、外资/海外供应商沟通 · 即使单批在 AQL 内，同一不良项目连续两批出现也应当发函 —— 等超了再发就晚了
怎么用
python supplier_letter_ai.py
首次运行会自动生成示例数据并输出完整报告。 把示例数据换成你自己的（保持列名一致）后重新运行即可。
方式二：环境变量
set DEEPSEEK_API_KEY=你的密钥 # Windows export DEEPSEEK_API_KEY=你的密钥 # Linux / macOS
方式三：命令行临时指定（不落盘，适合共用电脑）
python supplier_letter_ai.py --token 你的密钥
接口根地址与模型名也可用 DEEPSEEK_BASE_URL / DEEPSEEK_MODEL 覆盖， 换供应商时只改根地址即可 —— 请求体会话结构是 OpenAI 兼容格式。
输入数据
incoming_issue.csv（供应商/料号/物料/批次/来料数/不良数/不良项目/规格要求/实测值/检测方法/检验依据/检验日期）+ letter_info.json（收件方、发件人、联络序号等抬头信息）
输出内容
· 不良率逐批计算与 AQL 超限判定（默认 AQL 1.0%，可 --aql 调整） · 本次必须索取的资料清单（7 项，从 COA 到横向展开） · 函件要素预检（缺抬头信息会标出） · AI 段：中文函 + 英文函（同一事实，英文不逐字直译）
没有 Token 也能用（离线模式）
离线也能跑：事实核对、资料清单与中文函骨架可直接填内容使用
配置 Token 后，报告里的 AI 段落会自动补全；调用失败时也不会中断， 本地计算部分照常输出，只是在报告里标注 AI 段失败原因。
依赖
无。仅使用 Python 标准库（urllib / json / csv / math / re 等）， 不需要 pip 安装任何包，Windows / Linux / macOS 均可运行。
可调参数与计算口径
脚本顶部集中了主要阈值与常量：DATA_CSV="incoming_issue.csv"、INFO_JSON="letter_info.json"、REPORT_TXT="supplier_letter.txt"、USAGE_CSV="ai_usage_log.csv"、TEMPLATE_JSON="deepseek_config.json"、DEFAULT_BASE="https://api.deepseek.com"。改完直接重跑即可，不必改动计算逻辑。
--aql：允收水平（%%），默认 1.0（默认 DEFAULT_AQL）--mock：演示模式，不联网--token（默认 ""）--model（默认 ""）
会生成哪些文件
运行后除控制台输出外，还会生成：incoming_issue.csv、letter_info.json、supplier_letter.txt、ai_usage_log.csv、deepseek_config.json。
工具中出现的字段与提示
- 本批次出厂检验记录（COA / 检测报告），需覆盖本次不良项目
- 该批次的原材料追溯信息（上游批号、生产日期、产线与班次）
- 不良原因分析（5Why 或鱼骨图）与流出原因分析
- 临时围堵措施及其覆盖范围（在途、库存、已交付）
- 永久纠正措施与验证数据（含改进后同批重新检测结果）
- 同批剩余库存的处理方案（退货 / 挑选 / 让步接收）
- 同类物料与其他供货批次的横向展开结果
- 内置默认值
- 配置文件 %s
- 配置读取失败 %s：%s
- 环境变量 DEEPSEEK_API_KEY
- 输入token
- 输出token
- 合计token
- 估算费用
- XX精密材料
- 涂层浆料
- 涂层附着力不足
其余字段以界面与示例报告为准。
下载与文件清单
压缩包内包含：主程序脚本、示例数据文件、示例输出报告、中文说明文档，以及同主题 AI 提示词一套。解压后按说明运行即可，示例数据可直接试跑。
主程序文件：supplier_letter_ai.py。
本站工具免费下载，无需注册。工具为 Python 脚本，Python 3.8 及以上环境可直接运行，核心功能尽量不依赖第三方库。
常见问题
输入数据要准备成什么样？
按 示例首行中的列顺序准备即可，共 12 列：供应商、料号、物料、批次、来料数、不良数、不良项目、规格要求。列为空或格式不符时结果会失真，建议先用示例数据试跑一遍。
跑完最该关注哪几项？
报告按 中文函 等部分组织，其中判定结论与建议部分直接对应下一步动作。
阈值可以改成我们自己的标准吗？
可以，脚本顶部已把主要阈值与常量集中声明，按自己产线的标准修改后重跑即可，不需要改计算逻辑。
附赠的提示词怎么用？
把提示词与自己的数据一起交给大模型，可以让它按同一套口径帮你改写分析流程或扩展报告字段。
同分类的其它工具
分类归属：工业AI与智能分析工具包；完整清单在 工具资源包下载页。
