# 9255555工具集

**Repository Path**: Jeanbin/9255555-toolset

## Basic Information

- **Project Name**: 9255555工具集
- **Description**: No description available
- **Primary Language**: NodeJS
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 1
- **Created**: 2025-12-23
- **Last Updated**: 2026-01-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 9255555-toolset

一个基于 Node.js + Express 的开发者工具集合，提供多种实用的开发辅助工具，帮助开发者提升开发效率。
演示站点：https://tool.9255555.xyz/

## 功能特点

### 1. Java 代码生成器
- **数据库表结构自动生成 Java 代码**
  - 支持连接 MySQL 数据库
  - 自动生成 Entity（实体类）、Controller、Service、ServiceImpl、Mapper、Mapper XML、VO、BO 等完整代码
  - 支持 MyBatis 和 MyBatis-Plus 两种模式
  - 支持分页功能配置
  - 自动映射 MySQL 数据类型到 Java 数据类型
  - 生成的代码遵循 Maven 标准目录结构
  - 支持自定义包名和路径配置
  - 一键打包下载为 ZIP 文件

### 2. 编码修复工具
- **智能修复乱码文本**
  - 支持多种编码格式自动检测和修复（GBK、GB2312、GB18030、Big5、Latin1、ISO-8859-1 等）
  - 支持双重编码、三重编码等复杂情况的修复
  - 智能评分机制，自动选择最佳修复方案
  - 支持按行处理长文本
  - 提供修复质量评分和使用的编码信息

### 3. AI 聊天工具
- **集成 OpenAI 兼容 API**
  - 支持流式输出，实时显示 AI 回复
  - 支持自定义 API Key 和 Base URL
  - 支持多模型切换
  - 支持对话历史管理
  - 可配置多个 AI 服务提供商

### 4. JSON 转 Java 实体
- **JSON 数据转换为 Java 实体类**
  - 自动分析 JSON 结构
  - 生成对应的 Java 实体类代码
  - 支持嵌套对象和数组处理

## 技术栈

- **后端框架**: Express.js
- **数据库**: MySQL2 (用于代码生成器)
- **编码处理**: iconv-lite
- **文件压缩**: archiver
- **AI 集成**: OpenAI SDK
- **前端技术**: Vue.js 3 + Element Plus
- **进程管理**: PM2

## 安装步骤

### 1. 克隆项目

```bash
git clone <repository-url>
cd 9255555-toolset
```

### 2. 安装依赖

```bash
npm install
```

### 3. 配置环境

项目使用环境变量配置，可以通过 `.env` 文件或系统环境变量进行配置：

```bash
# 可选：创建 .env 文件
NODE_ENV=development
PORT=3000
```

### 4. 配置 AI 服务（可选）

编辑 `src/config/AIconf.json` 文件，配置 AI 服务信息：

```json
[
  {
    "model": "gpt-3.5-turbo",
    "apiKey": "your-api-key",
    "baseUrl": "https://api.openai.com/v1"
  }
]
```

### 5. 启动项目

**开发模式**:
```bash
npm run dev
```

**生产模式**:
```bash
npm start
```

**使用 PM2 管理**:
```bash
npm run pm2
```

项目默认运行在 `http://localhost:3000`

## 使用说明

### Java 代码生成器

1. 访问 `http://localhost:3000/java/codeGenerator`
2. 填写数据库连接信息（主机、端口、数据库名、用户名、密码）
3. 点击"连接数据库"验证连接
4. 选择要生成代码的数据表
5. 配置生成选项：
   - 实体类名
   - Java 包名
   - 各层路径配置
   - 选择要生成的代码类型
   - 选择 MyBatis 类型（MyBatis 或 MyBatis-Plus）
   - 是否启用分页功能
6. 点击"生成代码"下载 ZIP 压缩包

### 编码修复工具

1. 访问 `http://localhost:3000/trueEncode`
2. 粘贴需要修复的乱码文本
3. 点击"修复编码"
4. 查看修复结果，系统会显示：
   - 修复后的文本
   - 使用的编码方式
   - 修复质量评分

### AI 聊天工具

1. 访问 `http://localhost:3000/ai/2chat`
2. 配置 AI 服务信息（API Key、Base URL、模型）
3. 开始对话，支持流式输出

### JSON 转 Java 实体

1. 访问 `http://localhost:3000/java/tools/JSONConverterToJavaEntity`
2. 输入或粘贴 JSON 数据
3. 配置实体类名和包名
4. 生成 Java 实体类代码

## 项目结构

