用途:altium-validation 用于把 altium-cli 的代码(类型、常量、记录、解析)与 docs/dxp/、docs/schlib/、docs/schdoc/、docs/pcblib/ 等反向工程文档以及 Altium 源码交叉比对,专门检查实现是否与已记录的格式规范和原始 Altium 源码一致。它明确不是代码质量审查,而是格式一致性校验。
主要能力:校验清单覆盖 MISMATCH(V1 记录类型枚举完整性、V2 常量值、V3 各记录参数键、V4 参数类型、V5 分发覆盖、V6 流名称与布局、V7 sidecar 合并行为、V8 二进制布局)、GAP(V9 缺失记录字段、V10 缺失常量、V11 未文档化代码)、AMBIGUITY(V12 文档与 C# 源码冲突、V13 格式行为不确定、V14 版本相关行为)。每条发现需报告违反的规则、代码位置(file:line)、文档或源码引用、具体问题以及建议修复;模糊处单独标注并交用户决定。
使用方式:可指定范围,如 records、constants、streams、pcb 或 sch、某个记录类型、某个文件;未指定时按优先级顺序校验,即先记录类型枚举、再分发覆盖、常量值、参数键、流名称布局、sidecar、缺失字段、二进制布局。方法论上每个检查在可用时参考三类来源:本仓库代码(crates/altium-format-types/src/、crates/altium-format/src/)、格式文档 docs/dxp/ 与域文档 docs/schlib/、docs/schdoc/、docs/pcblib/、以及 Altium 源码 AD26-dotnet/(C# 反编译源码)和 ghidra-cli(Delphi)。域文档通常比跨领域文档更新更细,校验时先查对应域文档再查 docs/dxp/。报告按 MISMATCH、GAP、AMBIGUITY 分组并给出汇总计数。
适用场景:需要确认 altium-cli 实现是否忠实于文档化格式规范和 Altium 原实现,尤其是记录枚举、常量、参数键、流与 sidecar 处理、二进制布局等解析层正确性时。
限制:本技能不评估代码质量;遇到文档与源码冲突等模糊情形不猜测,需用户裁决;部分校验(如缺失字段、PCB 解析)耗时或依赖 PCB 解析进度;资料未提供具体安装命令、收费、平台或运行环境信息。