Skip to content

chore: dev → main(三栏导航外壳 + 首页崩溃修复 + 扩展连接/工具箱/剪贴板) - #573

Merged
feigeCode merged 22 commits into
mainfrom
dev
Nov 20, 2026
Merged

feigeCode merged 22 commits into
mainfrom
dev

Conversation

@feigeCode

Copy link
Copy Markdown
Owner

dev 累积的 5 个提交合并进 main。

提交清单

1. 437cd8b feat(ui): implement fixed three-column navigation shell

首页改为固定三栏导航外壳(全局导航 / 连接列表 / 详情),含批量选择与拖动交互。

2. 1e18663 fix(home): 修复首页远端资源占用采集的 Tokio reactor 崩溃

  • 根因:[Feature]: 在资产界面增加一个不登陆服务器就可以看到资源占用情况 #279 的 refresh_host_metrics 用 cx.background_spawn 跑 probe_host_resource_usage,SSH 建连路径(crates/ssh/src/ssh.rs 的 tokio::time::timeout)要求 Tokio 运行时,GPUI 后台线程池没有 reactor → there is no reactor running panic,随后 abort(exit 134)。home_show_host_metrics 默认开启,有 SSH 连接的用户一开首页必崩。
  • 修法:改用 one_core::gpui_tokio::Tokio::spawn,与 terminal_view 其它 SSH 建连一致;JoinError 时清 in_flight 并记 debug 日志。
  • 验证:dev profile 编译通过,启动后连续运行无 panic。

3. 4ba7a6c feat(extension): 扩展贡献的连接类型接入「新建连接」向导

扩展清单声明 kind="connection" 的 contribution 此前在向导里没有入口。app_kit 新增两个默认方法,new_connection 合并宿主与扩展种类,kind id 用 ext:{extension_id}::{contribution_id};顺带修「中间件」空态点「+」/回车无反应(find_entry 未匹配扩展项)。

4. 51cf300 feat(toolbox): 工具箱不再列出贡献面板的扩展 app

catalog 增加 panel_extensions 过滤,避免贡献 panels 的扩展在工具箱里多出一张空卡片。

5. 28e148d fix(clipboard): 粘贴图片统一转 PNG,临时文件统一 navop- 前缀

normalize_clipboard_image 把非 png/jpeg/webp/gif(如 macOS 截图的 TIFF)重编码为 PNG;远端临时文件 /tmp/onetcli-paste-* → /tmp/navop-paste-*.png,本地临时文件改 navop-clipboard-upload-*。

验证

  • cargo check -p navop_app --all-targets 通过(dev 基线)
  • cargo run -p navop 启动正常,首页远端资源占用采集不再 panic

普通 dev→main 合并,不含 CHANGELOG 与版本 bump;发版另开 release PR。

paofu-cium and others added 22 commits October 14, 2026 16:23
Windows 原生 RDP(mstscax)会话里,会话指针由 ActiveX 控件自己绘制并自己
设置光标,navop 既不绘制远端光标也不接管该路径的鼠标输入。但
RemoteCursorState 仍按 protocol == Rdp 认为自己在管理 OS 光标,而
pointer_hovered 在该路径永远为 false(on_hover / on_mouse_move 只对 canvas
路径注册),于是 should_hide_native_cursor() 恒假,sync_native_cursor() 走
restore 分支。

promote_latest() 每帧无条件调用 sync_native_cursor(),因此原生会话下 navop
每帧都执行 SetCursor(IDC_ARROW),与 ActiveX 设置的光标互相覆盖:远端窗口
边框上控件刚把光标换成双向调整箭头,下一帧就被 navop 改回普通箭头,表现为
"鼠标箭头和双向箭头来回变化",光标热点随之漂移,远端窗口边框几乎无法瞄准,
很难真正拖动调整大小。

修改:给 RemoteCursorState 增加 native_cursor_owned,由 render 每帧按
!uses_windows_native_presentation() 同步;未持有所有权时,
sync_native_cursor / rehide_native_cursor_after_pointer_move /
release_all_images 全部不再触碰 OS 光标。交还所有权时只撤销 navop 自己
施加过的隐藏,避免向原生会话多打一次 SetCursor。

