Private
Public Access
1
0
Files
u-desk/docs/08-用户指南/user-manual.md

7.4 KiB
Raw Permalink Blame History

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 默认 3306PostgreSQL 默认 5432
用户名/密码 数据库登录信息
数据库名 SQLite 填文件路径
  1. 点击 测试连接 验证
  2. 点击 保存

查询数据

展开连接 → 点击表名 → 自动生成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