更新记录

1.0.0(2026-11-19)

1.0.0 首发:实现 MSL 全等级参考寿命、标签寿命覆盖、MSL 6 烘烤后标签窗口;事件状态机支持干燥暂停、多次出入柜、BAKE 清零与 REFLOW 关闭;输出预警、超期、当前状态与动作建议;导出单 BOM UTF-8 审计 CSV。Node 22 实跑 221 项核心断言,失败 0 项,含两组手算序列;发布前 preflight 与打包白名单校验通过。HBuilderX launch --compile true 真编译通过,index.kt 659 行,含 evaluateOf 与 auditCsv。真机未执行(ADB 有设备但处于锁屏,本轮未获解锁密码);市场截图为 H5 真实渲染 4 张,已逐张核验。


平台兼容性

uni-app

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

湿敏器件车间寿命核算

给 SMT 仓库、产线与品质人员的一套料卷事件核算工具:把同一料卷的 OPEN 开封、DRY_IN 入合格干燥柜、DRY_OUT 出柜、BAKE 合规烘烤重置、REFLOW 完成回流串成一条严格递增的事件序列,计算真实车间暴露、剩余寿命、预警或超期状态,并导出逐事件审计 CSV。

纯本地、零依赖、零权限,仅支持 Android。不扫码、不做设备保养、不做通用文件管理。

购买前必读

  • 本插件是事件核算工具,不替代 J-STD-033 的完整工艺判定。器件标签、包装说明与本厂受控规范始终优先。
  • 只有 DRY_IN 明确代表的“符合本厂与器件要求的干燥存储”才暂停计时;干燥时段不会清零。
  • BAKE 的业务含义是“调用方已确认按器件及包装要求完成合格烘烤”。插件只清零已累计暴露,不提供烘烤温度、时长或自动烘烤表。
  • 不实现 10%RH 折算、SDE 短时暴露恢复、温湿度修正。不要把普通存放、防潮箱存放或不确定环境直接登记为合格干燥存储。
  • 所有时间由调用方传入 Unix 分钟整数;核心层不读系统时钟。事件顺序含混、时间倒退或重复入柜会直接拒绝,不自动排序或猜测。

MSL 参考寿命

MSL 参考车间寿命 说明
1 无限 remainingMinutes=-1,事件与暴露仍正常累计
2 8760h 1 年按 365 天 × 24 小时口径
2a 672h 28 天
3 168h 7 天
4 72h 3 天
5 48h 2 天
5a 24h 1 天
6 上线前必须烘烤 必须传 labelHours>0,BAKE 后按标签窗口核算

limitHours>0 可覆盖普通 MSL 的参考寿命,用于制造商标签优先场景。MSL 1 始终按无限处理;MSL 6 始终按 labelHours 核算,不能用 limitHours 替代标签窗口。

快速接入

import { msdLevels, msdEvaluate, msdExport, msdVersion } from '@/uni_modules/szhzy-msd-life'

const base = 29892960
const options = {
  msl: '3',
  now: base + 5640,
  warningHours: 24,
  events: [
    { at: base, type: 'OPEN', note: '防潮包装开封' },
    { at: base + 720, type: 'DRY_IN', note: '合格干燥柜 DC-03' },
    { at: base + 5040, type: 'DRY_OUT', note: '产线领用' },
    { at: base + 5520, type: 'BAKE', note: '受控烘烤记录 BK-261106' }
  ]
}

const result = msdEvaluate(options)
// result.totalExposureMinutes = 120:BAKE 清零后又暴露 2 小时
// result.remainingMinutes = 9960:MSL 3 还剩 166 小时
// result.state = 'exposed',result.status = 'normal'

事件约束

  • 首条必须为 OPEN,同一料卷只允许一次;之后所有事件 at 必须严格递增。
  • DRY_IN 只能从 exposed 进入 dry,重复入柜返回 DUPLICATE_DRY_IN。
  • DRY_OUT 只能从 dry 返回 exposed,非法出柜返回 INVALID_DRY_OUT。
  • BAKE 可在已开封且未关闭时登记,无论当前是暴露还是合规干燥存储;事件前的暴露先审计,再将累计值清零。
  • REFLOW 截止最后一次暴露并关闭记录,之后 now 不再增加暴露,也不得再出现任何事件。
  • MSL 6 未登记 BAKE 时状态为 bake_required,不得直接登记 REFLOW。
  • now 不得早于任何事件;空事件、未知类型、小数时间均返回明确错误码。

公开 API

msdLevels()

返回 { ok, code, message, count, levels }。levels[] 每项含 key/name/hours/rule;hours=-1 表示无限,hours=0 表示 MSL 6 需使用标签窗口。

