@mobius-os/mobius 0.3.42 → 0.3.43

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mobius-os/mobius",
-  "version": "0.3.42",
+  "version": "0.3.43",
   "type": "module",
   "description": "Mobius terminal client. Reuses Mobius frontend TypeScript types and jsonl entry shapes.",
   "bin": {
@@ -8,21 +8,13 @@
     "mobius-tui": "bin/mobius-tui.js"
   },
   "scripts": {
-    "dev": "tsx src/main.tsx",
-    "start": "tsx src/main.tsx",
-    "typecheck": "tsc --noEmit",
-    "test:integration": "tsx tests/integration.test.ts",
-    "test:ui": "tsx tests/ui.test.tsx",
-    "test:flow": "tsx tests/flow.test.tsx",
-    "test:resume": "tsx tests/resume.test.tsx",
-    "test:aimux": "tsx tests/aimux.test.tsx",
-    "test:reconnect": "tsx tests/reconnect.test.tsx",
-    "test:screen": "FORCE_COLOR=1 tsx tests/screen.test.tsx",
-    "test:scroll": "tsx tests/scroll.test.tsx",
-    "test:viewport": "tsx tests/viewport.test.ts",
-    "test:selection": "FORCE_COLOR=1 tsx tests/selection.test.tsx",
-    "test": "npm run typecheck && npm run test:ui && npm run test:integration"
+    "start": "tsx src/main.tsx"
   },
+  "files": [
+    "bin",
+    "src",
+    "README.md"
+  ],
   "dependencies": {
     "chalk": "^5.3.0",
     "cli-highlight": "2.1.11",
@@ -33,16 +25,7 @@
     "tsx": "4.19.2",
     "wrap-ansi": "^9.0.0"
   },
-  "devDependencies": {
-    "@types/node": "18.19.34",
-    "@types/react": "18.3.3",
-    "ink-testing-library": "4.0.0",
-    "typescript": "5.4.5"
-  },
   "engines": {
     "node": ">=18"
-  },
-  "publishConfig": {
-    "access": "public"
   }
 }

package/src/aimux.ts

@@ -20,6 +20,8 @@ export interface AimuxStatus {
   state: AimuxState
   phase?: AimuxPhase
   detail?: string
+  /** Runtime package version when known; falls back to the bundled version. */
+  version?: string
   identifier?: string
   attempt?: number
 }
@@ -90,7 +92,9 @@ async function pythonForAimux(onProgress?: (p: InstallProgress) => void): Promis
 // 系统 python（如被精简掉 ensurepip 的容器镜像）。aimux 全部依赖为纯 Python，
 // 故三平台可共用同一套打包产物，分别按 arch 发布到 CDN。
 const BUNDLE_VER = '3'
-const BUNDLE_AIMUX_VERSION = '0.1.23'
+const BUNDLE_AIMUX_VERSION = '0.1.28'
+/** Version expected from the installed or bundled AIMUX runtime. */
+export const AIMUX_VERSION = BUNDLE_AIMUX_VERSION
 const bundleDir = () => path.join(mobiusHome(), 'python-bundle')
 const bundlePython = () => WIN
   ? path.join(bundleDir(), 'python', 'python.exe')

package/src/components/Chat.tsx

