OpenMed v2.0.0 发布技术解读本地优先医疗 AI 的多语言隐私、Agent Skills 与发布安全体系【免费下载链接】openmedLocal-first healthcare AI: clinical NER HIPAA PII de-identification that runs 100% on-device. 2,200 medical models, 21 languages, Apple MLX Python, no cloud, no patient data leaving your network. Apache-2.0项目地址: https://gitcode.com/GitHub_Trending/ope/openmedOpenMed2.0.0是本地优先local-first医疗隐私与临床 AI 平台的 v2 基线版本将 Python、Swift、Kotlin/Android、JavaScript、MCP 与容器部署统一进同一套契约。本文以 v2.0.0 发布说明 为主线结合仓库中的迁移指南、安装脚本与源码实现解读本次发布的 34 种语言 PII 路由、72 个 Agent Skills、可增量的DEVICE标签、跨平台安装方式以及 fail-closed 的发布资质体系帮助读者完成从 v1.9.1 到 v2.0.0 的平滑升级并正确使用 v2 新能力。版本概览与发布范围OpenMed2.0.0于 2026-07-28 发布审查范围为v1.9.1..v2.0.0。发布说明中明确指出确切的候选提交candidate head会在打标签前立即重新审计完整的、由 Git 祖先关系推导出的 Pull Request 与提交台账记录在仓库根目录的 CHANGELOG.md 中。从 CHANGELOG 可以确认v2.0.0 审计区间1ab2eca4cc89..6525adb5722c共包含 539 个提交和 197 个合并的 Pull Request逐条列出了每个 PR 及其包含的审计提交。本次发布的核心目标是把 v2 版本线建立在四个明确契约之上多语言隐私契约内置 34 个 PII 语言码配合确定性标识符包、locale 感知验证器、原生文字替代surrogate、CJK/Indic 偏移保持以及代码混合code-mixed路由区域政策与证据契约中国 PIPL、印度 DPDP/ABDM、非洲隐私档案、GDPR 与欧盟 AI Act 模板、同意执行、数据驻留证明与 ISO 控制证据结构化与临床数据契约放射学解析器、序列趋势、纵向文档关联、共指消解、时间归一化、多语言关系抽取、flowsheet、检验面板、出院小结等Agent 工具与发布证据契约72 个可移植 Agent Skills、类型化 MCP 工具注册表以及签名发布就绪判定。值得强调的是v2 并非推倒重来CHANGELOG 的 Compatibility 段落明确记录所有v1.9.1的公开 Python 符号均被保留根导入OpenMedConfig、analyze_text、deidentify、extract_pii保持可用REST/OpenAPI 路径与 schema 集合不变。Highlightsv2 的七大技术支柱1. 多语言隐私内置 PII 路由扩展到 34 个语言码并新增了确定性标识符、日期、电话、地址与替代支持覆盖中文、印度语系、非洲语言、北欧语系、中欧/东欧语言、俄语、乌尔都语、越南语及区域性阿拉伯语工作流。其中值得关注的技术细节包括偏移保持的归一化与分词支持全角/半角文本、本地数字、简繁体中文、中文数字与词边界、Indic 字素与旧编码、跨文字转写、代码混合的 Hinglish 以及混淆文本脚本正确的替代surrogate中文地址与拼音姓名处理、印度标识符与转写姓名一致性、非洲 locale 提供者、带校验和的国别标识符替换带校验器的语言包例如新增的俄语ru包包含西里尔日期、电话、邮政编码与街道地址模式以及带校验和替代的 SNILS 与 OMS 验证器见 CHANGELOG.md匈牙利 TAJ、捷克 rodné číslo、塞尔维亚 JMBG、克罗地亚 OIB、保加利亚 EGN、芬兰 HETU、爱沙尼亚 isikukood 等均为带验证器的国家标识符包中文归一化通过 OpenCC 实现可选的简繁体转换含台湾、香港配置并保持偏移的跨度投影回原文中文数字解析支持日常与财务形式。2. 区域政策与证据新增中国 PIPL、印度 DPDP 与 ABDM、南非 POPIA、尼日利亚 NDPA、肯尼亚 DPA、埃及 PDPL、摩洛哥 09-08 号法、泛非 Malabo、GDPR、欧盟 AI Act、ISO 27701/27001、同意标签与数据驻留证据工作流。这些政策以策略即数据policy-as-data的形式存在于 openmed/core/policies 目录下例如china_pipl.json、india_dpdp_act.json、ke_dpa.json、ng_ndpa.json、ma_law_09_08.json等可直接通过policy参数引用。3. 临床与结构化数据新增放射学报告解析器分离 findings/impression/recommendation 并带出处跨度仅捕获明确陈述的 BI-RADS 或 Lung-RADS 类别、序列测量趋势对重复实体分组、归一化兼容单位、沿临床时间线排序并保留源跨度、纵向文档关联基于 MinHash 的近重复聚类、定向修正边、临床共指消解、时间归一化、缩略词消歧、多语言关系抽取44 谓词 CMeIE 映射、flowsheets、检验面板、出院小结、手术与儿科覆盖。同时新增离线结构化数据发布风险工作流advisory 准标识符发现、显式审阅者覆盖、患者级 k-匿名、distinct/entropy l-多样性、variational t-接近、有界层次与抑制搜索、整隐私单元抑制、物化输出再验证与可回滚发布以及基于行级或键控纵向档案的精确参考总体评估k-map、精确链接风险、delta-presence。4. 互操作性新增 OpenMRS、DHIS2、OpenHIM、社区健康表单、WHO SMART 档案、PySparkpandas_udf适配器、Prefect、scrubadub、LlamaIndex、scispaCy、QuickUMLS 与离线 ICD-11 接地点的本地适配器与打包。例如 PySpark 适配器位于 openmed/interop通过make_deidentify_udf()与deidentify_columns()在仓库规模上清洗自由文本列scrubadub 适配器提供to_canonical()/from_canonical()跨度转换。5. Agent Skills详见下一节72 个可移植 Agent Skills覆盖 14 个类别配套一条安全的单命令安装器。6. 端上设备与 MCP 工具watchOS 与 visionOS 的 OpenMedKit 目标、grapheme 安全的 Swift 跨度、AndroidEntityPrediction元数据与OpenMedSpan、类型化 MCP 工具注册表、openmed-mcp入口点、MCP 容器与 Compose 服务以及 WebGPU 与 GGUF 导出指南。CLI 现在统一提供--json成功与错误信封见 docs/cli/result-envelope.md。7. 发布安全与第三方归属多语言 golden fixtures、吞吐量与延迟预算、解析器 fuzzing、对抗性 PHI 测试、签名证据、API 兼容性输出以及 fail-closed 的发布就绪判定。Indic 分词器资源固定 ICU 57.1 源修订版使用合法 SPDXICU标识符并在 Python 发行版与每个独立转换模型包中携带完整 ICU 通知。Agent Skills从一句提示到一条本地管线v2 的一大亮点是随仓库发布的可移植 Agent Skills 目录——共 72 个技能、14 个类别覆盖去标识化、临床实体抽取、FHIR/OMOP 交接、评估、合规、文档摄取、分析与部署可教会 Claude Code、OpenAI Codex、OpenCode 及兼容 Agent 组装本地工作流。技能本体存放在仓库 skills 目录下例如 deidentifying-clinical-text、extracting-clinical-entities每个目录包含遵循开放 Agent Skills 标准的SKILL.md。安装方式发布说明给出了两种安装方式。完整安装覆盖所有受支持的 Agentgit clone https://github.com/maziyarpanahi/openmed cd openmed ./install-skills.sh或只针对单一客户端./install-skills.sh claude # ~/.claude/skills/ ./install-skills.sh codex # ~/.codex/skills/ ./install-skills.sh opencode # ~/.config/opencode/skills/ ./install-skills.sh agents # ~/.agents/skills/从仓库根目录的 install-skills.sh 源码可以确认几个关键实现细节符号链接而非复制技能通过ln -s符号链接到目标目录因此后续git pull会自动更新所有已安装技能保留用户既有条目脚本对已存在的不相关符号链接、文件或目录一律跳过并计数报告n skills - dest与skipped existing entries preserved这正是安全保留已有用户条目承诺的实现只安装真实技能仅处理包含SKILL.md的目录自动跳过helpers与_template等辅助目录Windows 提示脚本末尾提示 Windows 下符号链接需要开发者模式或管理员权限否则可用cp -r skills/*/ ~/.claude/skills/复制安装。用提示驱动 Agent 组装管线安装完成后可以向 Agent 提出一个基于合成输入的本地工作流需求Build a local OpenMed pipeline that de-identifies a synthetic discharge note and extracts medication entities. Keep the example synthetic.Agent 可以组合deidentifying-clinical-text与extracting-clinical-entities两个技能产出可运行的 OpenMed 代码import openmed note ( Synthetic patient Jane Example (MRN 12345), seen 2024-03-02, started on metformin 500mg BID. ) deid openmed.deidentify( note, methodmask, policyhipaa_safe_harbor, ) meds openmed.analyze_text( deid.deidentified_text, model_namepharma_detection_superclinical, )这段代码展示了 v2 根 API 的两个核心入口deidentify检测 PHI/PII 并按method重写文本与analyze_text在去标识化后的文本上继续做临床 NER。methodmask对应掩码模式v2 还支持remove、replace、hash、shift_dates等模式详见 deidentifying-clinical-text。policyhipaa_safe_harbor引用仓库内置的 HIPAA Safe Harbor 策略档案openmed/core/policies/hipaa_safe_harbor.json。pharma_detection_superclinical则对应 v2 修正了药物边界与可选精度过滤的 PharmaDetect 能力。需要强调的安全约束一次性模型下载后推理完全在本地进行不要把真实 PHI 放入云端托管的 Agent 提示、日志或复制的示例中。兼容性从 v1.9.1 到 v2.0.0 的静态对比API 表面变化发布说明给出了静态对比结论与v1.9.1相比Python 公开符号从 14,488 增长到 20,538 个其中新增 6,050 个符号零删除、零签名收窄、零新增弃用。REST 表面保持相同的路径与组件 schema 集合。这一对比是静态的如 迁移指南 所述它解析导出的openmed/表面而不导入包、不执行应用代码。读者可以在本地复现同样的对比python scripts/release/api_surface_diff.py \ v1.9.1 HEAD \ --json api-surface-diff.json \ --check docs/migration/1.9-to-2.0.md新增的DEVICE规范标签新的DEVICE规范标签是可增量的它服务于手术与诊断操作、器械与手术入路的零样本领域。但对于把标签建模为封闭枚举的应用必须显式添加该值# v1: 应用自有的穷举集合 ALLOWED_LABELS {PROCEDURE, BODY_SITE} # v2: 加入可增量规范标签 ALLOWED_LABELS {PROCEDURE, BODY_SITE, DEVICE}从 openmed/core/labels.py 的源码可以看到DEVICE: Final DEVICE的规范定义以及它的别名映射device、medicaldevice、implant、catheter等都归一化到DEVICE同时它被归类为CLINICAL_CONCEPT并映射到 SNOMED 体系。随 v2 发布的策略档案已经包含完整的 v2 标签集但应用自有的、逐一枚举标签的策略档案需要重新校验。保留的 v1 根导入文档化的 v1 根导入保持可用from openmed import OpenMedConfig, analyze_text, deidentify, extract_pii这与 openmed/init.py 中_LAZY_IMPORTS懒加载注册表一致——v2 继续通过根模块导出这四个核心入口。对于仍需要旧式字典形态载荷的调用方AnalyzeResult的映射访问与to_dict()仍是兼容桥result analyze_text(Synthetic clinical note) entities result[entities] payload result.to_dict()由于静态对比既未发现移除也未发现弃用不需要提供任何替换前/后代码片段。语言包与模型路由v2 中语言包目录成为模型支持语言、确定性标识符能力、locales 与可选 Indic 路由的共享单一事实来源。一个重要的行为变化是仅模式pattern-only的语言包不再默默声明默认神经模型。将其与模型支撑的推理组合时必须显式传入模型from openmed import extract_pii result extract_pii( Synthetic Afrikaans note, langaf, model_nameOpenMed/privacy-filter-multilingual, )对于不带模型的确定性标识符检查应使用该包文档化的语言特定模式与安全扫描safety-sweepAPI。注意接受显式模型标识符不等于对所有语言都有精度承诺——部署前务必用本地 fixtures 校验所选模型。可选依赖与迁移清单v2 通过新增聚焦 extras 来避免强制网络或大型模型运行时依赖pip install openmed[zh]2.0.0 # 中文分词/归一化 pip install openmed[indic]2.0.0 # Indic 文本工具 pip install openmed[lid]2.0.0 # 可选 token 语言识别 pip install openmed[integrity]2.0.0 # 签名工件校验 pip install openmed[openmrs]2.0.0 # OpenMRS 交接 pip install openmed[scrubadub]2.0.0 # scrubadub 适配器 pip install openmed[prefect]2.0.0 # Prefect 批处理流升级清单来自 迁移指南先将应用升级到openmed1.9.1并清除既有告警以应用实际使用的可选 extras 安装openmed2.0.0在所有穷举式规范标签枚举或策略开关中加入DEVICE用合成 fixtures 在每种部署的语言与文字上重跑隐私、泄漏、跨度偏移与直接标识符召回测试重跑自定义 MCP 客户端、CLI JSON、Swift、Android 或证据 schema 解码测试模型文件与受限临床术语保持包外管理——v2 不捆绑 gated 数据集或授权词表。另外注意依赖约束可选 MCP 集成现在要求mcp1.27,2可选 AWQ extra 仅支持 Linux且其依赖组合与不兼容的 GLiNER 环境刻意隔离ONNX 与多模态 extras 要求固定的 ONNX 1.21 行与 spaCy 3.8.9且与 scispaCy extra 刻意隔离scispaCy 的 NumPy ABI 约束与安全 ONNX 路线不兼容两者需要时应在独立环境中安装运行。安装与升级五个平台的官方路径Pythonpip install --upgrade openmed2.0.0只安装应用需要的 extras例如pip install --upgrade openmed[hf,zh,indic]2.0.0 pip install --upgrade openmed[service,mcp]2.0.0Browser 与 Node.jsnpm install openmed2.0.0npm 包保持无 scope同时提供 ESM 与 CommonJS 导出对应仓库 js/openmedkit-web 的 TypeScript 实现。Swiftdependencies: [ .package(url: https://github.com/maziyarpanahi/openmed.git, from: 2.0.0), ]OpenMedKit 通过仓库根包支持 iOS、iPadOS、macOS、watchOS 与 visionOS。v2 为 Swift 新增 watchOS/visionOS 目标、grapheme 安全的标量跨度对齐与紧凑端上分词且不移除既有 OpenMedKit API。Android添加 JitPack 并使用不可变标签dependencies { implementation(com.github.maziyarpanahi:openmed:v2.0.0) }Android 端新增OpenMedSpan与描述性EntityPrediction元数据工件坐标保持不变。容器与 Helm使用ghcr.io/maziyarpanahi/openmed:v2.0.0。Helm chart 默认值为2.0.0显式选择发布镜像时设置image.tagv2.0.0chart 位于 deploy/helm/openmed-service。CLI 与 MCP 的 v2 行为变化CLI 命令现在暴露一致的--json成功与错误信封。人类可读输出仍是默认自动化应显式选择 JSON 并检查结构化错误码而非抓取散文文本openmed models list --json openmed gates preview \ --candidate artifacts/release-candidate.json \ --baseline-store gates/baseline.json \ --strict \ --json新的openmed-mcp入口点从与文档、schema 漂移测试共用的同一类型化注册表渲染工具。MCP 客户端应刷新缓存的工具 schema以便识别注解与结构化输出。相应的 CLI 结果信封契约见 docs/cli/result-envelope.md。隐私与临床边界v2 的默认值本地处理是默认模型下载是显式行为所需工件就位后运行时的 PHI 处理不依赖任何云服务遥测默认关闭v2 新增了遥测默认关闭的强制执行防护对应 CHANGELOG 的 OM-099 安全测试证据无原始标识符发布证据使用哈希、计数、偏移与出处而非原始标识符残余风险声明任何去标识化系统都无法保证零残余风险——部署前必须在本地校验直接标识符召回、泄漏、跨度完整性、语言覆盖、策略行为与量化模型差异临床边界临床抽取是辅助软件不是医疗设备也不是临床金标准的来源。输出必须经合格人员审阅不得自动触发诊断、治疗、计费或其他临床决策。发布资质v2.0.0 标签前的 fail-closed 检查在创建v2.0.0标签前确切的候选提交必须通过以下全套检查来自 发布说明 的 Release qualification 章节仓库与依赖许可证策略锁定的依赖、lint、格式化与完整 Python 测试严格的文档与生成的 OpenAPI 检查Python wheel/sdist 构建、元数据、内容、Twine、SBOM 与出处测试npm 安装、审计、构建、类型检查、测试与 tarball 检查Swift resolve/build/测试以及托管的 Apple 平台编译Android AAR 构建/测试与不可变 JitPack 坐标检查Helm 默认值与合成值 lint/render 检查适用的多架构容器、签名与 SBOM 工作流真实的签名抽取/模型门报告、API 兼容性报告、具名 golden 套件结果以及最终的READY就绪判定。关键约束是跳过或缺失候选报告即视为证据不完整。注册表可用性、在线文档与消费者安装仅在发布后验证不属于候选准备阶段的声明。这一 fail-closed 设计对应 CHANGELOG 中新增的签名发布就绪门见 openmed/core 下 release-readiness 相关实现与 docs/release 系列文档。同时注意不要把构建哈希当作模型质量的证明——模型特定的召回、关键泄漏、量化差异、设备行为与跨度完整性证据必须独立校验详见 迁移指南 的 Release evidence 章节。结语OpenMed v2.0.0 不是一次破坏性重写而是一次面向本地优先、多语言、可审计的体系化升级零删除的 6,050 个新符号、可增量的DEVICE标签、34 个语言码的隐私路由、72 个 Agent Skills 与 fail-closed 的签名发布门共同把 v2 定义为一个可平滑迁移、可离线验证、可在端上运行的医疗隐私与临床 AI 平台基线。升级到openmed2.0.0后建议按本文的迁移清单逐项重跑隐私与临床校验并将 Agent Skills 安装到实际使用的编码助手用合成输入验证端到端管线。【免费下载链接】openmedLocal-first healthcare AI: clinical NER HIPAA PII de-identification that runs 100% on-device. 2,200 medical models, 21 languages, Apple MLX Python, no cloud, no patient data leaving your network. Apache-2.0项目地址: https://gitcode.com/GitHub_Trending/ope/openmed创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
