docs: update feature docs to correctly reflect Vite + React architecture

- Update backlog.md with accurate architecture differences
- Clarify that project uses Vite + React (not Next.js)
- Add detailed comparison between Vite and Next.js
- Document migration options and recommendations
- Update F1.1 and F1.2 docs with correct technical details

Author: qdriven

docs/features/F1.1-init-tauri-react.md

@@ -1,24 +1,75 @@
 # F1.1 初始化 Tauri v2 + React 桌面应用
 
-> 状态: ✅ 已完成 (有差异)
-> 原始需求: Tauri v2 + Next.js → 实际实现: Tauri v2 + React + Vite
+> 状态: ⚠️ 架构差异
+> 原始需求: Tauri v2 + **Next.js** → 实际实现: Tauri v2 + **React + Vite**
 
 ---
 
 ## 实现概览
 
-在 `apps/desktop/` 下创建了 Tauri v2 + React 桌面应用，使用 Vite 作为构建工具。
+在 `apps/desktop/` 下创建了 Tauri v2 + React 桌面应用，使用 **Vite** 作为构建工具。
+
+⚠️ **注意**: 原始需求要求使用 **Next.js 15**，但实际实现使用了 **Vite + React**。这是一个架构偏差。
 
 ## 技术栈
 
 | 技术 | 版本 | 说明 |
 |------|------|------|
 | Tauri | v2.x | 桌面应用框架 |
 | React | v19.x | UI 框架 |
-| Vite | v7.x | 构建工具 |
+| **Vite** | **v7.x** | **构建工具（非 Next.js）** |
 | TypeScript | v5.8 | 类型系统 |
 | Tailwind CSS | v3.4 | 样式框架 |
 
+## 与原始需求的差异
+
+### F1.1 原始需求
+
+```markdown
+- [ ] Next.js 15 (App Router) 作为前端
+- [ ] `pnpm dev` 能启动开发模式
+- [ ] 集成到现有 monorepo（pnpm workspace 正确配置）
+```
+
+### 实际实现
+
+```markdown
+✅ React 19 + Vite 作为前端
+✅ `npm run dev` 启动开发模式
+❌ 未配置 pnpm workspace（使用 npm）
+```
+
+### 差异分析
+
+| 需求项 | 计划 | 实际 | 差异说明 |
+|--------|------|------|----------|
+| 前端框架 | Next.js 15 | React 19 + Vite | 使用 Vite 替代 Next.js |
+| 包管理器 | pnpm | npm | 使用 npm 替代 pnpm |
+| Monorepo | pnpm workspace | 独立项目 | 未集成 monorepo |
+
+## 为什么使用 Vite 而非 Next.js
+
+### 当前实现的优势
+
+1. **启动速度**: Vite 开发服务器启动更快（秒级 vs 十秒级）
+2. **配置简单**: 无需处理 Next.js 的复杂配置
+3. **打包大小**: Vite 打包更轻量，适合桌面应用
+4. **Tauri 集成**: `create-tauri-app` 官方推荐 Vite 模板
+
+### Next.js 特性在桌面应用中的适用性
+
+| Next.js 特性 | 桌面应用需要？ | 说明 |
+|-------------|---------------|------|
+| SSR | ❌ 不需要 | Tauri 是本地应用，无需服务端渲染 |
+| SSG | ❌ 不需要 | 桌面应用不需要预生成静态页面 |
+| Image Optimization | ⚠️ 可选 | 可使用常规 img 标签 |
+| API Routes | ❌ 不需要 | 使用 Tauri 后端 API |
+| App Router | ⚠️ 可选 | Vite + React Router 可替代 |
+
+### 结论
+
+当前 **Vite + React** 架构完全满足桌面应用需求，**Next.js 不是必需的**。
+
 ## 项目结构
 
 ```
@@ -37,7 +88,8 @@ apps/desktop/
 │   ├── src/                 # Rust 源代码
 │   ├── Cargo.toml          # Rust 依赖
 │   └── tauri.conf.json     # Tauri 配置
-├── package.json             # Node.js 依赖
+├── index.html              # Vite 入口 HTML
+├── package.json             # Node.js 依赖（npm）
 ├── vite.config.ts          # Vite 配置
 ├── tailwind.config.js      # Tailwind 配置
 └── tsconfig.json           # TypeScript 配置
@@ -48,7 +100,7 @@ apps/desktop/
 ### ✅ 基础架构
 - [x] Tauri v2 项目初始化
 - [x] React 19 + TypeScript 集成
-- [x] Vite 构建工具配置
+- [x] **Vite** 构建工具配置（**非 Next.js**）
 - [x] 开发服务器正常运行 (`npm run tauri dev`)
 - [x] Tauri 窗口正确显示
 
@@ -71,21 +123,6 @@ apps/desktop/
 - [x] 终端状态管理
 - [x] 学习进度管理
 
-## 与原始需求的差异
-
-| 原始需求 | 实际实现 | 说明 |
-|----------|----------|------|
-| Next.js 15 | React 19 + Vite | 使用 Vite 替代 Next.js，更适合桌面应用 |
-| pnpm workspace | npm | 暂未配置 monorepo workspace |
-| App Router | 不适用 | React + Vite 不使用 App Router |
-
-## 为什么使用 React + Vite 而非 Next.js
-
-1. **桌面应用特性**: Tauri 桌面应用不需要 SSR/SSG
-2. **启动速度**: Vite 开发服务器启动更快
-3. **配置简单**: 无需处理 Next.js 的复杂配置
-4. **打包大小**: Vite 打包更轻量
-
 ## 运行方式
 
 ```bash
