乐于分享
好东西不私藏

Q-Heart PPAP审核专家:本地化AI审核工具

Q-Heart PPAP审核专家:本地化AI审核工具

一、解决什么问题

PPAP文件包通常包含多个Excel工作簿,跨文件一致性审核是重复劳动重灾区:

表格

审核项
人工方式
工具方式
零件号一致性
Ctrl+F逐文件搜索
批量解析,自动比对
版本号同步
翻邮件记录核对
FMEA/CP/作业指导书关联检查
日期逻辑
肉眼排序比对
自动识别时间序列异常
CPK样本量
打开文件跳转查看
数值字段条件判断
文件完整性
对照清单逐项确认
缺失项自动标红

设计目标:机器做80%的重复检查,SQE聚焦20%的专业判断。


二、技术架构

plain

Q-Heart PPAP Auditor├── 前端层:HTML/CSS/JS,Vue/React可选├── 桌面壳:Tauri(Rust后端)│   └── 系统级能力:文件拖拽、本地存储、打印服务├── 文件解析:SheetJS(xlsx.full.min.js)├── 数据安全:CryptoJS(AES加密)├── 报告渲染:Marked(Markdown→HTML)└── AI接口:可配置DeepSeek/OpenAI/Ollama

安全设计:

  • 文件解析在浏览器内存完成,不上传服务器

  • API Key本地AES加密存储

  • 一键清除所有数据


三、功能详解(对应代码实现)

3.1 多模型AI配置

JavaScript

// 预设模型配置(MODEL_PRESETS)const MODEL_PRESETS = {    deepseek: {        apiUrl: 'https://api.deepseek.com/v1/chat/completions',        model: 'deepseek-chat',        requiresKey: true    },    openai: {        apiUrl: 'https://api.openai.com/v1/chat/completions',        model: 'gpt-4o',        requiresKey: true    },    ollama: {        apiUrl: 'http://localhost:11434/v1/chat/completions',        model: 'llama3:8b',        requiresKey: false  // 本地模型无需Key    }};

UI实现:

  • 下拉选择预设,自动填充URL和模型名

  • 支持自定义配置

  • API Key密码框输入,加密存储

3.2 批量文件解析

支持格式:.xlsx / .xls / .csv

解析逻辑:

JavaScript

// 核心流程:processFiles → processDrop// 1. 过滤支持格式const supported = files.filter(f =>     f.name.endsWith('.xlsx') ||     f.name.endsWith('.xls') ||     f.name.endsWith('.csv'));// 2. Excel解析(SheetJS)const wb = XLSX.read(new Uint8Array(data), { type: 'array' });wb.SheetNames.forEach(sn => {    const json = XLSX.utils.sheet_to_json(wb.Sheets[sn]);    // 清洗:去除全空行    const cleanData = json.filter(row =>         Object.values(row).some(v => v !== null && v !== undefined && String(v).trim() !== '')    );});// 3. CSV直接读取文本const text = await file.text();

输出结构:

JavaScript

{    name: "PSW.xlsx",    type: "excel",    sheets: [{        name: "Sheet1",        headers: ["零件号", "版本", "日期"],        data: [{零件号: "ABC-123", 版本: "A", 日期: "2024-11-08"}]    }]}

3.3 离线规则审核

当前实现规则:

表格

规则
代码逻辑
严重度
零件号不一致
遍历所有sheet,提取含"零件号/图号/Part"的字段,跨文件比对
严重
缺少PSW
检测文件名/内容含"PSW/保证书"
严重
缺少FMEA
检测文件名/内容含"FMEA/失效模式"
严重
FMEA无版本号
检测headers含"版本/版次"
一般
缺少控制计划
检测文件名/内容含"控制计划/Control Plan"
严重
控制计划无版本号
同FMEA版本检查
一般
缺少MSA
检测文件名/内容含"MSA/测量系统"
一般
缺少检验记录
检测文件名/内容含"检验/全尺寸"
一般
CPK异常偏高
解析CPK值,>2.0标为异常
一般
试验报告过旧
解析日期字段,<2021年标红
严重
缺少性能试验
检测文件名/内容含"性能/试验"
观察

评分算法:

JavaScript

const score = Math.max(0, 100 - (majorCount * 25 + minorCount * 8 + obsCount * 3));// 严重:-25分/个,一般:-8分/个,观察:-3分/个

