元数据静态检查

元数据静态检查用于在推送测试服务器前发现明显结构问题，例如 JSON 语法错误、文件类型不匹配、关键字段缺失、DTS 类型不一致、引用路径异常和脚本入口配置错误。它适合在 AI 修改后快速拦截低级错误，但不能替代产品验证。

检查依据

静态检查通常结合以下依据：

1. 元数据手册中的文件类型、通用结构、.meta 和引用路径说明。
2. /dev-types/ 中发布的 DTS 类型声明。
3. 当前工作区中的同类文件和历史写法。
4. SuccApp CLI 当前可用的工作区检查能力。
5. SuccApp CLI 的服务器编译校验能力，用于检查 JSON 配置、表达式等元数据语义。

使用方式

常见检查方式：

1. 在 VS Code 中打开元数据文件，查看 JSON 语法、类型提示和编辑器诊断。
2. 执行 SuccApp: 初始化工作区，刷新类型声明和编辑器辅助配置。
3. 使用 succapp workspace repair --dry-run --only=workspace-support 检查推荐设置是否缺失。
4. 对旧版本元数据先执行 succapp workspace file upgrade --dry-run 查看升级候选。
5. 对需要编译的元数据文件执行 succapp workspace file compile <path>，把本地内容发送到当前服务器做编译校验。
6. 执行 succapp workspace repair --dry-run 预演工作区结构、本地同步基线和同步状态修复。

局限

静态检查不能证明：

1. 引用路径一定存在。
2. 字段名、组件 ID、数据集 ID 一定被正确引用。
3. SQL、脚本、表达式和权限配置运行正确。
4. 产品设计器一定能按预期渲染。
5. 业务口径和客户需求正确。

因此静态检查通过后，还要继续做引用检查、产品验证和Diff 审查。