openclaw-agent-dashboard 1.0.6 → 1.0.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-agent-dashboard",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "多 Agent 可视化看板 - 状态、任务、API、工作流、协作流程",
   "bin": {
     "openclaw-agent-dashboard": "scripts/install.js"
@@ -13,7 +13,12 @@
     "bundle": "bash scripts/bundle.sh",
     "start": "node scripts/start.js"
   },
-  "keywords": ["openclaw", "agent", "dashboard", "visualization"],
+  "keywords": [
+    "openclaw",
+    "agent",
+    "dashboard",
+    "visualization"
+  ],
   "license": "MIT",
   "repository": {
     "type": "git",

package/plugin/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "openclaw-agent-dashboard",
   "name": "OpenClaw Agent Dashboard",
   "description": "多 Agent 可视化看板 - 状态、任务、API、工作流、协作流程",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-agent-dashboard",
-  "version": "1.0.6",
+  "version": "1.0.8",
   "description": "多 Agent 可视化看板 - OpenClaw 插件",
   "main": "index.js",
   "openclaw": {

package/scripts/install.js

@@ -32,11 +32,12 @@ const {
   runCommandAsync,
   rmrf,
   copyDir,
-  downloadFile,
   backupDir,
   restoreBackup,
   cleanupBackup,
   cleanupOldBackups,
+  downloadFile,
+  formatBytes,
 } = require('./lib/common');
 
 // ============================================
@@ -125,6 +126,108 @@ function checkPrerequisites(remoteMode) {
   return allPassed;
 }
 
+// ============================================
+// 远程模式：tgz 解压（纯 Node.js，跨平台）
+// ============================================
+
+/**
+ * 解析 tar 文件路径和大小
+ * @param {Buffer} buffer - tar 数据
+ * @returns {{name: string, size: number, type: string, offset: number}[]}
+ */
+function parseTarEntries(buffer) {
+  const entries = [];
+  let offset = 0;
+
+  while (offset < buffer.length - 512) {
+    // 读取文件名（0-99）
+    let name = buffer.toString('utf8', offset, offset + 100).replace(/\0.*$/, '');
+
+    // 跳过空块
+    if (name === '') {
+      offset += 512;
+      continue;
+    }
+
+    // 文件大小（124-135，八进制）
+    const sizeStr = buffer.toString('utf8', offset + 124, offset + 135).replace(/\0.*$/, '').trim();
+    const size = parseInt(sizeStr, 8) || 0;
+
+    // 文件类型（156）
+    const type = buffer.toString('utf8', offset + 156, offset + 157);
+
+    entries.push({ name, size, type, offset });
+
+    // 跳到下一个条目（512 字节头 + 数据，数据按 512 对齐）
+    const dataBlocks = Math.ceil(size / 512);
+    offset += 512 + dataBlocks * 512;
+  }
+
+  return entries;
+}
+
+/**
+ * 解压 tgz 文件到指定目录
+ * @param {string} tgzFile - tgz 文件路径
+ * @param {string} destDir - 目标目录
+ * @param {boolean} verbose - 显示详细信息
+ * @returns {Promise<boolean>}
+ */
+async function extractTgz(tgzFile, destDir, verbose) {
+  const zlib = require('zlib');
+  const fsPromises = require('fs').promises;
+
+  return new Promise((resolve) => {
+    const fileStream = fs.createReadStream(tgzFile);
+    const gunzip = zlib.createGunzip();
+    const chunks = [];
+
+    gunzip.on('data', (chunk) => chunks.push(chunk));
+    gunzip.on('end', () => {
+      try {
+        const tarData = Buffer.concat(chunks);
+        const entries = parseTarEntries(tarData);
+
+        for (const entry of entries) {
+          // 跳过目录类型
+          if (entry.type === '5') continue;
+          // 跳过空文件名或 pax header
+          if (!entry.name || entry.name.startsWith('PaxHeader')) continue;
+
+          const fullPath = path.join(destDir, entry.name);
+          fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+
+          // 写入文件数据
+          const dataOffset = entry.offset + 512;
+          const fileData = tarData.slice(dataOffset, dataOffset + entry.size);
+          fs.writeFileSync(fullPath, fileData);
+
+          if (verbose) {
+            logInfo(`  ${entry.name} (${formatBytes(entry.size)})`);
+          }
+        }
+
+        resolve(true);
+      } catch (err) {
+        logError(`解压处理失败: ${err.message}`);
+        resolve(false);
+      }
+    });
+
+    gunzip.on('error', (err) => {
+      logError(`gzip 解压失败: ${err.message}`);
+      resolve(false);
+    });
+
+    fileStream.on('error', (err) => {
+      logError(`读取文件失败: ${err.message}`);
+      resolve(false);
+    });
+
+    fileStream.pipe(gunzip);
+  });
+}
+
 // ============================================
 // 远程模式：版本解析
 // ============================================
@@ -199,37 +302,20 @@ async function remoteInstall(pluginPath, options) {
     }
     logOk('下载完成');
 
-    // 3. 解压 tgz
+    // 3. 解压 tgz（纯 Node.js 实现，不依赖系统 tar）
     logStep('解压安装包...');
     const extractDir = path.join(tmpDir, 'extract');
     fs.mkdirSync(extractDir, { recursive: true });
 
-    const tar = require('child_process');
-    const isWin = process.platform === 'win32';
-    // tar 命令在 Windows 10+ / Node 18+ 可用，否则用 node tar 库
     let extractOk = false;
-
-    // 尝试系统 tar
     try {
-      tar.execSync(`tar xzf "${tgzFile}" -C "${extractDir}"`, {
-        stdio: options.verbose ? 'inherit' : 'pipe',
-        shell: true,
-      });
-      extractOk = true;
-    } catch {
-      // tar 不可用，尝试 node 内置解压
-      try {
-        const zlib = require('zlib');
-        const { Readable } = require('stream');
-
-        // 简单的 tgz 解压：用 gunzip + tar（通过 node-tar 或系统命令）
-        // 如果都失败，报错提示
-      } catch {}
+      extractOk = await extractTgz(tgzFile, extractDir, options.verbose);
+    } catch (err) {
+      logError(`解压失败: ${err.message}`);
     }
 
     if (!extractOk) {
       logError('解压失败');
-      logInfo('请确保系统支持 tar 命令');
       return false;
     }
     logOk('解压完成');

package/scripts/lib/common.js

@@ -191,10 +191,24 @@ function shellEscape(arg) {
  */
 function runCommand(cmd, args = [], options = {}) {
   const { cwd, silent = true, timeout = 120000 } = options;
+  const isWin = process.platform === 'win32';
 
   try {
-    // 构建命令字符串，对参数进行转义
-    const cmdStr = [cmd, ...args.map(shellEscape)].join(' ');
+    // Windows 用双引号，Unix 用单引号
+    const esc = (arg) => {
+      if (!arg) return '""';
+      if (isWin) {
+        // Windows: 用双引号包裹含空格/特殊字符的路径
+        if (/[^a-zA-Z0-9_\-./:=@]/.test(arg)) {
+          return '"' + arg.replace(/"/g, '""') + '"';
+        }
+        return arg;
+      } else {
+        return shellEscape(arg);
+      }
+    };
+
+    const cmdStr = [cmd, ...args.map(esc)].join(' ');
 
     const result = execSync(
       cmdStr,
@@ -203,7 +217,7 @@ function runCommand(cmd, args = [], options = {}) {
         encoding: 'utf8',
         timeout,
         stdio: silent ? ['ignore', 'pipe', 'pipe'] : 'inherit',
-        shell: process.platform === 'win32',
+        shell: true,
       }
     );
     return { success: true, code: 0, output: result || '' };