验证与发布

源码规则

npm run lint --prefix registry
npm run build --prefix registry
npm run sync:docs --prefix registry
npm test --prefix registry
npm run check:generated --prefix registry
npm run lint --prefix docs
npm run typecheck:site --prefix docs
npm run build:site --prefix docs

在浏览器检查前，注册表测试会验证依赖关系、文档示例、主题规则与生成源码的前提。

生成一致性

• 注册表目录、两份公开端点、主题CSS与初始化脚本均从源码生成。
• check:generated要求生成产物逐字节一致，且条目列表相同。
• CI最终生成检查会拒绝已跟踪文件的差异与意外的未跟踪文件。

默认CI

• main推送、拉取请求和未开启comprehensive的手动运行会检查注册表代码规范、构建与规则，文档代码规范、类型与构建，以及生成一致性。
• 文档交互使用Chromium的桌面明亮与移动深色模式检查。代表性的Vite与Next.js使用方安装通过consumer:verify --smoke检查。
• 依赖审计若发现高危或严重漏洞会阻止CI通过，包括开发工具中的漏洞。

完整本地与手动检查

• 广泛发布前，请在本地执行完整使用方与独立条目检查，或手动运行Verify并开启comprehensive。
• 独立安装矩阵从已构建目录中选取所有含文件条目。
• 模板在全新Next.js项目中构建，其他条目在Next.js与Vite中分别独立构建。
• 手动工作流将独立安装矩阵分成三个任务，并增加Firefox、WebKit使用方检查和detail、material界面检查。

已部署站点核心检查

• Published registry工作流会等待build-info.json与触发运行的main提交一致。
• 已部署站点只检查三个Chromium核心场景与三个代表性注册表端点。完整安装与浏览器矩阵在本地或手动完整验证中运行。
• 失败依据保存在CI产物中，本地浏览器检查依据写入docs/test-results。

发布边界

• 本地或CI构建通过，不代表shadcn目录批准或与已部署域名等价。
• 实际域名检查必须匹配准确的部署提交与公开注册表端点。
• 许可证与来源标注是独立发布条件，不能从仓库所有权推断已经满足。