创伤患者登记台账生成器（trauma-register-log）
一句话结论：给你一张能直接交急诊质控督查的创伤患者登记台账——四场景（接诊登记/致伤原因分布/创伤部位分布/处置去向月度汇总）一键成表，关键要素缺失行整行标红，ISS 评分与处置去向只做抄录（工具不评分、不判去向），【待填】红字清点，缺什么一眼看到。
本页导航：菜单式选路 → 对话示例 → 快速上手与输出预览 → 退出码表 → 字段与判定口径 → 铁律（医疗合规四关）→ 能力边界量化表 → 岗位场景例子 → 边界提醒 → 文件索引。
菜单式选路
使用者开口后按场景引导，一次一问补要素：
第一步 · 选场景（回复序号或场景名均可）：
- ① 接诊登记（逐笔登记：登记号、致伤原因分类、创伤部位分类、ISS 评分抄录、处置去向抄录）
- ② 致伤原因分布月度汇总（按分类汇总例数/占比/其中 ISS≥16 例数抄录）
- ③ 创伤部位分布月度汇总（按部位汇总例数与占比）
- ④ 处置去向月度汇总（急诊处置/收住院/转院，例数与占比）
第二步 · 给数据（任选一种）：
1. 粘贴/口述登记记录（按场景逐行给：登记号、日期、分类、去向……缺的项不用编）
2. --preset 场景名 --save 骨架.json 生成填写骨架，填好 --input 回来
3. --demo 先看脱敏样例长什么样
4. 直接要空模板（8 行【待填】占位）
第三步 · 出台账：xlsx 双表 = 登记明细（异常行整行标红 + 【待填】红字 + 冻结表头）+ 统计汇总（异常清单/【待填】清点/隐私与合规提示）。
不知道选什么？直接说需求，我给你列选项，回个序号就出表。
对话示例
> 用户：帮我弄个急诊创伤登记表
> 助手：好的，先选场景（回序号或场景名）：①接诊登记 ②致伤原因分布月度汇总 ③创伤部位分布月度汇总 ④处置去向月度汇总
> 用户：1
> 助手：好的，接诊登记。请逐笔给数据，一次一项，缺的跳过不编：
> 1. 登记号？（示例：T-1101-01）
> 用户：T-1101-01，2026-10-31 08:35，道路交通伤，多发伤，ISS 17，收住院，登记人 E2011
> 助手：要素齐全（接诊时间未提供→留空）。生成台账：1 行，无异常。提醒：ISS 评分已按您给的数值抄录，工具不评分、不判严重程度。
快速上手
# 场景菜单
python scripts/make_trauma_register_log.py --presets
# 脱敏示例（--date 固定台账日期，可复现）
python scripts/make_trauma_register_log.py --demo --out 台账.xlsx --date 2026-11-01
# 指定场景（回序号 1/2/3/4 或场景名均可）
python scripts/make_trauma_register_log.py --preset 致伤原因分布月度汇总 --out 10月致伤原因.xlsx
# 从填写好的骨架生成
python scripts/make_trauma_register_log.py --input 骨架.json --out 台账.xlsx
# 空模板（8 行【待填】占位）
python scripts/make_trauma_register_log.py --preset 接诊登记 --out 空模板.xlsx
输出预览
以下为 --demo --date 2026-11-01（场景① 接诊登记）输出的文本摘录（截取自实际生成的 xlsx 关键单元格）：
| 序号 | 登记号 | 接诊日期 | 接诊时间 | 致伤原因分类 | 创伤部位分类 | ISS评分(抄录) | 处置去向(抄录) | 登记人(工号) | 备注 |
|---|---|---|---|---|---|---|---|---|---|
| 1 | T-1101-01 | 2026-10-31 | 08:35 | 道路交通伤 | 多发伤 | 17 | 收住院 | E2011 | |
| 2 | T-1101-02 | 2026-10-31 | 09:20 | 跌落伤 | 四肢 | 9 | 急诊处置 | E2011 | |
| 3 | T-1101-03 | 2026-10-31 | 10:05 | 锐器伤 | 腹部 | 【待填】 | 收住院 | E2012 | ℹ️ ISS评分未抄录——由医师评定后补录（本工具不评分、不判严重程度） |
| 5 | 【待填】 | 2026-10-31 | 烧烫伤 | 体表 | 1 | 转院 | E2013 | ⚠️ 登记号缺失——创伤登记台账要素须完整可追溯，请补齐后复核…（整行标红） |
统计汇总（截取前几行）：登记场景=接诊登记｜台账日期=2026-11-01｜登记行数=6｜异常行数（红）=1｜【待填】单元格=2。
退出码表（脚本 scripts/make_trauma_register_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 后重跑 |
单行日期/数量格式错误不中断整份台账：该格转【待填】红字并在备注注明原因，汇总页计入清点；文件级错误才整体退出。
字段与判定口径
- ① 接诊登记（10 列）：序号 / 登记号 / 接诊日期 / 接诊时间 / 致伤原因分类 / 创伤部位分类 / ISS评分(抄录) / 处置去向(抄录) / 登记人(工号) / 备注
- ② 致伤原因分布月度汇总（8 列）：序号 / 月份 / 致伤原因分类 / 例数 / 占比(%) / 其中ISS≥16例数(抄录) / 登记人(工号) / 备注
- ③ 创伤部位分布月度汇总（7 列）：序号 / 月份 / 创伤部位分类 / 例数 / 占比(%) / 登记人(工号) / 备注
- ④ 处置去向月度汇总（7 列）：序号 / 月份 / 处置去向(抄录) / 例数 / 占比(%) / 登记人(工号) / 备注
异常行整行标红（写入备注 ⚠️ 提示，人工核对）：
- 接诊登记：登记号缺失（创伤登记须逐笔可追溯）｜致伤原因分类缺失｜处置去向缺失｜ISS评分(抄录)为负数
- 致伤原因分布：致伤原因分类缺失｜例数为负｜其中ISS≥16例数 > 总例数（勾稽矛盾）
- 创伤部位分布：创伤部位分类缺失｜例数为负
- 处置去向汇总：处置去向缺失｜例数为负
软提示（备注 ℹ️ 提示，不标红）：日期/月份格式无法识别、数值无法识别（该格转【待填】）；接诊登记 ISS 评分未抄录时提示「由医师评定后补录（本工具不评分、不判严重程度）」。
- 【待填】单元格红字标红，汇总页清点数量并提示「未补齐视为登记未完成」
- ISS 评分只做抄录：填什么登记什么，工具不计算 ISS、不定伤情严重程度；ISS≥16 例数由使用方按医师评定结果汇总后抄录
- 处置去向只做抄录：急诊处置/收住院/转院以急诊登记为准，工具不判流向
- 致伤原因/创伤部位分类词表不内置——按本院创伤登记本口径填写（如道路交通伤/跌落伤/锐器伤/钝器伤/烧烫伤；颅脑/胸部/腹部/四肢/脊柱骨盆/多发伤）
- 数量支持整数/小数；日期支持
2026-03-15/2026.3.15/2026/3/15/2026年3月15日/20260315，月份可直接填2026-10/2026年10月 - 工具默认场景为①接诊登记，
--input的 JSON 里也可写"preset": "场景名"自动选路；骨架顶层的date/dept回读时同样生效（命令行--date/--dept优先级更高，同时给出时覆盖骨架值）
铁律（医疗合规四关）
- 不碰创伤救治决策：只做接诊登记台账与分布汇总；ISS 评分由医师评定后抄录（工具不评分、不判伤情严重程度），处置去向由急诊登记抄录，救治方案与转归以临床团队判定为准
- 敏感个人信息硬拦截：脚本检测到姓名明文（含「患者张三」「张某某」式结构）、身份证号、手机号 → 退出码 13 直接拒绝处理（错误提示不回显敏感值）；人员标识仅可用登记号/工号，科室与业务名称可正常登记
- 数据不出机：台账本地生成，无网络请求；创伤登记信息按院内数据管理规定流转
- 不编造不代填：登记号、分类、例数等关键字段缺失一律【待填】标红，汇总页清点；占比等未提供的数据不代算，绝不编造
能力边界量化表
| 能做 | 不做（明确边界） |
|---|---|
| 四场景登记台账生成（xlsx 双表，可打印归档） | 不替代 HIS/急诊信息系统/创伤中心登记平台：无审批流、无数据联动、无上报接口 |
| 关键要素缺失整行标红（登记号/致伤原因分类/处置去向） | 不评分：ISS/AIS 等创伤评分由医师评定，工具只抄录数值 |
| 月度分布汇总（致伤原因/创伤部位/处置去向）勾稽（ISS≥16例数≤总例数） | 不判处置去向：去向以急诊登记抄录为准，工具不做分流建议 |
| 【待填】清点与补填提示（不代填） | 不碰创伤救治决策：救治方案、手术时机、转归判断均不属于本工具 |
| 敏感个人信息隐私拦截（退出码 13）；本地生成、数据不出机 | 不校验登记真伪（例数与实际接诊是否一致须人工核对） |
| 分类词表不内置，按本院口径填写 | 不识别或处理伤情照片/影像件；输入仅支持 JSON 文本 |
岗位场景例子
- 急诊护士：「每个创伤病人来了都要登记，月度要交质控」→ 选 ① → 逐笔出台账，登记号/分类/去向缺失自动标红
- 急诊质控员：「月度要报致伤原因分布」→ 选 ② → 例数/占比汇总，ISS≥16 例数抄录留痕
- 创伤中心联络员：「部位分布表要按月填」→ 选 ③ → 分类齐全一眼清，缺项【待填】红字
- 科室月底：「去向汇总要写月报」→ 选 ④ → 急诊处置/收住院/转院例数一目了然
边界提醒
- 与相邻技能划界：
triage-log=预检分诊台账（分诊级别、到院时间），ed-observation-log=留观期间床位流转与看护记录，adverse-event-report=不良事件上报——本技能只做创伤患者的接诊登记台账（致伤原因/部位分类、ISS 抄录、处置去向抄录）与月度分布汇总；分诊、留观、不良事件请用对应技能 - 本工具不碰创伤救治决策：不评 ISS、不判伤情、不做分流与转院建议；ISS 数值与处置去向均由使用方从医师评定/急诊登记中抄录
- 本工具不替代 HIS/急诊信息系统/创伤中心登记平台；纸质/电子登记册按院内要求归档
- 登记号列只填登记号，不得填写姓名明文——脚本对姓名明文/身份证/手机号是硬拦截（退出码 13）
文件索引
| 文件 | 用途 |
|---|---|
| scripts/make_trauma_register_log.py | 核心：CLI 成稿 + 四场景判定 + 异常标红 + 隐私拦截 + 错误码兜底 |
| references/trauma-register-guide.md | 登记实践参考：致伤原因/部位分类口径、ISS 抄录、处置去向留痕、月度分布汇总 |
| assets/faq.md | 常见问题 12 条（隐私拦截/ISS 抄录口径/异常标红含义/待填卡点/系统边界等） |
| assets/anti-patterns.md | 反模式集中清单（错误操作+后果+替代） |
| assets/input-example.json | 输入示例（脱敏，可直接 --input 试跑） |
| beta-test/run_tests.py | 内测回归脚本（四场景/隐私拦截/退出码/异常标红/待填不编造/骨架闭环等） |
| avatars/avatar-512.png | 技能头像 |
FAQ 快捷导航：帮我评 ISS 吗→Q1｜没数据能生成吗→Q2｜为什么被拒绝（13）→Q3｜日期格式→Q4｜例数填错→Q5｜标红是不是判定我出错→Q6｜和分诊/留观台账关系→Q7｜数据外传→Q8｜【待填】算完成吗→Q9｜场景怎么选→Q10｜分类词表→Q11｜去向能帮我定吗→Q12。