结论判定:

  • 严重=0且一般≤2:✅ 通过

  • 严重≥2:❌ 不通过

  • 其他:⚠️ 有条件通过

3.4 AI深度审核

调用流程:

JavaScript

// 1. 组装提示词(auditPrompt)const auditPrompt = `你是IATF 16949审核专家...` + allDataText;// 2. 构造请求头const headers = {    'Content-Type': 'application/json'};if(modelConfig.apiKey) {    headers['Authorization'] = `Bearer ${modelConfig.apiKey}`;}// 3. fetch调用const r = await fetch(modelConfig.apiUrl, {    method: 'POST',    headers: headers,    body: JSON.stringify({        model: modelConfig.model,        messages: [{ role: 'user', content: auditPrompt }],        temperature: 0.1  // 低温度,输出稳定    })});

输出格式:Markdown,含四级标题结构

  • ## 一、审核结论

  • ## 二、不符合项清单

  • ## 三、SMART整改指令

  • ## 四、详细审核意见

3.5 报告渲染

结论横幅(根据解析结果动态样式):

HTML

<!-- 通过:绿色渐变 --><divclass="conclusion-banner pass">    <divclass="icon">✅</div>    <divclass="verdict">通过</div></div><!-- 有条件通过:黄色渐变 --><divclass="conclusion-banner conditional">...</div><!-- 不通过:红色渐变 --><divclass="conclusion-banner fail">...</div>

表格渲染:标准Markdown表格 → HTML <table>

操作按钮:

  • 📋 离线审核(免费)

  • 🤖 AI深度审核(显示当前模型名)

  • 📄 导出PDF(调用window.print())

  • 🗑️ 清除数据(清除localStorage所有数据)

3.6 多语言支持

实现方式:i18n字典,三语言完整覆盖

表格

语言
代码
覆盖范围
中文
zh
完整
英文
en
完整
德文
de
完整(适配德系客户场景)

切换方式:顶部按钮,localStorage持久化


四、使用流程

plain

1. 启动应用(Tauri桌面端)   └── 自动加载上次保存的模型配置2. 选择/拖拽文件夹   └── 自动识别.xlsx/.xls/.csv文件   └── 显示文件列表:文件名/工作表名/行数3. 选择审核模式   ├── 离线审核(免费):规则引擎,秒出结果   └── AI深度审核(需配置API):关联分析,详细建议4. 查看报告   └── Markdown渲染,含结论横幅、表格、列表   └── 可打印/导出PDF5. 清除数据(可选)   └── 一键清除localStorage所有数据

五、当前局限与诚实说明

表格

局限
说明
计划
仅支持Excel/CSV
PDF扫描件需手动处理或等待OCR集成
v1.0评估PDF解析
AI审核需联网
离线规则审核完整,AI增强需API Key
已支持Ollama本地模型
规则库固定
当前8条规则,客户特殊要求需手动扩展
计划自定义规则配置
单用户本地存储
无团队协作、无云端同步
评估企业版需求后决策

六、适用场景

表格

角色
场景
建议模式
主机厂SQE
供应商PPAP预审,快速筛错
离线审核为主,AI复核
Tier1质量工程师
提交客户前自查
离线审核,确保基础合规
第三方审核员
委托项目快速初审
离线+AI结合,输出正式报告
个人学习
理解PPAP结构要求
离线审核,看规则覆盖点

不适用:已部署成熟QMS/PLM系统的企业;年审PPAP<3个的个体。


七、获取与反馈

当前形态:Tauri桌面端,Windows/Mac

分发方式:

  • 百度网盘:  链接: https://pan.baidu.com/s/1OLqdop88yL_Y_xHJZasIgg?pwd=5sbu 提取码: 5sbu

反馈渠道:

  • 邮件:zhengjinfa33@163.com

特别征集:脱敏的PPAP文件包(用于测试规则覆盖度),可换取企业版授权。


八、技术栈依赖

表格

库
用途
版本
SheetJS
Excel解析
0.20.1
CryptoJS
本地数据加密
4.2.0
Marked
Markdown渲染
latest
Tauri
桌面端封装
v1/v2

工具源于实际审核工作痛点,持续迭代中。欢迎试用,欢迎拍砖。

相关学习资料