openclaw-agent-dashboard 1.0.21 → 1.0.23

package/scripts/install.sh

@@ -1,367 +0,0 @@
-#!/usr/bin/env bash
-#
-# OpenClaw Agent Dashboard - 一键安装脚本
-# 用法: curl -fsSL https://raw.githubusercontent.com/Umarchen/openclaw-agent-dashboard/main/scripts/install.sh | bash
-# 默认安装仓库中标记为 Latest 的发布（即你最近推送的 release）。
-#
-# 选项:
-#   DASHBOARD_VERSION=x.x.x     安装指定版本 (默认: latest，即 Latest release)
-#   DASHBOARD_RELEASE_URL=URL   使用自定义下载地址
-#   DASHBOARD_SKIP_PYTHON=1     跳过 Python 依赖安装
-#   VERBOSE=1                   显示详细输出
-#   DRY_RUN=1                   仅预览，不执行实际安装
-#
-set -euo pipefail
-
-# ============================================
-# [公共函数] 与 scripts/lib/common.sh 同步
-# ============================================
-
-log_info()  { echo "$1"; }
-log_step()  { echo ""; echo ">>> $1"; }
-log_ok()    { echo "✓ $1"; }
-log_warn()  { echo "⚠ $1"; }
-log_error() { echo "❌ $1" >&2; }
-
-run_silent() {
-  if [ "${VERBOSE:-0}" = "1" ]; then
-    "$@"
-  else
-    "$@" 2>/dev/null
-  fi
-}
-
-resolve_openclaw_config_dir() {
-  if [ -n "${OPENCLAW_STATE_DIR:-}" ]; then
-    echo "${OPENCLAW_STATE_DIR}"
-    return
-  fi
-  if [ -n "${CLAWDBOT_STATE_DIR:-}" ]; then
-    echo "${CLAWDBOT_STATE_DIR}"
-    return
-  fi
-  local home_dir="${OPENCLAW_HOME:-${HOME:-${USERPROFILE:-}}}"
-  if [ -z "$home_dir" ]; then
-    home_dir="${HOME:-}"
-  fi
-  if [[ "$home_dir" == '~'* ]]; then
-    home_dir="${HOME:-}${home_dir#\~}"
-  fi
-  echo "${home_dir}/.openclaw"
-}
-
-detect_os() {
-  case "$(uname -s 2>/dev/null)" in
-    Linux*)   echo "linux" ;;
-    Darwin*)  echo "macos" ;;
-    MINGW*|MSYS*|CYGWIN*) echo "windows" ;;
-    *)        echo "unknown" ;;
-  esac
-}
-
-validate_os() {
-  local os="$1"
-  case "$os" in
-    linux|macos|windows)
-      log_info "系统: $os"
-      ;;
-    *)
-      log_error "不支持的系统: $(uname -s 2>/dev/null || echo 'unknown')"
-      log_info "支持的系统: Linux, macOS, Windows (Git Bash)"
-      exit 1
-      ;;
-  esac
-}
-
-download_file() {
-  local url="$1"
-  local output="$2"
-  log_info "  下载: $url"
-  if command -v curl &>/dev/null; then
-    if ! curl -fSL --progress-bar -o "$output" "$url"; then
-      return 1
-    fi
-  elif command -v wget &>/dev/null; then
-    if ! wget -q --show-progress -O "$output" "$url"; then
-      return 1
-    fi
-  else
-    log_error "需要 curl 或 wget 来下载文件"
-    exit 1
-  fi
-  return 0
-}
-
-# ============================================
-# 配置
-# ============================================
-
-REPO_OWNER="Umarchen"
-REPO_NAME="openclaw-agent-dashboard"
-PLUGIN_ID="openclaw-agent-dashboard"
-
-# ============================================
-# 环境变量
-# ============================================
-
-VERBOSE="${VERBOSE:-0}"
-DRY_RUN="${DRY_RUN:-0}"
-DASHBOARD_VERSION="${DASHBOARD_VERSION:-latest}"
-DASHBOARD_RELEASE_URL="${DASHBOARD_RELEASE_URL:-}"
-DASHBOARD_SKIP_PYTHON="${DASHBOARD_SKIP_PYTHON:-0}"
-
-# ============================================
-# 版本解析
-# ============================================
-
-resolve_version() {
-  local requested="$1"
-
-  if [ "$requested" = "latest" ]; then
-    local api_url="https://api.github.com/repos/${REPO_OWNER}/${REPO_NAME}/releases/latest"
-    local latest_tag
-
-    if command -v curl &>/dev/null; then
-      latest_tag=$(curl -fsSL "$api_url" 2>/dev/null | grep '"tag_name"' | head -1 | sed 's/.*"tag_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
-    elif command -v wget &>/dev/null; then
-      latest_tag=$(wget -qO- "$api_url" 2>/dev/null | grep '"tag_name"' | head -1 | sed 's/.*"tag_name"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/')
-    fi
-
-    if [ -n "$latest_tag" ]; then
-      echo "${latest_tag#v}"
-    else
-      echo "1.0.0"
-    fi
-  else
-    echo "$requested"
-  fi
-}
-
-# ============================================
-# [Python 依赖安装] 与 install-python-deps.sh 同步
-# ============================================
-
-install_python_deps_inline() {
-  local plugin_dir="$1"
-  local req_file="$plugin_dir/dashboard/requirements.txt"
-  local venv_dir="$plugin_dir/dashboard/.venv"
-  local python_deps_ok=""
-
-  if [ ! -f "$req_file" ]; then
-    log_warn "未找到 requirements.txt"
-    return 1
-  fi
-
-  # 策略 1: venv（推荐，不受 PEP 668 影响）
-  if python3 -c "import venv" 2>/dev/null; then
-    log_info "  尝试: venv（推荐）"
-    rm -rf "$venv_dir"
-    if python3 -m venv "$venv_dir" 2>/dev/null; then
-      local venv_python="$venv_dir/bin/python"
-      [ ! -x "$venv_python" ] && [ -x "$venv_dir/Scripts/python.exe" ] && venv_python="$venv_dir/Scripts/python.exe"
-      if [ -n "$venv_python" ]; then
-        run_silent "$venv_python" -m pip install --upgrade pip -q 2>/dev/null || true
-        if run_silent "$venv_python" -m pip install -r "$req_file" -q; then
-          python_deps_ok="venv"
-        fi
-      fi
-    fi
-  fi
-
-  # 策略 2: pip --user 兜底
-  if [ -z "$python_deps_ok" ]; then
-    log_info "  尝试: pip --user"
-    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)"
-    return 0
-  else
-    log_warn "Python 依赖安装失败"
-    print_python_deps_help "$req_file"
-    return 1
-  fi
-}
-
-print_python_deps_help() {
-  local req_file="$1"
-  echo ""
-  echo "========================================"
-  echo "请检查以下系统依赖是否已安装："
-  echo "========================================"
-  echo ""
-  
-  # 检测系统并给出针对性建议
-  if [ -f /etc/debian_version ]; then
-    echo "检测到 Debian/Ubuntu 系统（PEP 668 限制，请用 venv 安装）："
-    echo ""
-    echo "  1. 安装 python3-venv："
-    echo "     sudo apt update"
-    echo "     sudo apt install python3 python3-pip python3-venv"
-    echo ""
-    echo "  2. 在插件目录下用 venv 安装依赖（推荐）："
-    echo "     cd ~/.openclaw/extensions/openclaw-agent-dashboard/dashboard"
-    echo "     python3 -m venv .venv"
-    echo "     .venv/bin/pip install -r requirements.txt"
-    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 "  curl -fsSL https://raw.githubusercontent.com/Umarchen/openclaw-agent-dashboard/main/scripts/install.sh | bash"
-  echo ""
-  echo "或手动用 venv 安装 Python 依赖（Debian/Ubuntu 请用此方式）："
-  echo ""
-  echo "  cd \$(dirname $req_file)"
-  echo "  python3 -m venv .venv"
-  echo "  .venv/bin/pip install -r requirements.txt"
-  echo ""
-}
-
-# ============================================
-# 主流程
-# ============================================
-
-main() {
-  # 1. 检测系统
-  OS=$(detect_os)
-  validate_os "$OS"
-
-  # 2. 解析配置目录
-  OPENCLAW_CONFIG_DIR=$(resolve_openclaw_config_dir)
-  PLUGIN_PATH="${OPENCLAW_CONFIG_DIR}/extensions/${PLUGIN_ID}"
-
-  log_info "配置目录: $OPENCLAW_CONFIG_DIR"
-  log_info "插件路径: $PLUGIN_PATH"
-  echo ""
-
-  # 3. 检查 openclaw
-  if ! command -v openclaw &>/dev/null; then
-    log_error "未找到 openclaw 命令"
-    log_info "请先安装: npm install -g openclaw"
-    exit 1
-  fi
-
-  # 4. 解析版本
-  VERSION=$(resolve_version "$DASHBOARD_VERSION")
-  if [ "$DASHBOARD_VERSION" = "latest" ] && [ "$VERSION" = "1.0.0" ]; then
-    log_warn "无法获取最新版本，使用默认版本 1.0.0"
-  fi
-  log_info "版本: $VERSION"
-
-  # 5. 构建下载 URL
-  if [ -n "$DASHBOARD_RELEASE_URL" ]; then
-    DOWNLOAD_URL="$DASHBOARD_RELEASE_URL"
-  else
-    DOWNLOAD_URL="https://github.com/${REPO_OWNER}/${REPO_NAME}/releases/download/v${VERSION}/${PLUGIN_ID}-v${VERSION}.tgz"
-  fi
-
-  log_info "下载地址: $DOWNLOAD_URL"
-
-  # 6. dry-run 模式
-  if [ "$DRY_RUN" = "1" ]; then
-    echo ""
-    log_info "[DRY-RUN] 将执行以下操作:"
-    log_info "  - 下载: $DOWNLOAD_URL"
-    log_info "  - 安装插件到: $PLUGIN_PATH"
-    if [ "$DASHBOARD_SKIP_PYTHON" != "1" ]; then
-      log_info "  - 安装 Python 依赖到 venv 或 --user"
-    fi
-    log_ok "预览完成，未执行实际安装"
-    exit 0
-  fi
-
-  # 7. 创建临时目录
-  TMP_DIR=$(mktemp -d)
-  TGZ_FILE="$TMP_DIR/${PLUGIN_ID}.tgz"
-  trap 'rm -rf "$TMP_DIR"' EXIT
-
-  # 8. 下载
-  log_step "下载预构建包..."
-  if ! download_file "$DOWNLOAD_URL" "$TGZ_FILE"; then
-    log_error "下载失败"
-    log_info ""
-    log_info "可能的原因:"
-    log_info "  1. 网络连接问题"
-    log_info "  2. 版本不存在: v$VERSION"
-    log_info "  3. GitHub 访问受限"
-    log_info ""
-    log_info "尝试:"
-    log_info "  1. 检查网络连接"
-    log_info "  2. 设置代理: export https_proxy=http://proxy:port"
-    log_info "  3. 手动下载: curl -LO $DOWNLOAD_URL"
-    log_info "  4. 指定版本: DASHBOARD_VERSION=1.0.0 bash install.sh"
-    exit 1
-  fi
-  log_ok "下载完成"
-
-  # 9. 清理旧安装
-  log_step "清理旧版本..."
-  if [ -d "$PLUGIN_PATH" ]; then
-    log_info "  执行: openclaw plugins uninstall $PLUGIN_ID"
-    if run_silent openclaw plugins uninstall "$PLUGIN_ID" --force; then
-      log_ok "  已卸载（配置记录）"
-    else
-      log_warn "  uninstall 失败（可能未注册）"
-    fi
-    rm -rf "$PLUGIN_PATH"
-    log_ok "  已删除旧目录"
-  else
-    log_ok "  无旧版本"
-  fi
-
-  # 10. 安装插件
-  log_step "安装插件..."
-  log_info "  执行: openclaw plugins install $TGZ_FILE"
-  if ! openclaw plugins install "$TGZ_FILE"; then
-    log_error "插件安装失败"
-    exit 1
-  fi
-  log_ok "插件已安装"
-
-  # 11. 安装 Python 依赖
-  if [ "$DASHBOARD_SKIP_PYTHON" != "1" ] && [ -f "$PLUGIN_PATH/dashboard/requirements.txt" ]; then
-    log_step "安装 Python 依赖..."
-    install_python_deps_inline "$PLUGIN_PATH" || true
-  fi
-
-  # 12. 完成
-  echo ""
-  log_ok "=== 安装完成 (v$VERSION) ==="
-  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 ""
-}
-
-main "$@"

