dsh-code-server-app 0.1.42 → 0.2.0

package/lib/index.js

@@ -1,5 +1,10 @@
 /**
- * dsh-code-server — host 半部:code-server 进程的启动/停止/状态管理 + /api/code-server JSON API。
+ * dsh-code-server — host 半部:VS Code server 子进程(lib/launcher.mjs)的启动/停止/状态管理
+ * + /api/code-server JSON API。
+ *
+ * 模型(0.2.0 起):不再运行 code-server 的 Node 服务层 —— 直接由 lib/launcher.mjs 驱动
+ * <树>/lib/vscode/out/server-main.js(树 = @<scope>/dshcs-vscode-server 的 vscode/ 子目录)。
+ * 依据与实测见 docs/analysis-code-server-as-dsh-plugin.md。
  *
  * 零外部依赖:只用 Node 内置模块(child_process / http / fs / path / os)。
  * 静态 profile 插件,与 dsh-webproxy-router-plugin 同形态:
@@ -42,13 +47,16 @@ import {
   PACKAGE_ROOT,
   codeServerEntry,
   codeServerPackageName,
-  codeServerRoot,
   legacyInstallRoot,
+  productPath,
   readTreeVersion,
   vendoredVersion,
   vendorReady,
+  vsRoot,
+  vsServerEntry,
 } from './vendor.js';
-import { aliasNodePathDirs, ensureRuntimeLayout, resolveNativeDir, resolveRuntime, runtimePackageName, verifyNatives } from './native.js';
+import { aliasNodePathDirs, ensureRuntimeLayout, resolveRuntime, runtimePackageName, verifyNatives } from './native.js';
+import { MOUNT_PATH, mountOnWebServer } from './serve-dsh.mjs';
 
 // schemastery 由 DSH 部署自带(官方核心依赖),仿 auto-open-web 的解析策略:
 // 常规 import 优先,不可用时回退到全局 npm 布局的 DSH 部署副本。
@@ -87,16 +95,21 @@ export const Config = z.object({
   /** windowedOpen=false(默认)点击悬浮球打开内部浮动窗口;
    *  true 时改为在浏览器新标签页打开 code-server(自动启动并跟随工作区)。 */
   windowedOpen: z.boolean().default(false),
+  /** 服务方式:loopback(默认)独立回环端口;dsh 挂到 DSH webServer 的 /code-server
+   *  (同源、无额外端口、复用 DSH 的 Host/Origin + cookie 防护;需要 DSH 提供 webServer 服务,
+   *  缺失或注册失败时自动回退 loopback)。 */
+  serve: z.union([z.const('loopback'), z.const('dsh')]).default('loopback'),
 });
 
 const DEFAULT_CONFIG = {
-  bin: 'code-server',
+  bin: '',
   host: '127.0.0.1',
   port: 8090,
   auth: 'none',
-  passwordToken: '',
+  serve: 'loopback',
   userDataDir: '',
   extensionsDir: '',
+  locale: '',
   readyTimeoutMs: 60000,
 };
 
@@ -129,41 +142,29 @@ function win32() {
   return process.platform === 'win32';
 }
 
-/** 插件自带 code-server 入口探测(0.1.36 模型:就地运行,不再复制到 profile):
- *   1. 平台专属子包 @<scope>/dshcs-code-server-<platform>-<arch>(0.1.37+ 正式布局,
- *      由 pnpm 作为 optionalDependency 安装,内含 code-server/ 子树);
- *   2. 包内 vendor/code-server(0.1.36 及更早的随包布局 / 开发期);
- *   3. 旧版安装位 <profile>\.code-server-app/node_modules/code-server(兼容 0.1.35 及更早);
- *   4. 插件目录/node_modules/code-server(开发期 link: 布局)。
- *  不存在 → 回退配置/PATH。 */
+/** 插件自带 launcher(<pkg>/lib/launcher.mjs);它直接驱动 VS Code server(0.2.0 模型)。 */
+function launcherPath() {
+  return path.join(path.dirname(fileURLToPath(import.meta.url)), 'launcher.mjs');
+}
+
+/** code-server 兼容入口(旧全量树才有 out/node/entry.js);新树返回 null。 */
 function bundledRuntimeEntry() {
   try {
-    const entry = codeServerEntry(); // 子包优先,其次包内 vendor
-    if (entry !== null) return entry;
-    const here = path.dirname(fileURLToPath(import.meta.url)); // .../dsh-code-server-app/lib
-    const candidates = [
-      path.join(here, '..', '..', '..', '.code-server-app', 'node_modules', 'code-server', 'out', 'node', 'entry.js'),
-      path.join(here, '..', 'node_modules', 'code-server', 'out', 'node', 'entry.js'),
-    ];
-    for (const candidate of candidates) {
-      if (fs.existsSync(candidate)) return candidate;
-    }
-    return null;
+    return codeServerEntry();
   } catch {
     return null;
   }
 }
 
