放射剂量监测台账生成器（radiation-dose-log）
一句话结论：给你一张能直接交职业卫生管理部门自查备查的放射工作人员个人剂量监测台账——四场景（人员与周期登记/检测结果登记/异常处置登记/年度汇总）覆盖剂量计发放回收、检测结果、异常处置、年度统计全流程登记，异常行整行标红（剂量计超期未回收、同一人同期重复登记、监测周期断档、超本院关注水平未填处置、异常处置未闭环），本院关注水平与监测周期无硬编默认值、绝不内置剂量限值数字（--alert-level/--cycle-days 或行内列填写，未填不判定），人员只以工号+科室+岗位类型标识留痕不记姓名，【待填】红字清点，缺什么一眼看到。
本页导航：菜单式选路 → 对话示例 → 快速上手与退出码表 → 字段与判定口径 → 铁律（医疗合规四关）→ 能力边界量化表 → 岗位场景例子 → 边界提醒 → 文件索引。
菜单式选路
使用者开口后按场景引导，一次一问补要素：
第一步 · 选场景（回复序号或场景名均可）：
- ① 人员与周期登记（剂量计佩戴监测周期逐行登记：工号/科室/岗位类型（放射诊断/介入/核医学/口腔/放射治疗）/监测周期标识/发放日期，应回收日期自动计算，超期未回收/回收早于发放/同一人同期重复登记/周期断档标红）
- ② 检测结果登记（单期剂量值 mSv 逐行登记：值一律来自检测机构报告、缺失一律【待填】；超本院关注水平提示，超关注水平未填处置标红；关注水平无默认值按 --alert-level 或行内列填写）
- ③ 异常处置登记（剂量异常处置留痕：异常类型/处置措施（复查/调查）/复查调查登记号，无复查/调查凭证即「异常未闭环」标红；工具只登记不决定）
- ④ 年度汇总（按科室+岗位汇总：人均剂量/最高单期剂量自动统计展示，不做职业健康结论、不做达标判定、不做考核排名）
第二步 · 给数据（任选一种）：
1. 粘贴/口述登记记录（按场景逐行给：日期、工号、科室、岗位类型……缺的项不用编）
2. --preset 场景名 --save 骨架.json 生成填写骨架，填好 --input 回来
3. --demo 先看脱敏样例长什么样
4. 直接要空模板（8 行【待填】占位）
第三步 · 出台账：xlsx 双表 = 台账明细（异常行整行标红 + 【待填】红字 + 冻结表头）+ 统计汇总（异常清单/【待填】清点/阈值口径与合规提示）。
不知道选什么？直接说需求，我给你列选项，回个序号就出表。
对话示例
> 用户：帮我做个放射工作人员剂量台账
> 助手：好的，先选场景（回序号或场景名）：①人员与周期登记 ②检测结果登记 ③异常处置登记 ④年度汇总
> 用户：2
> 助手：好的，检测结果登记。请按检测报告逐行给数据，一次一项，缺的跳过不编：
> 1. 登记日期？（示例：2026-11-02）
> 用户：2026-10-15
> 助手：收到。2. 工号+科室+岗位类型？（示例：R2001 放射科 放射诊断；只收工号不收姓名）
> 用户：R2007 核医学科 核医学
> 助手：收到。3. 监测周期标识？（示例：2026Q3）
> 用户：2026Q3
> 助手：收到。4. 检测结果(mSv)？（来自检测机构报告，没数留空不编）
> 用户：2.8
> 助手：收到。5. 本院关注水平(mSv)？（无默认值，按本院制度填，或用 --alert-level）
> 用户：1.5
> 助手：收到。6. 处置登记？（超关注水平须填复查/调查及登记号）
> 用户：还没处置
> 助手：要素齐全（一句话直通车确认差异项：处置登记未填，该行将标红提示补处置）。生成台账：1 行，超本院关注水平（2.8>1.5）未填处置，整行标红。提醒：本工具不做超标认定，是否超标以职业卫生技术服务机构与卫生监督认定为准；请尽快登记复查/调查及登记号留痕。
快速上手
# 场景菜单
python scripts/make_radiation_dose_log.py --presets
# 脱敏示例（--date 固定台账日期=超期判定基准日，可复现）
python scripts/make_radiation_dose_log.py --demo --out 台账.xlsx --date 2026-11-02
# 指定场景（回序号 1/2/3/4 或场景名均可）
python scripts/make_radiation_dose_log.py --preset 检测结果登记 --out 本期检测结果.xlsx
# 从填写好的骨架生成
python scripts/make_radiation_dose_log.py --input 骨架.json --out 台账.xlsx
# 自定义阈值（关注水平/监测周期均无默认值，按本院制度填写）
python scripts/make_radiation_dose_log.py --preset 检测结果登记 --alert-level 1.5 --out 台账.xlsx
python scripts/make_radiation_dose_log.py --preset 人员与周期登记 --cycle-days 90 --out 台账.xlsx
# 空模板（8 行【待填】占位）
python scripts/make_radiation_dose_log.py --preset 异常处置登记 --out 空模板.xlsx
退出码表（脚本 scripts/make_radiation_dose_log.py，v1.0.0）
| 退出码 | 含义 | 处理 |
|---|---|---|
| 0 | 台账生成成功 | — |
| 10 | 输入文件不存在（沿用现有体系约定） | 核对 --input 路径 |
| 11 | 输入缺失：缺 items / items 非数组 / --save 未指定 --preset |
按 {"items": [ … ]} 结构补齐 |
| 12 | 格式错误：JSON 无法解析 / items 项非对象 / --date 无法识别 / --alert-level 非正数 / --cycle-days 非正整数 |
核对 JSON 语法、日期与阈值格式 |
| 13 | 隐私拦截：输入检测到姓名明文（含「张三」「张某某」「患者+姓」式，工号/登记人等人员字段填中文姓名视同姓名明文）、身份证号、手机号（台账不设姓名列，人员只收工号+科室+岗位类型） | 去除敏感信息后重试——放射剂量台账不登记人员姓名，人员只以工号+科室+岗位类型标识留痕（错误提示不回显敏感值） |
| 14 | 校验失败：预设名不存在 | 见 --presets 菜单（回序号/场景名均可） |
| 15 | 运行超时（60 秒看门狗） | 重跑同一条命令 |
| 20 | 解析失败 / 输出失败等未预期异常（兜底） | 把输入 JSON 与提示发给助手排查 |
| 21 | 缺依赖 | pip install openpyxl 后重跑 |
单行日期/数值格式错误不中断整份台账：该格转【待填】红字并在备注注明原因，汇总页计入清点；文件级错误才整体退出。
字段与判定口径
- ① 人员与周期登记（12 列）：序号 / 发放日期 / 工号 / 科室 / 岗位类型 / 剂量计类型 / 监测周期标识 / 监测周期(天) / 应回收日期(自动) / 回收日期 / 回收状态(自动) / 备注
- ② 检测结果登记（12 列）：序号 / 登记日期 / 工号 / 科室 / 岗位类型 / 监测周期标识 / 剂量计类型 / 检测结果(mSv) / 本院关注水平(mSv) / 与关注水平比对(自动) / 处置登记 / 备注
- ③ 异常处置登记（11 列）：序号 / 登记日期 / 工号 / 科室 / 岗位类型 / 监测周期标识 / 异常类型 / 处置措施 / 复查调查登记号 / 闭环状态(自动) / 备注
- ④ 年度汇总（13 列）：序号 / 年度 / 科室 / 岗位类型 / 登记人数 / 监测期数 / 剂量记录期数 / 剂量值合计(mSv) / 人均剂量(mSv,自动) / 最高单期剂量(mSv) / 超关注水平期数 / 未闭环期数 / 备注
异常行整行标红（写入备注 ⚠️ 提示，人工核对）：
- ①：剂量计超期未回收（超过应回收日期未登记回收）｜回收日期早于发放日期（勾稽异常）｜同一人同期重复登记（同工号+同监测周期标识）｜监测周期疑似断档（相邻两期发放间隔>单期监测周期，疑似存在未登记期次）｜监测周期为零或负数
- ②：检测结果超本院关注水平未填处置｜超关注水平但处置登记未见复查/调查凭证｜同一人同期重复登记｜关注水平为零或负数
- ③：异常处置未闭环（处置措施或复查/调查登记号缺失，即无复查/调查凭证）
- ④：人均剂量>最高单期剂量（勾稽矛盾）｜剂量记录期数>监测期数（勾稽矛盾）｜未闭环期数>0｜任一数值为负
阈值设计（重要）：本院关注水平、监测周期均无硬编默认值、绝不内置剂量限值数字——按 --alert-level（mSv，允许小数）/--cycle-days（正整数天）参数或行内「本院关注水平(mSv)」「监测周期(天)」列填写，行内列优先，未填则不判定、只给软提示，绝不编造阈值依据；年剂量约束值一律不内置，检测周期、年限值口径只写「以现行职业卫生要求与本院制度为准」；本工具不引用条款号。
软提示（备注 ℹ️，不标红）：①岗位类型未填/不在常见五类（放射诊断/介入/核医学/口腔/放射治疗）｜①工号未填｜①监测周期未填无法算应回收日期｜①逾期回收（已回收但超应回收日期，提示说明原因）｜②检测结果(mSv)未填（一律来自检测机构报告，不编不代填）｜②关注水平未填无法比对（不判定）｜②监测周期标识未填（无法做同期重复登记检查）｜③异常类型未填｜④剂量值合计/记录期数缺失人均无法计算｜日期/数值格式无法识别（该格转【待填】）
- 【待填】单元格红字标红，汇总页清点数量并提示「未补齐视为登记未完成」
- 剂量值/日期/关注水平等关键字段缺失一律【待填】，绝不编造、不代填；剂量值一律来自检测机构报告，绝不代填、绝不倒推编数；判定列只由已填字段与阈值计算，不代判
- 日期支持
2026-03-15/2026.3.15/2026/3/15/2026年3月15日/20260315 - 人员列只填工号+科室+岗位类型，不填个人姓名；工具默认场景为①人员与周期登记，
--input的 JSON 里也可写"preset": "场景名"自动选路
铁律（医疗合规四关）
- 不碰诊疗决策与职业健康诊断：只做剂量监测登记留痕与周期管理；剂量值含义解读、是否超标结论归职业卫生技术服务机构与卫生监督，本工具不做职业健康结论、不做超标认定；不替代职业卫生技术服务、不替代个人剂量管理系统（剂量计发放回收与检测数据以检测机构和系统为准）；复查/调查是否启动以本院制度与职业卫生部门要求为准（工具只登记不决定）；年剂量约束值不内置、不做年度剂量达标判定、不做考核排名；不引用条款号、不编造阈值依据
- 个人信息脱敏硬拦截（本技能核心合规点）：台账不设人员姓名列——人员只以工号+科室+岗位类型标识留痕，不记姓名；脚本检测到姓名明文（含「张三」「张某某」「患者+姓」式，工号/登记人等人员字段填中文姓名视同姓名明文）、身份证号、手机号 → 退出码 13 直接拒绝处理（错误提示不回显敏感值）；数据不出机
- 数据不出机：台账本地生成，无网络请求；剂量监测记录按院内数据管理规定流转
- 不编造不代填：剂量值/日期/关注水平等关键字段缺失一律【待填】标红，汇总页清点；剂量值一律来自检测机构报告，绝不编造、绝不代填、绝不倒推编数；判定列只由已填字段与阈值计算，不代判
能力边界量化表
| 能做 | 不做（明确边界） |
|---|---|
| 四场景登记台账生成（xlsx 双表，可打印归档）：人员与周期登记/检测结果登记/异常处置登记/年度汇总 | 不做职业健康结论、不做职业健康诊断：只做剂量监测登记留痕与周期管理，剂量值含义解读与职业健康状况评估归职业卫生技术服务机构与卫生监督 |
| 应回收日期自动计算、剂量计超期未回收标红、监测周期断档提示、同一人同期重复登记标红 | 不做超标认定：是否超过职业接触限值以职业卫生技术服务机构检测报告与卫生监督认定为准，本工具不内置任何限值数字 |
| 超本院关注水平提示（--alert-level 或行内列，未填不判定）与未填处置标红、复查/调查留痕闭环检查 | 不做处置决定：复查/调查是否启动以本院制度与职业卫生部门要求为准，本工具只登记留痕不决定 |
| 年度汇总人均剂量/最高单期剂量统计展示（只做统计提示） | 不做年度剂量达标判定、不做考核排名：年剂量约束值不内置，以现行职业卫生要求与本院制度为准 |
| 个人信息脱敏硬拦截（退出码 13；人员只收工号+科室+岗位类型）、本地生成、数据不出机 | 不替代职业卫生技术服务、不替代个人剂量管理系统：检测报告与发放回收数据以检测机构和系统为准，本台账只做登记留痕，不对接任何系统 |
| 【待填】标红清点（剂量值/日期/关注水平缺失不编造） | 不引用条款号、不编造阈值依据：关注水平/监测周期均无硬编默认值；不识别检测报告扫描件，输入仅支持 JSON 文本 |
岗位场景例子
- 职业健康管理员：「各科剂量计发下去老收不回来，谁超期不清楚」→ 选 ① → 应回收日期自动算，超期未回收当场标红
- 职业健康管理员：「检测机构报告回来了，结果要登记造册」→ 选 ② → 剂量值来自报告逐行登记，超本院关注水平提示，未填处置标红
- 职业健康管理员：「有人结果偏高，复查调查要留痕」→ 选 ③ → 处置措施+登记号登记，无凭证未闭环标红（只登记不决定）
- 后勤/职业卫生负责人：「年底要给领导一份年度汇总」→ 选 ④ → 人均/最高值自动统计展示（不做达标判定、不做考核排名）
边界提醒
- 本台账不设人员姓名列：人员只以工号+科室+岗位类型标识留痕，不记姓名——脚本对姓名明文/身份证号/手机号是硬拦截（退出码 13）
- 不做职业健康结论、不做超标认定：剂量值含义解读、是否超标结论归职业卫生技术服务机构与卫生监督；「与关注水平比对」列只是本院关注水平的登记提示，不是超标结论
- 不替代职业卫生技术服务、不替代个人剂量管理系统：检测报告、剂量计发放回收与检测数据以检测机构和系统为准，本台账只做人工登记留痕，不对接任何系统
- 不做处置决定：复查/调查是否启动以本院制度与职业卫生部门要求为准，工具只登记留痕；「闭环状态」只是凭证完整性检查
- 阈值口径以本院制度为准：本院关注水平、监测周期均无硬编默认值（--alert-level/--cycle-days 或行内列，未填不判定）；年剂量约束值不内置，检测周期、年限值口径只写「以现行职业卫生要求与本院制度为准」；本工具不引用条款号
- 人员列只填工号+科室+岗位类型，不填个人姓名；剂量值一律来自检测机构报告，缺失一律【待填】不编造
文件索引
| 文件 | 用途 |
|---|---|
| scripts/make_radiation_dose_log.py | 核心：CLI 成稿 + 四场景判定 + 阈值口径 + 异常标红 + 隐私拦截 + 错误码兜底 |
| references/radiation-dose-guide.md | 登记实践参考：人员与周期/检测结果/异常处置/年度汇总台账口径与闭环留痕 |
| assets/faq.md | 常见问题 12 条（隐私拦截/工号口径/阈值调整/边界/待填卡点等） |
| assets/anti-patterns.md | 反模式集中清单（错误操作+后果+替代） |
| assets/preview.md | 成稿预览（真实输出摘录+逐格复现命令） |
| assets/input-example.json | 输入示例（脱敏，可直接 --input 试跑） |
| beta-test/run_test.py | 内测回归脚本（隐私拦截/退出码/异常标红/待填不编造等） |
FAQ 快捷导航：为什么连职工姓名都不能写→Q1｜工号会重复吗→Q2｜没数据能生成吗→Q3｜为什么被拒绝（13）→Q4｜关注水平为什么不帮我默认→Q5｜监测周期填多少→Q6｜标红是不是判定我出错→Q7｜和职业卫生技术服务机构/个人剂量管理系统什么关系→Q8｜数据外传→Q9｜【待填】算完成吗→Q10｜阈值怎么改→Q11｜场景怎么选→Q12。
