diff --git a/TERMINAL_MODULE_PLAN.md b/TERMINAL_MODULE_PLAN.md index 9dfbd78..8764023 100644 --- a/TERMINAL_MODULE_PLAN.md +++ b/TERMINAL_MODULE_PLAN.md @@ -1182,11 +1182,192 @@ security / shortcuts)后广播 `terminal-settings`(无负载;`save_setting | 待真机确认(第四轮 · 死设置) | 关闭「关闭运行中的会话前确认」后关标签不再弹窗;开启「新会话继承当前目录」后新建本地标签落在当前 cwd(SSH 会话下不继承);「选中即复制」选中后剪贴板有内容、「中键粘贴」中键一次只粘一次;关掉「指纹变更时阻断连接」后换过密钥的主机直接连上且日志有 warn;关掉「记录安全事件」后日志不再出现主机密钥事件行;布局页不再有陈旧文案 | | 待真机确认(第三轮) | 新建/更多菜单可点开、tooltip 正常;独立窗口拖拽/最小化/最大化/关闭;Ctrl+3 从其它应用按下能唤到前台并建出窗口;终端模块禁用后 Ctrl+3 不再占用;深色模式下开窗不再闪白;主窗口改终端配色/字号后独立窗口即时同步;应用切深浅时终端画布一起变 | +### 文件面板三处修复(2026-09-24 第五轮) + +用户报三条:文件面板默认宽度太窄;本地栏选完目录不列文件、且路径不可编辑; +**SSH 会话的远端目录读不出来**(红字 `读取目录 \home\Atie 失败: No such file`)。 + +#### 一、远端目录为什么读不出来(根因在 OSC 7,不在 SFTP) + +报错里的路径是 `\home\Atie` —— 反斜杠,而远端是 POSIX 系统。 +追到 `shell.rs::parse_osc7`:它把 OSC 7 载荷里的路径**无条件**做了 `/` → `\` +的替换(只有「`^/[A-Za-z]:` 盘符形态」的分支多剥一个前导斜杠,**两个分支都在替换**)。 +于是远端 bash 上报的 `/home/Atie` 被存成 `\home\Atie`,文件管理器拿这个字符串去 +`read_dir`,服务端当然回 `No such file`。 + +`ssh/mod.rs` 里那句「远端路径是 POSIX 形态,`parse_osc7` 已按 `^/[A-Za-z]:` 区分, +无需特判」写的是**意图**,而代码只实现了盘符那半边 —— 注释是对的,实现是错的。 +这类 bug 的恶果在于三层之隔(OSC 解析 → 会话状态 → SFTP),现象端完全看不出根因。 + +**修法**:只有盘符形态才动路径(`/C:/Users` → `C:\Users`),其余一律原样返回。 +Git Bash / WSL 这类本地上报 POSIX 路径的 shell 同样受益(此前它们的 cwd 也被换成 +`\c\Users\...`)。新增单测 `parse_osc7_kind_by_reporter` 锁住四种形态 +(远端 POSIX / `file:///` 无主机 / Windows 盘符 / 百分号编码)。 + +#### 二、默认宽度 420 → 620 + +420px 是「本地栏只用来选目录」时代的取值:双栏各剩不到 200px,「名称」列连常见文件名 +都显示不全。本地栏升级为完整文件管理器后,两栏要给按钮组(5 个图标 + 筛选框,约 250px) +和四列表格留位置,故默认 620px;左右按 **45% / 55%** 分(远端多一列「权限」)。 +拖左边缘仍可调宽。 + +#### 三、本地栏升级为完整文件管理器 + +原设计(见本文件 §SFTP 与 `SftpPanel.vue` 头部注释)刻意让本地栏只做「定位与选取」, +浏览交给系统资源管理器。这条取舍在「先看看本地有什么、挑几个传上去」的场景下会撞出 +断头路:对话框一次选完就没了,不能进目录翻找,也不能就地改名或删除。 + +现在两栏结构对称,差别只剩两点:本地删除**走回收站**、符号链接的类型由本地解析得到。 + +| 改动 | 位置 | 说明 | +|---|---|---| +| 新增 `local_fs` 模块(列举 / 建目录 / 重命名 / 删除) | `terminal/local_fs.rs` | 符号链接返回**目标**类型(`metadata()` 免费拿到),`kind` 与远端栏因此可共用同一套判断;`canonicalize` 的 `\\?\` 前缀统一剥掉(否则回传给 `ShellExecuteW`/对话框/上传源路径都不认) | +| 4 个命令走 `spawn_blocking` | `terminal/commands.rs` | 映射网络盘 / 休眠机械盘上 `read_dir` 会阻塞数秒,占住 tokio worker 会拖慢同期的终端输出 | +| 删除复用 quickpanel 的回收站实现 | `quickpanel::commands::delete_file_impl` 改 `pub(crate)` | 这类实现最怕的是「某一份漏掉回收站语义变成永久删除」,差异没人会比对 | +| **盘符根不可删**(硬守卫) | `local_fs::delete` | 面板「上一级」停在 `C:\` 时删除按钮仍可用;不加判断就是递归删驱动器级别的数据事故 | +| 前端:可编辑路径栏 + 主目录 / 系统对话框两个跳转入口 | `SftpPanel.vue` | 手输路径(回车跳转、ESC 回填)与对话框定位并存,深路径与已知路径各取所便 | +| 前端:列表**多选**(`Ctrl` 加减、`Shift` 取范围) | `SftpPanel.vue` | 上传是最高频动作;选中 5 个文件逐个点要 10 次操作 | +| 前端:上传改为「选中项里的文件」;下载到本地目录后刷新本地列表 | `SftpPanel.vue` | 目录递归上传/下载仍属 P2,与远端口径一致(选到目录时按钮禁用并给出原因) | + +顺带统一两栏工具条的「重命名」图标(此前是一个文件图标,语义不对)。 + +#### 验证 + +| 检查 | 结果 | +|---|---| +| `vue-tsc --noEmit` | exit 0 | +| `eslint src`(改动文件) | exit 0 | +| `cargo check`(src-tauri) | exit 0 | +| `cargo test --lib` | 108 passed / 0 failed(含新增 3 条:OSC 7 形态、盘符根守卫、主目录列举) | +| 待真机确认 | SSH 会话打开文件面板,远端栏直接列出 `/home/`(不再红字报错);本地栏默认落在用户主目录、可双击进目录、可手输路径跳转、可新建/重命名、删除进了回收站;选中多个文件点「上传」全部传完;拖宽面板后两栏列宽正常 | + +### 文件管理器改版:从会话面板到独立页(2026-09-24 第六轮) + +上一轮把面板默认宽度加到 620px 之后,反馈仍是「还是有些小」。根因不在宽度: +面板长在终端卡片右侧,**它的宽度只能从终端画布里抢**,而双栏文件管理器需要的是 +一整页。因此改成模块级的一页,并顺手把「一次只服务一个会话」这个限制去掉。 + +#### 一、形态:终端卡片里的面板 → 模块「文件」页 + 独立窗口 + +| 项 | 旧 | 新 | +|---|---|---| +| 位置 | 终端卡片右侧的 `