156 lines
4.0 KiB
Markdown
156 lines
4.0 KiB
Markdown
# U-Desk
|
||
|
||
基于 Wails 的桌面应用程序，集成数据库客户端、文件管理、设备测试等功能。
|
||
|
||
## 技术栈
|
||
|
||
- **后端**：Go 1.25+、Wails v2
|
||
- **前端**：Vue 3、Arco Design Vue、Vite
|
||
- **存储**：SQLite、MySQL、Redis、MongoDB
|
||
|
||
## 核心功能
|
||
|
||
### 1. 数据库客户端
|
||
- 支持 MySQL、Redis、MongoDB 多种数据库连接
|
||
- 连接管理（保存、编辑、删除连接配置）
|
||
- SQL 执行与结果展示
|
||
- 数据表结构查看
|
||
|
||
### 2. 文件管理
|
||
- 本地文件系统浏览（支持多盘符）
|
||
- 文件预览（图片、文本、代码）
|
||
- 文件操作（复制、移动、删除、重命名）
|
||
- 常用路径快捷访问（桌面、文档、下载等）
|
||
- 搜索与筛选功能
|
||
|
||
### 3. 设备测试
|
||
- 系统设备信息查询
|
||
- 硬件状态检测
|
||
|
||
### 4. 更新管理
|
||
- 应用版本检查与自动更新
|
||
- 更新日志展示
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
go-desk/
|
||
├── app.go # 应用入口，API 方法绑定
|
||
├── main.go # 程序启动
|
||
├── wails.json # Wails 配置
|
||
├── go.mod # Go 模块依赖
|
||
├── internal/
|
||
│ ├── api/ # API 层（数据库、标签页、更新等）
|
||
│ ├── common/ # 通用工具（超时、工具函数）
|
||
│ ├── dbclient/ # 数据库客户端（MySQL、Redis、MongoDB）
|
||
│ ├── filesystem/ # 文件系统管理（模块化架构）
|
||
│ ├── service/ # 服务层（SQL 执行等）
|
||
│ ├── storage/ # 本地存储（SQLite）
|
||
│ └── system/ # 系统信息获取
|
||
└── web/ # 前端代码
|
||
├── package.json
|
||
├── vite.config.js
|
||
├── index.html
|
||
└── src/
|
||
├── components/ # Vue 组件
|
||
│ ├── FileSystem.vue # 文件管理
|
||
│ ├── DeviceTest.vue # 设备测试
|
||
│ ├── UpdatePanel.vue # 更新面板
|
||
│ └── CodeEditor.vue # 代码编辑器
|
||
├── composables/ # 组合式函数
|
||
│ ├── useFileOperations.js
|
||
│ ├── useFavoriteFiles.js
|
||
│ └── useLocalStorage.js
|
||
├── utils/ # 工具函数
|
||
├── api/ # API 调用
|
||
└── App.vue # 主应用
|
||
```
|
||
|
||
## 开发
|
||
|
||
### 1. 安装依赖
|
||
|
||
```bash
|
||
# Go 依赖
|
||
go mod tidy
|
||
|
||
# 前端依赖
|
||
cd web
|
||
npm install
|
||
```
|
||
|
||
### 2. 构建前端（必须）
|
||
|
||
```bash
|
||
cd web
|
||
npm run build
|
||
```
|
||
|
||
**重要**：每次修改前端代码后都需要重新构建，Wails 使用 `web/dist` 目录中的构建产物。
|
||
|
||
### 3. 开发模式运行
|
||
|
||
```bash
|
||
# 在项目根目录
|
||
wails dev
|
||
```
|
||
|
||
**注意**：如果 `wails` 命令找不到，使用完整路径：
|
||
```bash
|
||
# 获取 GOPATH
|
||
go env GOPATH
|
||
|
||
# 使用完整路径（根据你的 GOPATH 调整）
|
||
D:\Go\go-workspace\bin\wails.exe dev
|
||
```
|
||
|
||
### 4. 构建应用
|
||
|
||
```bash
|
||
# 确保前端已构建
|
||
cd web
|
||
npm run build
|
||
cd ..
|
||
|
||
# 构建当前平台
|
||
wails build
|
||
|
||
# 构建 Windows（明确指定平台）
|
||
wails build -platform windows/amd64
|
||
```
|
||
|
||
**构建产物位置**：`build/bin/go-desk.exe`
|
||
|
||
**注意**：
|
||
- 构建前确保前端已构建（`web/dist` 目录存在）
|
||
- 构建产物是独立的可执行文件，包含前端资源
|
||
|
||
## 数据库配置
|
||
|
||
应用使用 SQLite 本地存储连接配置和用户数据。
|
||
|
||
可选连接外部数据库：
|
||
- **MySQL**：支持连接、查询、表结构查看
|
||
- **Redis**：支持连接、基础操作
|
||
- **MongoDB**：支持连接、基础操作
|
||
|
||
## 架构特点
|
||
|
||
- **模块化文件系统**：文件管理功能采用模块化设计，职责分离
|
||
- **异步启动优化**：应用启动流程优化，核心功能快速初始化
|
||
- **本地文件服务器**：支持本地文件预览和访问
|
||
- **SQLite 持久化**：连接配置和用户数据本地存储
|
||
|
||
## 文档
|
||
|
||
详细文档请查看 `docs/` 目录：
|
||
- 架构设计文档
|
||
- 功能迭代记录
|
||
- 技术决策记录（ADR）
|
||
- 测试用例和检查报告
|
||
|
||
## 许可
|
||
|
||
本项目用于学习和测试目的。
|
||
|