@@ -140,6 +177,42 @@ export default defineConfig({
 });
 ```
 
+### 关键差异: Vite vs Next.js
+
+| 配置 | Vite | Next.js |
+|------|------|---------|
+| 入口文件 | `index.html` + `main.tsx` | `app/layout.tsx` + `app/page.tsx` |
+| 路由 | 手动管理 / React Router | App Router / Pages Router |
+| 构建配置 | `vite.config.ts` | `next.config.js` |
+| 开发命令 | `vite` | `next dev` |
+| 输出目录 | `dist/` | `.next/` |
+
+## 是否需要迁移到 Next.js
+
+### 当前 Vite 架构的不足
+
+1. **路由管理**: 需要手动实现路由（或使用 React Router）
+2. **代码分割**: 不如 Next.js 自动优化
+3. **生态系统**: 部分 Next.js 插件无法使用
+
+### 迁移成本
+
+| 迁移项 | 工作量 | 优先级 |
+|--------|--------|--------|
+| 项目结构改造 | 2-3 天 | 中 |
+| 路由迁移 | 1-2 天 | 中 |
+| 样式系统适配 | 1 天 | 低 |
+| Tauri 配置调整 | 0.5 天 | 低 |
+
+### 建议
+
+**短期**: 保持当前 Vite + React 架构，已满足需求
+
+**长期**: 如需以下特性，考虑迁移到 Next.js:
+- SSR/SSG 需求
+- 统一 Web + 桌面代码库
+- 使用 Next.js 生态插件
+
 ## 注意事项
 
 1. **CSS 导入**: 确保 `main.tsx` 导入 CSS 文件
@@ -151,8 +224,11 @@ export default defineConfig({
 
 3. **开发端口**: 固定使用 1420 端口
 
+4. **非 Next.js**: 不能使用 Next.js 特有的 API（如 `next/image`, `next/head`）
+
 ## 后续优化
 
 - [ ] 安装和配置 Tauri Shell 插件
 - [ ] 添加更多 Tauri 命令
 - [ ] 优化窗口配置（标题栏、尺寸等）
+- [ ] 评估 Next.js 迁移需求