SuperAPI AI 工具集

dicom-series-preflight

通用与其它

查看项目

更新于 10-16 03:49

技能介绍

用途:dicom_series_preflight 用于在转换或推理之前,对单个 DICOM 序列文件夹做仅读取头部的预检。它不是去标识化工具,也不用于临床批准。

主要能力:扫描目录(每文件夹一个序列),不解码像素;输出 JSON,包含清单、方向 axcodes、PHI 标记、发现项,以及 preflight.verdict 的 pass、warn 或 fail。

使用方式:先阅读 skill_manifest.yaml 再更改参数、副作用或验证门;通过文档命令运行 scripts/preflight_series.py,输出放在调用方提供的运行目录下;若宿主 agent 提供 run_script,则使用 run_script("scripts/preflight_series.py", args=[...])。运行脚本示例:python scripts/preflight_series.py PATH_TO_DICOM_DIR。与验证器配合、可信预检包示例:make run-trusted SKILL=dicom_series_preflight FIXTURE=skills/dicom-series-preflight/fixtures/clean_no_phi OUT=runs/dicom_preflight_demo。旗舰工作流示例:make run-workflow WORKFLOW=examples/workflows/dicom_preflight_gate.yaml WORKFLOW_INPUT=skills/dicom-series-preflight/fixtures/clean_no_phi WORKFLOW_OUT=runs/dicom_preflight_gate。运行前需满足运行时要求:安装 runtime.side_effects.pip_packages 中列出的 Python 包;除文中另有说明外,从仓库根目录运行命令。

限制:仅头部,不解码像素,也不检测烧录的 PHI;规范方向门假设 LPS 派生的 CT axcodes 为 L,P,S;压缩传输语法与多帧实例仅告警,不解码;只扫描单一目录,不整合一棵目录树中的多个检查;不得用于临床部署、法规去标识化、自主诊断,或未经审查转换器的生产摄取。故障排查:依赖缺失或导入错误,原因通常是运行时包与 skill_manifest.yaml 漂移,应安装清单声明的包或使用文档化设置命令;输出为空或模式无效,可能是输入路径错误、不支持的模态或上游失败,应使用已知 fixture 重跑并检查包装 JSON 与 stderr;验证门失败表示输出违反声明的工程不变量,应保留失败证据包并根据门消息修复输入或包装代码。