SuperAPI AI 工具集

deep-inspect

通用与其它

查看项目

更新于 10-16 08:01

技能介绍

用途:当某个 dotnet-inspect 变更需要常规 PR CI 之外的高成本证据,或准备发布认证时使用 deep-inspect。它是仓库本地维护者技能(CI/认证执行框架),并非随 dotnet-inspect 二进制发布的终端用户功能。它按需启用,适用于有风险的 PR;其 test、platform-test、decompiler-corpus 任务每日运行,为发布认证某个提交。发布流程消费最近一次已完成的认证证据,不会仅因 main 前进或发布决策延后而重跑慢速套件。同一 lane 的运行不取消更早运行,发布风险审查需要完整结果。夜间 release-candidate 工作流先构建不可变发布资产,再对同一提交调用 release-candidate lane,该 lane 合并发布认证、census 与全面的 Inspect Web 证据,不含单独调度的 authored-corpus 棘轮。所有 lane 也可在白天按需调度。

主要能力(lane):test 用于每日/按需发布认证或风险合并前的阻断证明,运行完整 decompiler 测试、完整 analysis 测试、vendored ILAssembler 还原、完整 IL 往返扫描;platform-test 用于 Windows、macOS、Ubuntu 上的跨平台认证,运行精简套件;census 用于观测性广谱信号与分诊;package-sweep 每周/按需发现当前热门 NuGet 包,仅做发现、从不阻塞 PR,每周一 09:00 UTC 运行;authored-corpus 用于每日/按需针对校验和验证的作者语料的回归棘轮;inspect-web 用于每日常规的 Browser/Wasm 回归证据;release-candidate 在夜间发布资产组装后调用,对候选精确 SHA 运行 test、platform-test、decompiler corpus、census 与 inspect-web;nightly 为可选的下一代 SDK/编译器验证,被有意排除在 all 之外;all 是发布候选深度读取,涵盖 test、platform-test、decompiler-corpus、census、authored-corpus 与 inspect-web。

使用方式:手动运行示例为 gh workflow run deep-inspect.yml -f lane=test;lane=platform-test、lane=census、lane=package-sweep、lane=authored-corpus、lane=inspect-web、lane=release-candidate、lane=nightly、lane=all 同理。查看最近运行与产物:gh run list --workflow deep-inspect.yml --limit 10;gh run view <run-id> --log-failed;gh run download <run-id> -D /tmp/deep-inspect-<run-id>。test lane 的本地等价步骤依序为 dotnet build dotnet-inspect.slnx -c Release、dotnet run --project tests/DotnetInspect.Cli.Tests -c Release、source eng/activate-iltools.sh、dotnet run --project tests/ILInspector.Decompiler.Tests -c Release -- --gate no-corpus、dotnet run --project tests/ILInspector.Analysis.Tests -c Release、bash eng/restore-ilassembler.sh、dotnet run --project tests/DotnetInspector.ILRoundtrip.Tests -c Release、dotnet run --project tests/ILInspector.Decompiler.Tests -c Release -- --gate corpus。corpus 命令作为单独工作流任务运行,可能耗时数小时。

结果解读与限制:test、platform-test 和 decompiler-corpus 的失败应视为可见发布风险;若发布决策需要绿色证据则修复,否则保留红色结论并走发布工作流的显式失败接受路径。不要仅因发布目标移动就自动重跑 Deep Inspect。census 输出视为分诊信号,除非命令按设计非零退出;快照应与已提交基线比较,把有意义的漂移转成 issue 或后续 PR。inspect-web 失败视为 Browser/Wasm 回归阻断项;普通 PR 运行快速边界模式,涉及门面生成器、金丝雀或托管桥所有者的变更在合并前运行完整模式。不要向 PR CI 添加广谱/语料式测试,应标记 [Trait("Speed", "Slow")] 并保留在 Deep Inspect 或完整本地运行中。自测覆盖激活脚本本身,不覆盖工作流步骤拼写、顺序或 GitHub Actions 的穷尽源模型。