Files
nexus-terminal/.helloagents/archive/2026-03/202603260150_workbench-file-folder-overview/proposal.md
T
yinjianm b1f036fdc6 fix(frontend): 调整工作台文件总览与快捷指令菜单
将文件管理区从单目录文件表格修正为多根目录常驻的文件夹总览,
点击目录时仅展开和聚焦,不再切换为单独目录列表。

同时修复快捷指令右键菜单的透明背景与粘贴语义,
统一为“粘贴到命令输入框”且不自动发送,并同步多语言文案。

顺带收紧快捷指令编辑弹窗的最小尺寸、初始尺寸与视口上限,
降低小分辨率下的弹窗溢出概率。
2026-03-26 02:04:07 +08:00

2.5 KiB

变更提案: workbench-file-folder-overview

元信息

类型: 功能调整
方案类型: implementation
优先级: P1
状态: 已完成
状态说明: 已改成多根目录常驻的文件夹总览视图,并通过前端构建验证
创建: 2026-03-26

1. 需求

背景

上一轮把工作台文件区改成了“左侧多根目录树 + 右侧当前目录文件表格”,但实际使用上仍然是点击目录后切成某一个目录的单独视图,不符合参考图想要的“多根目录持续保留、同时浏览多个文件夹层级”的交互。

目标

  • 保留多根目录作为长期可见的浏览主体。
  • 点击文件夹时不再把界面切成单目录文件表格。
  • 右侧改成多根目录下的文件夹总览,持续显示不同目录层级。

约束条件

范围约束: 优先只改 FileManager.vue,不改后端接口与 SFTP 协议
状态约束: 继续复用 favoritePaths 与 useSftpActions 的 fileTree/loadDirectory
交互约束: 文件区以目录浏览为主,不再横向展示当前目录下的具体文件列表
兼容约束: 路径输入、收藏路径、上传和新建动作仍依赖 currentPath 保持可用

验收标准

  • 左侧多根目录树持续可见
  • 点击文件夹后右侧不再变成单目录文件表格
  • 右侧改为多根目录下的文件夹总览,能同时显示不同目录层级
  • 前端构建通过

2. 方案

技术方案

继续以 FileManager.vue 为核心,保留左侧多根目录树,但树和右侧总览都只展示目录节点,不再渲染具体文件。右侧使用 fileTree 缓存派生出按根目录分组的文件夹总览卡片,点击目录只触发展开与目录聚焦,不再切换成单个目录的文件表格视图。

影响范围

涉及模块:
  - frontend: FileManager.vue
预计变更文件: 1-4

风险评估

风险 等级 应对
loadDirectory(path) 仍会更新 currentPath,导致操作目录与浏览目录耦合 将 currentPath 明确视为“当前操作目录”,界面主体不再依赖它切换视图
去掉文件表格后,部分基于当前目录文件列表的交互入口暂时只剩路径输入和上传/新建 本轮先满足目录总览需求,不扩展新的文件级操作入口
收藏路径存在父子重叠时,不同根目录区块会重复展示部分目录 保留重复,维持“每个根目录独立浏览”的用户心智