UDI 器械唯一标识校验器（MedXpert）

技能文档

---
name: udi-check
slug: udi-check
display_name: "UDI 器械唯一标识校验器（MedXpert）"
displayName: "UDI 器械唯一标识校验器（MedXpert）"
summary: "UDI/GTIN 校验：识别发码机构(GS1/HIBCC/ICCBBA)、GS1 GTIN-14 校验位算法核验、AIDC 形态检查。纯算法零网络，离线可用。"
description: "当用户需要校验一条 UDI/GTIN 是否合法（校验位算法核验）、判断它属于哪个发码机构体系(GS1 GTIN/HIBCC/ICCBBA)、或计算 GTIN 校验位时使用。纯算法、零网络、数据不出本机。"
description_en: "UDI/GTIN validation: issuing agency detection (GS1/HIBCC/ICCBBA), GS1 GTIN check-digit algorithm check. Pure local algorithm."
version: 1.0.0
category: 医疗器械合规
platforms: [windows, macos, linux]
author: 注册老炮@MedXpert
license: MIT
homepage: https://medxpert.cn
tags: ["UDI", "GTIN", "医疗器械唯一标识", "GS1", "HIBCC", "ICCBBA", "校验位", "AIDC", "UDI-DI", "UDI-PI", "barcode", "check digit", "唯一标识"]
---

# UDI 器械唯一标识校验器（MedXpert）

> 🌐 作者 Author: 注册老炮@MedXpert（品牌 MedXpert） ｜ 类型: 本地 MCP 工具（纯 stdlib 单文件，零依赖零 Key）
> UDI/GTIN 校验：识别发码机构(GS1/HIBCC/ICCBBA)、GS1 GTIN-14 校验位算法核验、AIDC 形态检查。纯算法零网络，离线可用。

## 何时用（AI 触发条件） / When to use
- 用户给一段 UDI/GTIN 问是否合法
- 要算 GTIN-14 校验位
- 要区分 GS1/HIBCC/ICCBBA

## 背后能力（MCP 工具） / Tools
| 工具 | 作用 |
|---|---|
| `validate_udi` | 校验 UDI 串合法性+识别发码机构 |
| `gtin_checkdigit` | 按 GS1 模10权重3/1 计算/核验校验位 |
| `detect_agency` | 判断 UDI 属于哪个发码机构体系 |

## 标准工作流 / SOP
1. validate_udi 直接验整串
2. 不合法再看哪段错→gtin_checkdigit 单算校验位
3. 需要贴标体系时 detect_agency

## 铁律 / Hard rules
- **校验位算法严格按 GS1 通用规范**
- **不校验赋码机构后台真实性**

## 禁止行为 / Don't
- 不把算法校验当官方注册证明

## 输入与输出 / IO
- 输入：以自然语言描述场景/数据即可，工具自行路由到对应函数；结构化参数按各工具 schema。
- 输出：结构化结果（等级/清单/区间/JSON），引用口径标注「参考框架/估算，非官方结论」。

## 接入与启用 / Setup
- 本地 mcp.json 加一条 stdio server，指向 `udi-check/` 下的 server 脚本（随本技能包自带）。
- 纯标准库，无需 pip install；装完 WorkBuddy 重启即加载。

## 触发示例（用户会怎么说） / User trigger examples
- "(01)00812345000011 这个 UDI 对吗？"
- "帮我算 0081234500001 的 GTIN 校验位"
- "这是 GS1 还是 HIBCC 的码？"

## 与生态联动 / Ecosystem
- 属「理论驱动工具集」矩阵一员（白皮书见 `MedXpert理论驱动工具集_白皮书.md`）；医疗合规链与 reg-*/samd-*/risk/pms 等互相引用。
- 上架渠道：WorkBuddy 开放平台连接器 + SkillHub + GitHub 三远端。

## 版本 / Version
- 1.0.0 · 2026-09-06 · 首批 SkillHub 包装

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。