u-desk/docs/INDEX.md

U-Desk 文档索引

更新日期：2026-05-01 分支: fs-only-v3 (Wails v3) 参考 wk-flux/docs 目录结构

---

目录结构

docs/
├── INDEX.md                    # 本文件
├── 01-技术文档/                 # 技术文档和专题研究
│   ├── CodeMirror/             # CodeMirror 6 编辑器系列（6篇）
│   └── 数据库优化/              # 数据库连接池、缓存优化（2篇）
├── 02-架构设计/                 # 架构设计、改进方案、迁移记录
│   ├── OOP架构/                # OOP vs Composables 架构对比（6篇）
│   ├── Pinia迁移/              # Pinia 状态管理迁移（5篇）
│   └── 插件系统方案.md
├── 03-模块文档/                 # 各功能模块实现文档
│   ├── 文件系统/               # 文件管理模块（14篇）
│   ├── 更新通知/               # 更新通知模块（10篇）
│   ├── 设置功能/               # 设置模块（4篇）
│   ├── 文件内容/               # 文件内容模块（2篇）
│   └── 启动优化/               # 启动优化模块（3篇）
├── 04-功能迭代/                 # 历史功能迭代文档
│   ├── GO-DESK-1.尝试/         # 应用初始化阶段
│   ├── GO-DESK-2.数据库客户端/ # 数据库客户端（39篇，已移除）
│   ├── GO-DESK-3.文件系统/     # 文件系统管理
│   ├── GO-DESK-4.AI工作台/     # AI 工作台
│   ├── GO-DESK-6.文件操作增强/  # 文件操作增强
│   └── GO-DESK-7.u-fs-agent远程文件服务/ # 远程文件服务
├── 05-代码审查/                 # 代码审查、走查报告、重构记录
│   ├── 审查报告/               # 各期代码审查报告
│   ├── 代码质量/               # 代码质量优化（3篇）
│   └── 分析报告/               # 各类分析报告（6篇）
├── 06-前端开发/                 # 前端分析与优化
│   ├── 布局分析/
│   ├── 代码分割/
│   ├── 组件分析/
│   └── 编译器未发现的初始化问题.md
├── 07-项目管理/                 # 项目规划与版本管理
│   ├── 项目规划/               # PROJECT_STATUS、work-plan
│   ├── 功能清单/               # 功能清单与核对报告
│   └── 版本管理/               # changelog、版本发布手册
├── 08-用户指南/                # 用户手册和配置指南
│   ├── u-desk-site/            # 官网（单页设计，部署至 /var/www/u-desk-site/）
│   │   ├── index.html          # 首页（Hero + 功能 + 文档 + 下载）
│   │   ├── changelog.html      # 版本历史记录页（时间线样式，7个版本完整日志）
│   │   ├── docs.html           # 详细文档页
│   │   ├── privacy.html        # 隐私声明
│   │   └── download/           # 安装包（Windows exe / Linux）

---

快速导航

分类	入口	说明
技术文档	01-技术文档/	CodeMirror、数据库优化等专题
架构设计	02-架构设计/	架构方案、迁移记录、设计决策
模块文档	03-模块文档/	各功能模块的实现和优化记录
功能迭代	04-功能迭代/	历史功能开发过程文档
代码审查	05-代码审查/	审查报告、走查报告、重构记录
前端开发	06-前端开发/	前端分析、优化、问题排查
项目管理	07-项目管理/	项目状态、功能清单、版本管理
用户指南	08-用户指南/	用户手册、配置指南

---

新文档放置规则

文档类型	放置位置
技术专题研究	01-技术文档/<专题名>/
架构设计/改进方案	02-架构设计/
功能模块实现文档	03-模块文档/<模块名>/
功能开发过程记录	04-功能迭代/GO-DESK-N.<模块>/
代码审查/走查报告	05-代码审查/审查报告/
前端优化分析	06-前端开发/
项目状态/功能清单	07-项目管理/
用户手册/配置指南	08-用户指南/

---

技术栈

• 后端: Go 1.26 + Wails v3 (alpha.80)
• 前端: Vue 3 + TypeScript + Arco Design Vue + Pinia
• 编辑器: CodeMirror 6
• 构建: Vite 7 + Taskfile
• 桌面端: 原生窗口（macOS/Windows/Linux）
• 数据库: SQLite（本地配置存储）
• 当前版本: 0.5.0

注：v0.4.0 起已移除 MySQL/Redis/MongoDB 数据库客户端模块，专注文件管理功能。

项目结构（当前）

u-desk/
├── main.go              # 入口：窗口配置、中间件、DevTools
├── app.go               # 应用逻辑：文件系统、更新检查等
├── wails.json           # Wails 项目配置
├── internal/            # 内部模块
│   ├── filesystem/      # 文件操作、锁、预览服务
│   └── agent/           # 远程文件服务 Agent
├── frontend/            # 前端代码 (Vue 3) ← 原 web/
│   ├── src/
│   │   ├── components/FileSystem/   # 文件管理主组件
│   │   ├── stores/                  # Pinia 状态管理
│   │   ├── api/                     # 后端调用封装（Transport 抽象）
│   │   └── utils/                   # 工具函数
│   └── vite.config.js
├── build/               # 构建配置（跨平台）
├── cmd/                 # 命令行入口
└── configs/             # 运行时配置