SuperAPI AI 工具集

dicom-metadata-extract

数据与分析

查看项目

更新于 10-16 03:49

技能介绍

用途:从单个 DICOM 文件中提取选定元数据,并标记标准标签中是否存在 PHI(受保护健康信息)。明确不用于匿名化,也不用于临床用途。

主要能力:使用 pydicom 读取一个 DICOM 文件,并在 stdout 输出 JSON,内容包括 transfer_syntax、modality、按 study/series/image 分组的元数据、phi_present 和 phi_tags_found。Manifest 输入为 dicom_path,输出为 metadata_json。

使用方式:先阅读 skill_manifest.yaml,再修改参数、副作用或验证门。通过 scripts/extract_metadata.py 运行,保持输出在调用方提供的运行目录下。若宿主 agent 提供 run_script,使用 run_script("scripts/extract_metadata.py", args=[...]);否则运行: python scripts/extract_metadata.py PATH_TO_DICOM python scripts/extract_metadata.py PATH_TO_DICOM --output result.json 处理结果前,检查生成的 JSON,并对 evidence packs 运行 medagent.verifiers.dicom_metadata_quality_v1,然后才将其视为已审核证据。

限制:仅覆盖基于 PS3.15 的一小部分标准标签子集,不是完整的基本应用保密配置文件实现;不检查私有标签;不检测像素中烧录的 PHI;多帧处理很有限。不适合临床部署、法规级去标识化、自主诊断或面向患者的使用。

运行要求与排查:运行依赖见 runtime.side_effects.pip_packages 中列出的 Python 包,除非另有说明,从仓库根目录运行命令。缺少依赖或导入错误时,按 manifest 安装声明的包;输出为空或 schema 无效时,用已知 fixture 重新运行并检查 wrapper JSON 与 stderr;验证门失败时,保留失败 evidence pack,并依据门消息修复输入或 wrapper 代码。该技能可作为 Medical AI Skills 的最小端到端示例。