package/scripts/lib/common.sh

@@ -1,137 +0,0 @@
-#!/usr/bin/env bash
-#
-# 公共函数库 - 安装脚本共用
-# 用法: source "$(dirname "$0")/../lib/common.sh" 或 source "$SCRIPT_DIR/lib/common.sh"
-#
-
-# ============================================
-# 日志函数
-# ============================================
-
-log_info()  { echo "$1"; }
-log_step()  { echo ""; echo ">>> $1"; }
-log_ok()    { echo "✓ $1"; }
-log_warn()  { echo "⚠ $1"; }
-log_error() { echo "❌ $1" >&2; }
-
-# ============================================
-# 执行辅助
-# ============================================
-
-# run_silent: 静默执行命令（VERBOSE=1 时显示输出）
-# 用法: run_silent command args...
-run_silent() {
-  if [ "${VERBOSE:-0}" = "1" ]; then
-    "$@"
-  else
-    "$@" 2>/dev/null
-  fi
-}
-
-# ============================================
-# 配置目录解析（与 OpenClaw 内部逻辑一致）
-# ============================================
-
-# resolve_openclaw_config_dir: 解析 OpenClaw 配置目录
-# 优先级: OPENCLAW_STATE_DIR > CLAWDBOT_STATE_DIR > OPENCLAW_HOME/.openclaw > HOME/.openclaw
-# 用法: OPENCLAW_CONFIG_DIR=$(resolve_openclaw_config_dir)
-resolve_openclaw_config_dir() {
-  if [ -n "${OPENCLAW_STATE_DIR:-}" ]; then
-    echo "${OPENCLAW_STATE_DIR}"
-    return
-  fi
-  if [ -n "${CLAWDBOT_STATE_DIR:-}" ]; then
-    echo "${CLAWDBOT_STATE_DIR}"
-    return
-  fi
-  local home_dir="${OPENCLAW_HOME:-${HOME:-${USERPROFILE:-}}}"
-  if [ -z "$home_dir" ]; then
-    home_dir="${HOME:-}"
-  fi
-  # 展开 ~ 前缀（与 openclaw 行为一致）
-  if [[ "$home_dir" == '~'* ]]; then
-    home_dir="${HOME:-}${home_dir#\~}"
-  fi
-  echo "${home_dir}/.openclaw"
-}
-
-# ============================================
-# JSON 版本解析
-# ============================================
-
-# parse_json_version: 从 JSON 文件解析 version 字段
-# 优先使用 jq，回退 node，最后 grep+sed
-# 用法: VERSION=$(parse_json_version plugin/openclaw.plugin.json)
-parse_json_version() {
-  local json_file="$1"
-  if [ ! -f "$json_file" ]; then
-    return 1
-  fi
-  if command -v jq &>/dev/null; then
-    jq -r '.version' "$json_file"
-  elif command -v node &>/dev/null; then
-    node -e "const f=require('fs');console.log(JSON.parse(f.readFileSync(process.argv[1],'utf8')).version)" "$json_file"
-  else
-    # 最后兜底：使用 grep + sed
-    grep '"version"' "$json_file" | head -1 | sed 's/.*"version"[[:space:]]*:[[:space:]]*"\([^"]*\)".*/\1/'
-  fi
-}
-
-# ============================================
-# 系统检测
-# ============================================
-
-# detect_os: 检测操作系统
-# 返回: linux, macos, windows, unknown
-detect_os() {
-  case "$(uname -s 2>/dev/null)" in
-    Linux*)   echo "linux" ;;
-    Darwin*)  echo "macos" ;;
-    MINGW*|MSYS*|CYGWIN*) echo "windows" ;;
-    *)        echo "unknown" ;;
-  esac
-}
-
-# validate_os: 验证操作系统是否支持
-# 用法: validate_os "$(detect_os)"
-validate_os() {
-  local os="$1"
-  case "$os" in
-    linux|macos|windows)
-      log_info "系统: $os"
-      ;;
-    *)
-      log_error "不支持的系统: $(uname -s 2>/dev/null || echo 'unknown')"
-      log_info "支持的系统: Linux, macOS, Windows (Git Bash)"
-      return 1
-      ;;
-  esac
-}
-
-# ============================================
-# 下载辅助
-# ============================================
-
-# download_file: 下载文件（自动选择 curl 或 wget）
-# 用法: download_file "https://example.com/file.tgz" "/tmp/file.tgz"
-download_file() {
-  local url="$1"
-  local output="$2"
-
-  log_info "  下载: $url"
-
-  if command -v curl &>/dev/null; then
-    if ! curl -fSL --progress-bar -o "$output" "$url"; then
-      return 1
-    fi
-  elif command -v wget &>/dev/null; then
-    if ! wget -q --show-progress -O "$output" "$url"; then
-      return 1
-    fi
-  else
-    log_error "需要 curl 或 wget 来下载文件"
-    return 1
-  fi
-
-  return 0
-}

