u-desk 文档v0.4.1
多源文件管理操作指南
介绍
Windows 桌面文件管理工具，支持本地磁盘、SFTP 远程服务器、云 OSS（七牛云/阿里云）统一浏览编辑。
多源文件管理
本地 + SFTP + 云 OSS 统一浏览、编辑、收藏
BGM 播放器
LRC 歌词同步、四种播放模式、全局热键
网站预览
HTML 自动下载关联资源，完整渲染静态站点
服务器监控
磁盘/CPU/内存实时监控，超 90% 红色警告
技术栈
| 组件 | 技术 |
|---|---|
| 后端 | Go 1.24+ / Wails v3 |
| 前端 | Vue 3 + Arco Design |
| 编辑器 | CodeMirror 6 |
| 存储 | SQLite (配置/缓存) |
| 云存储 | 七牛云 / 阿里云 OSS |
| 远程连接 | SFTP (SSH) |
安装
系统要求
| 系统 | 要求 |
|---|---|
| Windows | Windows 10 1809+ / Windows 11 |
| 磁盘 | 约 50MB |
安装步骤
- 下载 Windows 安装包
- 双击
u-desk.exe运行即可，无需安装
快速开始
| 操作 | 说明 |
|---|---|
| 启动 | 双击 u-desk.exe |
| 本地文件 | 启动后默认进入本地磁盘浏览 |
| SFTP 连接 | 侧边栏添加服务器，填入 SSH 地址和认证信息 |
| 云 OSS | 侧边栏添加 OSS 连接，填入 AK/SK |
| 设置 | 右上角 ⚙️ 按钮 |
提示：可以在设置中禁用不需要的模块来加快启动速度。
文件管理
统一浏览本地磁盘、SFTP 远程服务器、云 OSS 上的文件，预览、编辑、收藏。
侧边栏
- 服务器列表 - 显示所有 SFTP/OSS 连接，可折叠、拖拽排序
- 收藏夹 - 快速访问常用路径，支持置顶排序
- 快捷路径 - 桌面、文档、下载等
- 连接指示器 - 悬停弹出子文件夹列表，快速导航
文件操作
| 操作 | 方式 |
|---|---|
| 查看文件 | 单击文件 |
| 打开文件 | 双击（预览/编辑） |
| 进入目录 | 双击文件夹 |
| 收藏文件 | 点击 ⭐ 按钮 |
| 重命名 | 右键 → 重命名 → 回车确认 |
| 返回上级 | Backspace |
ZIP 文件浏览
双击 .zip 文件可浏览内部结构，当前仅支持只读。
提示：面包屑导航可快速跳转到任意父级目录。
SFTP 远程连接
通过 SSH 连接远程服务器，浏览和编辑文件。
连接方式
- 密码认证 - 输入主机、端口、用户名、密码
- 密钥认证 - 指定 SSH 私钥文件路径
支持的操作
| 操作 | 说明 |
|---|---|
| 浏览目录 | 双击文件夹进入，面包屑导航 |
| 上传文件 | 从本地拖拽或粘贴到远程目录 |
| 下载文件 | 自动缓存到本地，支持预览 |
| 编辑文件 | 双击打开编辑器，Ctrl+S 保存回传 |
| 服务器监控 | 自动显示磁盘/CPU/内存使用率 |
云 OSS 存储
连接七牛云或阿里云 OSS，像本地文件夹一样管理云端文件。
配置连接
- 厂商 - 七牛云 / 阿里云
- 认证 - AK/SK 密钥对
- 区域嗅探 - 连接时自动探测桶区域，无需手动填写
桶管理（七牛云）
| 操作 | 说明 |
|---|---|
| 查看桶域名 | 临时域名、自定义域名 |
| 查看真实区域 | 自动获取桶的实际存储区域 |
| 设置访问权限 | 公开读 / 私有 |
文件操作
| 操作 | 说明 |
|---|---|
| 列目录 | 按前缀分隔，正确展示文件夹层级 |
| 读/写文件 | 支持在线编辑和保存 |
| 预签名 URL | 私有空间安全访问 |
| 下载域名 | 智能解析：临时→自定义→CDN |
文件预览
不同格式用不同方式打开，远程文件自动缓存。
支持的文件类型
| 类型 | 扩展名 | 功能 |
|---|---|---|
| 图片 | .jpg, .png, .gif, .webp, .svg, .bmp | 预览 |
| 视频 | .mp4, .webm, .ogg | 播放 |
| 音频 | .mp3, .wav, .ogg, .flac | 播放 |
| 预览 | ||
| Office | .docx, .xlsx, .csv | 预览 |
| HTML | .html, .htm | 网站预览（自动下载关联资源） |
| Markdown | .md | 渲染 ↔ 编辑 |
| 代码 | .js, .ts, .go, .py, .java, .sql, .json 等 | 语法高亮 |
Markdown 编辑器
marked + highlight.js + mermaid 渲染：
- Mermaid 图表 — 流程图、时序图、类图、甘特图等，实时渲染
- 代码高亮 — 40+ 种编程语言语法着色（highlight.js）
- GFM 扩展 — 表格、任务列表、删除线、脚注完整支持
- 实时预览 — 所见即所得的编辑体验
BGM 音乐播放
编辑器底部控制条，边工作边听歌。
播放控制
- 基本操作 - 播放/暂停、上一首/下一首、进度拖拽
- 四种模式 - 单曲循环、顺序播放、随机播放、列表循环
- 播放列表 - 持久化存储，重启后不丢失
- 失败跳过 - 无法播放的文件自动跳过下一首
LRC 歌词
- 自动查找 - 播放时自动查找同名 .lrc 歌词文件
- 同步滚动 - 实时高亮当前歌词行
- 点击跳转 - 点击歌词行跳转到对应时间点
全局热键：按 Ctrl+Shift+B 即使应用最小化也能快速唤起播放控制。
服务器监控
侧边栏实时显示远程服务器资源使用情况。
监控指标
| 指标 | 说明 |
|---|---|
| 磁盘使用率 | 已用空间 / 总空间 |
| CPU 使用率 | 实时 CPU 占用百分比 |
| 内存使用率 | 已用内存 / 总内存 |
注意：超过 90% 的指标会显示红色警告。数据每 15 秒自动刷新。
设置
侧边栏配置
自定义侧边栏内容：
- 区块排序 - 服务器、收藏夹、帮助区块可拖拽排序
- 区块显隐 - 隐藏不需要的区块
- 服务器管理 - 添加/编辑/删除 SFTP 和 OSS 连接
主题切换
| 模式 | 说明 |
|---|---|
| 亮色 | 白底 |
| 暗色 | 黑底 |
快捷键
| 文件操作 | |||
| 新建文件 | Ctrl+N | 新建文件夹 | Ctrl+Shift+N |
| 重命名 | F2 | 删除 | Delete |
| 保存 | Ctrl+S | 重置编辑 | Ctrl+Z |
| 导航与浏览 | |||
| 返回上级 | Backspace | 刷新目录 | F5 |
| 后退目录 | Alt + ← | 前进目录 | Alt + → |
| 切换侧边栏 | Ctrl+B | 切换预览/编辑 | Ctrl+Shift+V |
| BGM 播放 | |||
| 全局唤起 | Ctrl+Shift+B | 应用最小化时快速唤起播放控制 | |
常见问题
启动慢？
原因：配置了多个远程连接
解决：设置中关闭不常用连接，侧边栏可自定义显隐
文件预览乱码？
原因：文件编码不是 UTF-8
解决：v0.4.1 已支持 GBK 自动转换，如仍乱码请用专业编辑器查看
如何重置配置？
| 系统 | 操作 |
|---|---|
| Windows | 删除 %LOCALAPPDATA%\u-desk\ |
删除后重启应用，自动恢复默认配置。
更新日志
查看完整的版本历史和变更记录：changelog.html →