新增：文档体系重构+CHANGELOG补充+发布产物清理

2026-05-01 22:22:06 +08:00
parent 3e1a540b83
commit 6eaaa56eb6
164 changed files with 40346 additions and 64 deletions
--- a/docs/07-项目管理/项目规划/PROJECT_STATUS.md
+++ b/docs/07-项目管理/项目规划/PROJECT_STATUS.md
@@ -0,0 +1,157 @@
+# U-Desk 项目状态
+
+**更新日期**：2026-01-29
+**版本**：v0.2.0 (开发中)
+**状态**：🚧 开发版本
+
+---
+
+## 📊 项目概览
+
+U-Desk 是基于 Wails 的桌面应用程序，集成了数据库客户端、文件管理、设备测试等功能。
+
+### 核心模块
+
+| 模块 | 状态 | 说明 |
+|------|------|------|
+| 数据库客户端 | ✅ 完成 | 支持 MySQL、Redis、MongoDB |
+| 文件管理 | ✅ 完成 | 模块化架构，支持预览和操作 |
+| 设备测试 | ✅ 完成 | 系统设备信息查询 |
+| 更新管理 | ✅ 完成 | 应用版本检查和自动更新 |
+
+---
+
+## 🎯 最近更新 (2026-01-28)
+
+### 架构优化
+- ✅ **文件系统模块化重构**：将文件管理功能拆分为多个独立模块
+  - `path_validator.go` - 路径验证
+  - `filetype_manager.go` - 文件类型管理
+  - `directory_stats.go` - 目录统计
+  - `audit_log.go` - 审计日志
+  - `file_lock.go` - 文件锁
+  - `recycle_bin.go` - 回收站
+  - `zip.go` / `zip_helper.go` - ZIP 压缩
+  - `service.go` - 核心服务
+  - `asset_handler.go` - 资源处理
+
+- ✅ **应用启动流程优化**：
+  - SQLite 快速初始化
+  - 核心 API 同步初始化
+  - 文件服务器异步启动
+  - UpdateAPI 异步初始化（涉及网络请求）
+
+### 前端优化
+- ✅ 新增 `CodeEditor.vue` 组件
+- ✅ 新增 Composables：
+  - `useFileOperations.js` - 文件操作
+  - `useFavoriteFiles.js` - 收藏文件
+  - `useLocalStorage.js` - 本地存储
+- ✅ 新增工具函数：
+  - `constants.js` - 常量定义
+  - `fileUtils.js` - 文件工具
+  - `debugLog.js` - 调试日志
+
+### 数据库客户端
+- ✅ MVP 功能全部完成
+- ✅ 右键菜单系统实现
+- ✅ 表结构查看功能（MySQL、MongoDB、Redis）
+- ✅ 测试连接功能
+
+---
+
+## 📚 文档
+
+### 设计文档
+- `docs/04-功能迭代/GO-DESK-1.尝试/` - 应用初始化和设备测试
+- `docs/04-功能迭代/GO-DESK-2.数据库客户端/` - 数据库客户端完整文档
+
+### 重构文档
+- `docs/filesystem-*.md` - 文件系统重构系列文档
+- `docs/架构改进*.md` - 架构改进文档
+
+---
+
+## 🚀 快速开始
+
+### 开发环境
+
+```bash
+# 安装依赖
+go mod tidy
+cd web && npm install
+
+# 构建前端
+cd web && npm run build
+
+# 开发模式
+wails dev
+```
+
+### 构建
+
+```bash
+# 构建应用
+wails build
+
+# 产物位置
+build/bin/go-desk.exe
+```
+
+---
+
+## 🔧 技术栈
+
+- **后端**：Go 1.25+、Wails v2
+- **前端**：Vue 3、Arco Design Vue、Vite
+- **存储**：SQLite、MySQL、Redis、MongoDB
+
+---
+
+## 📋 待办事项
+
+### P0 (高优先级)
+- [ ] 完善表结构编辑功能
+- [ ] 性能优化
+- [ ] 错误处理优化
+
+### P1 (中优先级)
+- [ ] 数据导出、导入功能
+- [ ] 查询历史管理
+- [ ] 结果集分页和筛选
+
+### P2 (低优先级)
+- [ ] 多数据库类型支持扩展
+- [ ] 高级功能（数据同步、备份等）
+
+---
+
+## 📝 版本历史
+
+### v0.2.0 (2026-01-28)
+- ✅ 模块重命名：go-desk → u-desk
+- ✅ 依赖更新：所有依赖包更新到最新版本
+- ✅ 文档更新：版本号调整为开发版本
+
+### v0.1.0 (2026-01-28)
+- ✅ 文件系统模块化重构
+- ✅ 应用启动流程优化
+- ✅ 数据库客户端 MVP 完成
+- ✅ 文档更新
+
+### v0.9.0 (2026-01-27)
+- ✅ 文件管理功能
+- ✅ 设备测试功能
+- ✅ 更新管理功能
+
+---
+
+## 👥 贡献
+
+本项目用于学习和测试目的。
+
+---
+
+## 📄 许可
+
+本项目仅供学习和测试使用。
--- a/docs/07-项目管理/项目规划/README.md
+++ b/docs/07-项目管理/项目规划/README.md
@@ -0,0 +1,16 @@
+# 项目规划文档
+
+本目录包含项目状态、工作计划和设计相关文档。
+
+## 📄 文档列表
+
+- [PROJECT_STATUS.md](./PROJECT_STATUS.md) - 项目状态总览
+- [work-plan.md](./work-plan.md) - 工作计划
+- [action-area-redesign.md](./action-area-redesign.md) - 操作区重设计
+- [minimalist-design-final.md](./minimalist-design-final.md) - 极简设计最终版
+
+## 🎯 用途
+
+- 了解项目当前状态
+- 规划开发任务
+- 设计参考
--- a/docs/07-项目管理/项目规划/action-area-redesign.md
+++ b/docs/07-项目管理/项目规划/action-area-redesign.md
@@ -0,0 +1,489 @@
+# 操作区域重新设计
+
+## 设计理念
+
+### 从"按钮"到"操作卡片"
+
+传统按钮虽然常见，但缺乏信息层次和视觉吸引力。我们采用**卡片式操作区域**，提供：
+
+- ✅ 更大的点击区域
+- ✅ 更清晰的说明文字
+- ✅ 更丰富的视觉信息
+- ✅ 更现代的设计风格
+
+---
+
+## 优化前后对比
+
+### 优化前（传统按钮）
+
+```
+┌──────────────────────────────────────────────┐
+│                                              │
+│                       [ 跳过此版本 ]          │ ← 传统按钮
+│                       [ 立即更新 ↓ ]          │
+│                                              │
+│ ☐ 提醒我稍后更新                             │ ← 复选框
+└──────────────────────────────────────────────┘
+```
+
+**问题：**
+- 信息量少，只显示操作名称
+- 说明文字（复选框）分离，不连贯
+- 视觉单调，缺乏层次
+- 点击区域较小
+
+### 优化后（操作卡片）
+
+```
+┌──────────────────────────────────────────────┐
+│                                              │
+│ ┌────────────────────────────────────────┐  │
+│ │ ✕ 稍后更新                             │  │ ← 图标 + 标题 + 说明
+│ │    跳过此版本，下次启动时再提醒         │  │
+│ └────────────────────────────────────────┘  │
+│                                              │
+│ ┌────────────────────────────────────────┐  │
+│ │ ↓ 立即更新到最新版本                → │  │ ← 主操作（突出）
+│ │    点击下载 45.2 MB 安装包            │  │
+│ └────────────────────────────────────────┘  │
+│                                              │
+│     ☐ 下次启动时继续提醒我                   │ ← 提醒选项
+└──────────────────────────────────────────────┘
+```
+
+**优势：**
+- 每个操作都有清晰的说明
+- 信息层次分明（图标 + 标题 + 描述）
+- 更大的点击区域
+- 视觉更丰富、更现代
+
+---
+
+## 设计细节
+
+### 1. 稍后更新（次要操作）
+
+```vue
+<div class="action-item skip-action" @click="handleSkip">
+  <div class="action-content">
+    <icon-close class="action-icon" />
+    <div class="action-text">
+      <div class="action-title">稍后更新</div>
+      <div class="action-desc">跳过此版本，下次启动时再提醒</div>
+    </div>
+  </div>
+</div>
+```
+
+**样式：**
+- 图标：关闭图标（✕）- 表示跳过
+- 背景：浅灰色（`var(--color-fill-3)`）
+- 悬停效果：轻微上移
+- 说明文字：灰色小字
+
+### 2. 立即更新（主要操作）
+
+```vue
+<div class="action-item primary-action" @click="handleDownload">
+  <div class="action-content">
+    <icon-download class="action-icon" />
+    <div class="action-text">
+      <div class="action-title">立即更新到最新版本</div>
+      <div class="action-desc">点击下载 45.2 MB 安装包</div>
+    </div>
+    <div class="action-arrow">
+      <icon-arrow-right />
+    </div>
+  </div>
+</div>
+```
+
+**样式：**
+- 图标：下载图标（↓）- 蓝色背景
+- 背景：主题色背景（`var(--color-primary-light-1)`）
+- 右侧箭头：→ 表示进入下一步
+- 悬停效果：
+  - 背景变为主题色
+  - 图标变为白色
+  - 箭头向右移动
+
+### 3. 安装中状态
+
+```vue
+<div class="action-item installing-action">
+  <div class="action-content">
+    <icon-loading class="action-icon spinning" />
+    <div class="action-text">
+      <div class="action-title">正在安装更新</div>
+      <div class="action-desc">安装完成后应用将自动重启，请稍候...</div>
+    </div>
+  </div>
+</div>
+```
+
+**样式：**
+- 图标：加载图标（旋转动画）
+- 背景：绿色背景（成功色）
+- 不可点击（`pointer-events: none`）
+- 图标旋转动画
+
+---
+
+## 交互设计
+
+### 悬停效果
+
+**普通状态：**
+```
+┌────────────────────────────────────────┐
+│ ↓ 立即更新到最新版本                → │
+│    点击下载 45.2 MB 安装包            │
+└────────────────────────────────────────┘
+背景：浅色
+图标：蓝色背景，白色图标
+箭头：深灰色，固定位置
+```
+
+**悬停状态：**
+```
+┌────────────────────────────────────────┐
+│ ↓ 立即更新到最新版本                → │  ← 箭头右移
+│    点击下载 45.2 MB 安装包            │
+└────────────────────────────────────────┘
+背景：主题色
+图标：白色背景，蓝色图标
+箭头：主题色，向右移动 4px
+```
+
+### 点击反馈
+
+```
+悬停 → 上移 1px
+点击 → 下移 0px（回到原位）
+```
+
+### 加载状态
+
+```
+┌────────────────────────────────────────┐
+│ ⟳ 立即更新到最新版本                   │  ← 图标脉冲动画
+│    正在准备下载...                    │
+└────────────────────────────────────────┘
+不透明度：0.6
+不可点击
+```
+
+---
+
+## 完整样式代码
+
+```css
+.action-section {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+
+.action-item {
+  background: var(--color-fill-1);
+  border: 1px solid var(--color-border-1);
+  border-radius: 8px;
+  padding: 16px;
+  cursor: pointer;
+  transition: all 0.2s ease;
+
+  &:hover {
+    background: var(--color-fill-2);
+    border-color: var(--color-border-2);
+    transform: translateY(-1px);
+  }
+
+  &:active {
+    transform: translateY(0);
+  }
+
+  .action-content {
+    display: flex;
+    align-items: center;
+    gap: 12px;
+  }
+
+  .action-icon {
+    width: 40px;
+    height: 40px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    background: var(--color-fill-3);
+    color: var(--color-text-2);
+    border-radius: 8px;
+    font-size: 18px;
+    flex-shrink: 0;
+  }
+
+  .action-text {
+    flex: 1;
+  }
+
+  .action-title {
+    font-size: 14px;
+    font-weight: 500;
+    color: var(--color-text-1);
+    margin-bottom: 2px;
+  }
+
+  .action-desc {
+    font-size: 12px;
+    color: var(--color-text-3);
+  }
+
+  .action-arrow {
+    color: var(--color-text-3);
+    font-size: 16px;
+    transition: all 0.2s ease;
+  }
+
+  &:hover .action-arrow {
+    color: var(--color-text-1);
+    transform: translateX(4px);
+  }
+}
+
+.primary-action {
+  background: var(--color-fill-2);
+  border-color: var(--color-border-2);
+
+  .action-icon {
+    background: var(--color-primary-light-1);
+    color: var(--color-primary-6);
+  }
+
+  &:hover {
+    background: var(--color-primary-light-1);
+    border-color: var(--color-primary-3);
+
+    .action-icon {
+      background: var(--color-primary-6);
+      color: white;
+    }
+
+    .action-title {
+      color: var(--color-primary-6);
+    }
+  }
+}
+
+@keyframes spin {
+  from { transform: rotate(0deg); }
+  to { transform: rotate(360deg); }
+}
+
+@keyframes pulse {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.6; }
+}
+```
+
+---
+
+## 强制更新场景
+
+### 优化前
+```
+┌──────────────────────────────────────────────┐
+│              [ 立即更新 ]                      │ ← 只有一个按钮
+└──────────────────────────────────────────────┘
+```
+
+### 优化后
+```
+┌──────────────────────────────────────────────┐
+│                                              │
+│ ┌────────────────────────────────────────┐  │
+│ │ ↓ 立即更新到最新版本                → │  │ ← 卡片式操作
+│ │    点击下载 45.2 MB 安装包            │  │
+│ └────────────────────────────────────────┘  │
+│                                              │
+│ ⚠️ 重要提示                                   │
+│ 此版本包含重要的安全更新和问题修复...        │
+└──────────────────────────────────────────────┘
+```
+
+**改进：**
+- 不再是冷冰冰的单个按钮
+- 提供更多上下文信息
+- 更大的点击区域
+- 更友好的引导
+
+---
+
+## 响应式设计
+
+### 大屏幕（> 600px）
+```
+┌────────────────────────────────────────────┐
+│ ✕ 稍后更新                                 │
+│    跳过此版本，下次启动时再提醒             │
+└────────────────────────────────────────────┘
+
+┌────────────────────────────────────────────┐
+│ ↓ 立即更新到最新版本                →     │
+│    点击下载 45.2 MB 安装包                │
+└────────────────────────────────────────────┘
+```
+
+### 小屏幕（< 600px）
+```
+布局保持一致，卡片宽度自适应
+```
+
+---
+
+## 可访问性
+
+### 键盘导航
+- ✅ Tab 键切换焦点
+- ✅ Enter/Space 键激活
+- ✅ 清晰的焦点指示器
+
+### 屏幕阅读器
+- ✅ 语义化的结构
+- ✅ 清晰的标签和描述
+- ✅ 视觉和文本信息一致
+
+### 对比度
+- ✅ 标题文字对比度 > 4.5:1
+- ✅ 描述文字对比度 > 4.5:1
+- ✅ 图标与背景对比度 > 3:1
+
+---
+
+## 动画效果
+
+### 1. 悬停上移
+```css
+transform: translateY(-1px);
+```
+**目的：** 提供视觉反馈，表示可点击
+
+### 2. 箭头移动
+```css
+transform: translateX(4px);
+```
+**目的：** 强调进入下一步的操作
+
+### 3. 图标旋转（安装中）
+```css
+animation: spin 1s linear infinite;
+```
+**目的：** 表示正在进行中
+
+### 4. 图标脉冲（准备中）
+```css
+animation: pulse 1.5s ease-in-out infinite;
+```
+**目的：** 表示等待响应
+
+---
+
+## 视觉层次
+
+### 信息密度
+```
+图标（40×40）→ 标题（14px）→ 描述（12px）→ 箭头（16px）
+   ↓                ↓               ↓              ↓
+视觉焦点         主要信息      辅助说明      方向指示
+```
+
+### 颜色层次
+```
+主要操作：主题色背景 + 蓝色图标
+次要操作：灰色背景 + 灰色图标
+安装中：绿色背景 + 绿色图标
+```
+
+---
+
+## 用户体验提升
+
+### 优化前
+- ❌ 只显示操作名称
+- ❌ 不清楚操作后果
+- ❌ 点击区域小
+- ❌ 视觉单调
+
+### 优化后
+- ✅ 操作 + 说明文字
+- ✅ 清晰的上下文信息
+- ✅ 整个卡片可点击
+- ✅ 丰富的视觉反馈
+
+### 数据对比
+| 维度 | 优化前 | 优化后 |
+|------|--------|--------|
+| 信息量 | 少 | 丰富 |
+| 点击区域 | 100×32px | 整个卡片 |
+| 视觉层次 | 单层 | 三层（图标/标题/描述） |
+| 交互反馈 | 简单 | 丰富 |
+
+---
+
+## 实现代码
+
+### 模板部分
+```vue
+<!-- 操作区域 -->
+<div class="action-section">
+  <!-- 稍后更新 -->
+  <div class="action-item skip-action" @click="handleSkip">
+    <div class="action-content">
+      <icon-close class="action-icon" />
+      <div class="action-text">
+        <div class="action-title">稍后更新</div>
+        <div class="action-desc">跳过此版本，下次启动时再提醒</div>
+      </div>
+    </div>
+  </div>
+
+  <!-- 立即更新 -->
+  <div class="action-item primary-action" @click="handleDownload">
+    <div class="action-content">
+      <icon-download class="action-icon" />
+      <div class="action-text">
+        <div class="action-title">立即更新到最新版本</div>
+        <div class="action-desc">点击下载 {{ formatFileSize(fileSize) }} 安装包</div>
+      </div>
+      <div class="action-arrow">
+        <icon-arrow-right />
+      </div>
+    </div>
+  </div>
+</div>
+```
+
+### 样式部分
+见上方"完整样式代码"
+
+---
+
+## 总结
+
+### 核心改进
+1. ✅ **信息更丰富** - 标题 + 描述文字
+2. ✅ **视觉更现代** - 卡片式设计
+3. ✅ **操作更友好** - 大点击区域
+4. ✅ **反馈更及时** - 丰富的悬停效果
+
+### 设计原则
+> 让用户清楚知道每个操作的含义和后果
+
+### 用户体验
+- 清晰的信息层次
+- 大的点击区域
+- 丰富的视觉反馈
+- 现代的设计风格
+
+---
+
+**操作区域重新设计完成！** 🎉
--- a/docs/07-项目管理/项目规划/minimalist-design-final.md
+++ b/docs/07-项目管理/项目规划/minimalist-design-final.md
@@ -0,0 +1,342 @@
+# 升级提示 - 简约设计最终版
+
+## ✅ 简化完成
+
+### 核心改进
+1. ✅ 去掉所有图标（除了必要的状态图标）
+2. ✅ 简化信息展示（去掉卡片背景和图标）
+3. ✅ 简化按钮（传统按钮，无多余装饰）
+4. ✅ 减少间距和字体
+5. ✅ 更快的动画（0.15s）
+
+---
+
+## 🎨 最终效果
+
+### 普通更新弹窗
+
+```
+┌──────────────────────────────────────────────┐
+│ 发现新版本       v0.1.0 → v0.1.2        [×]   │
+├──────────────────────────────────────────────┤
+│                                              │
+│ 发布日期        2026-01-28                   │
+│ 文件大小        45.2 MB                      │
+│                                              │
+│ 更新内容                                    │
+│ • 测试更新                                   │
+│ • 新功能测试                                 │
+│ • 性能优化                                   │
+│                                              │
+│ ┌────────────────────────────────────────┐  │
+│ │            立即更新                     │  │ ← 简约按钮
+│ └────────────────────────────────────────┘  │
+│                                              │
+│ ┌───────────────────┐ ┌────────────────┐     │
+│ │     稍后更新      │ │ ☐ 下次提醒我  │     │
+│ └───────────────────┘ └────────────────┘     │
+└──────────────────────────────────────────────┘
+```
+
+### 强制更新弹窗
+
+```
+┌──────────────────────────────────────────────┐
+│ ⚠ 重要更新                            [×]   │
+├──────────────────────────────────────────────┤
+│                                              │
+│ 发布日期        2026-01-28                   │
+│ 文件大小        45.2 MB                      │
+│                                              │
+│ 更新内容                                    │
+│ • 修复严重安全漏洞                           │
+│ • 修复数据损坏问题                           │
+│ • 优化系统稳定性                             │
+│                                              │
+│ ⚠️ 重要提示                                   │
+│ 此版本包含重要的安全更新和问题修复，         │
+│ 为保障正常使用，请完成更新后再继续。         │
+│                                              │
+│ ┌────────────────────────────────────────┐  │
+│ │            立即更新                     │  │
+│ └────────────────────────────────────────┘  │
+└──────────────────────────────────────────────┘
+```
+
+---
+
+## 📊 简化对比
+
+| 元素 | 简化前 | 简化后 | 改进 |
+|------|--------|--------|------|
+| **版本徽章** | 图标+文字+渐变 | 纯文字+边框 | ✅ 更简洁 |
+| **版本信息** | 卡片+图标+标签 | 纯文字行 | ✅ 扁平化 |
+| **更新日志** | 图标+标题+边框 | 纯文字 | ✅ 极简化 |
+| **操作区域** | 卡片式（图标+标题+说明+箭头） | 简约按钮 | ✅ 传统设计 |
+| **按钮** | 大尺寸（120px宽） | 正常尺寸 | ✅ 标准化 |
+| **圆角** | 6-8px | 4px | ✅ 更小 |
+| **动画** | 0.2s+缩放 | 0.15s+平移 | ✅ 更快 |
+| **弹窗宽度** | 580px | 480px | ✅ 更紧凑 |
+
+---
+
+## 🎯 设计原则
+
+### 极简主义
+> 去掉一切不必要的装饰，只保留核心功能
+
+### 核心保留
+- ✅ 版本信息
+- ✅ 更新日志
+- ✅ 操作按钮
+- ✅ 进度显示
+
+### 移除元素
+- ❌ 装饰性图标（日历、文件、书本等）
+- ❌ 卡片背景
+- ❌ 多余的说明文字
+- ❌ 复杂的悬停效果
+- ❌ 箭头图标
+
+---
+
+## 📐 最终规格
+
+### 尺寸
+- 弹窗宽度：480px
+- 弹窗内边距：20px
+- 元素间距：16px（区块）、8px（小元素）
+- 按钮内边距：10px 16px
+- 按钮圆角：4px
+- 徽章圆角：4px
+
+### 字体
+- 徽章：13px / 400
+- 标题：13px / 500
+- 正文：13px / 400
+- 小字：12px / 400
+
+### 颜色
+- 背景：`var(--color-fill-1/2/3)`
+- 边框：`var(--color-border-1/2)`
+- 文字：`var(--color-text-1/2/3)`
+- 主题色：`var(--color-primary-6)`
+- 警告色：`var(--color-warning-*)`
+
+### 动画
+- 弹窗进入：0.15s
+- 按钮悬停：0.2s
+- 位移距离：8px
+
+---
+
+## 💡 设计亮点
+
+### 1. 信息扁平化
+```
+简化前：
+┌──────────────────┐
+│ 📅               │ ← 图标
+│    发布日期       │
+│    2026-01-28     │
+└──────────────────┘
+
+简化后：
+发布日期        2026-01-28  ← 纯文字
+```
+
+### 2. 按钮简约化
+```
+简化前：
+┌────────────────────────────────────────┐
+│ ↓ 立即更新到最新版本                → │  ← 卡片式
+│    点击下载 45.2 MB 安装包            │
+└────────────────────────────────────────┘
+
+简化后：
+┌────────────────────────────────────────┐
+│            立即更新                     │  ← 纯按钮
+└────────────────────────────────────────┘
+```
+
+### 3. 布局紧凑化
+```
+简化前：gap: 20px（卡片间距）
+简化后：gap: 16px（区块间距）、gap: 8px（元素间距）
+```
+
+---
+
+## 🔄 交互流程
+
+### 普通更新
+```
+1. 点击"立即更新"
+   ↓
+2. 开始下载（显示进度条）
+   ↓
+3. 下载完成，自动安装
+   ↓
+4. 安装成功，应用重启
+```
+
+### 强制更新
+```
+1. 弹窗显示（无法关闭）
+   ↓
+2. 点击"立即更新"（唯一操作）
+   ↓
+3. 自动下载和安装
+   ↓
+4. 安装成功，应用重启
+```
+
+---
+
+## 📱 代码结构
+
+### 模板（简化）
+```vue
+<template>
+  <a-modal>
+    <!-- 版本徽章 + 版本对比 -->
+    <!-- 版本信息（纯文字行） -->
+    <!-- 更新日志（纯文字） -->
+    <!-- 强制更新提示（保留） -->
+    <!-- 下载进度（保留） -->
+    <!-- 操作按钮（简约） -->
+  </a-modal>
+</template>
+```
+
+### 样式（简化）
+```vue
+<style scoped>
+/* 去掉所有卡片样式 */
+/* 去掉所有图标样式 */
+/* 使用纯文字布局 */
+/* 标准按钮样式 */
+/* 简化的动画 */
+</style>
+```
+
+---
+
+## 🎨 视觉层次
+
+### 信息优先级
+```
+1. 操作按钮（最重要）
+   └> 主题色背景，白色文字
+
+2. 强制更新提示（次重要）
+   └> 左侧橙色边框
+
+3. 版本信息（一般）
+   └> 纯文字，左侧对齐
+
+4. 更新日志（辅助）
+   └> 小字，灰色
+```
+
+### 留白策略
+```
+区块间距：16px
+元素间距：8px
+文字内边距：4px
+
+整体感觉：紧凑但不拥挤
+```
+
+---
+
+## ✨ 核心价值
+
+### 极简而不简陋
+- ✅ 保留所有必要信息
+- ✅ 去掉所有装饰元素
+- ✅ 专注功能本身
+
+### 协调而非突出
+- ✅ 使用系统主题变量
+- ✅ 与整体风格一致
+- ✅ 不抢眼但实用
+
+### 快速而非拖沓
+- ✅ 更快的动画（0.15s）
+- ✅ 更小的位移（8px）
+- ✅ 更紧凑的布局
+
+---
+
+## 📋 使用方式
+
+### 立即可用
+```bash
+# 前端已构建成功
+wails dev
+```
+
+### 预期效果
+- 应用启动后 5 秒自动检查更新
+- 发现新版本显示简约弹窗
+- 点击"立即更新"自动下载和安装
+- 安装完成后应用自动重启
+
+---
+
+## 🎯 最终目标达成
+
+### 从"丰富"到"必要"
+```
+优化前：图标+卡片+装饰+说明
+优化后：文字+按钮+功能
+```
+
+### 从"突出"到"融入"
+```
+优化前：鲜艳的颜色，大的间距
+优化后：系统变量，紧凑布局
+```
+
+### 从"复杂"到"简单"
+```
+优化前：卡片式操作区域
+优化后：标准按钮
+```
+
+---
+
+## 📊 简化数据
+
+| 指标 | 简化前 | 简化后 | 减少 |
+|------|--------|--------|------|
+| 图标数量 | 6+ 个 | 1 个 | ⬇️ 83% |
+| 卡片数量 | 4 个 | 1 个 | ⬇️ 75% |
+| 代码行数 | 750 行 | 535 行 | ⬇️ 28% |
+| 样式类数 | 20+ 个 | 10 个 | ⬇️ 50% |
+| 动画时长 | 0.2s | 0.15s | ⬇️ 25% |
+| 弹窗宽度 | 580px | 480px | ⬇️ 17% |
+
+---
+
+## 🎉 总结
+
+### 设计哲学
+> **Less is More** - 少即是多
+
+### 核心原则
+1. **功能优先** - 保留核心功能
+2. **装饰最小化** - 去掉不必要元素
+3. **布局紧凑化** - 减少空间浪费
+4. **风格统一化** - 与系统协调
+
+### 最终效果
+- ✅ 简约而不简陋
+- ✅ 紧凑而不拥挤
+- ✅ 快速而不突兀
+- ✅ 实用而不花哨
+
+---
+
+**简约设计完成！极简、协调、实用！** ✨
--- a/docs/07-项目管理/项目规划/work-plan.md
+++ b/docs/07-项目管理/项目规划/work-plan.md
@@ -0,0 +1,422 @@
+# Go Desk 项目 - 多角度审视与工作计划
+
+**生成时间**: 2026-01-26
+**项目状态**: 功能开发阶段，存在技术债务
+**当前代码量**: 2590 行（重复率 59.7%）
+
+---
+
+## 🎭 各角色角度审视
+
+### 1️⃣ UX设计师视角
+
+#### ✅ 做得好的地方
+- **紧凑工具栏设计**：48px高度，功能集中，符合Fitts定律
+- **渐进式披露**：收藏夹、历史记录按需显示
+- **视觉一致性**：统一的间距、字体、圆角规范
+- **交互反馈**：拖拽时有清晰的视觉提示（hover、cursor变化）
+
+#### ❌ 存在的问题
+1. **交互模式不一致**
+   - DeviceTest.vue：使用 a-card + a-row 布局（旧设计）
+   - FileSystem.vue：使用自定义工具栏 + 侧边栏（新设计）
+   - **用户困惑**：两个"文件管理"功能，操作方式完全不同
+
+2. **功能发现率低**
+   - 侧边栏默认隐藏，用户可能不知道有收藏功能
+   - 没有视觉提示引导用户发现高级功能
+
+3. **缺少空状态引导**
+   - 首次使用时没有引导流程
+   - 空文件夹的提示不够友好
+
+#### 💡 UX改进建议
+- [ ] **统一交互模式**：将 FileSystem.vue 的新设计应用到 DeviceTest.vue
+- [ ] **添加首次引导**：简单的tooltip或empty state引导
+- [ ] **侧边栏记忆**：记住用户是否打开了侧边栏
+- [ ] **统一操作反馈**：所有成功操作使用一致的动画效果
+
+---
+
+### 2️⃣ CTO视角
+
+#### ❌ 技术债务问题（严重）
+1. **代码重复率 59.7%**
+   - 439 行重复代码
+   - 违反DRY原则，维护成本x2
+
+2. **缺少架构分层**
+   - 没有统一的业务逻辑层
+   - 组件直接调用API，缺少抽象
+   - 状态管理散乱（localStorage到处都是）
+
+3. **可测试性差**
+   - 没有单元测试
+   - 业务逻辑耦合在组件中，无法单独测试
+   - 缺少类型定义，运行时错误风险高
+
+4. **过度设计**
+   - FileSystem.vue（1374行）职责过多
+   - 媒体预览功能可以独立成服务
+   - 拖拽逻辑应该抽象为通用composable
+
+#### ✅ 技术亮点
+- API调用方式统一（有良好的基础）
+- 错误处理模式一致
+- 使用了现代Vue3 Composition API
+
+#### 💡 架构改进建议
+- [ ] **紧急**：建立composables抽象层（减少60%重复代码）
+- [ ] **本周**：统一localStorage键名管理
+- [ ] **本月**：引入TypeScript类型定义
+- [ ] **下月**：建立单元测试体系（目标70%覆盖率）
+
+---
+
+### 3️⃣ 程序员视角
+
+#### 😵 当前的痛点
+1. **改一个功能要改两个地方**
+   ```javascript
+   // 例如：修改收藏功能
+   DeviceTest.vue: toggleFavorite()    // 要改这里
+   FileSystem.vue: toggleFavorite()   // 还要改这里
+   ```
+
+2. **FileSystem.vue太复杂**
+   - 1374行，34个函数
+   - 状态变量15+个，难以追踪
+   - 添加新功能时容易引入bug
+
+3. **缺少类型提示**
+   - `fileList.value` 的数据结构不明确
+   - 函数参数没有类型检查
+   - 只能靠运行时测试发现错误
+
+4. **调试困难**
+   - 没有日志系统
+   - 错误堆栈难以追踪
+   - localStorage操作失败时静默失败
+
+#### 💡 开发体验改进
+- [ ] **立即**：抽取公共composables（useFileOperations, useFavoriteFiles）
+- [ ] **本周**：添加ESLint规则，强制统一代码风格
+- [ ] **本月**：引入Vitest + TypeScript
+- [ ] **长期**：建立错误监控和日志系统
+
+---
+
+### 4️⃣ 用户视角
+
+#### ✅ 功能完整性
+- ✅ 历史记录（方便回溯）
+- ✅ 收藏夹（快速访问）
+- ✅ 拖拽调整（灵活布局）
+- ✅ 文件预览（图片、视频、PDF）
+- ✅ 点击即打开（流畅操作）
+
+#### ⚠️ 用户困惑点
+1. **两个入口做什么？**
+   - "文件管理"和"设备调用测试"都能操作文件
+   - 功能重复，不知道该用哪个
+
+2. **收藏的文件在哪里？**
+   - 侧边栏默认隐藏
+   - 没有明确提示
+
+3. **为什么有些操作不一样？**
+   - DeviceTest.vue：列出目录后要手动点文件名
+   - FileSystem.vue：点击即打开
+
+#### 💡 用户价值优化
+- [ ] **合并入口**：只保留一个"文件管理"入口
+- [ ] **简化操作**：统一"点击即打开"的交互模式
+- [ ] **功能提示**：首次使用时显示功能引导
+- [ ] **键盘快捷键**：常用操作添加快捷键支持
+
+---
+
+### 5️⃣ 产品经理视角
+
+#### 📊 当前状态评估
+- **功能完成度**: 90% （核心功能都有）
+- **用户体验**: 70% （有用但不精致）
+- **技术健康度**: 50% （存在严重技术债务）
+- **市场竞争力**: 65% （功能完整但体验一般）
+
+#### 💰 成本分析
+- **重复功能开发成本**: 高（两个相似的文件管理页面）
+- **维护成本**: 高（改一个功能要改两个地方）
+- **bug率**: 中等（代码重复导致同步问题）
+- **新增功能成本**: 高（缺少公共抽象，每次都从零开始）
+
+#### 🎯 产品策略建议
+- [ ] **短期**：合并重复功能，统一用户体验
+- [ ] **中期**：偿还技术债务，提升开发效率
+- [ ] **长期**：建立差异化功能（如：批量操作、文件搜索、同步功能）
+
+---
+
+## 📋 综合工作计划
+
+基于以上分析，制定以下分阶段工作计划：
+
+---
+
+## 🚀 第一阶段：偿还技术债务（Week 1-2）
+
+**优先级**: 🔴 紧急
+**目标**: 减少代码重复，建立公共抽象层
+
+### Week 1: 创建公共 Composables
+
+#### Day 1-2: 核心 Composables
+```bash
+src/composables/
+├── useFileOperations.js     # 文件操作逻辑（2h）
+├── useFavoriteFiles.js      # 收藏功能（1.5h）
+├── usePathHistory.js        # 历史记录（1h）
+└── useLocalStorage.js       # localStorage封装（1.5h)
+```
+
+**验收标准**:
+- [ ] Composables有完整的TypeScript类型定义
+- [ ] 单元测试覆盖率>80%
+- [ ] DeviceTest和FileSystem都使用这些composables
+
+#### Day 3-4: 工具函数和常量
+```bash
+src/utils/
+├── fileUtils.js             # formatBytes, getFileIcon等（1h）
+└── constants.js             # STORAGE_KEYS, FILE_EXTENSIONS（1h）
+
+src/composables/
+└── useResizable.js          # 拖拽调整逻辑（1h）
+```
+
+**验收标准**:
+- [ ] 所有常量统一管理
+- [ ] 文件类型判断逻辑只有一处
+- [ ] 工具函数有单元测试
+
+### Week 2: 重构组件
+
+#### Day 1-2: 重构 DeviceTest.vue
+- [ ] 使用新的composables替换内联逻辑
+- [ ] 简化模板代码
+- [ ] 保持功能不变
+
+**预期效果**: 738行 → 300行（减少59%）
+
+#### Day 3-4: 重构 FileSystem.vue
+- [ ] 使用新的composables
+- [ ] 抽取FilePreviewer组件
+- [ ] 简化媒体预览逻辑
+
+**预期效果**: 1374行 → 500行（减少64%）
+
+#### Day 5: 回归测试
+- [ ] 手动测试所有功能
+- [ ] 修复重构引入的bug
+- [ ] 更新文档
+
+---
+
+## 🎨 第二阶段：统一用户体验（Week 3-4）
+
+**优先级**: 🟡 高
+**目标**: 统一交互模式，提升用户体验
+
+### Week 3: 统一交互设计
+
+#### Day 1-2: 统一布局结构
+- [ ] DeviceTest.vue采用FileSystem.vue的工具栏设计
+- [ ] 两个页面使用相同的文件列表组件
+- [ ] 统一拖拽交互
+
+#### Day 3-4: 优化用户体验
+- [ ] 添加首次使用引导
+- [ ] 优化空状态提示
+- [ ] 添加loading骨架屏
+- [ ] 统一成功/失败提示
+
+### Week 4: 功能整合
+
+#### Day 1-2: 合并重复入口
+- [ ] 讨论：是否合并"文件管理"和"设备调用测试"
+- [ ] 如果合并：决定保留哪个，迁移功能
+- [ ] 如果不合并：明确两者定位差异
+
+#### Day 3-4: 功能增强
+- [ ] 添加键盘快捷键
+- [ ] 批量操作功能
+- [ ] 文件搜索功能
+- [ ] 操作历史撤销/重做
+
+---
+
+## 🧪 第三阶段：质量保障（Week 5-6）
+
+**优先级**: 🟢 中
+**目标**: 建立测试体系，提升代码质量
+
+### Week 5: 单元测试
+
+#### Day 1-2: Composables测试
+```bash
+tests/composables/
+├── useFileOperations.spec.js
+├── useFavoriteFiles.spec.js
+├── usePathHistory.spec.js
+└── useLocalStorage.spec.js
+```
+
+**目标**: 覆盖率>80%
+
+#### Day 3-4: 工具函数测试
+```bash
+tests/utils/
+├── fileUtils.spec.js
+└── constants.spec.js
+```
+
+### Week 6: 集成测试和文档
+
+#### Day 1-2: 组件测试
+- [ ] DeviceTest.vue快照测试
+- [ ] FileSystem.vue快照测试
+- [ ] 公共组件测试
+
+#### Day 3-4: 文档和指南
+- [ ] 组件使用文档
+- [ ] Composables API文档
+- [ ] 贡献指南
+
+---
+
+## 🔮 第四阶段：性能优化（Week 7-8）
+
+**优先级**: 🟢 中
+**目标**: 优化性能，提升响应速度
+
+### Week 7: 性能优化
+
+#### Day 1-2: 虚拟滚动
+- [ ] 大文件列表使用虚拟滚动
+- [ ] 图片懒加载
+
+#### Day 3-4: 缓存优化
+- [ ] 文件列表缓存
+- [ ] 预览内容缓存
+- [ ] 路径解析缓存
+
+### Week 8: 高级功能
+
+#### Day 1-2: 批量操作
+- [ ] 多选文件
+- [ ] 批量删除
+- [ ] 批量下载
+
+#### Day 3-4: 搜索和过滤
+- [ ] 文件名搜索
+- [ ] 文件类型过滤
+- [ ] 大小过滤
+- [ ] 时间过滤
+
+---
+
+## 📊 优先级矩阵
+
+根据**影响力**和**紧急程度**排序：
+
+| 任务 | 影响力 | 紧急度 | 优先级 | 预计工时 |
+|------|--------|--------|--------|----------|
+| 抽取Composables | 高 | 高 | 🔴 P0 | 16h |
+| 统一常量管理 | 高 | 高 | 🔴 P0 | 4h |
+| 重构DeviceTest.vue | 高 | 高 | 🔴 P0 | 8h |
+| 重构FileSystem.vue | 高 | 高 | 🔴 P0 | 12h |
+| 统一交互模式 | 中 | 高 | 🟡 P1 | 16h |
+| 单元测试 | 中 | 中 | 🟡 P1 | 16h |
+| TypeScript迁移 | 高 | 低 | 🟢 P2 | 40h |
+| 性能优化 | 中 | 低 | 🟢 P2 | 16h |
+| 高级功能 | 中 | 低 | 🟢 P2 | 24h |
+
+---
+
+## 🎯 成功指标
+
+### 技术指标
+- [ ] **代码复用率**: 40% → 80%
+- [ ] **代码行数**: 2590 → 1500（减少42%）
+- [ ] **单元测试覆盖率**: 0% → 70%
+- [ ] **TypeScript覆盖率**: 0% → 100%
+- [ ] **代码重复率**: 59.7% → <10%
+
+### 用户体验指标
+- [ ] **交互一致性**: 两个页面操作方式100%一致
+- [ ] **功能发现率**: 核心功能发现率>90%
+- [ ] **首屏加载**: <1s
+- [ ] **操作响应**: <200ms
+
+### 开发效率指标
+- [ ] **新增功能时间**: 减少60%
+- [ ] **Bug修复时间**: 减少50%
+- [ ] **代码审查时间**: 减少40%
+
+---
+
+## 💡 立即行动（今天/明天）
+
+### 今天可以做的（2-3小时）
+1. ✅ **创建 `src/utils/constants.js`**（30min）
+   - 统一STORAGE_KEYS管理
+   - 统一FILE_EXTENSIONS定义
+
+2. ✅ **创建 `src/utils/fileUtils.js`**（1h）
+   - formatBytes
+   - getFileName
+   - getFileIcon（简化版）
+
+3. ✅ **重构DeviceTest.vue使用新工具函数**（1h）
+   - 导入新的utils
+   - 删除重复代码
+   - 测试功能
+
+### 明天可以做的（4-6小时）
+1. ✅ **创建 `src/composables/useLocalStorage.js`**（1.5h）
+   - 封装localStorage操作
+   - 添加类型定义
+
+2. ✅ **创建 `src/composables/useFileOperations.js`**（2.5h）
+   - 封装文件操作逻辑
+   - 添加错误处理
+
+3. ✅ **重构DeviceTest.vue使用composables**（2h）
+   - 替换内联逻辑
+   - 测试功能
+
+---
+
+## 📝 总结
+
+### 当前问题
+1. ❌ 代码重复率59.7%
+2. ❌ 缺少公共抽象
+3. ❌ 交互模式不一致
+4. ❌ 缺少类型和测试
+
+### 改进方向
+1. ✅ 建立composables抽象层
+2. ✅ 统一用户体验
+3. ✅ 建立测试体系
+4. ✅ 引入TypeScript
+
+### 预期收益
+- 代码减少42%
+- 开发效率提升60%
+- 维护成本降低50%
+- 用户满意度提升30%
+
+---
+
+**下一步**: 从"立即行动"开始，今天就迈出第一步！💪