dsh-code-server-app 0.3.63 → 0.3.66

package/lib/client.js

@@ -8,12 +8,29 @@
  *
  * 硬性约束(改动前先读;有 scripts/test-client-entry.mjs 守着):
  *   ① 顶层不许出现 import / export / await —— 经典脚本里它们是语法错误;
- *   ② require(...) 的实参只允许 'react' 与 'react/jsx-runtime'(DSH 冻结模块表);
+ *   ② require(...) 的实参只允许壳层冻结模块表里的名字('react' / 'react/jsx-runtime' /
+ *      'react-dom/client' / '@deepseek-ai/dsh-client-ui-primitives' / '@deepseek-ai/dsh-client-store';
+ *      test-client-entry.mjs 的白名单与之一致);
  *   ③ 必须保留 window.__ModuleLoader__.load({id, factory}) 这层包装与 module.exports 的
  *      { apply, inject, name } 形状(app/inject/name 的定义在文件末尾的"插件主体"段);
  *   ④ 各段落原来的顶层标识符现在共享同一作用域 —— 新增顶层名字时先搜一遍别撞名
  *      (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 上永远 pending(表现是侧栏标签/设置/预热**一起消失**)。
+ *   更早的 alpha(0.1.5-alpha.x、0.1.6-alpha.1)形状与 rc 线相同 —— 代码天然走得通,但**不作为目标**,
+ *   也不为它们写任何专门分支。本文件里凡出现"哪一版"的说法,都按这两条线命名。
+ *
  * 段落(按依赖顺序):地址语法 → 工作区解析 → 常驻面 → 全屏动作 → 认领类型(与 lib/claim-types.js
  * 同源的一致性副本)→ 插件主体。
  */
@@ -126,9 +143,9 @@ function resolveFilePath(parsed, cwd) {
 // —— 解析"当前工作区目录"(决定 workbench 用哪个 `?folder=` 打开)
 //
 // 为什么单独成模块:这段逻辑的真实输入是 **DSH 客户端 store 的形状**,而它随 DSH 版本变过 ——
-//   · DSH ≤ 0.1.6-alpha.1:`SessionListState` 带 `current`(选中的会话 id 就挂在会话列表快照上,
+//   · rc 线(≤ 0.1.5-rc.3,最新 rc 仍是这样):`SessionListState` 带 `current`(选中的会话 id 挂在快照上,
 //     老写法 `useSessions(s => s).current` 即"当前会话");
-//   · DSH ≥ 0.1.6-alpha.2:`current` 被移出列表 store(上游 refactor 的注释:view selection remains
+//   · 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)`)。
@@ -149,7 +166,7 @@ function cwdOf(sessions, sessionId) {
   return typeof row.cwd === 'string' && row.cwd !== '' ? row.cwd : undefined
 }
 
-/** 工作区表里"包含该会话"的那个工作区的路径(DSH ≤ 0.1.6-alpha.1 的 currentAddress 语义由它兜底)。 */
+/** 工作区表里"包含该会话"的那个工作区的路径(rc 线的 currentAddress 语义由它兜底)。 */
 function pathHoldingSession(workspaces, sessionId) {
   if (workspaces == null || !Array.isArray(workspaces.items)) return undefined
   if (typeof sessionId !== 'string' || sessionId === '') return undefined
@@ -763,7 +780,7 @@ function intersects(list, group) {
 // 数据通道:同源 fetch DSH Connection 的共享 /api(status / start / stop / setup / open-file / ui-mode;
 // web 走 webServer 的 /api 前缀,desktop 走 IPC 帧管道 → 插件不依赖 webServer)。
 //
-// UI 载体只有右侧栏标签(需要 sidebarRightTabs / sidebarRight 服务,DSH ≥ 0.1.5-alpha.1):
+// UI 载体只有右侧栏标签(需要 sidebarRightTabs / sidebarRight 服务;rc 线与 alpha 线都有):
 //   一段 ctx.sidebarRightTabs.register({ id, kind, priority, patterns, canOpen, title, guide })
 //     → guide 页入口框;并通过 patterns 认领 `dsh-resource://file/**` 文件地址,成为官方 openFile
 //       (产物 chip / "交付"卡片预览 / 正文提及)与任何 openResource(fileAddress) 的落点。
@@ -816,8 +833,8 @@ let React = require('react')
     }
 
     // ---------- 标准 prop 里的会话/工作区快照 ----------
-    // 取哪条路、退到哪条路**全在本文件的工作区解析段**(纯函数):DSH ≤ 0.1.6-alpha.1 的
-    // `SessionListState.current` 在 0.1.6-alpha.2 被移出列表 store,会话作用域插槽改用标准 prop
+    // 取哪条路、退到哪条路**全在本文件的工作区解析段**(纯函数):rc 线(≤ 0.1.5-rc.3)的
+    // `SessionListState.current` 在 alpha 线(≥ 0.1.6-alpha.2)被移出列表 store,会话作用域插槽改用标准 prop
     // `sessionId` 标识当前会话 —— 只认旧形状会让 cwd 静默变成 undefined(IDE 以空工作区启动)。
     /** 服务缺失时的占位选择器:**hook 调用次数必须恒定**(React 按位置对账),
      *  否则"服务晚到"的那一次渲染会抛 "Rendered more hooks than during the previous render"。 */
@@ -958,11 +975,15 @@ let React = require('react')
       document.head.appendChild(tag)
     }
 
-    // ---------- 右侧栏标签(DSH ≥ 0.1.5-alpha.1:ctx.sidebarRightTabs / ctx.sidebarRight) ----------
+    // ---------- 右侧栏标签(rc 线与 alpha 线都有:ctx.sidebarRightTabs / ctx.sidebarRight) ----------
     // 二段式注册:类型定义进 sidebarRightTabs,body 进 keyed 插槽 sidebar.right.pane.tab。
     // 服务始终不就绪(旧版 DSH)→ 判定 legacy:只留设置页提示(见 internalApply)。
     var CS_KIND = 'code-server'
     var CS_TAB_ID = 'dsh-code-server-app'
+    /** **profile 条目 id**(cordis.patch.yml 的 `- id: code-server`)。新通道里它同时是**设置命名空间**:
+     *  `ctx.configForms.get(ENTRY_ID)` 按条目 id 取表单,`whileServed([ENTRY_ID])` 按它判断
+     *  "宿主是否正在服务这个条目的配置"。必须与宿主 lib/index.js 的 SETTINGS_NS、行 id 三者一致。 */
+    var CS_ENTRY_ID = 'code-server'
     /** 本插件的**包名**,同时是客户端 bundle 的 loader id(banner 里 `load({id})` 那一个)。
      *  插件页按包名派发配置区(`renderSlot('plugins.bundle.config', …, { entryKey: pkg.name })`),
      *  所以这个键必须与安装进来的包名逐字相同 —— 0.3.50 起设置卡搬去插件页就是靠它认领。 */
@@ -1069,7 +1090,7 @@ let React = require('react')
       var navigation = tab.navigation
       var revision = navigation != null && typeof navigation.revision === 'number' ? navigation.revision : 0
       // 地址:文件 tab 可能来自会话树里的别的会话,故优先用地址里的 sessionId 对齐工作区;
-      // 页面 tab 用**会话作用域标准 prop** `sessionId`(DSH ≥ 0.1.6-alpha.2 的当前会话信源,
+      // 页面 tab 用**会话作用域标准 prop** `sessionId`(alpha 线 ≥ 0.1.6-alpha.2 的当前会话信源,
       // 老版的 `useSessions().current` 已被上游移除 —— 详见本文件的工作区解析段)。
       var address = navigation != null && typeof navigation.address === 'string' ? navigation.address : ''
       var parsed = isPageAddress(address) ? null : parseFileAddress(address)
@@ -1246,11 +1267,27 @@ let React = require('react')
     }
 
     // ---------- 设置(参照 auto-open-web 的自绘卡片模式) ----------
-    // 数据通道:settingsScope(官方 settings 域,命名空间 code-server)—— 两个座位共用。
-    // 座位(0.3.50 起两条腿都注册,谁被声明谁生效):
-    //   · `plugins.bundle.config`(DSH ≥ 0.1.6-alpha.2):插件页按**包名**派发的配置区,页面自带
-    //     标题/面包屑,我们只出表单 + 保存控件(seat='bundle-config');
-    //   · `settings.plugin.item`(DSH ≤ 0.1.6-alpha.1):设置页里自绘的可折叠卡片(已在新版退役)。
+    // **座位**与**数据通道**是两条独立的轴,而且分界点不在同一版(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 线已退役)。
+    //
+    //   数据通道(能力探测:`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 命名空间。
+    //
+    // 组合起来三种真实形态都要成立:
+    //   ① {旧座位, 旧通道} = rc 线;② {新座位, 旧通道} = 0.1.6-alpha.2;③ {新座位, 新通道} = 0.1.7-alpha.1+。
+    // 这也是为什么 `inject` 只留**必然存在**的 `slots`,两个通道都运行时探测:
+    // 把 `settingsScope` 写进 inject 会让整个客户端条目在 0.1.7-alpha.1 上永远 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}' +
       '.dshcs-card:hover{border-color:var(--dsw-alias-label-dimmed,var(--dsw-alias-border-l2))}' +
@@ -1408,177 +1445,305 @@ let React = require('react')
       )
     }
 