package/scripts/release-pack.sh

@@ -1,110 +0,0 @@
-#!/usr/bin/env bash
-#
-# 发布打包脚本
-# 用法: ./scripts/release-pack.sh [--version X.X.X]
-#
-# 生成预构建 tgz 包，供 CI 或本地发布使用。
-# 输出: openclaw-agent-dashboard-v{VERSION}.tgz
-#
-set -euo pipefail
-
-cd "$(dirname "$0")/.."
-ROOT=$(pwd)
-SCRIPT_DIR="$ROOT/scripts"
-
-# 引入公共库
-source "$SCRIPT_DIR/lib/common.sh"
-
-# ============================================
-# 参数解析
-# ============================================
-
-VERSION_OVERRIDE=""
-
-while [ $# -gt 0 ]; do
-  case "$1" in
-    --version) VERSION_OVERRIDE="$2"; shift 2 ;;
-    --help)
-      echo "用法: $0 [--version X.X.X]"
-      echo ""
-      echo "选项:"
-      echo "  --version  指定版本号 (默认从 plugin/openclaw.plugin.json 读取)"
-      exit 0
-      ;;
-    *) echo "未知选项: $1" >&2; exit 1 ;;
-  esac
-done
-
-# ============================================
-# 读取版本
-# ============================================
-
-if [ -n "$VERSION_OVERRIDE" ]; then
-  VERSION="$VERSION_OVERRIDE"
-else
-  if [ ! -f "$ROOT/plugin/openclaw.plugin.json" ]; then
-    log_error "未找到 plugin/openclaw.plugin.json"
-    exit 1
-  fi
-  VERSION=$(parse_json_version "$ROOT/plugin/openclaw.plugin.json")
-fi
-
-if [ -z "$VERSION" ]; then
-  log_error "无法解析版本号"
-  exit 1
-fi
-
-OUTPUT_FILE="$ROOT/openclaw-agent-dashboard-v${VERSION}.tgz"
-
-log_info "版本: $VERSION"
-log_info "输出: $OUTPUT_FILE"
-
-# ============================================
-# 确保已构建
-# ============================================
-
-if [ ! -d "$ROOT/plugin/frontend-dist" ] || [ ! -f "$ROOT/plugin/dashboard/main.py" ]; then
-  log_info "构建插件..."
-  npm run pack
-fi
-
-# ============================================
-# 生成 tgz
-# ============================================
-
-log_info "生成 tgz 包..."
-
-cd "$ROOT/plugin"
-
-# 清理旧的 tgz
-rm -f openclaw-agent-dashboard-*.tgz
-
-# npm pack
-npm pack
-
-# 查找生成的文件
-TGZ_FILE=$(ls openclaw-agent-dashboard-*.tgz 2>/dev/null | head -1)
-
-if [ -z "$TGZ_FILE" ]; then
-  log_error "npm pack 未生成 tgz 文件"
-  exit 1
-fi
-
-# 移动并重命名
-mv "$TGZ_FILE" "$OUTPUT_FILE"
-
-# ============================================
-# 完成
-# ============================================
-
-log_ok "已生成: $OUTPUT_FILE"
-
-# 显示文件信息
-ls -lh "$OUTPUT_FILE" 2>/dev/null || true
-
-# 显示 SHA256
-if command -v sha256sum &>/dev/null; then
-  echo "SHA256: $(sha256sum "$OUTPUT_FILE" | cut -d' ' -f1)"
-elif command -v shasum &>/dev/null; then
-  echo "SHA256: $(shasum -a 256 "$OUTPUT_FILE" | cut -d' ' -f1)"
-fi

