脚本

模板 package.json 里除单个校验器之外的每个 pnpm 脚本,按用途分组。

在项目根目录用 pnpm <name> 运行。涉及数据库的脚本从 .env 或 shell 读取 DATABASE_DIALECT 与 DATABASE_URL。单个 validate:* 脚本见校验器。

开发

脚本作用
pnpm dev用 Vite 启动 Web 应用,端口 5173
pnpm dev:agent同时启动 Web 应用和 Agent 服务(agent-starter),自带本机地址和临时签名密钥
pnpm kernlift运行 tools/kernlift 中的 Kernlift CLI,例如 pnpm kernlift deploy-target fly。见 deploy.config.json
pnpm preview用 vite preview 预览最近一次构建
pnpm cf-typegen生成 worker-configuration.d.ts,即源码编译所依赖的 Workers 运行时与绑定类型
pnpm assets:generate重新生成占位用的站点图标和社交分享图
pnpm assets:screenshots通过 Chrome 从本机运行的实例截取营销截图;CHROME_PATH 指定可执行文件

构建与运行

脚本作用
pnpm build按 deploy.config.json 记录的平台构建:Cloudflare Worker,或其它平台共用的 Node 服务
pnpm build:cloudflare不看 deploy.config.json,构建 Cloudflare Worker
pnpm build:node构建 Node 服务,并把管理员初始化脚本打包到 .output/scripts/ 供生产镜像使用
pnpm build:agent-service构建独立的 Agent 服务包
pnpm start运行 Node 构建产物(.output/server/index.mjs)
pnpm deploy执行所选平台的部署命令;Cloudflare 项目里是 wrangler deploy

数据库

脚本作用
pnpm db:migrate应用当前方言的迁移链;无法执行时打印数据库所处的状态
pnpm db:migrate:runtime用纯 Node 应用同一批迁移,不需要 TypeScript 工具链;生产镜像的发布步骤
pnpm db:migrate:d1:local通过 wrangler 把 SQLite 迁移链应用到本机 D1
pnpm db:migrate:d1:remote把 SQLite 迁移链应用到已部署的 D1
pnpm db:generate按 DATABASE_DIALECT 指定的方言运行 drizzle-kit generate
pnpm db:generate:sqlite为 SQLite schema 生成迁移
pnpm db:generate:postgres为 Postgres schema 生成迁移
pnpm db:studio在当前数据库上打开 Drizzle Studio
pnpm db:seed-baseline写入全新数据库需要的基线内容:邮件模板、营销页面与区块、限流规则。已存在的行保持不变
pnpm db:bootstrap-super-admin用 SUPER_ADMIN_EMAIL 和 SUPER_ADMIN_PASSWORD 创建首个管理员,写入权限目录并执行基线种子
pnpm db:seed不写入任何数据,只提示基线内容来自 pnpm db:seed-baseline
pnpm db:encrypt-config-secrets用 .env 或命令行环境中的 CONFIG_ENCRYPTION_KEY,把仍以明文存储的 secret 类后台配置加密。已加密的值跳过,重复执行不会改动任何行;没有有效密钥时报错退出。D1 默认处理本地状态,加 --remote 处理线上数据库,--persist-to <目录> 指定另一份本地状态

定时任务

脚本作用
pnpm jobs:run执行一轮定时任务并打印报告;这一轮已被其它执行方占用时打印 "skipped"。有任务失败时退出码非零

Agent

脚本作用
pnpm agent:publish-skills把内容有变化的平台 Skill 发布到技能注册表;设置 SKILL_PUBLISH_DRY_RUN 时只预览不写入

Registry 与技能

registry:build 用来把模块清单与代码核对,见开发一个模块。registry:publish 把结果上传到 registry 服务端,从 GitHub 克隆的项目没有这个服务端。

脚本作用
pnpm registry:build把检出切成一个底座条目和每个 modules/<key>/module.json 对应的条目,输出到 registry/dist
pnpm registry:publish用 KERNLIFT_PUBLISH_TOKEN 把 registry/dist 推送到 KERNLIFT_REGISTRY_URL 指向的 registry
pnpm skills:pack从 skills/ 构建 packages/kernlift-skills,并写出 skills.json 清单

检查

脚本作用
pnpm typechecktsc --noEmit,同时检查 tests/ 下的单元测试
pnpm test用 Node 内置测试运行器(tsx --test)执行 tests/unit/*.test.ts。覆盖签名、验签、金额换算和加密,不连数据库、不访问网络
pnpm checkbiome check .:lint 与格式检查,会报告存量违规
pnpm lintbiome lint .
pnpm lint:budget某条 lint 规则的违规数超过记录的预算时失败;确实减少后用 --update 下调预算
pnpm formatbiome format --write .
pnpm validate:all按顺序运行接入的校验器链,遇到第一个失败即停止
pnpm validate:gate运行除手动项和已知失败项之外的每个校验器;CI 以它为门禁
pnpm openspec:validate对每个带 tasks.md 的活动变更运行 openspec-cn validate
pnpm smoke:node在一次性 SQLite 数据库上运行 Node 构建产物,不带 Agent 服务;先运行 pnpm build:node
pnpm smoke:worker在本机 wrangler dev 和一次性 D1 数据库上运行构建好的 Worker,不带 Agent 服务;先运行 pnpm build

不要对整个仓库运行 biome check --write --unsafe。它的修复会去掉样式表里的 !important,并改写 React hook 的依赖数组,两者都会改变行为。

下一步