Medical Record Organizer

medical-record-organizer

Turns scattered images and PDFs into standard medical records, with doctor and family PDFs (transcribes, never diagnoses).

SkillPython★ 2Updated

GitHub repository

Install as a Claude Code skill

git clone https://github.com/weitzu-com/medical-record-organizer.git ~/.claude/skills/medical-record-organizer

The README below is shown in its original language.

把图片 / 照片 / PDF / 截图等零散的医疗资料,整理成符合中国医生习惯的标准病历,并同时产出两份 PDF:

  • 医生版 —— 术语精确、参考值齐全、嵌入心电图/造影等原图、信息密度高,方便医生快速查看;
  • 家属版 —— 大白话解释每项「是测什么的」、异常处标红、自动降噪,方便病人和家属看懂。

结果会沉淀进病人纵向健康档案,关键慢病指标(HbA1c、NT-proBNP、肌酐等)可跨次做趋势对比。

这是一个 Claude Code Skill。在对话里把资料发给 Claude,说「整理成病历」即可触发。


⚠️ 安全与免责(务必先读)

  • 本 skill 只做忠实誊录 + 结构化排版 + 异常值标注,绝不下诊断、不对个案做风险判断。
  • 所有产出仅供整理与查阅参考,不构成诊断或医疗建议;一切以医院原始报告和主治医生意见为准。
  • 报告自带的「危急值」标记会被如实转述并提示尽快就医,但 skill 不自行判定何为危急。
  • 详见 LICENSE 中的医疗免责声明。

🔒 隐私(最高优先级)

  • 病历数据全部本地处理,本 skill 自身不含、也绝不上传任何病人数据。
  • 病历数据绝不要 commit/push 到任何仓库。仓库自带 .gitignore 已忽略 资料原件/ 结构化数据/ 输出/ 趋势/ 病人档案.md 及常见影像/PDF;请把你的健康档案目录与本 skill 目录隔离存放。

安装

需要 Claude Code。把本仓库克隆到你的 skills 目录:

git clone <repo-url> ~/.claude/skills/病历整理

随后在 Claude Code 里输入 /病历整理,或直接发资料说「帮我整理成病历」即可。

依赖

依赖 用途 缺失后果
Chrome / Chromium / Edge HTML→PDF 渲染(必需) 无法生成 PDF;可用 CHROME_BIN 指定路径
poppler (pdfinfo/pdftocairo) 页数核验、渲图复核(强烈建议) 跳过自动核验
sips(macOS 自带) 图片压缩/旋转 非 mac 自动跳过压缩、直接内联原图

当前渲染管线在 macOS 上验证最充分;脚本已对浏览器路径、缺失依赖做跨平台兼容处理,但 Linux/Windows 下未充分实测。

工作流(价值链)

采集原件(只读) → 多模态抽取(忠实誊录) → 结构化中间层(真相源)
   → 医生版 + 家属版 双编排 → 渲染 PDF → 渲图核验 → 归集进纵向档案 + 更新趋势

目录结构

病历整理/
├── SKILL.md                         # 主协议(流程 / 安全边界 / 档案结构 / 隐私)
├── assets/
│   ├── style.css                    # A4 打印样式(中文字体 / 异常值双重编码 / 图片防分页)
│   ├── render.sh                    # HTML→PDF(跨平台探测浏览器,绕中文路径坑,pdfinfo 核验)
│   └── embed_images.py              # 本地图片 base64 内嵌(魔数判 MIME / 单双引号兼容 / sips 压缩)
├── references/
│   ├── 中国病历结构与慢病趋势.md     # 病历体例 / 章节规范 / 慢病趋势指标
│   ├── 家属版术语词典.md            # 检验项通俗解释(只解释"测什么",不评个案)
│   └── 渲染踩坑清单.md              # 7 条实测踩坑
├── .gitignore                       # 隐私护栏
└── LICENSE                          # MIT + 医疗免责

缘起

由一次真实的家庭病历整理实战提炼,并经多视角(安全 / 规范 / 工程 / 体验 / 隐私 / 数据)PDCA 审查迭代而成。

License

MIT(含医疗免责声明)。

Synced automatically from the README of github.com/weitzu-com/medical-record-organizer.