-/** 扩展安装目标:VS Code "内置扩展"目录 = code-server 程序根的 lib/vscode/extensions。
+/** 扩展安装目标:VS Code「内置扩展」目录 = <树>/lib/vscode/extensions。
  *  (位于程序内置目录的扩展被 VS Code 视为内置——用户视图显示为"内置",不可卸载;
  *   --extensions-dir 的是用户级扩展,可被用户禁用/卸载。)
- *  返回 { dst, builtin }——builtin=true 时为核心路径;找不到 code-server 根则回退用户级。 */
+ *  返回 { dst, builtin }——builtin=true 时为核心路径;找不到树则回退用户级。 */
 function extensionTarget(extensionsDir) {
   try {
-    const entry = bundledRuntimeEntry();
-    if (entry !== null) {
-      const csRoot = path.dirname(path.dirname(path.dirname(entry))); // .../code-server
-      const vscodeExt = path.join(csRoot, 'lib', 'vscode', 'extensions');
+    const root = vsRoot();
+    if (root !== null) {
+      const vscodeExt = path.join(root, 'lib', 'vscode', 'extensions');
       if (fs.existsSync(vscodeExt)) {
         return { dst: path.join(vscodeExt, 'dshcs-open-file'), builtin: true };
       }
@@ -203,22 +204,22 @@ function openFileSignalPath(userDataDir) {
   return path.join(userDataDir, 'User', 'dshcs-open.json');
 }
 
-/** 插件 package.json 里声明的内部依赖(纯 JS 直装集)。 */
+/** 插件 package.json 里声明的内部依赖(纯 JS 直装集;排除 VS Code 树包本身)。 */
 function declaredInnerDeps() {
   try {
     const manifest = JSON.parse(fs.readFileSync(path.join(PACKAGE_ROOT, 'package.json'), 'utf8'));
-    return Object.keys(manifest.dependencies ?? {});
+    return Object.keys(manifest.dependencies ?? {})
+      .filter((name) => !/^@[^/]+\/dshcs-(vscode-server|code-server)$/.test(name));
   } catch {
     return [];
   }
 }
 
-/** 从 code-server 运行位置解析内部依赖(与运行时同一套向上查找规则)。
- *  先试 `<name>/package.json`(code-server 本体包没有入口文件,ESM-only 包也没有 require 入口),
- *  再退回 `<name>` 本身。 */
+/** 从 VS Code 树位置解析内部依赖(与运行时同一套向上查找规则)。
+ *  先试 `<name>/package.json`(ESM-only 包没有 require 入口),再退回 `<name>` 本身。 */
 function checkInnerDeps() {
   const declared = declaredInnerDeps();
-  const root = codeServerRoot();
+  const root = vsRoot();
   const from = createRequire(path.join(root ?? PACKAGE_ROOT, 'package.json'));
   const missing = [];
   let resolved = 0;
@@ -237,32 +238,25 @@ function checkInnerDeps() {
   return { declared: declared.length, resolved, missing };
 }
 
-/** 环境检测:code-server 入口 + 原生模块(argon2) + 内部依赖 + 预编译原生包。
- * 返回 { ok, entry, native, vscodeInner, innerDeps, codeServer, vendored, upToDate, nativeRuntime, node, platform, arch }。 */
+/** 环境检测:VS Code 树 + server 入口 + 内部依赖 + 预编译原生包。
+ * 返回 { ok, tree, entry, productPath, vscodeInner, innerDeps, treeVersion, vendored, upToDate, nativeRuntime, node, platform, arch }。 */
 function envCheck() {
-  const entry = bundledRuntimeEntry();
-  const csRoot = entry ? path.dirname(path.dirname(path.dirname(entry))) : null; // .../code-server
-  // argon2 不在 code-server 本体包里(平台包 @<scope>/dshcs-argon2-<平台>-<架构> 提供,经聚合包用
-  // npm: 别名装回原名);pnpm 会把带 os/cpu 限定的包嵌套装在聚合包下,所以按多锚点解析。
-  const argon2 = resolveNativeDir('argon2');
-  // 必须按当前平台判定:argon2 的 prebuilds 目录存在不代表本平台有二进制(win32-arm64 就缺)。
-  const nativeOk = argon2 !== null && (
-    fs.existsSync(path.join(argon2, 'build', 'Release', 'argon2.node')) ||
-    fs.existsSync(path.join(argon2, 'prebuilds', `${process.platform}-${process.arch}`))
-  );
+  const root = vsRoot();
+  const entry = vsServerEntry();
   const inner = checkInnerDeps();
   const runtime = resolveRuntime();
   const natives = verifyNatives(runtime !== null ? runtime.modules : []);
-  const installed = csRoot !== null ? readTreeVersion(csRoot) : null;
+  const installed = root !== null ? readTreeVersion(root) : null;
   const vendored = vendoredVersion();
   return {
-    ok: entry !== null && nativeOk && inner.missing.length === 0
+    ok: entry !== null && inner.missing.length === 0
       && runtime !== null && natives.missing.length === 0,
+    tree: root !== null ? root.replace(/\\/g, '/') : null,
     entry: entry !== null ? entry.replace(/\\/g, '/') : null,
-    native: nativeOk,
+    productPath: productPath(root),
     vscodeInner: inner.missing.length === 0,
     innerDeps: { declared: inner.declared, resolved: inner.resolved, missing: inner.missing },
-    codeServer: installed,
+    treeVersion: installed,
     vendored,
     upToDate: installed !== null && vendored !== null && installed === vendored,
     // 本平台预编译原生产物(平台聚合包 + 它带回原始名字的原生模块)
@@ -281,41 +275,49 @@ function envCheck() {
   };
 }
 
-/** 解析 code-server 启动方式:返回 { launched, command, script } | { command, args }。
- *  - `bin` 为可执行文件(裸名/绝对路径 .exe/.cmd):直接 spawn;
- *  - `bin` 为 JS 入口(依赖安装的 out/node/entry.js):自动用 node 运行;
- *  - 未配置 `bin` 时:先探测插件依赖安装的 code-server,再回退 PATH 裸名 code-server。 */
-function resolveLaunch(config) {
-  const probe = bundledRuntimeEntry();
-  let preferred = config.bin || DEFAULT_CONFIG.bin;
-  // 依赖安装的 code-server 优先,除非用户显式配置了非默认 bin
-  if (preferred === DEFAULT_CONFIG.bin && probe !== null) preferred = probe;
-  console.log(`[code-server] resolveLaunch: configuredBin=${config.bin ?? '(none)'} probe=${probe ?? '(none)'} -> ${preferred}`);
-  if (/\.(js|mjs|cjs)$/i.test(preferred)) {
-    // JS 入口:node <entry> ...(code-server 的 out/node/entry.js 是官方发布形态)
-    if (!fs.existsSync(preferred)) {
-      throw new Error(`code-server 入口不存在: ${preferred}`);
-    }
-    return { kind: 'node', script: preferred };
-  }
-  if (path.isAbsolute(preferred)) return { kind: 'bin', command: preferred };
+/** 解析启动方式:
+ *  - 默认:插件自带 launcher(node lib/launcher.mjs)+ 内置 VS Code 树;
+ *  - `bin` 显式配置时按旧模型当逃生舱:可执行文件 / code-server 的 out/node/entry.js。 */
+function resolveLaunch(config, serve) {
+  const configured = typeof config.bin === 'string' && config.bin !== '' && config.bin !== DEFAULT_CONFIG.bin
+    ? config.bin
+    : null;
+  if (configured === null) {
+    const root = vsRoot();
+    if (root === null || vsServerEntry() === null) {
+      throw new Error(
+        '找不到 VS Code 树(缺 lib/vscode/out/server-main.js)。请重新安装插件'
+        + '(`dsh plugin --profile web add dsh-code-server-app`),'
+        + '开发期先用 `node scripts/vendor-vscode-server.mjs --dev-links` 生成 vendor/vscode。',
+      );
+    }
+    return { kind: 'launcher', script: launcherPath(), tree: root };
+  }
+  console.log(`[code-server] resolveLaunch: 使用显式配置的 bin=${configured}(launcher 旁路)`);
+  if (/\.(js|mjs|cjs)$/i.test(configured)) {
+    if (!fs.existsSync(configured)) throw new Error(`配置的入口不存在: ${configured}`);
+    return { kind: 'node', script: configured };
+  }
+  if (path.isAbsolute(configured)) return { kind: 'bin', command: configured };
   try {
     if (win32()) {
-      const out = execFileSync('where.exe', [preferred], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+      const out = execFileSync('where.exe', [configured], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
       const lines = out.split(/\r?\n/).map((s) => s.trim()).filter(Boolean);
       return { kind: 'bin', command: lines.find((l) => /\.cmd$/i.test(l)) ?? lines.find((l) => /\.exe$/i.test(l)) ?? lines[0] };
     }
-    const out = execFileSync('which', [preferred], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
+    const out = execFileSync('which', [configured], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] });
     return { kind: 'bin', command: out.split('\n')[0].trim() };
   } catch {
-    throw new Error(
-      `code-server 未找到("${preferred}" 不在 PATH)。插件包内应自带 vendor/code-server/out/node/entry.js;` +
-      `若缺失请重新安装插件(dsh plugin --profile web add <tgz>),` +
-      `也可在 cordis.patch.yml 的 code-server config 中把 bin 指向已安装的 code-server 可执行文件 / out/node/entry.js。`,
-    );
+    throw new Error(`配置的 bin 未找到("${configured}" 不在 PATH)`);
   }
 }
 
+/** 命名管道名(仅 dsh 模式使用):按 profile/pid 稳定,避免撞名。 */
+function pipeName() {
+  const key = `${process.pid}`;
+  return win32() ? `\\\\.\\pipe\\dshcs-vscode-${key}` : path.join(os.tmpdir(), `dshcs-vscode-${key}.sock`);
+}
+
 function healthCheck(host, port, timeoutMs = 1500) {
   return new Promise((resolve) => {
     const req = http.get({ host, port, path: '/healthz', timeout: timeoutMs, method: 'GET' }, (res) => {
@@ -330,6 +332,22 @@ function healthCheck(host, port, timeoutMs = 1500) {
   });
 }
 
+/** 命名管道上的 /healthz 探针(dsh 模式;管道由 launcher 监听)。 */
+function healthCheckPipe(pipe, timeoutMs = 1500) {
+  return new Promise((resolve) => {
+    const req = http.request({ socketPath: pipe, path: '/healthz', method: 'GET', timeout: timeoutMs }, (res) => {
+      res.resume();
+      resolve({ ok: res.statusCode >= 200 && res.statusCode < 500, statusCode: res.statusCode });
+    });
+    req.on('error', () => resolve({ ok: false }));
+    req.on('timeout', () => {
+      req.destroy();
+      resolve({ ok: false });
+    });
+    req.end();
+  });
+}
+
 function readPidFile(config) {
   try {
     const raw = JSON.parse(fs.readFileSync(pidFile(config), 'utf8'));
@@ -357,8 +375,15 @@ export async function apply(ctx, config) {
 
   // ---- 设置:行配置为种子;settings 命名空间持久化(设置卡片写入) ----
   const settingsSvc = ctx.get('settings');
+  // connection 是 host↔client 通道(必需);提前取出,供 DSH 同源挂载的 fence 使用。
+  const connection = ctx.get('connection');
+  if (connection === undefined || connection.fetch === undefined) {
+    console.error('[code-server] connection service unavailable; plugin registered but idle');
+    return;
+  }
   let reserveComposer = true;
   let windowedOpen = false;
+  let serveSetting = 'loopback';
   if (settingsSvc !== undefined && typeof settingsSvc.register === 'function') {
     try {
       const scope = settingsSvc.register(SETTINGS_NS, Config);
@@ -367,6 +392,7 @@ export async function apply(ctx, config) {
         const resolved = scope.get();
         reserveComposer = resolved && typeof resolved.reserveComposer === 'boolean' ? resolved.reserveComposer : true;
         windowedOpen = resolved && typeof resolved.windowedOpen === 'boolean' ? resolved.windowedOpen : false;
+        serveSetting = resolved && resolved.serve === 'dsh' ? 'dsh' : 'loopback';
       }
       scope.watch((next) => {
         if (next != null && typeof next.reserveComposer === 'boolean') {
@@ -377,12 +403,37 @@ export async function apply(ctx, config) {
           windowedOpen = next.windowedOpen;
           console.log(`[code-server] windowedOpen updated: ${windowedOpen}`);
         }
+        if (next != null && (next.serve === 'dsh' || next.serve === 'loopback')) {
+          if (next.serve !== serveSetting) {
+            serveSetting = next.serve;
+            console.log(`[code-server] serve updated: ${serveSetting}(下次启动生效)`);
+          }
+        }
       });
     } catch (error) {
       console.error(`[code-server] settings unavailable; using defaults (reserveComposer=true, windowedOpen=false): ${error.message}`);
     }
   }
 
+  // 依赖布局自愈必须发生在任何解析之前:精简树不含 lib/vscode/node_modules,
+  // 由这里按插件依赖图补 junction(幂等;重装后自愈)。
+  const layout = ensureRuntimeLayout();
+
+  // ---- 服务方式:settings/行配置请求 dsh,但只有本 deployment 真的提供 webServer 时才用 ----
+  let webServerSvc = ctx.get('webServer');
+  let dshMount = null; // { disposers, upgradePath } —— 由下面的 ctx.inject 填充
+
+  /** 生效的服务方式:loopback(默认,独立回环端口)| dsh(DSH 同源挂载)。 */
+  function requestedServe() {
+    const want = serveSetting === 'dsh' || cfg.serve === 'dsh' ? 'dsh' : 'loopback';
+    if (want === 'loopback') return 'loopback';
+    if (webServerSvc === undefined || dshMount === null) {
+      console.warn('[code-server] serve=dsh 但 webServer 不可用/挂载失败 → 回退 loopback');
+      return 'loopback';
+    }
+    return 'dsh';
+  }
+
   const state = {
     status: 'stopped', // stopped | starting | running | stopping | error
     pid: null,
@@ -393,7 +444,9 @@ export async function apply(ctx, config) {
     logTail: '',
     startedAt: null,
     adopted: false,
-    env: envCheck(), // 环境检测(code-server 入口/native/内部依赖/预编译原生包)
+    serve: 'loopback', // 实际生效的服务方式(loopback | dsh)
+    pipe: null, // dsh 模式下的命名管道
+    env: envCheck(), // 环境检测(VS Code 树 / server 入口 / 内部依赖 / 预编译原生包)
     setup: { running: false, done: true, ok: true, logTail: '0.1.36 起由包管理器安装依赖,无需「安装环境」步骤', startedAt: null, finishedAt: null }, // 兼容旧客户端
   };
 
@@ -401,17 +454,48 @@ export async function apply(ctx, config) {
   let pollTimer = null;
   let disposeKilled = false;
 
+  // ---- DSH 同源挂载(serve=dsh):把 /code-server 注册到 DSH 自己的 webServer ----
+  // webServer 只在 web profile 存在(desktop 显式禁用该行)→ 用 ctx.inject 特性检测,
+  // 缺失时 requestedServe() 自动回退 loopback。
+  ctx.inject(['webServer'], (wsCtx) => {
+    webServerSvc = wsCtx.webServer;
+    try {
+      dshMount = mountOnWebServer({
+        webServer: wsCtx.webServer,
+        connection,
+        // 目标随时可变:launcher 重启会换管道/端口,未运行时返回 null(路由回 503)
+        getTarget: () => (state.serve === 'dsh' && state.pipe !== null ? { kind: 'pipe', pipe: state.pipe } : null),
+        productPath: state.env?.productPath ?? productPath() ?? 'stable',
+      });
+      console.log(`[code-server] serve=dsh 挂载就绪:${MOUNT_PATH}/ (HTTP)+ ${dshMount.upgradePath} (WS)`);
+    } catch (error) {
+      dshMount = null;
+      console.error(`[code-server] serve=dsh 挂载失败(将回退 loopback):${error && error.message ? error.message : error}`);
+    }
+  });
+
+  ctx.effect(() => () => {
+    if (dshMount === null) return;
+    for (const dispose of dshMount.disposers) {
+      try { dispose(); } catch { /* ignore */ }
+    }
+  }, 'code-server: dsh mount');
+
   function snapshot() {
     const running = state.status === 'running' && state.pid !== null;
+    const dshMode = state.serve === 'dsh';
     return {
       ok: state.status !== 'error' || running,
       running,
       status: state.status,
-      port: state.port,
-      host: cfg.host,
+      serve: state.serve,
+      port: dshMode ? null : state.port,
+      host: dshMode ? null : cfg.host,
       pid: state.pid,
       cwd: state.cwd,
-      url: running ? `http://${cfg.host}:${state.port}/` : null,
+      // dsh 模式:同源相对地址(由 DSH webServer 的 prefix 路由提供服务)
+      url: running ? (dshMode ? '/code-server/' : `http://${cfg.host}:${state.port}/`) : null,
+      productPath: state.env?.productPath ?? null,
       version: state.version,
       error: state.error,
       logTail: state.logTail.slice(-LOG_TAIL_MAX),
@@ -523,6 +607,12 @@ export async function apply(ctx, config) {
     if (reason) state.error = null;
   }
 
+  /** 就绪探针:loopback 走 TCP,dsh 模式走命名管道。 */
+  function probeReady(timeoutMs = 1500) {
+    if (state.pipe !== null) return healthCheckPipe(state.pipe, timeoutMs);
+    return healthCheck(cfg.host, state.port, timeoutMs);
+  }
+
   function beginPollingReady() {
     stopPolling();
     const deadline = Date.now() + (Number(cfg.readyTimeoutMs) || DEFAULT_CONFIG.readyTimeoutMs);
@@ -533,7 +623,7 @@ export async function apply(ctx, config) {
         first = false;
         return; // 等 800ms 才首次探测(给 Node 启动留时间)
       }
-      const probe = await healthCheck(cfg.host, state.port);
+      const probe = await probeReady();
       if (probe.ok) {
         stopPolling();
         state.status = 'running';
@@ -542,7 +632,7 @@ export async function apply(ctx, config) {
       if (Date.now() > deadline) {
         stopPolling();
         state.status = 'error';
-        state.error = `启动超时(${cfg.readyTimeoutMs}ms 内 /healthz 未就绪);code-server 启动日志尾部:\n${state.logTail.slice(-2000)}`;
+        state.error = `启动超时(${cfg.readyTimeoutMs}ms 内 /healthz 未就绪);启动日志尾部:\n${state.logTail.slice(-2000)}`;
       }
     }, 500);
   }
@@ -571,36 +661,37 @@ export async function apply(ctx, config) {
       }
     }
 
-    const launch = resolveLaunch(cfg); // throws with install guidance when missing
+    const serve = requestedServe(); // loopback | dsh(按 DSH 是否提供 webServer 定)
+    const launch = resolveLaunch(cfg, serve); // throws with install guidance when missing
 
-    // 认证:非回环 host 必须 password;显式 password 必须带 token
-    const auth = cfg.auth || 'none';
-    if (auth === 'none' && !LOOPBACK_HOSTS.has(cfg.host)) {
+    if (serve === 'loopback' && !LOOPBACK_HOSTS.has(cfg.host)) {
       state.status = 'error';
-      state.error = `auth=none 仅允许回环绑定(当前 host="${cfg.host}");请改用 auth=password 并配置 passwordToken`;
+      state.error = `serve=loopback 仅允许回环绑定(当前 host="${cfg.host}");`
+        + '如需对外提供服务,请改用 serve=dsh(挂到 DSH 同源路径,由 DSH 统一防护)';
       return snapshot();
     }
-    if (auth === 'password' && !cfg.passwordToken) {
-      state.status = 'error';
-      state.error = 'auth=password 需要配置 passwordToken(cordis.patch.yml 的 config.passwordToken)';
-      return snapshot();
+    if (cfg.auth === 'password') {
+      console.warn('[code-server] 0.2.0 起不再支持口令认证(argon2 已移除),按 auth=none 运行');
     }
 
-    // 端口占用则尝试 adopt(pid.json 有效 + /healthz 响应),否则报错
-    const probe = await healthCheck(cfg.host, cfg.port, 800);
-    if (probe.ok) {
-      const record = readPidFile(cfg);
-      if (record && isAlive(record.pid)) {
-        state.status = 'running';
-        state.pid = record.pid;
-        state.cwd = cwd ?? record.cwd ?? null;
-        state.startedAt = record.startedAt ?? null;
-        state.adopted = true;
+    // 端口占用则尝试 adopt(仅 loopback 模式;pid.json 有效 + /healthz 响应),否则报错
+    if (serve === 'loopback') {
+      const probe = await healthCheck(cfg.host, cfg.port, 800);
+      if (probe.ok) {
+        const record = readPidFile(cfg);
+        if (record && isAlive(record.pid)) {
+          state.serve = 'loopback';
+          state.status = 'running';
+          state.pid = record.pid;
+          state.cwd = cwd ?? record.cwd ?? null;
+          state.startedAt = record.startedAt ?? null;
+          state.adopted = true;
+          return snapshot();
+        }
+        state.status = 'error';
+        state.error = `端口 ${cfg.port} 已被占用且没有有效的 pid.json 记录(拒绝误杀);请释放端口或修改 port 配置`;
         return snapshot();
       }
-      state.status = 'error';
-      state.error = `端口 ${cfg.port} 已被占用且没有有效的 pid.json 记录(拒绝误杀);请释放端口或修改 port 配置`;
-      return snapshot();
     }
 
     // 重建数据目录
@@ -613,16 +704,35 @@ export async function apply(ctx, config) {
     // 安装内置扩展(dshcs-open-file:host 信号文件 → VS Code 打开文件)
     installBundledExtension(extensionsDir, userDataDir);
 
-    const args = [
-      '--bind-addr', `${cfg.host}:${cfg.port}`,
-      '--auth', auth === 'password' ? 'password' : 'none',
-      '--user-data-dir', userDataDir,
-      '--extensions-dir', extensionsDir,
-      '--disable-telemetry',
-      '--disable-update-check',
-    ];
-    if (cwd !== undefined) args.push(cwd);
+    const args = launch.kind === 'launcher'
+      ? [
+        launch.script,
+        '--tree', launch.tree,
+        '--user-data-dir', userDataDir,
+        '--extensions-dir', extensionsDir,
+        '--parent-pid', String(process.pid),
+      ]
+      : [
+        '--bind-addr', `${cfg.host}:${cfg.port}`,
+        '--auth', 'none',
+        '--user-data-dir', userDataDir,
+        '--extensions-dir', extensionsDir,
+        '--disable-telemetry',
+        '--disable-update-check',
+      ];
+    if (launch.kind === 'launcher') {
+      if (serve === 'dsh') {
+        state.pipe = pipeName();
+        args.push('--pipe', state.pipe);
+      } else {
+        state.pipe = null;
+        args.push('--port', String(cfg.port), '--host', cfg.host);
+      }
+      if (typeof cfg.locale === 'string' && cfg.locale !== '') args.push('--locale', cfg.locale);
+    }
+    if (cwd !== undefined && launch.kind !== 'launcher') args.push(cwd);
 
+    state.serve = serve;
     state.error = null;
     state.logTail = '';
     state.status = 'starting';
@@ -631,12 +741,11 @@ export async function apply(ctx, config) {
     state.adopted = false;
 
     const env = { ...process.env };
-    if (auth === 'password') env.PASSWORD = cfg.passwordToken;
     // 内置扩展信号文件路径(host → 扩展 打开文件)
     env.DSHCS_OPEN_FILE_SIGNAL = openFileSignalPath(userDataDir);
-    // pnpm 会把带 os/cpu 限定的原生包(os 限定/平台专属)嵌套装在平台聚合包下
-    // (如 <profile>/node_modules/@<scope>/dsh-code-server-runtime-<平台>-<架构>/node_modules/argon2),
-    // 那些目录不在 code-server 树的向上查找链里 → 用 NODE_PATH 让子进程的 require 找得到。
+    // pnpm 会把带 os/cpu 限定的原生包嵌套装在平台聚合包下(如 <profile>/node_modules/@<scope>/
+    // dsh-code-server-runtime-<平台>-<架构>/node_modules/@vscode/spdlog),那些目录不在 VS Code
+    // 树的向上查找链里 → 用 NODE_PATH 让子进程的 require 找得到(CJS;ESM 由 ensureAliasLinks 的 junction 负责)。
     const nodePathDirs = aliasNodePathDirs();
     if (nodePathDirs.length > 0) {
       const existing = typeof env.NODE_PATH === 'string' && env.NODE_PATH !== '' ? env.NODE_PATH.split(path.delimiter) : [];
@@ -648,8 +757,8 @@ export async function apply(ctx, config) {
       // 启动前再自愈一次依赖布局(插件重装/树被替换后可能丢失;幂等且只做存在性检查)
       ensureRuntimeLayout();
       const isCmd = launch.kind === 'bin' && win32() && /\.cmd$/i.test(launch.command);
-      const command = launch.kind === 'node' ? process.execPath : launch.command;
-      const spawnArgs = launch.kind === 'node' ? [launch.script, ...args] : args;
+      const command = launch.kind === 'bin' ? launch.command : process.execPath;
+      const spawnArgs = launch.kind === 'bin' ? args : [launch.script, ...args];
       // shell 仅对 .cmd shim(Windows npm 全局包)必要:它必须经 cmd.exe 解析。
       // 含空格路径由 spawn 数组传参,不再经 shell 拼接,避免 'C:\Program' 拆分。
       proc = spawn(isCmd ? `"${command}"` : command, spawnArgs, {
@@ -671,10 +780,12 @@ export async function apply(ctx, config) {
       pid: proc.pid,
       startedAt: state.startedAt,
       cwd: cwd ?? null,
-      host: cfg.host,
-      port: cfg.port,
+      host: serve === 'dsh' ? null : cfg.host,
+      port: serve === 'dsh' ? null : cfg.port,
+      serve,
+      pipe: state.pipe,
       launchKind: launch.kind,
-      launchCommand: launch.kind === 'node' ? launch.script : launch.command,
+      launchCommand: launch.kind === 'bin' ? launch.command : launch.script,
     });
 
     proc.stdout?.on?.('data', appendLog);
@@ -721,8 +832,8 @@ export async function apply(ctx, config) {
   /** 环境问题的一句话描述(状态卡/日志共用)。 */
   function describeEnvProblem(env) {
     const parts = [];
-    if (env.entry === null) parts.push('缺少包内 vendor/code-server/out/node/entry.js');
-    if (env.native !== true) parts.push('argon2 原生模块缺失(当前平台无预编译产物)');
+    if (env.tree === null) parts.push(`缺少 VS Code 树(包内 vendor/vscode 或 dshcs-vscode-server 未安装)`);
+    else if (env.entry === null) parts.push('树里缺少 lib/vscode/out/server-main.js');
     if (env.vscodeInner !== true) {
       const missing = Array.isArray(env.innerDeps?.missing) ? env.innerDeps.missing : [];
       parts.push(`内部依赖未装全(缺 ${missing.length} 个:${missing.slice(0, 5).join(', ')}${missing.length > 5 ? ' …' : ''})`);
@@ -822,16 +933,9 @@ export async function apply(ctx, config) {
     }
   }
 
-  const connection = ctx.get('connection');
-  if (connection === undefined || connection.fetch === undefined) {
-    console.error('[code-server] connection service unavailable; plugin registered but idle');
-    return;
-  }
-
   // 每条操作一条 exact Fetch 路由。desktop 的 assetHandler 只把 /api/* 交给
   // createSharedFetchHandler('/api'),所以路径必须落在 /api 下。
-  const disposers = [
-    { path: `${API_BASE}/status`, methods: ['GET'], fetch: handleStatus },
+  const disposers = [    { path: `${API_BASE}/status`, methods: ['GET'], fetch: handleStatus },
     { path: `${API_BASE}/start`, methods: ['POST'], fetch: handleStart },
     { path: `${API_BASE}/stop`, methods: ['POST'], fetch: handleStop },
     { path: `${API_BASE}/setup`, methods: ['POST'], fetch: handleSetup },
@@ -880,12 +984,7 @@ export async function apply(ctx, config) {
   }
 
   state.env = envCheck();
-  // 补齐 code-server 树里被"拍平"掉的依赖布局:
-  //   ① VS Code 内部依赖目录(lib/vscode/node_modules、lib/vscode/extensions/node_modules)
-  //      —— 老模型是 npm 装在树里的真实目录,新模型拍平在 profile 根;用显式路径找依赖的代码
-  //      (如内置 TS 扩展找 tsserver.js)否则会报 "tsserver was deleted …";
-  //   ② 聚合包带回的原生别名(ESM import 不认 NODE_PATH,只能靠目录链)。
-  const layout = ensureRuntimeLayout();
+  // layout 已在本函数开头算过(envCheck 之前):这里只报告结果。
   if (layout.created.length > 0) {
     console.log(`[code-server] 已补齐 ${layout.created.length} 个依赖链接: ${layout.created.join(', ')}`);
   }
@@ -893,10 +992,10 @@ export async function apply(ctx, config) {
     console.warn(`[code-server] 依赖链接创建失败: ${layout.failed.join('; ')}`);
   }
   if (!vendorReady()) {
-    console.warn(`[code-server] 找不到 code-server 运行树:平台子包 ${codeServerPackageName()} 未安装,`
-      + '且包内 vendor/code-server 不存在(开发期请先 `npm run vendor:code-server`)');
+    console.warn(`[code-server] 找不到 VS Code 树:平台无关包 ${codeServerPackageName()} 未安装,`
+      + '且包内 vendor/vscode 不存在(开发期请先 `node scripts/vendor-vscode-server.mjs --dev-links`)');
   } else {
-    console.log(`[code-server] code-server 运行树: ${codeServerRoot()}`);
+    console.log(`[code-server] VS Code 树: ${vsRoot()}(productPath=${state.env.productPath ?? '?'})`);
   }
   if (!state.env.ok) {
     console.warn(`[code-server] 环境未就绪: ${describeEnvProblem(state.env)}`);
@@ -906,10 +1005,12 @@ export async function apply(ctx, config) {
     console.log(`[code-server] 检测到旧版安装根 ${legacyRoot}(0.1.35 及更早遗留,已不再使用,可安全删除)`);
   }
 
-  // DSH host 重启后 adopt:pid.json 有效且进程存活且 /healthz 响应 → 接管
-  if (liveInstance) {
+  // DSH host 重启后 adopt(仅 loopback 模式):pid.json 有效且进程存活且 /healthz 响应 → 接管。
+  // dsh 模式的 launcher 带 --parent-pid 看门狗:host 一退出它就自行退出,不存在可接管的孤儿。
+  if (liveInstance && (record.serve !== 'dsh')) {
     const probe = await healthCheck(cfg.host, cfg.port, 800);
     if (probe.ok) {
+      state.serve = 'loopback';
       state.status = 'running';
       state.pid = record.pid;
       state.cwd = record.cwd ?? null;
@@ -919,9 +1020,11 @@ export async function apply(ctx, config) {
     } else {
       removePidFile(cfg);
     }
+  } else if (liveInstance) {
+    removePidFile(cfg); // 上次是 dsh 模式(管道随进程消失)→ 清理陈旧记录
   }
 
   maybePrestart();
 
-  console.log(`[code-server] static plugin loaded (host=${cfg.host} port=${cfg.port} auth=${cfg.auth})`);
+  console.log(`[code-server] static plugin loaded (serve=${requestedServe()} host=${cfg.host} port=${cfg.port})`);
 }