放射防护用品检查登记台账生成器（radiation-protective-gear-log）
一句话结论：给你一张能直接交放射卫生督查/等级评审的放射防护用品检查登记台账——四场景（台账登记/定期检查/到期提醒/月度汇总）自动推算到期、结论≠完好缺处置整行标红，【待填】红字清点，检测周期不套默认值，缺什么一眼看到。
本页导航：菜单式选路 → 对话示例 → 快速上手与退出码表 → 字段与判定口径 → 铁律（医疗合规四关）→ 能力边界量化表 → 岗位场景例子 → 边界提醒 → 文件索引。
菜单式选路
使用者开口后按场景引导，一次一问补要素：
第一步 · 选场景（回复序号或场景名均可）：
- ① 防护用品台账登记（逐件建档：用品编号/名称/类别（铅衣/铅围裙/铅屏风/铅眼镜等由本院目录给定）/所在机房/铅当量（由产品铭牌抄录）/启用日期/保管人工号，编号重复登记标红）
- ② 定期检查登记（检查日期/检查方式（外观/影像检测等，检测结果由检测方给定）/检查结论（完好/裂纹/变形/失效，由检查人登记）/处置措施；结论≠完好而处置缺失 → 整行标红+【待填】）
- ③ 检测到期提醒（按上次检测日期+检测周期推算下次到期，给定基准日期输出临期/超期清单；周期用 --cycle 或行内列给定，不硬编默认周期）
- ④ 月度汇总（用品完好率、待检清单、失效停用清单、按机房分布透视）
第二步 · 给数据（任选一种）：
1. 粘贴/口述登记记录（按场景逐行给：编号、机房、日期、结论……缺的项不用编）
2. --preset 场景名 --save 骨架.json 生成填写骨架，填好 --input 回来
3. --demo 先看脱敏样例长什么样
4. 直接要空模板（8 行【待填】占位）
第三步 · 出台账：xlsx 双表 = 登记明细（异常行整行标红 + 【待填】红字 + 冻结表头）+ 统计汇总（异常清单/到期统计或机房透视/【待填】清点/隐私与合规提示）。
不知道选什么？直接说需求，我给你列选项，回个序号就出表。
对话示例
> 用户：帮我们放射科弄个铅衣检查登记表
> 助手：好的，先选场景（回序号或场景名）：①防护用品台账登记 ②定期检查登记 ③检测到期提醒 ④月度汇总
> 用户：2
> 助手：好的，定期检查登记。按检查逐行给数据，一次一件，缺的跳过不编：
> 1. 检查日期？（示例：2026-10-20）
> 用户：2026-10-20
> 助手：收到。2. 用品编号+名称+类别+所在机房？（示例：FY-CT1-001 铅橡胶围裙 铅围裙 CT1机房）
> 用户：FY-CT1-001 铅橡胶围裙 铅围裙 CT1机房，外观检查完好，检查人R2011
> 助手：要素齐全（一句话直通车确认缺项：检查方式未提供→【待填】）。生成台账：1 行，无异常，1 个【待填】。
> 用户：再记一件，DR1 的铅颈套影像检测有裂纹
> 助手：检查结论「裂纹」≠完好，处置措施必须登记（送检/停用/报废按本院流程）——缺处置我会整行标红并把处置栏记【待填】。请给处置措施和检查人工号。
快速上手
# 场景菜单
python scripts/make_radiation_protective_gear_log.py --presets
# 脱敏示例（--date 固定基准日期，可复现）
python scripts/make_radiation_protective_gear_log.py --demo --out 台账.xlsx --date 2026-11-04
# 指定场景（回序号 1/2/3/4 或场景名均可）
python scripts/make_radiation_protective_gear_log.py --preset 定期检查登记 --out 10月铅衣检查.xlsx
# 到期推算：检测周期用 --cycle 给定（也可行内列逐件给），基准日期 --date
python scripts/make_radiation_protective_gear_log.py --preset 检测到期提醒 --cycle 12 \
--alert-days 30 --date 2026-11-04 --out 到期提醒.xlsx
# 从填写好的骨架生成
python scripts/make_radiation_protective_gear_log.py --input 骨架.json --out 台账.xlsx
# 空模板（8 行【待填】占位）
python scripts/make_radiation_protective_gear_log.py --preset 防护用品台账登记 --out 空模板.xlsx
骨架全局字段回读：--input 自动采用骨架 JSON 顶层的 date（基准日期）、dept（科室/登记点）、cycle（检测周期）、alert_days（预警天数）、preset（场景）——与 --save 保存字段一一对应；命令行参数优先级更高，已传时覆盖骨架值，骨架字段为【待填】视为未填不生效。--date 支持完整日期（2026-11-04 等）与月份（2026-11，按当月最后一日计）。
输出预览
以下为 --demo --date 2026-11-04 生成的防护用品台账登记关键单元格摘录（6 行，异常 2 行整行标红）：
| 序号 | 用品编号 | 用品名称 | 类别 | 所在机房 | 铅当量(mmPb) | 启用日期 | 保管人(工号) |
|---|---|---|---|---|---|---|---|
| 1 | FY-CT1-001 | 铅橡胶围裙 | 铅围裙 | CT1机房 | 0.5 | 2025-03-12 | R2011 |
| 2 | FY-CT1-002 | 铅橡胶围裙 | 铅围裙 | CT1机房 | 0.5 | 2025-03-12 | R2011 |
| 3 | FY-DR1-001 | 铅橡胶颈套 | 铅颈套 | DR1机房 | 0.5 | 2024-11-06 | R2015 |
终端同步输出摘要：已生成: 台账.xlsx / 场景 防护用品台账登记 | 登记行 6 | 异常行(红) 2 | 【待填】单元格 1。
退出码表（脚本 scripts/make_radiation_protective_gear_log.py，v1.0.1）
| 退出码 | 含义 | 处理 |
|---|---|---|
| 0 | 台账生成成功 | — |
| 10 | 输入文件不存在（沿用现有体系约定） | 核对 --input 路径 |
| 11 | 输入缺失：缺 items / items 非数组 / --save 未指定 --preset |
按 {"items": [ … ]} 结构补齐 |
| 12 | 格式错误：JSON 无法解析 / items 项非对象 / --date / --cycle / --alert-days 无法识别 |
核对 JSON 语法、日期与数值格式 |
| 13 | 隐私拦截：输入检测到姓名明文（「张三」「李某某」式/患者·病人+姓名式）、身份证号、手机号 | 去除敏感个人信息后重试；人员标识仅可用工号（错误提示不回显敏感值） |
| 14 | 校验失败：预设名不存在 | 见 --presets 菜单（回序号/场景名均可） |
| 15 | 运行超时（60 秒看门狗） | 重跑同一条命令 |
| 20 | 解析失败 / 输出失败等未预期异常（兜底） | 把输入 JSON 与提示发给助手排查 |
| 21 | 缺依赖 | pip install openpyxl 后重跑 |
单行日期/数值格式错误不中断整份台账：该格转【待填】红字并在备注注明原因，汇总页计入清点；文件级错误才整体退出。
字段与判定口径
- ① 防护用品台账登记（9 列）：序号 / 用品编号 / 用品名称 / 类别（铅衣/铅围裙/铅屏风/铅眼镜等，由本院防护用品目录给定） / 所在机房 / 铅当量(mmPb)（照产品铭牌抄录） / 启用日期 / 保管人(工号) / 备注
- ② 定期检查登记（11 列）：序号 / 检查日期 / 用品编号 / 用品名称 / 类别 / 所在机房 / 检查方式（外观/影像检测等，检测结果由检测方给定） / 检查结论（完好/裂纹/变形/失效，由检查人登记） / 处置措施 / 检查人(工号) / 备注
- ③ 检测到期提醒（11 列）：序号 / 用品编号 / 用品名称 / 类别 / 所在机房 / 上次检测日期 / 检测周期(月) / 下次到期日(推算) / 距基准日(天) / 状态（超期/临期/正常/未推算） / 备注
- ④ 月度汇总（9 列）：序号 / 月份 / 用品编号 / 用品名称 / 类别 / 所在机房 / 本月检查结论 / 状态(自动)（完好/需处置/失效停用/待检） / 备注
异常行整行标红（写入备注 ⚠️ 提示，人工核对）：
- 台账登记：用品编号重复登记（一物一号）｜铅当量为负
- 定期检查：检查结论≠完好而处置措施缺失（处置栏记【待填】，补登后重跑）
- 到期提醒：推算下次到期早于基准日期（超期）｜距到期 ≤ 预警阈值 --alert-days（临期）
- 月度汇总：本月检查结论未登记（列入待检清单）｜检查结论=失效（列入失效停用清单，应立即停用）
软提示（备注 ℹ️ 提示，不标红）：日期/数值格式无法识别（该格转【待填】）；铅当量未登记提示照铭牌/检测报告抄录；检查结论不在常见口径内按结论≠完好处理、口径以检查人登记为准；检测周期列未填按 --cycle 推算并注明；裂纹/变形用品在月度汇总中列入需处置清单（处置登记见场景②）。
- 【待填】单元格红字标红，汇总页清点数量并提示「未补齐视为登记未完成」
- 到期推算为纯算术推导（上次检测日期+周期），周期缺失则不推算不判定，绝不代填
- 完好率口径（④）：完好率 = 完好数 ÷ 已检数（完好+需处置+失效停用），待检单列不计入分母
- 铅当量只照产品铭牌与检测报告抄录，不做达标判定；日期支持
2026-03-15/2026.3.15/2026/3/15/2026年3月15日/20260315，月份可直接填2026-10/2026年10月 - 人员标识只能填工号；工具默认场景为①防护用品台账登记，
--input的 JSON 里也可写"preset": "场景名"自动选路
铁律（医疗合规四关）
- 不碰诊疗决策、不做防护效果评价：只做防护用品检查登记台账；不判断铅当量是否达标（铅当量只照产品铭牌与检测报告抄录）、不出具检测结论，防护效果评价与检测以有资质的检测机构及本院制度为准，台账只做登记留痕与时限跟踪
- 隐私硬拦截：脚本检测到姓名明文（「张三」「李某某」式/患者·病人+姓名式）、身份证号、手机号 → 退出码 13 直接拒绝处理（错误提示不回显敏感值）；工号/机房号/用品编号允许；「检查」「防护」「铅衣」等业务词白名单防误拦
- 数据不出机：台账本地生成，无网络请求；防护用品检查登记信息按院内数据管理规定流转
- 不编造不代填：数值/日期等关键字段缺失一律【待填】标红，汇总页清点；检测周期不硬编默认值（--cycle 或行内列给定，未给不推算不判定）；检测周期与铅当量要求以现行放射防护标准与本院制度为准
能力边界量化表
| 能做 | 不做（明确边界） |
|---|---|
| 四场景登记台账生成（xlsx 双表，可打印归档） | 不替代放射防护管理系统/装备管理系统：无审批流、无报废联动、无监管报送接口 |
| 异常行整行标红（结论≠完好缺处置、编号重复、超期/临期、待检） | 不做防护效果评价，不出具或复算检测结论（结论以检测方/检查人为准） |
| 到期推算（上次检测日期+周期，纯算术推导，周期参数化不硬编） | 不判断铅当量是否达标：铅当量只照铭牌与检测报告抄录，达标与否以检测报告为准 |
| 月度汇总：完好率/待检清单/失效停用清单/按机房分布 | 不碰诊疗决策：防护用品怎么用、给谁用，按诊疗规范与本院制度，台账不管 |
| 隐私拦截（退出码 13），工号/机房号/用品编号允许 | 不识别或处理影像/扫描件；输入仅支持 JSON 文本 |
| 本地生成、数据不出机 | 不引用法规具体条款号；检测周期与铅当量要求以现行放射防护标准与本院制度为准 |
岗位场景例子
- 放射科设备管理员：「新到一批铅围裙要建档，一件一号」→ 选 ① → 逐件登记，编号重复自动标红
- 科室质控员：「每季度外观检查一次，裂纹变形要记处置」→ 选 ② → 结论≠完好缺处置的行直接红
- 装备管理员：「防护用品检测到期别漏，超期就是督查缺口」→ 选 ③ → --cycle 给周期，超期/临期清单自动出
- 科室月底：「月度安全检查要报完好率和失效停用清单」→ 选 ④ → 完好率+待检清单+按机房分布透视
边界提醒
查重边界（放射相关三个台账工具分工，先看清再选）：
| 工具 | 管什么 | 不管什么 |
|---|---|---|
| radiation-protective-gear-log（本工具） | 防护用品（铅衣/铅围裙/铅屏风/铅眼镜等）的外观、编号与检测状态检查登记：建档、定期检查、检测到期、月度汇总 | 不做个人剂量监测（→radiation-dose-log），不做设备质控与场所检测（→radiation-equipment-qc-log） |
| radiation-dose-log | 人员个人剂量监测：剂量计发放回收、检测结果、异常处置、年度统计 | 不管防护用品检查登记（→本工具），不碰职业健康诊断 |
| radiation-equipment-qc-log | 设备质控与场所检测：放射诊疗设备性能质控（状态/稳定性检测）与机房场所防护检测 | 不管防护用品的检查登记（→本工具），不做通用计量检定 |
三个工具互不替代：放射技师的「个人剂量」找 radiation-dose-log、CT 的「状态检测」和机房的「场所检测」找 radiation-equipment-qc-log、穿在身上的「铅衣铅围裙」检查登记找本工具。
- 本工具不替代防护用品管理系统；纸质/电子台账按院内要求归档
- 类别（铅衣/铅围裙/铅屏风/铅眼镜等）由本院防护用品目录给定，工具不内置目录、不代判归类
- 人员标识只填工号，不得写姓名明文——脚本对姓名明文/身份证号/手机号是硬拦截（退出码 13）
- 检测结论（完好/裂纹/变形/失效）由检查人登记，检查方式与检测结果由检测方给定，工具只登记不代判
文件索引
| 文件 | 用途 |
|---|---|
| scripts/make_radiation_protective_gear_log.py | 核心：CLI 成稿 + 四场景判定 + 异常标红 + 到期推算 + 隐私拦截 + 错误码兜底 |
| references/radiation-gear-log-guide.md | 登记实践参考：建档/定期检查/到期跟踪/月度汇总台账口径 |
| requirements.txt | 依赖（openpyxl） |
| beta-test/run_tests.py | 内测回归脚本（隐私拦截/退出码/异常标红/到期推算/待填不编造等） |
| assets/faq.md | 高频问答：场景选择/周期/--date 月份/隐私拦截/分工等 12 问 |
| assets/anti-patterns.md | 反模式清单：8 条「错误用法→后果→正确做法」 |
