openclaw-agent-dashboard 1.0.5 → 1.0.7

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-agent-dashboard",
-  "version": "1.0.5",
+  "version": "1.0.7",
   "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.5",
+  "version": "1.0.7",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/plugin/package.json

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

package/scripts/install-python-deps.js

@@ -56,12 +56,24 @@ function parseArgs() {
 // Python 环境检测
 // ============================================
 
+/**
+ * 获取 Python 命令（跨平台）
+ * Windows 通常是 python，Linux/macOS 通常是 python3
+ * @returns {string}
+ */
+function getPythonCmd() {
+  if (runCommand('python3', ['--version'], { silent: true }).success) return 'python3';
+  if (runCommand('python', ['--version'], { silent: true }).success) return 'python';
+  return 'python3'; // 默认
+}
+
 /**
  * 检查 venv 模块是否可用
  * @returns {boolean}
  */
 function checkVenvModule() {
-  const result = runCommand('python3', ['-c', 'import venv'], { silent: true });
+  const pythonCmd = getPythonCmd();
+  const result = runCommand(pythonCmd, ['-c', 'import venv'], { silent: true });
   return result.success;
 }
 
@@ -70,14 +82,13 @@ function checkVenvModule() {
  * @returns {boolean}
  */
 function checkPipModule() {
-  // 尝试 python3 -m pip
-  let result = runCommand('python3', ['-m', 'pip', '--version'], { silent: true });
+  const pythonCmd = getPythonCmd();
+  // 尝试 python -m pip
+  let result = runCommand(pythonCmd, ['-m', 'pip', '--version'], { silent: true });
   if (result.success) return true;
 
-  // 尝试 pip3
+  // 尝试 pip3 / pip
   if (commandExists('pip3')) return true;
-
-  // 尝试 pip
   if (commandExists('pip')) return true;
 
   return false;
@@ -121,7 +132,8 @@ function installWithVenv(reqFile, venvDir, silent) {
 
   // 创建 venv
   logInfo('  创建虚拟环境...');
-  const createResult = runCommand('python3', ['-m', 'venv', venvDir], { silent });
+  const pythonCmd = getPythonCmd();
+  const createResult = runCommand(pythonCmd, ['-m', 'venv', venvDir], { silent });
   if (!createResult.success) {
     logWarn('  venv 创建失败');
     if (!silent) {
@@ -169,8 +181,8 @@ function installWithPipUser(reqFile, silent) {
   logInfo('  尝试: pip --user（PEP 668 兜底）');
 
   const pipCommands = [
-    { cmd: 'python3', args: ['-m', 'pip', 'install', '-r', reqFile, '-q', '--user'], name: 'python3 -m pip --user' },
-    { cmd: 'python3', args: ['-m', 'pip', 'install', '-r', reqFile, '-q'], name: 'python3 -m pip' },
+    { cmd: getPythonCmd(), args: ['-m', 'pip', 'install', '-r', reqFile, '-q', '--user'], name: 'pip --user' },
+    { cmd: getPythonCmd(), args: ['-m', 'pip', 'install', '-r', reqFile, '-q'], name: 'pip' },
     { cmd: 'pip', args: ['install', '-r', reqFile, '-q', '--user'], name: 'pip --user' },
     { cmd: 'pip3', args: ['install', '-r', reqFile, '-q', '--user'], name: 'pip3 --user' },
   ];

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/src/backend/requirements.txt

@@ -3,3 +3,4 @@ uvicorn[standard]==0.27.0
 pydantic==2.5.0
 python-multipart==0.0.6
 watchdog>=3.0.0
+tzdata