137 lines
3.8 KiB
Markdown
137 lines
3.8 KiB
Markdown
# TraceStudio v0.2.0 更新日志
|
||
|
||
## 🎉 重大更新：多用户文件管理系统
|
||
|
||
### 新增功能
|
||
|
||
#### 📁 文件管理器
|
||
- **完整的文件系统**: 浏览、上传、下载、删除、重命名文件
|
||
- **目录导航**: 面包屑路径，支持快速返回父级
|
||
- **右键菜单**: 直观的文件操作
|
||
- **文件图标**: 根据文件类型显示不同图标
|
||
|
||
#### 👤 多用户支持
|
||
- **用户切换**: 点击 HeaderBar 右侧用户按钮即可切换
|
||
- **数据隔离**: 每个用户拥有独立的文件空间
|
||
- **自动创建**: 首次登录自动创建用户目录结构
|
||
|
||
#### 🎯 拖拽集成
|
||
- **CSV 拖拽**: 从文件浏览器拖拽 CSV 文件到画布
|
||
- **自动创建节点**: 自动生成 CSVLoader 节点
|
||
- **自动填充路径**: 节点参数自动填入文件路径
|
||
|
||
#### 🗂️ 目录结构
|
||
```
|
||
cloud/
|
||
├── shared/ # 共享资源（所有用户可见）
|
||
├── temp/ # 临时文件
|
||
└── users/ # 用户私有空间
|
||
└── {username}/
|
||
├── workflows/ # 工作流
|
||
├── data/ # 数据文件
|
||
└── results/ # 结果
|
||
```
|
||
|
||
### 技术实现
|
||
|
||
#### 后端 (Python/FastAPI)
|
||
- **新增模块**: `server/file_manager.py`
|
||
- **API 路由**: `/api/files/*` (list, upload, action, download)
|
||
- **路径安全**: 防止目录遍历攻击
|
||
- **自动初始化**: 启动时创建基础目录结构
|
||
|
||
#### 前端 (React/TypeScript)
|
||
- **新组件**: `FileExplorer.tsx` (文件浏览器)
|
||
- **Store 扩展**: 添加 `currentUser`, `currentPath` 状态
|
||
- **UI 集成**: 左侧面板新增"文件"标签
|
||
- **用户切换器**: HeaderBar 右侧新增用户按钮
|
||
|
||
### 修复的 Bug
|
||
|
||
#### ✅ 无限循环渲染问题
|
||
- **问题**: `useEffect` 中同步调用 `setState` 导致级联渲染
|
||
- **解决**:
|
||
- 移除 UniversalNode 中的空 useEffect
|
||
- Workspace 使用 ref 跟踪更新来源
|
||
- 避免所有同步 setState 调用
|
||
|
||
#### ✅ 空值安全问题
|
||
- **问题**: 访问 `preview.data.length` 未使用可选链
|
||
- **解决**: 所有预览数据访问添加 `?.` 和 `Array.isArray` 检查
|
||
|
||
### API 变更
|
||
|
||
#### 新增接口
|
||
```typescript
|
||
// 文件管理 API
|
||
listFiles(path, username) // 列出目录
|
||
uploadFile(file, path, username) // 上传文件
|
||
fileAction(action) // 文件操作
|
||
getDownloadUrl(path) // 获取下载链接
|
||
getFileInfo(path) // 获取文件信息
|
||
```
|
||
|
||
#### Store 新增
|
||
```typescript
|
||
// 用户状态
|
||
currentUser: string // 当前用户名
|
||
setCurrentUser(user) // 切换用户
|
||
|
||
// 文件浏览器
|
||
showFileExplorer: boolean // 显示/隐藏
|
||
currentPath: string // 当前路径
|
||
setCurrentPath(path) // 设置路径
|
||
```
|
||
|
||
### 使用指南
|
||
|
||
#### 快速开始
|
||
|
||
1. **启动服务**
|
||
```bash
|
||
# 后端
|
||
python -m uvicorn server.main:app --reload
|
||
|
||
# 前端
|
||
cd web && npm run dev
|
||
```
|
||
|
||
2. **切换用户**
|
||
- 点击 HeaderBar 右上角用户按钮
|
||
- 选择预设用户或自定义用户名
|
||
|
||
3. **上传文件**
|
||
- 点击左侧"📁 文件"标签
|
||
- 点击"📤 上传"选择文件
|
||
|
||
4. **拖拽创建节点**
|
||
- 拖动 CSV 文件到画布
|
||
- 自动生成 CSVLoader 节点
|
||
|
||
### 性能优化
|
||
|
||
- **React 渲染优化**: 使用 ref 避免循环依赖
|
||
- **异步加载**: 文件列表异步获取，不阻塞 UI
|
||
- **懒加载**: 只在需要时加载文件列表
|
||
|
||
### 下一步计划
|
||
|
||
- [ ] 工作流文件（.utrace）的保存/加载
|
||
- [ ] 拖拽支持更多文件类型（JSON、图片）
|
||
- [ ] 文件搜索功能
|
||
- [ ] 文件夹批量操作
|
||
- [ ] 文件预览（CSV、图片）
|
||
- [ ] 用户权限管理（生产环境）
|
||
|
||
### 文档
|
||
|
||
- 📖 [文件管理器使用指南](./docs/FILE_MANAGER_GUIDE.md)
|
||
- 📖 [功能更新文档](./docs/FEATURE_UPDATE_v0.2.0.md)
|
||
|
||
---
|
||
|
||
**版本**: v0.2.0
|
||
**发布日期**: 2026-01-07
|
||
**重大变更**: 是
|
||
**向后兼容**: 是
|