同时给 native_cursor 增加 #[cfg(test)] 调用计数,让"谁持有 OS 光标"变成可
断言的行为而不是仅靠注释。

验证:
- cargo test -p remote_desktop_view --lib:264 passed / 0 failed,含新增
  native_presentation_does_not_touch_the_os_cursor 与
  handing_the_os_cursor_back_only_undoes_a_hide_navap_applied 两条回归用例
- 本机为 Windows 10 家庭版(fDenyTSConnections=1,无入站 RDP 服务),无法
  搭建真实 RDP 会话做端到端复现,真机验证仍待有远端主机的环境确认
#279 在 refresh_host_metrics 里用 cx.background_spawn 去跑
terminal_view::probe_host_resource_usage,而 SSH 建连路径(crates/ssh/src/ssh.rs
的 tokio::time::timeout)要求处于 Tokio 运行时。GPUI 的后台线程池没有 reactor,
于是 panic: there is no reactor running, must be called from the context of a
Tokio 1.x runtime,两个未命名线程接连 panic 后 fatal runtime error 直接 abort
(exit code 134)。

设置里 home_show_host_metrics 默认开启,因此有 SSH 连接的用户一打开首页应用就崩溃。

改为与 terminal_view 里其它 SSH 建连一致的 one_core::gpui_tokio::Tokio::spawn,
任务返回 JoinError 时只清掉 in_flight 并记 debug 日志,不再 panic。
扩展清单里可以声明 kind="connection" 的 contribution,但向导只认宿主内置
连接种类,装了这类扩展也看不到入口。

- app_kit 的 HostContribution 增加两个默认方法,new_connection 合并宿主与扩展
  提供的连接种类,kind id 用 ext:{extension_id}::{contribution_id} 前缀区分;
- 顺带修「中间件」空态下点「+」或回车静默无反应(find_entry 没匹配到扩展项);
- 编辑/复制既有连接时不再走贡献表单,避免把扩展表单套到宿主连接上。
贡献 panels 的扩展会在工具箱里重复出现一个空 app 卡片;catalog 增加
panel_extensions 过滤,只保留真正有工具入口的扩展。
剪贴板里常见 TIFF 等格式(macOS 截图就是 TIFF),远端预览服务不认,粘贴
终端/SFTP 会失败。

- normalize_clipboard_image 把非 png/jpeg/webp/gif 重编码为 PNG,解码失败则
  原样返回不阻断粘贴;
- 远端临时文件从 /tmp/onetcli-paste-* 改为 /tmp/navop-paste-*.png,本地临时
  文件改为 navop-clipboard-upload-*,与项目改名的其余部分保持一致。
在连接卡片、列表和树形视图中展示远端系统、CPU、内存与磁盘信息,并按布局使用完整胶囊、紧凑状态带和迷你状态条。

后台探测改用应用 Tokio runtime,解析钥匙串凭据,限制并发并继续排空待采集连接;补充周期刷新和显示开关门控。
问题:
- JumpServer 等堡垒机按策略拒绝 direct-tcpip 端口转发,russh 只回传
  原因枚举导致界面只显示 "Failed to open channel (AdministrativelyProhibited)",
  用户无从知道真实成因;
- 堡垒机场景只能靠「跳板机(ProxyJump)」硬闯端口转发,没有「登录式直连」模式,
  Koko 类堡垒机的 user#account#asset 直连格式完全用不上;
- SFTP 跳板认证走的是无 MFA 的旧路径(authenticate_with_strategy 无
  KeyboardInteractiveTarget 区分),跳板机 OTP/MFA 全部失效;
- 存储层 JumpServerConfig → 连接层 JumpServerConnectConfig 的映射在
  terminal/sftp_transfer/runtime_sftp/port_forwarding/ssh_form 五处重复实现,
  认证映射漂移(键盘响应器只有两处传入);
- 每个终端连接各建独立 SshSessionManager,跨 tab/跨连接零复用;DB/Redis/
  Mongo「引用 SSH 连接建隧道」时 jump/proxy 配置全部丢失;