@@ -24,11 +24,12 @@ import {
 import type { ReadyState } from './PrepScreen.js'
 import type { AnyEntry } from '../types.js'
 import { ConfigFlow, ReconfigFlow, type ConfigResult } from './ConfigFlow.js'
-import type { AimuxStatus } from '../aimux.js'
+import { AIMUX_VERSION, type AimuxStatus } from '../aimux.js'
 import { AimuxStatusLine, aimuxStatusText } from './AimuxStatus.js'
 import { isEscapeKeypress, isMouseInput, useMouseEvents, useStableInput } from './primitives.js'
 import { useDeleteKeyCapture, applyDeleteIntent, clampCursor, previousCursorBoundary, nextCursorBoundary, previousWordBoundary, nextWordBoundary } from '../lib/delete-keys.js'
 import { useCursorKeyCapture } from '../lib/cursor-keys.js'
+import { usePaintFlushOnInput } from '../lib/paint-flush.js'
 
 interface ChatProps {
   client: MobiusClient
@@ -62,6 +63,7 @@ const SLASH_COMMANDS = [
   { cmd: '/config', desc: '重新选择项目、任务和模型' },
   { cmd: '/logout', desc: '断开当前连接并返回登录界面' },
   { cmd: '/help', desc: '显示帮助' },
+  { cmd: '/version', desc: '显示 TUI、AIMUX 和运行环境版本' },
   { cmd: '/quit', desc: '退出 TUI' },
 ]
 
@@ -77,6 +79,7 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
   const [reconfigOpen, setReconfigOpen] = useState(false)
   // 本地命令错误 (如无会话时 /compact): 与 chat.error 分开, 下一次提交时清除。
   const [slashError, setSlashError] = useState<string | null>(null)
+  const [versionInfo, setVersionInfo] = useState<string[] | null>(null)
   // Ink may deliver one final event to Composer while an async config picker is
   // replacing it. The shared ref lets that stale listener report "not handled"
   // so App can replay the key after the new Select mounts.
@@ -88,6 +91,9 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
   const handlerRef = useRef<{ configOpen: boolean; reconfigOpen: boolean; sessionId: string | null }>({ configOpen: false, reconfigOpen: false, sessionId: null })
   handlerRef.current = { configOpen, reconfigOpen, sessionId: chat.sessionId }
   const terminal = useTerminalSize()
+  // Paint each keystroke immediately instead of waiting out Ink's 32ms render
+  // throttle — that dead window was the typing lag users felt.
+  usePaintFlushOnInput()
 
   const runSlash = useCallback((raw: string) => {
     const [name] = raw.trim().split(/\s+/)
@@ -108,13 +114,27 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
       }
       case '/resume': onResume(); return true
       case '/help': setShowHelp(s => !s); return true
+      case '/version': {
+        const details = [
+          `TUI       v${TUI_VERSION}`,
+          `AIMUX     v${aimuxStatus?.version ?? AIMUX_VERSION}`,
+          `Node      ${process.version}`,
+          `平台      ${process.platform}/${process.arch}`,
+          `服务器    ${client.server}`,
+          `模型      ${modelLabel ?? ready.prefs.model ?? 'default'}`,
+          `AIMUX状态 ${aimuxStatus ? aimuxStatusText(aimuxStatus, true) : '未知'}`,
+        ]
+        setVersionInfo(details)
+        setShowHelp(false)
+        return true
+      }
       case '/model': setConfigOpen(true); return true
       case '/config': setReconfigOpen(true); return true
       case '/logout': onLogout(); return true
       case '/quit': case '/exit': onQuit(); return true
       default: return false
     }
-  }, [chat, onClear, onResume, onQuit, onLogout])
+  }, [aimuxStatus, chat, client.server, modelLabel, ready.prefs.model, onClear, onResume, onQuit, onLogout])
 
   const onSubmit = useCallback((text: string) => {
     const t = text.trim()
@@ -125,6 +145,7 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
       return
     }
     setShowHelp(false)
+    setVersionInfo(null)
     setRowAnchor(null)
     void chat.send(t)
   }, [chat, runSlash])
@@ -177,7 +198,7 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
     (entry) => rowsForEntry(entry),
   ), [transcriptEntries, rowsForEntry])
   const viewportRows = terminal.isTty ? Math.max(9, terminal.rows - 1) : terminal.rows
-  const activityRows = (chat.typing ? 2 : 0) + (chat.error ? 1 : 0) + (slashError ? 1 : 0)
+  const activityRows = (chat.typing ? 2 : 0) + (chat.error ? 1 : 0) + (slashError ? 1 : 0) + (versionInfo ? versionInfo.length + 2 : 0)
   const helpRows = showHelp ? SLASH_COMMANDS.length + 3 : 0
   // Conversation chrome is exactly two rows: compact header + navigation.
   const transcriptRows = Math.max(1, viewportRows - composerRows - STATUS_ROWS - activityRows - helpRows - 2)
@@ -384,6 +405,7 @@ export function ChatScreen({ client, ready, webUserId, resumeSessionId, onClear,
         {chat.typing ? <WorkingIndicator firstQuery={firstQueryInFlight} /> : null}
         {chat.error ? <Text color="red">⚠ {chat.error}</Text> : null}
         {slashError ? <Text color="red">⚠ {slashError}</Text> : null}
+        {versionInfo ? <VersionBlock lines={versionInfo} /> : null}
 
         <Composer
           onSubmit={onSubmit}
@@ -576,6 +598,15 @@ function HelpBlock({ commands }: { commands: { cmd: string; desc: string }[] })
   )
 }
 
