package.json

根 package.json 内 scripts 段的全部命令，按用途分组

在 site.config.ts、.env 与设置三节介绍的是「可修改的字段」，本节列出「可执行的命令」，全部来自根 package.json 的 scripts 段。所有命令均通过 bun run <name> 执行。

开发与构建

命令	说明
`bun run dev`	启动 Nuxt 开发服务器，app 与 nitro 同起
`bun run generate`	在 build 的基础上额外预渲染页面
`bun run preview`	预览构建产物
`bun run serve`	本地附件文件服务（服务仓库根的 `.attachments/` 目录，端口 3030）
`bun run build`	生产构建（= `nuxt build`），postbuild 会自动跑
`bun run postbuild`	`bun scripts/copy-data.ts && bun scripts/update-sw-cdn.ts`，构建后自动执行
`bun run postinstall`	`nuxt prepare`，在 `bun install` 后自动执行
`bun run export:bundle`	从 Docker 镜像内导出构建产物到宿主机的 `dist/`

校验与测试

命令	说明
`bun run check`	依次执行 lint、typecheck 与 tailwindcss:lint 三项校验
`bun run lint`	ESLint 全仓校验，警告视为失败，不包含 `mini/` 子项目
`bun run lint:fix`	ESLint 自动修复
`bun run typecheck`	Nuxt 端到端类型检查
`bun run test`	运行 `test/` 下的单元与集成测试，参数透传给 bun test
`bun run test:e2e`	运行 Playwright 端到端测试
`bun run test:e2e:smoke`	只运行第三方服务冒烟用例
`bun run test:e2e:install`	安装 `test/` 子包依赖，首次运行测试或 E2E 前执行一次

数据库

命令	说明
`bun run db:init`	数据库初始化，建表、写入默认设置、插入种子数据
`bun run prisma:generate`	生成 Prisma 客户端
`bun run prisma:studio`	打开 Prisma 图形化界面

部署与运维

命令	说明
`bun run nginx:generate`	生成 nginx 配置片段（带 / 不带 CDN 重定向）
`bun run upload:cos`	把静态资源上传到腾讯云 COS
`bun run upload:server`	把构建产物上传到目标服务器（SSH）
`bun run restart:server`	通过宝塔面板重启 Node 项目
`bun run clear:redis`	清空 Redis；清空的是该实例的全部 16 个库，不只是本站的缓存

数据维护

命令	说明
`bun run compress:livephoto`	压缩实况照片（用 ffmpeg）
`bun run reset:password`	重置管理员密码
`bun run reset:2fa`	重置两步验证
`bun run get:ip`	查询 IP 归属地（参数传一个或多个 IP）
`bun run check:update`	检查依赖更新
`bun run tailwindcss:lint`	Tailwind 样式校验

子包

命令	说明
`bun run scripts:install`	安装 `scripts/` 子包依赖；首次运行 scripts 相关命令前需执行一次

小程序

小程序是 git 子模块，位于 mini/，有自己的 package.json。这些命令进入 mini/ 后再调用子包自己的 bun run：

命令	说明
`bun run mini:dev:h5`	小程序 H5 端开发
`bun run mini:dev:mp-weixin`	微信小程序开发
`bun run mini:dev:mp-alipay`	支付宝小程序开发
`bun run mini:build:h5`	小程序 H5 端构建
`bun run mini:build:mp-weixin`	微信小程序构建
`bun run mini:build:mp-alipay`	支付宝小程序构建
`bun run mini:type-check`	小程序类型校验
`bun run mini:lint`	小程序 lint