# zeus-client

**Repository Path**: rederic/zeus-client

## Basic Information

- **Project Name**: zeus-client
- **Description**: 开发工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Zeus 开发工具箱

<div align="center">

![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)
![License](https://img.shields.io/badge/license-MIT-green.svg)
![Vue](https://img.shields.io/badge/Vue-3.4.21-brightgreen.svg)
![Electron](https://img.shields.io/badge/Electron-29.1.4-blue.svg)

**一款功能强大的开发者工具集，基于 Electron + Vue 3 构建**

[功能特性](#功能特性) • [快速开始](#快速开始) • [项目结构](#项目结构) • [开发指南](#开发指南)

</div>

---

## 📖 项目简介

Zeus 开发工具箱是一款面向开发者的综合性工具平台，集成了代码生成、数据库管理、常用开发工具等多种功能。通过 Electron 桌面应用技术，为开发者提供高效、便捷的开发体验。

## ✨ 功能特性

### 🔧 开发工具箱

| 工具类别 | 工具名称 | 功能说明 |
|---------|---------|---------|
| **格式化工具** | JSON 格式化 | JSON 数据格式化、压缩、校验 |
| | JSON 转换 | JSON 与其他格式互转 |
| | Base64 编解码 | Base64 编码/解码工具 |
| | URL 编解码 | URL 编码/解码工具 |
| **时间工具** | 时间戳转换 | 时间戳与日期时间互转 |
| | Cron 工具 | Cron 表达式生成与解析 |
| **编码工具** | 加密解密 | AES/DES/MD5/SHA 等加密算法 |
| | UUID 生成 | UUID/GUID 生成工具 |
| **文本工具** | 正则测试 | 正则表达式在线测试 |
| | 文本对比 | 文本差异对比工具 |
| | Markdown 编辑器 | Markdown 实时编辑预览 |
| **图像工具** | 二维码工具 | 二维码生成与解析 |
| | 图片工具 | 图片压缩、格式转换 |
| **数据工具** | Excel 转字符串 | Excel 数据转换为字符串 |
| | SQL 工具 | SQL 语句提取与格式化 |

### 💾 数据库管理

- **MySQL 数据库**
  - 数据库连接管理
  - 表结构查看与搜索
  - SQL 查询编辑器（支持 Tab 补全）
  - 多条 SQL 执行与结果展示
  - 表结构导出

- **Redis 缓存**
  - Redis 连接管理
  - 键值对查看与编辑
  - 数据类型支持

- **离线数据库**
  - 表结构文件导入
  - 离线查看数据库结构
  - 字段搜索功能

### 📝 业务功能

- **代码生成**
  - 基于模板的代码自动生成
  - 支持多种数据库类型
  - 自定义模板语法

- **项目管理**
  - 项目信息管理
  - 模板配置管理
  - 文件目录树展示

- **配置管理**
  - 数据库配置
  - 系统参数配置
  - 配置导入导出

- **共享库**
  - 代码片段共享
  - Excel 在线编辑
  - 多人协作

- **记事本**
  - 快速备忘录
  - 分类管理
  - 搜索功能

- **日程管理**
  - 日历视图
  - 待办事项
  - 日程导出

### 👥 系统管理

- **用户管理**
  - 用户增删改查
  - 角色权限管理
  - 用户状态管理

- **版本管理**
  - 版本发布记录
  - 版本更新日志

- **网页库**
  - 常用网址收藏
  - 快速访问

- **脚本管理**
  - 脚本文件管理
  - 脚本执行

## 🛠️ 技术栈

### 前端框架
- **Vue 3.4.21** - 渐进式 JavaScript 框架
- **TypeScript 5.4.2** - JavaScript 的超集
- **Vite 5.1.6** - 下一代前端构建工具

### UI 组件库
- **Element Plus 2.6.1** - 基于 Vue 3 的组件库
- **@element-plus/icons-vue** - Element Plus 图标库

### 桌面应用
- **Electron 29.1.4** - 跨平台桌面应用框架
- **electron-builder** - Electron 应用打包工具

### 代码编辑器
- **CodeMirror 6** - 代码编辑器
- **@codemirror/lang-*** - 多语言语法支持

### 数据处理
- **Axios** - HTTP 客户端
- **mysql2** - MySQL 客户端
- **ioredis** - Redis 客户端
- **xlsx** - Excel 文件处理

### 工具库
- **Pinia** - Vue 状态管理
- **Vue Router** - 路由管理
- **crypto-js** - 加密算法库
- **qrcode** - 二维码生成
- **markdown-it** - Markdown 解析
- **highlight.js** - 代码高亮

## 📦 快速开始

### 环境要求

- **Node.js**: >= 16.0.0
- **npm**: >= 8.0.0
- **操作系统**: Windows / macOS / Linux

### 安装依赖

```bash
cd zeus-client
npm install
```

### 开发模式

```bash
# 启动开发服务器
npm run dev

# 启动 Electron 开发模式
npm run electron:dev
```

### 生产构建

```bash
# 构建应用
npm run build

# 构建 Electron 应用
npm run electron:build
```

构建产物将输出到 `release` 目录。

## 📁 项目结构

```
zeus-client/
├── electron/                 # Electron 主进程
│   ├── main.ts              # 主进程入口
│   └── preload.ts           # 预加载脚本
├── public/                   # 静态资源
│   └── docs/                # 使用文档
├── src/                      # 源代码
│   ├── api/                 # API 接口
│   ├── assets/              # 资源文件
│   ├── components/          # 公共组件
│   ├── constant/            # 常量定义
│   ├── layouts/             # 布局组件
│   ├── router/              # 路由配置
│   ├── stores/              # 状态管理
│   ├── styles/              # 全局样式
│   ├── types/               # 类型定义
│   ├── utils/               # 工具函数
│   └── views/               # 页面组件
│       ├── code-download/   # 代码生成
│       ├── configure/       # 配置管理
│       ├── docs/            # 使用文档
│       ├── home/            # 首页
│       ├── login/           # 登录
│       ├── notepad/         # 记事本
│       ├── profile/         # 个人中心
│       ├── project/         # 项目管理
│       ├── shareLibrary/    # 共享库
│       ├── shell/           # 脚本管理
│       ├── tools/           # 工具箱
│       ├── user/            # 用户管理
│       ├── version/         # 版本管理
│       └── webLibrary/      # 网页库
├── .env                      # 环境变量
├── index.html               # HTML 模板
├── package.json             # 项目配置
├── tsconfig.json            # TypeScript 配置
└── vite.config.ts           # Vite 配置
```

## ⚙️ 配置说明

### 环境变量配置

编辑 `.env` 文件配置服务端地址：

```env
# 服务端地址
VUE_APP_DEFALUT_IP=http://139.196.80.246
VUE_APP_DEFALUT_PORT=8010

# 是否内网模式
VUE_APP_IS_INNER=false

# 是否单机模式
VUE_APP_IS_SINGLE=false
```

### 后端服务配置

默认连接的后端服务地址：
- **IP**: http://139.196.80.246
- **端口**: 8010
- **完整地址**: http://139.196.80.246:8010

## 🎯 开发指南

### 添加新工具

1. 在 `src/views/tools/` 下创建新的 Vue 组件
2. 在 `src/router/index.ts` 中添加路由配置
3. 在 `src/views/tools/ToolsPage.vue` 中添加工具入口

### 添加新页面

1. 在 `src/views/` 下创建页面目录
2. 在 `src/router/index.ts` 中添加路由
3. 在 `src/api/` 中添加对应的 API 接口

### 状态管理

使用 Pinia 进行状态管理，store 文件位于 `src/stores/` 目录：

- `user.ts` - 用户状态
- `tab.ts` - 标签页状态
- `theme.ts` - 主题配置

### API 请求

API 请求统一使用 `src/utils/service.ts` 中的 axios 实例：

```typescript
import service from '@/utils/service'

export const getUserInfo = () => {
  return service.get('/user/info')
}
```

## 🎨 主题配置

系统支持多主题切换，主题配置位于 `src/stores/theme.ts`：

- 默认蓝色主题
- 紫色主题
- 绿色主题
- 橙色主题
- 红色主题

主题色会自动应用到：
- 导航栏渐变
- 按钮颜色
- 链接颜色
- 选中状态

## 📚 使用文档

应用内置完整的使用文档，访问方式：

1. 点击右上角"使用文档"按钮
2. 或访问路由 `/docs`

文档内容包括：
- 项目简介
- 角色说明
- 快捷键说明
- 功能说明
- 使用手册
- 部署说明
- 常见问题

## 🔒 安全说明

- 用户密码使用 MD5 + 盐值加密
- 敏感配置使用 DES 加密
- Token 机制保证接口安全
- 支持 Token 过期自动刷新

## 📝 更新日志

### v1.0.0 (2024-04-21)
- ✨ 初始版本发布
- ✨ 集成 20+ 开发工具
- ✨ 支持数据库管理
- ✨ 代码生成功能
- ✨ 多主题支持
- ✨ 完整的文档系统

## 🤝 贡献指南

欢迎提交 Issue 和 Pull Request！

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

## 🙏 致谢

感谢以下开源项目：

- [Vue.js](https://vuejs.org/)
- [Element Plus](https://element-plus.org/)
- [Electron](https://www.electronjs.org/)
- [CodeMirror](https://codemirror.net/)

---

<div align="center">

**Made with ❤️ by Zeus Team**

</div>