dsh-code-server-app 0.3.69 → 0.3.71

package/lib/client.js

@@ -16,20 +16,14 @@
  *   ④ 各段落原来的顶层标识符现在共享同一作用域 —— 新增顶层名字时先搜一遍别撞名
  *      (var/function 撞名是**静默覆盖**,不会报错)。
  *
- * DSH 支持范围(2026-09-22 收敛;**判据一律是能力是否被声明**,不做版本号比较):
- *   · rc 线    0.1.5-rc.x(最新 0.1.5-rc.3 = npm latest/next)
- *              座位 `settings.plugin.item` + 会话列表快照上的 `current` + 数据通道 `settingsScope`
- *   · alpha 线 ≥ 0.1.6-alpha.2(最新 0.1.7-alpha.1)
- *              座位 `plugins.bundle.config` + 会话作用域标准 prop `sessionId`
- *
- *   **座位与数据通道的分界点不在同一版**,所以代码里是两条独立的轴(详见"设置"段的说明):
- *   ① {旧座位, 旧通道} = rc 线;
- *   ② {新座位, 旧通道} = **0.1.6-alpha.2**(座位已搬走、`settingsScope` 还在);
- *   ③ {新座位, 新通道} = **≥ 0.1.7-alpha.1**(`settingsScope` 被删除,换成 `configForms`)。
- *   静态 `inject` 因此只留普遍存在的 `['slots']`,两个通道都运行时探测 —— 写进 inject 会让整个
+ * DSH 支持范围(2026-10-01 收敛成**一代**;判据一律是能力是否被声明,不做版本号比较):
+ *   · DSH ≥ 0.2.0-rc.2 —— web 与 desktop 现在都是这一代:`sidebarRightTabs`(标签类型 + `keepMounted`)、
+ *     `useTabInfo()`、插件页座位 `plugins.bundle.config`、会话作用域标准 prop `sessionId`、通道 `configForms`。
+ *   旧代的兼容分支已随本轮清理删除(rc 线 `0.1.5-rc.x` / alpha 线 `0.1.6-alpha.2…0.1.7-rc.x`):
+ *   座位 `settings.plugin.item`、通道 `settingsScope`、会话快照上的 `current`、`recentWorkspaceId` 都不再支持;
+ *   旧版 DSH 用户钉旧插件版本(见 README「旧版 DSH」一段)。
+ *   静态 `inject` 因此只留普遍存在的 `['slots']`,`configForms` 一律运行时探测 —— 写进 inject 会让整个
  *   条目在没有那个服务的 DSH 上永远 pending(表现是侧栏标签/设置/预热**一起消失**)。
- *   更早的 alpha(0.1.5-alpha.x、0.1.6-alpha.1)形状与 rc 线相同 —— 代码天然走得通,但**不作为目标**,
- *   也不为它们写任何专门分支。本文件里凡出现"哪一版"的说法,都按这两条线命名。
  *
  * 段落(按依赖顺序):地址语法 → 工作区解析 → 常驻面 → 全屏动作 → 认领类型(与 lib/claim-types.js
  * 同源的一致性副本)→ 插件主体。
