病理设备维护登记台账生成器（pathology-equipment-log）
一句话结论：给你一张能直接交设备督查的病理科设备台账——四场景（保养登记/报修流转/状态登记/月度汇总）自动勾稽，报修未闭环整行黄色预警，闭环率自动算，【待填】红字清点，缺什么一眼看到。
本页导航：菜单式选路 → 对话示例 → 快速上手与退出码表 → 字段与判定口径 → 铁律（医疗合规四关）→ 能力边界量化表 → 岗位场景例子 → 边界提醒 → 文件索引。
菜单式选路
使用者开口后按场景引导，一次一问补要素：
第一步 · 选场景（回复序号或场景名均可）：
- ① 维护保养登记（设备编号/保养项目/保养日期/执行人工号，保养项目按厂家说明书抄录）
- ② 故障报修流转（报修日期/故障描述/维修状态/闭环日期，报修未闭环黄色预警）
- ③ 设备状态登记（在用/停用/维修——状态由病理科给定，工具只登记不判定）
- ④ 月度汇总（每台保养次数/报修闭环率自动算，未闭环台次>0 黄色预警）
第二步 · 给数据（任选一种）：
1. 粘贴/口述登记记录（按场景逐行给：设备编号、日期、项目、工号……缺的项不用编）
2. --preset 场景名 --save 骨架.json 生成填写骨架，填好 --input 回来
3. --demo 先看脱敏样例长什么样
4. 直接要空模板（8 行【待填】占位）
第三步 · 出台账：xlsx 双表 = 登记明细（异常行整行标红 / 预警行整行标黄 + 【待填】红字 + 冻结表头）+ 统计汇总（异常/预警清单/【待填】清点/隐私与合规提示）。
不知道选什么？直接说需求，我给你列选项，回个序号就出表。
对话示例
> 用户：帮我弄个病理设备保养登记表
> 助手：好的，先选场景（回序号或场景名）：①维护保养登记 ②故障报修流转 ③设备状态登记 ④月度汇总
> 用户：1
> 助手：好的，维护保养登记。按次逐行给数据，一次一项，缺的跳过不编：
> 1. 保养日期+设备编号？（示例：2026-10-10 BL-TS-01）
> 用户：2026-10-10 BL-TS-01，全封闭组织脱水机，换固定液脱水液，执行 B1077
> 助手：要素齐全（一句话直通车确认差异项：保养项目建议照厂家说明书条号抄录→可后补；下次保养日期未提供→【待填】）。生成台账：1 行，无异常，1 个【待填】。
快速上手
# 场景菜单
python scripts/make_pathology_equipment_log.py --presets
# 脱敏示例（--date 固定台账日期，可复现）
python scripts/make_pathology_equipment_log.py --demo --out 台账.xlsx --date 2026-11-01
# 指定场景（回序号 1/2/3/4 或场景名均可）
python scripts/make_pathology_equipment_log.py --preset 故障报修流转 --out 10月报修台账.xlsx
# 从填写好的骨架生成
python scripts/make_pathology_equipment_log.py --input 骨架.json --out 台账.xlsx
# 空模板（8 行【待填】占位）
python scripts/make_pathology_equipment_log.py --preset 设备状态登记 --out 空模板.xlsx
输出预览
以下为 --demo --date 2026-11-01（场景② 故障报修流转）输出的文本摘录（截取自实际生成的 xlsx 关键单元格；完整摘录与逐格复现命令见 assets/preview.md）：
| 序号 | 报修日期 | 设备编号 | 设备名称 | 故障描述 | 维修状态 | 闭环日期 | 备注 |
|---|---|---|---|---|---|---|---|
| 1 | 2026-10-08 | BL-RS-04 | 全自动染色机 | 第3缸试剂泵报错 | 已闭环 | 2026-10-11 | |
| 2 | 2026-10-18 | BL-TS-01 | 全封闭组织脱水机 | 脱水程序中途停滞 | 维修中 | 【待填】 | ⚠ 报修未闭环黄色预警（当前状态：维修中）——请跟进维修进度直至闭环（整行标黄） |
| 3 | 2026-10-28 | BL-QP-03 | 轮转式切片机 | 刀架松动 | 已闭环 | 【待填】 | ⚠️ 维修状态为已闭环但闭环日期缺失——闭环无日期佐证（整行标红） |
统计汇总（截取前几行）：登记场景=故障报修流转｜台账日期=2026-11-01｜登记行数=4｜异常行数（红）=1｜预警行数（黄）=2｜【待填】单元格=3。
退出码表（脚本 scripts/make_pathology_equipment_log.py，v1.0.0）
| 退出码 | 含义 | 处理 |
|---|---|---|
| 0 | 台账生成成功 | — |
| 10 | 输入文件不存在（沿用现有体系约定） | 核对 --input 路径 |
| 11 | 输入缺失：缺 items / items 非数组 / --save 未指定 --preset |
按 {"items": [ … ]} 结构补齐 |
| 12 | 格式错误：JSON 无法解析 / items 项非对象 / --date 无法识别 |
核对 JSON 语法与日期格式 |
| 13 | 隐私拦截：输入检测到姓名明文（张三/李某某/「工程师：张三」式）、身份证号、手机号等敏感个人信息 | 去除敏感信息后重试；登记仅用设备编号/工号（错误提示不回显敏感值） |
| 14 | 校验失败：预设名不存在 | 见 --presets 菜单（回序号/场景名均可） |
| 15 | 运行超时（60 秒看门狗） | 重跑同一条命令 |
| 20 | 解析失败 / 输出失败等未预期异常（兜底） | 把输入 JSON 与提示发给助手排查 |
| 21 | 缺依赖 | pip install openpyxl 后重跑 |
单行日期/数值格式错误不中断整份台账：该格转【待填】红字并在备注注明原因，汇总页计入清点；文件级错误才整体退出。
字段与判定口径
- ① 维护保养登记（9 列）：序号 / 保养日期 / 设备编号 / 设备名称 / 设备类别 / 保养项目 / 执行人(工号) / 下次保养日期 / 备注
- ② 故障报修流转（10 列）：序号 / 报修日期 / 设备编号 / 设备名称 / 故障描述 / 报修单号 / 维修状态 / 闭环日期 / 经办人(工号) / 备注
- ③ 设备状态登记（8 列）：序号 / 设备编号 / 设备名称 / 设备类别 / 设备状态 / 状态起始日期 / 登记人(工号) / 备注
- ④ 月度汇总（11 列）：序号 / 月份 / 设备编号 / 设备名称 / 本月保养次数 / 本月报修台次 / 已闭环台次 / 闭环率% / 未闭环台次 / 当前状态 / 备注
异常行整行标红（写入备注 ⚠️ 提示，人工核对）：
- 维护保养：设备编号缺失（保养记录无法归集到台）｜保养项目缺失（须按厂家说明书逐条抄录）｜保养日期倒置（下次保养日期早于本次）
- 故障报修：设备编号缺失｜已闭环但闭环日期缺失（闭环无日期佐证）｜闭环日期早于报修日期（日期倒置）
- 设备状态：设备编号缺失｜状态缺失｜状态值不在 在用/停用/维修 之列（状态由病理科给定，工具只登记不判定，遇「报废待批」等院务状态请先与病理科核对改填）
- 月度汇总：设备编号缺失｜台次为负｜已闭环台次>报修台次｜当前状态值非法
黄色预警（整行标黄，⚠ 提示，非差错定性）：
- 故障报修：维修状态≠已闭环 且 闭环日期空 → 「报修未闭环黄色预警（当前状态：…）」，提醒跟进直至闭环
- 月度汇总：未闭环台次>0 → 「报修未闭环黄色预警：未闭环 N 台次」
软提示（备注 ℹ️ 提示，不标红）：日期/台次格式无法识别（该格转【待填】）；闭环日期已填但状态未更新为已闭环；本月无报修（闭环率不适用）。
- 闭环率/未闭环台次为纯算术推导（闭环率=已闭环÷报修台次），源自已抄录台次，输入不全则为【待填】，绝不代填
- 设备类别对照：脱水机/包埋机/切片机/染色机/冷冻切片机等——按本院设备台账抄录，工具不预设清单
- 【待填】单元格红字标红，汇总页清点数量并提示「未补齐视为登记未完成」
- 日期支持
2026-03-15/2026.3.15/2026/3/15/2026年3月15日/20260315，月份可填2026-10/2026年10月 - 骨架 JSON 顶层的
date/dept回读时同样生效（命令行--date/--dept优先级更高，同时给出时覆盖骨架值）
铁律（医疗合规四关）
- 不判设备性能结论：只做病理科设备维护登记台账；设备性能好坏、能否继续使用以工程师检测与验收为准，台账只做保养/报修/状态的抄录与勾稽留痕
- 敏感个人信息硬拦截：脚本检测到姓名明文（含「工程师：张三」「李某某」式）、身份证号、手机号 → 退出码 13 直接拒绝处理（错误提示不回显敏感值）；登记仅用设备编号/工号；「某某公司」「保养/报修/巡检」等泛指与业务词有白名单不误拦
- 数据不出机：台账本地生成，无网络请求；设备维护信息按院内数据管理规定流转
- 不编造不代填：保养项目按厂家说明书抄录、设备状态由病理科给定、台次按维修台账抄录，缺失一律【待填】标红，汇总页清点；闭环率只做算术推导并标注口径，绝不代填
能力边界量化表
| 能做 | 不做（明确边界） |
|---|---|
| 四场景登记台账生成（xlsx 双表，可打印归档） | 不替代设备管理系统/计量管理系统：无维修工单流、无备件库存、无检定计划 |
| 报修未闭环黄色预警（标黄提醒跟进） | 不判设备性能结论：能否使用以工程师检测为准，台账不写合格/不合格 |
| 闭环率/未闭环台次自动勾稽（纯算术推导） | 不做计量检定与质控记录（检定用 equipment-calibration-log、放射质控用对应技能） |
| 设备状态登记（在用/停用/维修，状态由病理科给定） | 不做资产调拨/报废账务处置（资产口径用 equipment-transfer-log，报废走本院流程） |
| 【待填】清点与补填提示（不代填） | 不校验保养是否真做（执行质量须科室现场核查） |
| 敏感个人信息隐私拦截（退出码 13，白名单防误拦） | 不识别或处理说明书扫描件/照片；输入仅支持 JSON 文本 |
| 本地生成、数据不出机 | 不引用设备管理法规具体条款号；保养周期口径以厂家说明书与本院制度为准 |
岗位场景例子
- 病理科设备员：「脱水机每季度要保养，得留痕」→ 选 ① → 保养项目照说明书抄录，缺项目/日期倒置自动标红
- 设备员/质控员：「报修了 3 台，哪台还没修好？」→ 选 ② → 未闭环整行黄色预警，闭环要填日期
- 病理科主任：「停用/维修的设备要台账留痕」→ 选 ③ → 状态照病理科给定登记，值非法即标红
- 科室月底：「上报每台保养次数和报修闭环率」→ 选 ④ → 闭环率自动算，未闭环台次标黄提醒
边界提醒
- 与相邻技能划界：equipment-check-calendar=全院设备巡检日历、equipment-calibration-log=计量检定台账、equipment-transfer-log=设备资产档案与调拨——巡检、检定、调拨请用对应技能；本技能是病理科设备专项（保养/报修/状态），四者划清边界
- 本工具不替代设备管理系统与计量管理系统；维修单、检定证书、验收单等原始凭证按院内要求归档，台账仅作登记留痕
- 设备性能结论（合格/不合格、能否继续使用）以工程师检测与验收为准——本台账只登记事实（保养做了、报修了、状态是什么），不写任何性能判定
- 保养项目必须照厂家说明书抄录，工具不生成、不推测保养内容；执行人栏只填工号，不得填写姓名明文——脚本对姓名明文/身份证号/手机号等敏感个人信息是硬拦截（退出码 13）
文件索引
| 文件 | 用途 |
|---|---|
| scripts/make_pathology_equipment_log.py | 核心：CLI 成稿 + 四场景判定 + 黄色预警 + 闭环率勾稽 + 隐私拦截 + 错误码兜底 |
| references/pathology-equipment-guide.md | 登记实践参考：保养抄录/报修闭环/状态登记/月度勾稽台账口径 |
| assets/faq.md | 常见问题 12 条（隐私拦截/黄预警含义/闭环率算法/状态口径/系统边界等） |
| assets/anti-patterns.md | 反模式集中清单（错误操作+后果+替代） |
| assets/preview.md | 成稿预览（真实输出摘录+逐格复现命令） |
| assets/input-example.json | 输入示例（脱敏，可直接 --input 试跑） |
| beta-test/run_tests.py | 内测回归脚本（隐私拦截/退出码/标红与黄预警/闭环率勾稽/待填不编造等） |
FAQ 快捷导航：判设备能不能用→Q1｜没数据能生成吗→Q2｜为什么被拒绝（13）→Q3｜黄预警是什么→Q4｜闭环率怎么算→Q5｜状态谁说了算→Q6｜和设备管理系统→Q7｜数据外传→Q8｜【待填】算完成吗→Q9｜场景怎么选→Q10｜保养项目怎么填→Q11｜巡检检定去哪记→Q12。
