检验试剂管理台账生成器（reagent-inventory-log）

一句话结论：给你一张能直接交检验质控督查的《检验试剂管理台账》——未开封效期和开瓶有效期双轨判定，开瓶超效的试剂单独标红一眼揪出；库存跌破安全线自动出申购建议；每个批号可追溯，汇总页给待处置清单和【待填】清点。

菜单式选路

使用者开口后按场景引导，一次一问补要素：

第一步 · 选场景（回复字母或序号）：
- A. 生化/免疫试剂月度盘点（全量登记，未开封阈值 warn=90/red=30）
- B. 临检/门急诊试剂（周转快，warn=60/red=14）
- C. 微生物/PCR/分子专项（冷链 2~8℃ 或 -20℃，备注记温度读数）
- D. 开瓶效期核查（专查已开瓶试剂，开瓶日期+开瓶效期天数必填）
- E. 自定义（自己给阈值）

第二步 · 给数据（任选一种）：
1. 粘贴/口述试剂记录（每行：试剂名称、批号、库存、有效期至、开瓶状态……缺的项不用编）
2. --preset 场景 --save 骨架.json 生成填写骨架，填好 --input 回来
3. --demo 先看脱敏样例长什么样
4. 直接要空模板（8 行【待填】占位）

第三步 · 出台账：xlsx 双表 = 试剂明细（三色标色+开瓶超效标红+冻结表头）+ 统计汇总（状态分布/待处置清单/申购建议/【待填】提示）。

文件索引

快速上手

# 场景菜单
python scripts/make_reagent_inventory_log.py --presets
# 脱敏示例
python scripts/make_reagent_inventory_log.py --demo --out 试剂台账.xlsx
# 指定场景
python scripts/make_reagent_inventory_log.py --preset 生化免疫月度 --out 11月试剂盘点.xlsx
# 从填写好的骨架生成
python scripts/make_reagent_inventory_log.py --input 骨架.json --out 试剂台账.xlsx
# 固定台账日期（剩余天数判定可复现，缺省=运行当天）
python scripts/make_reagent_inventory_log.py --input 骨架.json --date 2026-11-01 --out 试剂台账.xlsx

输入 JSON：--input 接受顶层 {"items": [...]}（--save 骨架即此格式）或直接一个记录数组；字段=列名，缺项自动【待填】。粘贴/口述记录由助手按此结构整理后调用。

骨架全局字段回读：--input 自动采用骨架 JSON 顶层的 preset（场景）、warn_days/red_days（阈值）、dept（盘点科室，进汇总页标注）、date（台账日期）——与 --save 保存字段对齐；命令行 --preset/--warn-days/--red-days/--dept/--date 优先级更高。固定台账日期后同一输入多次生成结果一致（跨日期结果变化问题就此解决）。

字段与判定口径

• 列：序号 / 试剂名称 / 规格/包装 / 批号(Lot) / 生产厂商 / 储存条件 / 存放位置 / 库存数量 / 单位 / 开瓶状态 / 开瓶日期 / 开瓶效期(天) / 未开封有效期至 / 效期判定至 / 剩余天数 / 效期状态 / 安全库存 / 申购建议 / 处置方式 / 经手人(工号) / 备注(温度/机载位点等)
• 双轨判定：
• 未开瓶 → 按未开封有效期判定
• 已开瓶 → 开瓶日期 + 开瓶效期天数 = 开瓶效期至；取「未开封有效期」与「开瓶效期至」中更早者判定
• 已开瓶但缺未开封效期：直接按开瓶效期至判定——超期记「开瓶超效」（红），不会被误归为"已过期"
• 已开瓶但缺开瓶日期或缺开瓶效期天数 → 状态【待填】，汇总页单列提示，不算正常
• 开瓶状态漏填不静默：漏填但提供了开瓶日期/天数 → 效期状态【待填】+ 屏幕提示补填（不掩盖漏项）；漏填且无任何开瓶信息 → 按未开封效期判定，但屏幕提示"已按未开封效期判定，如已开瓶请补填"
• 状态枚举：已过期(红) / 开瓶超效(红) / 临过期(红) / 近效期(黄) / 正常(绿) / 【待填】；【待填】不着色——绿色只代表"正常"，信息不全与正常在视觉上必须区分
• 阈值校验：warn/red 需 ≥0 且 warn ≥ red，违反报退出码 13；处置方式不在枚举（正常使用/优先使用/停用待处理/退库/报废销毁）→ 降级【待填】+ 屏幕校验提示
• 剩余天数 = 效期判定至 − 台账日；已过期/开瓶超效/临过期(≤red-days)标红、近效期(≤warn-days)标黄、其余绿
• 库存预警：库存数量 < 安全库存 → 申购建议自动填「建议申购」；库存/安全库存任一缺失 → 【待填】；数字解析支持"6 盒"带单位写法与负数（盘亏按负数登记，负库存必然触发申购）
• 开瓶效期天数按试剂说明书填写（常见 7/14/28 天等），本工具不代填、不猜
• 日期支持 2026-03-15 / 2026.3.15 / 2026/3/15 / 2026年3月15日 / 20260315
• 处置方式可选：正常使用 / 优先使用 / 停用待处理 / 退库 / 报废销毁