@@ -143,16 +137,13 @@ function resolveFilePath(parsed, cwd) {
 // —— 解析"当前工作区目录"(决定 workbench 用哪个 `?folder=` 打开)
 //
 // 为什么单独成模块:这段逻辑的真实输入是 **DSH 客户端 store 的形状**,而它随 DSH 版本变过 ——
-//   · rc 线(≤ 0.1.5-rc.3,最新 rc 仍是这样):`SessionListState` 带 `current`(选中的会话 id 挂在快照上,
-//     老写法 `useSessions(s => s).current` 即"当前会话");
-//   · alpha 线(≥ 0.1.6-alpha.2,含最新 0.1.7-alpha.1):`current` 被移出列表 store(上游 refactor 注释:view selection remains
-//     outside the Controller;快照只剩 `{ ids, byId, phase, subagentsByParent, jobsBySession }`),
-//     会话作用域插槽改为用标准 prop `sessionId` 告诉 body"你是哪个会话的" —— 官方自己的右侧栏标签
-//     就是这么读 cwd 的(ui-deliverables 的 ReviewTab:`useSessions(s => s.byId[sessionId]?.cwd)`)。
-// 只认一种形状 ⇒ 在另一版上静默拿到 undefined:0.3.46 在 0.1.6-alpha.2 上就是这样 —— 客户端不再
-// 发 cwd,IDE 以**空工作区**启动(pid.json 里 cwd/launchCwd 双空)。所以这里按
-// 「会话标准 prop → 旧版 current → 工作区表补位」的顺序取,并把判断留在纯函数里(可离线单测,
-// 见 scripts/test-workspace-cwd.mjs;hook 一律留在组件内,本模块不碰 React)。
+// 所以判断全留在这个纯函数里(可离线单测,见 scripts/test-workspace-cwd.mjs;hook 一律留在组件内,
+// 本模块不碰 React)。
+//   0.2 这一代:会话作用域插槽用标准 prop `sessionId` 告诉 body"你是哪个会话的",官方自己的右侧栏标签
+//   就是这么读 cwd 的(ui-sidebar-files 的 FilesBody:`useSessions(s => s.byId[sessionId]?.cwd)`);
+//   快照形状 `{ ids, byId, phase, subagentsByParent, jobsBySession }`,**选中的会话 id 不再挂在列表快照上**
+//   (`current` 那条兜底已随旧代清理删除 —— 它正是 0.3.46 那类"客户端不再发 cwd、IDE 以空工作区启动"的根源)。
+//   取 cwd 的顺序:会话 cwd → 工作区表里含该会话的工作区 → 最近活跃会话的工作区 → 工作区表第一个。
 //
 // 全部输入都是"可能不存在"的:拿不到就返回 undefined,调用方不传 cwd(/start 不带 cwd = 保留当前
 // 目录),**绝不猜一个目录** —— 猜错会把 IDE 开到别人的工作区里。
@@ -193,37 +184,21 @@ function pickWorkspaceCwd(input) {
   var workspaces = opts.workspaces == null ? null : opts.workspaces
   var sessionId = typeof opts.sessionId === 'string' && opts.sessionId !== '' ? opts.sessionId : undefined
 
-  // 1) 会话自带的 cwd(新 DSH:标准 prop 给 sessionId;两条版本都吃这一条)
+  // 1) 会话自带的 cwd(标准 prop `sessionId` → 会话行上的 cwd)
   var fromSession = cwdOf(sessions, sessionId)
   if (fromSession !== undefined) return fromSession
 
-  // 2) 旧版 DSH:列表快照上的 current
-  var legacyCurrent = sessions == null ? undefined : sessions.current
-  var fromLegacy = cwdOf(sessions, legacyCurrent)
-  if (fromLegacy !== undefined) return fromLegacy
-
-  // 3) 工作区表:该会话所属的工作区
+  // 2) 工作区表:该会话所属的工作区
   var fromWorkspace = pathHoldingSession(workspaces, sessionId)
   if (fromWorkspace !== undefined) return fromWorkspace
-  var fromLegacyWorkspace = pathHoldingSession(workspaces, typeof legacyCurrent === 'string' ? legacyCurrent : undefined)
-  if (fromLegacyWorkspace !== undefined) return fromLegacyWorkspace
 
-  // 4) 根作用域(后台预热)没有 sessionId:退到"最近活跃的那个会话"所属的工作区。
+  // 3) 根作用域(后台预热)没有 sessionId:退到"最近活跃的那个会话"所属的工作区。
   //    host 的会话列表按活跃度排序(list() 文档:ordered by activity),所以 ids[0] 就是它。
   var recent = sessions != null && Array.isArray(sessions.ids) ? sessions.ids[0] : undefined
   var fromRecent = pathHoldingSession(workspaces, typeof recent === 'string' ? recent : undefined)
   if (fromRecent !== undefined) return fromRecent
 
-  // 5) 旧字段兼容(recentWorkspaceId 在现版 WorkspaceSnapshot 里已不存在,留着不害事)
-  if (workspaces != null && Array.isArray(workspaces.items) && workspaces.recentWorkspaceId !== undefined) {
-    for (var j = 0; j < workspaces.items.length; j += 1) {
-      var item = workspaces.items[j]
-      if (item == null || item.workspaceId !== workspaces.recentWorkspaceId) continue
-      if (typeof item.path === 'string' && item.path !== '') return item.path
-    }
-  }
-
-  // 6) 最后兜底:工作区表的第一个(hook 拿不到选中态时的既有行为)
+  // 4) 最后兜底:工作区表的第一个(hook 拿不到选中态时的既有行为)
   if (workspaces != null && Array.isArray(workspaces.items) && workspaces.items.length > 0) {
     var first = workspaces.items[0]
     if (first != null && typeof first.path === 'string' && first.path !== '') return first.path
@@ -254,12 +229,27 @@ const supportsMoveBefore = typeof Element !== 'undefined'
 
 var PARK_OFFSCREEN_LEFT = -20000
 
+/** 停放超过这个时长,回归时直接重新加载同一 URL(而不是只补一次重绘)。
+ *  依据:2026-10-01 的 desktop 实例 —— 面被停放到离屏后,里面那条到 IDE 的 WebSocket
+ *  22.8 小时零收包、1952 条消息无 ack,`nudgeRepaint()` 只能修合成、救不回半死连接。
+ *  10 分钟的取值:短于它的来回切换(最常见的"看一眼别的标签")仍然零重载,保持本插件的承诺。 */
+var PARKED_RELOAD_MS = 10 * 60 * 1000
+
+/** 桌面载体(Electron / DSH desktop):离屏 iframe 在这里会被更激进地挂起,
+ *  预热很可能换来一个"一出生就冻死"的会话 ⇒ 桌面下不预热到离屏。 */
+function desktopCarrier() {
+  if (typeof globalThis !== 'undefined' && globalThis.dshDesktop != null) return true
+  return typeof navigator !== 'undefined' && /Electron/i.test(navigator.userAgent)
+}
+
 var surfaceState = {
   park: null,
   frame: null,
   currentSrc: null,
   sameOrigin: null,
   owner: null,
+  /** 最后一次停放的时刻(ms):停放期间 iframe 可能被挂起,回归时据此决定要不要重新加载。 */
+  parkedAt: null,
   /** 最后一次有效停靠尺寸:停放时沿用它,避免 VS Code 触发 0×0 重排。 */
   lastRect: null,
   /** 'offscreen'(默认,省 CPU)| 'behind'(停在原位、压在面板下,规避不可见 iframe 节流)。 */
@@ -283,6 +273,7 @@ function snapshot() {
     parkStrategy: surfaceState.parkStrategy,
     degraded: surfaceState.degraded,
     preloaded: surfaceState.preloaded,
+    parkedAt: surfaceState.parkedAt,
     supportsMoveBefore: supportsMoveBefore,
     nudgeCount: surfaceState.nudgeCount,
     lastNudgeAt: surfaceState.lastNudgeAt,
@@ -459,8 +450,17 @@ function dockInto(host, owner) {
   markDocked()
   surfaceState.park.setAttribute('aria-hidden', 'true')
   moveInto(host)
-  // 从停放回到停靠:补一次重绘唤醒(见文件头"另一个实测坑")。
-  if (wasParked) nudgeRepaint()
+  var parkedFor = wasParked && typeof surfaceState.parkedAt === 'number' ? Date.now() - surfaceState.parkedAt : 0
+  surfaceState.parkedAt = null
+  if (parkedFor > PARKED_RELOAD_MS) {
+    // 停放太久:补重绘救不回被挂起的那条连接(见 PARKED_RELOAD_MS 的注释),只能重新导航同一 URL,
+    // 让 workbench 重新握手 + 从服务端恢复状态(IDE 进程本身没重启,缓冲区/终端都还在)。
+    console.warn('[code-server] 常驻面停放 ' + Math.round(parkedFor / 1000) + 's 后回归:重新加载以免沿用半死的连接')
+    if (surfaceState.currentSrc !== null) surfaceState.frame.src = surfaceState.currentSrc
+  } else if (wasParked) {
+    // 从停放回到停靠:补一次重绘唤醒(见文件头"另一个实测坑")。
+    nudgeRepaint()
+  }
   notify()
 }
 
@@ -472,6 +472,7 @@ function parkSurface(owner) {
   applyParkStyle()
   markParked()
   surfaceState.park.setAttribute('aria-hidden', 'true')
+  surfaceState.parkedAt = Date.now()
   moveInto(surfaceState.park)
   notify()
 }
@@ -777,7 +778,7 @@ function intersects(list, group) {
 // 形态:window.__ModuleLoader__.load({id,factory}) 的经典脚本;factory 内静态 require('react')
 // (DSH 冻结模块表)。0.3.58 起**不再构建** —— 这个文件就是源码,改它即改客户端。
 //
-// 数据通道:同源 fetch DSH Connection 的共享 /api(status / start / stop / setup / open-file / ui-mode;
+// 数据通道:同源 fetch DSH Connection 的共享 /api(status / start / stop / open-file / ui-mode;
 // web 走 webServer 的 /api 前缀,desktop 走 IPC 帧管道 → 插件不依赖 webServer)。
 //
 // UI 载体只有右侧栏标签(需要 sidebarRightTabs / sidebarRight 服务;rc 线与 alpha 线都有):
@@ -857,6 +858,10 @@ let React = require('react')
       if (status == null || typeof status.url !== 'string' || status.url === '') return null
       var tag = status.pid != null ? String(status.pid) : (status.startedAt != null ? String(status.startedAt) : '0')
       var url = status.url + '?s=' + encodeURIComponent(tag)
+      // 版本标记:插件版本或 VS Code 树变了 ⇒ URL 变 ⇒ 常驻 iframe 自动换页。
+      // 只靠 `s=<pid>` 挡不住"升级后 IDE 进程被 adopt(pid 不变)而页面还是旧的"这种情况
+      // (2026-10-01:面里跑着 0.3.68 + 4.138 的页面,endpoint.json 已是 4.139.1)。
+      if (typeof status.htmlTag === 'string' && status.htmlTag !== '') url += '&v=' + encodeURIComponent(status.htmlTag)
       var dir = typeof cwd === 'string' && cwd !== '' ? cwd : (status != null && status.cwd != null ? status.cwd : null)
       if (dir == null || dir === '') return url
       var normalized = dir.replace(/\\/g, '/')
@@ -875,6 +880,8 @@ let React = require('react')
       var pageUrl = props.pageUrl
       var reloadTick = props.reloadTick
       var owner = props.owner
+      /** 本 body 是否"活跃"(缺省 true = 旧形状:没有可见性信号时按老行为停靠)。 */
+      var active = props.active !== false
       var hostRef = React.useRef(null)
       var running = status != null && status.ok === true && status.running === true
       var starting = status != null && status.status === 'starting'
@@ -891,8 +898,14 @@ let React = require('react')
           return
         }
         ensureSurface({ src: pageUrl, sameOrigin: sameOrigin })
+        // 后台保留的 body 不许持有面(会抢空可见面板);它只把面**留在停放区**,
+        // 等自己变活跃时这一次 effect 会因 active 变化重跑并停靠。
+        if (active !== true) {
+          parkSurface(owner)
+          return
+        }
         if (hostRef.current !== null) dockInto(hostRef.current, owner)
-      }, [running, pageUrl, sameOrigin, reloadTick, owner])
+      }, [running, pageUrl, sameOrigin, reloadTick, owner, active])
 
       // 停放必须用 **layout** cleanup:React 在提交阶段先跑 layout effect 销毁、再摘除 DOM,
       // 此时 iframe 仍连着文档 → moveBefore 成功(状态保持);若放到 passive cleanup,
@@ -948,6 +961,9 @@ let React = require('react')
       var url = running ? buildPageUrl(status, cwd) : null
       React.useEffect(function () {
         if (!keep || !running || url === null) return
+        // 桌面载体上不用"离屏预热":Electron 会挂起离屏 iframe,预热等于提前造一个冻死的会话
+        // (2026-10-01 实测)。首次点开时 body 会正常加载并停靠,代价只是首次多等一次加载。
+        if (desktopCarrier()) return
         preloadSurface({ src: url, sameOrigin: status != null && status.serve === 'dsh' })
       }, [keep, running, url, status != null ? status.serve : null])
       return null
@@ -980,9 +996,9 @@ let React = require('react')
     // 服务始终不就绪(旧版 DSH)→ 判定 legacy:只留设置页提示(见 internalApply)。
     var CS_KIND = 'code-server'
     var CS_TAB_ID = 'dsh-code-server-app'
-    /** **profile 条目 id**(cordis.patch.yml 的 `- id: code-server`)。新通道里它同时是**设置命名空间**:
+    /** **profile 条目 id**(cordis.patch.yml 的 `- id: code-server`)。它同时是**设置命名空间**:
      *  `ctx.configForms.get(ENTRY_ID)` 按条目 id 取表单,`whileServed([ENTRY_ID])` 按它判断
-     *  "宿主是否正在服务这个条目的配置"。必须与宿主 lib/index.js 的 SETTINGS_NS、行 id 三者一致。 */
+     *  "宿主是否正在服务这个条目的配置"。必须与宿主 `lib/index.js` 导出的 `name` 以及行 id 三者一致。 */
     var CS_ENTRY_ID = 'code-server'
     /** 本插件的**包名**,同时是客户端 bundle 的 loader id(banner 里 `load({id})` 那一个)。
      *  插件页按包名派发配置区(`renderSlot('plugins.bundle.config', …, { entryKey: pkg.name })`),
@@ -1111,6 +1127,15 @@ let React = require('react')
       var rootRef = React.useRef(null)
       var forcedFullscreenRef = React.useRef(false)
       var visible = info.tab != null && info.tab.visible === true
+      // **停靠仲裁(2026-10-01,回归修复)**:宿主会**同时保留多个** body —— 0.2 的 `keepMounted`
+      // 让每个打开过本标签的 Session 的正文都留在树里(后台的也在)。而 iframe 只有一个:
+      // 谁最后 `dockInto` 谁赢,于是后台那个保留 body 一重渲染就把可见面板里的面**抢空**(现象:
+      // 切换标签/工作区回来一片空)。所以只有"活跃"的 body 才许持有面:
+      //   · 优先用 0.2 的 `useTabInfo().active`(官方 TabSlot 给的"本标签是否活跃");
+      //   · 退到记录上的 `visible`(老形状);
+      //   · 两个信号都没有(更老的壳层)⇒ 按"活跃"处理,保持以前的行为不变。
+      var hasActiveSignal = info.active !== undefined || (info.tab != null && info.tab.visible !== undefined)
+      var active = hasActiveSignal ? (info.active === true || visible === true) : true
       var fullscreen = info.sidebar != null && info.sidebar.fullscreen === true
       // 单标签页(0.3.57):登记自己的"座位"(能关掉自己的那个函数 + 所在窗格),
       // 并在**首次可见**时把同窗格里的旧 code-server 标签页收掉 —— 见 closeSiblingTabs 的注释。
@@ -1191,6 +1216,7 @@ let React = require('react')
       return React.createElement('div', { className: 'dshcs-tabroot', 'data-code-server-tab': 'body', ref: rootRef },
         React.createElement(CodeServerSurface, {
           status: status, pageUrl: buildPageUrl(status, cwd), reloadTick: tick, owner: 'tab:' + tab.id,
+          active: active,
         })
       )
     }
@@ -1231,6 +1257,12 @@ let React = require('react')
           // 第三方 openResource(fileAddress) 都会落到本 tab。含 `:` 的 pattern 按整址 glob 匹配。
           patterns: ['dsh-resource://file/**'],
           canOpen: function (a) { return claimsAddress(parseFileAddress(a), claimPolicy()) },
+          // **宿主级保活(DSH 0.2 起的契约)**:声明后,已访问过的正文在**切 tab / 切 Session / 收起 /
+          // 停靠与浮窗切换**期间由右侧栏自己保留(`TabSlot` 看到 `keepMounted === true` 就 `retainTab`),
+          // 不必再靠本插件把 iframe 搬进离屏 park 来硬扛 —— 那正是 2026-10-01 那次故障的来源:
+          // 离屏 iframe 被挂起,里面到 IDE 的 WebSocket 静默半开(22.8 小时零收包、1952 条消息无 ack),
+          // 界面"活着但不会动"。旧壳层不认识这个字段,直接忽略 ⇒ 无需能力探测。
+          keepMounted: true,
           // 文件 tab 用文件名当 chip 文本;页面 tab(openTab/openResource 指定 kind)仍是产品名
           title: function (a) {
             if (isPageAddress(a) || a === undefined || a === null || a === '') return 'Code Server'
@@ -1268,26 +1300,18 @@ let React = require('react')
     }
 
     // ---------- 设置(参照 auto-open-web 的自绘卡片模式) ----------
-    // **座位**与**数据通道**是两条独立的轴,而且分界点不在同一版(2026-09-22 之后的实测更正):
-    //
-    //   座位(声明驱动:`slots.inject` 只在插槽真被声明时才回调,所以两条腿都注册、谁在谁生效):
-    //     · `plugins.bundle.config`(alpha 线 ≥ 0.1.6-alpha.2,含最新 0.1.7-alpha.1):插件页按**包名**派发的配置区,
-    //       页面自带标题/面包屑,我们只出表单 + 保存控件(seat='bundle-config');
-    //     · `settings.plugin.item`(rc 线 ≤ 0.1.5-rc.3,最新 rc 仍在用):设置页里自绘的可折叠卡片(alpha 线已退役)。
+    // 座位(声明驱动:`slots.inject` 只在插槽真被声明时才回调)只有 `plugins.bundle.config` 一条:
+    // 插件页按**包名**派发配置区,页面自带标题/面包屑,我们只出表单 + 保存控件(seat='bundle-config')。
+    // 旧座位 `settings.plugin.item`(设置页里的自绘卡片)已随旧代清理删除。
     //
-    //   数据通道(能力探测:`configForms` 在就用新通道,否则回退 `settingsScope`):
-    //     · 新通道 `ctx.configForms.get(ENTRY_ID)`(alpha 线 ≥ 0.1.7-alpha.1):`settingsScope` 已被删除,
-    //       配置就是**插件条目自己的 Config**(宿主半的字段 `.volatile()`)。表单模型:
-    //       `getSnapshot()` → { status, writable, revision, value, base, user }、`subscribe(cb)`、
-    //       **唯一写路径** `mutate(ops, revision)`(原子、带 revision 栅栏)、`dispose()`;
-    //       注册还要经 `whileServed([ENTRY_ID], …)` 门禁(宿主只有在服务该条目配置时才让我们注册页面)。
-    //     · 旧通道 `ctx.settingsScope.bind({ namespace })`(rc 0.1.5-rc.x;**也含 0.1.6-alpha.2** ——
-    //       那一版座位已经搬到插件页、数据面却还是旧的):卡片直接读写 settings 命名空间。
+    // 数据通道(能力探测)只有 `ctx.configForms.get(ENTRY_ID)` 一条:配置就是**插件条目自己的 Config**
+    // (宿主半的字段 `.volatile()`)。表单模型:`getSnapshot()` → { status, writable, revision, value, base, user }、
+    // `subscribe(cb)`、**唯一写路径** `mutate(ops, revision)`(原子、带 revision 栅栏)、`dispose()`;
+    // 注册还要经 `whileServed([ENTRY_ID], …)` 门禁(宿主只有在服务该条目配置时才让我们注册页面)。
+    // 旧通道 `ctx.settingsScope.bind({ namespace })` 同样已删除(旧代专属)。
     //
-    // 组合起来三种真实形态都要成立:
-    //   ① {旧座位, 旧通道} = rc 线;② {新座位, 旧通道} = 0.1.6-alpha.2;③ {新座位, 新通道} = 0.1.7-alpha.1+。
-    // 这也是为什么 `inject` 只留**必然存在**的 `slots`,两个通道都运行时探测:
-    // 把 `settingsScope` 写进 inject 会让整个客户端条目在 0.1.7-alpha.1 上永远 pending
+    // 这也是为什么 `inject` 只留**必然存在**的 `slots`,`configForms` 一律运行时探测:
+    // 把它写进 inject 会让整个客户端条目在没有该服务的宿主上永远 pending
     // (表现是右侧栏标签、设置卡、常驻预热**全都不存在**,而且只有一条 "1 entry did not activate")。
     var CARD_CSS =
       '.dshcs-card{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);border-radius:12px;list-style:none;transition:border-color .16s,background .16s}' +
@@ -1685,7 +1709,7 @@ let React = require('react')
     var CS_LEGACY_LEAD = '本插件自 0.2.3 起不再兼容旧版 DSH。'
     var CS_LEGACY_BODY = '未检测到右侧栏插件服务 sidebarRightTabs / sidebarRight,因此插件不提供任何入口'
       + '(旧版的悬浮球与浮动窗口已移除),也不会后台启动 IDE。'
-      + '\n升级 DSH 到 rc 线(0.1.5-rc.x)或 0.1.6-alpha.2 起的 alpha 线后,Code Server 会出现在右侧栏标签里,'
+      + '\n升级 DSH 到 0.2.0-rc.2 及以上后,Code Server 会出现在右侧栏标签里,'
       + '本页同时显示完整设置项;升级后无需重装本插件,刷新页面即可。'
 
     /** 保存/恢复成功后,把 host 最新 status 推给模块共享 store → 常驻预热等立即按新设置生效。 */
@@ -1953,177 +1977,6 @@ let React = require('react')
       return csConfigPage(view, handlers, csSettingsFields(view, handlers, { surfaceHint: csSurfaceHintText(surfaceState) }))
     }
 
