用途:从多个来源发现并核对阿里云产品目录,解析 OpenAPI 元数据,为技能规划生成产品与接口汇总。
主要能力:从 Ticket System(ListProducts)、Support & Service(ListProductByGroup)、BSS OpenAPI(QueryProductList)三处获取产品列表;合并产品来源;抓取 OpenAPI 元数据产品列表;按产品/版本抓取接口文档;将产品与接口数量关联;按分类/分组汇总产品;可选对比产品与已有技能。
使用方式:在技能目录内运行捆绑脚本,例如 python scripts/products_from_ticket_system.py、python scripts/products_from_support_service.py、python scripts/products_from_bssopenapi.py、python scripts/merge_product_sources.py、python scripts/products_from_openapi_meta.py、python scripts/apis_from_openapi_meta.py、python scripts/join_products_with_api_meta.py、python scripts/summarize_openapi_meta_products.py、python scripts/analyze_products_vs_skills.py。各脚本需按 references 配置所需环境变量。抓取接口文档默认数据量大,可用 OPENAPI_META_MAX_PRODUCTS、OPENAPI_META_PRODUCTS、OPENAPI_META_VERSIONS 做试运行过滤。
输出与验证:所有生成文件须放在 output/ 下;产物、命令输出与 API 响应摘要保存到 output/aliyun-openapi-discovery/,证据文件包含 region、资源 id、时间范围等关键参数。验证命令为 mkdir -p output/aliyun-openapi-discovery 后对 scripts/*.py 执行 python3 -m py_compile,通过标准为退出码 0 且生成 validate.txt。
前提与限制:执行前配置最小权限的阿里云凭证,优先使用环境变量 ALIBABACLOUD_ACCESS_KEY_ID、ALIBABACLOUD_ACCESS_KEY_SECRET,可选 ALIBABACLOUD_REGION_ID;区域不明确时先询问用户再执行变更类操作。具体脚本参数、接口端点与返回字段以 references/product-sources.md 和 references/openapi-meta.md 为准,资料未提供更细的字段说明。