# FileNameTranslator

**Repository Path**: GUANJIANCIGJIAC/FileNameTranslator

## Basic Information

- **Project Name**: FileNameTranslator
- **Description**: 在日常工作中，我们经常会遇到大量英文文件名的文件需要整理，手动翻译不仅效率低下，还容易出现不一致的问题。本文将介绍如何使用 Java 结合 LangChain4j 框架开发一款文件名 AI 翻译助手，实现批量翻译、自动过滤含中文文件、配置管理等功能，帮助你高效处理多语言文件命名问题。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-05
- **Last Updated**: 2025-11-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 文件名AI翻译助手

## 项目简介

文件名AI翻译助手是一款使用Java开发的桌面应用程序，能够帮助用户批量将英文文件名为中文。该应用利用AI接口智能识别并翻译文件名，特别擅长处理包含缩写、专业术语的文件名，解决了人工翻译效率低、专业术语翻译不准确的问题。

## 核心功能

1. **批量文件处理**：支持读取指定文件夹下的所有文件
2. **AI智能翻译**：调用OpenAI API进行智能翻译，处理缩写和专业术语
3. **翻译结果预览**：直观展示原文件名和翻译后的文件名
4. **批量重命名**：一键将翻译结果应用到实际文件
5. **翻译对照表导出**：支持将翻译结果导出为CSV文件
6. **模型切换**：支持在主界面设置上切换模型

## 界面特点

- **简洁直观**：采用现代化的Java Swing界面，操作简单
- **拖放功能**：支持直接拖拽文件夹到应用窗口
- **实时进度**：翻译过程中显示进度条和详细日志
- **结果清晰**：表格形式展示翻译结果和状态

## 安装与配置

### 环境要求

- Java 8 或更高版本
- Maven 3.6 或更高版本（用于构建项目）

### 配置步骤

1. **下载项目**：克隆或下载本项目到本地
2. **配置API**：编辑 `src/main/resources/config.properties` 文件，填入你的OpenAI API信息
   ```properties
   openai.api-key=你的API密钥
   openai.base-url=API基础URL
   openai.model=使用的模型名称
   openai.temperature=0.7
   openai.timeout=60000
   ```
3. **构建项目**：使用Maven构建项目
   ```bash
   mvn clean package
   ```

## 使用方法

### 基本操作流程

1. **选择文件夹**：
   - 点击"浏览"按钮选择要处理的文件夹
   - 或直接将文件夹拖拽到应用窗口中

2. **开始翻译**：
   - 点击"开始翻译"按钮，系统将自动翻译所有文件名
   - 翻译过程中会显示进度条，翻译完成后会有提示

3. **查看结果**：
   - 在表格中查看原文件名和翻译后的文件名
   - 状态列显示"已翻译"、"翻译失败"或"待翻译"

4. **批量重命名**：
   - 确认翻译结果无误后，点击"批量重命名"按钮
   - 系统会将翻译后的文件名应用到实际文件

5. **导出对照表**：
   - 点击"导出对照表"按钮，将翻译结果导出为CSV文件
   - 可选择保存路径和文件名

### 注意事项

1. **API费用**：使用OpenAI API会产生相应费用，请确保你的账户有足够余额
2. **翻译时间**：翻译时间取决于文件数量和API响应速度
3. **文件备份**：重命名操作不可撤销，建议在操作前备份重要文件
4. **特殊字符**：文件名中的特殊字符可能会影响翻译结果，请留意

## 技术实现

### 核心模块

1. **主界面**：FileNameTranslator.java - 实现Swing界面和用户交互
2. **翻译服务**：OpenAITranslationService.java - 调用OpenAI API进行翻译
3. **文件处理**：FileInfo.java - 存储文件信息和翻译结果
4. **表格模型**：FileTableModel.java - 展示文件列表和翻译结果
5. **导出服务**：ExportService.java - 将翻译结果导出为CSV文件

### 技术栈

- Java 8
- Swing (桌面应用界面)
- Maven (项目构建和依赖管理)
- FastJSON (JSON解析)
- OpenAI API (智能翻译)

## 常见问题

### Q1: 翻译失败怎么办？

A1: 请检查以下几点：
- API密钥是否正确配置
- API服务是否可用
- 网络连接是否正常
- 文件名是否包含特殊字符

### Q2: 如何提高翻译准确性？

A2: 可以尝试调整以下参数：
- 修改temperature值（0.0-1.0），较低的值更保守，较高的值更多样化
- 检查并更新API模型配置
- 确保文件名格式规范

### Q3: 支持子文件夹处理吗？

A3: 当前版本只处理选定文件夹下的直接文件，不包含子文件夹。如需处理子文件夹，请将其单独添加。

## 许可证

MIT License