-    /** 设置卡片页面:useState+useEffect 订阅 settingsScope(不投机 useSyncExternalStore
-     *  对 snapshot 引用稳定性的要求;不建中间 store)。 */
-    function csSettingsPage(props) {
-      try {
-        var scope = props.scope
-        var [snapshot, setSnapshot] = React.useState(function () { return scope !== undefined ? scope.getSnapshot() : null })
-        var [draft, setDraft] = React.useState(null) // null | { keepResident, fileOpenScope }(未保存草稿)
-        var [saving, setSaving] = React.useState(false)
-        var [failed, setFailed] = React.useState(false)
-        // 共享 store:读取当前 UI 载体状态(右侧栏是否就绪 / 是否旧版 DSH),必须放在所有提前 return 之前
-        var liveStore = useStore()
-        // 常驻面实时状态(停靠/停放/降级):卡片里显示,便于判断"切标签是否还会重载"
-        var [surfaceState, setSurfaceState] = React.useState(surfaceSnapshot())
-        React.useEffect(function () {
-          return subscribeSurface(function (snap) { setSurfaceState(snap) })
-        }, [])
-        React.useEffect(function () {
-          if (scope === undefined || typeof scope.subscribe !== 'function') return
-          function onUpdate() {
-            try { setSnapshot(scope.getSnapshot()) } catch (e) { /* ignore */ }
-          }
-          var dispose = scope.subscribe(onUpdate)
-          return function () { if (typeof dispose === 'function') dispose() }
-        }, [scope])
-        if (scope === undefined) {
-          console.error('[code-server] card scope missing')
-          return null
-        }
-        if (snapshot === null || snapshot === undefined || snapshot.status !== 'ready') {
-          // 尚未就绪(连接/镜像加载中):静默留空,官方插槽边界接管;不显示占位
-          if (snapshot !== null && snapshot !== undefined && snapshot.status === 'unavailable') {
-            console.warn('[code-server] settings scope unavailable:', snapshot.status)
-          }
-          return null
-        }
-      var value = snapshot.value !== undefined && snapshot.value !== null ? snapshot.value : {}
-      var user = snapshot.user
-      // 当前生效值(每个字段的兜底与宿主 schema 默认值同源,见 CS_FIELDS.read)。
-      var loaded = {}
-      CS_FIELDS.forEach(function (spec) { loaded[spec.field] = spec.read(value) })
-      // ---- 旧版 DSH(无右侧栏服务):本页是唯一的提示出口,不显示任何设置项 ----
-      if (liveStore != null && liveStore.sidebarUi === 'legacy') {
-        return csLegacyNotice('card')
-      }
-      // 归一化视图:新通道那份由 configForms 的投影直接给出(形状与此完全相同)⇒ 表单主体只认这一层。
-      var view = {
-        available: true,
-        writable: snapshot.writable === true,
-        values: {},
-        overridden: {},
-      }
-      CS_FIELDS.forEach(function (spec) {
-        view.values[spec.field] = draft !== null ? draft[spec.field] : loaded[spec.field]
-        view.overridden[spec.field] = csOverridden(user, spec.field)
-      })
-      view.dirty = draft !== null && CS_FIELDS.some(function (spec) {
-        return !spec.same(spec.parse(spec.display(view.values[spec.field])), loaded[spec.field])
-      })
-      view.invalid = false
-      view.saving = saving
-      view.failed = failed
-      var saveDisabled = view.dirty !== true || saving
-      var state = {
-        available: true,
-        writable: view.writable,
-        dirty: view.dirty,
-        invalid: view.invalid,
-        saving: view.saving,
-        failed: view.failed,
-      }
-      // 保存/恢复成功后,把 host 最新 status 推给模块共享 store → 常驻预热等立即按新设置生效。
-      async function doSave() {
-        if (view.dirty && !saving) {
-          setSaving(true); setFailed(false)
-          try {
-            var d = draft !== null ? draft : loaded
-            await props.scope.set('keepResident', d.keepResident === true)
-            await props.scope.set('claimExtensions', normalizeClaimExtensions(d.claimExtensions))
-            await props.scope.set('fullscreenOnOpen', d.fullscreenOnOpen === true)
-            await props.scope.set('fim', d.fim === true)
-            await props.scope.set('fimDebounceMs', normalizeFimDebounce(d.fimDebounceMs))
-            await props.scope.set('fimMultiline', d.fimMultiline === true)
-            await props.scope.set('fimDisableGlobs', typeof d.fimDisableGlobs === 'string' ? d.fimDisableGlobs : '')
-            setDraft(null)
-            csSyncStatusToStore()
-          } catch (e) {
-            setFailed(true)
-          }
-          setSaving(false)
-        }
-      }
-      async function doReset() {
-        if (saving || snapshot.writable !== true) return
-        setSaving(true); setFailed(false)
-        try {
-          // unset 清除 user 覆盖层 → 回到 base 默认值;成功后镜像同步
-          if (typeof props.scope.unset === 'function') {
-            await props.scope.unset('keepResident')
-            await props.scope.unset('claimExtensions')
-            await props.scope.unset('fullscreenOnOpen')
-            await props.scope.unset('fim')
-            await props.scope.unset('fimDebounceMs')
-            await props.scope.unset('fimMultiline')
-            await props.scope.unset('fimDisableGlobs')
-          } else {
-            await props.scope.set('keepResident', value.keepResident === undefined || value.keepResident === null ? true : value.keepResident)
-            await props.scope.set('claimExtensions', typeof value.claimExtensions === 'string' ? normalizeClaimExtensions(value.claimExtensions) : DEFAULT_CLAIM_EXTENSIONS)
-            await props.scope.set('fullscreenOnOpen', value.fullscreenOnOpen === undefined || value.fullscreenOnOpen === null ? true : value.fullscreenOnOpen)
-            await props.scope.set('fim', value.fim === true)
-            await props.scope.set('fimDebounceMs', normalizeFimDebounce(value.fimDebounceMs))
-            await props.scope.set('fimMultiline', value.fimMultiline !== false)
-            await props.scope.set('fimDisableGlobs', typeof value.fimDisableGlobs === 'string' ? value.fimDisableGlobs : '')
-          }
-          setDraft(null)
-          csSyncStatusToStore()
-        } catch (e) {
-          setFailed(true)
-        }
-        setSaving(false)
-      }
-      /** 旧通道的处理器:草稿仍在组件里(旧通道没有 mutate,只能逐字段 set/unset)。 */
-      var handlers = {
-        onEdit: function (field, next) {
-          setDraft(function (prev) {
-            var base = Object.assign({}, prev !== null ? prev : loaded)
-            base[field] = next
-            return base
-          })
-          setFailed(false)
-        },
-        // 旧通道的"恢复默认"是**整份** unset(0.3.x 起的行为);新通道按官方契约是逐字段 unset。
-        onResetField: function () { doReset() },
-        onSave: function () { doSave() },
-        onDiscard: function () { setDraft(null); setFailed(false) },
-      }
-      var fields = csSettingsFields(view, handlers, { surfaceHint: csSurfaceHintText(surfaceState) })
-      // ---- 插件页的配置区(alpha 线 ≥ 0.1.6-alpha.2):页面自己画标题/图标/面包屑,
-      //      把 `plugins.bundle.config`(按包名为键)渲染在描述与行之间,只问 `view: 'page'`;
-      //      所以这里不再套可折叠卡片(标题会与页面标题重复),只出表单 + 自己的保存控件。
-      //      注意:0.1.6-alpha.2 的**座位**已是这一条,而**数据通道**还是旧的 settingsScope ⇒
-      //      同一个 seat 必须两种通道都答得起(新通道那份见 ConfigFormsEntry)。
-      if (props.seat === 'bundle-config') {
-        return csConfigPage(view, handlers, fields)
-      }
-      return React.createElement(csCard, {
-        title: CS_LEGACY_TITLE,
-        description: '入口:右侧栏标签(需 DSH 带 sidebarRight/sidebarRightTabs,即 rc 线或 0.1.6-alpha.2 起的 alpha 线);认领类型决定哪些文件交给 Code Server 打开',
-        state: state,
-        unsavedLabel: CS_UNSAVED_LABEL, readOnlyLabel: CS_READONLY_LABEL,
-        saveFailedLabel: CS_SAVE_FAILED_LABEL,
-        discardLabel: CS_DISCARD_LABEL, saveLabel: CS_SAVE_LABEL, savingLabel: CS_SAVING_LABEL,
-        onSave: handlers.onSave, onDiscard: handlers.onDiscard,
-      }, ...fields)
-      } catch (e) {
-        // 渲染异常:记日志不打断;官方插槽对异常有边界,卡片留空即可
-        console.error('[code-server] card render error:', e !== null && e !== undefined && e.message !== undefined ? e.message : String(e))
-        return null
-      }
-    }
-
-    /** 插件页配置区的入口组件(**旧通道**;0.3.50 起)。
-     *  用它的场合:座位是 `plugins.bundle.config` 但数据面还是 `settingsScope` —— 也就是
-     *  rc 线之外**还包括 0.1.6-alpha.2**(那一版座位已搬、通道未换)。新通道见 ConfigFormsEntry。
-     *  上游契约:同一个 entry 会被要两种视图 —— `summary`(标题下的一句话)与 `page`(表单,
-     *  自带保存控件)。插件页对 `plugins.bundle.config` 只用 `page`,但两种都答得起才算合格。
-     *  本组件自身不调 hook(两个分支都不调),真正的设置表单在 csSettingsPage 里(独立组件边界)。 */
-    function BundleConfigEntry(props) {
-      if (props != null && props.view === 'summary') return CS_CONFIG_SUMMARY
-      return React.createElement(csSettingsPage, Object.assign({}, props, { seat: 'bundle-config' }))
-    }
-
     // ---------- 「问 DSH」对话框(0.3.24;0.3.59 起面板本体就是这份源码)----------
     // 对话**不在编辑器的侧栏/tab 里**,而是作为一个浮在 DSH 页面上的对话框(用户的原话:
     // "对话不要用侧边栏,还是改成对话框形式")。这里就是那个对话框:**外壳**(标题栏 / 拖动 / 关闭)
