SuperAPI AI 工具集

verify-catalog

通用与其它

查看项目

更新于 10-16 03:17

技能介绍

用途:校验 Pega Dev Components 目录(index.json)中所有二进制 URL 是否有效,并确认资源实际文件大小与声明一致,常用于发布后验证、部署前测试、资源完整性检查及 CI/CD 质量门禁。

主要能力:解析 index.json 提取所有二进制 URL;在本地 8000 端口启动 HTTP 服务器并逐个发起 HEAD 请求;将 GitHub Pages 地址自动转换为 http://localhost:8000/assets/... 本地地址;比对 content-length 与本地实际文件大小;输出通过/失败汇总表与详细报告,并用 ✓/✗ 彩色标记;退出码 0 表示全部通过,1 表示存在失败。校验范围覆盖目录中全部组件与版本,例如 Platform Blueprint Component、AI Authoring Rules、CDH Blueprint Import Module。

必要用法:需在 pega-dev-components 仓库根目录操作,具备 Python 3.6+ 且 assets/components/ 中已存在全部资源,8000 端口可用。典型步骤为:先执行 python3 -m http.server 8000 启动服务器,再运行 python3 scripts/verify_catalog.py http://localhost:8000,完成后结束服务器进程。也可指定其他端口,如 python3 scripts/verify_catalog.py http://localhost:9000;脚本纯 Python 标准库实现,无外部依赖。

限制与说明:若不做 HTTP 校验,仅检查 index.json 引用文件是否本地存在,可直接用 Python 读取并比对路径(资料给出示例代码,此处不完整抄录)。常见问题包括连接被拒(服务器未启动)、本地文件缺失、大小不匹配(下载损坏或不完整)、HTTP 404(URL 路径与实际结构不符)、端口被占用(需先终止占用进程)。文档未提供收费、许可或跨平台支持等其他信息。