yinjianm
b1f036fdc6
将文件管理区从单目录文件表格修正为多根目录常驻的文件夹总览， 点击目录时仅展开和聚焦，不再切换为单独目录列表。 同时修复快捷指令右键菜单的透明背景与粘贴语义， 统一为“粘贴到命令输入框”且不自动发送，并同步多语言文案。 顺带收紧快捷指令编辑弹窗的最小尺寸、初始尺寸与视口上限， 降低小分辨率下的弹窗溢出概率。
59 lines
2.5 KiB
Markdown
59 lines
2.5 KiB
Markdown
# 变更提案: workbench-file-folder-overview
|
|
|
|
## 元信息
|
|
```yaml
|
|
类型: 功能调整
|
|
方案类型: implementation
|
|
优先级: P1
|
|
状态: 已完成
|
|
状态说明: 已改成多根目录常驻的文件夹总览视图，并通过前端构建验证
|
|
创建: 2026-03-26
|
|
```
|
|
|
|
---
|
|
|
|
## 1. 需求
|
|
|
|
### 背景
|
|
上一轮把工作台文件区改成了“左侧多根目录树 + 右侧当前目录文件表格”，但实际使用上仍然是点击目录后切成某一个目录的单独视图，不符合参考图想要的“多根目录持续保留、同时浏览多个文件夹层级”的交互。
|
|
|
|
### 目标
|
|
- 保留多根目录作为长期可见的浏览主体。
|
|
- 点击文件夹时不再把界面切成单目录文件表格。
|
|
- 右侧改成多根目录下的文件夹总览，持续显示不同目录层级。
|
|
|
|
### 约束条件
|
|
```yaml
|
|
范围约束: 优先只改 FileManager.vue，不改后端接口与 SFTP 协议
|
|
状态约束: 继续复用 favoritePaths 与 useSftpActions 的 fileTree/loadDirectory
|
|
交互约束: 文件区以目录浏览为主，不再横向展示当前目录下的具体文件列表
|
|
兼容约束: 路径输入、收藏路径、上传和新建动作仍依赖 currentPath 保持可用
|
|
```
|
|
|
|
### 验收标准
|
|
- [x] 左侧多根目录树持续可见
|
|
- [x] 点击文件夹后右侧不再变成单目录文件表格
|
|
- [x] 右侧改为多根目录下的文件夹总览，能同时显示不同目录层级
|
|
- [x] 前端构建通过
|
|
|
|
---
|
|
|
|
## 2. 方案
|
|
|
|
### 技术方案
|
|
继续以 `FileManager.vue` 为核心，保留左侧多根目录树，但树和右侧总览都只展示目录节点，不再渲染具体文件。右侧使用 `fileTree` 缓存派生出按根目录分组的文件夹总览卡片，点击目录只触发展开与目录聚焦，不再切换成单个目录的文件表格视图。
|
|
|
|
### 影响范围
|
|
```yaml
|
|
涉及模块:
|
|
- frontend: FileManager.vue
|
|
预计变更文件: 1-4
|
|
```
|
|
|
|
### 风险评估
|
|
| 风险 | 等级 | 应对 |
|
|
|------|------|------|
|
|
| `loadDirectory(path)` 仍会更新 currentPath，导致操作目录与浏览目录耦合 | 中 | 将 currentPath 明确视为“当前操作目录”，界面主体不再依赖它切换视图 |
|
|
| 去掉文件表格后，部分基于当前目录文件列表的交互入口暂时只剩路径输入和上传/新建 | 中 | 本轮先满足目录总览需求，不扩展新的文件级操作入口 |
|
|
| 收藏路径存在父子重叠时，不同根目录区块会重复展示部分目录 | 低 | 保留重复，维持“每个根目录独立浏览”的用户心智 |
|