​
Web 应用脚本

命令作用
npm run dev启动开发服务器
npm run build生产构建
npm run start启动生产模式
npm run lint代码检查
npm run test运行测试（tsx --test）

​
数据库与 Prisma

命令作用
npm run db:up启动 PostgreSQL 容器
npm run db:down停止 PostgreSQL 容器
npm run db:logs查看数据库日志
npm run db:generate生成 Prisma Client
npm run db:migrate开发迁移
npm run db:studio打开 Prisma Studio

​
内容相关

命令作用
npm run content:sync同步 blog + travel 内容到数据库
npm run content:sync:dry同步预演（不写数据库）
npm run travel:images生成/处理 travel 图片产物
npm run travel:images:drytravel 图片处理预演
npm run travel:mdx-docs生成 travel MDX 组件文档

​
常用组合

​
新环境初始化

npm install
npm run db:up
npm run db:generate
npm run db:migrate
npm run content:sync
npm run dev

​
提交前验证

npm run lint
npm run test
npm run build