公共组件清单 JSON 格式规范(v1.0)

公司维护一份公共组件清单,三种取法(结构完全一致,以当次读取结果为准):

  1. 生产清单(默认):https://w4xrncbp.qwenwork.host/data/components.json——「安全风险简报情报站」托管的仓库文件 public/data/components.json,维护即改该文件并重新发布,站点发布后此 URL 立即返回最新内容;
  2. 其他 URL:发布在固定 URL(返回 JSON,UTF-8,Content-Type: application/json),简报生成时实时拉取;
  3. 本地 JSON 文件:按本规范保存为 .json 文件,生成简报时提供文件路径。

本规范定义其结构。

顶层字段

字段类型必填说明
schemaVersionstring是固定 "1.0"
updatedAtstring是清单最近维护日期 YYYY-MM-DD
maintainerstring是维护部门/团队
componentsarray是组件数组,至少 1 项
latestVersionCheckedAtstring否顶层字段:latestVersion 的核对日期 YYYY-MM-DD
docsstring否顶层字段:本规范或清单说明页 URL

components[] 字段

字段类型必填说明
namestring是组件规范名(简报显示用),如 Dify、kkFileView、RAGFlow
aliasesstring[]建议检索别名:大小写变体、仓库 owner/repo、常用简称,用于漏洞检索与匹配
repostring建议官方仓库或官网 URL,作为一手信源
categorystring否用途分类,如「AI 应用开发平台」「文件预览」「RAG 引擎」
enabledboolean否默认 true;false 表示已下线/暂停监测,简报跳过
deploymentsarray是在用部署数组,至少 1 项;同一组件多版本/多环境分列

deployments[] 字段

字段类型必填说明
versionstring是在用版本号(如 1.9.1、4.4.0);确实不掌握时填 "unknown",简报将列入「版本待核实」,不得省略该字段
envstring是环境:生产 / 测试 / 开发 等
exposurestring建议暴露面:互联网 / 内网 / 办公网;影响风险排序,互联网暴露优先提示
notestring否备注(如「仅内部 API 调用」「前置 WAF」)
latestVersionstring否信息性字段:核对时官方最新版本(写发行版原样,不带 v),仅用于体现落后程度,不参与版本命中判定

维护约定

清单的可读版发布在 https://w4xrncbp.qwenwork.host/data/components-schema.html;站点另提供离线维护工具 https://w4xrncbp.qwenwork.host/components-editor.html(清单生成器:导入现有 JSON、按规范编辑、校验后导出标准 JSON),导出的文件由维护人交回对话覆盖 public/data/components.json 后发布生效。

打开清单生成器查看生产清单 JSON返回情报站首页
本页面由技能参考文档 references/components-schema.md 同步生成,权威源为技能目录内的 Markdown 文件;两者若有出入,以技能文档为准。