@@ -3202,14 +3055,14 @@ let React = require('react')
         setState({ status: s })
       }).catch(function () { /* 首次失败由后续轮询补救 */ })
 
-      // ---- 设置:两个**座位** × 两条**数据通道**(见本段开头的说明) ----
-      // 通道用能力探测,座位用声明驱动:`slots.inject` 只在插槽真被声明时才回调 ⇒ 两条腿都注册。
-      // 探测只经 `ctx.get`:这两个服务**不能**写进静态 inject(写进去会让另一条线上的条目永远 pending),
-      // 而未声明的服务在 DSH 里**属性访问会抛** —— 所以这里绝不用 ctx.configForms / ctx.settingsScope。
+      // ---- 设置:单一座位 `plugins.bundle.config`(DSH 0.2 起;旧座位 `settings.plugin.item` 与旧通道
+      //      `settingsScope` 已随老版本线一并删除 —— 两套 UI(web/desktop)现在都是 0.2 这一代) ----
+      // 通道用能力探测:`configForms` 在就用它;没有(宿主没服务本条目)就只打日志、不注册页面。
+      // 探测只经 `ctx.get`:`configForms` **不能**写进静态 inject(会让没有这个服务的宿主上整条目永远 pending),
+      // 而未声明服务的属性访问在 DSH 里会抛 —— 所以这里绝不用 ctx.configForms。
       var formsSvc = ctx.get('configForms')
