dsh-code-server-app 0.1.32 → 0.1.37

package/lib/index.js

@@ -6,7 +6,7 @@
  *   - exports.name    = 插件名(与 cordis.patch.yml 行 id 一致)
  *   - exports.inject  = ['connection', 'settings'](connection 承载 client↔host 通道)
  *   - apply(ctx, config) 在共享 /api 通道注册 5 条 exact Fetch 路由:
- *     status / start / stop / setup / open-file
+ *     status / start / stop / setup(兼容空操作) / open-file
  *
  * 通道选择(重要):**不依赖 webServer**。路由经 ctx.connection.fetch.register
  * 挂在 Connection 服务的共享 /api 通道上:
@@ -38,6 +38,17 @@ import * as os from 'node:os';
 import * as http from 'node:http';
 import { fileURLToPath } from 'node:url';
 import { createRequire } from 'node:module';
+import {
+  PACKAGE_ROOT,
+  codeServerEntry,
+  codeServerPackageName,
+  codeServerRoot,
+  legacyInstallRoot,
+  readTreeVersion,
+  vendoredVersion,
+  vendorReady,
+} from './vendor.js';
+import { resolveRuntime, runtimePackageName, verifyNatives } from './native.js';
 
 // schemastery 由 DSH 部署自带(官方核心依赖),仿 auto-open-web 的解析策略:
 // 常规 import 优先,不可用时回退到全局 npm 布局的 DSH 部署副本。
