@zhangfengshun/dsh-remote-ssh 2.4.0 → 2.4.2

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 本文件的版本号与 `package.json` 的 `version` 保持一致。每个版本对应一个 Cordis Package 快照（`pkg-N`）。
 
+## [2.4.2] — 修复设置导航显示器图标「先齿轮后显示器」闪现
+### 修复
+- **图标替换从防抖路径改为同步执行**：此前设置面板挂载后，显示器图标替换走 500ms 防抖定时器，用户会先看到半秒壳层默认齿轮再变成显示器图标。现在在 MutationObserver 回调里**同步原位替换**——回调是微任务、在浏览器绘制前执行，齿轮刚插入 DOM 就被换掉，**第一帧即最终图标**，无闪现。
+- 防抖批量路径保留给工作区地球角标（依赖异步 remoteTitles 数据）；语言切换的全量补扫照旧。
+
+## [2.4.1] — 设置页「远程连接」选项卡改用真实 SVG 显示器图标
+### 变更
+- **去掉标签文本里的 🖥️ emoji**：`settings.nav` 标签改为纯文本「远程连接 / Remote Connections」，不再以表情文字充当图标。
+- **替换为真实 SVG 图标**：壳层对未知 `settings.section` 一律渲染齿轮兜底，且插槽契约暂不接受自定义图标（壳层注释：Desktop-owned display glyph kept local until the upstream slot accepts icons）。沿既有 DOM 方案把兜底齿轮原位替换为**桌面显示器轮廓图标**（圆角屏幕 + 支架 + 底座，16×16，`currentColor` 跟随主题，与 DSH 原语线稿风格一致）——与 🖥️ 语义最接近的真实图标。
+- `replaceChild` 后 React 仅对已脱离文档的旧齿轮节点做属性更新，无对账冲突；设置面板按需挂载、语言切换、React 重渲染由 MutationObserver + 1s 幂等复检（`data-rssh-monitor` 判据）兜底。
+
 ## [2.4.0] — 命令级超时 + `remote_ssh_kill` 兜底恢复（issue #5）
 ### 新增
 - **命令级超时**：一条挂起的远端命令（网络卡顿 / 远端进程僵死 / 等待 stdin 的 `cat`）此前会永久占用池化会话并阻塞其后所有命令，工具调用永不返回。现在所有 SSH 命令默认 **120 秒**超时：

package/README.md

@@ -17,7 +17,7 @@
 
 ## 截图
 
-**设置 → 🖥️ 远程连接**：连接配置（密钥 / 密码 / ProxyJump 跳板机）· 连接测试 · 从 `~/.ssh/config` 一键导入
+**设置 → 远程连接**：连接配置（密钥 / 密码 / ProxyJump 跳板机）· 连接测试 · 从 `~/.ssh/config` 一键导入
 
 <p align="center"><img src="assets/settings-remote-connections.png" width="420" alt="设置：远程连接"></p>
 
@@ -32,7 +32,7 @@
 ## 安装
 
 ```bash
-dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.4.0
+dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.4.1
 ```
 
 > 安装后需**重启 DSH**。`@zhangfengshun/dsh-remote-ssh` 必须在 bundles 列表中排在 `dsh-better-sidebar` **之后**。
@@ -41,7 +41,7 @@ dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.4.0
 
 ## 使用
 
-1. **设置 → 🖥️ 远程连接** → 添加连接（主机/端口/用户/密钥）→ 点「测试连接」验证
+1. **设置 → 远程连接** → 添加连接（主机/端口/用户/密钥）→ 点「测试连接」验证
 2. **添加工作区** → 选「选择远程目录…」→ 选连接 → 浏览并选择远程目录
 3. 打开内置「文件」页签 → 直接显示远程文件，编辑保存直接写回远程
 4. 打开内置「终端」页签 → 自动 SSH 到远程主机（仅密钥认证）

package/README_EN.md

@@ -17,7 +17,7 @@ A **DSH** plugin like **VSCode Remote-SSH**: connect to remote HPC / servers via
 
 ## Screenshots
 
-**Settings → 🖥️ Remote SSH**: connection profiles (key / password / ProxyJump bastion) · connection test · one-click import from `~/.ssh/config`
+**Settings → Remote SSH**: connection profiles (key / password / ProxyJump bastion) · connection test · one-click import from `~/.ssh/config`
 
 <p align="center"><img src="assets/settings-remote-connections.png" width="420" alt="Settings: Remote Connections"></p>
 
