更新记录

1.0.0(2026-11-16)

首个版本:检验项目清单与量具清单逐条比对。类型分长度、电学、色度、光通量、热学、可靠性与其他七类,卡尺不能拿去覆盖电压;校准状态按「校准日期 + 周期」与判定基准日比较,到期当天仍可用、过期一天即不可用;量程要求名义值加减偏差两端都落在范围内;分辨力按公差带 1/10、最大允许误差按公差带 1/3 判定,两个除数均可配置;名义值落在量程 1/3~2/3 之外只提示不判不合格。结论分可自检、送校、增购、外委四类,同类型多台可用时按精度余量优先、理想量程次之选推荐量具,其余候选全部保留。关键特性有缺口时整批判 FAIL 并给出放行控制动作;无公差带的试验项目按外委处理并计入年费。CSV 单 BOM,含逐项目结论与口径行。Node 22.22.2 实跑 107 项断言,失败 0 项,覆盖跨年跨月、闰年、月末夹取、量程与分辨力边界、校准当天与过期一天、类型不匹配与 CSV;HBuilderX launch --compile true 真编译通过并核验 Kotlin 产物。Android 真机未执行(本轮 ADB 无设备);界面截图为 H5 真实渲染。


平台兼容性

uni-app

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
× √ × × √ × √ × ×
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
× × × × × × × × × × × ×

检验能力与量具覆盖

给品质工程师、计量员和 SQE 用的一段离线代码:在新产品导入、客户审核或 PPAP 提交前,把「这几年要检哪些特性」和「车间现有哪些量具」摆到一起,逐条判一遍,回答一个具体问题——这个项目我们自己检得了吗?检不了是送校、买新的,还是外委?

解决什么问题

供应商审核和客户 PPAP 常问两件事:检验项目清单是否覆盖图纸特性、量具是否有校准证据。多数工厂的做法是拿 Excel 台账手工比:这对卡尺量程够不够、分辨力够不够、证书过没过期、千分尺和电压表是不是一类东西,全靠人肉对上七八十行。漏一项,审核现场就被挑出来。

本插件把这件事变成可复核的判定:逐项目比对,给出覆盖状态、缺口原因与动作,并算清外委一年的费用。

判定口径

维度 判定 说明
类型 量具类型必须与检验项目一致 长度 LEN / 电学 ELEC / 光学 OPT / 热学 THERM / 可靠性 REL / 其他 OTHER,避免用卡尺"覆盖"电压
校准状态 判定基准日必须早于「校准日期 + 周期」 无记录或已过期一律不可用,先送校
量程 名义值 − 下偏差 ≥ 量程下限,名义值 + 上偏差 ≤ 量程上限 两端都要进来,不是只看名义值
分辨力 分辨力 ≤ 公差带 ÷ 10 除数可配(5 / 10 / 20),默认按十分之一规则
最大允许误差 MPE ≤ 公差带 ÷ 3 除数可配(3 / 4 / 10),默认按三分之一规则
理想区间 名义值落在量程 1/3~2/3 只作提示,不判不合格;落在两端时在说明里点出来

同一项目有多台量具可用时,按「精度余量优先、理想量程次之」选推荐量具,其余候选仍全部保留在结果里,便于审核时说明为什么选它。

四类结论

  • COVERED:有量具通过全部判定,直接自检。
  • NEED_CAL:有量具能力够但校准过期或缺失。这类是手续问题,送校最便宜。
  • NEED_BUY:现有量具量程、分辨力或精度不够,需增购。
  • NEED_OUTSOURCE:没有同类型量具,按外委处理,并计入年度外委费(年频次 × 单次单价)。

整批判定:关键特性(CTQ)只要有一项没覆盖,verdict 直接为 FAIL,并给出一条放行控制动作;非关键缺口为 CONDITIONAL。

公开 API

import { gageCoverage, gageExport, gageVersion } from '@/uni_modules/szhzy-gage-coverage'

