121 lines
5.8 KiB
Markdown
121 lines
5.8 KiB
Markdown
# U-Desk 文档索引
|
||
|
||
> 更新日期：2026-05-01
|
||
> 分支: `fs-only-v3` (Wails v3)
|
||
> 参考 [wk-flux/docs](../../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-技术文档/](./01-技术文档/) | CodeMirror、数据库优化等专题 |
|
||
| 架构设计 | [02-架构设计/](./02-架构设计/) | 架构方案、迁移记录、设计决策 |
|
||
| 模块文档 | [03-模块文档/](./03-模块文档/) | 各功能模块的实现和优化记录 |
|
||
| 功能迭代 | [04-功能迭代/](./04-功能迭代/) | 历史功能开发过程文档 |
|
||
| 代码审查 | [05-代码审查/](./05-代码审查/) | 审查报告、走查报告、重构记录 |
|
||
| 前端开发 | [06-前端开发/](./06-前端开发/) | 前端分析、优化、问题排查 |
|
||
| 项目管理 | [07-项目管理/](./07-项目管理/) | 项目状态、功能清单、版本管理 |
|
||
| 用户指南 | [08-用户指南/](./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/ # 运行时配置
|
||
```
|