阿拉丁·劳保管家工坊 (aladin-ppe-forge)

阿拉丁出品 · 办公台账稽核系列。把散落在 Excel、车间领用登记本、仓库出库单里的劳保用品发放记录，一键变成「谁的岗位该配没配、哪些防护装备早该换了还在用、离职的人把安全帽带走了没、这笔劳保钱花得对不对」的答案。

劳保用品是安全生产里最容易糊弄过去、也最容易在事故后被追责的一环。台账通常记了，但很少有人逐条核过：钳工的防砸鞋三年没换、绝缘手套过期半年还在带电作业、离职三个月的人名下挂着一套阻燃服、特种防护用品连认证编号都没登记。这些不是台账好不好看的问题，是出事时定责的问题。本技能用 12 条稽核规则 + 风险密度评分，让安环员在 1 分钟内看清全厂防护配备的真实状态。

何时触发

「帮我查一下劳保用品台账有没有问题 / 做个劳保发放稽核」
「哪些防护用品已经超过更换周期了 / 谁的安全帽该换了」
「各岗位的强制配备达标率是多少 / 有没有人该配的没配」
「离职的人劳保用品退还了吗 / 做离职装备清缴清单」
「特种劳动防护用品的认证编号齐不齐 / 安全带安全帽有没有登记合格证」
「劳保领用有没有异常，谁在重复领、单价对不对、这笔钱花哪了」
「audit PPE issuance records / check safety equipment replacement cycle」

何时不触发

要在系统里实际发放、采购、下单劳保用品——本技能只稽核记录，不操作任何系统
要对接 ERP/WMS/OA 实时拉取库存与出库单——本技能只读离线导出的文件
管办公耗材、硒鼓纸张、办公用品领用——那是耗材台账的事，本款只管劳动防护用品
管固定资产、设备与工具借还——那是资产台账的事
做职业健康体检安排与职业病档案管理——那是职业健康档案的范畴
要编制劳保采购计划与招标——本技能做的是「事后稽核」，输出可作为采购输入但不代替采购决策

能做

读取发放记录 CSV/TSV/JSON（多文件合并），中文表头别名自动识别，GB18030 编码自适应
用品类别智能推断：安全帽→头部防护、绝缘手套→手部防护等九大类内置知识库，类别列缺失也能跑
更换周期三级回退：配备标准目录 > 台账自带周期列 > 按类别内置默认周期，缺目录也能判超期
岗位配备标准比对：按「适用岗位」展开强制配备矩阵，逐人核算应配未配缺口与达标率
PP1-PP12 十二条规则稽核 + P0/P1/P2 分级 + 风险密度评分 + SAFE/WATCH/ALERT 门禁
--staff/--leavers 名单联动，揪出幽灵领用人与离职未退还的可回收防护装备
输出三件套：HTML 看板（评分环+门禁横幅+KPI+风险表+人员概览）、Markdown 整改清单（checkbox 可勾选）、utf-8-sig CSV 台账（Excel 直接打开）

不做

不联网、不调用任何在线接口，数据不出本机
不对接 ERP/WMS/采购系统，不实时抓取库存
不执行发放、采购、报废等系统操作
不管办公耗材、固定资产、工具借还（与耗材/资产台账分工明确）
不替代法定安全评价与专业机构检测结论（稽核结果是管理线索，不是法律鉴定）

输入输出规范

输入：发放记录文件（CSV/TSV/JSON，必需，可多个）；可选 --catalog 配备标准目录、--staff 在册名单、--leavers 离职名单。表头支持中文别名：发放日期/姓名/工号/部门/岗位/用品名称/类别/规格/数量/单价/金额/更换周期/领用类型/签收/认证编号/供应商/退还日期（详见 references/data-contracts.md）。

输出（全部落在 --outdir 指定目录）：

ppe_dashboard.html 看板：评分环 SVG + 门禁横幅 + 9 项 KPI + 风险清单 + 逐人领用概览
ppe_report.md 整改清单：P0 当日 / P1 一周 / P2 建议三档 checkbox + 下游联动建议
ppe_ledger.csv 归一化台账，含超期天数与规则标记，utf-8-sig 编码 Excel 直开

工作流

Step 1：清洗归一（ppe_ingest）

