V2ault

面向个人创作流程的 AI 视觉资产库：把生成图片、Prompt 与风格信息放在一起，方便回看、筛选和整理。

核心能力

• 瀑布流浏览与图片详情查看，适配桌面与移动端
• 按 Prompt、文件名、路径、分辨率、模型、风格与收藏状态检索
• 上传图片并编辑 Prompt、模型、风格等元数据
• 支持多选、批量编辑、下载、收藏与移入回收站
• 回收站可恢复图片或永久删除
• 管理员/访客模式：上传和删除操作受密码保护

技术栈

• Next.js 16、React 19、TypeScript、Tailwind CSS
• PostgreSQL、阿里云 OSS
• Sharp、BlurHash、Framer Motion

本地启动

git clone https://github.com/Shanzoon/V2ault.git
cd V2ault
pnpm install
cp .env.local.example .env.local

在 .env.local 至少配置：

DATABASE_URL=postgresql://user:password@localhost:5432/v2ault
OSS_REGION=oss-cn-hangzhou
OSS_BUCKET=your-bucket-name
OSS_ACCESS_KEY_ID=your-access-key-id
OSS_ACCESS_KEY_SECRET=your-access-key-secret
ADMIN_PASSWORD=your_secure_password

OSS_ENDPOINT 可用于自定义 OSS Endpoint；UPLOAD_MAX_SIZE 可调整上传大小限制（默认 20MB）。

pnpm db:init
pnpm dev

然后访问 http://localhost:3000。

常用命令

pnpm dev          # 启动本地开发服务器
pnpm build        # 构建生产版本
pnpm start        # 启动生产服务器
pnpm lint         # 运行 ESLint
pnpm test:run     # 运行一次测试
pnpm db:init      # 初始化数据库表

许可证

MIT