- ssh_session_registry / ssh_session_identity 两层共享基础设施已建好但无任何
  调用者(死代码)。

修法(按设计文档 docs/design/ssh-jump-server-optimization.md 四期落地):
- P0 错误链:russh Handler 的 channel_open_failure 钩子捕获服务器 descr 存入
  open_failure_slot,direct-tcpip 拒绝时读槽补上下文并包装为
  JumpChannelRejected(含堡垒机端口转发被禁提示);SFTP 跳板认证改走
  authenticate_with_strategy_for_target(KeyboardInteractiveTarget::JumpServer),
  补齐 MFA/OTP 支持;
- P1 BastionDirect:JumpServerConfig/JumpServerConnectConfig 增加
  mode/bastion_asset/bastion_account/bastion_user_format,用户名按
  user#account#asset 格式渲染直连堡垒机,由堡垒机代理会话/SFTP/exec
  (Koko DirectConnectSftpMode / proxyAssetCommand),不开 direct-tcpip;
  表单增加跳板机模式单选与堡垒机资产/账号输入,三语 i18n;
- P2 映射收敛:sftp_transfer::ssh_config 提供 jump_connect_config /
  proxy_connect_config / ssh_auth 统一入口,五处重复映射合一删除;
- P3-T1 隧道继承:SshTunnelConfig 增加 jump/proxy 可序列化字段(向后兼容),
  apply_referenced_ssh_tunnel 引用 SSH 连接时回填跳板/代理配置,redis/mongo
  隧道路径不再硬编码 None;
- P3-R1 共享传输接线:PersistedSshSessionIdentity 增加
  derive_from_metadata;shell_domain 暴露 ssh_session_service 并在 init 时
  注入 Terminal 侧获取桥;Terminal 连接尝试经 registry acquire 共享租约
  (acquire 完成后才启动连接任务,保证首个连接即共享;失败/临时连接回退本地
  manager),四个 take+disconnect 点按持有方式收尾(共享租约只 release,
  绝不断其他 tab 共享的传输);terminal_view refresh 时补注册 remote_ops,
  修复「运行时凭据连接 ssh_exec 永远不可用」缺口。

验证:
- cargo test 受影响 crate 全绿(one-core 1351+ / ssh 169+ / sftp 111+ /
  terminal 556 / terminal_view 623 / shell_domain 43 / sftp_transfer 52 /
  port_forwarding 7 / runtime_sftp 17 / redis-runtime / db / mongodb_view 等,0 failed);
- cargo test --workspace --no-run 编译零错误;
- cargo clippy --all-targets 无新增 error;
- 新增测试覆盖:跳板拒绝包装、堡垒机直连格式、五处映射合一、隧道 jump 继承、
  identity 元数据派生、lifecycle 双全局注入。
CNB 对象存储免费额度 100 GiB(统计制品、LFS、图片与附件),而 navop 单版镜像
已涨到约 3 GiB,46 个历史 Release 占了 80.76 GiB,触发了 80% 用量告警。

新增 .github/scripts/prune-cnb-releases.sh:列出 CNB Release,保留版本号最大的
5 个,并保底保留最新稳定版与最新 beta —— 两条通道的客户端都按「最新 tag」取
feed-*.json,保底避免 5 个最新版本全是 beta 时稳定清单断供。

清理只删 Release,不动 git tag(更新器靠 git refs 广告发现版本);本次已在线上
实测:删掉 41 个旧 Release 后 115 个 tag 完全一致,保留版本的 feed 匿名可下载。
脚本拒绝在「本次同步的 tag 不在 CNB 上」时清理,令牌缺 repo-release:rw 时报错
并提示重建,避免静默失效。

