293 lines
7.4 KiB
Markdown
293 lines
7.4 KiB
Markdown
# U-Desk 使用手册
|
||
|
||
> 轻量级桌面工具集 - 数据库管理 | 文件管理 | 设备测试
|
||
|
||
---
|
||
|
||
## 📖 快速开始
|
||
|
||
| 操作 | 说明 |
|
||
|------|------|
|
||
| **启动应用** | 双击 `u-desk.exe` |
|
||
| **默认界面** | 数据库、文件管理、设备调用测试 |
|
||
| **打开设置** | 点击右上角 ⚙️ 按钮 |
|
||
| **拖动窗口** | 按住标题栏 "U-Desk" 文字区域 |
|
||
|
||
---
|
||
|
||
## 💾 数据库管理
|
||
|
||
### 界面布局
|
||
|
||
```
|
||
┌──────────────┬──────────────────────────────┐
|
||
│ 连接树 │ SQL 编辑器 │
|
||
│ │ ───────────── │
|
||
│ ▼ 连接1 │ SELECT * FROM users... │
|
||
│ 📋 表1 │ │
|
||
│ 📋 表2 │ ───────────── │
|
||
│ │ 结果区域 │
|
||
│ ▼ 连接2 │ ┌───┬────┬────┐ │
|
||
│ │ │id │name│ age│ │
|
||
│ │ ├───┼────┼────┤ │
|
||
│ │ │ 1 │Tom │ 20 │ │
|
||
│ │ └───┴────┴────┘ │
|
||
└──────────────┴──────────────────────────────┘
|
||
```
|
||
|
||
### 常用操作
|
||
|
||
#### 添加数据库连接
|
||
|
||
1. 点击连接树顶部的 **+ 新建连接**
|
||
2. 填写连接信息
|
||
|
||
| 字段 | 说明 |
|
||
|------|------|
|
||
| 类型 | MySQL / PostgreSQL / SQLite / MongoDB / Redis |
|
||
| 主机 | `localhost` 或服务器 IP |
|
||
| 端口 | MySQL 默认 `3306`，PostgreSQL 默认 `5432` |
|
||
| 用户名/密码 | 数据库登录信息 |
|
||
| 数据库名 | SQLite 填文件路径 |
|
||
|
||
3. 点击 **测试连接** 验证
|
||
4. 点击 **保存**
|
||
|
||
#### 查询数据
|
||
|
||
```
|
||
展开连接 → 点击表名 → 自动生成SQL → 执行（Ctrl + Enter）
|
||
```
|
||
|
||
#### 查看表结构
|
||
|
||
```
|
||
右键表名 → 查看结构 → 切换到"结构"标签页
|
||
```
|
||
|
||
#### 修改表结构
|
||
|
||
```
|
||
编辑模式 → 修改字段/索引 → 保存 → 预览SQL → 确认执行
|
||
```
|
||
|
||
#### 查看历史
|
||
|
||
```
|
||
点击"历史"标签页 → 查看所有执行过的SQL
|
||
```
|
||
|
||
---
|
||
|
||
## 📁 文件管理
|
||
|
||
### 界面布局
|
||
|
||
```
|
||
┌─────────────────────────────────────────┐
|
||
│ 路径框 [快捷访问▼] [历史▼] [刷新] [☰] │
|
||
├──────┬────────────┬────────────────────┤
|
||
│收藏夹│ 文件列表 │ 文件内容 │
|
||
└──────┴────────────┴────────────────────┘
|
||
```
|
||
|
||
### 导航操作
|
||
|
||
| 方式 | 操作 |
|
||
|------|------|
|
||
| **输入路径** | 在路径框输入（如 `C:\Users\Documents`），按回车 |
|
||
| **快捷访问** | 点击按钮选择：桌面、文档、下载、图片 |
|
||
| **历史记录** | 查看最近访问的 10 个路径 |
|
||
|
||
### 文件操作
|
||
|
||
| 操作 | 方法 |
|
||
|------|------|
|
||
| **查看文件** | 单击文件 |
|
||
| **打开文件** | 双击文件（预览/编辑） |
|
||
| **进入目录** | 双击文件夹 |
|
||
| **收藏文件** | 点击 ⭐ 按钮，添加到左侧收藏夹 |
|
||
| **重命名** | 右键 → 重命名 → 按回车确认 |
|
||
|
||
### 文件预览支持
|
||
|
||
| 类型 | 扩展名 | 功能 |
|
||
|------|--------|------|
|
||
| **图片** | `.jpg`, `.png`, `.gif`, `.svg`, `.webp` | 预览 |
|
||
| **视频** | `.mp4`, `.webm`, `.ogg` | 播放器 |
|
||
| **音频** | `.mp3`, `.wav`, `.ogg` | 播放器 |
|
||
| **PDF** | `.pdf` | 预览 |
|
||
| **HTML** | `.html`, `.htm` | 预览 ↔ 编辑切换 |
|
||
| **Markdown** | `.md` | 渲染 ↔ 编辑切换 |
|
||
| **代码** | `.js`, `.py`, `.go`, `.java`, `.sql`, `.json` 等 | 语法高亮 |
|
||
|
||
### ZIP 文件浏览
|
||
|
||
```
|
||
双击 .zip 文件 → 进入浏览模式 → 查看文件列表 → 双击预览 → 退出 ZIP
|
||
```
|
||
|
||
### 面板调整
|
||
|
||
| 操作 | 方法 |
|
||
|------|------|
|
||
| **调整宽度** | 拖动文件列表和内容区之间的分隔条 |
|
||
| **显示收藏夹** | 点击顶部 ☰ 按钮 |
|
||
|
||
---
|
||
|
||
## 🔧 设备调用测试
|
||
|
||
### 系统信息
|
||
|
||
点击 **刷新系统信息** 获取：
|
||
|
||
| 类别 | 显示内容 |
|
||
|------|----------|
|
||
| **CPU** | 核心数、型号、使用率 |
|
||
| **内存** | 总内存、已用、可用、使用率 |
|
||
| **系统** | 操作系统、架构、主机名、平台 |
|
||
| **磁盘** | 所有分区和使用情况 |
|
||
|
||
### 文件系统操作
|
||
|
||
```
|
||
输入路径 → 列出目录 → 查看文件列表 → 预览内容
|
||
```
|
||
|
||
---
|
||
|
||
## ⚙️ 设置
|
||
|
||
### Tab 配置
|
||
|
||
| 功能 | 操作 |
|
||
|------|------|
|
||
| **调整顺序** | 拖拽 ⋮⋮ 图标 |
|
||
| **显示/隐藏** | 勾选/取消勾选（至少保留一个） |
|
||
| **设置默认** | 点击 ○ 默认 单选按钮 |
|
||
| **保存** | 点击 **保存配置** 按钮 |
|
||
| **重置** | 点击 **重置** 恢复上次保存的状态 |
|
||
|
||
### 版本更新
|
||
|
||
```
|
||
切换到"版本更新"标签页 → 检查更新 → 下载并安装
|
||
```
|
||
|
||
---
|
||
|
||
## ❓ 常见问题
|
||
|
||
### 应用启动慢？
|
||
|
||
**原因**：启用了所有模块
|
||
|
||
**解决**：设置中取消勾选不用的模块，只保留需要的
|
||
|
||
---
|
||
|
||
### 数据库连接失败？
|
||
|
||
**检查清单**：
|
||
|
||
- [ ] 主机、端口、用户名、密码是否正确
|
||
- [ ] 数据库服务器是否已启动
|
||
- [ ] 点击 **测试连接** 验证配置
|
||
|
||
---
|
||
|
||
### 文件预览乱码？
|
||
|
||
**原因**：文件编码不是 UTF-8
|
||
|
||
**解决**：使用专业编辑器（VS Code、Notepad++）查看
|
||
|
||
---
|
||
|
||
### 编辑器无法保存？
|
||
|
||
**说明**：编辑器当前为只读模式
|
||
|
||
**替代**：复制内容到外部编辑器保存
|
||
|
||
---
|
||
|
||
### 如何重置配置？
|
||
|
||
| 系统 | 操作 |
|
||
|------|------|
|
||
| **Windows** | 删除 `%LOCALAPPDATA%\u-desk\` 文件夹内容 |
|
||
| **macOS** | 删除 `~/Library/Application Support/u-desk/` 文件夹 |
|
||
| **Linux** | 删除 `~/.config/u-desk/` 文件夹 |
|
||
|
||
删除后重启应用，自动恢复默认配置
|
||
|
||
---
|
||
|
||
### ZIP 文件无法修改？
|
||
|
||
**说明**：ZIP 浏览模式为只读
|
||
|
||
**解决**：使用专业压缩软件（WinRAR、7-Zip）修改
|
||
|
||
---
|
||
|
||
## 📂 配置文件位置
|
||
|
||
| 系统 | 路径 |
|
||
|------|------|
|
||
| **Windows** | `%LOCALAPPDATA%\u-desk\` |
|
||
| **macOS** | `~/Library/Application Support/u-desk/` |
|
||
| **Linux** | `~/.config/u-desk/` |
|
||
|
||
---
|
||
|
||
## ⌨️ 快捷键
|
||
|
||
### 数据库模块
|
||
|
||
| 快捷键 | 功能 |
|
||
|--------|------|
|
||
| `F5` | 执行 SQL |
|
||
| `Ctrl + Enter` | 执行选中的 SQL |
|
||
|
||
### 文件管理模块
|
||
|
||
| 快捷键 | 功能 |
|
||
|--------|------|
|
||
| `Ctrl + N` | 新建文件 |
|
||
| `Ctrl + Shift + N` | 新建文件夹 |
|
||
| `F2` | 重命名选中文件 |
|
||
| `Del` | 删除选中文件 |
|
||
| `Ctrl + B` | 显示/隐藏收藏夹侧边栏 |
|
||
| `Ctrl + ←` | 后退到上一个目录 |
|
||
| `Ctrl + →` | 前进到下一个目录 |
|
||
| `Ctrl + Shift + C` | 快速打开 C 盘 |
|
||
| `Ctrl + Shift + D` | 快速打开 D 盘 |
|
||
| `Ctrl + Shift + E` | 快速打开 E 盘 |
|
||
| `Enter` | 确认（编辑文件名时） |
|
||
| `Esc` | 取消（编辑文件名时） |
|
||
|
||
### 通用快捷键
|
||
|
||
| 快捷键 | 功能 |
|
||
|--------|------|
|
||
| `F5` | 刷新当前视图 |
|
||
|
||
---
|
||
|
||
## 🎯 窗口控制
|
||
|
||
| 按钮 | 功能 |
|
||
|------|------|
|
||
| `-` | 最小化到任务栏 |
|
||
| `□` | 最大化/还原 |
|
||
| `×` | 关闭窗口 |
|
||
|
||
**拖动窗口**：按住标题栏 "U-Desk" 文字区域或标签页空白区域
|
||
|
||
---
|
||
|
||
**版本**：1.0.0 | **更新日期**：2026-01-28
|