# qfa-tools

**Repository Path**: zhouzq2046/qfa-tools

## Basic Information

- **Project Name**: qfa-tools
- **Description**: No description available
- **Primary Language**: Java
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-01
- **Last Updated**: 2026-05-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Qz-One项目框架构快速构建工具

本项目是Qz-One项目的核心工具，包括项目创建、代码生成器和文件分发功能。

## 版本历史

参见[QFA-Tools User Manual](release.md)

## 构建与发布

使用 Maven 构建：

```shell
# 构建
mvn clean verify

# 发布到Nexus
mvn clean package deploy
```

打包产物位于 `target/` 目录。

## 使用说明

详细使用说明参见[QFA-Tools User Manual](release.md)

## 设计说明

### 编码检测

使用BOM标记和字符频率分析自动检测文件编码，支持：
- UTF-8（带或不带BOM）
- UTF-16（大端序和小端序）
- GBK/GB2312
- ISO-8859-1

### 文本文件识别
通过文件扩展名和编码检测结果判断是否为文本文件，确保：
- 文本文件正确处理编码和换行符
- 二进制文件完整复制，不做任何修改

### 错误处理
完善的错误处理机制：
- 文件访问权限问题
- 磁盘空间不足
- 编码检测失败
- 路径构建错误

## 支持

如遇到问题，请：
1. 翻阅本说明文档的相关章节
2. 检查工具的输出日志信息
3. 确保环境配置正确