@@ -76,9 +87,6 @@ export const Config = z.object({
   /** windowedOpen=false(默认)点击悬浮球打开内部浮动窗口;
    *  true 时改为在浏览器新标签页打开 code-server(自动启动并跟随工作区)。 */
   windowedOpen: z.boolean().default(false),
-  /** installGuideDismissed=false(默认)环境未就绪时弹出安装指引;
-   *  true = 用户已永久关闭安装指引(不再弹出;设置卡可重新打开)。 */
-  installGuideDismissed: z.boolean().default(false),
 });
 
 const DEFAULT_CONFIG = {
@@ -121,22 +129,24 @@ function win32() {
   return process.platform === 'win32';
 }
 
-/** 插件自带 code-server 入口探测,兼容两种依赖布局:
- *   1. profile 专用目录:profileRoot/.code-server-app/node_modules/code-server/...
- *      (方案 D 默认安装位,独立项目、避开 profile 依赖树冲突);
- *   2. 包内:插件目录/node_modules/code-server/...(开发期 link:/独立 npm install 布局)。
+/** 插件自带 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。 */
 function bundledRuntimeEntry() {
   try {
-    const here = path.dirname(fileURLToPath(import.meta.url)); // .../dsh-code-server-app/lib 或 .../dsh-code-server/lib
+    const entry = codeServerEntry(); // 子包优先,其次包内 vendor
+    if (entry !== null) return entry;
+    const here = path.dirname(fileURLToPath(import.meta.url)); // .../dsh-code-server-app/lib
     const candidates = [
-      // profile 专用目录:here=.../dsh-code-server/lib → ../..=node_modules → ../../..=profile根
       path.join(here, '..', '..', '..', '.code-server-app', 'node_modules', 'code-server', 'out', 'node', 'entry.js'),
-      // 包内(dev link / 独立目录):here=.../lib → ../node_modules
       path.join(here, '..', 'node_modules', 'code-server', 'out', 'node', 'entry.js'),
     ];
-    for (const entry of candidates) {
-      if (fs.existsSync(entry)) return entry;
+    for (const candidate of candidates) {
+      if (fs.existsSync(candidate)) return candidate;
     }
     return null;
   } catch {
@@ -193,26 +203,73 @@ function openFileSignalPath(userDataDir) {
   return path.join(userDataDir, 'User', 'dshcs-open.json');
 }
 
-/** 环境检测:code-server 入口 + 原生模块 + VS Code 内部依赖 是否就绪。
- * 返回 { ok, entry, native, vscodeInner, node, platform, arch, pathToSetup }。 */
+/** 插件 package.json 里声明的内部依赖(纯 JS 直装集)。 */
+function declaredInnerDeps() {
+  try {
+    const manifest = JSON.parse(fs.readFileSync(path.join(PACKAGE_ROOT, 'package.json'), 'utf8'));
+    return Object.keys(manifest.dependencies ?? {});
+  } catch {
+    return [];
+  }
+}
+
+/** 从 code-server 运行位置解析内部依赖(与运行时同一套向上查找规则)。 */
+function checkInnerDeps() {
+  const declared = declaredInnerDeps();
+  const root = codeServerRoot();
+  const from = createRequire(path.join(root ?? PACKAGE_ROOT, 'package.json'));
+  const missing = [];
+  let resolved = 0;
+  for (const name of declared) {
+    try {
+      from.resolve(name);
+      resolved += 1;
+    } catch {
+      missing.push(name);
+    }
+  }
+  return { declared: declared.length, resolved, missing };
+}
+
+/** 环境检测:code-server 入口 + 原生模块(argon2) + 内部依赖 + 预编译原生包。
+ * 返回 { ok, entry, native, vscodeInner, innerDeps, codeServer, vendored, upToDate, nativeRuntime, node, platform, arch }。 */
 function envCheck() {
   const entry = bundledRuntimeEntry();
   const csRoot = entry ? path.dirname(path.dirname(path.dirname(entry))) : null; // .../code-server
-  const nativeOk = csRoot !== null && (
-    fs.existsSync(path.join(csRoot, 'node_modules', 'argon2', 'build', 'Release', 'argon2.node')) ||
-    fs.existsSync(path.join(csRoot, 'node_modules', 'argon2', 'prebuilds'))
+  const argon2 = csRoot !== null ? path.join(csRoot, 'node_modules', 'argon2') : null;
+  // 必须按当前平台判定: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 innerOk = csRoot !== null &&
-    fs.existsSync(path.join(csRoot, 'lib', 'vscode', 'node_modules'));
+  const inner = checkInnerDeps();
+  const runtime = resolveRuntime();
+  const natives = verifyNatives(runtime !== null ? runtime.modules : []);
+  const installed = csRoot !== null ? readTreeVersion(csRoot) : null;
+  const vendored = vendoredVersion();
   return {
-    ok: entry !== null && nativeOk && innerOk,
+    ok: entry !== null && nativeOk && inner.missing.length === 0
+      && runtime !== null && natives.missing.length === 0,
     entry: entry !== null ? entry.replace(/\\/g, '/') : null,
     native: nativeOk,
-    vscodeInner: innerOk,
+    vscodeInner: inner.missing.length === 0,
+    innerDeps: { declared: inner.declared, resolved: inner.resolved, missing: inner.missing },
+    codeServer: installed,
+    vendored,
+    upToDate: installed !== null && vendored !== null && installed === vendored,
+    // 本平台预编译原生产物(平台聚合包 + 它带回原始名字的原生模块)
+    nativeRuntime: runtime !== null
+      ? {
+        name: runtime.name,
+        source: 'package',
+        version: runtime.version,
+        packages: natives.resolved.length,
+        missing: natives.missing,
+      }
+      : { name: runtimePackageName(), source: null, version: null, packages: 0, missing: [] },
     node: process.version,
     platform: process.platform,
     arch: process.arch,
-    pathToSetup: path.join(path.dirname(fileURLToPath(import.meta.url)), '..', 'scripts', 'setup-code-server.mjs').replace(/\\/g, '/'),
   };
 }
 
@@ -244,9 +301,9 @@ function resolveLaunch(config) {
     return { kind: 'bin', command: out.split('\n')[0].trim() };
   } catch {
     throw new Error(
-      `code-server 未找到("${preferred}" 不在 PATH)。请安装最新版并确保可执行: ` +
-      `npm install -g code-server@latest(Windows 原生需配套最新版 node-gyp 与 VS Spectre 缓解库),` +
-      `或在 cordis.patch.yml 的 code-server config 中把 bin 指向已安装的 code-server 可执行文件 / out/node/entry.js。`,
+      `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。`,
     );
   }
 }
@@ -294,7 +351,6 @@ export async function apply(ctx, config) {
   const settingsSvc = ctx.get('settings');
   let reserveComposer = true;
   let windowedOpen = false;
-  let installGuideDismissed = false;
   if (settingsSvc !== undefined && typeof settingsSvc.register === 'function') {
     try {
       const scope = settingsSvc.register(SETTINGS_NS, Config);
@@ -303,7 +359,6 @@ 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;
-        installGuideDismissed = resolved && typeof resolved.installGuideDismissed === 'boolean' ? resolved.installGuideDismissed : false;
       }
       scope.watch((next) => {
         if (next != null && typeof next.reserveComposer === 'boolean') {
@@ -314,10 +369,6 @@ export async function apply(ctx, config) {
           windowedOpen = next.windowedOpen;
           console.log(`[code-server] windowedOpen updated: ${windowedOpen}`);
         }
-        if (next != null && typeof next.installGuideDismissed === 'boolean') {
-          installGuideDismissed = next.installGuideDismissed;
-          console.log(`[code-server] installGuideDismissed updated: ${installGuideDismissed}`);
-        }
       });
     } catch (error) {
       console.error(`[code-server] settings unavailable; using defaults (reserveComposer=true, windowedOpen=false): ${error.message}`);
@@ -334,8 +385,8 @@ export async function apply(ctx, config) {
     logTail: '',
     startedAt: null,
     adopted: false,
-    env: envCheck(), // 环境检测(code-server 入口/native/内部依赖)
-    setup: { running: false, done: false, ok: false, logTail: '', startedAt: null, finishedAt: null }, // 环境安装任务
+    env: envCheck(), // 环境检测(code-server 入口/native/内部依赖/预编译原生包)
+    setup: { running: false, done: true, ok: true, logTail: '0.1.36 起由包管理器安装依赖,无需「安装环境」步骤', startedAt: null, finishedAt: null }, // 兼容旧客户端
   };
 
   let child = null;
@@ -359,7 +410,6 @@ export async function apply(ctx, config) {
       adopted: state.adopted,
       reserveComposer,
       windowedOpen,
-      installGuideDismissed,
       env: state.env,
       setup: {
         running: state.setup.running,
@@ -371,14 +421,13 @@ export async function apply(ctx, config) {
     };
   }
 
-  /** 读 setup 失败标记文件(按需安装失败时写入;成功则不存在)→ 用户可查看。
-   *  标记在安装根:<profile>\.code-server-app\last-setup-error.json。 */
+  /** 读旧版(≤0.1.35)环境安装失败标记文件;新版不再有安装步骤 → 通常为 null。
+   *  标记在旧安装根:<profile>\.code-server-app\last-setup-error.json。 */
   function readLastSetupError() {
     try {
-      const here = path.dirname(fileURLToPath(import.meta.url));
-      // 插件目录 <profile>\node_modules\<name> 向上两级 = <profile> 根
-      const profileRoot = path.join(here, '..', '..');
-      const marker = path.join(profileRoot, '.code-server-app', 'last-setup-error.json');
+      const root = legacyInstallRoot();
+      if (root === null) return null;
+      const marker = path.join(root, 'last-setup-error.json');
       if (!fs.existsSync(marker)) return null;
       const raw = fs.readFileSync(marker, 'utf8');
       const j = JSON.parse(raw);
@@ -634,39 +683,38 @@ export async function apply(ctx, config) {
     return snapshot();
   }
 
-  /** 后台启动环境安装(setup 脚本):npm 自装 code-server + native + vscode 内部依赖。
-   * 异步运行,进度经 status.setup 轮询返回;完成后刷新 envCheck。 */
-  function startSetup() {
-    if (state.setup.running) return;
-    const script = envCheck().pathToSetup;
-    state.setup = { running: true, done: false, ok: false, logTail: '', startedAt: Date.now(), finishedAt: null };
-    let proc;
-    try {
-      proc = spawn(process.execPath, [script], {
-        stdio: ['ignore', 'pipe', 'pipe'],
-        windowsHide: true,
-      });
-    } catch (err) {
-      state.setup = { running: false, done: true, ok: false, logTail: `spawn 失败: ${err.message}`, startedAt: Date.now(), finishedAt: Date.now() };
-      return;
-    }
-    const onChunk = (chunk) => {
-      try {
-        const text = typeof chunk === 'string' ? chunk : chunk.toString('utf8');
-        state.setup.logTail = (state.setup.logTail + text).slice(-LOG_TAIL_MAX * 2);
-      } catch { /* ignore */ }
+  /** 0.1.36 起没有「安装环境」步骤:code-server 随插件包发布,内部依赖与预编译原生模块
+   *  都由包管理器在 `dsh plugin add` 时装好。这里只做一次重新自检(兼容旧客户端的按钮)。 */
+  function refreshEnv() {
+    state.env = envCheck();
+    state.setup = {
+      running: false,
+      done: true,
+      ok: state.env.ok,
+      logTail: state.env.ok
+        ? '环境已就绪(依赖由包管理器安装,无需安装步骤)'
+        : `环境未就绪:${describeEnvProblem(state.env)}`,
+      startedAt: null,
+      finishedAt: Date.now(),
     };
-    proc.stdout?.on?.('data', onChunk);
-    proc.stderr?.on?.('data', onChunk);
-    proc.on('error', (err) => {
-      state.setup = { ...state.setup, running: false, done: true, ok: false, logTail: state.setup.logTail + `\nspawn 错误: ${err.message}`, finishedAt: Date.now() };
-      state.env = envCheck();
-    });
-    proc.on('exit', (code) => {
-      state.setup = { ...state.setup, running: false, done: true, ok: code === 0, finishedAt: Date.now() };
-      state.env = envCheck();
-      console.log(`[code-server] setup finished code=${code} env.ok=${state.env.ok}`);
-    });
+    return state.setup;
+  }
+
+  /** 环境问题的一句话描述(状态卡/日志共用)。 */
+  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.vscodeInner !== true) {
+      const missing = Array.isArray(env.innerDeps?.missing) ? env.innerDeps.missing : [];
+      parts.push(`内部依赖未装全(缺 ${missing.length} 个:${missing.slice(0, 5).join(', ')}${missing.length > 5 ? ' …' : ''})`);
+    }
+    if (env.nativeRuntime !== null && env.nativeRuntime.source === null) {
+      parts.push(`平台预编译包未安装(${env.nativeRuntime.name})`);
+    } else if (Array.isArray(env.nativeRuntime?.missing) && env.nativeRuntime.missing.length > 0) {
+      parts.push(`原生模块解析失败:${env.nativeRuntime.missing.slice(0, 5).join(', ')}`);
+    }
+    return parts.length > 0 ? parts.join('; ') : '未知问题';
   }
 
   // ---- /api/code-server 路由(Connection 共享通道;web 与 desktop 通用) ----
@@ -724,14 +772,14 @@ export async function apply(ctx, config) {
 
   async function handleSetup() {
     try {
-      // 环境安装:后台执行 setup 脚本(npm 自装 code-server + native + vscode 内部依赖)
-      if (state.setup.running) {
-        // 已在安装中:同样视为"已发起"(客户端会轮询 setup 状态直至结束)
-        return jsonResponse({ ...snapshot(), ok: true, message: '环境安装已在进行中,请等待完成', error: null });
-      }
-      startSetup();
-      // 安装任务已启动;服务态 error(如未安装)不掩盖安装态
-      return jsonResponse({ ...snapshot(), ok: true });
+      // 兼容旧客户端:0.1.36 起没有安装步骤,这里只重新自检并返回结果。
+      const setup = refreshEnv();
+      return jsonResponse({
+        ...snapshot(),
+        ok: true,
+        message: setup.ok ? '环境已就绪,无需安装' : `环境未就绪:${setup.logTail}`,
+        error: null,
+      });
     } catch (err) {
       return failureResponse(err);
     }
@@ -800,9 +848,36 @@ export async function apply(ctx, config) {
     };
   }, 'code-server: lifecycle');
 
-  // DSH host 重启后 adopt:pid.json 有效且进程存活且 /healthz 响应 → 接管
+  // ---- 环境自检:code-server 就在插件目录里就地运行,依赖由包管理器装好,无任何安装步骤 ----
   const record = readPidFile(cfg);
-  if (record && isAlive(record.pid)) {
+  const liveInstance = record !== undefined && record !== null && isAlive(record.pid);
+
+  function maybePrestart() {
+    // 环境就绪且未运行 → 后台自动拉起(不等待),悬浮球打开时 iframe 立即加载。
+    if (state.env.ok && state.status !== 'running' && state.status !== 'starting') {
+      start().catch((err) => {
+        console.error('[code-server] prestart failed:', err && err.message ? err.message : String(err));
+      });
+    }
+  }
+
+  state.env = envCheck();
+  if (!vendorReady()) {
+    console.warn(`[code-server] 找不到 code-server 运行树:平台子包 ${codeServerPackageName()} 未安装,`
+      + '且包内 vendor/code-server 不存在(开发期请先 `npm run vendor:code-server`)');
+  } else {
+    console.log(`[code-server] code-server 运行树: ${codeServerRoot()}`);
+  }
+  if (!state.env.ok) {
+    console.warn(`[code-server] 环境未就绪: ${describeEnvProblem(state.env)}`);
+  }
+  const legacyRoot = legacyInstallRoot();
+  if (legacyRoot !== null && fs.existsSync(legacyRoot)) {
+    console.log(`[code-server] 检测到旧版安装根 ${legacyRoot}(0.1.35 及更早遗留,已不再使用,可安全删除)`);
+  }
+
+  // DSH host 重启后 adopt:pid.json 有效且进程存活且 /healthz 响应 → 接管
+  if (liveInstance) {
     const probe = await healthCheck(cfg.host, cfg.port, 800);
     if (probe.ok) {
       state.status = 'running';
@@ -816,13 +891,7 @@ export async function apply(ctx, config) {
     }
   }
 
-  // ---- 预启动:环境就绪且未运行 → 后台自动拉起(不等待) ----
-  // 悬浮球打开时若已 running,iframe 立即加载(消除冷启动等待)。
-  if (state.env.ok && state.status !== 'running' && state.status !== 'starting') {
-    start().catch((err) => {
-      console.error('[code-server] prestart failed:', err && err.message ? err.message : String(err));
-    });
-  }
+  maybePrestart();
 
   console.log(`[code-server] static plugin loaded (host=${cfg.host} port=${cfg.port} auth=${cfg.auth})`);
 }

package/lib/native.js

@@ -0,0 +1,86 @@
+// lib/native.js — 平台聚合包(预编译原生模块)的定位与校验。
+//
+// 模型(0.1.36 起):VS Code 内部依赖里那批「pnpm 拒绝安装」的原生包(node-pty /
+// @vscode/sqlite3 / kerberos / koffi / ssh2 / cpu-features / @parcel/watcher /
+// @vscode/windows-* …)在打包期由 scripts/vendor-repacks.mjs 重打包成
+// @<scope>/dshcs-<名字>[-<平台>-<架构>],再由平台聚合包
+//   @<scope>/dsh-code-server-runtime-<平台>-<架构>
+// 用 npm: 别名把它们装回**原始名字**。聚合包挂在插件 package.json 的
+// optionalDependencies 上(os/cpu 限定)→ pnpm 一条命令按架构自动选中。
+//
+// 本模块只做两件事:
+//   1. 找到本平台聚合包(以及它的依赖清单 = 期望可解析的原生模块名);
+//   2. 从 code-server 运行位置出发校验这些模块是否真的能 require 到。
+import { createRequire } from 'node:module';
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { PACKAGE_ROOT, codeServerRoot, profileRootOf } from './vendor.js';
+
+const require_ = createRequire(import.meta.url);
+
+/** 平台目录名,如 win32-arm64。 */
+export function platformKey(platform = process.platform, arch = process.arch) {
+  return `${platform}-${arch}`;
+}
+
+/** 本平台聚合包名(取插件 optionalDependencies 中匹配 <平台>-<架构> 的那个)。 */
+export function runtimePackageName(platform = process.platform, arch = process.arch) {
+  const key = platformKey(platform, arch);
+  try {
+    const pkg = JSON.parse(readFileSync(join(PACKAGE_ROOT, 'package.json'), 'utf8'));
+    const declared = { ...(pkg.optionalDependencies ?? {}), ...(pkg.dependencies ?? {}) };
+    const hit = Object.keys(declared).find((name) => /^@[^/]+\/dsh-code-server-runtime-/.test(name) && name.endsWith(`-${key}`));
+    if (hit !== undefined) return hit;
+  } catch { /* 回退默认 scope */ }
+  return `@jinsiyu/dsh-code-server-runtime-${key}`;
+}
+
+/** 定位已安装的平台聚合包。
+ *  @returns {{name:string, version:string|null, root:string, modules:string[]}|null} */
+export function resolveRuntime() {
+  const name = runtimePackageName();
+  const candidates = [];
+  try {
+    candidates.push(dirname(require_.resolve(`${name}/package.json`)));
+  } catch { /* 未安装 */ }
+  const profileRoot = profileRootOf();
+  for (const root of [join(PACKAGE_ROOT, 'node_modules'), profileRoot !== null ? join(profileRoot, 'node_modules') : null, PACKAGE_ROOT]) {
+    if (root !== null) candidates.push(join(root, name));
+  }
+  for (const root of candidates) {
+    const manifestPath = join(root, 'package.json');
+    if (!existsSync(manifestPath)) continue;
+    try {
+      const manifest = JSON.parse(readFileSync(manifestPath, 'utf8'));
+      const modules = Object.keys({ ...(manifest.dependencies ?? {}), ...(manifest.optionalDependencies ?? {}) });
+      return { name, version: typeof manifest.version === 'string' ? manifest.version : null, root, modules };
+    } catch { /* 尝试下一个 */ }
+  }
+  return null;
+}
+
+/** 从 code-server 运行位置校验原生模块能否解析(与运行时同一套向上查找规则)。
+ *  先试 `<name>/package.json`(ESM-only 包没有 require 入口,如 @microsoft/mxc-sdk),
+ *  再退回 `<name>` 本身。
+ *  @param {string[]} modules 期望的原生模块名(通常来自聚合包依赖清单)
+ *  @returns {{resolved:string[], missing:string[]}} */
+export function verifyNatives(modules) {
+  // 锚点 = code-server 运行根(平台子包内的 code-server/ 或包内 vendor);
+  // 从它向上:自带 node_modules → 插件 node_modules → <profile>/node_modules。
+  const from = createRequire(join(codeServerRoot() ?? PACKAGE_ROOT, 'package.json'));
+  const resolved = [];
+  const missing = [];
+  for (const name of modules) {
+    let ok = false;
+    for (const spec of [`${name}/package.json`, name]) {
+      try {
+        from.resolve(spec);
+        ok = true;
+        break;
+      } catch { /* 试下一个 */ }
+    }
+    if (ok) resolved.push(name);
+    else missing.push(name);
+  }
+  return { resolved, missing };
+}

package/lib/vendor.js

@@ -0,0 +1,107 @@
+// lib/vendor.js — 内置 code-server 产物的路径工具(host 与脚本共用)。
+//
+// 模型(0.1.37 起):
+//   - code-server 本体 + 它自己的运行时依赖(约 232MB 解包)打成**平台专属子包**发布:
+//       @<scope>/dshcs-code-server-<platform>-<arch>@<code-server 版本>
+//     (os/cpu 限定,挂在插件 optionalDependencies 上 → pnpm 按架构自动选中);
+//     子包内布局:<pkg>/code-server/{out,lib/vscode,node_modules,…};
+//   - VS Code 内部依赖(约 1GB)与需编译的原生模块仍由包管理器安装:
+//       纯 JS 部分写在插件 package.json 的 dependencies;
+//       pnpm 拒绝安装的原生包由 scripts/vendor-repacks.mjs 重打包成 @<scope>/dshcs-*,
+//       再由平台聚合包 @<scope>/dsh-code-server-runtime-<platform>-<arch> 用 npm: 别名装回原名字;
+//   - 插件包内 `vendor/code-server/` 只作为**开发期/兼容**回退(0.1.37 起不再随包发布)。
+import { createRequire } from 'node:module';
+import { existsSync, readFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const here = dirname(fileURLToPath(import.meta.url)); // <pkg>/lib
+const require_ = createRequire(import.meta.url);
+export const PACKAGE_ROOT = resolve(here, '..');
+/** 包内 code-server 树(0.1.36 及更早随包发布;现在仅开发期/兼容回退)。 */
+export const VENDOR_TREE = join(PACKAGE_ROOT, 'vendor', 'code-server');
+const VENDOR_META = join(PACKAGE_ROOT, 'vendor', 'VENDOR.json');
+/** 旧版安装根目录名(0.1.35 及更早);仅用于迁移提示。 */
+export const APP_DIR_NAME = '.code-server-app';
+
+/** <profile> 根;插件不在 profile 布局(开发期独立目录)时返回 null。 */
+export function profileRootOf() {
+  const profileRoot = resolve(PACKAGE_ROOT, '..', '..');
+  const isProfile = existsSync(join(profileRoot, 'node_modules')) && existsSync(join(profileRoot, 'package.json'));
+  return isProfile ? profileRoot : null;
+}
+
+/** 旧版安装根(<profile>\.code-server-app);存在时提示可删除。 */
+export function legacyInstallRoot() {
+  const profileRoot = profileRootOf();
+  return profileRoot !== null ? join(profileRoot, APP_DIR_NAME) : null;
+}
+
+/** 本平台 code-server 子包名:优先取插件 optionalDependencies 里匹配 <平台>-<架构> 的声明。 */
+export function codeServerPackageName(platform = process.platform, arch = process.arch) {
+  const key = `${platform}-${arch}`;
+  try {
+    const manifest = JSON.parse(readFileSync(join(PACKAGE_ROOT, 'package.json'), 'utf8'));
+    const declared = { ...(manifest.optionalDependencies ?? {}), ...(manifest.dependencies ?? {}) };
+    const hit = Object.keys(declared).find((name) => /dshcs-code-server-/.test(name) && name.endsWith(`-${key}`));
+    if (hit !== undefined) return hit;
+  } catch { /* 回退默认 scope */ }
+  return `@jinsiyu/dshcs-code-server-${key}`;
+}
+
+/** code-server 运行根(优先依赖安装的平台子包,其次包内 vendor)。
+ *  @returns {string|null} 绝对路径,如 <profile>\node_modules\@jinsiyu\dshcs-code-server-win32-arm64\code-server */
+export function codeServerRoot() {
+  const name = codeServerPackageName();
+  try {
+    const manifest = require_.resolve(`${name}/package.json`);
+    const root = join(dirname(manifest), 'code-server');
+    if (existsSync(join(root, 'out', 'node', 'entry.js'))) return root;
+  } catch { /* 子包未安装 */ }
+  if (existsSync(join(VENDOR_TREE, 'out', 'node', 'entry.js'))) return VENDOR_TREE;
+  return null;
+}
+
+/** code-server 入口脚本(out/node/entry.js);不可用时返回 null。 */
+export function codeServerEntry() {
+  const root = codeServerRoot();
+  return root !== null ? join(root, 'out', 'node', 'entry.js') : null;
+}
+
+/** code-server 运行根(旧名,脚本/调用方沿用)。 */
+export function codeServerTarget() {
+  return codeServerRoot();
+}
+
+export function readTreeVersion(dir) {
+  try {
+    const manifest = JSON.parse(readFileSync(join(dir, 'package.json'), 'utf8'));
+    return typeof manifest.version === 'string' ? manifest.version : null;
+  } catch {
+    return null;
+  }
+}
+
+/** 内置产物元数据(vendor/VENDOR.json;打包期写入,随包发布)。 */
+export function readVendorMeta() {
+  try {
+    const meta = JSON.parse(readFileSync(VENDOR_META, 'utf8'));
+    return meta !== null && typeof meta === 'object' ? meta : null;
+  } catch {
+    return null;
+  }
+}
+
+/** 内置 code-server 版本(VENDOR.json 优先,回退树内 package.json)。 */
+export function vendoredVersion() {
+  const meta = readVendorMeta();
+  if (meta !== null && typeof meta.codeServerVersion === 'string' && meta.codeServerVersion !== '') {
+    return meta.codeServerVersion;
+  }
+  return readTreeVersion(VENDOR_TREE);
+}
+
+/** code-server 是否可用(平台子包已安装或包内 vendor 在位)。 */
+export function vendorReady() {
+  return codeServerRoot() !== null;
+}