WebUI 使用指南

登录与认证

首次访问

打开浏览器访问 AstrNest 前端地址（默认：http://localhost:3000）
如果是首次使用，系统会提示创建管理员账户
填写管理员信息并完成注册

用户认证

管理员账户: 拥有所有权限，可以管理用户和系统设置
普通用户: 只能管理自己的图片和相册
访客模式: 只读权限，可以浏览公开图片

仪表板概览

首页仪表板

上传统计: 显示总上传量、今日上传量、存储使用情况
最近上传: 显示最近上传的图片列表
系统状态: 显示服务器状态、数据库连接状态
快速操作: 一键上传、创建相册、查看统计

导航菜单

首页: 系统概览和快速操作
图片管理: 管理所有上传的图片
相册管理: 创建和管理图片相册
用户管理 (仅管理员): 管理用户账户和权限
系统设置 (仅管理员): 配置系统参数

图片上传

单文件上传

点击"上传"按钮或拖拽文件到上传区域
选择要上传的图片文件（支持 JPG、PNG、GIF、WebP）
设置图片标题、描述和标签（可选）
选择相册（可选）
点击"上传"完成操作

批量上传

点击"批量上传"按钮
选择多个图片文件（支持最多 50 个文件）
设置统一的标题前缀和标签
系统会自动为每个文件生成唯一标识
上传过程中显示进度和状态

上传选项

图片压缩: 自动压缩大图片以减少文件大小
水印添加: 为图片添加自定义水印
隐私设置: 设置图片为公开或私有
CDN 加速: 启用 CDN 加速图片访问

图片管理

图片列表

网格视图: 以网格形式显示所有图片
列表视图: 以列表形式显示详细信息
筛选功能: 按日期、大小、类型、标签筛选
搜索功能: 按标题、描述、标签搜索图片

图片操作

查看详情: 点击图片查看详细信息
编辑信息: 修改标题、描述、标签
下载图片: 下载原图或压缩版本
分享链接: 复制图片直链或分享代码
删除图片: 删除不需要的图片

批量操作

批量选择: 选择多个图片进行操作
批量删除: 删除选中的多个图片
批量移动: 将图片移动到指定相册
批量标签: 为多个图片添加相同标签

相册管理

创建相册

点击"创建相册"按钮
输入相册名称和描述
设置相册封面（可选）
设置相册权限（公开/私有）
保存相册设置

管理相册

添加图片: 将图片添加到相册
移除图片: 从相册中移除图片
编辑信息: 修改相册名称和描述
设置封面: 选择相册封面图片
删除相册: 删除整个相册

相册分享

公开相册: 任何人都可以查看
私有相册: 只有相册创建者可以查看
分享链接: 生成相册分享链接
嵌入代码: 获取相册嵌入代码

用户管理（管理员功能）

用户列表

查看所有注册用户
查看用户基本信息（用户名、邮箱、注册时间）
查看用户上传统计
管理用户状态（启用/禁用）

权限管理

管理员权限: 授予用户管理员权限
上传权限: 控制用户上传权限
存储限制: 设置用户存储空间限制
API 权限: 控制用户 API 访问权限

系统设置（管理员功能）

基本设置

站点名称: 设置网站显示名称
站点描述: 设置网站描述信息
Logo 设置: 上传网站 Logo
主题设置: 选择界面主题颜色

上传设置

文件大小限制: 设置最大上传文件大小
文件类型限制: 设置允许上传的文件类型
图片质量设置: 设置图片压缩质量
水印设置: 配置图片水印

安全设置

用户注册: 启用/禁用用户注册功能
API 访问: 配置 API 访问权限
速率限制: 设置 API 调用频率限制
日志设置: 配置系统日志记录

快捷键操作

通用快捷键

Ctrl/Cmd + U: 打开上传对话框
Ctrl/Cmd + F: 聚焦搜索框
Ctrl/Cmd + S: 保存当前编辑
Esc: 关闭对话框或取消操作

图片浏览快捷键

← →: 上一张/下一张图片
Space: 播放/暂停幻灯片
F: 切换全屏模式
Z: 缩放图片到适合大小

移动端使用

响应式设计

AstrNest WebUI 完全支持移动端访问：

自适应布局: 根据屏幕尺寸自动调整布局
触摸优化: 优化触摸操作体验
手势支持: 支持缩放、滑动等手势操作
离线支持: 支持离线浏览已缓存的图片

移动端功能

相机上传: 直接使用手机相机拍照上传
地理位置: 为图片添加地理位置信息
分享功能: 一键分享图片到社交平台
推送通知: 接收上传完成等系统通知