-      var scope = null
       if (formsSvc !== undefined && formsSvc !== null && typeof formsSvc.get === 'function') {
-        // ① 新通道(alpha 线 ≥ 0.1.7-alpha.1):配置是本条目自己的 volatile Config。
+        // 配置就是本条目自己的 volatile Config。
         var form = formsSvc.get(CS_ENTRY_ID)
         var controller = csConfigFormController(form)
         var face = null
@@ -3217,7 +3070,7 @@ let React = require('react')
         if (store !== null) {
           face = Object.assign({ hooks: { codeServerForm: store } }, controller.actions())
         } else {
-          console.warn('[code-server] 快照 store 不可用:配置区退回旧通道(没有就只剩提示)')
+          console.error('[code-server] 快照 store 不可用:配置区不注册(表单无法读写)')
         }
         // 表单订阅属于本 fiber:插件卸载/热重载时释放,避免监听泄漏到服务缓存的表单上。
         ctx.effect(function () { return function () { controller.dispose() } }, 'code-server: config form subscription')
@@ -3237,30 +3090,7 @@ let React = require('react')
           console.log('[code-server] client config page registered: plugins.bundle.config[' + PKG_NAME + '] via configForms')
         }
       } else {
-        // ② 旧通道(rc 0.1.5-rc.x;**也含 0.1.6-alpha.2** —— 那一版座位已搬到插件页,数据面还是旧的)。
-        var settingsScope = ctx.get('settingsScope')
-        if (settingsScope !== undefined && settingsScope !== null && typeof settingsScope.bind === 'function') {
-          scope = settingsScope.bind({ namespace: CS_ENTRY_ID })
-        }
-        if (scope === null) {
-          console.error('[code-server] 没有可用的配置数据通道(configForms / settingsScope 都不可见):配置区不注册')
-        }
-        if (scope !== null) {
-          // ②-a 插件页的配置区(alpha 线 ≥ 0.1.6-alpha.2):`settings.plugin.item` 退役,上游把插件配置搬到
-          //     插件页 —— 键是**包名**(页面按 `pkg.name` 派发),只问 `view: 'page'`。插件页只在
-          //     `ledger.bundles.has(包名)` 时才渲染那一块,所以键写错就等于"设置又不见了"。
-          //     0.1.6-alpha.2 用的就是这一条(座位新、通道旧)。
-          slots.inject('plugins.bundle.config', () => slots.register(
-            { name: 'plugins.bundle.config', key: PKG_NAME, inject: function () { return { scope: scope } } },
-            BundleConfigEntry
-          ))
-          // ②-b 设置页里的插件卡片(rc 线 ≤ 0.1.5-rc.3,最新 rc 仍在用;也是没有右侧栏服务的旧 DSH 里唯一的提示出口)。
-          //     `slots.inject` 只在插槽真被声明时才回调 ⇒ 新 DSH 上这一条自然不生效。
-          slots.inject('settings.plugin.item', () => slots.register(
-            { name: 'settings.plugin.item', key: CS_ENTRY_ID, label: 'Code Server', inject: function () { return { scope: scope } } },
-            csSettingsPage
-          ))
-        }
+        console.error('[code-server] configForms 不可见(宿主没在服务本条目配置):配置区不注册')
       }
 
       // ---- 能力探测:只有带右侧栏服务(sidebarRightTabs/sidebarRight;rc 线与 alpha 线都有)才注册可用 UI;探测不到就只留设置页提示 ----
@@ -3354,9 +3184,9 @@ let React = require('react')
       }, LEGACY_REPORT_MS)
     }
 
-    // 静态 inject 只列**两条线都必然存在**的服务。`configForms` / `settingsScope` 都是
-    // **运行时探测**的:把它们写进 inject,客户端条目会在没有那个服务的 DSH 上永远 pending
-    // (0.1.7-alpha.1 上 `settingsScope` 已被删除 ⇒ 整个条目不激活、右侧栏与设置一起消失)。
+    // 静态 inject 只列**必然存在**的服务。`configForms`(设置通道)是**运行时探测**的:
+    // 把它写进 inject,客户端条目会在没有那个服务的宿主上永远 pending ——
+    // 表现是右侧栏标签、设置卡、常驻预热**一起消失**,日志里只有一句 "1 entry did not activate"。
     const inject = ['slots']
     const name = 'code-server'