@mobius-os/mobius 0.3.42 → 0.3.45

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/src/sse.ts

@@ -15,8 +15,10 @@ import type { AnyEntry } from './types.js'
 export interface SseHandlers {
   onOpen?: () => void
   onSubscribed?: (session: any) => void
-  onHistoryEntries?: (entries: AnyEntry[], done: boolean) => void
-  onEntry?: (entry: AnyEntry) => void
+  /** ③ 新组元数据 (开轮卡本身随随后的 entries 事件到达). */
+  onGroupCreated?: (group: any) => void
+  /** ③ 组条目增量: version = 应用该批后的组版本 (调用方水位线判据). */
+  onEntries?: (payload: { group_id: string; group_id_version: number; entries: AnyEntry[] }) => void
   onTyping?: (active: boolean) => void
   onError?: (message: string, category?: string) => void
   onClose?: () => void
@@ -105,11 +107,15 @@ export class SseConnection {
     const ev = p?.event ?? eventName
     switch (ev) {
       case 'subscribed': this.handlers.onSubscribed?.(p.session); break
-      case 'jsonl_history':
-        this.handlers.onHistoryEntries?.(p.entries ?? [], !!p.done)
+      case 'group_created':
+        this.handlers.onGroupCreated?.(p.group)
         break
-      case 'jsonl_entry':
-        this.handlers.onEntry?.(p.entry)
+      case 'entries':
+        this.handlers.onEntries?.({
+          group_id: String(p.group_id ?? ''),
+          group_id_version: Number(p.group_id_version) || 0,
+          entries: Array.isArray(p.entries) ? p.entries : [],
+        })
         break
       case 'typing':
         this.handlers.onTyping?.(!!p.active)
@@ -119,7 +125,7 @@ export class SseConnection {
         this.handlers.onError?.(p.message ?? p.error ?? '未知错误', p.category)
         break
       default:
-        // history / jsonl_meta / message / stream / etc. — currently unused by the TUI.
+        // history / message / stream / etc. — currently unused by the TUI.
         break
     }
   }

package/src/types.ts

@@ -193,14 +193,23 @@ export interface ResourceAccess {
 // ════════════════════════════════════════════════════════════════════════════
 export type AnyEntry = Record<string, any>
 
+// ── agent-history 组元数据 (协议 ① 的载荷) ───────────────────────────────────
+export interface HistoryGroup {
+  id: string
+  seq: number
+  opener_ts: string | null
+  user_summary: string
+  version: number
+  entry_count: number
+}
+
 // ── SSE envelope events (GET /api/sessions/:id/events) ───────────────────────
 // Each SSE frame's data is a JSON object with an `event` discriminator.
 export type SseEvent =
   | { event: 'subscribed'; session: Session }
   | { event: 'history'; messages: any[]; total?: number }
-  | { event: 'jsonl_meta'; session_id: string; total?: number; total_approximate?: number; tail_count?: number; jsonl_path?: string }
-  | { event: 'jsonl_history'; reset?: boolean; done?: boolean; chunk_index?: number; count?: number; entries: AnyEntry[] }
-  | { event: 'jsonl_entry'; session_id: string; entry: AnyEntry }
+  | { event: 'group_created'; session_id: string; group: HistoryGroup }
+  | { event: 'entries'; session_id: string; group_id: string; group_id_version: number; entries: AnyEntry[] }
   | { event: 'typing'; active: boolean }
   | { event: 'error'; message?: string; category?: string }
   | { event: 'server_error'; message?: string }

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
-}