2026-04-29-21-27-10 - 组件目录扁平化重构

工程分析/实现方案-2026-04-29-21-27-10.md

@@ -0,0 +1,135 @@
+# 实现方案 - 2026-04-29-21-27-10
+
+## 对应需求
+- 需求分析文档: `需求分析-2026-04-29-21-27-10.md`
+
+## 方案概述
+将 `src/components/` 下 7 个子目录共 11 个 `.tsx` 组件文件全部移动到 `src/components/` 根目录，并更新所有相关 import 路径。这是一个纯路径重构，不涉及任何业务逻辑变更。
+
+## 当前目录结构
+
+```
+src/components/
+├── ai/
+│   └── AISegmentation.tsx
+├── auth/
+│   └── Login.tsx
+├── dashboard/
+│   └── Dashboard.tsx
+├── layout/
+│   └── Sidebar.tsx
+├── projects/
+│   └── ProjectLibrary.tsx
+├── templates/
+│   └── TemplateRegistry.tsx
+└── workspace/
+    ├── CanvasArea.tsx
+    ├── FrameTimeline.tsx
+    ├── OntologyInspector.tsx
+    ├── ToolsPalette.tsx
+    └── VideoWorkspace.tsx
+```
+
+## 目标目录结构
+
+```
+src/components/
+├── AISegmentation.tsx
+├── Login.tsx
+├── Dashboard.tsx
+├── Sidebar.tsx
+├── ProjectLibrary.tsx
+├── TemplateRegistry.tsx
+├── CanvasArea.tsx
+├── FrameTimeline.tsx
+├── OntologyInspector.tsx
+├── ToolsPalette.tsx
+└── VideoWorkspace.tsx
+```
+
+## 修改文件清单
+
+### 文件 1-11: 组件文件移动（11 个文件）
+- **修改类型**: 移动（mv）
+- **文件列表**:
+  - `src/components/ai/AISegmentation.tsx` → `src/components/AISegmentation.tsx`
+  - `src/components/auth/Login.tsx` → `src/components/Login.tsx`
+  - `src/components/dashboard/Dashboard.tsx` → `src/components/Dashboard.tsx`
+  - `src/components/layout/Sidebar.tsx` → `src/components/Sidebar.tsx`
+  - `src/components/projects/ProjectLibrary.tsx` → `src/components/ProjectLibrary.tsx`
+  - `src/components/templates/TemplateRegistry.tsx` → `src/components/TemplateRegistry.tsx`
+  - `src/components/workspace/CanvasArea.tsx` → `src/components/CanvasArea.tsx`
+  - `src/components/workspace/FrameTimeline.tsx` → `src/components/FrameTimeline.tsx`
+  - `src/components/workspace/OntologyInspector.tsx` → `src/components/OntologyInspector.tsx`
+  - `src/components/workspace/ToolsPalette.tsx` → `src/components/ToolsPalette.tsx`
+  - `src/components/workspace/VideoWorkspace.tsx` → `src/components/VideoWorkspace.tsx`
+
+### 文件 12: `src/App.tsx`（修改）
+- **修改类型**: 修改 import 路径
+- **修改内容**:
+  - `./components/layout/Sidebar` → `./components/Sidebar`
+  - `./components/dashboard/Dashboard` → `./components/Dashboard`
+  - `./components/projects/ProjectLibrary` → `./components/ProjectLibrary`
+  - `./components/workspace/VideoWorkspace` → `./components/VideoWorkspace`
+  - `./components/templates/TemplateRegistry` → `./components/TemplateRegistry`
+  - `./components/ai/AISegmentation` → `./components/AISegmentation`
+  - `./components/auth/Login` → `./components/Login`
+
+### 文件 13: `src/components/AISegmentation.tsx`（修改）
+- **修改类型**: 修改 import 路径
+- **修改内容**:
+  - `../../lib/utils` → `../lib/utils`
+  - `../workspace/OntologyInspector` → `./OntologyInspector`
+
+### 文件 14: `src/components/Login.tsx`（修改）
+- **修改类型**: 修改 import 路径
+- **修改内容**:
+  - `../../lib/utils` → `../lib/utils`
+
+### 文件 15: `src/components/Sidebar.tsx`（修改）
+- **修改类型**: 修改 import 路径
+- **修改内容**:
+  - `../../lib/utils` → `../lib/utils`
+  - `../../App` → `../App`
+
+### 文件 16: `src/components/ToolsPalette.tsx`（修改）
+- **修改类型**: 修改 import 路径
+- **修改内容**:
+  - `../../lib/utils` → `../lib/utils`
+
+### 文件 17: `src/components/FrameTimeline.tsx`（修改）
+- **修改类型**: 修改 import 路径
+- **修改内容**:
+  - `../../lib/utils` → `../lib/utils`
+
+### 文件 18: `src/components/VideoWorkspace.tsx`（修改）
+- **修改类型**: 修改 import 路径
+- **修改内容**:
+  - `./CanvasArea` → `./CanvasArea`（不变，已在同目录）
+  - `./ToolsPalette` → `./ToolsPalette`（不变，已在同目录）
+  - `./OntologyInspector` → `./OntologyInspector`（不变，已在同目录）
+  - `./FrameTimeline` → `./FrameTimeline`（不变，已在同目录）
+  - 注：VideoWorkspace 原本在 workspace 子目录内引用同级文件，移动到根目录后路径格式不变
+
+### 文件 19-21: 清理空目录（7 个目录）
+- **修改类型**: 删除空目录
+- **目录列表**:
+  - `src/components/ai/`
+  - `src/components/auth/`
+  - `src/components/dashboard/`
+  - `src/components/layout/`
+  - `src/components/projects/`
+  - `src/components/templates/`
+  - `src/components/workspace/`
+
+## 新增依赖
+无
+
+## 兼容性分析
+- 与现有功能冲突: 无，纯路径重构
+- 回滚策略: 通过 git 回滚到上一个 commit 即可
+
+## 预估工作量
+- 文件移动: 5 分钟
+- 路径更新: 10 分钟
+- 验证构建: 5 分钟