openclaw-agent-dashboard 1.0.21 → 1.0.23

package/plugin/package.json

@@ -1,26 +0,0 @@
-{
-  "name": "openclaw-agent-dashboard",
-  "version": "1.0.20",
-  "description": "多 Agent 可视化看板 - OpenClaw 插件",
-  "main": "index.js",
-  "openclaw": {
-    "extensions": ["./index.js"]
-  },
-  "keywords": ["openclaw", "dashboard", "agent", "monitoring"],
-  "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Umarchen/openclaw-agent-dashboard.git"
-  },
-  "files": [
-    "openclaw.plugin.json",
-    "index.js",
-    "dashboard",
-    "frontend-dist",
-    "scripts"
-  ],
-  "scripts": {
-    "pack": "node ../scripts/build-plugin.js",
-    "prepublishOnly": "npm run pack"
-  }
-}

package/scripts/build-plugin.js

@@ -1,81 +0,0 @@
-#!/usr/bin/env node
-/**
- * 插件打包脚本
- * 1. 构建前端
- * 2. 复制 backend 到 plugin/dashboard
- * 3. 复制 frontend/dist 到 plugin/frontend-dist
- */
-const fs = require('fs');
-const path = require('path');
-const { execSync } = require('child_process');
-
-const ROOT = path.join(__dirname, '..');
-const PLUGIN_DIR = path.join(ROOT, 'plugin');
-const BACKEND_SRC = path.join(ROOT, 'src', 'backend');
-const FRONTEND_DIR = path.join(ROOT, 'frontend');
-const DASHBOARD_DEST = path.join(PLUGIN_DIR, 'dashboard');
-const FRONTEND_DEST = path.join(PLUGIN_DIR, 'frontend-dist');
-
-function rmrf(dir) {
-  if (fs.existsSync(dir)) {
-    fs.rmSync(dir, { recursive: true });
-  }
-}
-
-function copyDir(src, dest, exclude = []) {
-  fs.mkdirSync(dest, { recursive: true });
-  const entries = fs.readdirSync(src, { withFileTypes: true });
-  for (const entry of entries) {
-    if (exclude.includes(entry.name)) continue;
-    if (entry.name.endsWith('.pyc') || entry.name.endsWith('.log')) continue;
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      copyDir(srcPath, destPath, exclude);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
-
-console.log('[pack] 1. 构建前端...');
-// 检查是否需要安装依赖：无 node_modules 或缺少 .bin（如 Windows 下 .bin 未生成）时都执行 install
-const nodeModulesPath = path.join(FRONTEND_DIR, 'node_modules');
-const binVite = path.join(nodeModulesPath, '.bin', 'vite');
-const binViteCmd = path.join(nodeModulesPath, '.bin', 'vite.cmd'); // Windows
-const needInstall = !fs.existsSync(nodeModulesPath) ||
-  !(fs.existsSync(binVite) || fs.existsSync(binViteCmd));
-if (needInstall) {
-  console.log('[pack] 安装前端依赖...');
-  execSync('npm install --no-audit', { cwd: FRONTEND_DIR, stdio: 'inherit', env: process.env });
-}
-execSync('npm run build', { cwd: FRONTEND_DIR, stdio: 'inherit', env: process.env });
-
-console.log('[pack] 2. 复制 backend -> plugin/dashboard');
-rmrf(DASHBOARD_DEST);
-copyDir(BACKEND_SRC, DASHBOARD_DEST, ['__pycache__', '.pytest_cache']);
-
-console.log('[pack] 3. 复制 frontend/dist -> plugin/frontend-dist');
-rmrf(FRONTEND_DEST);
-const frontendDist = path.join(FRONTEND_DIR, 'dist');
-if (fs.existsSync(frontendDist)) {
-  copyDir(frontendDist, FRONTEND_DEST);
-} else {
-  console.warn('[pack] frontend/dist 不存在，跳过');
-}
-
-console.log('[pack] 4. 复制 Python 依赖安装脚本 -> plugin/scripts（供 npm 包与 openclaw plugins install 使用）');
-const SCRIPTS_SRC = path.join(ROOT, 'scripts');
-const SCRIPTS_DEST = path.join(PLUGIN_DIR, 'scripts');
-rmrf(SCRIPTS_DEST);
-fs.mkdirSync(path.join(SCRIPTS_DEST, 'lib'), { recursive: true });
-fs.copyFileSync(
-  path.join(SCRIPTS_SRC, 'install-python-deps.js'),
-  path.join(SCRIPTS_DEST, 'install-python-deps.js'),
-);
-fs.copyFileSync(
-  path.join(SCRIPTS_SRC, 'lib', 'common.js'),
-  path.join(SCRIPTS_DEST, 'lib', 'common.js'),
-);
-
-console.log('[pack] 完成');

package/scripts/bundle.sh

@@ -1,62 +0,0 @@
-#!/usr/bin/env bash
-#
-# 打包项目为可分发的压缩包
-# 用法: npm run bundle
-#
-set -e
-cd "$(dirname "$0")/.."
-ROOT=$(pwd)
-
-VERSION=$(grep '"version"' "$ROOT/plugin/openclaw.plugin.json" | sed 's/.*"version": *"\([^"]*\)".*/\1/')
-OUTPUT="openclaw-agent-dashboard-v$VERSION.tar.gz"
-
-echo "=== 打包分发文件 ==="
-echo ""
-echo "  版本: $VERSION"
-echo "  输出: $OUTPUT"
-echo ""
-
-# 临时目录
-TMPDIR=$(mktemp -d)
-DISTDIR="$TMPDIR/openclaw-agent-dashboard"
-
-mkdir -p "$DISTDIR"
-
-# 复制需要的文件
-echo ">>> 复制文件..."
-cp -r "$ROOT/frontend" "$DISTDIR/"
-cp -r "$ROOT/src" "$DISTDIR/"
-cp -r "$ROOT/plugin" "$DISTDIR/"
-cp -r "$ROOT/scripts" "$DISTDIR/"
-cp "$ROOT/package.json" "$DISTDIR/"
-cp "$ROOT/README.md" "$DISTDIR/"
-
-# 清理不需要的文件
-echo ">>> 清理 node_modules..."
-rm -rf "$DISTDIR/frontend/node_modules"
-rm -rf "$DISTDIR/frontend/dist"
-rm -rf "$DISTDIR/plugin/frontend-dist"
-rm -rf "$DISTDIR/plugin/dashboard"
-find "$DISTDIR" -name "__pycache__" -type d -exec rm -rf {} + 2>/dev/null || true
-find "$DISTDIR" -name ".pytest_cache" -type d -exec rm -rf {} + 2>/dev/null || true
-
-# 打包
-echo ">>> 压缩..."
-cd "$TMPDIR"
-tar -czf "$ROOT/$OUTPUT" openclaw-agent-dashboard
-
-# 清理临时目录
-rm -rf "$TMPDIR"
-
-# 显示结果
-echo ""
-echo "=== 打包完成 ==="
-echo ""
-echo "  文件: $OUTPUT"
-echo "  大小: $(du -h "$ROOT/$OUTPUT" | cut -f1)"
-echo ""
-echo "分发使用说明:"
-echo "  1. 解压: tar -xzf $OUTPUT"
-echo "  2. 进入: cd openclaw-agent-dashboard"
-echo "  3. 安装: npm run deploy"
-echo ""

package/scripts/install-plugin.sh

@@ -1,162 +0,0 @@
-#!/usr/bin/env bash
-#
-# OpenClaw Agent Dashboard 插件 - 安装/升级脚本
-# 用法: npm run deploy（推荐）或 ./scripts/install-plugin.sh
-#
-# 选项:
-#   VERBOSE=1   显示详细输出（包括 npm/pip 的错误信息）
-#   DRY_RUN=1   仅预览，不执行实际安装
-#
-# 配置目录与 OpenClaw 一致：OPENCLAW_STATE_DIR > OPENCLAW_HOME > HOME
-#
-set -euo pipefail
-
-cd "$(dirname "$0")/.."
-ROOT=$(pwd)
-SCRIPT_DIR="$ROOT/scripts"
-
-# 引入公共库
-source "$SCRIPT_DIR/lib/common.sh"
-
-# 环境变量
-VERBOSE="${VERBOSE:-0}"
-DRY_RUN="${DRY_RUN:-0}"
-
-# ============================================
-# 本脚本特有函数
-# ============================================
-
-# 获取已安装版本
-get_installed_version() {
-  local plugin_path="$1"
-  if [ -f "$plugin_path/openclaw.plugin.json" ]; then
-    parse_json_version "$plugin_path/openclaw.plugin.json"
-  else
-    echo ""
-  fi
-}
-
-# 检查命令是否存在
-check_cmd() {
-  if ! command -v "$1" &>/dev/null; then
-    log_error "未找到 $1，请先安装: $2"
-    exit 1
-  fi
-}
-
-# ============================================
-# 主流程
-# ============================================
-
-OPENCLAW_CONFIG_DIR=$(resolve_openclaw_config_dir)
-PLUGIN_PATH="${OPENCLAW_CONFIG_DIR}/extensions/openclaw-agent-dashboard"
-NEW_VERSION=$(parse_json_version "$ROOT/plugin/openclaw.plugin.json")
-OLD_VERSION=$(get_installed_version "$PLUGIN_PATH")
-
-log_info "[安装] 配置目录: $OPENCLAW_CONFIG_DIR"
-log_info "[安装] 插件路径: $PLUGIN_PATH"
-echo ""
-
-# 显示标题（区分安装/升级）
-if [ -n "$OLD_VERSION" ] && [ -d "$PLUGIN_PATH" ]; then
-  log_info "=== OpenClaw Agent Dashboard 插件升级 ==="
-  echo ""
-  log_info "  $OLD_VERSION → $NEW_VERSION"
-else
-  log_info "=== OpenClaw Agent Dashboard 插件安装 ==="
-  echo ""
-  log_info "  版本: $NEW_VERSION"
-fi
-
-# dry-run 模式：仅预览
-if [ "$DRY_RUN" = "1" ]; then
-  echo ""
-  log_info "[DRY-RUN] 将执行以下操作:"
-  log_info "  - 安装插件到: $PLUGIN_PATH"
-  log_info "  - 安装 Python 依赖到 venv 或 --user"
-  log_ok "预览完成，未执行实际安装"
-  exit 0
-fi
-
-# 1. 检查前置条件
-check_cmd node "https://nodejs.org"
-check_cmd python3 "https://www.python.org"
-check_cmd openclaw "npm install -g openclaw"
-
-echo ""
-log_ok "前置条件检查通过"
-
-# 2. 构建前端（若通过 npm run deploy 调用，pack 已构建，跳过）
-if [ -d "$ROOT/frontend/dist" ] && [ -n "$(ls -A "$ROOT/frontend/dist" 2>/dev/null)" ]; then
-  log_step "1/4 前端已构建，跳过"
-else
-  log_step "1/4 构建前端..."
-  (cd frontend && run_silent npm install && npm run build)
-fi
-
-# 3. 打包插件（若通过 npm run deploy 调用，pack 已完成，跳过）
-if [ -d "$ROOT/plugin/dashboard" ] && [ -f "$ROOT/plugin/dashboard/main.py" ]; then
-  log_step "2/4 插件已打包，跳过"
-else
-  log_step "2/4 打包插件..."
-  node scripts/build-plugin.js
-fi
-
-# 4. 安装插件（升级时用 uninstall 清理配置+目录，避免 plugins.allow 引用已删目录导致校验失败）
-PLUGIN_ID="openclaw-agent-dashboard"
-if [ -d "$PLUGIN_PATH" ]; then
-  log_step "3/4 移除旧版本后安装..."
-  log_info "    执行: openclaw plugins uninstall $PLUGIN_ID"
-  if run_silent openclaw plugins uninstall "$PLUGIN_ID" --force; then
-    log_ok "    已卸载（配置记录）"
-  else
-    log_warn "    uninstall 失败（可能未注册）"
-  fi
-  # uninstall 只删除配置记录，需要手动删除物理目录
-  rm -rf "$PLUGIN_PATH"
-  log_ok "    已删除旧目录"
-else
-  log_step "3/4 安装插件..."
-fi
-log_info "    目标: $PLUGIN_PATH"
-log_info "    执行: openclaw plugins install ./plugin"
-if ! openclaw plugins install ./plugin; then
-  log_error "插件安装失败"
-  exit 1
-fi
-log_ok "    插件已安装"
-
-# 5. 安装 Python 依赖
-# 详见 docs/python-environment-compatibility.md
-if [ -f "$PLUGIN_PATH/dashboard/requirements.txt" ]; then
-  if [ -n "$OLD_VERSION" ]; then
-    log_step "4/4 检查 Python 依赖..."
-  else
-    log_step "4/4 安装 Python 依赖..."
-  fi
-
-  # 调用独立的 Python 依赖安装脚本
-  DEPS_OPTS=""
-  [ "$VERBOSE" = "1" ] && DEPS_OPTS="--verbose"
-
-  if ! bash "$SCRIPT_DIR/install-python-deps.sh" "$PLUGIN_PATH" $DEPS_OPTS; then
-    exit 1
-  fi
-else
-  log_warn "插件未正确安装（缺少 requirements.txt）"
-fi
-
-# 完成
-echo ""
-if [ -n "$OLD_VERSION" ]; then
-  log_ok "=== 升级完成 ($OLD_VERSION → $NEW_VERSION) ==="
-else
-  log_ok "=== 安装完成 (v$NEW_VERSION) ==="
-fi
-echo ""
-log_info "执行任意 openclaw 命令（如 openclaw tui）时，Dashboard 会自动启动。"
-log_info "访问地址: http://localhost:38271"
-echo ""
-log_info "若端口被占用，可创建 ~/.openclaw-agent-dashboard/config.json 设置端口:"
-log_info '  {"port": 38271}'
-echo ""

package/scripts/install-python-deps.sh

@@ -1,226 +0,0 @@
-#!/usr/bin/env bash
-#
-# Python 依赖安装脚本
-# 用法: ./install-python-deps.sh <plugin_dir> [options]
-#
-# 选项:
-#   --verbose     显示详细输出
-#   --venv-only   仅使用 venv，不回退 pip
-#   --skip-create 跳过创建 venv (已存在)
-#
-# 环境变量:
-#   VERBOSE=1     显示详细输出
-#
-set -euo pipefail
-
-# ============================================
-# 参数解析
-# ============================================
-
-if [ $# -lt 1 ]; then
-  echo "用法: $0 <plugin_dir> [--verbose] [--venv-only] [--skip-create]"
-  echo ""
-  echo "参数:"
-  echo "  plugin_dir    插件安装目录 (必须)"
-  echo ""
-  echo "选项:"
-  echo "  --verbose     显示详细输出"
-  echo "  --venv-only   仅使用 venv，不回退 pip"
-  echo "  --skip-create 跳过创建 venv (已存在)"
-  exit 1
-fi
-
-PLUGIN_DIR="$1"
-shift
-
-# 解析选项
-VERBOSE="${VERBOSE:-0}"
-VENV_ONLY=0
-SKIP_CREATE=0
-
-while [ $# -gt 0 ]; do
-  case "$1" in
-    --verbose) VERBOSE=1 ;;
-    --venv-only) VENV_ONLY=1 ;;
-    --skip-create) SKIP_CREATE=1 ;;
-    *) echo "未知选项: $1" >&2; exit 1 ;;
-  esac
-  shift
-done
-
-# ============================================
-# 日志辅助函数
-# ============================================
-
-log_info()  { echo "$1"; }
-log_ok()    { echo "✓ $1"; }
-log_warn()  { echo "⚠ $1"; }
-log_error() { echo "❌ $1" >&2; }
-
-run_silent() {
-  if [ "$VERBOSE" = "1" ]; then
-    "$@"
-  else
-    "$@" 2>/dev/null
-  fi
-}
-
-# ============================================
-# 系统依赖检测
-# ============================================
-
-check_python() {
-  if ! command -v python3 &>/dev/null; then
-    log_error "未找到 python3 命令"
-    echo ""
-    echo "请先安装 Python 3:"
-    echo "  Debian/Ubuntu: sudo apt install python3"
-    echo "  macOS:         brew install python3"
-    echo "  Windows:       从 https://www.python.org 下载安装"
-    return 1
-  fi
-  return 0
-}
-
-check_venv_module() {
-  if ! python3 -c "import venv" 2>/dev/null; then
-    return 1
-  fi
-  return 0
-}
-
-check_pip_module() {
-  if python3 -m pip --version &>/dev/null; then
-    return 0
-  fi
-  if command -v pip3 &>/dev/null; then
-    return 0
-  fi
-  if command -v pip &>/dev/null; then
-    return 0
-  fi
-  return 1
-}
-
-# ============================================
-# 验证
-# ============================================
-
-REQ_FILE="$PLUGIN_DIR/dashboard/requirements.txt"
-VENV_DIR="$PLUGIN_DIR/dashboard/.venv"
-
-if [ ! -f "$REQ_FILE" ]; then
-  log_error "未找到 requirements.txt: $REQ_FILE"
-  exit 1
-fi
-
-# ============================================
-# 安装 Python 依赖
-# ============================================
-
-PYTHON_DEPS_OK=""
-
-# 策略 1: venv（推荐，不受 PEP 668 影响，跨平台一致）
-if check_venv_module; then
-  log_info "  尝试: venv（推荐，不受 PEP 668 影响）"
-
-  VENV_PYTHON=""
-  # 检查现有 venv
-  [ -x "$VENV_DIR/bin/python" ] && VENV_PYTHON="$VENV_DIR/bin/python"
-  [ -z "$VENV_PYTHON" ] && [ -x "$VENV_DIR/Scripts/python.exe" ] && VENV_PYTHON="$VENV_DIR/Scripts/python.exe"
-
-  # 创建新 venv
-  if [ -z "$VENV_PYTHON" ] && [ "$SKIP_CREATE" != "1" ]; then
-    rm -rf "$VENV_DIR"
-    if ! python3 -m venv "$VENV_DIR" 2>/dev/null; then
-      log_warn "  venv 创建失败，尝试其他方式..."
-    else
-      [ -x "$VENV_DIR/bin/python" ] && VENV_PYTHON="$VENV_DIR/bin/python"
-      [ -z "$VENV_PYTHON" ] && [ -x "$VENV_DIR/Scripts/python.exe" ] && VENV_PYTHON="$VENV_DIR/Scripts/python.exe"
-    fi
-  fi
-
-  # 安装依赖
-  if [ -n "$VENV_PYTHON" ]; then
-    if run_silent "$VENV_PYTHON" -m pip install --upgrade pip -q 2>/dev/null; then
-      if run_silent "$VENV_PYTHON" -m pip install -r "$REQ_FILE" -q; then
-        PYTHON_DEPS_OK="venv"
-      fi
-    fi
-  fi
-fi
-
-# 策略 2: pip --user 兜底（Debian 12/Ubuntu 23.04+ 等 PEP 668 环境）
-if [ -z "$PYTHON_DEPS_OK" ] && [ "$VENV_ONLY" != "1" ]; then
-  log_info "  尝试: pip --user（PEP 668 兜底）"
-
-  if run_silent python3 -m pip install -r "$REQ_FILE" -q --user; then
-    PYTHON_DEPS_OK="pip --user"
-  elif run_silent python3 -m pip install -r "$REQ_FILE" -q; then
-    PYTHON_DEPS_OK="pip"
-  elif run_silent pip install -r "$REQ_FILE" -q --user; then
-    PYTHON_DEPS_OK="pip --user"
-  elif run_silent pip3 install -r "$REQ_FILE" -q --user; then
-    PYTHON_DEPS_OK="pip3 --user"
-  fi
-fi
-
-# ============================================
-# 结果
-# ============================================
-
-if [ -n "$PYTHON_DEPS_OK" ]; then
-  log_ok "Python 依赖已就绪 ($PYTHON_DEPS_OK)"
-  exit 0
-else
-  log_error "Python 依赖安装失败"
-  echo ""
-  echo "========================================"
-  echo "请检查以下系统依赖是否已安装："
-  echo "========================================"
-  echo ""
-  
-  # 检测系统并给出针对性建议
-  if [ -f /etc/debian_version ]; then
-    echo "检测到 Debian/Ubuntu 系统，请执行："
-    echo ""
-    echo "  sudo apt update"
-    echo "  sudo apt install python3 python3-pip python3-venv"
-    echo ""
-  elif [ -f /etc/redhat-release ]; then
-    echo "检测到 RedHat/CentOS/Fedora 系统，请执行："
-    echo ""
-    echo "  sudo dnf install python3 python3-pip"
-    echo ""
-  elif [[ "$(uname -s)" == "Darwin" ]]; then
-    echo "检测到 macOS 系统，请执行："
-    echo ""
-    echo "  brew install python3"
-    echo ""
-  else
-    echo "请确保已安装："
-    echo "  - Python 3"
-    echo "  - pip (python3-pip)"
-    echo "  - venv 模块 (python3-venv，Linux 通常需要单独安装)"
-    echo ""
-  fi
-  
-  echo "========================================"
-  echo "安装系统依赖后，重新执行："
-  echo "========================================"
-  echo ""
-  echo "  npm run deploy"
-  echo ""
-  echo "或手动安装 Python 依赖："
-  echo ""
-  echo "  python3 -m pip install -r $REQ_FILE --user"
-  echo ""
-  echo "========================================"
-  echo "调试模式："
-  echo "========================================"
-  echo ""
-  echo "  VERBOSE=1 npm run deploy"
-  echo ""
-  
-  exit 1
-fi