-    /** 设置卡片页面: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
+    // ---------- 字段规格 + 新通道的表单控制器(configForms;alpha 线 ≥ 0.1.7-alpha.1)----------
+    /**
+     * 表单字段规格表:**两条通道共用**的"怎么读当前值 / 怎么解析草稿 / 怎么比较"。
+     *
+     * 字段名与宿主 `Config`(lib/index.js 的 SETTING_FIELDS)一一对应 —— 少一个就是"设置里少一项",
+     * 多一个就是"宿主暴露了没人画的字段"。`read` 里的兜底值必须与宿主的 schema 默认值一致
+     * (claimExtensions 用本文件同源的 DEFAULT_CLAIM_EXTENSIONS,其余与 Config 的 default 对齐)。
+     */
+    var CS_FIELDS = [
+      {
+        field: 'claimExtensions', kind: 'text',
+        read: function (v) { return typeof v.claimExtensions === 'string' ? v.claimExtensions : DEFAULT_CLAIM_EXTENSIONS },
+        display: function (v) { return typeof v === 'string' ? v : '' },
+        parse: function (text) { return normalizeClaimExtensions(text) },
+        same: function (a, b) { return normalizeClaimExtensions(a) === normalizeClaimExtensions(b) },
+      },
+      {
+        field: 'fullscreenOnOpen', kind: 'bool',
+        read: function (v) { return v.fullscreenOnOpen !== false },
+        display: function (v) { return v !== false },
+        parse: function (draft) { return draft === true },
+        same: function (a, b) { return (a !== false) === (b !== false) },
+      },
+      {
+        field: 'fim', kind: 'bool',
+        read: function (v) { return v.fim === true },
+        display: function (v) { return v === true },
+        parse: function (draft) { return draft === true },
+        same: function (a, b) { return (a === true) === (b === true) },
+      },
+      {
+        field: 'fimDebounceMs', kind: 'number',
+        read: function (v) { return normalizeFimDebounce(v.fimDebounceMs) },
+        display: function (v) { return v === undefined || v === null ? '' : String(v) },
+        parse: function (text) { return normalizeFimDebounce(text) },
+        same: function (a, b) { return normalizeFimDebounce(a) === normalizeFimDebounce(b) },
+      },
+      {
+        field: 'fimMultiline', kind: 'bool',
+        read: function (v) { return v.fimMultiline !== false },
+        display: function (v) { return v !== false },
+        parse: function (draft) { return draft === true },
+        same: function (a, b) { return (a !== false) === (b !== false) },
+      },
+      {
+        field: 'fimDisableGlobs', kind: 'text',
+        read: function (v) { return typeof v.fimDisableGlobs === 'string' ? v.fimDisableGlobs : '' },
+        display: function (v) { return typeof v === 'string' ? v : '' },
+        parse: function (text) { return typeof text === 'string' ? text : '' },
+        same: function (a, b) { return String(a === undefined ? '' : a) === String(b === undefined ? '' : b) },
+      },
+      {
+        field: 'keepResident', kind: 'bool',
+        read: function (v) { return v.keepResident !== false },
+        display: function (v) { return v !== false },
+        parse: function (draft) { return draft === true },
+        same: function (a, b) { return (a !== false) === (b !== false) },
+      },
+    ]
+    /** 快照里的"值对象"(缺失时给空对象,让各字段的 read 兜底到默认值)。 */
+    function csValueObject(snapshot) {
+      return snapshot !== undefined && snapshot !== null
+        && snapshot.value !== undefined && snapshot.value !== null && typeof snapshot.value === 'object'
+        ? snapshot.value : {}
+    }
+    /** 某字段在设置里是否被用户显式改过(user 层的**键存在**即"已覆盖",不看值)。 */
+    function csOverridden(user, field) {
+      return user !== undefined && user !== null && Object.prototype.hasOwnProperty.call(user, field)
+    }
+
+    /**
+     * 壳层冻结模块表里的快照 store(`@deepseek-ai/dsh-client-store`,壳层基线模块)。
+     * 拿不到就返回 null —— 调用方据此退回旧通道,**绝不让整个客户端半部因为一个可选数据面加载失败**。
+     */
+    var csStoreFactory
+    function csSnapshotStore(initial) {
+      if (csStoreFactory === undefined) {
+        try {
+          var mod = require('@deepseek-ai/dsh-client-store')
+          csStoreFactory = mod !== null && mod !== undefined && typeof mod.createSnapshotStore === 'function'
+            ? mod.createSnapshotStore : null
+        } catch (e) {
+          csStoreFactory = 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)
+        if (csStoreFactory === null) {
+          console.warn('[code-server] @deepseek-ai/dsh-client-store 不在壳层模块表里:配置表单退回旧通道')
+        }
+      }
+      return csStoreFactory === null ? null : csStoreFactory(initial)
+    }
+
+    /**
+     * 新通道的表单控制器(官方 `ConfigForm` 的暂存编辑器等价物)。
+     *
+     * 语义与官方一致,这也是它存在的理由:
+     *   · 字段值 = **用户层 over 组合层 over schema 默认**(`getSnapshot().value`),`user` 的键存在即"已覆盖";
+     *   · 只有**保存**才写,而且一次 `mutate(ops, revision)` **原子提交全部暂存编辑**,带暂存起点读到的
+     *     revision 作栅栏;宿主是唯一权威(返回布尔即接受与否),被拒时**保留草稿**;
+     *   · 暂存在控制器里(不在组件里):组件只从 store 的投影渲染,写只经 action —— 与官方页面同构。
+     */
+    function csConfigFormController(form) {
+      var staged = new Map() // field -> { clear: boolean, display: any }
+      var listeners = new Set()
+      var baseline = null // 首次编辑前读到的快照(revision 栅栏的来源)
+      var saving = false
+      var failed = false
+      function publish() { listeners.forEach(function (fn) { fn() }) }
+      var unsubscribe = form !== null && form !== undefined && typeof form.subscribe === 'function'
+        ? form.subscribe(function () { publish() })
+        : function () {}
+      var snapshotOf = function () { return form.getSnapshot() }
+      function specOf(field) {
+        for (var i = 0; i < CS_FIELDS.length; i += 1) if (CS_FIELDS[i].field === field) return CS_FIELDS[i]
+        return null
+      }
+      /** 计划:暂存编辑 → 有序 op 列表(撤销 = unset;草稿与存量等价 = 不发 op)。 */
+      function plan() {
+        var snapshot = snapshotOf()
+        var value = csValueObject(snapshot)
+        var user = snapshot !== undefined && snapshot !== null ? snapshot.user : undefined
+        var out = []
+        CS_FIELDS.forEach(function (spec) {
+          if (!staged.has(spec.field)) return
+          var entry = staged.get(spec.field)
+          if (entry.clear === true) {
+            // 恢复默认 = 移除覆盖层(回落到组合层/schema 默认);本来就没有覆盖 ⇒ 无需写。
+            if (csOverridden(user, spec.field)) out.push({ field: spec.field, op: { op: 'unset', path: [spec.field] } })
+            return
           }
-          return null
+          var wire = spec.parse(entry.display)
+          if (wire === undefined) { out.push({ field: spec.field }); return } // 不可解析:草稿留着,保存被拒
+          if (spec.same(wire, spec.read(value))) return
+          out.push({ field: spec.field, op: { op: 'set', path: [spec.field], value: wire } })
+        })
+        return out
+      }
+      function projection() {
+        var snapshot = snapshotOf()
+        var value = csValueObject(snapshot)
+        var user = snapshot !== undefined && snapshot !== null ? snapshot.user : undefined
+        var values = {}
+        var overridden = {}
+        CS_FIELDS.forEach(function (spec) {
+          values[spec.field] = staged.has(spec.field)
+            ? staged.get(spec.field).display
+            : spec.display(spec.read(value))
+          overridden[spec.field] = csOverridden(user, spec.field)
+        })
+        var items = plan()
+        return {
+          available: snapshot !== undefined && snapshot !== null && snapshot.status === 'ready',
+          writable: snapshot !== undefined && snapshot !== null && snapshot.writable === true,
+          dirty: items.length > 0,
+          invalid: items.some(function (item) { return item.op === undefined }),
+          saving: saving,
+          failed: failed,
+          values: values,
+          overridden: overridden,
         }
-      var value = snapshot.value !== undefined && snapshot.value !== null ? snapshot.value : {}
-      var user = snapshot.user
-      var loaded = {
-        keepResident: value.keepResident !== false,
-        claimExtensions: typeof value.claimExtensions === 'string' ? value.claimExtensions : DEFAULT_CLAIM_EXTENSIONS,
-        fullscreenOnOpen: value.fullscreenOnOpen !== false,
-        fim: value.fim === true,
-        fimDebounceMs: normalizeFimDebounce(value.fimDebounceMs),
-        fimMultiline: value.fimMultiline !== false,
-        fimDisableGlobs: typeof value.fimDisableGlobs === 'string' ? value.fimDisableGlobs : '',
       }
-      // ---- 旧版 DSH(无右侧栏服务):本页是唯一的提示出口,不显示任何设置项 ----
-      if (liveStore != null && liveStore.sidebarUi === 'legacy') {
-        return React.createElement(csCard, {
-          title: 'Code Server',
-          description: '当前 DSH 版本不受支持(缺少右侧栏服务)',
-          defaultOpen: true,
-          noticeOnly: true,
-          state: { available: true, writable: false, dirty: false, invalid: false, saving: false, failed: false },
-        },
-          React.createElement('div', { className: 'dshcs-field' },
-            React.createElement('div', { className: 'dshcs-legacy' }, '本插件自 0.2.3 起不再兼容旧版 DSH。'),
-            React.createElement('div', { className: 'dshcs-hint', style: { marginTop: 0 } },
-              '未检测到右侧栏插件服务 sidebarRightTabs / sidebarRight,因此插件不提供任何入口'
-              + '(旧版的悬浮球与浮动窗口已移除),也不会后台启动 IDE。'
-              + '\n升级 DSH 到带右侧栏的版本(≥ 0.1.5-alpha.1)后,Code Server 会出现在右侧栏标签里,'
-              + '本页同时显示完整设置项;升级后无需重装本插件,刷新页面即可。'
-            )
-          )
-        )
+      function stage(field, entry) {
+        if (baseline === null) baseline = snapshotOf()
+        staged.set(field, entry)
+        failed = false
+        publish()
       }
-      var overriddenKeep = user !== undefined && user !== null && Object.prototype.hasOwnProperty.call(user, 'keepResident')
-      var overriddenClaim = user !== undefined && user !== null && Object.prototype.hasOwnProperty.call(user, 'claimExtensions')
-      var overriddenFullscreen = user !== undefined && user !== null && Object.prototype.hasOwnProperty.call(user, 'fullscreenOnOpen')
-      var overriddenFim = user !== undefined && user !== null && Object.prototype.hasOwnProperty.call(user, 'fim')
-      var overriddenFimDebounce = user !== undefined && user !== null && Object.prototype.hasOwnProperty.call(user, 'fimDebounceMs')
-      var overriddenFimMultiline = user !== undefined && user !== null && Object.prototype.hasOwnProperty.call(user, 'fimMultiline')
-      var overriddenFimGlobs = user !== undefined && user !== null && Object.prototype.hasOwnProperty.call(user, 'fimDisableGlobs')
-      var dirty = draft !== null && (draft.keepResident !== loaded.keepResident
-        || normalizeClaimExtensions(draft.claimExtensions) !== normalizeClaimExtensions(loaded.claimExtensions)
-        || draft.fullscreenOnOpen !== loaded.fullscreenOnOpen
-        || draft.fim !== loaded.fim
-        || normalizeFimDebounce(draft.fimDebounceMs) !== normalizeFimDebounce(loaded.fimDebounceMs)
-        || draft.fimMultiline !== loaded.fimMultiline
-        || draft.fimDisableGlobs !== loaded.fimDisableGlobs)
-      var saveDisabled = !dirty || saving
-      var state = {
-        available: true,
-        writable: snapshot.writable,
-        dirty: dirty,
-        invalid: false,
-        saving: saving,
-        failed: failed,
+      function discard() {
+        if (staged.size === 0 && failed !== true) return
+        staged.clear()
+        baseline = null
+        failed = false
+        publish()
       }
-      // 保存/恢复成功后,把 host 最新 status 推给模块共享 store → 常驻预热等立即按新设置生效。
-      function syncStatusToStore() {
-        api('/code-server/status').then(function (s) {
-          if (s != null && typeof s === 'object') setState({ status: s })
-        }).catch(function () { /* 失败由下次轮询兜底 */ })
+      function save() {
+        var items = plan()
+        var snapshot = snapshotOf()
+        if (items.length === 0 || saving === true) return Promise.resolve(false)
+        if (snapshot !== undefined && snapshot !== null && snapshot.writable !== true) return Promise.resolve(false)
+        if (items.some(function (item) { return item.op === undefined })) return Promise.resolve(false)
+        var ops = items.map(function (item) { return item.op })
+        var revision = baseline !== null && baseline !== undefined ? baseline.revision : undefined
+        saving = true
+        failed = false
+        publish()
+        return Promise.resolve()
+          .then(function () { return form.mutate(ops, revision) })
+          .then(function (landed) {
+            if (landed === true) { staged.clear(); baseline = null } else { failed = true }
+            return landed === true
+          })
+          .catch(function () { failed = true; return false })
+          .then(function (ok) { saving = false; publish(); return ok })
       }
-      async function doSave() {
-        if (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)
-            syncStatusToStore()
-          } catch (e) {
-            setFailed(true)
+      return {
+        projection: projection,
+        /** bind 出的是 DSH 的 hook 源(壳层按 hooks 键名派生成 `props.use<Key>`)。 */
+        bind: function () {
+          var store = csSnapshotStore(projection())
+          if (store === null) return null
+          listeners.add(function () { store.set(projection()) })
+          return store
+        },
+        actions: function () {
+          return {
+            edit: function (field, display) { stage(field, { clear: false, display: display }) },
+            resetField: function (field) {
+              var spec = specOf(field)
+              if (spec === null) return
+              var snapshot = snapshotOf()
+              var base = snapshot !== undefined && snapshot !== null
+                && snapshot.base !== undefined && snapshot.base !== null && typeof snapshot.base === 'object'
+                ? snapshot.base : {}
+              stage(field, { clear: true, display: spec.display(spec.read(base)) })
+            },
+            save: save,
+            discard: discard,
           }
-          setSaving(false)
-        }
+        },
+        dispose: function () {
+          unsubscribe()
+          listeners.clear()
+        },
       }
-      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)
-          syncStatusToStore()
-        } catch (e) {
-          setFailed(true)
-        }
-        setSaving(false)
+    }
+
+    // ---------- 两条通道共用的呈现层 ----------
+    /** 文案常量:两个外壳(设置页卡片 / 插件页配置区)必须逐字一致,否则"同一项设置在两个位置说法不同"。 */
+    var CS_UNSAVED_LABEL = '未保存'
+    var CS_READONLY_LABEL = '本部署的设置为只读。'
+    var CS_SAVE_FAILED_LABEL = '本部署没有接受这些值，已保留供你修改。'
+    var CS_DISCARD_LABEL = '放弃修改'
+    var CS_SAVE_LABEL = '保存'
+    var CS_SAVING_LABEL = '保存中…'
+    /** 旧版 DSH(无右侧栏服务)的提示文案 —— 本页是那种部署里唯一的提示出口。 */
+    var CS_LEGACY_TITLE = 'Code Server'
+    var CS_LEGACY_DESC = '当前 DSH 版本不受支持(缺少右侧栏服务)'
+    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 会出现在右侧栏标签里,'
+      + '本页同时显示完整设置项;升级后无需重装本插件,刷新页面即可。'
+
+    /** 保存/恢复成功后,把 host 最新 status 推给模块共享 store → 常驻预热等立即按新设置生效。 */
+    function csSyncStatusToStore() {
+      api('/code-server/status').then(function (s) {
+        if (s != null && typeof s === 'object') setState({ status: s })
+      }).catch(function () { /* 失败由下次轮询兜底 */ })
+    }
+    /** 常驻面状态那行提示(两个通道共用)。 */
+    function csSurfaceHintText(surfaceState) {
+      if (!supportsMoveBefore) {
+        return '当前浏览器不支持 Element.moveBefore(Chromium <133)→ 常驻不可用,切标签仍会整页重载(升级浏览器后自动生效)'
       }
-      var fields = [
+      return '常驻面:' + (surfaceState.docked ? '已停靠' : (surfaceState.ready ? '已停放(后台运行中)' : '未启动'))
+        + (surfaceState.degraded ? ' · 本次发生过降级重载' : '')
+    }
+    /** 面缺失时的占位 hook:hook 调用次数恒定(仍走一次 useSyncExternalStore),但永不订阅、恒返回 undefined。 */
+    function csNoopSubscribe() { return function () {} }
+    function csUndefinedSnapshot() { return undefined }
+    function csAbsentHook() { return React.useSyncExternalStore(csNoopSubscribe, csUndefinedSnapshot) }
+
+    /**
+     * 表单主体(**两条通道共用**):只认归一化视图与处理器,不知道数据从哪来。
+     * @param view {writable, values, overridden, dirty, invalid, saving, failed}
+     * @param handlers {onEdit(field, value), onResetField(field), onSave, onDiscard}
+     * @param extras {surfaceHint} 常驻面那行提示(需要组件里的实时状态,故由调用方算好传进来)
+     */
+    function csSettingsFields(view, handlers, extras) {
+      var writable = view.writable === true
+      var reset = function (field) {
+        return React.createElement(csBadges, {
+          overridden: true, disabled: !writable,
+          overriddenLabel: '已覆盖', resetLabel: '恢复默认',
+          onReset: function () { handlers.onResetField(field) },
+        })
+      }
+      var edit = function (field) {
+        return function (v) { handlers.onEdit(field, v) }
+      }
+      return [
         // 一行一个可改设置(0.2.11 起):认领类型 + 打开即全屏 + FIM 补全(0.3.61,含 0.3.62 的三个子项)
         // + 后台常驻。入口/依赖安装/环境检测三行已移除(入口在右侧栏「开始」页的 guide 入口框;诊断看 host 日志)。
         React.createElement('div', { className: 'dshcs-field' },
           React.createElement('div', { className: 'dshcs-fieldHead' },
             React.createElement('span', { className: 'dshcs-fieldLabel' }, '认领类型(按扩展名,分号分隔)'),
-            overriddenClaim === true
-              ? React.createElement(csBadges, {
-                  overridden: true, disabled: snapshot.writable !== true,
-                  overriddenLabel: '已覆盖', resetLabel: '恢复默认',
-                  onReset: function () { doReset() },
-                })
-              : null
+            view.overridden.claimExtensions === true ? reset('claimExtensions') : null
           ),
           React.createElement(csTextarea, {
-            value: draft !== null ? draft.claimExtensions : loaded.claimExtensions,
-            disabled: snapshot.writable !== true,
+            value: view.values.claimExtensions,
+            disabled: !writable,
             placeholder: '例如 py;ts;!md(留空 = 不认领任何文件)',
-            onChange: function (v) { setDraft(function (prev) { return Object.assign({}, prev !== null ? prev : loaded, { claimExtensions: v }) }); setFailed(false) },
+            onChange: edit('claimExtensions'),
           }),
           React.createElement('div', { className: 'dshcs-hint', style: { marginTop: 4 } },
             '写扩展名(不带点,大小写随意);`*` = 其余类型也认领;`!ext` = 不认领(排除优先)。'
             + '不再区分会话内/绝对路径 —— 所有 `dsh-resource://file/**` 一视同仁,未认领的落回 DSH 自带预览。'),
           React.createElement('div', { className: 'dshcs-hint', style: { marginTop: 4 } },
-            '实际规则:' + describeClaimPolicy(draft !== null ? draft.claimExtensions : loaded.claimExtensions)
-            + (normalizeClaimExtensions(draft !== null ? draft.claimExtensions : loaded.claimExtensions)
-              !== (draft !== null ? draft.claimExtensions : loaded.claimExtensions) ? '(保存后归一化)' : '')),
+            '实际规则:' + describeClaimPolicy(view.values.claimExtensions)
+            + (normalizeClaimExtensions(view.values.claimExtensions) !== view.values.claimExtensions ? '(保存后归一化)' : '')),
           // 提示块(0.3.52):分三行写清楚 + 默认值**折成多行**显示。
           // 以前这里是一整行"… · 默认 <700 字符>" —— `;` 在 CSS 里不是断行点,那串既不折行也复制不全,
           // 直接把卡片撑破。现在:三组各自成行(与 lib/claim-types.js 的常量同源),换行与分号等价,
@@ -1597,18 +1762,12 @@ let React = require('react')
         React.createElement('div', { className: 'dshcs-field' },
           React.createElement('div', { className: 'dshcs-fieldHead' },
             React.createElement('span', { className: 'dshcs-fieldLabel' }, '打开即全屏(右侧栏铺满窗口)'),
-            overriddenFullscreen === true
-              ? React.createElement(csBadges, {
-                  overridden: true, disabled: snapshot.writable !== true,
-                  overriddenLabel: '已覆盖', resetLabel: '恢复默认',
-                  onReset: function () { doReset() },
-                })
-              : null
+            view.overridden.fullscreenOnOpen === true ? reset('fullscreenOnOpen') : null
           ),
           React.createElement(csCheck, {
-            checked: draft !== null ? draft.fullscreenOnOpen : loaded.fullscreenOnOpen,
-            disabled: snapshot.writable !== true,
-            onChange: function (v) { setDraft(function (prev) { return Object.assign({}, prev !== null ? prev : loaded, { fullscreenOnOpen: v === true }) }); setFailed(false) },
+            checked: view.values.fullscreenOnOpen,
+            disabled: !writable,
+            onChange: edit('fullscreenOnOpen'),
           }, '打开 Code Server 标签(含点开产物/交付文件)时,自动把右侧栏从"与对话并排"切到全屏;'
             + '想同时看对话就关掉它,或随时点右侧栏的「退出全屏」—— 本次打开不会被抢回去'),
           React.createElement('div', { className: 'dshcs-hint', style: { marginTop: 4 } },
@@ -1618,18 +1777,12 @@ let React = require('react')
         React.createElement('div', { className: 'dshcs-field' },
           React.createElement('div', { className: 'dshcs-fieldHead' },
             React.createElement('span', { className: 'dshcs-fieldLabel' }, 'FIM 补全(实验性)'),
-            overriddenFim === true
-              ? React.createElement(csBadges, {
-                  overridden: true, disabled: snapshot.writable !== true,
-                  overriddenLabel: '已覆盖', resetLabel: '恢复默认',
-                  onReset: function () { doReset() },
-                })
-              : null
+            view.overridden.fim === true ? reset('fim') : null
           ),
           React.createElement(csCheck, {
-            checked: draft !== null ? draft.fim : loaded.fim,
-            disabled: snapshot.writable !== true,
-            onChange: function (v) { setDraft(function (prev) { return Object.assign({}, prev !== null ? prev : loaded, { fim: v === true }) }); setFailed(false) },
+            checked: view.values.fim,
+            disabled: !writable,
+            onChange: edit('fim'),
           }, '开启后,在编辑器里打字停顿约 0.3 秒会向模型要一次「续写」,以灰字显示在光标后:Tab 接受、Esc 丢弃。默认关闭'),
           React.createElement('div', { className: 'dshcs-hint', style: { marginTop: 4 } },
             '实验性功能,默认关闭。三点须知:'
@@ -1643,18 +1796,12 @@ let React = require('react')
         React.createElement('div', { className: 'dshcs-field' },
           React.createElement('div', { className: 'dshcs-fieldHead' },
             React.createElement('span', { className: 'dshcs-fieldLabel' }, 'FIM · 停顿毫秒数(停下多久才请求)'),
-            overriddenFimDebounce === true
-              ? React.createElement(csBadges, {
-                  overridden: true, disabled: snapshot.writable !== true,
-                  overriddenLabel: '已覆盖', resetLabel: '恢复默认',
-                  onReset: function () { doReset() },
-                })
-              : null
+            view.overridden.fimDebounceMs === true ? reset('fimDebounceMs') : null
           ),
           React.createElement(csNumber, {
-            value: draft !== null ? draft.fimDebounceMs : loaded.fimDebounceMs,
-            min: 100, max: 3000, step: 50, disabled: snapshot.writable !== true,
-            onChange: function (v) { setDraft(function (prev) { return Object.assign({}, prev !== null ? prev : loaded, { fimDebounceMs: v }) }); setFailed(false) },
+            value: view.values.fimDebounceMs,
+            min: 100, max: 3000, step: 50, disabled: !writable,
+            onChange: edit('fimDebounceMs'),
           }),
           React.createElement('div', { className: 'dshcs-hint', style: { marginTop: 4 } },
             '有效范围 100–3000ms,保存时按它夹取(与宿主同一套规则)。实测这条端点往返 112–416ms,'
@@ -1663,18 +1810,12 @@ let React = require('react')
         React.createElement('div', { className: 'dshcs-field' },
           React.createElement('div', { className: 'dshcs-fieldHead' },
             React.createElement('span', { className: 'dshcs-fieldLabel' }, 'FIM · 允许多行补全'),
-            overriddenFimMultiline === true
-              ? React.createElement(csBadges, {
-                  overridden: true, disabled: snapshot.writable !== true,
-                  overriddenLabel: '已覆盖', resetLabel: '恢复默认',
-                  onReset: function () { doReset() },
-                })
-              : null
+            view.overridden.fimMultiline === true ? reset('fimMultiline') : null
           ),
           React.createElement(csCheck, {
-            checked: draft !== null ? draft.fimMultiline : loaded.fimMultiline,
-            disabled: snapshot.writable !== true,
-            onChange: function (v) { setDraft(function (prev) { return Object.assign({}, prev !== null ? prev : loaded, { fimMultiline: v === true }) }); setFailed(false) },
+            checked: view.values.fimMultiline,
+            disabled: !writable,
+            onChange: edit('fimMultiline'),
           }, '允许补出多行(关掉后只取第一行;首行为空 = 这次不补)'),
           React.createElement('div', { className: 'dshcs-hint', style: { marginTop: 4 } },
             '默认开。实测模型在"并不需要补"的位置会硬凑一段,多行会把这种噪声放大 —— 想更克制就关掉它。')
@@ -1682,19 +1823,13 @@ let React = require('react')
         React.createElement('div', { className: 'dshcs-field' },
           React.createElement('div', { className: 'dshcs-fieldHead' },
             React.createElement('span', { className: 'dshcs-fieldLabel' }, 'FIM · 按 glob 禁用(分号或换行分隔)'),
-            overriddenFimGlobs === true
-              ? React.createElement(csBadges, {
-                  overridden: true, disabled: snapshot.writable !== true,
-                  overriddenLabel: '已覆盖', resetLabel: '恢复默认',
-                  onReset: function () { doReset() },
-                })
-              : null
+            view.overridden.fimDisableGlobs === true ? reset('fimDisableGlobs') : null
           ),
           React.createElement(csTextarea, {
-            value: draft !== null ? draft.fimDisableGlobs : loaded.fimDisableGlobs,
-            disabled: snapshot.writable !== true,
+            value: view.values.fimDisableGlobs,
+            disabled: !writable,
             placeholder: '例如 *.md;**/dist/**;vendor/**',
-            onChange: function (v) { setDraft(function (prev) { return Object.assign({}, prev !== null ? prev : loaded, { fimDisableGlobs: v }) }); setFailed(false) },
+            onChange: edit('fimDisableGlobs'),
           }),
           React.createElement('div', { className: 'dshcs-hint', style: { marginTop: 4 } },
             '留空 = 不禁用。语法:`*` 不跨目录、`**` 跨目录、不含 `/` 的模式只匹配文件名、`/` 结尾视作 `/**`。'
@@ -1704,59 +1839,271 @@ let React = require('react')
         React.createElement('div', { className: 'dshcs-field' },
           React.createElement('div', { className: 'dshcs-fieldHead' },
             React.createElement('span', { className: 'dshcs-fieldLabel' }, '后台常驻(切标签不重载)'),
-            overriddenKeep === true
-              ? React.createElement(csBadges, {
-                  overridden: true, disabled: snapshot.writable !== true,
-                  overriddenLabel: '已覆盖', resetLabel: '恢复默认',
-                  onReset: function () { doReset() },
-                })
-              : null
+            view.overridden.keepResident === true ? reset('keepResident') : null
           ),
           React.createElement(csCheck, {
-            checked: draft !== null ? draft.keepResident : loaded.keepResident,
-            disabled: snapshot.writable !== true,
-            onChange: function (v) { setDraft(function (prev) { return Object.assign({}, prev !== null ? prev : loaded, { keepResident: v === true }) }); setFailed(false) },
+            checked: view.values.keepResident,
+            disabled: !writable,
+            onChange: edit('keepResident'),
           }, '开启后宿主启动即把 IDE 加载到后台"停放区":切换右侧栏标签、收起/展开侧栏、拖成浮动窗口都不再重载,首次打开免等待;关闭则只在打开面板时加载(省内存)'),
-          React.createElement('div', { className: 'dshcs-hint', style: { marginTop: 4 } },
-            supportsMoveBefore
-              ? '常驻面:' + (surfaceState.docked ? '已停靠' : (surfaceState.ready ? '已停放(后台运行中)' : '未启动'))
-                + (surfaceState.degraded ? ' · 本次发生过降级重载' : '')
-              : '当前浏览器不支持 Element.moveBefore(Chromium <133)→ 常驻不可用,切标签仍会整页重载(升级浏览器后自动生效)')
-        )
+          React.createElement('div', { className: 'dshcs-hint', style: { marginTop: 4 } }, extras.surfaceHint)
+        ),
       ]
-      // ---- 插件页的配置区(DSH ≥ 0.1.6-alpha.2)----
-      // 上游把插件设置从"设置 → 插件"搬到**插件页**:页面自己画标题/图标/面包屑,把
-      // `plugins.bundle.config`(按包名为键)渲染在描述与行之间,只问 `view: 'page'`。
-      // 所以这里不再套可折叠卡片(标题会与页面标题重复),只出表单 + 自己的保存控件
-      // (契约原文:the form with its own save control)。
-      if (props.seat === 'bundle-config') {
+    }
+
+    /** 插件页配置区的外壳(0.3.50):页面自己画标题/图标/面包屑,这里只排表单 + 保存控件。 */
+    function csConfigPage(view, handlers, fields) {
+      return React.createElement('div', { className: 'dshcs-cfgpage', 'data-code-server-config': 'page' },
+        view.writable !== true
+          ? React.createElement('p', { className: 'dshcs-cardReadOnly', role: 'status' }, CS_READONLY_LABEL)
+          : null,
+        ...fields,
+        view.failed === true
+          ? React.createElement('p', { className: 'dshcs-cardFailed', role: 'status' }, CS_SAVE_FAILED_LABEL)
+          : null,
+        React.createElement('div', { className: 'dshcs-cfgfoot' },
+          React.createElement(csBtn, {
+            disabled: view.dirty !== true || view.saving === true,
+            onClick: handlers.onDiscard,
+          }, CS_DISCARD_LABEL),
+          React.createElement(csBtn, {
+            variant: 'primary',
+            disabled: view.dirty !== true || view.invalid === true || view.saving === true,
+            onClick: handlers.onSave,
+          }, view.saving === true ? CS_SAVING_LABEL : CS_SAVE_LABEL)
+        )
+      )
+    }
+
+    /** 旧版 DSH(无右侧栏服务)的提示:两个座位各自的外壳 + 同一段文案。 */
+    function csLegacyNotice(seat) {
+      var body = React.createElement('div', { className: 'dshcs-field' },
+        React.createElement('div', { className: 'dshcs-legacy' }, CS_LEGACY_LEAD),
+        React.createElement('div', { className: 'dshcs-hint', style: { marginTop: 0 } }, CS_LEGACY_BODY)
+      )
+      if (seat === 'page') {
         return React.createElement('div', { className: 'dshcs-cfgpage', 'data-code-server-config': 'page' },
-          snapshot.writable !== true
-            ? React.createElement('p', { className: 'dshcs-cardReadOnly', role: 'status' }, '本部署的设置为只读。')
-            : null,
-          ...fields,
-          failed === true
-            ? React.createElement('p', { className: 'dshcs-cardFailed', role: 'status' }, '本部署没有接受这些值，已保留供你修改。')
-            : null,
-          React.createElement('div', { className: 'dshcs-cfgfoot' },
-            React.createElement(csBtn, {
-              disabled: !dirty || saving,
-              onClick: function () { setDraft(null); setFailed(false) },
-            }, '放弃修改'),
-            React.createElement(csBtn, {
-              variant: 'primary', disabled: saveDisabled, onClick: function () { doSave() },
-            }, saving === true ? '保存中…' : '保存')
-          )
+          React.createElement('p', { className: 'dshcs-cardReadOnly', role: 'status' }, CS_LEGACY_DESC),
+          body
         )
       }
       return React.createElement(csCard, {
-        title: 'Code Server',
-        description: '入口:右侧栏标签(DSH ≥ 0.1.5-alpha.1);认领类型决定哪些文件交给 Code Server 打开',
+        title: CS_LEGACY_TITLE,
+        description: CS_LEGACY_DESC,
+        defaultOpen: true,
+        noticeOnly: true,
+        state: { available: true, writable: false, dirty: false, invalid: false, saving: false, failed: false },
+      }, body)
+    }
+
+    /**
+     * 新通道的配置页(alpha 线 ≥ 0.1.7-alpha.1;座位 `plugins.bundle.config`,键 = **包名**)。
+     *
+     * 数据面是 `ctx.configForms.get(ENTRY_ID)`,组件经 `props.useCodeServerForm`(壳层按注入面的
+     * `hooks.codeServerForm` 派生成 `use<Key>`)拿投影,写**只**经 `props.edit/resetField/save/discard` ——
+     * 保存最终落到一次原子的 `form.mutate(ops, revision)`。组件里不持有草稿(与旧通道不同)。
+     */
+    function ConfigFormsEntry(props) {
+      // hook 调用次数必须恒定(React 按位置对账):注入面缺失时也走一个"同形但不订阅"的 hook。
+      var useForm = typeof props.useCodeServerForm === 'function' ? props.useCodeServerForm : csAbsentHook
+      var state = useForm(function (snapshot) { return snapshot })
+      var liveStore = useStore()
+      // 常驻面实时状态(与旧通道同一段:两个外壳里的提示要一致)
+      var [surfaceState, setSurfaceState] = React.useState(surfaceSnapshot())
+      React.useEffect(function () {
+        return subscribeSurface(function (snap) { setSurfaceState(snap) })
+      }, [])
+      // 页面离开即丢弃暂存编辑(插件页的同一约定:只有保存才写入)。
+      var discardRef = React.useRef(props.discard)
+      discardRef.current = props.discard
+      React.useEffect(function () {
+        return function () { if (typeof discardRef.current === 'function') discardRef.current() }
+      }, [])
+      if (props.view === 'summary') return CS_CONFIG_SUMMARY
+      if (liveStore != null && liveStore.sidebarUi === 'legacy') return csLegacyNotice('page')
+      if (state === null || state === undefined || state.available !== true) {
+        // 条目未加载 / 配置还没到:官方插槽边界接管,这里给一句能读懂的话(不显示占位骨架)。
+        return React.createElement('p', { className: 'dshcs-cardReadOnly', role: 'status' },
+          '宿主还没有提供本插件的配置(条目未加载或仍在加载),暂时无法编辑。')
+      }
+      var view = {
+        available: true,
+        writable: state.writable === true,
+        values: state.values,
+        overridden: state.overridden,
+        dirty: state.dirty === true,
+        invalid: state.invalid === true,
+        saving: state.saving === true,
+        failed: state.failed === true,
+      }
+      var handlers = {
+        onEdit: function (field, v) { if (typeof props.edit === 'function') props.edit(field, v) },
+        onResetField: function (field) { if (typeof props.resetField === 'function') props.resetField(field) },
+        onSave: function () {
+          if (typeof props.save !== 'function') return
+          // 保存成功后宿主状态(serve/常驻/认领类型)会变:立刻拉一次,别等下一趟轮询。
+          var out = props.save()
+          if (out !== null && out !== undefined && typeof out.then === 'function') {
+            out.then(function (ok) { if (ok === true) csSyncStatusToStore() }, function () { /* 失败已由控制器记账 */ })
+          }
+        },
+        onDiscard: function () { if (typeof props.discard === 'function') props.discard() },
+      }
+      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: '未保存', readOnlyLabel: '本部署的设置为只读。',
-        saveFailedLabel: '本部署没有接受这些值，已保留供你修改。',
-        discardLabel: '放弃修改', saveLabel: '保存', savingLabel: '保存中…',
-        onSave: doSave, onDiscard: function () { setDraft(null); setFailed(false) },
+        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) {
         // 渲染异常:记日志不打断;官方插槽对异常有边界,卡片留空即可
@@ -1765,7 +2112,9 @@ let React = require('react')
       }
     }
 
-    /** 插件页配置区的入口组件(0.3.50)。
+    /** 插件页配置区的入口组件(**旧通道**;0.3.50 起)。
+     *  用它的场合:座位是 `plugins.bundle.config` 但数据面还是 `settingsScope` —— 也就是
+     *  rc 线之外**还包括 0.1.6-alpha.2**(那一版座位已搬、通道未换)。新通道见 ConfigFormsEntry。
      *  上游契约:同一个 entry 会被要两种视图 —— `summary`(标题下的一句话)与 `page`(表单,
      *  自带保存控件)。插件页对 `plugins.bundle.config` 只用 `page`,但两种都答得起才算合格。
      *  本组件自身不调 hook(两个分支都不调),真正的设置表单在 csSettingsPage 里(独立组件边界)。 */
@@ -2844,36 +3193,76 @@ let React = require('react')
         console.error('[code-server] slots service unavailable')
         return
       }
-      // settings scope 提前绑定(设置卡共用)
-      var settingsScope = ctx.settingsScope
-      var scope = null
-      if (settingsScope !== undefined && typeof settingsScope.bind === 'function') {
-        scope = settingsScope.bind({ namespace: 'code-server' })
-      } else {
-        console.error('[code-server] settingsScope unavailable (inject missing?); settings card disabled')
-        return
-      }
-      // 预拉取 status(设置卡/预热/侧栏 body 共用)
+      // 预拉取 status(设置卡/预热/侧栏 body 共用)。**放在通道探测之前**:0.1.7-alpha.1 上
+      // 旧通道(settingsScope)已经不存在,配置区只是"少一块",侧栏标签/常驻预热必须照旧起来
+      // (0.3.50~0.3.65 的写法在这里提前 return,把整个右侧栏一起带走了 —— 那就是线上那次
+      // "Failed to load plugins / 1 entry did not activate" 之后的第二层故障)。
       api('/code-server/status').then(function (s) {
         setState({ status: s })
       }).catch(function () { /* 首次失败由后续轮询补救 */ })
 
-      // ---- 设置:两条腿都注册,谁被声明谁生效(两次注册不会同时出现) ----
-      // ① 插件页的配置区(DSH ≥ 0.1.6-alpha.2):`settings.plugin.item` 退役,上游把插件配置搬到
-      //    插件页 —— 键是**包名**(页面按 `pkg.name` 派发),只问 `view: 'page'`。插件页只在
-      //    `ledger.bundles.has(包名)` 时才渲染那一块,所以键写错就等于"设置又不见了"。
-      slots.inject('plugins.bundle.config', () => slots.register(
-        { name: 'plugins.bundle.config', key: PKG_NAME, inject: function () { return { scope: scope } } },
-        BundleConfigEntry
-      ))
-      // ② 设置页里的插件卡片(DSH ≤ 0.1.6-alpha.1;也是极旧 DSH 里唯一的提示出口)。
-      //    `slots.inject` 只在插槽真被声明时才回调 ⇒ 新 DSH 上这一条自然不生效。
-      slots.inject('settings.plugin.item', () => slots.register(
-        { name: 'settings.plugin.item', key: 'code-server', label: 'Code Server', inject: function () { return { scope: scope } } },
-        csSettingsPage
-      ))
-
-      // ---- 能力探测:只有带右侧栏服务(DSH ≥ 0.1.5-alpha.1)才注册可用 UI;探测不到就只留设置页提示 ----
+      // ---- 设置:两个**座位** × 两条**数据通道**(见本段开头的说明) ----
+      // 通道用能力探测,座位用声明驱动:`slots.inject` 只在插槽真被声明时才回调 ⇒ 两条腿都注册。
+      // 探测只经 `ctx.get`:这两个服务**不能**写进静态 inject(写进去会让另一条线上的条目永远 pending),
+      // 而未声明的服务在 DSH 里**属性访问会抛** —— 所以这里绝不用 ctx.configForms / ctx.settingsScope。
+      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。
+        var form = formsSvc.get(CS_ENTRY_ID)
+        var controller = csConfigFormController(form)
+        var face = null
+        var store = controller.bind()
+        if (store !== null) {
+          face = Object.assign({ hooks: { codeServerForm: store } }, controller.actions())
+        } else {
+          console.warn('[code-server] 快照 store 不可用:配置区退回旧通道(没有就只剩提示)')
+        }
+        // 表单订阅属于本 fiber:插件卸载/热重载时释放,避免监听泄漏到服务缓存的表单上。
+        ctx.effect(function () { return function () { controller.dispose() } }, 'code-server: config form subscription')
+        if (face !== null) {
+          // `whileServed` 是**门禁**:宿主只有在服务该条目配置时才让我们注册页面
+          // (没加载这个插件的部署看不到任何痕迹;宿主不再服务时自动撤下)。
+          ctx.effect(function () {
+            return formsSvc.whileServed([CS_ENTRY_ID], function () {
+              return slots.inject('plugins.bundle.config', function () {
+                return slots.register(
+                  { name: 'plugins.bundle.config', key: PKG_NAME, inject: function () { return face } },
+                  ConfigFormsEntry
+                )
+              })
+            })
+          }, 'code-server: plugins.bundle.config page (configForms)')
+          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
+          ))
+        }
+      }
+
+      // ---- 能力探测:只有带右侧栏服务(sidebarRightTabs/sidebarRight;rc 线与 alpha 线都有)才注册可用 UI;探测不到就只留设置页提示 ----
       var modernSettled = false
 
       function onModernUi(sctx, via) {
@@ -2964,7 +3353,10 @@ let React = require('react')
       }, LEGACY_REPORT_MS)
     }
 
-    const inject = ['slots', 'settingsScope']
+    // 静态 inject 只列**两条线都必然存在**的服务。`configForms` / `settingsScope` 都是
+    // **运行时探测**的:把它们写进 inject,客户端条目会在没有那个服务的 DSH 上永远 pending
+    // (0.1.7-alpha.1 上 `settingsScope` 已被删除 ⇒ 整个条目不激活、右侧栏与设置一起消失)。
+    const inject = ['slots']
     const name = 'code-server'
 
     // 入口导出(与原 `export { apply, inject, name }` 等价;banner/footer 的 CJS 形态要求)