夜雨聆风在医院医保办日常工作中，「病案首页」与「医保结算清单」之间的字段口径不一致，常常导致费用差异难以归因、申诉材料反复修改、对账周期拉长。一线人员既要核对成百上千条数据，又要理解医保政策与临床收费逻辑的细微差别，工作强度大、容错率低、沟通成本高。为缓解这一痛点，开源项目 med-insurance-reconcile 应运而生，它不是另一个通用数据比对工具，而是专为医院医保结算场景打磨的字段级口径差异自动对账台账系统。
项目概述：从“人工翻表”到“一键生成台账”
med-insurance-reconcile 是一个轻量、可部署、开箱即用的命令行工具，核心目标明确：将原本依赖 Excel 手动比对、经验判断、逐条撰写申辩理由的繁琐流程，转变为结构化、规则驱动、可追溯的自动化工作流。
该项目不替代医院 HIS 或医保平台，而是作为中间层增强工具，聚焦于两个关键输入源，病案首页（通常由病案科导出）和医保结算清单（由医保系统生成），完成三件事：- 自动识别哪些字段存在数值差异、类型差异或缺失- 判断差异是否属于已知的医保计费口径问题（如手术费是否含麻醉费）- 基于规则生成可直接用于医保申诉系统的材料草稿，并输出便于汇报存档的 HTML 报告
整个过程无需数据库、不依赖 Web 服务，单机即可运行，安装后通过 medinsrec 命令即可调用全部功能。
技术亮点：务实、可控、可扩展
项目技术选型兼顾开发效率与生产可用性，所有组件均为 Python 生态中稳定、文档完善、医院 IT 环境友好型库：
- pandas
：承担核心数据清洗与字段对齐任务，支持千分位数字自动解析、空值智能填充、多格式（CSV/XLSX）统一读取 - openpyxl
：精准处理 Excel 中的合并单元格、样式保留等实际业务常见需求 - click
：构建清晰分层的 CLI 接口， reconcile、batch、rules三大子命令职责分明，参数设计贴合真实使用路径 - Jinja2
：HTML 报告模板完全解耦，支持医院自定义样式、添加单位 logo、调整字段展示顺序 - 模块化架构
：代码按功能严格分层， reconcile_engine.py封装差异计算逻辑，appeal_generator.py负责申辩话术生成，rules_loader.py管理口径规则库，便于后续扩展新规则或对接院内知识库
值得一提的是，项目预留了 LLM 增强接口。当遇到规则库未覆盖的新型差异时，可通过环境变量配置 Anthropic API Key 启用解释能力，自动给出差异成因推测与参考话术。该功能为可选模块，未启用时系统完全离线运行，保障数据安全与合规底线。
应用场景：面向医保办与信息科的真实需求
本工具并非理论原型，其设计直指医院医保管理中的高频、刚需场景：
- 月度医保结算复核
可用于每月初快速筛查上月出院病例中病案首页与医保清单的费用偏差，定位集中性口径问题 - 医保飞行检查迎检准备
批量生成差异台账与申辩材料草稿，缩短材料整理周期，提升迎检响应效率 - 新医保政策落地验证
在政策切换初期，对比新旧版本清单数据，快速识别因计费规则调整引发的字段映射偏移 - 院内跨部门协同提效
为病案科、医保办、信息科提供统一的事实依据与结构化输出，减少“各说各话”的沟通摩擦 - 医保结算质量持续改进
长期积累差异台账，可反向分析高频差异字段，推动 HIS 收费模块或病案编码流程优化
工具支持自定义字段映射，适配不同医院 HIS 系统导出的列名差异；批量处理模式支持按文件名自动配对，兼容主流命名习惯（如 病案首页_202403.xlsx 与 医保清单_202403.xlsx）。
使用指南：三步上手，零学习门槛
安装与使用极为简洁，全程基于终端操作，无图形界面依赖：
第一步：安装工具
推荐使用可编辑安装方式，确保 medinsrec 命令全局可用：
git clone https://github.com/nexorin9/med-insurance-reconcilecd med-insurance-reconcilepip install -e .medinsrec --version第二步：单次对账（快速验证）
使用项目自带示例数据测试基础流程：
medinsrec reconcile \ --front-page data/front_page_sample.csv \ --insurance-list data/insurance_list_sample.csv \ --output output/report.html执行完成后，打开 output/report.html 即可查看包含差异详情、规则匹配结果、申诉建议的完整报告。
第三步：批量处理（投入日常使用）
将待对账的病案首页与医保清单按规范放入同一目录（如 data/batch/），运行：
medinsrec batch \ --input data/batch/ \ --output output/batch_reports/ \ --pattern "病案首页_*.xlsx" "医保清单_*.xlsx"工具将自动配对文件、逐对执行差异分析，并为每组生成独立 HTML 报告。
如需查看内置规则，可随时运行：
medinsrec rules或按字段筛选：
medinsrec rules --field "手术费"总结：让医保对账回归业务本质
med-insurance-reconcile 的价值不在于炫技，而在于把医保结算中那些“本不该由人干的活”交还给程序，重复的字段比对、机械的规则查证、模板化的申辩撰写。它不试图重构医院信息系统，而是以最小侵入方式，成为医保办工作人员桌面上那个“永远在线、从不抱怨、越用越懂你”的数字协作者。
项目采用 MIT 许可，源码开放，规则库可读可改，报告模板可定制。无论是信息科工程师做二次开发，还是医保办同事直接拿来用，都能在一天内完成从下载到产出首份有效报告的全过程。
项目当前免费开源，若您对项目有疑问、使用上的困惑或想深入交流，欢迎私信我们，或加入社群讨论。
项目地址：
https://github.com/nexorin9/med-insurance-reconcile
