openclaw-agent-dashboard 1.0.4 → 1.0.6

package/README.md

@@ -48,16 +48,35 @@ brew install python3
 
 ## 快速安装
 
-### 方式一：一键安装（推荐）
+### 方式一：npx 安装（推荐，全平台）
 
 ```bash
-# 一键安装（需已安装 openclaw：npm install -g openclaw）
-curl -fsSL https://raw.githubusercontent.com/Umarchen/openclaw-agent-dashboard/main/scripts/install.sh | bash
+npx openclaw-agent-dashboard
+```
+
+一行搞定，自动从 GitHub Release 下载最新版并安装。升级也是同一行命令。
+
+**可选参数**:
+
+```powershell
+# 指定版本
+npx openclaw-agent-dashboard --version 1.0.4
+
+# 跳过 Python 依赖安装
+npx openclaw-agent-dashboard --skip-python
+
+# 显示详细输出（调试用）
+npx openclaw-agent-dashboard --verbose
+
+# 预览安装过程（不执行实际安装）
+npx openclaw-agent-dashboard --dry-run
 ```
 
-安装完成后，执行任意 `openclaw` 命令时 Dashboard 会自动启动。
+### 方式二：一键脚本（Linux / macOS）
 
-访问地址: http://localhost:38271
+```bash
+curl -fsSL https://raw.githubusercontent.com/Umarchen/openclaw-agent-dashboard/main/scripts/install.sh | bash
+```
 
 **可选参数**:
 
@@ -65,20 +84,14 @@ curl -fsSL https://raw.githubusercontent.com/Umarchen/openclaw-agent-dashboard/m
 # 安装指定版本
 DASHBOARD_VERSION=1.0.0 curl -fsSL https://raw.githubusercontent.com/Umarchen/openclaw-agent-dashboard/main/scripts/install.sh | bash
 
-# 使用自定义下载地址
-DASHBOARD_RELEASE_URL=https://example.com/openclaw-agent-dashboard-v1.0.0.tgz curl -fsSL ... | bash
-
 # 跳过 Python 依赖安装
 DASHBOARD_SKIP_PYTHON=1 curl -fsSL ... | bash
 
 # 显示详细输出（调试用）
 VERBOSE=1 curl -fsSL ... | bash
-
-# 预览安装过程（不执行实际安装）
-DRY_RUN=1 curl -fsSL ... | bash
 ```
 
-### 方式二：从源码安装
+### 方式三：从源码安装
 
 ```bash
 # 克隆仓库
@@ -100,7 +113,7 @@ cd openclaw-agent-dashboard
 npm run deploy
 ```
 
-### 方式三：手动下载安装
+### 方式四：手动下载安装
 
 从 [GitHub Releases](https://github.com/Umarchen/openclaw-agent-dashboard/releases) 下载 tgz 包：
 
@@ -111,12 +124,15 @@ curl -LO https://github.com/Umarchen/openclaw-agent-dashboard/releases/download/
 # 安装
 openclaw plugins install openclaw-agent-dashboard-v1.0.0.tgz
 
-# 安装 Python 依赖（Debian/Ubuntu 请用 venv，避免 PEP 668 报错）
+# 安装 Python 依赖
 cd ~/.openclaw/extensions/openclaw-agent-dashboard/dashboard
 python3 -m venv .venv
 .venv/bin/pip install -r requirements.txt
 ```
 
+> 安装完成后，执行任意 `openclaw` 命令时 Dashboard 会自动启动。
+> 访问地址: http://localhost:38271
+
 ## 命令说明
 
 | 命令 | 说明 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-agent-dashboard",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "description": "多 Agent 可视化看板 - 状态、任务、API、工作流、协作流程",
   "bin": {
     "openclaw-agent-dashboard": "scripts/install.js"

package/plugin/openclaw.plugin.json

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

package/plugin/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-agent-dashboard",
-  "version": "1.0.4",
+  "version": "1.0.6",
   "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/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