需求

• 最好用linux开发，window可以用wsl

文档

• nuxt4目录结构
• nuxt4 API
• nitro 文档
• drizzle 文档

提醒

用 Linux 开发与部署，包管理器采用 bun@1.3.11。数据库为 postgres（通过 DATABASE_URL 连接；本地可参考 .env.example 复制为 .env.local）。部署时可直接打包 .output 目录，在服务器环境执行迁移命令，省时省力。

部署

提供最简单的部署方式：

1. bun run build
2. 进入.output文件夹
3. 编辑.env环境变量
4. sh run.sh 不采用重量级的docker，可以直接打包.output到服务器部署，数据库目前只支持sqlite。

用户数据导出 API

已登录用户可通过以下接口发起并获取导出结果：

1. POST /api/me/export/request

   • 用途：创建导出任务并异步执行。
   • 请求体：{ "maskPolicy": "masked" | "raw" }（可省略，默认 masked）。
   • 返回示例：{ "code": 0, "data": { "taskId": 123, "status": "pending" } }

2. GET /api/me/export/tasks

   • 用途：查询当前用户导出任务列表。
   • 返回数据包含：id、status、maskPolicy、outputName、totalBytes、errorCode、errorMessage、createdAt、updatedAt、expiresAt。

3. GET /api/me/export/tasks/:id/download

   • 用途：下载已完成任务的 manifest.json。
   • 说明：仅可下载当前用户自己的任务；任务未完成会返回 409，已过期返回 410。