# VSee

**Repository Path**: joqson/vsee

## Basic Information

- **Project Name**: VSee
- **Description**: VSee 图库
一款轻量级的 Android 本地图库应用，支持 HarmonyOS 3 和 HyperOS 3 系统。

功能特性
📁 文件夹管理
网格/列表视图切换 - 两种显示模式自由切换
文件夹缩略图 - 3x3 网格布局，第一张图片占 2x2 区域
排序功能 - 支持按名称/时间 升序/降序排序
隐藏文件夹 - 长按选择文件夹进行隐藏，隐藏的文件夹移至"隐藏项"标签页
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: HarmonyOS3
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-06
- **Last Updated**: 2026-04-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# VSee 图库

一款轻量级的 Android 本地图库应用，支持 HarmonyOS 3 和 HyperOS 3 系统。

## 功能特性

### 📁 文件夹管理
- **网格/列表视图切换** - 两种显示模式自由切换
- **文件夹缩略图** - 3x3 网格布局，第一张图片占 2x2 区域
- **排序功能** - 支持按名称/时间 升序/降序排序
- **隐藏文件夹** - 长按选择文件夹进行隐藏，隐藏的文件夹移至"隐藏项"标签页
- **隐藏项管理** - 点击隐藏项可打开查看图片，也可恢复取消隐藏

### 🖼️ 图片浏览
- **全屏显示** - 沉浸式图片浏览体验
- **手势缩放** - 双指缩放、单指拖动
- **滑动切换** - 左右滑动切换图片
- **双击缩放** - 双击在 100% 和适应屏幕之间切换
- **惯性滚动** - 快速滑动后的平滑动画效果
- **边界检查** - 图片边缘不会离开屏幕边界

### 🎬 幻灯片播放
- **自动播放** - 2 秒间隔自动切换图片
- **手动控制** - 仅支持手动停止
- **状态保持** - 退出幻灯片后保持当前图片位置
- **智能暂停** - 放大/缩小/拖动时自动暂停，恢复初始状态后继续播放

### 🎨 壁纸设置
- **锁屏壁纸** - 设置锁屏壁纸
- **桌面壁纸** - 设置桌面壁纸
- **同时设置** - 同时设置锁屏和桌面壁纸
- **权限引导** - HyperOS/MIUI 系统自动引导开启壁纸权限

### 📷 相机功能
- **拍照** - 直接拍摄照片
- **存储位置** - 照片保存在 DCIM/VSee 目录

### 🔍 二维码扫描
- **快速扫描** - 支持各种二维码格式
- **扫描动画** - 动态扫描线效果
- **手势缩放** - 扫描时支持手势缩放相机预览
- **缩放按钮** - 提供缩放控制按钮

### 🔎 搜索功能
- **图片搜索** - 搜索设备中的图片

### 🔐 密码保护
- **压缩文件密码保护** - 进入压缩文件页面需要密码验证
- **隐藏项密码保护** - 进入隐藏项页面需要密码验证
- **设置密码验证** - 切换密码保护开关时需要验证密码
- **ZIP 加密** - 压缩文件夹时支持设置密码

### 📦 压缩功能
- **文件夹压缩** - 将文件夹压缩为 ZIP 文件
- **密码加密** - 支持设置压缩密码
- **批量压缩** - 支持批量压缩多个文件夹
- **批量解压** - 支持批量解压 ZIP 文件
- **智能命名** - 自动避免重复文件名

## 系统要求

- Android 6.0 (API 23) 或更高版本
- 支持 HarmonyOS 3
- 支持 HyperOS 3

## 权限说明

| 权限 | 用途 |
|------|------|
| READ_EXTERNAL_STORAGE | 读取图片文件 |
| WRITE_EXTERNAL_STORAGE | 保存照片 |
| READ_MEDIA_IMAGES | Android 13+ 读取图片 |
| CAMERA | 相机拍照和二维码扫描 |
| SET_WALLPAPER | 设置壁纸 |

## 项目结构

```
app/src/main/java/com/vsee/gallery/
├── MainActivity.java           # 主界面
├── ImageDetailActivity.java    # 图片详情界面
├── ImageListActivity.java      # 图片列表界面
├── QRScannerActivity.java      # 二维码扫描界面
├── SearchActivity.java         # 搜索界面
├── ZipFilesFragment.java       # 压缩文件列表
├── HiddenFoldersFragment.java  # 隐藏文件夹列表
├── HiddenFoldersActivity.java  # 隐藏文件夹页面
├── FoldersFragment.java        # 文件夹列表
├── AllImagesFragment.java      # 全部图片列表
├── ImagePagerAdapter.java      # 图片滑动适配器
├── FolderAdapter.java          # 文件夹网格适配器
├── SelectableFolderAdapter.java # 可选择文件夹适配器
├── HiddenFolderAdapter.java    # 隐藏文件夹适配器
├── ZipFolderAdapter.java       # 压缩文件适配器
├── ImageGridAdapter.java       # 图片网格适配器
├── HarmonyOSImageScanner.java  # 图片扫描工具
└── ZipManager.java             # ZIP 压缩管理
```

## 编译安装

### 编译项目
```bash
./gradlew assembleDebug
```

### 安装到设备
```bash
adb install -r app/build/outputs/apk/debug/app-debug.apk
```

## Git 分支

- **main** - 主分支
- **HarmonyOS3** - HarmonyOS 3 适配分支
- **HyperOS3** - HyperOS 3 适配分支

## 界面预览

### 主界面
- 黑色背景，鲜红色文字
- 文件夹缩略图带白色边框
- 透明间隙

### 图片浏览
- 全屏显示
- 半透明工具栏（自动隐藏）
- 显示文件名和图片位置

### 壁纸设置对话框
- 居中显示
- 宽度为屏幕的 1/3
- 圆角设计

## 技术特点

- **MediaStore API** - 使用系统 MediaStore 查询图片
- **ViewPager2** - 流畅的图片滑动体验
- **Matrix 变换** - 精确的图片缩放和位置控制
- **GestureDetector** - 手势识别
- **ValueAnimator** - 自定义惯性动画
- **ZXing** - 二维码扫描
- **WallpaperManager** - 壁纸设置
- **Zip4j** - ZIP 文件加密压缩和解压
- **SharedPreferences** - 本地设置存储

## 特殊适配

### HarmonyOS 3
- 传统权限模型
- MediaStore 兼容查询

### HyperOS 3
- 全屏显示优化
- 壁纸权限引导
- 安全访问适配

## 开发环境

- Android Studio
- Java 8+
- Gradle 8.0+
- minSdkVersion 23
- targetSdkVersion 34

## 许可证

本项目仅供学习和研究使用。