更新记录
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.kt654 行,包名及evaluateOf/auditCsv产物已核验。 - Android 真机、真机文件导出:未执行(ADB 无在线设备,不声称真机通过)。
- H5 截图:已生成并人工核验 4 张,尺寸均为 750×1624,哈希互不相同;演示工程非 App 环境使用明确标注“示例数据”的内存适配,不代表插件支持 Web。
- 发布:未执行,按停止后续发布动作要求保持未上架。iOS、鸿蒙、小程序、Web 均不支持。

收藏人数:
购买源码授权版(
试用
使用 HBuilderX 导入示例项目
赞赏(0)
下载 15
赞赏 0
下载 12773692
赞赏 1960
赞赏
京公网安备:11010802035340号