# 功能验证清单（手动测试）

**项目**: go-desk / u-desk
**版本**: eb2cbad（当前版本）
**基准版本**: 4a9b25a
**测试日期**: 2026-01-31

---

## 使用说明

- ✅ 通过：功能正常
- ❌ 失败：功能异常
- ⚠️ 部分：功能部分正常
- ⏭️ 跳过：无法测试（如无相关环境）

---

## 一、文件系统核心功能

### 1.1 文件浏览

| 序号 | 测试项 | 操作步骤 | 预期结果 | 状态 |
|------|--------|----------|----------|------|
| 1.1.1 | 浏览本地目录 | 输入路径 `C:\Users` → 回车 | 显示用户目录文件列表 | ⏭️ |
| 1.1.2 | 浏览网络驱动器 | 输入路径 `\\server\share` → 回车 | 显示网络共享文件 | ⏭️ |
| 1.1.3 | 路径自动完成 | 输入 `C:\W` → 查看下拉提示 | 显示 `C:\Windows` 等提示 | ⏭️ |
| 1.1.4 | 后退导航 | 点击工具栏"后退"按钮或按 `Alt+←` | 返回上一个目录 | ⏭️ |
| 1.1.5 | 前进导航 | 点击工具栏"前进"按钮或按 `Alt+→` | 前进到下一个目录 | ⏭️ |
| 1.1.6 | 快捷访问 | 点击"快捷访问"下拉 → 选择"桌面" | 导航到桌面目录 | ⏭️ |
| 1.1.7 | 历史记录 | 点击"历史"下拉 → 选择任意路径 | 导航到选中的历史路径 | ⏭️ |
| 1.1.8 | 刷新文件列表 | 点击"刷新"按钮 | 重新加载当前目录 | ⏭️ |
| 1.1.9 | 双击文件夹 | 双击文件夹图标 | 进入该文件夹 | ⏭️ |
| 1.1.10 | 单击文件夹 | 单击文件夹 | 选中但不进入 | ⏭️ |

### 1.2 文件操作

| 序号 | 测试项 | 操作步骤 | 预期结果 | 状态 |
|------|--------|----------|----------|------|
| 1.2.1 | 选中文件 | 单击文件 | 文件高亮显示 | ⏭️ |
| 1.2.2 | 打开文本文件 | 双击 `.txt` 文件 | 右侧显示文件内容 | ⏭️ |
| 1.2.3 | 打开代码文件 | 双击 `.js` 文件 | 右侧显示语法高亮代码 | ⏭️ |
| 1.2.4 | 打开图片文件 | 双击 `.png` 文件 | 右侧显示图片预览 | ⏭️ |
| 1.2.5 | 打开视频文件 | 双击 `.mp4` 文件 | 右侧显示视频播放器 | ⏭️ |
| 1.2.6 | 打开音频文件 | 双击 `.mp3` 文件 | 右侧显示音频播放器 | ⏭️ |
| 1.2.7 | 打开PDF文件 | 双击 `.pdf` 文件 | 右侧显示PDF预览 | ⏭️ |
| 1.2.8 | 打开二进制文件 | 双击 `.exe` 文件 | 显示友好提示信息 | ⏭️ |
| 1.2.9 | 新建文件 | 右键空白处 → "新建文件" → 输入文件名 | 创建新文件 | ⏭️ |
| 1.2.10 | 新建文件夹 | 右键空白处 → "新建文件夹" → 输入名称 | 创建新文件夹 | ⏭️ |
| 1.2.11 | 重命名文件 | 选中文件 → 按 `F2` → 输入新名称 → `Enter` | 文件重命名成功，光标自动聚焦 | ⏭️ |
| 1.2.12 | 删除文件 | 选中文件 → 按 `Delete` → 确认 | 文件被删除 | ⏭️ |
| 1.2.13 | 收藏文件 | 点击文件旁的星标图标 | 文件添加到收藏夹，星标变黄 | ⏭️ |
| 1.2.14 | 取消收藏 | 点击已收藏文件的星标图标 | 文件从收藏夹移除，星标变空 | ⏭️ |

### 1.3 文件编辑