package/scripts/start.js

@@ -1,50 +0,0 @@
-/**
- * 跨平台启动脚本
- * 解决 Windows 下 npm run start 无法解析 Linux shell 语法的问题
- */
-const { spawn } = require('child_process');
-const path = require('path');
-const os = require('os');
-
-// 环境变量处理（跨平台）
-const OPENCLAW_HOME = process.env.OPENCLAW_HOME || path.join(os.homedir(), '.openclaw');
-const DASHBOARD_PORT = process.env.DASHBOARD_PORT || '38271';
-
-// Windows 使用 python，非 Windows 使用 python3
-const pythonCmd = process.platform === 'win32' ? 'python' : 'python3';
-
-// 工作目录
-const backendDir = path.join(__dirname, '..', 'src', 'backend');
-
-// 设置环境变量并启动 uvicorn
-const env = {
-  ...process.env,
-  OPENCLAW_HOME,
-  DASHBOARD_PORT
-};
-
-console.log(`Starting Dashboard...`);
-console.log(`  OPENCLAW_HOME: ${OPENCLAW_HOME}`);
-console.log(`  PORT: ${DASHBOARD_PORT}`);
-console.log(`  Python: ${pythonCmd}`);
-
-const child = spawn(pythonCmd, [
-  '-m', 'uvicorn',
-  'main:app',
-  '--host', '0.0.0.0',
-  '--port', DASHBOARD_PORT
-], {
-  cwd: backendDir,
-  env,
-  stdio: 'inherit',
-  shell: process.platform === 'win32'
-});
-
-child.on('error', (err) => {
-  console.error('Failed to start Dashboard:', err);
-  process.exit(1);
-});
-
-child.on('exit', (code) => {
-  process.exit(code || 0);
-});