python scripts/ppe_ingest.py 劳保发放台账.csv [更多文件...] \
  [--catalog 配备标准目录.csv] [--staff 在册名单.txt] [--leavers 离职名单.txt] \
  [--year 2026] -o ppe_ir.json

产出中间层契约 aladin.ppe-ir/v1。表头无法识别、文件为空、全部行无有效数据时报错退出（exit=2），不吞错。

Step 2：规则稽核（ppe_audit）

python scripts/ppe_audit.py ppe_ir.json -o ppe_audit.json \
  [--today 2026-07-30] [--qty-threshold 5] [--overdue-grace 30]

执行 PP1-PP12 十二条规则（速览见下表，详解见 references/audit-rules.md），输出发现清单 + KPI + 评分门禁 + 逐人聚合。阈值全部可调，--today 固定基准日以保证结果可复现。

| 规则 | 级别 | 说明 | |------|------|------| | PP1 | P0 | 强制配备缺失：岗位按标准应配，台账中无任何发放记录 | | PP2 | P0/P1 | 防护用品超期未更换（超期过半周期升 P0） | | PP3 | P0 | 离职人员未退还可回收防护装备 | | PP4 | P1 | 幽灵领用人：领用人不在在册名单 | | PP5 | P1 | 发放无签收记录 | | PP6 | P1/P2 | 未到周期提前重复领用 | | PP7 | P1 | 日期异常：未来日期或退还早于发放 | | PP8 | P1 | 特种劳动防护用品缺认证编号 | | PP9 | P2 | 尺码敏感用品（鞋/服装/手套）缺规格 | | PP10 | P2 | 单次领用数量异常 | | PP11 | P2 | 单价显著偏离同类中位水平 | | PP12 | P1 | 关键字段缺失（日期/姓名/用品） |

评分模型（风险密度）：P0 权重 25 / P1 权重 8 / P2 权重 3，加权扣分按受检人数归一，得分 = 100 − 人均扣分。这样 100 人工厂与 10 人班组可横向比较，不会因台账体量大就必然触底 0 分。存在 P0 时评分封顶 74 分，硬伤不被规模稀释。门禁：有 P0 或 <60 分 ALERT；<85 分 WATCH；其余 SAFE。

Step 3：生成报告（ppe_report）

python scripts/ppe_report.py ppe_audit.json --ir ppe_ir.json --outdir 输出目录 [--prefix ppe]

一次产出 HTML 看板 + MD 整改清单 + CSV 台账三件套。

复用资源

| 文件 | 用途 | 加载时机 | |------|------|----------| | references/audit-rules.md | PP1-PP12 规则详解：判定条件、阈值参数、处置建议、误报豁免说明 | 需要解释某条发现或调阈值时加载 | | references/data-contracts.md | 输入表头别名全表 + aladin.ppe-ir/v1 契约字段 + 类别知识库与默认周期表 | 准备输入数据或对接下游时加载 | | references/usage-examples.md | 3 个完整场景示例（季度全厂稽核/离职清缴/超期换新采购）+ 最佳实践 + FAQ | 首次使用或用户问「怎么用」时加载 |

samples/ 内附一套 94 行演示台账（含 15 项配备标准、20 人在册、2 人离职），可直接跑通三步链路查看效果。

重要约束

数据不出本机：全流程纯 Python 标准库离线运行，不联网、不上传、不调用第三方服务（→ Trust）
不吞错：输入无法解析、契约不匹配一律报错退出 exit=2，绝不静默产出半份报告（→ Reliability）
结果可复现：固定 --today 后同一输入双跑输出逐字节一致，每条结论可追溯到规则与行号（→ Reliability）
只稽核不执行：不触碰采购与发放系统，发现问题只给处置建议，由人决策（→ Trust）
阈值透明可调：基准日、数量阈值、超期宽限期全部命令行可调并写入结果契约（→ Convention）
规则不空转：安全帽等可调头围通用款豁免尺码校验，避免刷屏式误报淹没真问题（→ Reliability）
表头中立：兼容常见台账导出与手工登记表头，不绑定任何特定品牌系统（→ Adaptability）

更新日志

1.0.0：首发。三脚本流水线（ingest/audit/report）、PP1-PP12 十二规则、风险密度评分 + SAFE/WATCH/ALERT 门禁、HTML/MD/CSV 三件套、配备标准比对、类别知识库、staff/leavers 名单联动。