| 序号 | 测试项 | 操作步骤 | 预期结果 | 状态 |
|------|--------|----------|----------|------|
| 1.3.1 | 编辑文本文件 | 打开 `.txt` 文件 → 修改内容 → 点击"保存" | 文件保存成功，显示成功提示 | ⏭️ |
| 1.3.2 | 编辑代码文件 | 打开 `.js` 文件 → 修改代码 → 保存 | 文件保存成功 | ⏭️ |
| 1.3.3 | 保存快捷键 | 编辑文件 → 按 `Ctrl+S` | 文件保存成功 | ⏭️ |
| 1.3.4 | 重置内容 | 编辑文件 → 点击"重置" | 恢复到原始内容 | ⏭️ |
| 1.3.5 | 切换编辑模式 | 打开 `.html` 文件 → 点击"预览" | 切换到渲染预览 | ⏭️ |
| 1.3.6 | 调整编辑器高度 | 拖动编辑器底部边框 | 编辑器高度变化 | ⏭️ |
| 1.3.7 | 大文件提示 | 打开超过5MB的文件 | 显示文件过大提示，不加载内容 | ⏭️ |

---

## 二、收藏夹功能

### 2.1 收藏夹基础操作

| 序号 | 测试项 | 操作步骤 | 预期结果 | 状态 |
|------|--------|----------|----------|------|
| 2.1.1 | 添加收藏 | 点击文件旁的星标 | 文件出现在左侧收藏夹 | ⏭️ |
| 2.1.2 | 移除收藏 | 点击已收藏文件的星标 | 文件从收藏夹消失 | ⏭️ |
| 2.1.3 | 刷新收藏夹 | 重启应用 | 收藏夹内容保持不变 | ⏭️ |

### 2.2 收藏夹打开功能（重点测试）