退出码表

成稿预览（--demo 真实输出摘录）

统计汇总页（demo，台账日 2026-11-01）：
  登记批次总数        6
  已过期（红）        0
  开瓶超效（红）      1        ← 沙门氏菌显色培养基，开瓶14天超效（红）
  临过期（红）        2        ← 含"开瓶效期早于未开封效期"的已开瓶批次
  近效期（黄）        0
  正常（绿）          2
  效期信息不全【待填】1        ← 已开瓶但说明书天数未查到（不着色）
  —— 待处置清单（已过期/开瓶超效/临过期）——
  序号2 甘油三酯测定试剂盒(TG) / A202512-03 / ... / 临过期 / 优先使用
  序号3 全血细胞分析试剂包(CBC) / H2609-88 / ... / 临过期 / 优先使用
  序号5 沙门氏菌显色培养基 / M2502-07 / ... / 开瓶超效 / 停用待处理
  —— 申购建议清单（低于安全库存）——
  序号2 甘油三酯测定试剂盒(TG) / A202512-03 / 库存2 / 安全线3
  序号3 全血细胞分析试剂包(CBC) / H2609-88 / 库存5 / 安全线6
  【待填】字段提示    明细表共 19 个【待填】单元格——正式上报前须逐项补齐，未补齐视为盘点未完成
  合规提示            试剂能否继续使用以厂家说明书、室内质控与本院检验制度为准

明细页：剩余天数/效期状态两列三色着色（红/黄/绿，【待填】不着色），「建议申购」橙底标出，表头深绿冻结首行。

铁律（医疗合规）

1. 不碰检测质量判断：只记效期与库存；某试剂"测得准不准""超效后结果是否可接受"以厂家说明书、室内质控与本院检验制度为准，本工具不判质量、不出检测结论
2. 不编造：试剂名称、批号、效期、开瓶日期、库存……使用者没提供的字段一律【待填】占位，汇总页清点【待填】数量并提示"未补齐视为盘点未完成"
3. 开瓶效期不代填：开瓶有效期天数依厂家说明书而定，各品牌各型号不同，用户没给就【待填】，绝不套用"常见 28 天"猜数
4. 数据不出机：台账生成在本地，含批号/厂商信息时按院内数据管理规定流转

岗位场景例子

• 检验科试剂管理员："月底试剂盘点" → 选 A → 全量批号三色台账 + 近效期清单（给采购留申购窗口）
• 门急诊组长："急诊生化仪试剂周转快" → 选 B → 阈值更严（warn=60/red=14），断货前补货
• 分子实验室："PCR 试剂冷链核查" → 选 C → 备注列记温度读数，效期+温控双查
• 组长/质控员："上周开瓶的试剂还能用吗" → 选 D → 逐瓶跟开瓶日期+开瓶效期，超效立刻标红停用登记

边界提醒

• 本工具不替代 LIS/SPD 系统的试剂管理；纸质/电子台账按院内要求归档
• 试剂储存温度异常、运输偏差等问题在备注登记，按本院不合格品控制流程处理，本工具不判合格与否
• 危险品/腐蚀性试剂的领用与销毁按《危险化学品安全管理条例》及院内制度执行，本工具只记台账
• 校准品/质控品效期管理可一并录入，但靶值与质控判定属室内质控范畴，不在本工具内