@aiyiran/myclaw 1.0.122 → 1.0.124

package/assets/myclaw-tts.js

@@ -3,12 +3,12 @@
  * MyClaw TTS — 讯飞语音合成
  * ============================================================================
  *
- * 功能：拦截 chat-tts-btn 按钮，点击后使用讯飞 TTS 播放消息
+ * 功能：在每条消息的 .chat-group-footer 左侧注入播放按钮，用文字显示状态
  *
  * 状态：
- *   idle      → 默认状态，显示小嘴巴 emoji
- *   generating → 合成中，显示加载动画
- *   playing   → 播放中，显示喇叭 emoji，点击可停止
+ *   idle       → 默认，显示"播放"
+ *   generating  → 合成中，显示"生成中"
+ *   playing    → 播放中，显示"播放中"，点击停止并回到"播放"
  *
  * 依赖：voice-output.js（讯飞 VoiceOutput SDK，需先于本脚本加载）
  * ============================================================================
@@ -18,19 +18,18 @@
 
   // ═══ 状态 ═══
   var tts = null;              // VoiceOutput 实例
-  var ttsBtnHooked = false;
-  var currentBtn = null;      // 当前正在播放的按钮
   var playerState = 'idle';   // idle | generating | playing
+  var currentBtn = null;      // 当前正在使用的按钮
 
   // ═══ 讯飞配置 ═══
   var IFLYTEK_CONFIG = {
     APPID: 'de6ec59e',
     APISecret: 'ZTA3ZDU3YjAyNDUyZGVkNjQwMGM5MWNi',
     APIKey: '37104a0463a5460d7571869324b667d5',
-    vcn: 'x4_yezi',    // 默认音色：小露（普通话女声）
+    vcn: 'x4_yezi',
   };
 
-  // ═══ 公开配置接口 ═══
+  // ═══ 公开接口 ═══
   window.MyClawTts = {
     setVcn: function (vcn) {
       IFLYTEK_CONFIG.vcn = vcn;
@@ -45,53 +44,139 @@
     },
   };
 