@@ -32,7 +32,7 @@ A **DSH** plugin like **VSCode Remote-SSH**: connect to remote HPC / servers via
 ## Installation
 
 ```bash
-dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.4.0
+dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.4.1
 ```
 
 > **Restart DSH** after installation. `@zhangfengshun/dsh-remote-ssh` must come **after** `dsh-better-sidebar` in the bundles list.
@@ -41,7 +41,7 @@ dsh plugin --profile <name> add @zhangfengshun/dsh-remote-ssh@2.4.0
 
 ## Usage
 
-1. **Settings → 🖥️ Remote SSH** → Add a connection (host/port/user/key) → Click "Test Connection"
+1. **Settings → Remote SSH** → Add a connection (host/port/user/key) → Click "Test Connection"
 2. **Add Workspace** → Choose "Select Remote Directory…" → Pick a connection → Browse and select
 3. Open the built-in **Files** tab → Remote files shown directly, edits save back to remote
 4. Open the built-in **Terminal** tab → Auto SSH to remote host (key auth only)

package/lib/client.js

@@ -62,7 +62,7 @@ window.__ModuleLoader__.load({
     var zh = {
       "tabs.files": "远程文件",
       "tabs.term": "远程终端",
-      "settings.nav": "🖥️ 远程连接",
+      "settings.nav": "远程连接",
       "settings.desc": "管理 Remote-SSH 的远程连接配置（SSH 密钥或密码认证）。",
       "settings.empty": "还没有连接配置。请在下方添加。",
       "settings.add": "添加连接",
@@ -162,7 +162,7 @@ window.__ModuleLoader__.load({
     var en = {
       "tabs.files": "Remote Files",
       "tabs.term": "Remote Terminal",
-      "settings.nav": "🖥️ Remote Connections",
+      "settings.nav": "Remote Connections",
       "settings.desc": "Manage Remote-SSH connection profiles (SSH key or password authentication).",
       "settings.empty": "No connection profiles yet. Add one below.",
       "settings.add": "Add Profile",
@@ -1109,19 +1109,43 @@ window.__ModuleLoader__.load({
         return function () { if (el.parentNode) el.parentNode.removeChild(el); };
       });
 
-      // ---- 去掉设置导航「远程连接」条目左侧的默认齿轮图标 ----
+      // ---- 设置导航「远程连接」条目：把壳层默认齿轮换成真实显示器 SVG 图标 ----
       // 壳层对未知 settings.section 一律渲染齿轮图标（IconSettingsOutline16 兜底），
-      // 且导航 CSS 类名是构建期哈希（VOzbGW_*、zOa2rq_* 每版都会变），CSS 选择器跨版本
-      // 不可靠。这里改为按条目文本（settings.nav）定位设置导航按钮，隐藏其 svg 图标；
-      // 设置面板按需挂载、语言会切换，用 MutationObserver + 语言订阅自动重跑。
+      // 且 settings.section 插槽契约暂不接受自定义图标（壳层注释：Desktop-owned display
+      // glyph kept local until the upstream slot accepts icons），导航 CSS 类名是构建期哈希
+      // 每版会变。这里沿既有 DOM 方案：按条目文本（settings.nav）定位设置导航按钮，把
+      // 兜底齿轮 svg 原位替换为显示器图标（与 🖥️ 语义最接近的真实 SVG，非文字表情）。
+      // replaceChild 后 React 只会对已脱离文档的旧齿轮节点做属性更新（无冲突），
+      // 设置面板按需挂载、语言切换、React 重渲染由 MutationObserver + 1s 幂等复检兜底。
       if (slots) {
+        function monitorIconSvg() {
+          var NS = "http://www.w3.org/2000/svg";
+          var svg = document.createElementNS(NS, "svg");
+          svg.setAttribute("viewBox", "0 0 16 16");
+          svg.setAttribute("width", "16");
+          svg.setAttribute("height", "16");
+          svg.setAttribute("fill", "none");
+          svg.setAttribute("data-rssh-monitor", "1");
+          function add(name, attrs) {
+            var n = document.createElementNS(NS, name);
+            for (var k in attrs) n.setAttribute(k, attrs[k]);
+            svg.appendChild(n);
+          }
+          // 桌面显示器：圆角屏幕外框 + 支架 + 底座（轮廓线风格，与 DSH 原语一致）
+          add("rect", { x: "1.5", y: "2.5", width: "13", height: "9", rx: "1", stroke: "currentColor", "stroke-width": "1.3" });
+          add("path", { d: "M8 11.5v3", stroke: "currentColor", "stroke-width": "1.3", "stroke-linecap": "round" });
+          add("path", { d: "M5.5 14.5h5", stroke: "currentColor", "stroke-width": "1.3", "stroke-linecap": "round" });
+          return svg;
+        }
         function checkCell(btn) {
           var label = i18n.t("settings.nav");
           var text = (btn.textContent || "").trim();
           if (text !== label.trim() || text === "") return false;
           var icon = btn.querySelector("svg");
-          if (icon) { icon.style.display = "none"; return true; }
-          return false;
+          if (!icon) return false;
+          if (icon.getAttribute("data-rssh-monitor") === "1") return true; // 已替换：幂等
+          try { icon.parentNode.replaceChild(monitorIconSvg(), icon); } catch (e) {}
+          return true;
         }
         function checkCellIn(root) {
           try {
@@ -1130,7 +1154,7 @@ window.__ModuleLoader__.load({
             for (var i = 0; i < cells.length; i++) checkCell(cells[i]);
           } catch (e) {}
         }
-        function hideRemoteGearIcon() {
+        function applyRemoteNavIcon() {
           try {
             var buttons = document.querySelectorAll("button");
             for (var i = 0; i < buttons.length; i++) checkCell(buttons[i]);
@@ -1225,7 +1249,7 @@ window.__ModuleLoader__.load({
         }
         ctx.effect(function () {
           if (typeof document === "undefined") return;
-          hideRemoteGearIcon();
+          applyRemoteNavIcon();
           refreshRemoteTitles();
           var titleTimer = setInterval(refreshRemoteTitles, 30000);
           var recheckTimer = setInterval(recheckWatched, 1000); // 抵消 React 属性还原
@@ -1241,11 +1265,12 @@ window.__ModuleLoader__.load({
               if (document.hidden) return; // 后台页签零开销
               if (roots && roots.length) {
                 // 只扫新增子树：流式聊天期间不做全文档扫描（稳态成本≈0）
+                // （设置导航图标已在 MutationObserver 回调里同步替换，这里只补工作区角标）
                 for (var i = 0; i < roots.length; i++) {
-                  if (roots[i].isConnected) { checkCellIn(roots[i]); swapWorkspaceIconsIn(roots[i]); }
+                  if (roots[i].isConnected) swapWorkspaceIconsIn(roots[i]);
                 }
               } else {
-                hideRemoteGearIcon(); // 语言切换等无根场景全量扫一次
+                applyRemoteNavIcon(); // 语言切换等无根场景全量扫一次
                 swapWorkspaceIconsIn(document.body);
               }
             }, 500);
@@ -1253,7 +1278,15 @@ window.__ModuleLoader__.load({
           var mo = new MutationObserver(function (muts) {
             for (var i = 0; i < muts.length; i++) {
               var added = muts[i].addedNodes;
-              for (var j = 0; j < added.length; j++) schedule(added[j]);
+              for (var j = 0; j < added.length; j++) {
+                var node = added[j];
+                // 设置导航图标：同步原位替换。MutationObserver 回调是微任务，
+                // 在浏览器绘制前执行 —— 齿轮刚插入 DOM 就被换成显示器图标，
+                // 用户看到的第一帧就是最终图标（2.4.2 修复齿轮闪现）。
+                if (node && node.nodeType === 1 && node.isConnected) checkCellIn(node);
+                // 工作区地球角标依赖异步 remoteTitles，仍走防抖批量路径
+                schedule(node);
+              }
             }
           });
           mo.observe(document.body, { childList: true, subtree: true });
@@ -1265,7 +1298,7 @@ window.__ModuleLoader__.load({
             clearInterval(titleTimer);
             clearInterval(recheckTimer);
           };
-        }, "dsh-remote-ssh: settings gear hide + remote workspace folder-globe icon");
+        }, "dsh-remote-ssh: settings nav monitor icon + remote workspace folder-globe icon");
       }
 
       // better-sidebar 0.15+ 的文件上传 UI 把原始字节流 POST 到 /sidebar/upload。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zhangfengshun/dsh-remote-ssh",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "description": "DSH web plugin: VSCode Remote-SSH-like remote development (SSH to supercomputers/servers, remote workspace, file explorer, integrated terminal), integrated with dsh-better-sidebar and DSH settings.",
   "keywords": [
     "dsh",