dsh-cliworker-now 0.7.6 → 0.7.8

package/lib/types/host/windows-desktop-cli-installation.js

@@ -0,0 +1,420 @@
+import * as nodeFs from 'node:fs';
+import { createRequire } from 'node:module';
+import { homedir } from 'node:os';
+import { win32 } from 'node:path';
+import { WindowsCliInstallationError } from "./windows-cli-installation.js";
+import { ProcessCleanupUnconfirmedError } from "./process.js";
+const label = (cli) => (cli === 'zcode' ? 'ZCode' : 'OpenCode');
+const failure = (cli, message = '桌面安装信息探测失败') => new WindowsCliInstallationError(`${label(cli)} ${message}，请配置 ${cli}Executable`);
+/** Fixed OS metadata query only. No installer, shortcut target, or user command is executed. */
+export const WINDOWS_DESKTOP_INSTALL_QUERY = String.raw `
+$ErrorActionPreference='Stop'
+[Console]::OutputEncoding=[Text.UTF8Encoding]::new($false)
+$watch=[Diagnostics.Stopwatch]::StartNew()
+$rows=[Collections.Generic.List[object]]::new()
+$complete=$true
+$seen=0
+function Bound {
+  $script:seen++
+  if($watch.ElapsedMilliseconds -gt 8000 -or $script:seen -gt 4096 -or $rows.Count -ge 128){throw 'Metadata limit'}
+}
+function Product([string]$name) {
+  if($name -match '^ZCode(?:\s.*)?$'){return 'zcode'}
+  if($name -match '^OpenCode(?:\s.*)?$'){return 'opencode'}
+  return $null
+}
+function CleanFile([string]$value,[bool]$icon) {
+  if([string]::IsNullOrWhiteSpace($value)){return $null}
+  $p=$value.Trim()
+  if($icon){$p=$p -replace ',\s*-?\d+\s*$',''}
+  if($p.StartsWith('"') -and $p.EndsWith('"')){$p=$p.Substring(1,$p.Length-2)}
+  if($p -match '[\x00-\x1f\x7f"]' -or $p -notmatch '^[A-Za-z]:[\\/]' -or $p -notmatch '\.(?:exe|ico)$'){return $null}
+  return $p
+}
+function AddRoot([string]$cli,[string]$source,[string]$value) {
+  if([string]::IsNullOrWhiteSpace($value)){return}
+  Bound
+  $p=$value.Trim().Trim('"')
+  if($p -match '[\x00-\x1f\x7f"]' -or $p -notmatch '^[A-Za-z]:[\\/]'){return}
+  $rows.Add([ordered]@{cli=$cli;source=$source;root=$p})
+}
+function AddTarget([string]$cli,[string]$source,[string]$value,[bool]$icon) {
+  $p=CleanFile $value $icon
+  if(!$p){return}
+  Bound
+  $rows.Add([ordered]@{cli=$cli;source=$source;target=$p})
+}
+$shell=$null
+try {
+  # Defaults are independent hints: deleting shortcuts/registration does not
+  # hide a complete installation left at a known vendor location.
+  if($env:LOCALAPPDATA) {
+    foreach($leaf in @('Programs\ZCode')){AddRoot 'zcode' 'default-location' (Join-Path $env:LOCALAPPDATA $leaf)}
+    foreach($leaf in @('Programs\@opencodedesktop','Programs\OpenCode','OpenCode')){AddRoot 'opencode' 'default-location' (Join-Path $env:LOCALAPPDATA $leaf)}
+  }
+  foreach($baseDir in @($env:ProgramFiles,[Environment]::GetEnvironmentVariable('ProgramFiles(x86)'))) {
+    if($baseDir){AddRoot 'zcode' 'default-location' (Join-Path $baseDir 'ZCode');AddRoot 'opencode' 'default-location' (Join-Path $baseDir 'OpenCode')}
+  }
+  foreach($hive in @([Microsoft.Win32.RegistryHive]::CurrentUser,[Microsoft.Win32.RegistryHive]::LocalMachine)) {
+    foreach($view in @([Microsoft.Win32.RegistryView]::Registry64,[Microsoft.Win32.RegistryView]::Registry32)) {
+      Bound
+      $base=[Microsoft.Win32.RegistryKey]::OpenBaseKey($hive,$view)
+      try {
+        $uninstall=$base.OpenSubKey('Software\Microsoft\Windows\CurrentVersion\Uninstall')
+        if($uninstall) {
+          try {
+            foreach($name in $uninstall.GetSubKeyNames()) {
+              Bound
+              $key=$uninstall.OpenSubKey($name)
+              if(!$key){continue}
+              try {
+                $cli=Product ([string]$key.GetValue('DisplayName'))
+                if(!$cli){continue}
+                AddRoot $cli 'uninstall-location' ([string]$key.GetValue('InstallLocation'))
+                AddTarget $cli 'uninstall-icon' ([string]$key.GetValue('DisplayIcon')) $true
+              } finally {$key.Dispose()}
+            }
+          } finally {$uninstall.Dispose()}
+        }
+        foreach($entry in @(@('zcode','ZCode.exe'),@('opencode','OpenCode.exe'),@('opencode','opencode-cli.exe'))) {
+          Bound
+          $key=$base.OpenSubKey('Software\Microsoft\Windows\CurrentVersion\App Paths\'+$entry[1])
+          if(!$key){continue}
+          try {AddTarget $entry[0] 'app-path' ([string]$key.GetValue('')) $false} finally {$key.Dispose()}
+        }
+      } finally {$base.Dispose()}
+    }
+  }
+  # Read only image paths of exact product names, never arguments or accounts.
+  foreach($process in @(Get-Process -Name 'ZCode','OpenCode','OpenCode Beta','OpenCode Dev','OpenCode Desktop','OpenCode-Beta','OpenCode-Dev','OpenCode-Desktop' -ErrorAction SilentlyContinue)) {
+    Bound
+    $target=[string]$process.Path
+    if($target){AddTarget $(if($process.ProcessName -ieq 'ZCode'){'zcode'}else{'opencode'}) 'running-process' $target $false}
+  }
+  $shell=New-Object -ComObject Shell.Application
+  $queue=[Collections.Generic.Queue[object]]::new()
+  $visited=[Collections.Generic.HashSet[string]]::new([StringComparer]::OrdinalIgnoreCase)
+  foreach($folder in @('StartMenu','CommonStartMenu','DesktopDirectory','CommonDesktopDirectory')) {
+    $path=[Environment]::GetFolderPath([Environment+SpecialFolder]::$folder)
+    $maxDepth=if($folder -match 'StartMenu'){4}else{0}
+    if($path -and $visited.Add($path)){$queue.Enqueue(@($path,0,$maxDepth))}
+  }
+  while($queue.Count -gt 0) {
+    Bound
+    if($visited.Count -gt 256){throw 'Directory limit'}
+    $entry=$queue.Dequeue();$directory=[IO.DirectoryInfo]::new([string]$entry[0]);$depth=[int]$entry[1];$maxDepth=[int]$entry[2]
+    if(!$directory.Exists -or ($directory.Attributes -band [IO.FileAttributes]::ReparsePoint)){continue}
+    foreach($item in $directory.GetFileSystemInfos()) {
+      Bound
+      if($item.Attributes -band [IO.FileAttributes]::ReparsePoint){continue}
+      if($item -is [IO.DirectoryInfo]) {
+        if($depth -lt $maxDepth -and $visited.Add($item.FullName)){$queue.Enqueue(@($item.FullName,$depth+1,$maxDepth))}
+        # Only known shell folders and their bounded descendants are searched.
+        continue
+      }
+      if($item.Extension -ine '.lnk'){continue}
+      $cli=Product $item.BaseName
+      if(!$cli){continue}
+      $folder=$null;$linkItem=$null;$link=$null
+      try {
+        $folder=$shell.Namespace($directory.FullName)
+        if(!$folder){throw 'Shortcut metadata unavailable'}
+        $linkItem=$folder.ParseName($item.Name)
+        if(!$linkItem -or !$linkItem.IsLink){throw 'Shortcut metadata unavailable'}
+        $link=$linkItem.GetLink
+        $target=CleanFile ([string]$link.Path) $false
+        $name=if($target){[IO.Path]::GetFileName($target)}else{''}
+        if(($cli -eq 'zcode' -and $name -ieq 'ZCode.exe') -or ($cli -eq 'opencode' -and $name -match '^(?:OpenCode(?:[ -](?:Beta|Dev|Desktop))?|opencode-cli)\.exe$')) {
+          AddTarget $cli 'shortcut' $target $false
+        }
+      } finally {
+        foreach($com in @($link,$linkItem,$folder)){if($com -and [Runtime.InteropServices.Marshal]::IsComObject($com)){[void][Runtime.InteropServices.Marshal]::FinalReleaseComObject($com)}}
+      }
+    }
+  }
+} catch {$complete=$false}
+finally {if($shell -and [Runtime.InteropServices.Marshal]::IsComObject($shell)){[void][Runtime.InteropServices.Marshal]::FinalReleaseComObject($shell)}}
+$json=[ordered]@{schema=1;complete=$complete;records=@($rows.ToArray())}|ConvertTo-Json -Depth 5 -Compress
+if([Text.Encoding]::UTF8.GetByteCount($json) -gt 65536){$json='{"schema":1,"complete":false,"records":[]}'}
+[Console]::WriteLine($json)
+`;
+let physicalFiles;
+/** Installation identity is about disk files, not Electron's virtual ASAR tree. */
+function physicalFs() {
+    return (physicalFiles ??= process.versions.electron
+        ? createRequire(import.meta.url)('original-fs')
+        : nodeFs);
+}
+function ordinary(path) {
+    const { statSync, accessSync, constants, realpathSync } = physicalFs();
+    try {
+        const info = statSync(path);
+        if (!info.isFile() || !info.size)
+            throw new Error('Invalid file');
+        accessSync(path, constants.R_OK);
+        return realpathSync(path);
+    }
+    catch (error) {
+        if (['ENOENT', 'ENOTDIR'].includes(error.code))
+            return undefined;
+        throw error;
+    }
+}
+function directory(path) {
+    const { statSync, realpathSync } = physicalFs();
+    try {
+        return statSync(path).isDirectory() ? realpathSync(path) : undefined;
+    }
+    catch (error) {
+        if (['ENOENT', 'ENOTDIR'].includes(error.code))
+            return undefined;
+        throw error;
+    }
+}
+function pe(path) {
+    const canonical = ordinary(path);
+    if (!canonical)
+        return undefined;
+    const { openSync, fstatSync, readSync, closeSync } = physicalFs();
+    const fd = openSync(canonical, 'r');
+    try {
+        const info = fstatSync(fd), head = Buffer.alloc(64), signature = Buffer.alloc(4);
+        if (readSync(fd, head, 0, 64, 0) !== 64 || head.toString('ascii', 0, 2) !== 'MZ')
+            throw new Error('Invalid PE');
+        const offset = head.readUInt32LE(0x3c);
+        if (offset < 64 ||
+            offset + 4 > info.size ||
+            readSync(fd, signature, 0, 4, offset) !== 4 ||
+            signature.toString('hex') !== '50450000')
+            throw new Error('Invalid PE');
+        return canonical;
+    }
+    finally {
+        closeSync(fd);
+    }
+}
+const files = { ordinaryFile: ordinary, directory, peFile: pe };
+const contained = (root, entry, path) => {
+    const relative = path.relative(root.toLowerCase(), entry.toLowerCase());
+    return (!!relative && !path.isAbsolute(relative) && relative !== '..' && !relative.startsWith('..' + path.sep));
+};
+function safePath(value, path) {
+    if (typeof value !== 'string' ||
+        !value ||
+        value.length > 2048 ||
+        /[\x00-\x1f\x7f"]/.test(value) ||
+        !path.isAbsolute(value) ||
+        (path === win32 && (!/^[A-Za-z]:[\\/]/.test(value) || /^[\\/]{2}/.test(value))) ||
+        value.split(/[\\/]/).includes('..'))
+        throw new Error('Invalid path');
+    return path.normalize(value);
+}
+function iconPath(value, path) {
+    if (typeof value !== 'string')
+        throw new Error('Invalid path');
+    let target = value.trim().replace(/,\s*-?\d+\s*$/, '');
+    if (target.startsWith('"') && target.endsWith('"'))
+        target = target.slice(1, -1);
+    return safePath(target, path);
+}
+function installationEntries(cli, root, fs, path) {
+    const foundRoot = fs.directory(root);
+    if (!foundRoot)
+        return [];
+    const canonicalRoot = safePath(foundRoot, path);
+    const entries = [];
+    if (cli === 'zcode') {
+        const entry = fs.ordinaryFile(path.join(root, 'resources', 'glm', 'zcode.cjs'));
+        const provider = fs.ordinaryFile(path.join(root, 'resources', 'config', 'provider', 'zcode-builtin.json'));
+        if (entry &&
+            provider &&
+            contained(canonicalRoot, entry, path) &&
+            contained(canonicalRoot, provider, path))
+            entries.push(entry);
+        else if (entry || provider)
+            throw failure(cli, '桌面 CLI 配套文件不可用');
+    }
+    else {
+        for (const candidate of [
+            path.join(root, 'resources', 'opencode-cli.exe'),
+            path.join(root, 'opencode-cli.exe'),
+        ]) {
+            const entry = fs.peFile(candidate);
+            if (entry) {
+                if (!contained(canonicalRoot, entry, path))
+                    throw failure(cli, '桌面 CLI 入口被重定向');
+                entries.push(entry);
+            }
+        }
+    }
+    const desktopNames = cli === 'zcode'
+        ? ['ZCode.exe']
+        : [
+            'OpenCode.exe',
+            'OpenCode Beta.exe',
+            'OpenCode Dev.exe',
+            'OpenCode Desktop.exe',
+            'OpenCode-Beta.exe',
+            'OpenCode-Dev.exe',
+            'OpenCode-Desktop.exe',
+        ];
+    if (!entries.length && desktopNames.some((name) => fs.ordinaryFile(path.join(root, name))))
+        throw failure(cli, '桌面已存在，但没有可用独立 CLI');
+    return entries;
+}
+/** Metadata is a bounded hint, never a command or an account source. */
+export function windowsDesktopCliFromMetadata(cli, raw, options = {}) {
+    const path = options.path ?? win32, fs = options.files ?? files;
+    try {
+        if (Buffer.byteLength(raw, 'utf8') > 65536)
+            throw new Error('Metadata limit');
+        const value = JSON.parse(raw.replace(/^\uFEFF/, '').trim());
+        if (!value ||
+            value.schema !== 1 ||
+            value.complete !== true ||
+            !Array.isArray(value.records) ||
+            value.records.length > 128)
+            throw new Error('Invalid metadata');
+        const roots = new Map();
+        for (const record of value.records) {
+            if (!record ||
+                typeof record !== 'object' ||
+                Array.isArray(record) ||
+                !['zcode', 'opencode'].includes(record.cli) ||
+                ![
+                    'uninstall-location',
+                    'uninstall-icon',
+                    'app-path',
+                    'shortcut',
+                    'default-location',
+                    'running-process',
+                ].includes(record.source) ||
+                Object.keys(record).some((key) => !['cli', 'source', 'root', 'target'].includes(key)))
+                throw new Error('Invalid metadata');
+            if (record.cli !== cli)
+                continue;
+            let root;
+            if (record.root !== undefined &&
+                record.target === undefined &&
+                ['uninstall-location', 'default-location'].includes(record.source))
+                root = safePath(record.root, path);
+            else if (record.target !== undefined &&
+                record.root === undefined &&
+                !['uninstall-location', 'default-location'].includes(record.source)) {
+                const target = iconPath(record.target, path), name = path.basename(target).toLowerCase();
+                if (record.source === 'uninstall-icon') {
+                    if (!/\.(?:exe|ico)$/i.test(name))
+                        throw new Error('Invalid icon');
+                }
+                else if (cli === 'zcode'
+                    ? name !== 'zcode.exe'
+                    : !/^(?:opencode(?:[ -](?:beta|dev|desktop))?|opencode-cli)\.exe$/.test(name))
+                    throw new Error('Invalid target');
+                root = path.dirname(target);
+                if (cli === 'opencode' && name === 'opencode-cli.exe') {
+                    if (path.basename(root).toLowerCase() === 'resources')
+                        root = path.dirname(root);
+                }
+            }
+            else
+                throw new Error('Invalid metadata');
+            roots.set(root.toLowerCase(), root);
+        }
+        const candidates = [];
+        let incomplete;
+        for (const root of roots.values()) {
+            try {
+                candidates.push(...installationEntries(cli, root, fs, path));
+            }
+            catch (error) {
+                // An old desktop missing its companion CLI must not hide a complete
+                // installation. Read/access errors still fail the overall discovery.
+                if (!(error instanceof WindowsCliInstallationError))
+                    throw error;
+                incomplete ??= error;
+            }
+        }
+        const unique = new Map(candidates.map((entry) => [entry.toLowerCase(), entry]));
+        if (unique.size > 1)
+            throw failure(cli, '发现多个可用安装');
+        if (!unique.size && incomplete)
+            throw incomplete;
+        return [...unique.values()][0];
+    }
+    catch (error) {
+        if (error instanceof WindowsCliInstallationError)
+            throw error;
+        throw failure(cli);
+    }
+}
+export async function findWindowsDesktopCli(cli, capture, signal, env = process.env) {
+    signal.throwIfAborted();
+    const root = env.SystemRoot || env.WINDIR || 'C:\\Windows';
+    let raw;
+    try {
+        const command = win32.join(safePath(root, win32), 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
+        raw = await capture([
+            command,
+            '-NoLogo',
+            '-NoProfile',
+            '-NonInteractive',
+            '-EncodedCommand',
+            Buffer.from(WINDOWS_DESKTOP_INSTALL_QUERY, 'utf16le').toString('base64'),
+        ], homedir());
+    }
+    catch (error) {
+        if (error instanceof ProcessCleanupUnconfirmedError)
+            throw error;
+        signal.throwIfAborted();
+        throw failure(cli);
+    }
+    signal.throwIfAborted();
+    return windowsDesktopCliFromMetadata(cli, raw);
+}
+/** Do not treat a PATH/explicit Desktop GUI as the command-line binary. */
+export function windowsOpenCodeDesktopCli(executable, explicit = false, options = {}) {
+    const path = options.path ?? win32, fs = options.files ?? files;
+    if (!/^opencode(?:[ -](?:beta|dev|desktop))?\.exe$/i.test(path.basename(executable)))
+        return undefined;
+    const root = path.dirname(executable);
+    try {
+        const marker = fs.ordinaryFile(path.join(root, 'resources', 'app.asar'));
+        // Old Tauri bundles place a CLI alongside their GUI. The GUI PE subsystem
+        // must confirm that case; a standalone console opencode.exe is unchanged.
+        let legacyGui = false;
+        if (!marker && fs.ordinaryFile(executable)) {
+            const { openSync, readSync, closeSync } = physicalFs();
+            const fd = openSync(executable, 'r');
+            try {
+                const head = Buffer.alloc(64), kind = Buffer.alloc(2), signature = Buffer.alloc(4);
+                if (readSync(fd, head, 0, 64, 0) === 64 && head.toString('ascii', 0, 2) === 'MZ') {
+                    const peOffset = head.readUInt32LE(0x3c), offset = peOffset + 24 + 68;
+                    legacyGui =
+                        peOffset >= 64 &&
+                            readSync(fd, signature, 0, 4, peOffset) === 4 &&
+                            signature.toString('hex') === '50450000' &&
+                            readSync(fd, kind, 0, 2, offset) === 2 &&
+                            kind.readUInt16LE(0) === 2;
+                }
+            }
+            finally {
+                closeSync(fd);
+            }
+        }
+        if (!marker && !legacyGui)
+            return undefined;
+        if (explicit)
+            throw failure('opencode', '执行路径指向桌面主程序');
+        const entries = installationEntries('opencode', root, fs, path);
+        const unique = new Map(entries.map((entry) => [entry.toLowerCase(), entry]));
+        if (unique.size !== 1)
+            throw failure('opencode', unique.size ? '发现多个可用安装' : '桌面已存在，但没有可用独立 CLI');
+        return [...unique.values()][0];
+    }
+    catch (error) {
+        if (error instanceof WindowsCliInstallationError)
+            throw error;
+        throw failure('opencode', '桌面 CLI 入口不可用');
+    }
+}
+//# sourceMappingURL=windows-desktop-cli-installation.js.map

package/lib/types/host/windows-desktop-cli-installation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows-desktop-cli-installation.js","sourceRoot":"","sources":["../../../src/host/windows-desktop-cli-installation.ts"],"names":[],"mappings":"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"}

package/lib/types/host/windows-hidden-launch.mjs

@@ -0,0 +1,51 @@
+// A GUI-subsystem Electron root avoids Windows Terminal's console delegation.
+// The enclosing Harness Job still owns this root and every native descendant.
+import { Socket } from 'node:net'
+import { forwardNativeStdio, spawnNativeProcess } from './native-spawn.mjs'
+
+// Pinned Harness 0.2.0-rc.2 public control contract. This helper must remain
+// self-contained: an ordinary child does not use the Host's SDK module loader.
+const marker = process.env.DSH_SUBPROCESS_CONTROL
+delete process.env.DSH_SUBPROCESS_CONTROL
+if (marker !== 'pipe') throw new Error('Windows background control channel is unavailable')
+// Receipts are write-only. Reading this inherited Windows pipe keeps a read
+// operation alive after the receipt flush and prevents the relay from exiting.
+const control = new Socket({ fd: 7, readable: false, writable: true, allowHalfOpen: true })
+let child, sent = false
+function receipt(value) {
+  if (sent) return
+  sent = true
+  control.end(JSON.stringify(value) + '\n', () => control.destroy())
+}
+control.on('error', () => {
+  child?.kill('SIGTERM')
+  process.exitCode = 1
+})
+try {
+  const [encoded, executable, ...argv] = process.argv.slice(2)
+  const restore = JSON.parse(encoded)
+  if (!restore || !Object.hasOwn(restore, 'nodeEnv') ||
+      (restore.nodeEnv !== null && typeof restore.nodeEnv !== 'string') || !executable)
+    throw new Error('Invalid fixed bootstrap arguments')
+  if (restore.privateUmask === true) process.umask(0o077)
+  // ELECTRON_RUN_AS_NODE belongs only to this GUI bootstrap. Preserve the
+  // original target environment, including an explicit deletion of that value.
+  const env = { ...process.env }
+  for (const key of Object.keys(env))
+    if (key.toUpperCase() === 'ELECTRON_RUN_AS_NODE') delete env[key]
+  if (restore.nodeEnv !== null) env.ELECTRON_RUN_AS_NODE = restore.nodeEnv
+  child = spawnNativeProcess(executable, argv, { env, stdio: ['pipe', 'pipe', 'pipe'], detached: false })
+  forwardNativeStdio(child)
+  child.once('error', error => receipt({
+    kind: 'spawn-error',
+    code: ['ENOENT', 'EACCES', 'ENOEXEC', 'EINVAL'].includes(error.code) ? error.code : 'UNKNOWN',
+  }))
+  // A descendant may keep these pipes open after the native parent exits.
+  // Report its actual exit now; keep forwarding bytes until the pipes close.
+  // The Host's original Job remains responsible for the entire process range.
+  child.once('exit', (exitCode, signal) => receipt({ kind: 'exit', exitCode, signal }))
+  for (const signal of ['SIGTERM', 'SIGINT'])
+    process.on(signal, () => child.kill(signal))
+} catch {
+  receipt({ kind: 'spawn-error', code: 'UNKNOWN' })
+}

package/lib/types/host/windows-hidden-process.d.ts

@@ -0,0 +1,12 @@
+import type { SubprocessHandle, SubprocessSpawnSpec } from '@deepseek-ai/dsh-subprocess';
+import type { ProcessBackend } from './process.ts';
+export declare const isCurrentWindowsRuntime: (value: string) => boolean;
+/** Only console-subsystem targets need a GUI bootstrap. Existing Node helpers
+ * already use Electron's GUI executable; terminal allocation stays untouched. */
+export declare function needsWindowsHiddenLaunch(argv: readonly string[], platform: NodeJS.Platform, electron: boolean): boolean;
+/** Window presentation only: all byte streams, collection and process-range
+ * ownership remain the SDK's. Native exit facts travel over a private channel,
+ * never stdout/stderr and never the native CLI's credential/session protocol. */
+export declare function spawnWindowsHidden(backend: ProcessBackend, spec: SubprocessSpawnSpec, options?: {
+    privateUmask?: true;
+}): SubprocessHandle;

package/lib/types/host/windows-hidden-process.js

@@ -0,0 +1,116 @@
+import { win32 } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const failure = () => new Error('Windows 后台 CLI 启动回执异常');
+const bootstrap = fileURLToPath(new URL('./windows-hidden-launch.mjs', import.meta.url));
+export const isCurrentWindowsRuntime = (value) => win32.normalize(value).toLowerCase() === win32.normalize(process.execPath).toLowerCase();
+/** Only console-subsystem targets need a GUI bootstrap. Existing Node helpers
+ * already use Electron's GUI executable; terminal allocation stays untouched. */
+export function needsWindowsHiddenLaunch(argv, platform, electron) {
+    return platform === 'win32' && electron && !isCurrentWindowsRuntime(argv[0]);
+}
+function nodeEnvironment(env) {
+    let value;
+    for (const [key, entry] of Object.entries(process.env))
+        if (key.toUpperCase() === 'ELECTRON_RUN_AS_NODE')
+            value = entry;
+    for (const [key, entry] of Object.entries(env ?? {}))
+        if (key.toUpperCase() === 'ELECTRON_RUN_AS_NODE')
+            value = entry;
+    return value ?? null;
+}
+/** Window presentation only: all byte streams, collection and process-range
+ * ownership remain the SDK's. Native exit facts travel over a private channel,
+ * never stdout/stderr and never the native CLI's credential/session protocol. */
+export function spawnWindowsHidden(backend, spec, options = {}) {
+    // Current plugin calls do not use this channel. Never silently take a future
+    // consumer's control protocol or downgrade to an unhidden spawn.
+    if (spec.stdio.control)
+        throw new Error('Windows 后台 CLI 启动不能复用已占用的控制通道');
+    const inner = backend.spawn({
+        ...spec,
+        argv: [process.execPath, bootstrap, JSON.stringify({ nodeEnv: nodeEnvironment(spec.env), ...options }), ...spec.argv],
+        env: { ...spec.env, ELECTRON_RUN_AS_NODE: '1' },
+        stdio: { ...spec.stdio, control: 'pipe' },
+    });
+    let cancelled = false, bytes = 0, raw = '', invalid = false;
+    const channel = inner.control;
+    if (!channel)
+        inner.terminate();
+    // Attach readers immediately so a fast metadata process cannot fill a pipe.
+    const reading = channel ? new Promise((resolve) => {
+        channel.on('data', (chunk) => {
+            bytes += Buffer.byteLength(chunk);
+            if (bytes > 1024) {
+                invalid = true;
+                channel.destroy();
+                inner.terminate();
+            }
+            else
+                raw += String(chunk);
+        });
+        channel.once('error', () => { invalid = true; inner.terminate(); resolve(); });
+        channel.once('end', resolve);
+        channel.once('close', resolve);
+    }) : Promise.resolve();
+    // A native parent can exit while its descendants retain stdout/stderr. The
+    // GUI relay must remain alive to forward those bytes, so its exit cannot be
+    // used as the native process's completion signal. Keep range exit on the SDK.
+    const outerDone = inner.done.then(async (outer) => {
+        let timer;
+        try {
+            await Promise.race([reading, new Promise((_, reject) => {
+                    timer = setTimeout(() => reject(failure()), 1000);
+                })]);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        return outer;
+    });
+    void outerDone.catch(() => inner.terminate());
+    const done = (async () => {
+        try {
+            if (!channel) {
+                await inner.done;
+                throw failure();
+            }
+            const outer = await Promise.race([reading.then(() => undefined), outerDone]);
+            if (cancelled || spec.signal?.aborted)
+                return await inner.done;
+            if (invalid || (outer && (outer.exitCode !== 0 || outer.signal)))
+                throw failure();
+            const value = JSON.parse(raw);
+            if (!value || typeof value !== 'object' || Array.isArray(value))
+                throw failure();
+            if (value.kind === 'spawn-error' && ['ENOENT', 'EACCES', 'ENOEXEC', 'EINVAL', 'UNKNOWN'].includes(value.code))
+                throw Object.assign(new Error('Windows 后台 CLI 无法启动'), { code: value.code });
+            if (value.kind !== 'exit' ||
+                !(value.exitCode === null || (Number.isInteger(value.exitCode) && value.exitCode >= -2147483648 && value.exitCode <= 4294967295)) ||
+                !(value.signal === null || (typeof value.signal === 'string' && /^SIG[A-Z0-9]+$/.test(value.signal))) ||
+                (value.exitCode === null) === (value.signal === null))
+                throw failure();
+            return { exitCode: value.exitCode, signal: value.signal };
+        }
+        catch (error) {
+            inner.terminate();
+            if (error instanceof SyntaxError)
+                throw failure();
+            throw error;
+        }
+        finally {
+            channel?.destroy();
+        }
+    })();
+    void done.catch(() => undefined);
+    return {
+        stdin: inner.stdin,
+        stdout: inner.stdout,
+        stderr: inner.stderr,
+        collected: inner.collected,
+        control: undefined,
+        done,
+        terminate: () => { cancelled = true; channel?.destroy(); inner.terminate(); },
+        waitForExit: (signal) => inner.waitForExit(signal),
+    };
+}
+//# sourceMappingURL=windows-hidden-process.js.map

package/lib/types/host/windows-hidden-process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"windows-hidden-process.js","sourceRoot":"","sources":["../../../src/host/windows-hidden-process.ts"],"names":[],"mappings":"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"}

package/lib/types/host/zcode-adapter.js

@@ -43,10 +43,14 @@ export function managedZCodeEntry(home = homedir()) {
 }
 function builtinPath(executable, builtin) {
     const adjacent = join(dirname(executable), 'provider/zcode-builtin.json');
+    // Both Desktop bundles keep glm/zcode.cjs next to config/provider resources.
+    const bundled = join(dirname(executable), '../config/provider/zcode-builtin.json');
     const config = builtin ??
         (existsSync(adjacent)
             ? adjacent
-            : '/Applications/ZCode.app/Contents/Resources/config/provider/zcode-builtin.json');
+            : existsSync(bundled)
+                ? bundled
+                : '/Applications/ZCode.app/Contents/Resources/config/provider/zcode-builtin.json');
     if (!existsSync(config))
         throw new Error('请配置与 ZCode CLI 配套的 zcodeBuiltinConfig');
     return config;