msdEvaluate(options)

参数 类型 必填 说明
msl string 是 1/2/2a/3/4/5/5a/6,大小写与首尾空格可规范化
now number 是 当前 Unix 分钟整数
events array 是 { at, type, note }[],note 可空并写入审计说明
limitHours number 否 大于 0 时覆盖普通 MSL 参考寿命;默认 0
labelHours number MSL 6 必填 合规烘烤后的标签使用窗口,必须大于 0
warningHours number 否 预警窗口,默认 24,可为 0,不可为负

成功结果除统一信封外包含:

字段 含义
totalExposureMinutes 当前累计暴露;REFLOW 后定格
remainingMinutes 剩余分钟;MSL 1 为 -1,超期为负数
usedPercent 有限寿命的使用率,可超过 100
state sealed/exposed/dry/closed;实际核算从 OPEN 开始,因此结果通常为后三者
status normal/warning/expired/bake_required/closed
hint 与当前状态对应的可执行动作建议
deadlineAt Unix 分钟;无限、已关闭、干燥暂停或 MSL 6 待烘烤时为 null
closedAt REFLOW 时点;未关闭为 null
baked 是否已登记 BAKE
audits 每条事件的 at/type/addedMinutes/totalMinutes/note

有限寿命下,remainingMinutes<0 为 expired;0<=remainingMinutes<=warningHours×60 为 warning;其余为 normal。干燥状态只暂停计时,预警或超期判定仍按已累计值执行。

msdExport(options)

接受 msdEvaluate 的全部参数,并可传 dir 与 fileName。默认文件名为 MSL车间寿命审计.csv,写应用外部私有目录。成功返回 { ok, code, message, dir, path, bytes }。

CSV 含汇总与每条事件的时点、类型、该段暴露增量、事件后累计值和说明;逗号、双引号与换行均转义。内容只带一个 UTF-8 BOM,平台写文件前会检查首字符,避免双 BOM。

msdVersion()

返回当前版本字符串 1.0.0。

错误码

code 场景
BAD_MSL MSL 等级为空或未知
BAD_NOW now 不是有限整数
EMPTY_EVENTS 事件序列为空
BAD_EVENT_TIME 事件 at 不是有限整数
FIRST_NOT_OPEN 首条不是 OPEN
UNKNOWN_EVENT 事件类型未知
TIME_NOT_INCREASING 事件时间相同或倒退
NOW_BEFORE_EVENT now 早于事件
DUPLICATE_DRY_IN 已在干燥存储仍重复入柜
INVALID_DRY_OUT 非干燥状态登记出柜
OPEN_NOT_ALLOWED 重复开封
EVENT_AFTER_CLOSED REFLOW 后仍追加事件
BAKE_REQUIRED_BEFORE_REFLOW MSL 6 未烘烤就登记回流
MISSING_LABEL_HOURS MSL 6 未提供有效 labelHours
BAD_LIMIT_HOURS limitHours 为负或非数值
BAD_LABEL_HOURS labelHours 为负或非数值
BAD_WARNING_HOURS warningHours 为负或非数值
NO_OUTPUT_DIR 无法取得应用外部私有目录
WRITE_FAILED CSV 写入失败

验证状态

  • Node 22.22.2 使用 --experimental-strip-types 真实加载 core.uts:通过 221 项,失败 0 项,覆盖全部 MSL、状态转移、手算序列、干燥暂停、BAKE 清零、REFLOW 关闭、非法输入与 CSV。
  • 发布前 preflight:已通过,10 个插件文件均为 UTF-8 无 BOM、LF,清单、价格、零依赖、权限声明与敏感信息检查通过。
  • UTS → Kotlin 编译:当前 221 项修订已复编通过,index.kt 654 行,包名及 evaluateOf/auditCsv 产物已核验。
  • Android 真机、真机文件导出:未执行(ADB 无在线设备,不声称真机通过)。
  • H5 截图:已生成并人工核验 4 张,尺寸均为 750×1624,哈希互不相同;演示工程非 App 环境使用明确标注“示例数据”的内存适配,不代表插件支持 Web。
  • 发布:未执行,按停止后续发布动作要求保持未上架。iOS、鸿蒙、小程序、Web 均不支持。

隐私、权限声明

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

无系统权限。CSV 写应用外部私有目录,不需要存储权限。

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

插件不采集、不上传任何数据,不访问网络,不写日志。MSL 等级、事件时间与核算结果仅由调用方传入并在内存中处理;审计 CSV 默认写应用外部私有目录。

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

无

暂无用户评论。