由于收到 DMCA 下架通知, 本仓库的原始代码已被移除,

Photo View 图片墙

基于 React + Next.js 的图片查看器前端应用。 提供瀑布流展示和图片预览等功能。

需要的后端接口

在 /dashboard 页面中配置自己的后端地址

一个适配了本项目的 后端

1. 获取联系人列表

GET /v1/contacts

用途：初始化联系人选择器

返回：

{
  "count": 10,
  "contacts": ["张三", "李四"]
}

3. 同步照片元数据

POST /v1/sync/{user}?month=2025-01

用途：同步数据

返回：

{
  "user": "张三",
  "synced": 1234
}

4. 获取照片元数据列表

GET /v1/photos/{user}/metadata

用途：获取图片列表和尺寸信息

返回：

{
  "user": "张三",
  "count": 50,
  "metadata": [
    {
      "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "name": "mmexport1234567890123",
      "width": 1920,
      "height": 1080
    }
  ]
}

5. 获取照片规格列表

GET /v1/metadata/{uuid}

用途：获取单张照片的可用规格（缩略图/常规/原图）

返回：

{
  "uuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "count": 3,
  "metadata": [
    {
      "spec": "thumb",
      "mode": "default"
    },
    {
      "spec": "regular",
      "mode": "default"
    },
    {
      "spec": "original",
      "mode": "default"
    }
  ]
}

6. 获取图片文件

GET /v1/photos/{uuid}?spec=regular&mode=default

用途：加载实际图片

查询参数：

• spec: 规格（thumb | regular | original）
• mode: 模式（default | legacy | plain）

返回：图片文件（image/jpeg）