检查 Labs 描述符

读取 Labs 目录并验证本地边界健康状态描述符。

Linux 上的 Altifigence CLI 0.1.9 提供本地 Labs 描述符工作流。使用此工作流检查固定的工作流目录、读取描述符状态，并检查 JSON 边界健康状态摘要。命令返回的元数据可与审查资料一同保存。先查看目录和状态，以确定正在检查哪些描述符。

读取已保存的结果之前，确认退出状态为 0。单独保留标准错误输出，并检查下文所述的结果字段。

读取目录

alti labs inspect
alti labs status

作为一个小型验证示例，将以下 JSON 保存为现有项目中的 boundary-health.json。此示例包含空的健康状态卡片数组和源引用数组，用于展示验证器接受的描述符结构。需要进行实质性健康状态审查时，请根据已检查的清单填写实际摘要。标识、覆盖范围和安全性字段都是受检查结构的一部分。

保存描述符

{
  "schemaVersion": "altifigence.lab.json-boundary-health-summary.v0",
  "tool": "alti-lab",
  "healthSummaryId": "local-example",
  "summaryState": "descriptor_only",
  "inventoryState": "checked_fixture",
  "sourceInventoryRef": {},
  "coverageSummary": {
    "overallState": "checked",
    "summaryOnly": true,
    "descriptorOnly": true
  },
  "consumerPolicy": {},
  "safetyFlags": {
    "dataOnly": true,
    "descriptorOnly": true,
    "readOnly": true,
    "summaryOnly": true,
    "commandExecution": false,
    "shellExecution": false,
    "runtimeExecution": false,
    "networkCalls": false,
    "repositoryMutation": false
  },
  "sourceCheckRefs": [],
  "healthCards": [],
  "driftGates": [],
  "blockedActions": [],
  "limitations": [],
  "issueRefs": []
}

验证已保存的文件

alti labs validate --project /absolute/project boundary-health.json

使用项目的绝对路径，以及相对于该项目的描述符路径。命令成功后，以 JSON 形式输出已验证的描述符。将返回的摘要标识与已保存的输入进行比较，然后将文件和输出一同保留。验证会检查描述符声明的结构。

检查验证输出

以下展示了验证成功输出中的部分字段。完整输出保留其余描述符字段。

{"schemaVersion":"altifigence.lab.json-boundary-health-summary.v0","tool":"alti-lab","healthSummaryId":"local-example","summaryState":"descriptor_only","inventoryState":"checked_fixture"}

对于错误 unsupported JSON boundary health summary schema，请将 schemaVersion 设置为输入示例中的 altifigence.lab.json-boundary-health-summary.v0，然后重新验证。