const out = gageCoverage({
  today: '2026-11-16',            // 判定基准日,由调用方传入,插件不读系统时钟
  resolutionDivisor: 10,          // 可选,默认 10
  accuracyDivisor: 3,             // 可选,默认 3
  idealLow: 0.333,                // 可选
  idealHigh: 0.667,               // 可选
  items: [
    { id: 'I1', name: '灯体长度', kind: 'LEN', nominal: 320, tolPlus: 0.3, tolMinus: 0.3, unit: 'mm', grade: 'CTQ', freqPerYear: 12, outsourcePrice: 60 }
  ],
  gages: [
    { id: 'G1', name: '数显卡尺', kind: 'LEN', rangeMin: 0, rangeMax: 150, resolution: 0.01, mpe: 0.03, calDate: '2026-03-10', calCycleMonths: 12, status: 'ACTIVE' }
  ]
})

out.verdict        // PASS / CONDITIONAL / FAIL
out.coverageRate   // 项目覆盖率 %
out.ctqRate        // 关键特性覆盖率 %
out.needCal        // 需送校项数
out.outsourceYearCost // 年度外委费
out.items[i].code  // 单项目结论
out.items[i].pairs // 每台量具的逐项判定与原因
out.actions        // 动作清单(送校 / 增购 / 外委 / 放行控制)

gageExport(options) 导出同一批判定为 CSV(单 BOM,含逐项目结论与口径行),默认写应用外部私有目录;gageVersion() 返回版本与默认口径。

统一返回信封

所有方法返回 { ok, code, message, ... },错误用 code 表达,不抛异常:

code 含义
SUCCESS 全部覆盖
HAS_GAP 关键特性全覆盖,存在待处理项
CTQ_GAP 关键特性有缺口,不得以自检结论放行
NO_ITEMS 未录入检验项目
BAD_INPUT 基准日期格式不是 YYYY-MM-DD
NO_OUTPUT_DIR / BAD_FILE_NAME / WRITE_FAILED 导出失败的具体原因

购买前必读

  • 不内置量具库、不内置标准公差表。 量程、分辨力、MPE 一律由你按量具说明书或校准证书录入;插件不猜型号。
  • 不做单位换算。 项目单位与被测量具单位必须一致,混填 mm 与 mil 会被判成量程不符。
  • 判定口径可调但要有依据。 十分之一与三分之一是常见做法,客户或体系有更严要求时自行改除数,并把依据写进检验规范。
  • 只解决「有没有合用仪器」,不替代 MSA。 量具够不够准是一回事,测量系统重复性再现性(GRR)是另一回事,两者要分别做。
  • 校准日期按证书上的日期录入。 插件只做日期比较,不判断证书本身是否有效(资质范围、不确定度是否满足,仍需人工看证书)。
  • 仅支持 Android。 iOS、鸿蒙与各小程序端未实现,市场平台声明里已标不支持。

验证状态

  • 编译:cli launch app-android --project <演示工程> --compile true 真编译通过,Kotlin 产物已核对存在与行数。
  • 逻辑:Node 实跑核心逻辑断言,覆盖日期跨月跨年、闰年、量程与分辨力边界、校准当天与过期一天、类型不匹配、四类结论切换与 CSV,失败 0 项。
  • 界面:用 H5 渲染真实页面截图(演示数据全部由插件按本厂清单计算得出)。
  • Android 真机未执行:本轮 ADB 无在线设备,真机链路(含 CSV 实际落盘)未验证,不能对外声称真机通过。

许可

商用授权范围内可用于任意数量的自有 App。源码授权可二次开发,但不得转售或作为同类插件重新发布。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

无系统权限。CSV 写出使用应用外部私有目录,不读取设备其他文件。

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集、不上传任何数据,不访问网络,不写日志。输入与判定结果只在本机内存处理;CSV 由调用方触发写出,默认保存到应用外部私有目录。

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

无

暂无用户评论。