校验器

每个 validate:* 脚本证明什么、validate:all 与发布门禁是否运行它,以及哪些已知会失败。

用 pnpm validate:<name> 运行单个校验器。pnpm validate:all 按顺序运行接入的整条链,遇到第一个失败即停止。pnpm validate:gate 运行除手动项和 scripts/validate/known-failures.json 所列之外的每个 validate:* 脚本,出现任何回归即失败。

功能

脚本证明
validate:api-keysKey 做了哈希、带 scope 并受限流;记录用量;后台清单与接线
validate:auth账号流程:注册、验证、重置、会话
validate:auth-feedback登录错误在两种语言下都有译文,并以 alert 呈现
validate:auth-boundary每个 API 路由要么受守卫,要么写明理由后公开;布局守卫;Webhook 验签结论
validate:google-one-tap向 Better Auth 处理器发真实请求:One Tap 开启时伪造的 ID token 返回 400 且不建会话;关闭或 Google 未启用时 /api/auth/one-tap/callback 返回 404
validate:aiAI 任务、定价与积分围绕真实结果结算
validate:ai-channel渠道 schema、定价、解析、Webhook 签名与轮询、退款
validate:generation-pipeline渠道解析路径可以索引数组、场景的相对状态路径、虚拟主机风格的对象寻址
validate:analytics分析服务商、事件、报表拉取与工单
validate:billing结账、Webhook、退款、客户门户;服务商未配置时判为失败,不伪造成功
validate:billing-fulfilment已付订单、退款和结账拒绝对每个 billing.fulfilment 插件只通知一次;失败会被记录,并由定时任务重试
validate:wechat-pay微信支付的签名、验签、解密、金额核对、结算、退款、按币种选渠道与二维码收银页
validate:alipay支付宝的 RSA2 签名、收银台地址、异步通知验签及应用号 / 卖家 / 金额核对、结算、重复通知、网关应答验签、按币种选渠道与后台表单
validate:waffoWaffo 的请求签名、结账会话(按套餐选商品、含税价格、订单 id、优惠码)、webhook 验签及重放与篡改拒绝、按实收金额结算
validate:promotion-codes优惠码开关只在开启时传给 Stripe Checkout;签名 webhook 中的折后金额记为实付
validate:pricing-plans/admin/plans 写入每个语言行,/pricing 与结账读到同样的数据,非法输入被拒绝,保存有审计且需要 plans.write
validate:credits预留、扣减与退还账本
validate:signup-credits注册奖励设置读写一致;每个用户只发一次、关闭时不发;Better Auth 的用户创建钩子已接线
validate:cache-policy来自后台配置的分域缓存策略
validate:config-encryptionsecret 类配置以 enc:v1: 密文存储、读出明文;密钥不对时读作未配置且不被默认值覆盖;加密命令;持有凭证的缓存域只用内存
validate:email模板、投递记录、通知渠道
validate:files上传、签名下载、存储配置
validate:foundation上线就绪检查、后台概览、系统状态
validate:plugins插件注册表的冲突处理、已安装列表的接线、启用状态与依赖级联、/admin/plugins 页面
validate:session-owner读取限定在所有者范围内
validate:system系统状态页、事件记录、跳转、维护模式
validate:usersRBAC、角色、权限、分配、状态变更

模块与 Agent

脚本证明
validate:affiliate推荐、佣金、提现审核、计划设置
validate:cms内容条目、修订、SEO 检查、支持多语言的后台路由
validate:newsletter订阅与候补名单流程、服务商同步日志
validate:registryregistry 切片可以还原整个检出;底座单独通过类型检查;清单描述的都是真实文件
validate:kernlift-lifecycle在真实 registry 条目上执行 CLI 的模块安装与卸载:预览不写入、拒绝被依赖的模块、逐字节还原、保留改动、--purge-data 生成迁移
validate:optional-agent不部署 Agent 服务时 Web 应用完整可用:定时任务在 Web 应用内由一把锁控制运行,Agent 入口显示不可用,任何 Web 请求路径都不加载 Agent 运行时
validate:agent-starterAgent 模板的隔离、对事务型数据库的要求、所有者范围、API 守卫、积分与就绪状态
validate:agent-plugin-contract所有 Agent 插件共用一个工作台输入框;插件的卡片、面板与服务端接入点;被停用的插件不会被选中
validate:agent-generation生成管线的 Agent 一侧:SQLite 上的原始查询、发布生成的媒体、视频产物
validate:dsh-runtimeAgent 运行时解析到锁定版本的 DeepSeek Harness,运行时包之外没有代码直接引用它
validate:image-agent图片 Agent 只通过插件插槽接入宿主、工作台和两个控制台,并作为模块发布

