校验器
每个 validate:* 脚本证明什么、validate:all 与发布门禁是否运行它,以及哪些已知会失败。
用 pnpm validate:<name> 运行单个校验器。pnpm validate:all 按顺序运行接入的整条链,遇到第一个失败即停止。pnpm validate:gate 运行除手动项和 scripts/validate/known-failures.json 所列之外的每个 validate:* 脚本,出现任何回归即失败。
| 脚本 | 证明 |
|---|
validate:api-keys | Key 做了哈希、带 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:ai | AI 任务、定价与积分围绕真实结果结算 |
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:waffo | Waffo 的请求签名、结账会话(按套餐选商品、含税价格、订单 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-encryption | secret 类配置以 enc:v1: 密文存储、读出明文;密钥不对时读作未配置且不被默认值覆盖;加密命令;持有凭证的缓存域只用内存 |
validate:email | 模板、投递记录、通知渠道 |
validate:files | 上传、签名下载、存储配置 |
validate:foundation | 上线就绪检查、后台概览、系统状态 |
validate:plugins | 插件注册表的冲突处理、已安装列表的接线、启用状态与依赖级联、/admin/plugins 页面 |
validate:session-owner | 读取限定在所有者范围内 |
validate:system | 系统状态页、事件记录、跳转、维护模式 |
validate:users | RBAC、角色、权限、分配、状态变更 |
| 脚本 | 证明 |
|---|
validate:affiliate | 推荐、佣金、提现审核、计划设置 |
validate:cms | 内容条目、修订、SEO 检查、支持多语言的后台路由 |
validate:newsletter | 订阅与候补名单流程、服务商同步日志 |
validate:registry | registry 切片可以还原整个检出;底座单独通过类型检查;清单描述的都是真实文件 |
validate:kernlift-lifecycle | 在真实 registry 条目上执行 CLI 的模块安装与卸载:预览不写入、拒绝被依赖的模块、逐字节还原、保留改动、--purge-data 生成迁移 |
validate:optional-agent | 不部署 Agent 服务时 Web 应用完整可用:定时任务在 Web 应用内由一把锁控制运行,Agent 入口显示不可用,任何 Web 请求路径都不加载 Agent 运行时 |
validate:agent-starter | Agent 模板的隔离、对事务型数据库的要求、所有者范围、API 守卫、积分与就绪状态 |
validate:agent-plugin-contract | 所有 Agent 插件共用一个工作台输入框;插件的卡片、面板与服务端接入点;被停用的插件不会被选中 |
validate:agent-generation | 生成管线的 Agent 一侧:SQLite 上的原始查询、发布生成的媒体、视频产物 |
validate:dsh-runtime | Agent 运行时解析到锁定版本的 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-docs | README 只提到存在的命令和路径;/setup 的就绪状态由实时配置推导 |
validate:skills | 技能只引用存在的命令、路径和路由 |
validate:project-context | pnpm kernlift context 输出与源码一致 |
validate:store-boundary | 模板里没有授权、registry 服务端、商品目录、Kernlift 营销站和文档站 |
| 脚本 | 证明 |
|---|
validate:env-example | .env.example 与源码读取的变量一致 |
validate:unit-tests | pnpm test 通过,且 src/server/payments/ 中每个支付客户端和配置加密都有单元测试 |
validate:template-boundary | 骨架不从可编辑区导入;升级指南覆盖该流程 |
validate:init-cli | CLI 的项目初始化器会生成会话密钥、能续跑未完成的初始化,且不会删除云资源 |
validate:migrations | 两条迁移链都能在空库上重放,并得到相同的表 |
validate:db-adapters | 适配器注册表、绑定与服务端入口 |
validate:sqlite-transactions | 默认 SQLite 适配器上,异步事务回调的提交、回滚、排队与嵌套都正确 |
validate:deploy-targets | deploy.config.json 决定 Cloudflare 或 Node 构建;入口、镜像和迁移执行器与之一致 |
validate:openspec-traceability、validate:openspec-consistency、validate:openspec-remaining-scope | OpenSpec 记录、可追溯性与剩余范围 |
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 | 需要种子用户、角色与权限 |