# file-manage-java

**Repository Path**: chiying/file-manage-java

## Basic Information

- **Project Name**: file-manage-java
- **Description**: java客户端，遍历和查看文件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-04
- **Last Updated**: 2026-03-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 极简文件管理

一个跨平台的桌面文件管理工具，基于 JavaFX 构建，采用 Apple 风格的现代 UI 设计。

## 功能特性

- **文件扫描** - 选择文件夹递归扫描，支持按类型筛选（图片/视频/文档/音频/压缩包）
- **MD5 去重** - 扫描时自动计算文件 MD5，防止重复录入；移动时可选剔除重复文件
- **文件浏览** - 网格缩略图展示，支持按类别、月份、标签、关键词分页查询
- **文件操作** - 打开、移动、复制、删除，支持批量删除和全部清空
- **标签系统** - 为文件添加自定义彩色标签，按标签筛选
- **按时间整理** - 扫描后可自动按年/月归类到目标文件夹
- **深色模式** - 一键切换亮色/暗色主题
- **原生打包** - 通过 jpackage 生成免安装 Java 的原生安装包

## 技术栈

| 技术 | 用途 |
|------|------|
| Java 17+ | 运行时 |
| JavaFX 21 | GUI 框架 |
| SQLite | 嵌入式数据库 |
| Thumbnailator | 缩略图生成 |
| Maven | 构建工具 |
| jpackage | 原生打包 |

## 快速开始

### 前置要求

- JDK 17 或更高版本
- Maven 3.9+（项目内已包含可用的 `apache-maven-3.9.6`）

### 开发运行

```bash
mvn javafx:run
```

### 编译

```bash
mvn clean compile
```

### 打包为原生安装包

Windows:
```bash
packaging\package.bat
```

macOS / Linux:
```bash
bash packaging/package.sh
```

生成的安装包位于 `target/installer/` 目录，用户无需安装 Java 即可直接运行。

## 项目结构

```
src/main/java/com/filemanager/
├── App.java / AppLauncher.java     # 应用入口
├── config/                         # 配置
├── model/                          # 数据模型
├── database/                       # SQLite DAO
├── service/                        # 业务逻辑（扫描/缩略图/文件操作）
├── controller/                     # UI 控制器
├── view/                           # 自定义 UI 组件
└── util/                           # 工具类
```

## 支持平台

- Windows 10/11
- macOS 12+
- Linux (Ubuntu, Fedora 等主流发行版)