脚本
模板 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 typecheck | tsc --noEmit,同时检查 tests/ 下的单元测试 |
pnpm test | 用 Node 内置测试运行器(tsx --test)执行 tests/unit/*.test.ts。覆盖签名、验签、金额换算和加密,不连数据库、不访问网络 |
pnpm check | biome check .:lint 与格式检查,会报告存量违规 |
pnpm lint | biome lint . |
pnpm lint:budget | 某条 lint 规则的违规数超过记录的预算时失败;确实减少后用 --update 下调预算 |
pnpm format | biome 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 的依赖数组,两者都会改变行为。