| 序号 | 测试项 | 操作步骤 | 预期结果 | 状态 |
|------|--------|----------|----------|------|
| 2.2.1 | 打开收藏的文件夹 | 当前在目录A → 点击收藏的目录B | 文件列表切换到目录B | ⏭️ |
| 2.2.2 | 打开收藏的文件 | 当前在目录A → 点击收藏的file.txt | 右侧显示file.txt内容，当前目录仍为A | ⏭️ |
| 2.2.3 | 打开收藏的图片 | 当前在目录A → 点击收藏的image.png | 右侧显示图片，当前目录仍为A | ⏭️ |
| 2.2.4 | 打开收藏的代码 | 当前在目录A → 点击收藏的code.js | 右侧显示代码，当前目录仍为A | ⏭️ |
| 2.2.5 | 打开收藏的ZIP | 当前在目录A → 点击收藏的files.zip | 进入ZIP浏览模式，当前目录仍为A | ⏭️ |
| 2.2.6 | 跨目录收藏 | 在不同目录收藏多个文件 | 所有收藏都能正确打开 | ⏭️ |
| 2.2.7 | 路径分隔符兼容 | 收藏包含 `\` 和 `/` 的路径 | 所有路径都能正确识别 | ⏭️ |

### 2.3 收藏夹持久化

| 序号 | 测试项 | 操作步骤 | 预期结果 | 状态 |
|------|--------|----------|----------|------|
| 2.3.1 | 重启后保留 | 收藏文件 → 关闭应用 → 重新打开 | 收藏夹内容仍存在 | ⏭️ |
| 2.3.2 | 删除文件后 | 收藏文件 → 在系统中删除该文件 → 点击收藏 | 显示文件不存在提示 | ⏭️ |
| 2.3.3 | 重命名文件后 | 收藏文件 → 重命名文件 | 收藏夹自动更新路径 | ⏭️ |

---

## 三、ZIP文件浏览功能（新增功能）

### 3.1 ZIP浏览基础

| 序号 | 测试项 | 操作步骤 | 预期结果 | 状态 |
|------|--------|----------|----------|------|
| 3.1.1 | 进入ZIP模式 | 双击 `.zip` 文件 | 工具栏显示ZIP路径和"退出ZIP"按钮 | ⏭️ |
| 3.1.2 | 显示ZIP内容 | 进入ZIP模式 | 文件列表显示ZIP内的文件和文件夹 | ⏭️ |
| 3.1.3 | ZIP内导航 | 双击ZIP内的文件夹 | 进入该文件夹 | ⏭️ |
| 3.1.4 | 面包屑显示 | 进入ZIP子目录 | 工具栏显示完整路径面包屑 | ⏭️ |
| 3.1.5 | 面包屑导航 | 点击面包屑中的路径 | 快速返回到对应的目录 | ⏭️ |
| 3.1.6 | 返回ZIP根目录 | 点击ZIP文件名标签 | 返回ZIP根目录 | ⏭️ |
| 3.1.7 | 退出ZIP模式 | 点击"退出ZIP"按钮 | 返回正常浏览模式 | ⏭️ |

### 3.2 ZIP文件预览

| 序号 | 测试项 | 操作步骤 | 预期结果 | 状态 |
|------|--------|----------|----------|------|
| 3.2.1 | 预览ZIP内图片 | 双击ZIP内的 `.png` 文件 | 右侧显示图片（临时提取） | ⏭️ |
| 3.2.2 | 查看ZIP内文本 | 双击ZIP内的 `.txt` 文件 | 右侧显示文本内容 | ⏭️ |
| 3.2.3 | 查看ZIP内代码 | 双击ZIP内的 `.js` 文件 | 右侧显示语法高亮代码 | ⏭️ |
| 3.2.4 | 图片加载状态 | 观察图片加载过程 | 显示loading状态，加载完成后显示尺寸 | ⏭️ |

### 3.3 收藏夹中打开ZIP

| 序号 | 测试项 | 操作步骤 | 预期结果 | 状态 |
|------|--------|----------|----------|------|
| 3.3.1 | 收藏ZIP文件 | 点击ZIP文件的星标 | ZIP文件添加到收藏夹 | ⏭️ |
| 3.3.2 | 从收藏夹打开ZIP | 点击收藏夹中的ZIP文件 | 进入ZIP浏览模式 | ⏭️ |

---

## 四、快捷键功能

| 序号 | 测试项 | 快捷键 | 预期结果 | 状态 |
|------|--------|--------|----------|------|
| 4.1 | 重命名文件 | `F2` | 进入编辑模式，光标自动聚焦到输入框 | ⏭️ |
| 4.2 | 删除文件 | `Delete` | 弹出删除确认对话框 | ⏭️ |
| 4.3 | 后退 | `Alt+←` | 返回上一个目录 | ⏭️ |
| 4.4 | 前进 | `Alt+→` | 前进到下一个目录 | ⏭️ |
| 4.5 | 保存文件 | `Ctrl+S` | 保存当前编辑的文件 | ⏭️ |

---

## 五、右键菜单功能

| 序号 | 测试项 | 操作步骤 | 预期结果 | 状态 |
|------|--------|----------|----------|------|
| 5.1 | 文件右键菜单 | 右键点击文件 | 显示菜单：打开、重命名、删除、收藏等 | ⏭️ |
| 5.2 | 空白处右键菜单 | 右键点击空白区域 | 显示菜单：新建文件、新建文件夹、刷新等 | ⏭️ |
| 5.3 | 菜单操作 | 点击各菜单项 | 对应功能正常执行 | ⏭️ |

---

## 六、界面交互功能

### 6.1 布局调整

| 序号 | 测试项 | 操作步骤 | 预期结果 | 状态 |
|------|--------|----------|----------|------|
| 6.1.1 | 调整面板宽度 | 拖动左右面板之间的分隔条 | 面板宽度变化 | ⏭️ |
| 6.1.2 | 显示/隐藏侧边栏 | 点击侧边栏按钮 | 侧边栏显示/隐藏切换 | ⏭️ |
| 6.1.3 | 调整编辑器高度 | 拖动编辑器底部边框 | 编辑器高度变化 | ⏭️ |

### 6.2 视觉反馈

| 序号 | 测试项 | 操作步骤 | 预期结果 | 状态 |
|------|--------|----------|----------|------|
| 6.2.1 | 文件选中效果 | 单击文件 | 文件背景高亮 | ⏭️ |
| 6.2.2 | 鼠标悬停效果 | 鼠标移到文件上 | 文件背景变化 | ⏭️ |
| 6.2.3 | 加载状态 | 执行文件操作 | 显示loading状态 | ⏭️ |
| 6.2.4 | 成功提示 | 操作成功 | 显示绿色成功提示 | ⏭️ |
| 6.2.5 | 错误提示 | 操作失败 | 显示红色错误提示 | ⏭️ |

---

## 七、边界情况测试

### 7.1 特殊文件

| 序号 | 测试项 | 操作步骤 | 预期结果 | 状态 |
|------|--------|----------|----------|------|
| 7.1.1 | 无扩展名文件 | 打开无扩展名的文件 | 根据内容判断是否为文本 | ⏭️ |
| 7.1.2 | 多点扩展名 | 打开 `file.tar.gz` | 正确识别为 `.gz` 文件 | ⏭️ |
| 7.1.3 | 大写扩展名 | 打开 `file.TXT` | 正确识别为文本文件 | ⏭️ |
| 7.1.4 | Unicode文件名 | 打开包含中文/日文的文件 | 正常显示和处理 | ⏭️ |
| 7.1.5 | 特殊字符文件名 | 打开包含空格/特殊字符的文件 | 正常打开 | ⏭️ |

### 7.2 边界路径

| 序号 | 测试项 | 操作步骤 | 预期结果 | 状态 |
|------|--------|----------|----------|------|
| 7.2.1 | 根目录 | 输入 `C:\` → 回车 | 显示C盘根目录内容 | ⏭️ |
| 7.2.2 | 深层路径 | 浏览多层嵌套目录 | 正常导航 | ⏭️ |
| 7.2.3 | 长路径 | 浏览路径超过260字符的文件 | 正常处理（如果系统支持） | ⏭️ |
| 7.2.4 | 网络路径 | 输入 `\\server\share` | 显示网络共享内容 | ⏭️ |

### 7.3 性能测试

| 序号 | 测试项 | 操作步骤 | 预期结果 | 状态 |
|------|--------|----------|----------|------|
| 7.3.1 | 大目录 | 浏览包含1000+文件的目录 | 正常显示，无明显卡顿 | ⏭️ |
| 7.3.2 | 大文件 | 打开接近5MB的文本文件 | 显示文件大小提示 | ⏭️ |
| 7.3.3 | 大ZIP文件 | 打开包含大量文件的ZIP | 正常显示文件列表 | ⏭️ |
| 7.3.4 | 快速切换 | 快速点击多个文件夹 | 响应及时，无错误 | ⏭️ |

---

## 八、跨平台兼容性（如适用）

| 序号 | 测试项 | Windows | macOS | Linux |
|------|--------|---------|-------|-------|
| 8.1 | 路径分隔符 | ✅ `\` 和 `/` | ✅ `/` | ✅ `/` |
| 8.2 | 系统路径 | ✅ `C:\Users` | ✅ `/Users` | ✅ `/home` |
| 8.3 | 快捷方式 | ✅ `.lnk` | ✅ Alias | ⚠️ Symbolic Link |
| 8.4 | 回收站 | ✅ 支持 | ✅ 支持 | ⚠️ 取决于桌面环境 |

---

## 九、错误处理

| 序号 | 测试项 | 操作步骤 | 预期结果 | 状态 |
|------|--------|----------|----------|------|
| 9.1 | 访问拒绝 | 尝试访问需要管理员权限的目录 | 显示权限错误提示 | ⏭️ |
| 9.2 | 路径不存在 | 输入不存在的路径 | 显示路径不存在提示 | ⏭️ |
| 9.3 | 无效文件名 | 新建文件时输入非法字符 | 显示文件名包含非法字符提示 | ⏭️ |
| 9.4 | 文件被占用 | 尝试删除被其他程序占用的文件 | 显示文件被占用提示 | ⏭️ |
| 9.5 | 磁盘满 | 尝试保存文件到已满的磁盘 | 显示磁盘空间不足提示 | ⏭️ |

---

## 十、总结

### 测试统计

- 总测试项：___ 项
- 通过：___ 项（___%）
- 失败：___ 项（___%）
- 跳过：___ 项（___%）
- 部分：___ 项（___%）

### 关键功能状态

| 功能模块 | 状态 | 备注 |
|----------|------|------|
| 文件浏览 | ⏭️ 待测试 | |
| 文件操作 | ⏭️ 待测试 | |
| 收藏夹 | ⏭️ 待测试 | 重点：跨目录打开 |
| ZIP浏览 | ⏭️ 待测试 | 新功能 |
| 快捷键 | ⏭️ 待测试 | |
| 界面交互 | ⏭️ 待测试 | |

### 遗留问题

| 序号 | 问题描述 | 严重程度 | 计划修复时间 |
|------|----------|----------|--------------|
| - | - | - | - |

### 建议

1. 优先测试收藏夹的跨目录打开功能
2. 重点验证ZIP浏览功能的稳定性
3. 检查快捷键在输入框中是否冲突
4. 测试大文件的性能表现

---

**测试人员**: _______________
**测试日期**: _______________
**测试环境**: Windows _____ / Go版本 _____ / Wails版本 _____
