feat(frontend): 将文件管理器改为固定根树视图

文件区改为固定 `/` 根节点的单栏资源管理器树，在同一树中同时展示目录和文件，并移除文件夹总览区块同时收紧快捷指令编辑弹窗尺寸并优化窄屏为上下布局，降低小分辨率下的溢出概率，并同步更新中英文 README 及 `.helloagents` 方案记录
2026-03-26 02:21:06 +08:00
parent b1f036fdc6
commit dcdc8deab8
11 changed files with 284 additions and 355 deletions
@@ -0,0 +1 @@
+{"status":"completed","completed":4,"failed":0,"pending":0,"total":4,"done":4,"percent":100,"current":"FileManager 已改为固定 / 根节点并显示目录和文件的单栏树","updated_at":"2026-03-26 02:21:00"}
@@ -0,0 +1,58 @@
+# 变更提案: workbench-file-root-tree
+
+## 元信息
+```yaml
+类型: 功能调整
+方案类型: implementation
+优先级: P1
+状态: 已完成
+状态说明: 已改为固定 / 根节点的单栏资源管理器树，并通过前端构建验证
+创建: 2026-03-26
+```
+
+---
+
+## 1. 需求
+
+### 背景
+上一轮虽然去掉了单目录文件表格，但仍保留了“文件夹总览”区块，而且根目录会随当前路径变化，不符合实际想要的资源管理器体验。
+
+### 目标
+- 文件区只保留一个资源管理器树。
+- 根节点始终固定显示 `/`。
+- 目录展开时同时显示子目录和文件，文件作为叶子节点显示。
+
+### 约束条件
+```yaml
+范围约束: 优先只改 FileManager.vue，不改后端接口与 SFTP 协议
+状态约束: 继续复用 useSftpActions 的 fileTree 和 loadDirectory(path)
+交互约束: 点击目录只展开和聚焦，点击文件按现有逻辑打开
+兼容约束: 顶部工具栏、路径栏、上传与新建动作保持可用
+```
+
+### 验收标准
+- [x] 文件区只保留单栏资源管理器树
+- [x] 根节点始终固定显示 `/`
+- [x] 目录下同时展示子目录和文件
+- [x] 前端构建通过
+
+---
+
+## 2. 方案
+
+### 技术方案
+在 `FileManager.vue` 中去掉多根目录和文件夹总览派生结构，改为以 `/` 为唯一 explorer root，树节点直接基于 `fileTree` 递归渲染所有已加载的目录和文件，按“目录在前、文件在后”排序。主内容区改成单栏树视图，点击目录只负责展开与调用 `loadDirectory(path)` 以懒加载子节点，点击文件则继续复用现有 `openFileInWorkspace`。
+
+### 影响范围
+```yaml
+涉及模块:
+  - frontend: FileManager.vue
+预计变更文件: 1-4
+```
+
+### 风险评估
+| 风险 | 等级 | 应对 |
+|------|------|------|
+| `/` 下初次只会显示已加载到 `fileTree` 的节点 | 中 | 在组件中确保优先加载 `/`，展开目录时继续复用现有懒加载 |
+| 右侧总览移除后，拖拽与右键的作用区域缩小 | 低 | 保留主容器和现有上下文菜单、上传入口，不改后端动作 |
+| 树节点数量增多后单栏滚动深度增加 | 低 | 保留当前滚动容器与层级缩进，先满足准确交互 |
@@ -0,0 +1,42 @@
+# 任务清单: workbench-file-root-tree
+
+```yaml
+@feature: workbench-file-root-tree
+@created: 2026-03-26
+@status: completed
+@mode: R2
+```
+
+## 进度概览
+
+| 完成 | 失败 | 跳过 | 总数 |
+|------|------|------|------|
+| 4 | 0 | 0 | 4 |
+
+---
+
+## 任务列表
+
+### 1. 方案与范围确认
+
+- [√] 1.1 创建固定 `/` 根节点资源管理器方案包并锁定范围到 `FileManager.vue` | depends_on: []
+
+### 2. 交互调整实现
+
+- [√] 2.1 将资源管理器改为固定 `/` 唯一根节点 | depends_on: [1.1]
+- [√] 2.2 在树中同时渲染子目录和文件，并移除文件夹总览区块 | depends_on: [2.1]
+
+### 3. 验证与同步
+
+- [√] 3.1 运行前端构建验证并同步 `.helloagents` 文档与归档记录 | depends_on: [2.2]
+
+---
+
+## 执行日志
+
+| 时间 | 任务 | 状态 | 备注 |
+|------|------|------|------|
+| 2026-03-26 02:12 | 1.1 | 完成 | 创建 implementation 方案包，范围锁定为 FileManager 固定 / 根节点单栏资源管理器改造 |
+| 2026-03-26 02:17 | 2.1 | 完成 | 文件区收敛为固定 / 根节点单栏树，并确保组件加载时优先请求 / 目录 |
+| 2026-03-26 02:19 | 2.2 | 完成 | 树中同时渲染目录和文件节点，并移除文件夹总览面板 |
+| 2026-03-26 02:21 | 3.1 | 完成 | `npm run build --workspace @nexus-terminal/frontend` 通过，准备同步知识库与归档 |
@@ -7,6 +7,7 @@

 | 时间戳 | 名称 | 类型 | 涉及模块 | 决策 | 结果 |
 |--------|------|------|---------|------|------|
+| 202603260212 | workbench-file-root-tree | implementation | frontend | - | ✅完成 |
 | 202603260156 | quickcommands-context-menu-polish | implementation | frontend | quickcommands-context-menu-polish#D001 | ✅完成 |
 | 202603260150 | workbench-file-folder-overview | implementation | frontend | - | ✅完成 |
 | 202603260041 | workbench-file-multi-root-explorer | implementation | frontend | - | ✅完成 |
@@ -34,6 +35,7 @@
 ## 按月归档

 ### 2026-03
+- [202603260212_workbench-file-root-tree](./2026-03/202603260212_workbench-file-root-tree/) - 将工作台文件区收敛为固定 / 根节点的单栏资源管理器树，并在树内同时显示目录与文件
 - [202603260156_quickcommands-context-menu-polish](./2026-03/202603260156_quickcommands-context-menu-polish/) - 修正快捷命令右键菜单透明背景，并将粘贴动作统一为“粘贴到命令输入框（不发送）”
 - [202603260150_workbench-file-folder-overview](./2026-03/202603260150_workbench-file-folder-overview/) - 将工作台文件区调整为多根目录常驻的文件夹总览，不再点击目录后切成单独文件表格
 - [202603260041_workbench-file-multi-root-explorer](./2026-03/202603260041_workbench-file-multi-root-explorer/) - 为工作台文件面板补齐左侧多根目录资源管理器，并允许收藏路径与当前路径同屏作为多个根目录展开浏览
				`@@ -0,0 +1 @@`
				`{"status":"completed","completed":4,"failed":0,"pending":0,"total":4,"done":4,"percent":100,"current":"FileManager 已改为固定 / 根节点并显示目录和文件的单栏树","updated_at":"2026-03-26 02:21:00"}`