调整
This commit is contained in:
1 parent
79bded1cd2
commit
9e6d73e191
73 files changed
+6229
-1427
No files matched your search
+190
-2
@@ -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/<user>`(不再红字报错);本地栏默认落在用户主目录、可双击进目录、可手输路径跳转、可新建/重命名、删除进了回收站;选中多个文件点「上传」全部传完;拖宽面板后两栏列宽正常 |
|
||||
|
||||
### 文件管理器改版:从会话面板到独立页(2026-09-24 第六轮)
|
||||
|
||||
上一轮把面板默认宽度加到 620px 之后,反馈仍是「还是有些小」。根因不在宽度:
|
||||
面板长在终端卡片右侧,**它的宽度只能从终端画布里抢**,而双栏文件管理器需要的是
|
||||
一整页。因此改成模块级的一页,并顺手把「一次只服务一个会话」这个限制去掉。
|
||||
|
||||
#### 一、形态:终端卡片里的面板 → 模块「文件」页 + 独立窗口
|
||||
|
||||
| 项 | 旧 | 新 |
|
||||
|---|---|---|
|
||||
| 位置 | 终端卡片右侧的 `<aside>`(宽度 620,可拖) | 模块 Tabs 的「文件」页(终端 · **文件** · 主机 · 密钥 · 设置);另有单例独立窗口 |
|
||||
| 分栏 | 本地 ↔ 当前会话(唯一组合) | 左右各 50%,**每栏各自选连接**(本地 / 任一已连接 SSH),组合为 本地↔ssh1、ssh1↔ssh2、ssh1↔ssh1(同机跨目录) |
|
||||
| 无 SSH 时 | 面板不可打开(`canShowSftp`) | 左栏本地、右栏空态提示;连上主机后右栏自动补上第一个会话 |
|
||||
| 路径行 | 本地显示只读文本、远端显示面包屑 | 统一**可编辑输入框**(回车跳转、ESC 还原)。取舍:远端丢了逐级点击,换来两栏同一心智模型(Explorer 地址栏)与「本地可编辑」这条诉求 |
|
||||
| 传输 | 左栏「上传」+ 右栏「下载到本地目录」 | 每栏底部一个**方向式**按钮(箭头指向另一栏,文案随组合变化:上传到远端 / 下载到本地 / 中继到远端) |
|
||||
| 「跟随 cd」 | 跟随终端页当前激活会话(面板绑会话) | 跟随**本栏所选会话**的 cwd(多栏各自独立) |
|
||||
| 入口 | 控制栏「更多」菜单里的「显示/隐藏文件面板」 | 控制栏**外露**的文件图标:终端页 → 跳到「文件」页并预选当前会话;终端独立窗口 → 打开/唤出文件窗口。快捷键 `Ctrl+Shift+P` 的 action id 仍叫 `toggleSftp`(改名会让用户已有的绑定失效),行为已改为跳页 |
|
||||
|
||||
#### 二、SSH → SSH 传输:流式中继(新增后端能力)
|
||||
|
||||
双远端传输是这次改版带来的**新组合**,原有两条命令(`sftp_upload` 需本地源、
|
||||
`sftp_download` 需本地目标)都不适用。三条路里选了**流式中继**:
|
||||
|
||||
| 方案 | 为什么不选 |
|
||||
|---|---|
|
||||
| 下载到本地临时目录再上传 | 本地磁盘要 ≥ 文件大小、链路走两遍、临时文件清理还要再定一套规则 |
|
||||
| 只浏览不传 | 用户明确要 ssh1 ↔ ssh2 |
|
||||
| **流式中继**(选中) | 从源会话读 32KB 块直接写进目标会话,本地只留一个缓冲;新增 `relay_file` + `terminal_sftp_relay` |
|
||||
|
||||
两处刻意的取舍:**只取目标侧的并发许可**(同时占源、目标两把信号量会在双向中继
|
||||
并发时成环);**不做断点续传**(两端都不在本地,没有可信的进度锚点,目标一律
|
||||
`TRUNCATE` 重写 —— 宁可重传也不能写出一半新一半旧的损坏文件)。
|
||||
|
||||
#### 三、独立文件窗口(单例)
|
||||
|
||||
`FileWindow.vue` + `terminal_file_window_open`,label 固定 `file-window`
|
||||
(新增 `capabilities/file-window.json`)。与终端独立窗口的关系是**刻意的不对称**:
|
||||
终端窗口的粒度是会话(一会话一窗口),文件窗口的粒度是「两台机器之间的关系」,
|
||||
因此它不绑会话,也就**只能是单例** —— 开第二个只会显示同一份状态。
|
||||
窗口由 Rust 隐藏创建,前端应用主题后再显示(与同模块其它窗口同一套)。
|
||||
|
||||
#### 四、SFTP 通道生命周期变了:按需打开、不再主动关
|
||||
|
||||
旧规则是「面板打开 → open,面板关闭 → close」。现在同一会话的通道可能被
|
||||
**两个窗口**同时使用(文件页 + 文件窗口),谁先切走就 close 会让另一个窗口
|
||||
直接报「尚未打开」。新规则:进入某栏的 ssh 来源时确保打开(幂等),
|
||||
关闭只发生在**会话结束时**(Rust 随会话回收)。因此前端不再调用
|
||||
`terminal_sftp_close` / `terminal_sftp_is_open`(两个命令保留在命令层)。
|
||||
|
||||
#### 五、代码落点
|
||||
|
||||
| 文件 | 变化 |
|
||||
|---|---|
|
||||
| `components/FilePane.vue`(新) | 单栏组件:本地与远端**合成一套代码**(差异只剩「调用哪条命令 / 路径怎么拼 / 删除是什么语义」),含连接选择器、多选、增删改 |
|
||||
| `components/FileManager.vue`(新) | 双栏容器:连接组合 → 传输方向的编排、传输进度条、默认分栏与失效连接的收敛 |
|
||||
| `FileWindow.vue`(新)+ `main.ts` | 独立窗口入口(`#file-window`) |
|
||||
| `fileUtils.ts`(新) | 路径拼接(`joinLocal` / `joinRemote`)与展示工具。**单独抽出来**是因为它要被三处用,而拼错路径是静默错误(`C:\dir\/name` 只在服务端报 `No such file` 时才暴露) |
|
||||
| `components/SftpPanel.vue` | **删除**(逻辑已并入 FilePane / FileManager) |
|
||||
| `stores/terminalStore.ts` | 新增 `filePaneSources`(两栏连接,放 store 才能在 tab 切走再回来时保住)、`sftpRelay`、`openFileWindow`;删除 `sftpClose` / `sftpIsOpen` |
|
||||
| `terminal/window.rs`、`ssh/sftp.rs` | `open_file_window`(单例幂等)、`relay_file`(流式中继) |
|
||||
|
||||
#### 验证
|
||||
|
||||
| 检查 | 结果 |
|
||||
|---|---|
|
||||
| `cargo check`(src-tauri) | exit 0(新增 capability 已被 tauri-build 收进 `capabilities.json`) |
|
||||
| `cargo test --lib` | 108 passed / 0 failed |
|
||||
| `vue-tsc --noEmit` | exit 0 |
|
||||
| `eslint src`(改动文件) | exit 0 |
|
||||
| 待真机确认 | 「文件」页左本地 / 右第一个 SSH;两栏可各自切到任一已连接会话(本地选项在另一栏已是本地时置灰);选中多文件后按方向按钮上传/下载/中继各跑通一次、进度条与完成提示正常;终端控制栏文件按钮跳页并预选当前会话;终端独立窗口的文件按钮打开/唤出文件窗口(第二次是唤出而非新建);Ctrl+Shift+P 同样可用 |
|
||||
|
||||
### 文件页布局返工:表格换固定列宽行(2026-09-24 第七轮)
|
||||
|
||||
第六轮上线后用户报五条,全部成立,其中一条是**布局缺陷而非审美问题**。
|
||||
|
||||
#### 一、名称列被压成 0 宽(真 bug)
|
||||
|
||||
截图里「名称」列头与所有文件名都不见了,大小/时间列被挤成 40px 宽、日期折成三行,
|
||||
列表还多出一条横向滚动条。根因是列表用了 `<table>` + **auto 布局**:
|
||||
|
||||
- 表格的 auto 布局按内容**协商**列宽。名称单元格里是 `min-w-0` 的 flex + `truncate`
|
||||
的文本,这个组合的最小内容宽度是 0,于是协商时名称列被让到 0;
|
||||
- 大小/时间列的 `w-20` / `w-28` 只是**偏好**宽度,协商中被压到最小内容宽度
|
||||
(`大小` 两个汉字换行、`2026-05-19` 在连字符处折行);
|
||||
- 表格的 `w-full` 又要求它撑满容器,两侧要求互相矛盾,最终多出一条横向滚动条。
|
||||
|
||||
**改法**:列表不再用表格,改成**定宽 flex 行**(与项目 `DataListRow` 同一套手法):
|
||||
|
||||
| 列 | 规则 |
|
||||
|---|---|
|
||||
| 名称 | `flex-1 min-w-0` + `truncate` —— 唯一可伸缩的一列 |
|
||||
| 大小 | `w-[72px] shrink-0` + `whitespace-nowrap tabular-nums` |
|
||||
| 修改时间 | `w-[76px] shrink-0` + `whitespace-nowrap` |
|
||||
| 权限(仅远端) | `w-11 shrink-0` + `whitespace-nowrap` |
|
||||
|
||||
定宽列没有任何协商空间,宽度不足时只会**挤名称列并截断**,其余列永不变形。
|
||||
表头与数据行共用同一套列宽,且表头放在滚动区**外面**(不随内容滚动,
|
||||
也不牵连 sticky 在 reka-ui viewport 里的定位问题)。
|
||||
|
||||
顺带把修改时间改成紧凑格式:本年内 `05-19 10:01`、其余 `2024-05-19`,
|
||||
完整时间戳放悬停提示(`fmtEntryTime` / `fmtFullTime`)。原先一律 `YYYY-MM-DD HH:mm`
|
||||
在 12px 下要 100px 宽,是定宽列被逼换行的直接原因。
|
||||
|
||||
#### 二、其余四条
|
||||
|
||||
| 反馈 | 处理 |
|
||||
|---|---|
|
||||
| 左右两栏应在一个窗口内、能拖中线改宽度 | 两张 `Card` + `gap-3`(读作「两个窗口并排」)改为**一张 `Card` 内两栏**,中间是命中区 5px、视觉 1px 的可拖分界线;宽度存**百分比**(`filePaneSplit`,存 store 以便切 tab 后仍生效),拖动逻辑挂在 document 上(鼠标划出 5px 命中区不会断) |
|
||||
| 内部宽度远超容器 | 见上,横向溢出随表格一起消失 |
|
||||
| 画面大了文字还是很小 | 列表 11px → **12px**、行高 → 32px;工具条/路径行/筛选框 11px → 12px、控件 h-6 → h-7;按钮与图标同步放大一档 |
|
||||
| 滚动条用 ScrollArea | 列表滚动区改为 `ScrollArea`(项目统一的可视化滚动条)。**注意**:ScrollArea 只有竖向滚动条,横向溢出会被裁掉 —— 所以它同时是「内容必须自适应」的硬约束,与表格改定宽列是同一件事的两面 |
|
||||
|
||||
#### 验证
|
||||
|
||||
| 检查 | 结果 |
|
||||
|---|---|
|
||||
| `vue-tsc --noEmit` / `eslint` | exit 0 |
|
||||
| 真实组件实测(临时页 = 真 `FileManager` + 真 Tailwind,`window.__TAURI_INTERNALS__.invoke` 喂假数据,视口 1267px) | 名称列 432.5px / 大小 72px / 修改时间 76px;超长文件名 `clientWidth 582 < scrollWidth 692` 且 `text-overflow: ellipsis`(截断生效);大小与时间列 `clientHeight == lineHeight == 16px` 单行;行高 32px、字号 12px;列表 `clientWidth === scrollWidth` → **无横向滚动条** |
|
||||
| 分界线拖动(同一次实测) | 合成 mousedown/mousemove(+202px)/mouseup 后:左栏 620.5px → 822px(行容器 1241px,即 50% → 66%),右栏同步收窄;拖动后两栏仍 `scrollWidth === clientWidth`,列与截断表现不变 |
|
||||
|
||||
> 结论:本轮的布局缺陷已用**实测**(而非推理)确认修复。上一版之所以漏掉,正是因为只跑了类型检查与 lint —— 表格 auto 布局的问题只在真实渲染里才暴露。
|
||||
|
||||
## 附:P1 新增命令清单(供前端对接与后续维护)
|
||||
|
||||
| 命令 | 参数 | 返回 |
|
||||
|---|---|---|
|
||||
| `terminal_sftp_is_open` | `sessionId` | `bool` |
|
||||
| `terminal_sftp_is_open` | `sessionId` | `bool`(前端已不用:通道按需打开、不主动关,见第六轮) |
|
||||
| `terminal_sftp_open` | `sessionId` | `ActionOutcome`(幂等) |
|
||||
| `terminal_sftp_close` | `sessionId` | `()` |
|
||||
| `terminal_sftp_list` | `sessionId`, `path` | `RemoteDir` |
|
||||
@@ -1196,10 +1377,16 @@ security / shortcuts)后广播 `terminal-settings`(无负载;`save_setting
|
||||
| `terminal_sftp_delete` | `sessionId`, `path`, `isDir` | `ActionOutcome` |
|
||||
| `terminal_sftp_rename` | `sessionId`, `from`, `to` | `()` |
|
||||
| `terminal_sftp_upload` | `sessionId`, `localPath`, `remotePath` | `ActionOutcome` |
|
||||
| `terminal_sftp_relay` | `fromSessionId`, `fromPath`, `toSessionId`, `toPath` | `ActionOutcome`(远端→远端流式中继,不经本地磁盘) |
|
||||
| `terminal_sftp_download` | `sessionId`, `remotePath`, `localPath` | `ActionOutcome` |
|
||||
| `terminal_file_window_open` | — | `ActionOutcome`(文件窗口,**单例**:已存在则 show + focus) |
|
||||
| `terminal_session_cwd_value` | `sessionId` | `string` |
|
||||
| `terminal_open_local_path` | `path` | `()` |
|
||||
| `terminal_reveal_local_path` | `path` | `()` |
|
||||
| `terminal_local_list` | `path`(空串 = 用户主目录) | `LocalDir`(`cwd` / `parent`(盘符根为 `null`)/ `entries`) |
|
||||
| `terminal_local_mkdir` | `path` | `()`(递归创建) |
|
||||
| `terminal_local_rename` | `from`, `to` | `()` |
|
||||
| `terminal_local_delete` | `paths: string[]` | `ActionOutcome`(**移入回收站**;部分成功时 `ok=false` 且 message 带成功数,前端按 `ok` 分流提示级别) |
|
||||
| `terminal_list_snippets` | — | `SnippetView[]` |
|
||||
| `terminal_save_snippet` | `snippet` | `SnippetView[]` |
|
||||
| `terminal_delete_snippet` | `snippetId` | `SnippetView[]` |
|
||||
@@ -1207,7 +1394,8 @@ security / shortcuts)后广播 `terminal-settings`(无负载;`save_setting
|
||||
| `terminal_run_snippet` | `sessionId`, `snippetId`, `values`, `submit` | `ActionOutcome` |
|
||||
| `terminal_restore_default_snippets` | — | `SnippetView[]` |
|
||||
|
||||
**新增事件**:`terminal-transfer-progress`(负载 `TransferProgress`,200ms 节流)。
|
||||
**新增事件**:`terminal-transfer-progress`(负载 `TransferProgress`,200ms 节流;
|
||||
`direction` 取 `upload` / `download` / `relay`,中继事件的 `sessionId` 是**目标**会话)。
|
||||
|
||||
### 追加:P1 第四 / 第五批(字符编码 + 命令历史)
|
||||
|
||||
|
||||
Reference in new issue
Block a user