站点与文案

脚本证明
validate:app-i18n通用、认证、系统与营销文案都经由词典解析
validate:route-i18n路由支持多语言
validate:marketing营销快照、页面与区块
validate:example-landing/ 与 /pricing 只用公开外壳、page-shell 基础组件和 beUI 搭建,其中每个链接都指向存在的路由
validate:beui-console控制台、工作台、认证页与系统页使用统一的 beUI 体系,不引入 src/components/ui
validate:admin-surface-polish后台记录列表的分页与窗口计算正确
validate:mobile响应式约定
validate:site-metadata站点配置、站点地图、robots、.env.example 漂移
validate:project-docsREADME 只提到存在的命令和路径;/setup 的就绪状态由实时配置推导
validate:skills技能只引用存在的命令、路径和路由
validate:project-contextpnpm kernlift context 输出与源码一致
validate:store-boundary模板里没有授权、registry 服务端、商品目录、Kernlift 营销站和文档站

工程与部署

脚本证明
validate:env-example.env.example 与源码读取的变量一致
validate:unit-testspnpm test 通过,且 src/server/payments/ 中每个支付客户端和配置加密都有单元测试
validate:template-boundary骨架不从可编辑区导入;升级指南覆盖该流程
validate:init-cliCLI 的项目初始化器会生成会话密钥、能续跑未完成的初始化,且不会删除云资源
validate:migrations两条迁移链都能在空库上重放,并得到相同的表
validate:db-adapters适配器注册表、绑定与服务端入口
validate:sqlite-transactions默认 SQLite 适配器上,异步事务回调的提交、回滚、排队与嵌套都正确
validate:deploy-targetsdeploy.config.json 决定 Cloudflare 或 Node 构建;入口、镜像和迁移执行器与之一致
validate:openspec-traceability、validate:openspec-consistency、validate:openspec-remaining-scopeOpenSpec 记录、可追溯性与剩余范围
validate:external有凭据时对真实服务商做检查;EXTERNAL_VALIDATE_STRICT=true 时跳过即失败
validate:external-readiness先运行 validate:external,再写出就绪报告

pnpm openspec:validate 也接在 validate:all 里,它对每个带 tasks.md 的活动变更运行 openspec-cn validate。

单独运行

脚本为什么不在 validate:all 里
validate:all整条链本身;门禁不运行它
validate:gate发布门禁本身
validate:storage-drivers会在存储桶里写入并删除真实对象,只应对你选定的存储桶有意运行。门禁同样跳过它
validate:ai-channel、validate:auth-feedback、validate:external没有接进 validate:all,但门禁会运行
lint:budget存量 lint 违规的递减预算;--update 记下一次减少

商店项目

以下校验器属于销售 Kernlift 的商店项目。由模板创建的项目里没有它们。

脚本证明
validate:products服务端定价、授权签发与撤销
validate:module-catalog模块页、定价页与首页区块由产品数据渲染
validate:github-delivery会员与会员价、用 GitHub 用户名激活、仓库邀请、激活后的退款规则、撤销授权
validate:template-marketplace模板页基于真实快照渲染
validate:landing-blocks首页组合、设计令牌、来自检出的计数
validate:docs双语导航与链接可解析;模块清单、Agent API 方法、数据表和环境变量与文档一致
validate:deployment-docs部署文档覆盖每个目标平台

已知失败

scripts/validate/known-failures.json 列出在仅由 pnpm db:migrate 建出的数据库上尚不能通过的校验器。这份清单只能缩短。新增条目会让 CI 失败。

脚本原因简述
validate:ai需要全新数据库没有的 AI 场景、渠道与定价行
validate:auth断言的文案已移入词典
validate:billing断言一份已归档设计记录里的行
validate:cms需要种子内容,并断言旧的后台标记
validate:credits为不存在的用户写账本行;文案已迁移
validate:files需要种子文件夹、文件与用量行;文案已迁移
validate:newsletter断言的字面量已移入词典
validate:openspec-consistency早期归档的变更缺少后来新增的策略章节
validate:users需要种子用户、角色与权限

下一步