​
工作目录

所有命令默认在以下目录执行： ~/web/gump-website

​
常用命令

目标命令
安装依赖npm install
启动开发服务器npm run dev
生产构建npm run build
启动生产模式npm run start
全量 lintnpm run lint
全量测试npm run test
启动数据库npm run db:up
停止数据库npm run db:down
数据库日志npm run db:logs
Prisma Clientnpm run db:generate
开发迁移npm run db:migrate
内容同步npm run content:sync
内容同步预演npm run content:sync:dry

​
推荐本地开发流程

1

同步代码并安装依赖

执行 npm install，保证 lockfile 和 node_modules 一致。
2

启动数据库并迁移

执行 npm run db:up、npm run db:generate、npm run db:migrate。
3

启动开发服务器

执行 npm run dev，在 http://localhost:3000 验证页面。
4

开发完成后验证

依次执行 npm run lint、npm run test、npm run build。

​
单测执行方式

测试运行器是 tsx --test。 执行单个文件： 
npm run test -- tests/blog/frontmatter.test.ts
按名称匹配执行： 
npm run test -- --test-name-pattern="normalize tags trim and dedupe"

​
目录与职责

  • app/: Next.js App Router 路由
  • components/: 组件实现
  • content/: MDX 内容源与 travel JSON
  • lib/: 业务逻辑、解析器、仓储与同步逻辑
  • scripts/: 运维和内容脚本
  • prisma/: 数据模型与迁移
  • tests/: 单元测试与行为测试

​
文档协作建议

当你修改功能时，建议同步更新以下文档页面：
  • 新增/修改命令：/reference/scripts
  • 新增/修改环境变量：/reference/environment-variables
  • 新增/修改路由：/reference/routes
  • 新增/修改后台接口：/api-reference/introduction 与对应 endpoint 页面
首次接手本仓库时，请先按你团队约定更新 gump-website-docs/AGENTS.md，避免后续协作风格不一致。