同步脚本从 github.ref 的稀疏检出里取,不依赖按 tag 检出的工作区,这样手工重跑
旧 tag 也能执行清理。
问题一:共享会话 acquire 在 GPUI executor 上直接 await,其内部
tokio::spawn(idle reaper / 创建飞行)找不到 Tokio reactor,打开
堡垒机连接时直接 panic(session_registry.rs:636 "there is no reactor
running")。改为先克隆 connect 配置,用 Tokio::spawn 包一层再等待,
失败时回退本地 manager。

问题二:堡垒机直连(BastionDirect)模式下目标认证被跳过、实际认证
的是堡垒机会话,但「连接时输入密码」只注入目标主机 auth,运行时输
入的密码到不了 jump.auth,导致该模式下每次都拿空密码认证失败。现在
运行时密码会同时注入 jump.auth 的 Password 因子(含组合认证场景)。

验证:cargo test -p terminal --lib 556 passed 0 failed;dev 实例实跑
BastionDirect 连接 10.2.5.220:2222 成功(终端/exec 落在资产
10.1.101.27,SFTP 读取 /tmp 文件成功,行为与系统 sftp 客户端一致)。
为一次性资源探测补充第二次 /proc/stat 快照并计算 CPU 使用率;列表把地址与资源信息合并到同一行,降低行高。

卡片区分采集成功、等待和失败状态,仅在需要资源状态带时预留高度,避免无内容空白。
JumpServer 的 Luna 页面点「连接」时会把一次性 connection token 拼成
jms:// 链接交给系统处理器。Navop 此前只处理 file://,jms:// 会被当成
本地文件打开并失败,所以网页里点连接拉不起客户端。

实现:
- 新增 crates/navop_app/src/jump_deeplink.rs:解析 jms://<base64url(JSON)>,
  token.id/value 兼容旧版顶层 id/value,endpoint 作为 SSH 网关;用
  JMS-<token.id> 作用户名、token value 作密码,构造 id=None、
  sync_enabled=false 的临时连接,经 registry().open_connection 打开 SSH
  终端;protocol=sftp 时自动切到 SFTP 双栏。凭据只用于本次会话,不落库、
  不写日志,解析失败也不会回显含 token 的原始 URL。
- file_open.rs:on_open_urls 与启动参数(Windows/Linux 二次启动走 argv)
  统一识别 jms:// 并转交深链处理;Linux 桌面文件 %U 传入的 file:// 也在这里
  解码成本地路径,普通路径行为不变。
- 系统关联:AppIdentity 新增 url_schemes 声明;macOS Info.plist 增加
  CFBundleURLTypes(仅全量产品,shell/data 由打包脚本删段);Windows MSI
  写 HKCU\Software\Classes\jms(默认值、URL Protocol、DefaultIcon、
  shell\open\command);Linux desktop 改用 %U 并声明 x-scheme-handler/jms;
  app_kit 按产品声明的 scheme 动态注册,注册戳升级到 v3 让旧安装重跑。
- 打包回归:test-bundle-macos.sh 校验三产品的 URL scheme 声明,
  test-release-packaging.mjs 增加 plist/WiX/desktop 的 jms 断言。

验证:cargo test -p navop_app --lib jump_deeplink(10 项通过)、
cargo test -p app_kit --lib(200 项通过)、node --test
script/test-release-packaging.mjs(47 项通过)。
问题:堡垒机直连模式下,「跳板机」页要填一遍堡垒机地址/端口/用户名/认证,
「基础信息」页还得把同样的地址/端口/用户名/认证再填一遍;而且基础信息里
这几项在堡垒机直连时并不参与连接,只是保存校验要求主机非空才被迫填。

修法:把「直连 / 跳板机 / 堡垒机直连」提到基础信息顶部做成单选:
- 直连:只连目标主机,跳板机页变为说明文字;
- 跳板机:ProxyJump 转发,跳板机页保留原有表单;
- 堡垒机直连:基础信息即堡垒机登录信息(标签改为「堡垒机地址/端口」),
  下方补「堡垒机资产 ID / 资产登录账号」,保存时由基础信息派生
  jump_server(mode=BastionDirect);缺资产或账号直接拦住保存。
停用跳板机时已填信息仍写进 disabled_jump_server,切回跳板机可恢复。
跳板机认证方式同目标主机一样改用下拉框,避免一整排单选在多语言长标签下
换行把表单撑宽。
问题:
- 堡垒机直连(JumpServer/Koko)下,资产的「文件管理根目录」之外的路径会被
  服务端回 `No such file`,而 list_dir 直接透传原始错误,用户只看到
  「列出目录失败: Failed to read directory /home: No such file: file does not exist」,
  很容易误判成文件真的不存在。
- list_dir 的 read_dir 没有任何超时,堡垒机限流或大目录时文件面板会一直转圈,
  MCP 那条连接被拖住后整条关闭(Navop MCP connection closed)。

改动:
- list_dir 包一层 30 秒超时,超时给出「N 秒内没有收到服务器响应」的可读提示。
- 新增 describe_list_dir_error:路径不存在且当前是堡垒机直连时,改说
  「堡垒机只开放了受限的 SFTP 根目录…请在根目录 / 内操作,或请管理员把
  『文件管理根目录』改成你要浏览的路径」;普通服务器仍保留原文。
- 判定堡垒机直连需要会话级信息:RusshClient 记录 bastion_direct 并暴露
  is_bastion_direct(),复用终端连接的 SFTP 客户端(connect_with_client)据此
  继承同一判定,避免只有独立连接才拿到正确文案。
堡垒机直连时 SFTP 只开放资产的「文件管理根目录」(常见为 /tmp),而终端里
`cd /home` 完全正常,于是 OSC 7 每次上报都把文件面板拽到一个远端并不存在的
目录,面板只能报「读取目录失败」再回退——用户每 cd 一次就挨一次错误。用户
反馈的「这个一直报错」就是这个循环。

改动:
- 记住最近一次由跟随终端目录发起的导航目标;只有属于这种导航的失败才归因
  于跟随本身(用户自己点进的目录失败仍走原来的回退逻辑)。
- 判定成立时停用跟随、通过 ToggleFollowTerminalCwd 交回宿主持久化,面板退回
  根目录(受限会话能浏览的那块),并只提示一次说明原因,不再反复弹错。
- 三语文案 follow_suspended_restricted_root,讲清「终端路径在远端不存在」并
  告诉用户可以在工具栏重新打开跟随。
Windows 客户端遇到服务端合法的 `c:` / `c:foo` 条目时,`is_valid_remote_entry_name`
用 `Path::components()` 把它解析成盘符前缀而判非法,`list_dir` 随即整个目录返回
Err,文件面板按导航失败回退到工作目录,用户看到「读取目录失败:Refusing unsafe
SFTP directory entry name ... "c:"」。同一个目录在 macOS / Linux 客户端却能正常
打开,平台相关本身就是缺陷。

把校验拆成两件事:
- `is_valid_remote_entry_name` 只做平台无关的单层名字检查:非空、不是 `.` / `..`、
  不含 `/`、`\`、NUL。`c:`、`a:b` 在 Linux 服务器上是普通文件名,照常列出。
- 新增 `is_valid_local_file_name`,额外拒绝 Windows 盘符前缀形态,只用于把远程
  名字拼成本地路径的位置(目录下载相对路径、FTP 下载相对路径、SFTP 单文件下载、
  侧栏下载目标与下载)。

同时 `list_dir` 与目录递归列举遇到真非法的名字(`../outside.txt`、含 `/`)改为
跳过并记 warn,不再让一个坏条目毁掉整个目录浏览;落盘前仍逐分量复核,穿越防护
不放松。

测试:新增 `russh_impl_listing_tests.rs`(进程内假 SFTP 服务端返回 `.`、`..`、
`../outside.txt`、`sub/file.txt`、`c:` 等,断言列举成功且只保留合法条目);
目录下载穿越用例改为断言「跳过坏条目、其它文件照常下载、不落盘到沙箱外」;
`cargo test -p sftp --lib` 121 passed,`cargo test -p ftp --lib` 23 passed。
@feigeCode

Copy link
Copy Markdown
Owner Author

已修复上一轮 CI 的三处 warnings-as-errors,并一并合入 #574 的终端独立搜索浮层。提交:3f63fbc8defc5bad4d2c49453958c1f8fd852801。已验证 RUSTFLAGS='-D warnings' cargo check --workspace --all-targets、深链接 12 项测试及 terminal_view 全量 lib 测试。

@feigeCode
feigeCode merged commit e5463d0 into main Nov 20, 2026
18 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants