SuperAPI AI 工具集

artifact-proof

测试与质量

查看项目

更新于 10-30 16:18

技能介绍

用途

Artifact Proof 用于在构建出交付物之后,验证用户实际收到的产物是否可用。它针对的是 ZIP、安装程序、可执行文件、wheel、软件包、发布资产等构建产物,而不是源码树。其核心规则明确指出:源码树中的测试不能证明构建产物本身正确,必须测试用户真正拿到的东西。

主要能力

该技能定义了一套构建后的验证契约,包含以下步骤:

  1. 计算校验和,并记录版本与源码修订号;
  2. 将产物打开或解压到一个全新目录;
  3. 验证必需文件是否存在,并检查是否混入禁止文件;
  4. 从解压后的产物中运行真实的用户入口点;
  5. 运行产物自带的 doctor/自检;
  6. 验证内部清单/校验和与版本信息;
  7. 针对解压后的副本重复关键测试,而不是针对源码树。

针对不同类型的产物,还给出了具体验证方式:归档文件需验证 CRC 与路径往返;二进制需执行版本/自检;安装程序在适用时需验证安装与卸载/修复行为。

使用方式

该技能以规则和契约的形式描述验证流程,未提供具体的安装命令或代码示例。使用时应按照上述契约步骤,在构建完成后对产物执行打开、解压、运行入口点、自检、校验和验证等操作。

适用场景

适用于任何需要发布构建产物的场景,包括但不限于:打包 ZIP 归档、生成安装程序、编译可执行文件、构建 Python wheel、制作软件包或发布资产。

限制

该技能强调一个停止条件:不能因为编译、lint 或仓库测试通过就宣布发布就绪。如果产物本身没有被打开并实际运行,应将其行为标记为未验证。资料中未提供具体的工具依赖、平台支持范围、收费方式或价格信息。