-  // ═══ 按钮图标 ═══
-  var ICONS = {
-    idle: '👁',      // 👁 小嘴巴
-    generating: '🔄', // 🔄 加载中
-    playing: '🔊',   // 🔊 喇叭
+  // ═══ 状态文字 ═══
+  var STATE_TEXT = {
+    idle: '播放',
+    generating: '生成中',
+    playing: '播放中',
   };
 
-  // ═══ 状态更新 ═══
-  function setPlayerState(btn, state) {
-    if (!btn) return;
-    playerState = state;
+  // ═══ 提取消息文字 ═══
+  function extractMessageText(btn) {
+    var group = btn.closest('.chat-group-messages');
+    if (!group) return '';
 
-    // 恢复原生 SVG
-    var svg = btn.querySelector('svg');
-    if (svg) {
-      svg.style.display = state === 'idle' ? '' : 'none';
-    }
+    var bubble = group.querySelector('.chat-bubble');
+    if (!bubble) return '';
 
-    // 移除所有状态 class
+    var chatText = bubble.querySelector('.chat-text');
+    if (!chatText) return '';
+
+    var text = chatText.textContent || '';
+    return text.replace(/\s+/g, ' ').trim();
+  }
+
+  // ═══ 创建按钮 ═══
+  function createTtsBtn() {
+    var btn = document.createElement('button');
+    btn.className = 'myclaw-tts-btn';
+    btn.type = 'button';
+    btn.textContent = STATE_TEXT.idle;
+    return btn;
+  }
+
+  // ═══ 更新按钮状态 ═══
+  function updateBtn(btn, state) {
+    if (!btn) return;
+    playerState = state;
+    btn.textContent = STATE_TEXT[state];
     btn.classList.remove('myclaw-tts--generating', 'myclaw-tts--playing');
 
     if (state === 'generating') {
       btn.classList.add('myclaw-tts--generating');
-      btn.title = '生成中...';
     } else if (state === 'playing') {
       btn.classList.add('myclaw-tts--playing');
-      btn.title = '点击停止';
-    } else {
-      btn.title = '朗读';
     }
   }
 
-  function updateBtnIcon(btn, state) {
-    if (!btn) return;
+  // ═══ 注入按钮到 footer ═══
+  function injectBtn(footer) {
+    // 避免重复注入
+    if (footer.querySelector('.myclaw-tts-btn')) return;
+
+    var btn = createTtsBtn();
+
+    btn.addEventListener('click', function (e) {
+      e.preventDefault();
+      e.stopPropagation();
 
-    // 移除旧的 emoji 容器
-    var oldEmoji = btn.querySelector('.myclaw-tts-icon');
-    if (oldEmoji) oldEmoji.remove();
+      var state = playerState;
+      var text = extractMessageText(btn);
 
-    // 创建 emoji 容器
-    var emoji = document.createElement('span');
-    emoji.className = 'myclaw-tts-icon';
-    emoji.innerHTML = ICONS[state];
-    emoji.style.cssText = 'display:inline-block;width:18px;height:18px;line-height:18px;text-align:center;';
+      if (!text) {
+        console.warn('[myclaw-tts] 未找到消息文字');
+        return;
+      }
 
-    // 插入到按钮最前面
-    btn.insertBefore(emoji, btn.firstChild);
+      // 正在播放时，点击停止
+      if (state === 'playing' && currentBtn === btn) {
+        console.log('[myclaw-tts] 停止播放');
+        if (tts) tts.stop();
+        updateBtn(btn, 'idle');
+        currentBtn = null;
+        return;
+      }
+
+      // 已有其他按钮在播放，先停掉
+      if (state === 'playing' && currentBtn && currentBtn !== btn) {
+        if (tts) tts.stop();
+        updateBtn(currentBtn, 'idle');
+      }
+
+      console.log('[myclaw-tts] 播放:', text.substring(0, 50) + (text.length > 50 ? '...' : ''));
+
+      currentBtn = btn;
+      updateBtn(btn, 'generating');
+
+      if (!tts) initTts();
+      if (tts) {
+        tts.onAudioEnd = function () {
+          console.log('[myclaw-tts] 播放结束');
+          if (currentBtn) {
+            updateBtn(currentBtn, 'idle');
+            currentBtn = null;
+          }
+          playerState = 'idle';
+        };
+        tts.vcn = IFLYTEK_CONFIG.vcn;
+        tts.speak(text);
+
+        // 等待合成完成进入播放状态
+        setTimeout(function () {
+          if (playerState === 'generating') {
+            updateBtn(btn, 'playing');
+          }
+        }, 150);
+      }
+    });
+
+    // 插入到 footer 最前面（左边），原有按钮保留在右边
+    footer.insertBefore(btn, footer.firstChild);
+    console.log('[myclaw-tts] ✅ 播放按钮已注入');
+  }
+
+  // ═══ 观察 footer 变化 ═══
+  function observeFooters() {
+    new MutationObserver(function (mutations) {
+      mutations.forEach(function (mutation) {
+        mutation.addedNodes.forEach(function (node) {
+          if (node.nodeType !== 1) return;
+
+          // 直接是 footer
+          if (node.classList && node.classList.contains('chat-group-footer')) {
+            injectBtn(node);
+          }
+
+          // footer 内部的子节点
+          if (node.querySelectorAll) {
+            node.querySelectorAll('.chat-group-footer').forEach(injectBtn);
+          }
+        });
+      });
+    }).observe(document.documentElement, { childList: true, subtree: true });
+
+    // 立即处理已有的 footer
+    document.querySelectorAll('.chat-group-footer').forEach(injectBtn);
   }
 
   // ═══ 初始化 TTS ═══
@@ -107,32 +192,21 @@
       APISecret: IFLYTEK_CONFIG.APISecret,
       APIKey: IFLYTEK_CONFIG.APIKey,
       vcn: IFLYTEK_CONFIG.vcn,
-      onAudio: function (audioBuffer) {
-        // console.log('[myclaw-tts] audio chunk:', audioBuffer.byteLength, 'bytes');
-      },
       onStatusChange: function (oldStatus, newStatus) {
         console.log('[myclaw-tts] status:', oldStatus, '->', newStatus);
 
-        if (!currentBtn) return;
-
-        if (newStatus === 'connecting' || newStatus === 'synthesizing') {
-          updateBtnIcon(currentBtn, 'generating');
-          setPlayerState(currentBtn, 'generating');
-        } else if (newStatus === 'idle') {
-          if (playerState === 'generating') {
-            // 合成完成但未开始播放（可能是空文字或其他错误）
-            setPlayerState(currentBtn, 'idle');
-          }
-          // playing 状态会在 audio.onended 时处理
+        if (newStatus === 'idle' && playerState === 'generating') {
+          // 合成失败或空内容
+          if (currentBtn) updateBtn(currentBtn, 'idle');
+          currentBtn = null;
         }
       },
       onError: function (err) {
         console.error('[myclaw-tts] error:', err);
         if (currentBtn) {
-          setPlayerState(currentBtn, 'idle');
-          updateBtnIcon(currentBtn, 'idle');
+          updateBtn(currentBtn, 'idle');
+          currentBtn = null;
         }
-        currentBtn = null;
         playerState = 'idle';
       },
     });
@@ -140,41 +214,41 @@
     console.log('[myclaw-tts] ✅ 讯飞 TTS SDK 已初始化');
   }
 
-  // ═══ 提取消息文字 ═══
-  function extractMessageText(ttsBtn) {
-    var group = ttsBtn.closest('.chat-group-messages');
-    if (!group) return '';
-
-    var bubble = group.querySelector('.chat-bubble');
-    if (!bubble) return '';
-
-    var chatText = bubble.querySelector('.chat-text');
-    if (!chatText) return '';
-
-    var text = chatText.textContent || '';
-    return text.replace(/\s+/g, ' ').trim();
-  }
-
-  // ═══ 注入样式 ═══
+  // ═══ 样式 ═══
   function injectStyles() {
     if (document.querySelector('#myclaw-tts-styles')) return;
     var style = document.createElement('style');
     style.id = 'myclaw-tts-styles';
     style.textContent = [
-      /* 生成中：旋转动画 */
-      '.myclaw-tts--generating {',
-      '  animation: myclaw-tts-spin 1s linear infinite;',
-      '  opacity: 0.7;',
+      /* 按钮基础样式 */
+      '.myclaw-tts-btn {',
+      '  background: rgba(59, 130, 246, 0.1);',
+      '  border: 1px solid rgba(59, 130, 246, 0.3);',
+      '  border-radius: 4px;',
+      '  color: #3b82f6;',
+      '  font-size: 12px;',
+      '  padding: 2px 8px;',
+      '  cursor: pointer;',
+      '  transition: all 0.2s;',
+      '  white-space: nowrap;',
+      '}',
+      '.myclaw-tts-btn:hover {',
+      '  background: rgba(59, 130, 246, 0.2);',
       '}',
-      '@keyframes myclaw-tts-spin {',
-      '  from { transform: rotate(0deg); }',
-      '  to { transform: rotate(360deg); }',
+      /* 生成中 */
+      '.myclaw-tts-btn.myclaw-tts--generating {',
+      '  color: #f59e0b;',
+      '  border-color: rgba(245, 158, 11, 0.4);',
+      '  background: rgba(245, 158, 11, 0.1);',
+      '  animation: myclaw-tts-blink 0.8s ease-in-out infinite;',
       '}',
-      /* 播放中：脉冲动画 */
-      '.myclaw-tts--playing {',
-      '  animation: myclaw-tts-pulse 0.8s ease-in-out infinite;',
+      /* 播放中 */
+      '.myclaw-tts-btn.myclaw-tts--playing {',
+      '  color: #10b981;',
+      '  border-color: rgba(16, 185, 129, 0.4);',
+      '  background: rgba(16, 185, 129, 0.1);',
       '}',
-      '@keyframes myclaw-tts-pulse {',
+      '@keyframes myclaw-tts-blink {',
       '  0%, 100% { opacity: 1; }',
       '  50% { opacity: 0.5; }',
       '}',
@@ -182,84 +256,12 @@
     document.head.appendChild(style);
   }
 
-  // ═══ 挂载按钮拦截 ═══
-  function hookTtsButton() {
-    if (ttsBtnHooked) return;
-    ttsBtnHooked = true;
-
-    document.addEventListener('click', function (e) {
-      var btn = e.target.closest('.chat-tts-btn');
-      if (!btn) return;
-
-      e.preventDefault();
-      e.stopPropagation();
-
-      // 如果正在播放，点击停止
-      if (playerState === 'playing' && currentBtn === btn) {
-        console.log('[myclaw-tts] 停止播放');
-        if (tts) tts.stop();
-        setPlayerState(btn, 'idle');
-        updateBtnIcon(btn, 'idle');
-        currentBtn = null;
-        playerState = 'idle';
-        return;
-      }
-
-      // 如果当前有其他按钮在播放，先停掉
-      if (playerState === 'playing' && currentBtn && currentBtn !== btn) {
-        if (tts) tts.stop();
-        setPlayerState(currentBtn, 'idle');
-        updateBtnIcon(currentBtn, 'idle');
-      }
-
-      var text = extractMessageText(btn);
-      if (!text) {
-        console.warn('[myclaw-tts] 未找到消息文字');
-        return;
-      }
-
-      console.log('[myclaw-tts] 播放:', text.substring(0, 50) + (text.length > 50 ? '...' : ''));
-
-      // 设置当前按钮和状态
-      currentBtn = btn;
-      setPlayerState(btn, 'generating');
-      updateBtnIcon(btn, 'generating');
-
-      // 拦截 onAudioEnd 来设置 playing 状态
-      if (!tts) initTts();
-      if (tts) {
-        tts.onAudioEnd = function () {
-          console.log('[myclaw-tts] 播放结束');
-          if (currentBtn) {
-            setPlayerState(currentBtn, 'idle');
-            updateBtnIcon(currentBtn, 'idle');
-            currentBtn = null;
-          }
-          playerState = 'idle';
-        };
-        tts.vcn = IFLYTEK_CONFIG.vcn;
-        tts.speak(text);
-
-        // 状态会在 onStatusChange 里变成 playing
-        // 手动设置一次，因为 Web Audio API 可能比 status 更快
-        setTimeout(function () {
-          if (playerState === 'generating') {
-            setPlayerState(btn, 'playing');
-            updateBtnIcon(btn, 'playing');
-            playerState = 'playing';
-          }
-        }, 100);
-      }
-    }, true);
-
-    console.log('[myclaw-tts] ✅ TTS 按钮拦截器已挂载');
-  }
-
   // ═══ 启动 ═══
   function init() {
     injectStyles();
     initTts();
-    hookTtsButton();
+    observeFooters();
+    console.log('[myclaw-tts] ✅ 初始化完成');
   }
 
   if (document.readyState === 'loading') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aiyiran/myclaw",
-  "version": "1.0.122",
+  "version": "1.0.124",
   "description": "",
   "main": "index.js",
   "bin": {

package/patch-manifest.json

@@ -1,6 +1,6 @@
 {
   "_doc": "MyClaw 注入清单 (auto-generated)。strategy: auto | on | off | delete",
-  "_generated": "2026-04-02T15:57:57.414Z",
+  "_generated": "2026-04-03T03:21:17.226Z",
   "agents": [
     {
       "id": "danci",

package/wsl2.js

@@ -5,20 +5,18 @@
  * MyClaw WSL2 一键安装器
  * ============================================================================
  *
- * 使用方式: myclaw wsl2
+ * 采用“固定流程 + 状态标记”机制，避免使用容易出错的环境嗅探（wsl --status）。
+ * 标记文件：~/.myclaw_wsl_state
  *
- * 安装过程中会提示：
- *   - 有本地文件？拖拽到窗口 + 回车
- *   - 没有？直接回车，从 CDN 下载
- *
- * 自动检测安装状态，分两阶段完成：
- *   Phase 1: 启用底层 Windows 功能 + 安装 WSL → 需要重启
- *   Phase 2: 导入预制 Linux 环境 → 自动启动 Gateway
+ * Phase 1: 启用底层 Windows 功能 + 安装 WSL → 需要重启
+ * Phase 2: 导入预制 Linux 环境 → 自动启动 Gateway
  * ============================================================================
  */
 
 const { execSync } = require('child_process');
 const os = require('os');
+const fs = require('fs');
+const path = require('path');
 
 // ============================================================================
 // 配置
@@ -35,14 +33,24 @@ const C = isWindows
   ? { r: '', g: '', y: '', b: '', nc: '' }
   : { r: '\x1b[31m', g: '\x1b[32m', y: '\x1b[33m', b: '\x1b[34m', nc: '\x1b[0m' };
 
+const STATE_FILE = path.join(os.homedir(), '.myclaw_wsl_state');
+
 // ============================================================================
 // 工具函数
 // ============================================================================
 
-function launchElevatedPS(script) {
-  const fs = require('fs');
-  const path = require('path');
+function getState() {
+  if (fs.existsSync(STATE_FILE)) {
+    return fs.readFileSync(STATE_FILE, 'utf8').trim();
+  }
+  return 'needs-features';
+}
+
+function setState(state) {
+  fs.writeFileSync(STATE_FILE, state, 'utf8');
+}
 
+function launchElevatedPS(script) {
   // 把脚本写到临时文件（避免 Windows 命令行长度限制）
   const tmpDir = process.env.LOCALAPPDATA
     ? path.join(process.env.LOCALAPPDATA, 'myclaw')
@@ -50,7 +58,7 @@ function launchElevatedPS(script) {
   try { fs.mkdirSync(tmpDir, { recursive: true }); } catch {}
   const scriptPath = path.join(tmpDir, 'wsl2_installer.ps1');
 
-  // UTF-8 with BOM — PowerShell 需要 BOM 才能正确读取中文
+  // UTF-8 with BOM
   const BOM = '\uFEFF';
   fs.writeFileSync(scriptPath, BOM + script, 'utf8');
 
@@ -68,14 +76,6 @@ function launchElevatedPS(script) {
   }
 }
 
-/**
- * 生成「拖拽 / 盘符搜索 / 回车」的 PowerShell 交互代码片段
- * @param {string} prompt   提示文字
- * @param {string} destVar  目标文件变量名（如 $msi, $tarPath）
- * @param {string} cdnUrl   CDN 下载地址
- * @param {string} desc     文件描述（如 "WSL 安装包"）
- * @param {string} fileName 要搜索的文件名（如 "wsl_full.msi"）
- */
 function makeAskLocalOrCDN(prompt, destVar, cdnUrl, desc, fileName) {
   return `
 Write-Host ''
@@ -92,7 +92,6 @@ $userInput = $userInput.Trim().Trim('"')
 $resolved = ''
 
 if ($userInput) {
-    # 判断是否为单个盘符 (如 F, G, d)
     if ($userInput -match '^[a-zA-Z]$') {
         $drive = $userInput.ToUpper()
         $drivePath = $drive + ':'
@@ -105,10 +104,8 @@ if ($userInput) {
             Write-Host "      未在 $drivePath 中找到 ${fileName}"
         }
     } elseif (Test-Path $userInput -PathType Leaf) {
-        # 直接就是文件路径（拖拽）
         $resolved = $userInput
     } elseif (Test-Path $userInput -PathType Container) {
-        # 是目录，在里面搜索
         Write-Host "      正在搜索 $userInput 中的 ${fileName}..."
         $found = Get-ChildItem -Path $userInput -Filter '${fileName}' -Recurse -ErrorAction SilentlyContinue | Select-Object -First 1
         if ($found) {
@@ -142,35 +139,17 @@ if ($resolved) {
 `;
 }
 
-// ============================================================================
-// 状态检测
-// ============================================================================
-
-function detectState() {
-  try {
-    execSync('wsl echo ok', { stdio: 'pipe', timeout: 15000 });
-    return 'ready';
-  } catch {}
-
-  try {
-    execSync('wsl --status', { stdio: 'pipe', timeout: 5000 });
-    return 'needs-setup';
-  } catch {}
-
-  return 'needs-features';
-}
-
 // ============================================================================
 // Phase 1: 启用功能 + 安装 WSL
 // ============================================================================
 
 function runPhase1() {
   console.log('');
-  console.log('[当前进度] WSL 功能 ' + C.r + '[未启用]' + C.nc);
-  console.log('           WSL 组件 ' + C.r + '[未安装]' + C.nc);
+  console.log('[当前进度] WSL 功能 ' + C.y + '[安装/覆盖]' + C.nc);
+  console.log('           WSL 组件 ' + C.y + '[安装/重置]' + C.nc);
   console.log('           Linux    ' + C.r + '[未安装]' + C.nc);
   console.log('');
-  console.log('阶段 1/2: 启用底层功能 + 安装 WSL');
+  console.log('阶段 1/2: 强制执行底层系统组件配置');
   console.log('  完成后需要 ' + C.y + '重启电脑' + C.nc);
   console.log('');
   console.log('[' + C.y + '注意' + C.nc + '] 请在 UAC 弹窗中点击【是】');
@@ -194,15 +173,16 @@ Write-Host '  MyClaw WSL2 安装 - 阶段 1/2'
 Write-Host '========================================'
 Write-Host ''
 
-$dir = "$env:LOCALAPPDATA\\\\myclaw"
+$dir = "$env:LOCALAPPDATA\\myclaw"
 New-Item -ItemType Directory -Force -Path $dir | Out-Null
+$msi = "$dir\\wsl_full.msi"
 
 Write-Host '[1/4] 启用 Windows Subsystem for Linux...'
 try {
     dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart | Out-Null
     Write-Host '      [OK]'
 } catch {
-    Write-Host '      跳过 (可能已启用)'
+    Write-Host '      [异常] 启用失败，继续尝试...'
 }
 Write-Host ''
 
@@ -211,34 +191,37 @@ try {
     dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart | Out-Null
     Write-Host '      [OK]'
 } catch {
-    Write-Host '      跳过 (可能已启用)'
+    Write-Host '      [异常] 启用失败，继续尝试...'
 }
 Write-Host ''
 
 Write-Host '[3/4] 获取 WSL 安装包...'
-$msi = "$dir\\\\wsl_full.msi"
-$wslInstalled = $false
-try {
-    $ver = wsl --version 2>&1 | Out-String
-    if ($ver -match 'WSL') { $wslInstalled = $true }
-} catch {}
+# 移除文件以保证不做本地缓存
+if (Test-Path $msi) { Remove-Item $msi -Force }
 
-if ($wslInstalled) {
-    Write-Host '      WSL 已安装，跳过'
-    Write-Host '      [OK]'
-} else {
 ${askMsi}
 
-    Write-Host ''
-    Write-Host '[4/4] 安装 WSL...'
-    try {
-        Start-Process msiexec.exe -ArgumentList @('/i', $msi, '/quiet', '/norestart') -Wait -NoNewWindow
+Write-Host ''
+Write-Host '[4/4] 强制覆盖安装 WSL...'
+try {
+    Start-Process msiexec.exe -ArgumentList @('/i', $msi, '/quiet', '/norestart') -Wait -NoNewWindow
+    if ($LASTEXITCODE -ne 0 -and $LASTEXITCODE -ne 3010) {
+        Write-Host "      [警告] 安装退出代码异常 (Code: $LASTEXITCODE)"
+    } else {
         Write-Host '      [OK]'
-    } catch {
-        Write-Host '      [失败] 安装出错'
     }
+} catch {
+    Write-Host '      [失败] 安装出错'
+    throw 'MSI 安装失败'
 }
 
+# 装完立刻删除缓存
+if (Test-Path $msi) { Remove-Item $msi -Force }
+
+# 提权环境下，通过指定绝对路径来将标记写给原来普通用户
+$markerPath = "${STATE_FILE.replace(/\\/g, '\\\\')}"
+Out-File -FilePath "$markerPath" -InputObject "phase1-done" -Encoding utf8 -Force
+
 Write-Host ''
 Write-Host '========================================'
 Write-Host '  阶段 1/2 完成!'
@@ -275,8 +258,8 @@ Write-Host '========================================'
 
 function runPhase2() {
   console.log('');
-  console.log('[当前进度] WSL 功能 ' + C.g + '[OK]' + C.nc);
-  console.log('           WSL 组件 ' + C.g + '[OK]' + C.nc);
+  console.log('[当前进度] WSL 功能 ' + C.g + '[已就绪]' + C.nc);
+  console.log('           WSL 组件 ' + C.g + '[已就绪]' + C.nc);
   console.log('           Linux    ' + C.y + '[待安装]' + C.nc);
   console.log('');
   console.log('即将导入预制 Linux 环境...');
@@ -302,8 +285,9 @@ Write-Host '  导入预制 Linux 环境'
 Write-Host '========================================'
 Write-Host ''
 
-$dir = "$env:LOCALAPPDATA\\\\myclaw"
+$dir = "$env:LOCALAPPDATA\\myclaw"
 New-Item -ItemType Directory -Force -Path $dir | Out-Null
+$tarPath = "$dir\\openclaw-rootfs.tar"
 
 Write-Host '[1/3] 设置 WSL2 为默认版本...'
 try { wsl --set-default-version 2 2>$null } catch {}
@@ -311,16 +295,17 @@ Write-Host '      [OK]'
 Write-Host ''
 
 Write-Host '[2/3] 获取预制 Linux 环境...'
-$tarPath = "$dir\\\\openclaw-rootfs.tar"
 $distroName = 'OpenClaw'
-$installDir = "$dir\\\\OpenClaw"
+$installDir = "$dir\\OpenClaw"
 $installed = $false
 
+# 移除旧的缓存
+if (Test-Path $tarPath) { Remove-Item $tarPath -Force }
+
 ${askTar}
 
 Write-Host '      正在导入 (可能需要几分钟)...'
 
-# 先尝试卸载旧的同名发行版（不存在则忽略）
 Write-Host '      清理旧版本...'
 try { wsl --unregister $distroName 2>$null } catch {}
 Write-Host '      [OK]'
@@ -339,6 +324,9 @@ try {
 }
 Write-Host ''
 
+# 导入完毕清理 TAR 缓存
+if (Test-Path $tarPath) { Remove-Item $tarPath -Force }
+
 Write-Host '[3/3] 验证安装结果...'
 try {
     $result = wsl -l -v 2>&1 | Out-String
@@ -354,17 +342,18 @@ if ($installed) {
     Write-Host '========================================'
     Write-Host ''
 
-    # 显示镜像构建信息
+    $markerPath = "${STATE_FILE.replace(/\\/g, '\\\\')}"
+    Out-File -FilePath "$markerPath" -InputObject "phase2-done" -Encoding utf8 -Force
+
     Write-Host '[镜像信息]'
     try {
         $buildInfo = wsl -d $distroName -- cat /etc/openclaw-build-info 2>&1
         Write-Host $buildInfo
     } catch {
-        Write-Host '  (无法读取构建信息)'
+        Write-Host '  (无构建信息)'
     }
     Write-Host ''
 
-    # 统一启动流程：update + patch + gateway + open
     wsl -d $distroName -- myclaw launch
 } else {
     Write-Host '  [失败] 请检查后重试: myclaw wsl2'
@@ -402,14 +391,22 @@ function run() {
     process.exit(0);
   }
 
+  // 隐藏的高级玩家后门，强制跳过阶段
+  if (process.argv.includes('--force-phase1')) {
+    setState('needs-features');
+  }
+  if (process.argv.includes('--force-phase2')) {
+    setState('phase1-done');
+  }
+
   const bar = '========================================';
-  const state = detectState();
+  const state = getState();
 
   console.log('');
   console.log('[' + C.b + 'MyClaw' + C.nc + '] WSL2 一键安装向导');
   console.log(bar);
 
-  if (state === 'ready') {
+  if (state === 'phase2-done') {
     console.log('');
     console.log('[' + C.g + 'OK' + C.nc + '] WSL2 已完全安装就绪！');
     console.log('');
@@ -423,15 +420,15 @@ function run() {
     console.log('输入 ' + C.y + 'wsl' + C.nc + ' 即可进入 Linux 环境。');
     console.log('');
 
-    // 询问是否重装
     const readline = require('readline');
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    rl.question('是否要重新安装 Linux 环境? (y/N): ', (answer) => {
+    rl.question('是否要重置状态并完全重新走安装流程? (y/N): ', (answer) => {
       rl.close();
       if (answer.trim().toLowerCase() === 'y') {
         console.log('');
-        console.log('[' + C.y + '重装模式' + C.nc + '] 将重新导入 Linux 环境...');
-        runPhase2();
+        console.log('[' + C.y + '重置模式' + C.nc + '] 将删除标记文件并从 Phase 1 重新开始...');
+        setState('needs-features');
+        runPhase1();
       } else {
         console.log('');
         console.log('已取消。');
@@ -440,7 +437,7 @@ function run() {
     return;
   }
 
-  if (state === 'needs-setup') {
+  if (state === 'phase1-done') {
     runPhase2();
   } else {
     runPhase1();