```
9255555-toolset/
├── bin/                    # 启动脚本
│   └── www                # Express 应用入口
├── logs/                   # 日志文件目录
├── node_modules/           # 依赖包
├── public/                 # 静态资源
│   ├── libs/              # 第三方库（Vue、Element Plus 等）
│   └── stylesheets/       # 样式文件
├── routes/                 # 路由文件
│   ├── index.js           # 首页路由
│   ├── java.js            # Java 代码生成器 API
│   ├── javatool.js        # Java 工具页面路由
│   ├── basetools.js       # 编码修复工具 API
│   ├── openai.js          # AI 聊天 API
│   └── users.js           # 用户相关路由
├── src/
│   ├── config/            # 配置文件
│   │   └── AIconf.json   # AI 服务配置
│   ├── templates/         # 代码生成模板
│   │   └── java/         # Java 代码模板
│   └── views/            # 前端页面
│       ├── index.html    # 工具站首页
│       ├── basetools/    # 基础工具页面
│       ├── java/         # Java 工具页面
│       └── openai/       # AI 聊天页面
├── app.js                 # Express 应用主文件
├── ecosystem.config.js    # PM2 配置文件
├── package.json           # 项目配置和依赖
└── README.md             # 项目说明文档
```

## API 接口

### Java 代码生成器

- `POST /api/java/connect` - 验证数据库连接
- `POST /api/java/tables` - 获取数据库表列表
- `POST /api/java/fields` - 获取表字段信息
- `POST /api/java/generate` - 生成代码并下载 ZIP

### 编码修复工具

- `GET /trueEncode` - 编码修复工具页面
- `POST /trueEncode/fix` - 修复编码接口

### AI 聊天

- `GET /ai/2chat` - AI 聊天页面
- `GET /ai/model/list` - 获取模型列表
- `POST /ai/chat` - 普通聊天接口
- `POST /ai/chat/stream` - 流式聊天接口

## 配置说明

### PM2 配置

项目包含 PM2 配置文件 `ecosystem.config.js`，支持生产环境部署：

```bash
# 启动
pm2 start ecosystem.config.js --env production

# 查看状态
pm2 status

# 查看日志
pm2 logs

# 停止
pm2 stop clwy-api
```

### 端口配置

默认端口为 3000，可通过以下方式修改：

1. 修改 `ecosystem.config.js` 中的 `PORT` 环境变量
2. 设置系统环境变量 `PORT`
3. 修改 `bin/www` 中的端口配置

## 依赖说明

主要依赖包：

- `express` - Web 框架
- `mysql2` - MySQL 数据库驱动
- `iconv-lite` - 字符编码转换
- `archiver` - ZIP 文件压缩
- `openai` - OpenAI API 客户端
- `cookie-parser` - Cookie 解析
- `morgan` - HTTP 请求日志
- `dotenv` - 环境变量管理

## 注意事项

1. **数据库连接**: Java 代码生成器需要能够访问目标数据库，请确保网络连接正常
2. **编码修复**: 编码修复工具使用多种算法尝试修复，对于极端情况可能无法完全修复
3. **AI 服务**: 使用 AI 聊天功能需要配置有效的 API Key，注意保护 API Key 安全
4. **生产部署**: 建议使用 PM2 或类似工具进行进程管理，确保服务稳定运行

## 开发计划

- [ ] 支持更多数据库类型（PostgreSQL、Oracle 等）
- [ ] 增加更多代码生成模板选项
- [ ] 优化编码修复算法
- [ ] 增加代码格式化功能
- [ ] 支持批量表代码生成
- [ ] 在线加解密 
- [ ] MD5加密
- [ ] SHA加密
- [ ] MD5加密
- [ ] AES加/解密
- [ ] RC4加/解密
- [x] 国密SM2加/解密
- [ ] Base64加/解密
- [ ] Base64加/解密
- [ ] RSA加/解密
- [ ] DES加/解密
- [ ] Rabbit加/解密
- [ ] 摩斯密码加/解密
- [ ] 货币转换
- [ ] 日历转换
- [ ] 字节转换
- [ ] 进制转换
- [ ] CSS单位转换
- [ ] 驼峰/下划线转换

## Electron 桌面应用

本项目已支持打包成 Electron 桌面应用。

### 开发模式运行

```bash
# 以 Electron 方式启动应用
npm run electron
```

### 打包应用

**Windows 平台**:
```bash
npm run build:win
```

**macOS 平台**:
```bash
npm run build:mac
```

**Linux 平台**:
```bash
npm run build:linux
```

**所有平台**:
```bash
npm run build
```

打包后的应用文件会生成在 `dist` 目录下。

### 配置说明

- Electron 主进程文件: `main.js`
- 应用图标: 放置在 `assets/` 目录下（可选）
  - Windows: `icon.ico`
  - macOS: `icon.icns`
  - Linux: `icon.png`
- 打包配置: 在 `package.json` 的 `build` 字段中配置

### 注意事项

1. 首次打包可能需要下载 Electron 二进制文件，请耐心等待
2. 打包时确保端口 3000 未被占用
3. 如果修改了端口配置，需要同步更新 `main.js` 中的 `SERVER_PORT` 常量

## 许可证

请查看 `LICENSE` 文件了解详细的授权信息。

## 贡献

欢迎提交 Issue 和 Pull Request 来帮助改进项目。

## 联系方式

如有任何问题或建议，请联系项目维护者 jeanbin520@outlook.com。

该项目托管在 [Gitee](https://gitee.com) 上，更多详情请访问项目主页。