Skip to content

Latest commit

 

History

History
74 lines (53 loc) · 3.56 KB

Declaration_zh.md

File metadata and controls

74 lines (53 loc) · 3.56 KB

声明

图片上传限制

  • Vercel Free Plan 限制:单张图片超过 4.5MB 将无法上传。
  • 自动转化 WebP:
    • 上传超过 4.4MB 的图片将自动转为 WebP 格式;若仍超出,将进行强制压缩,最终失败时会报错。
    • 若不希望转化为 WebP,可手动开启压缩功能自行处理;手动压缩后仍超出 4.4MB 的图片将判定为上传失败。

上传时间限制

  • 10 秒限制:单次上传时间限制为 10 秒。
    • 上传文件过多或网络延迟可能导致失败,并弹出 uploadserror 提示。
    • 此问题由 Vercel 限制引起,失败文件可根据提示重新上传。

流量与加载说明

  • 上传调用 Vercel 后端 API,图片加载通过客户端直接访问存储桶(如 R2),无需担忧流量超限。
  • 模糊预览与加载优化:
    • 图片加载时优先显示 thumbs 文件夹中的预览图(最大尺寸为 200px,WebP 格式);若无预览图,则加载原图。
    • 上传时可直接预览原图,避免加载原图导致的缓存压力。

文件命名与重复处理

  • 后缀名一致:开启 WebP 转化后,文件后缀名保持与源图片一致,但 MIME 格式为 WebP,这是故意为之,避免同名不同格式的重复上传。
  • 自动添加序号:重复上传的文件会在文件名后添加序号(如 logo_1.pnglogo_2.png)。

应用功能与限制

  • 单用户设计:仅适用于个人使用,不支持多用户场景。若需多用户支持,可在 Vercel 上重复部署。
  • 收藏功能:
    • 收藏的图片在存储桶中生成标记文件(不占用空间)。
    • 管理页面提供“展示收藏图片”开关(默认关闭),便于查看和删除收藏图片。
  • 上传与下载:
    • 不支持批量下载,仅可通过直链单独下载图片;批量下载建议使用 Alist。

数据安全与隐私

  • 无数据库依赖:图片数据通过 CDN 转链,存储于 S3。即使页面失效,图片仍可正常访问。
  • 文件安全性:环境变量存储在 Vercel,数据需经过授权才可访问。图片 CDN 与页面地址独立,链接可自由分享。
  • 图床安全:不建议分享部署后的图床链接,因为暂未对图床登录进行更强的加密方式。但图片的链接可以分享的,因为它独立依赖于CDN。

其他说明

  • 图床响应速度:上传或删除图片后需重新获取元数据,受限于 Vercel 和 S3,已尽可能优化响应速度。

  • 压缩率配置

    :默认压缩率为 0.85,WebP 优化率为 0.9,代码位置:

    components/ImageUploader.tsx
    
    • 第 50 行调整压缩率
    • 第 74 行调整 WebP 优化率
  • 登录页面背景:可自定义背景图片,路径:/app/login/page.tsx 第 18 行。 默认背景

    const [bgImage, setBgImage] = useState<string | null>('null')
    

    自定义背景

    const [bgImage, setBgImage] = useState<string | null>('https://example.com/background.png')
    

使用心得与建议

  1. 收藏功能设计
    • 管理页面仅提供 “收藏”和“删除” 功能,默认隐藏收藏图片。使用showlikes开关会显示收藏图片,界面设计突出了其样式,提醒用户避免误操作。
    • 取消收藏需在“收藏页面”完成,通过多步操作确认关键操作。
  2. 上传后的收藏:上传图片后可直接点击“收藏”标记,若后悔可立即取消收藏,符合用户使用逻辑。