夜雨聆风在医院信息科、医务处或一线科室的日常工作中，病历质量始终是医疗安全与合规管理的关键环节。一份疏漏的诊断依据、一次未及时记录的异常检验结果、一张缺失的知情同意书，都可能成为后续质控检查或纠纷溯源中的风险点。与其被动迎检，不如主动预判，病历自我防御预检器（EMR Pre-Defense Inspector） 正是为此而生。它不替代医生判断，也不生成完整病历，而是以「上级医生」视角，为每份待提交病历提供一份可操作、可追溯、多维度的自查清单。
项目概述
病历自我防御预检器是一款基于大语言模型的病历质量辅助工具。它的核心逻辑很朴素：把医生即将提交的病历文本输入系统，模型即刻进入角色，逐项审视其中潜在问题，并输出「哪些地方可能被质疑」的结构化反馈。这种设计跳出了传统规则引擎的刚性限制，也避开了纯人工质控的高成本与低覆盖，真正服务于临床工作流的最后一公里。
项目支持两种运行模式：当大语言模型可用时，启用深度语义分析；当网络中断、API 限流或需快速初筛时，自动降级至本地规则引擎，确保服务不中断。这种「LLM 主力 + 规则兜底」的双模架构，让工具既具备专业判断力，又保有工程可靠性。
技术亮点
多维度质疑生成能力系统覆盖诊断依据充分性、用药与诊断匹配、病历时限合规、病程记录及时性、关键节点完整、异常结果处理、知情同意完备、检查检验关联等八大临床质控维度，每一项均对应真实诊疗规范要求。
结构化、多格式输出支持同一份分析结果，可一键导出为 JSON 供系统集成、Markdown 便于文档沉淀、Terminal 彩色输出适配命令行场景、HTML 可视化报告支持浏览器交互查看，满足不同使用习惯与协作需求。
智能缓存与批量处理机制基于病历文本哈希值的本地缓存，默认 24 小时有效，避免重复调用 API；批量处理功能支持通配符匹配、并发控制、风险阈值筛选与汇总统计，适合科室级病历集中复核。
真正的交互式体验
--interactive模式下，医生可逐段粘贴病历内容，系统实时流式返回质疑点，无需等待全文上传完成，更贴近实际书写与修改节奏。灵活的部署与扩展能力支持 OpenAI GPT-4o 与 Anthropic Claude 3.5 Sonnet 双后端；可通过环境变量切换本地 Ollama 模型；允许自定义提示词模板、配置多 API Key 负载均衡、启用 Web API 服务，兼顾团队协作与私有化部署。
应用场景
该工具可用于多种临床与管理场景，尤其适合以下几类用户：
一线医生在病历归档前快速自查，提前发现诊断依据薄弱、用药逻辑矛盾、知情同意遗漏等高频问题，减少返工与质控扣分。
科室质控员批量扫描本科室近期出院病历，生成风险分布热力图与维度汇总报告，定位共性缺陷，支撑针对性培训与流程优化。
医务管理部门将其嵌入院内质控平台或作为独立工具下发，统一质控标准，降低对专家人工抽审的依赖，提升质控覆盖率与时效性。
医学教育与住培带教结合样例病历（如心内科冠心病待查、普外科腹腔镜胆囊切除等），直观展示不同专科常见病历缺陷类型，辅助教学与案例讨论。
区域医疗信息平台建设者利用其 FastAPI 提供的标准化接口，可快速接入区域电子病历质控中台，实现跨机构病历质量基线比对与预警。
使用指南
安装与启动极为简洁：
pip install -r requirements.txtcp .env.example .env# 编辑 .env 文件，填入 OpenAI 或 Anthropic 的 API Key单份病历检查示例如下：
emr-pre-defense inspect data/sample_internal_medicine.txt如需指定输出格式或聚焦特定维度：
emr-pre-defense inspect data/sample_internal_medicine.txt --output htmlemr-pre-defense inspect data/sample_internal_medicine.txt --dimensions 诊断依据充分性,用药与诊断匹配启动 Web 服务后，即可通过 HTTP 接口调用：
uvicorn src.web.app:app --reload --port 8000curl -X POST http://localhost:8000/inspect \ -H "Content-Type: application/json" \ -d '{"text": "患者男性，65岁，因\"胸闷、胸痛2小时\"入院..."}'对于批量任务，推荐使用并行参数控制资源消耗：
emr-pre-defense batch data/ --pattern "*.txt" --parallel 4 --min-risk high高级用户还可通过环境变量自定义提示词、切换本地模型、启用多 Key 轮询，或强制使用规则引擎进行离线扫描：
emr-pre-defense inspect input.txt --engine rule所有功能均有清晰帮助说明，执行 emr-pre-defense --help 即可查看完整 CLI 参数列表。
总结
病历自我防御预检器不是另一个试图“写病历”的 AI 工具，而是一个专注“挑毛病”的临床协作者。它把《病历书写基本规范》和一线质控经验，转化成可执行、可验证、可集成的技术能力。无论是深夜写完最后一份出院记录的住院医，还是需要出具季度质控简报的医务科同事，都能在几分钟内获得一份有依据、有位置、有建议的风险清单。
它不承诺取代人的判断，但努力让每一次判断更从容；不追求覆盖全部边界，但力求抓住最常被质疑的那几个关键点。开源的意义，正在于让更多人看见、试用、反馈、共建，让病历质量这件事，从“事后追责”走向“事前设防”。
项目当前免费开源，若您对项目有疑问、使用上的困惑或想深入交流，欢迎私信我们，或加入社群讨论。
项目地址：
https://github.com/nexorin9/emr-pre-defense-inspector
