重构：文件系统模块化架构，优化应用启动流程

docs/04-功能迭代/GO-DESK-1.尝试/启动指南.md

@@ -0,0 +1,150 @@
+# Go Desk 启动指南
+
+## 前置条件
+
+1. Go v1.25.4 已安装
+2. Node.js 和 npm 已安装
+3. MySQL 数据库 lab_dev 已启动
+
+## 安装 Wails CLI
+
+```bash
+go install github.com/wailsapp/wails/v2/cmd/wails@latest
+```
+
+**如果 `wails` 命令找不到**：
+
+1. 获取 GOPATH：
+   ```bash
+   go env GOPATH
+   ```
+
+2. 使用完整路径运行（假设 GOPATH 是 `D:\Go\go-workspace`）：
+   ```bash
+   D:\Go\go-workspace\bin\wails.exe dev
+   ```
+
+3. 或添加到 PATH 环境变量（永久解决）：
+   - 将 `%GOPATH%\bin` 添加到系统 PATH
+   - 重新打开终端
+
+## 首次启动步骤
+
+### 1. 安装 Go 依赖
+
+```bash
+cd go-desk
+go mod tidy
+```
+
+### 2. 安装前端依赖
+
+```bash
+cd web
+npm install
+```
+
+### 3. 构建前端（必须）
+
+```bash
+npm run build
+```
+
+这会生成 `web/dist` 目录，包含前端构建产物。
+
+### 4. 开发模式运行
+
+```bash
+# 回到项目根目录
+cd ..
+
+# 启动 Wails 开发服务器
+wails dev
+```
+
+## 开发流程
+
+### 修改前端代码后
+
+```bash
+cd web
+npm run build
+cd ..
+wails dev
+```
+
+### 修改后端代码后
+
+直接重启 `wails dev` 即可。
+
+## 常见问题
+
+### 问题1：找不到 web/dist 目录
+
+**解决**：需要先构建前端
+```bash
+cd web
+npm run build
+```
+
+### 问题2：数据库连接失败
+
+**检查**：
+1. 测试服 MySQL 是否可访问（外网IP: 39.99.243.191:3306）
+2. 数据库 lab_dev 是否存在
+3. 用户名密码是否正确（root/Lake@2019）
+4. 网络连接是否正常（可能需要VPN或白名单）
+
+### 问题3：前端调用后端方法失败
+
+**检查**：
+1. 确保 `main.go` 中正确设置了 `Services: []interface{}{app}`
+2. 前端调用方式：`window.go.main.App.QueryUsers(...)`
+3. 检查浏览器控制台错误信息
+
+### 问题4：wails 命令找不到
+
+**解决**：
+- 使用完整路径：`%GOPATH%\bin\wails.exe`
+- 或添加到 PATH 环境变量
+
+## 构建发布版本
+
+### 1. 确保前端已构建
+
+```bash
+cd web
+npm run build
+cd ..
+```
+
+### 2. 执行构建
+
+```bash
+# 构建当前平台（Windows）
+wails build
+
+# 或明确指定平台
+wails build -platform windows/amd64
+```
+
+### 3. 构建产物
+
+构建成功后，可执行文件位于123：
+```
+build/bin/go-desk.exe
+```
+
+### 4. 运行打包后的应用
+
+直接双击 `build/bin/go-desk.exe` 运行，或使用命令行：
+
+```bash
+build\bin\go-desk.exe
+```
+
+**注意事项**：
+- 打包后的应用是独立的可执行文件，包含所有前端资源
+- 首次运行需要确保 MySQL 数据库 `lab_dev` 可访问
+- 数据库连接信息硬编码在代码中（localhost:3306, root/123456）
+- 如需分发，确保目标机器有 MySQL 数据库或修改为远程数据库连接