+function VersionBlock({ lines }: { lines: string[] }) {
+  return (
+    <Box flexDirection="column" borderStyle="round" borderColor="gray" borderDimColor paddingX={1} marginTop={1}>
+      <Text bold color="cyan">Mobius 版本信息</Text>
+      {lines.map(line => <Text key={line} dimColor>{line}</Text>)}
+    </Box>
+  )
+}
+
 interface ComposerProps {
   onSubmit: (text: string) => void
   onStop: () => void

package/src/lib/paint-flush.ts

@@ -0,0 +1,223 @@
+/**
+ * Typing-latency optimizations against Ink 5.2's fixed render pipeline.
+ *
+ * Profiling a keystroke loop (node --cpu-prof) showed ~40% of typing time
+ * inside Ink's per-paint `Output.get()`:
+ *   stringWidth 13.5% + styledCharsFromTokens 12.4% + Output.get 6.4%
+ *   + styledCharsToString 5.5% + diffAnsiCodes 3.4%
+ *
+ * Every paint rebuilds the whole frame: for each write-op line it applies
+ * style transformers, tokenizes the ANSI-styled text into styled chars and
+ * re-measures widths, then walks the full cell matrix back to a string.
+ * While typing, 19 of 22 line strings are byte-identical across paints (only
+ * the composer row changes), yet all are re-tokenized every time — that
+ * repetition is the lag users feel.
+ *
+ * Two runtime patches below. Both verify Ink internals first and silently
+ * no-op on mismatch (or when MOBIUS_TUI_DISABLE_PAINT_FLUSH=1):
+ *
+ * 1. usePaintFlushOnInput — Ink hardcodes `throttle(onRender, 32ms)`. React
+ *    commits a key in <1ms; the paint can then wait out the throttle window.
+ *    On each editing key we call the throttle's `flush()` right after the
+ *    commit lands, so the frame paints in the same event-loop turn.
+ *
+ * 2. installStyledLineCache — replaces `Output.prototype.get` with a faithful
+ *    reimplementation whose only difference is memoizing
+ *    `styledCharsFromTokens(tokenize(line))` by the post-transform line
+ *    string (the exact input tokenize receives, so cached results are
+ *    byte-identical). Unchanged lines skip the tokenize+measure hot path,
+ *    which is where the profiled ~40% lives.
+ */
+
+import { useEffect } from 'react'
+import { useStdin, useStdout } from 'ink'
+
+// ── 1. flush the render throttle right after each editing key ────────────────
+
+type Flushable = { flush?: () => void }
+
+/** Text-editing inputs that should paint immediately (typed text, Enter, backspace). */
+function isEditingInput(input: string): boolean {
+  if (!input) return false
+  if (input === '\r' || input === '\n') return true
+  if (input === '\x7f' || input === '\x08') return true
+  // Anything without an ESC lead is typed text (or a paste chunk). Sequences
+  // (arrows, mouse, bracketed paste) start with ESC and keep normal pacing.
+  return !input.startsWith('\x1b')
+}
+
+export function usePaintFlushOnInput(): void {
+  const { internal_eventEmitter } = useStdin()
+  const { stdout } = useStdout()
+
+  useEffect(() => {
+    if (process.env.MOBIUS_TUI_DISABLE_PAINT_FLUSH === '1') return
+    if (!internal_eventEmitter) return
+    installStyledLineCache()
+    const handler = (chunk: unknown) => {
+      if (!isEditingInput(String(chunk))) return
+      // React schedules the commit for this key on a setImmediate (scheduler's
+      // Immediate priority). Flushing on a microtask would paint the STALE
+      // frame before that commit lands. Schedule the flush for after the
+      // commit: another setImmediate queued from here runs after the one
+      // React already queued (FIFO within the same iteration).
+      setImmediate(() => {
+        try { getThrottledRender(stdout)?.flush?.() } catch { /* best-effort */ }
+      })
+    }
+    internal_eventEmitter.on('input', handler)
+    return () => { internal_eventEmitter.off('input', handler) }
+  }, [internal_eventEmitter, stdout])
+}
+
+// ── Ink internals access ─────────────────────────────────────────────────────
+// Ink's exports map blocks subpath imports ('ink/build/instances.js' →
+// ERR_PACKAGE_PATH_NOT_EXPORTED), but `import.meta.resolve('ink')` yields the
+// package entry file URL and the internal modules live next to it in the same
+// build directory. Resolving relative to the entry keeps this working in any
+// install layout (local node_modules, global npm prefix).
+
+function inkModuleUrl(name: string): string {
+  return new URL(name, new URL('.', (import.meta as any).resolve('ink') as string)).href
+}
+
+let cachedInstances: WeakMap<object, any> | null | undefined
+
+function getThrottledRender(stdout: object): Flushable | null {
+  if (cachedInstances === undefined) {
+    cachedInstances = null
+    void import(inkModuleUrl("instances.js"))
+      .then(mod => { cachedInstances = mod.default })
+      .catch(() => { /* keep null */ })
+  }
+  try {
+    return cachedInstances?.get(stdout)?.rootNode?.onRender ?? null
+  } catch {
+    return null
+  }
+}
+
+// ── 2. memoize styled-line tokenization across paints ────────────────────────
+
+let cacheInstalled = false
+
+export function installStyledLineCache(): void {
+  if (cacheInstalled || process.env.MOBIUS_TUI_DISABLE_PAINT_FLUSH === '1') return
+  cacheInstalled = true
+  void (async () => {
+    try {
+      const [outputMod, at, widestLineMod, stringWidthMod, sliceAnsiMod]: any[] = await Promise.all([
+        import(inkModuleUrl("output.js")),
+        import('@alcalzone/ansi-tokenize'),
+        import('widest-line'),
+        import('string-width'),
+        import('slice-ansi'),
+      ])
+      const OutputClass = outputMod.default
+      const proto = OutputClass?.prototype
+      if (!proto || typeof proto.get !== 'function' || typeof proto.write !== 'function') return
+      if (typeof at.styledCharsFromTokens !== 'function' || typeof at.tokenize !== 'function') return
+      const widestLine = widestLineMod.default
+      const stringWidth = stringWidthMod.default
+      const sliceAnsi = sliceAnsiMod.default
+
+      // Fragile-internals guard: confirm the op shape this Ink version writes.
+      const probe = new OutputClass({ width: 4, height: 2 })
+      probe.write(0, 0, 'ab', { transformers: [] })
+      const op = probe.operations?.[0]
+      if (!op || op.type !== 'write' || typeof op.text !== 'string' || !Array.isArray(op.transformers)) return
+
+      const cache = new Map<string, any[]>()
+      const styledCharsOf = (line: string): any[] => {
+        const hit = cache.get(line)
+        if (hit) return hit
+        const chars = at.styledCharsFromTokens(at.tokenize(line)) as any[]
+        if (cache.size >= 4096) cache.clear() // bound memory; rebuilt lazily
+        cache.set(line, chars)
+        return chars
+      }
+
+      const origGet = proto.get
+      proto.get = function (this: any) {
+        // Faithful reimplementation of Ink 5.2.0 Output.get with one change:
+        // the tokenize+styledCharsFromTokens result is memoized by the
+        // post-transform line string. Everything else mirrors upstream.
+        const output = []
+        for (let y = 0; y < this.height; y++) {
+          const row = []
+          for (let x = 0; x < this.width; x++) {
+            row.push({ type: 'char', value: ' ', fullWidth: false, styles: [] })
+          }
+          output.push(row)
+        }
+        const clips: any[] = []
+        for (const operation of this.operations) {
+          if (operation.type === 'clip') clips.push(operation.clip)
+          if (operation.type === 'unclip') clips.pop()
+          if (operation.type !== 'write') continue
+          const { text, transformers } = operation
+          let { x, y } = operation
+          let lines = text.split('\n')
+          const clip = clips.at(-1)
+          if (clip) {
+            const clipHorizontally = typeof clip?.x1 === 'number' && typeof clip?.x2 === 'number'
+            const clipVertically = typeof clip?.y1 === 'number' && typeof clip?.y2 === 'number'
+            if (clipHorizontally) {
+              const width = widestLine(text)
+              if (x + width < clip.x1 || x > clip.x2) continue
+            }
+            if (clipVertically) {
+              const height = lines.length
+              if (y + height < clip.y1 || y > clip.y2) continue
+            }
+            if (clipHorizontally) {
+              lines = lines.map((line: string) => {
+                const from = x < clip.x1 ? clip.x1 - x : 0
+                const width = stringWidth(line)
+                const to = x + width > clip.x2 ? clip.x2 - x : width
+                return sliceAnsi(line, from, to)
+              })
+              if (x < clip.x1) x = clip.x1
+            }
+            if (clipVertically) {
+              const from = y < clip.y1 ? clip.y1 - y : 0
+              const height = lines.length
+              const to = y + height > clip.y2 ? clip.y2 - y : height
+              lines = lines.slice(from, to)
+              if (y < clip.y1) y = clip.y1
+            }
+          }
+          let offsetY = 0
+          for (const [index, line0] of lines.entries()) {
+            const currentLine = output[y + offsetY]
+            if (!currentLine) continue
+            let line = line0
+            for (const transformer of transformers) line = transformer(line, index)
+            const characters = styledCharsOf(line)
+            let offsetX = x
+            for (const character of characters) {
+              currentLine[offsetX] = character
+              const isWideCharacter = character.fullWidth || character.value.length > 1
+              if (isWideCharacter) {
+                currentLine[offsetX + 1] = {
+                  type: 'char', value: '', fullWidth: false, styles: character.styles,
+                }
+              }
+              offsetX += isWideCharacter ? 2 : 1
+            }
+            offsetY++
+          }
+        }
+        const generatedOutput = output
+          .map(line => {
+            const lineWithoutEmptyItems = line.filter((item: unknown) => item !== undefined)
+            return at.styledCharsToString(lineWithoutEmptyItems).trimEnd()
+          })
+          .join('\n')
+        return { output: generatedOutput, height: output.length }
+      }
+      // Keep a handle for tests/debugging; origGet unused beyond the guard.
+      void origGet
+    } catch { /* keep stock behavior */ }
+  })()
+}

package/install.ps1

@@ -1,265 +0,0 @@
-#requires -Version 5.1
-<#
-.SYNOPSIS
-  Mobius TUI Windows 便携安装 (自带 portable Node, 无需 admin, 不依赖 npm.ps1)
-.DESCRIPTION
-  下载 portable Node win-x64 zip 解压到 ~/.mobius/node-portable/ → 用 node.exe 直跑 npm-cli.js
-  装 @mobius-os/mobius 到 ~/.mobius/npm-global/ → 自建 mobius.cmd 启动器(绝对路径指向便携 node)
-  → 加 ~/.mobius/bin 到用户 PATH (无需 admin)。
-  npm 安装和 mobius 启动均直接使用 node.exe/tsx；安装完成后同时注册两个
-  Explorer 右键入口：“在 Mobius 中打开”（文件夹本身 + 文件夹空白处）。
-.EXAMPLE
-  irm https://serve.nutshellai.cn/publish/auto/mobiustui/install-v15.ps1 | iex
-#>
-$ErrorActionPreference = 'Stop'
-$ProgressPreference    = 'SilentlyContinue'
-
-function Step($m){ Write-Host "[*] $m" -ForegroundColor Cyan }
-function Ok($m)  { Write-Host "[OK] $m" -ForegroundColor Green }
-function Warn($m){ Write-Host "[!]  $m" -ForegroundColor Yellow }
-function Err($m) { Write-Host "[X]  $m" -ForegroundColor Red }
-function Fail($m) { throw $m }
-
-function Invoke-MobiusInstall {
-Write-Host "=== Mobius TUI Windows 便携安装 (无需 admin) ===" -ForegroundColor White
-
-$MHOME      = Join-Path $env:USERPROFILE ".mobius"
-$NODE_DIR   = Join-Path $MHOME "node-portable"
-$GLOBAL_DIR = Join-Path $MHOME "npm-global"
-$NODE_VER   = "v24.18.1"
-$ZIP_URL     = "https://serve.nutshellai.cn/publish/auto/mobius-tui/node/node-$NODE_VER-win-x64.zip"
-$NODE_SHA256 = "ec56b84a7551893ab2324ebdfdc4ab974a63b4781162600b68a1293cc3e53765"  # node v24.18.1 win-x64
-$nodeExe    = Join-Path $NODE_DIR "node.exe"
-$npmCli     = Join-Path $NODE_DIR "node_modules\npm\bin\npm-cli.js"
-
-New-Item -ItemType Directory -Force -Path $MHOME | Out-Null
-
-# --- 1. portable Node ---
-if (Test-Path $nodeExe) {
-    Ok "便携 Node 已存在: $NODE_DIR"
-} else {
-    Step "下载便携 Node $NODE_VER (~37MB), 可能需 1-2 分钟..."
-    $zip = Join-Path $MHOME "node.zip"
-    Invoke-WebRequest -Uri $ZIP_URL -OutFile $zip
-    Step "校验 sha256..."
-    $actual = (Get-FileHash $zip -Algorithm SHA256).Hash.ToLower()
-    if ($actual -ne $NODE_SHA256.ToLower()) { Fail "Node zip sha256 不匹配 (下载损坏? 期望 $NODE_SHA256 实际 $actual)" }
-    Step "解压..."
-    $tmp = Join-Path $MHOME "_extract"
-    if (Test-Path $tmp) { Remove-Item $tmp -Recurse -Force }
-    Expand-Archive -Path $zip -DestinationPath $tmp -Force
-    $inner = Join-Path $tmp "node-$NODE_VER-win-x64"
-    if (-not (Test-Path (Join-Path $inner "node.exe"))) { Fail "解压后未找到 node.exe" }
-    if (Test-Path $NODE_DIR) { Remove-Item $NODE_DIR -Recurse -Force }
-    Move-Item $inner $NODE_DIR -Force
-    Remove-Item $tmp -Recurse -Force
-    Remove-Item $zip -Force
-    Ok "便携 Node 就绪: $NODE_DIR"
-}
-
-# --- 2. npm 装 @mobius-os/mobius (node.exe 直跑 npm-cli.js, 绕过 npm.ps1 的 ExecutionPolicy 拦截) ---
-Step "npm 安装 @mobius-os/mobius@latest (本地 install 到便携目录, 官方 registry)..."
-New-Item -ItemType Directory -Force -Path $GLOBAL_DIR | Out-Null
-$oldNodeModules = Join-Path $GLOBAL_DIR "node_modules"
-$oldPackageJson = Join-Path $GLOBAL_DIR "package.json"
-for ($attempt = 1; $attempt -le 3 -and (Test-Path $oldNodeModules); $attempt++) {
-    Remove-Item $oldNodeModules -Recurse -Force -ErrorAction SilentlyContinue
-    if (Test-Path $oldNodeModules) { Start-Sleep -Milliseconds (300 * $attempt) }
-}
-if (Test-Path $oldNodeModules) {
-    Warn "请关闭正在运行的 mobius 终端后重试: $oldNodeModules"
-    Fail "无法清理旧 node_modules，可能仍有 Mobius/Node 进程占用文件"
-}
-Remove-Item $oldPackageJson -Force -ErrorAction SilentlyContinue
-$npmLog = Join-Path $MHOME "npm-install.log"
-$npmStdout = Join-Path $MHOME "npm-install.stdout.log"
-$npmStderr = Join-Path $MHOME "npm-install.stderr.log"
-$previousPath = $env:Path
-# npm lifecycle scripts use cmd.exe and resolve `node` from PATH.
-$env:Path = "$NODE_DIR;$env:Path"
-Push-Location $GLOBAL_DIR
-$previousErrorActionPreference = $ErrorActionPreference
-$ErrorActionPreference = "Continue"
-try {
-    # PowerShell 5.1 会把 npm 的 stderr warning 包装成 NativeCommandError。
-    # 合并输出并只依据原生进程退出码判定成败，避免 warning 提前终止脚本。
-    & $nodeExe $npmCli init -y 2>&1 | Out-Null
-    $initExitCode = $LASTEXITCODE
-    if ($initExitCode -ne 0) { throw "npm 初始化失败 (退出码 $initExitCode)" }
-
-    # npm 11 默认拦截 esbuild postinstall，安装前明确允许该脚本。旧 npm 会忽略该字段。
-    & $nodeExe $npmCli pkg set "allowScripts.esbuild=true" --json 2>&1 | Out-Null
-    $configExitCode = $LASTEXITCODE
-    if ($configExitCode -ne 0) { throw "配置 esbuild 安装脚本授权失败 (退出码 $configExitCode)" }
-
-    function Invoke-NpmInstallAttempt([string]$registry, [int]$timeoutSeconds) {
-        Remove-Item $npmStdout, $npmStderr -Force -ErrorAction SilentlyContinue
-        # Do not call System.Diagnostics.Process instance methods here.
-        # Windows PowerShell ConstrainedLanguage blocks those methods even
-        # though Start-Process itself is allowed. A tiny cmd wrapper records
-        # %ERRORLEVEL%; Wait-Process and taskkill remain CLM-safe.
-        $attemptCmd = Join-Path $GLOBAL_DIR 'npm-install-attempt.cmd'
-        $exitCodeFile = Join-Path $GLOBAL_DIR 'npm-install.exitcode'
-        Remove-Item $exitCodeFile -Force -ErrorAction SilentlyContinue
-        $attemptLines = @(
-            '@echo off',
-            'setlocal',
-            ('set "PATH={0};%PATH%"' -f $NODE_DIR),
-            ('"{0}" "{1}" install "@mobius-os/mobius@latest" --registry "{2}" --loglevel warn >"{3}" 2>"{4}"' -f $nodeExe, $npmCli, $registry, $npmStdout, $npmStderr),
-            'set "EXIT_CODE=%ERRORLEVEL%"',
-            ('>"{0}" echo %EXIT_CODE%' -f $exitCodeFile),
-            'exit /b %EXIT_CODE%'
-        )
-        Set-Content -Path $attemptCmd -Value $attemptLines -Encoding ASCII
-        $proc = Start-Process -FilePath $env:ComSpec -ArgumentList @('/d', '/s', '/c', ('"{0}"' -f $attemptCmd)) `
-            -WorkingDirectory $GLOBAL_DIR -PassThru -WindowStyle Hidden
-        Wait-Process -Id $proc.Id -Timeout $timeoutSeconds -ErrorAction SilentlyContinue | Out-Null
-        # Allow cmd a short moment to flush the marker after it exits, without
-        # invoking any restricted Process instance methods.
-        for ($markerAttempt = 1; $markerAttempt -le 20 -and -not (Test-Path $exitCodeFile); $markerAttempt++) {
-            Start-Sleep -Milliseconds 100
-        }
-        if (-not (Test-Path $exitCodeFile)) {
-            Warn "npm 官方源安装超过 $timeoutSeconds 秒，正在终止并切换镜像源..."
-            & $env:ComSpec /d /s /c "taskkill /PID $($proc.Id) /T /F" 2>&1 | Out-Null
-            Start-Sleep -Milliseconds 300
-            Remove-Item $attemptCmd -Force -ErrorAction SilentlyContinue
-            return @{ TimedOut = $true; ExitCode = $null }
-        }
-        $exitText = Get-Content -Path $exitCodeFile -Raw -ErrorAction SilentlyContinue
-        $exitCode = $exitText -as [int]
-        if ($null -eq $exitCode) { $exitCode = 1 }
-        Remove-Item $attemptCmd, $exitCodeFile -Force -ErrorAction SilentlyContinue
-        return @{ TimedOut = $false; ExitCode = $exitCode }
-    }
-
-    function Save-NpmAttemptLog([string]$label) {
-        Add-Content -Path $npmLog -Value "`n===== $label ====="
-        if (Test-Path $npmStdout) { Get-Content $npmStdout | Add-Content -Path $npmLog }
-        if (Test-Path $npmStderr) { Get-Content $npmStderr | Add-Content -Path $npmLog }
-    }
-
-    Remove-Item $npmLog -Force -ErrorAction SilentlyContinue
-    $official = Invoke-NpmInstallAttempt "https://registry.npmjs.org/" 10
-    Save-NpmAttemptLog "official registry.npmjs.org"
-    $npmSucceeded = (-not $official.TimedOut -and $official.ExitCode -eq 0)
-    if (-not $npmSucceeded) {
-        if ($official.TimedOut) {
-            Warn "官方源超时，切换 npmmirror 镜像源重试..."
-        } else {
-            Warn "官方源安装失败 (退出码 $($official.ExitCode))，切换 npmmirror 镜像源重试..."
-        }
-        # A timed-out npm process can leave a partial tree behind; remove only
-        # the package tree and keep the user-level install directory intact.
-        if (Test-Path $oldNodeModules) { Remove-Item $oldNodeModules -Recurse -Force -ErrorAction SilentlyContinue }
-        $mirror = Invoke-NpmInstallAttempt "https://registry.npmmirror.com/" 120
-        Save-NpmAttemptLog "mirror registry.npmmirror.com"
-        $npmSucceeded = (-not $mirror.TimedOut -and $mirror.ExitCode -eq 0)
-    }
-    if (-not $npmSucceeded) {
-        Err "npm 安装失败"
-        if (Test-Path $npmLog) {
-            Write-Host "--- npm 最近日志: $npmLog ---" -ForegroundColor Yellow
-            Get-Content $npmLog -Tail 120
-            Write-Host "--- npm 日志结束 ---" -ForegroundColor Yellow
-        }
-        Fail "npm 安装失败，完整日志: $npmLog"
-    }
-} finally {
-    $ErrorActionPreference = $previousErrorActionPreference
-    $env:Path = $previousPath
-    Pop-Location
-}
-$tsxCli = Join-Path $GLOBAL_DIR "node_modules\tsx\dist\cli.mjs"
-$esbuildExe = Join-Path $GLOBAL_DIR "node_modules\@esbuild\win32-x64\esbuild.exe"
-if (-not (Test-Path $tsxCli)) { Fail "npm 包缺少 tsx 运行时依赖，日志: $npmLog" }
-if (-not (Test-Path $esbuildExe)) { Fail "esbuild Windows 二进制未正确安装，日志: $npmLog" }
-Ok "mobius 装到: $GLOBAL_DIR"
-
-# --- 3. mobius 启动器 (.cmd batch, 用绝对路径指向便携 node, 不依赖系统 PATH/ExecutionPolicy) ---
-$binDir   = Join-Path $MHOME "bin"
-$entryJs  = Join-Path $GLOBAL_DIR "node_modules\@mobius-os\mobius\bin\mobius-tui.js"
-if (-not (Test-Path $entryJs)) { Fail "未找到 mobius 入口: $entryJs" }
-New-Item -ItemType Directory -Force -Path $binDir | Out-Null
-$mainTsx   = Join-Path $GLOBAL_DIR "node_modules\@mobius-os\mobius\src\main.tsx"
-$mobiusCmd = Join-Path $binDir "mobius.cmd"
-@"
-@echo off
-"$nodeExe" "$tsxCli" "$mainTsx" %*
-"@ | Set-Content -Path $mobiusCmd -Encoding ASCII
-Ok "启动器: $mobiusCmd"
-
-# --- 4. 用户 PATH (无需 admin) ---
-$userPath = (Get-ItemProperty -Path 'HKCU:\Environment' -Name Path -ErrorAction SilentlyContinue).Path
-if ($userPath -notlike "*$binDir*") {
-    $newPath = if ($userPath) { "$userPath;$binDir" } else { $binDir }
-    if (Test-Path 'HKCU:\Environment') {
-        Set-ItemProperty -Path 'HKCU:\Environment' -Name Path -Value $newPath
-    } else {
-        New-Item -Path 'HKCU:\Environment' -Force | Out-Null
-        New-ItemProperty -Path 'HKCU:\Environment' -Name Path -Value $newPath -PropertyType ExpandString -Force | Out-Null
-    }
-    $env:Path += ";$binDir"
-    Ok "已加入用户 PATH: $binDir (重开 PowerShell 生效)"
-} else {
-    Ok "PATH 已含: $binDir"
-}
-
-# --- 5. Explorer 右键菜单 (当前用户，无需 admin) ----------------------------
-# 两个入口必须同时注册：
-#   Directory\shell\Mobius            = 右键文件夹本身，目标参数 %1
-#   Directory\Background\shell\Mobius = 右键文件夹空白处，目标参数 %V
-# 使用 .cmd 辅助启动器，避免右键动作依赖 PowerShell ExecutionPolicy。
-$openHereCmd = Join-Path $binDir "mobius-open-here.cmd"
-$openHereLines = @(
-    '@echo off',
-    'setlocal',
-    'set "MOBIUS_TARGET=%~1"',
-    'if not defined MOBIUS_TARGET set "MOBIUS_TARGET=%CD%"',
-    'cd /d "%MOBIUS_TARGET%"',
-    'call "%~dp0mobius.cmd"',
-    'endlocal'
-)
-Set-Content -Path $openHereCmd -Value $openHereLines -Encoding ASCII
-
-$classes = "HKCU:\Software\Classes"
-$folderMenu = Join-Path $classes "Directory\shell\Mobius"
-$folderCommand = Join-Path $folderMenu "command"
-$backgroundMenu = Join-Path $classes "Directory\Background\shell\Mobius"
-$backgroundCommand = Join-Path $backgroundMenu "command"
-
-foreach ($key in @($folderCommand, $backgroundCommand)) {
-    New-Item -Path $key -Force | Out-Null
-}
-
-foreach ($menu in @($folderMenu, $backgroundMenu)) {
-    Set-ItemProperty -Path $menu -Name "MUIVerb" -Value "在 Mobius 中打开"
-    Set-ItemProperty -Path $menu -Name "Icon" -Value "$env:SystemRoot\System32\cmd.exe,0"
-}
-
-# Explorer command quoting: cmd /c ""helper.cmd" "%1"".
-$folderCommandValue = '"{0}" /d /s /c ""{1}" "%1""' -f $env:ComSpec, $openHereCmd
-$backgroundCommandValue = '"{0}" /d /s /c ""{1}" "%V""' -f $env:ComSpec, $openHereCmd
-Set-Item -Path $folderCommand -Value $folderCommandValue
-Set-Item -Path $backgroundCommand -Value $backgroundCommandValue
-Ok "右键菜单已添加: 在 Mobius 中打开 (文件夹 + 空白处)"
-
-Write-Host ""
-Write-Host "=== 完成! 重开 PowerShell 后运行:  mobius ===" -ForegroundColor Green
-Write-Host "(或直接运行: $mobiusCmd)" -ForegroundColor Gray
-Write-Host "右键文件夹或文件夹空白处，可选择: 在 Mobius 中打开" -ForegroundColor Gray
-}
-
-try {
-    Invoke-MobiusInstall
-} catch {
-    $errorLog = Join-Path $env:TEMP "mobius-install-v15-error.log"
-    $errorText = $_ | Format-List * -Force | Out-String
-    $errorText | Set-Content -Path $errorLog -Encoding UTF8
-    Write-Host ""
-    Err "Mobius 安装失败: $($_.Exception.Message)"
-    Write-Host "完整错误日志: $errorLog" -ForegroundColor Yellow
-    Write-Host $errorText -ForegroundColor DarkYellow
-    try { Read-Host "按 Enter 返回 PowerShell（窗口不会自动关闭）" | Out-Null } catch { }
-    return
-}