SuperAPI AI 工具集

json-schema-lookup

通用与其它

查看项目

更新于 10-16 01:12

技能介绍

用途:通过查询 schemastore.org 的公共配置架构目录,校验配置文件结构、发现可用选项并检查允许的取值,适用于与热门开源项目相关的配置文件。

主要能力:访问目录 API https://www.schemastore.org/api/json/catalog.json,该接口结构为 { "schemas": [{ "name", "description", "fileMatch", "url", "versions"? }] };可先按名称或文件名模式搜索目录,再获取匹配条目中的 url 得到单个架构;支持查看顶层属性、特定字段的类型与枚举值、定义的共享类型、必填字段以及嵌套属性。

使用方式:使用命令行工具查询,例如按名称搜索:curl -s https://www.schemastore.org/api/json/catalog.json | jq '.schemas[] | select(.name | test("tsconfig"; "i")) | {name, url, fileMatch}';按文件名匹配:curl -s https://www.schemastore.org/api/json/catalog.json | jq '.schemas[] | select(.fileMatch[]? | test("package\.json")) | {name, url}';获取架构后可查询顶层属性 keys、特定字段 .properties.FIELD_NAME、定义 .definitions.DEF_NAME.properties、枚举 .properties.FIELD.enum、必填字段 .required 等。也可对目录 URL 使用 WebFetch 并请求相关条目。

适用场景:需要为开源项目配置文件做校验、查找可配置项、确认允许值或理解架构组成时使用。

限制与提示:部分架构使用 allOf/anyOf 组合,需检查这些数组以获得完整属性集;目录条目的 versions 字段在可用时提供特定版本的架构 URL;架构 URL 不统一,可能指向 json.schemastore.org 或 raw.githubusercontent.com;大型架构应查询特定路径而非整体输出;在同一会话中多次查询时可本地缓存目录响应。官方文本暂未提供。