@bitseek/hermes-webui 0.1.0-beta.0

package/vendor/agent-frontend-shell/extensions/pages/registry.js

@@ -0,0 +1,302 @@
+/**
+ * Hermes WebUI Extension Pages Registry
+ *
+ * Provides hermes.registerPanel() API for adding custom pages
+ * without modifying core files. Monkey-patches switchPanel() to
+ * support extension panels and dynamically injects DOM elements.
+ */
+(function() {
+  'use strict';
+
+  // Prevent double-loading
+  if (document.getElementById('hermes-pages-registry')) return;
+
+  // Built-in panel names (cannot be overridden)
+  var BUILTIN_PANELS = ['chat', 'tasks', 'kanban', 'skills', 'memory',
+    'workspaces', 'profiles', 'todos', 'insights', 'logs', 'settings'];
+
+  // Namespace
+  var NS = (window.hermes = window.hermes || {});
+  var panels = new Map();
+  NS._panels = panels;
+
+  // Inject registry marker
+  var marker = document.createElement('script');
+  marker.id = 'hermes-pages-registry';
+  marker.type = 'text/html';
+  marker.textContent = 'registry-loaded';
+  document.head.appendChild(marker);
+
+  // Dynamic CSS element for catch-all override
+  var dynamicStyle = null;
+
+  function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+  }
+
+  function createNavButton(name, label, icon, tooltip, isMobile, labelKey, tooltipKey) {
+    var btn = document.createElement('button');
+    btn.className = isMobile
+      ? 'nav-tab has-tooltip has-tooltip--bottom'
+      : 'rail-btn nav-tab has-tooltip';
+    btn.setAttribute('data-panel', name);
+    if (!isMobile) btn.setAttribute('data-label', label);
+    btn.setAttribute('data-tooltip', tooltip || label);
+    btn.setAttribute('onclick', "switchPanel('" + name + "',{fromRailClick:true})");
+    btn.setAttribute('aria-label', label);
+    btn.innerHTML = icon;
+
+    // Wire up i18n: applyLocaleToDOM() will auto-update on locale switch
+    if (labelKey) btn.setAttribute('data-i18n-aria-label', labelKey);
+    if (tooltipKey) {
+      btn.setAttribute('data-i18n-title', tooltipKey);
+    } else if (labelKey) {
+      btn.setAttribute('data-i18n-title', labelKey);
+    }
+
+    return btn;
+  }
+
+  function injectNavButton(name, label, icon, tooltip, position, labelKey, tooltipKey) {
+    // Desktop rail
+    var rail = document.querySelector('.rail');
+    if (rail) {
+      var railBtn = createNavButton(name, label, icon, tooltip, false, labelKey, tooltipKey);
+      var refPanel = position.replace(/^(before|after)-/, '');
+      var refBtn = rail.querySelector('[data-panel="' + refPanel + '"]');
+      if (refBtn) {
+        if (position.startsWith('after-')) {
+          refBtn.parentNode.insertBefore(railBtn, refBtn.nextSibling);
+        } else {
+          refBtn.parentNode.insertBefore(railBtn, refBtn);
+        }
+      } else {
+        rail.appendChild(railBtn);
+      }
+    }
+
+    // Mobile sidebar-nav
+    var sidebarNav = document.querySelector('.sidebar-nav');
+    if (sidebarNav) {
+      var mobileBtn = createNavButton(name, label, icon, tooltip, true, labelKey, tooltipKey);
+      var refMobile = sidebarNav.querySelector('[data-panel="' + refPanel + '"]');
+      if (refMobile) {
+        if (position.startsWith('after-')) {
+          refMobile.parentNode.insertBefore(mobileBtn, refMobile.nextSibling);
+        } else {
+          refMobile.parentNode.insertBefore(mobileBtn, refMobile);
+        }
+      } else {
+        sidebarNav.appendChild(mobileBtn);
+      }
+    }
+  }
+
+  function injectPanelView(name, panelContent) {
+    var sidebar = document.querySelector('.sidebar');
+    if (!sidebar) return null;
+
+    var el = document.createElement('div');
+    el.className = 'panel-view ext-panel-view';
+    el.id = 'panel' + capitalize(name);
+    if (typeof panelContent === 'string') {
+      el.innerHTML = panelContent;
+    } else if (panelContent instanceof HTMLElement) {
+      el.appendChild(panelContent);
+    }
+
+    // Insert before resize-handle (last element in sidebar)
+    var resizeHandle = sidebar.querySelector('.resize-handle');
+    if (resizeHandle) {
+      sidebar.insertBefore(el, resizeHandle);
+    } else {
+      sidebar.appendChild(el);
+    }
+    return el;
+  }
+
+  function injectMainView(name, mainContent) {
+    var main = document.querySelector('main.main');
+    if (!main) return null;
+
+    var el = document.createElement('div');
+    el.className = 'ext-main-view main-view';
+    el.id = 'main' + capitalize(name);
+    if (typeof mainContent === 'string') {
+      el.innerHTML = mainContent;
+    } else if (mainContent instanceof HTMLElement) {
+      el.appendChild(mainContent);
+    }
+
+    main.appendChild(el);
+    return el;
+  }
+
+  function updateDynamicCSS() {
+    if (!dynamicStyle) {
+      dynamicStyle = document.createElement('style');
+      dynamicStyle.id = 'hermes-ext-panel-css';
+      document.head.appendChild(dynamicStyle);
+    }
+
+    var extNames = [];
+    panels.forEach(function(cfg, name) {
+      if (cfg.showingClass !== false) {
+        extNames.push(name);
+      }
+    });
+
+    if (extNames.length === 0) {
+      dynamicStyle.textContent = '';
+      return;
+    }
+
+    var selectors = extNames.map(function(n) { return '.showing-' + n; });
+    var rules = [
+      'main.main:is(' + selectors.join(',') + ') > #mainChat{display:none!important;}'
+    ];
+
+    extNames.forEach(function(n) {
+      rules.push('main.main.showing-' + n + ' > #main' + capitalize(n) + '{display:flex;}');
+    });
+
+    dynamicStyle.textContent = rules.join('\n');
+  }
+
+  /**
+   * Register a new panel/extension page
+   *
+   * @param {Object} config
+   * @param {string} config.name - Panel identifier (required)
+   * @param {string} config.label - Display name (fallback if no labelKey)
+   * @param {string} config.labelKey - i18n key for nav button label/aria-label
+   * @param {string} config.icon - SVG markup for nav button
+   * @param {string} config.tooltip - Hover tooltip (fallback if no tooltipKey)
+   * @param {string} config.tooltipKey - i18n key for nav button tooltip
+   * @param {string} config.position - 'before-settings' (default) or 'before-logs'
+   * @param {string|HTMLElement} config.panel - Sidebar panel content
+   * @param {string|HTMLElement} config.main - Main content area
+   * @param {Function} config.onActivate - Called when panel becomes active
+   * @param {Function} config.onDeactivate - Called when leaving panel
+   * @param {boolean} config.showingClass - Whether to add showing- class (default true)
+   */
+  NS.registerPanel = function(config) {
+    if (!config || !config.name) {
+      console.warn('[pages-registry] registerPanel requires a name');
+      return;
+    }
+
+    var name = config.name;
+
+    // Validate name
+    if (BUILTIN_PANELS.indexOf(name) !== -1) {
+      console.warn('[pages-registry] Cannot override built-in panel:', name);
+      return;
+    }
+    if (panels.has(name)) {
+      console.warn('[pages-registry] Panel already registered:', name);
+      return;
+    }
+
+    var labelKey = config.labelKey;
+    var tooltipKey = config.tooltipKey;
+    var label = (labelKey && typeof t === 'function') ? (t(labelKey) || config.label || name) : (config.label || name);
+    var tooltip = (tooltipKey && typeof t === 'function') ? (t(tooltipKey) || config.tooltip || label) : (config.tooltip || label);
+    var icon = config.icon || '<svg width="20" height="20" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="10"/></svg>';
+    var position = config.position || 'before-settings';
+
+    // Inject DOM elements
+    var panelEl = injectPanelView(name, config.panel);
+    var mainEl = injectMainView(name, config.main);
+    injectNavButton(name, label, icon, tooltip, position, labelKey, tooltipKey);
+
+    // Register labelKey in APP_TITLEBAR_KEYS so syncAppTitlebar shows translated title
+    if (labelKey && typeof APP_TITLEBAR_KEYS !== 'undefined') {
+      APP_TITLEBAR_KEYS[name] = labelKey;
+    }
+
+    // Store in registry
+    panels.set(name, {
+      config: config,
+      panelEl: panelEl,
+      mainEl: mainEl,
+      showingClass: config.showingClass !== false
+    });
+
+    // Update CSS rules
+    updateDynamicCSS();
+
+    console.log('[pages-registry] Panel registered:', name);
+  };
+
+  /**
+   * Load a page script or stylesheet dynamically
+   */
+  NS.loadPage = function(url) {
+    if (url.endsWith('.css')) {
+      var link = document.createElement('link');
+      link.rel = 'stylesheet';
+      link.href = url;
+      document.head.appendChild(link);
+    } else {
+      var s = document.createElement('script');
+      s.src = url;
+      s.defer = true;
+      document.body.appendChild(s);
+    }
+  };
+
+  // Monkey-patch switchPanel()
+  var origSwitchPanel = window.switchPanel;
+  if (typeof origSwitchPanel === 'function') {
+    window.switchPanel = async function(name, opts) {
+      var result = await origSwitchPanel.call(this, name, opts);
+      var nextPanel = name || 'chat';
+      var mainEl = document.querySelector('main.main');
+
+      // Handle extension panels
+      if (mainEl) {
+        // Add showing- class for extension panels
+        if (panels.has(nextPanel)) {
+          var cfg = panels.get(nextPanel);
+          if (cfg.showingClass) {
+            mainEl.classList.add('showing-' + nextPanel);
+          }
+        }
+
+        // Remove showing- from extension panels when switching away
+        panels.forEach(function(cfg, pname) {
+          if (pname !== nextPanel && cfg.showingClass) {
+            mainEl.classList.remove('showing-' + pname);
+          }
+        });
+      }
+
+      // Call lifecycle hooks
+      panels.forEach(function(cfg, pname) {
+        if (pname === nextPanel && typeof cfg.config.onActivate === 'function') {
+          cfg.config.onActivate();
+        } else if (pname !== nextPanel && typeof cfg.config.onDeactivate === 'function') {
+          cfg.config.onDeactivate();
+        }
+      });
+
+      return result;
+    };
+  }
+
+  // Auto-load pages from manifest
+  (async function() {
+    try {
+      var resp = await fetch('/extensions/pages/manifest.json');
+      if (!resp.ok) return;
+      var manifest = await resp.json();
+      if (Array.isArray(manifest.pages)) {
+        manifest.pages.forEach(function(p) { NS.loadPage(p); });
+      }
+    } catch(e) {
+      // Manifest not found or invalid, skip
+    }
+  })();
+
+})();

package/vendor/agent-frontend-shell/extensions/themes/bitseek/index.css

@@ -0,0 +1,93 @@
+/* ═══════════════════════════════════════════════════════════════════════════
+   BitSeek Skin for Hermes WebUI
+   Coral Orange brand (#FF7F50) with warm dark / clean light palettes.
+   Loaded via HERMES_WEBUI_EXTENSION_STYLESHEET_URLS — no core files modified.
+   ═══════════════════════════════════════════════════════════════════════════ */
+
+/* ── Light mode (B-end Dashboard) ── */
+:root[data-skin="bitseek"] {
+  --bg:#FFFFFF;--sidebar:#FAFAFA;--surface:#F6F6F6;
+  --border:#ECEFF8;--border2:#DFDFDF;
+  --text:#404040;--muted:#A7A7A7;--strong:#404040;--em:#646464;
+  --accent:#FF7F50;--accent-hover:#FA4321;--accent-text:#DE360C;
+  --accent-bg:rgba(255,127,80,0.08);--accent-bg-strong:rgba(255,127,80,0.16);
+  --code-bg:#F6F6F6;--code-inline-bg:rgba(255,127,80,0.08);--code-text:#DE360C;--pre-text:#404040;
+  --topbar-bg:rgba(255,255,255,0.96);--main-bg:rgba(255,255,255,0.55);
+  --input-bg:rgba(0,0,0,0.03);--hover-bg:#FFF7ED;
+  --focus-ring:rgba(255,127,80,0.3);--focus-glow:rgba(255,127,80,0.1);
+  --blue:#4A90D9;--gold:#DE360C;
+  --error:#EF4444;--success:#83D04E;--warning:#E68A00;--info:#4A90D9;
+  --surface-subtle:rgba(255,127,80,0.03);--surface-subtle-hover:rgba(255,127,80,0.06);
+  --border-subtle:rgba(255,127,80,0.06);--border-muted:rgba(255,127,80,0.12);
+  --user-bubble-bg:#FFF7ED;--user-bubble-border:rgba(255,127,80,0.25);
+  --user-bubble-text:#404040;--user-bubble-placeholder:#A7A7A7;
+  --user-selection-bg:rgba(255,127,80,0.25);--user-selection-text:#404040;
+}
+
+/* ── Dark mode (C-end Marketing) ── */
+:root.dark[data-skin="bitseek"] {
+  --bg:#160804;--sidebar:#1A1A1A;--surface:#1A1A1A;
+  --border:#040404;--border2:rgba(255,255,255,0.12);
+  --text:#FFFFFF;--muted:#C4BAB8;--strong:#FFFFFF;--em:#C4BAB8;
+  --accent:#FF7F50;--accent-hover:#FF9570;--accent-text:#FF9570;
+  --accent-bg:rgba(255,127,80,0.12);--accent-bg-strong:rgba(255,127,80,0.22);
+  --code-bg:#1A1A1A;--code-inline-bg:rgba(255,127,80,0.15);--code-text:#FF9570;--pre-text:#FFFFFF;
+  --topbar-bg:rgba(22,8,4,0.96);--main-bg:rgba(22,8,4,0.55);
+  --input-bg:rgba(255,255,255,0.04);--hover-bg:rgba(255,255,255,0.06);
+  --focus-ring:rgba(255,127,80,0.35);--focus-glow:rgba(255,127,80,0.1);
+  --blue:#6AABE8;--gold:#FF9570;
+  --error:#FF6B6B;--success:#83D04E;--warning:#FFB74D;--info:#6AABE8;
+  --surface-subtle:rgba(255,255,255,0.03);--surface-subtle-hover:rgba(255,255,255,0.06);
+  --border-subtle:rgba(255,255,255,0.06);--border-muted:rgba(255,255,255,0.12);
+  --user-bubble-bg:rgba(255,127,80,0.12);--user-bubble-border:rgba(255,127,80,0.20);
+  --user-bubble-text:#FFFFFF;--user-bubble-placeholder:#C4BAB8;
+  --user-selection-bg:rgba(255,127,80,0.28);--user-selection-text:#FFFFFF;
+}
+
+/* ── Onboarding: theme-aware overrides ── */
+/* style.css hardcodes dark backgrounds for .onboarding-card etc.
+   These rules restore correct colors for both light and dark modes. */
+
+/* -- Light mode onboarding -- */
+:root[data-skin="bitseek"]:not(.dark) .onboarding-overlay{background:rgba(200,205,215,.72);}
+:root[data-skin="bitseek"]:not(.dark) .onboarding-card{background:#fff;border-color:var(--border);box-shadow:0 24px 80px rgba(0,0,0,.10);}
+:root[data-skin="bitseek"]:not(.dark) .onboarding-step{background:var(--input-bg);}
+:root[data-skin="bitseek"]:not(.dark) .onboarding-step.active{background:var(--accent-bg);}
+:root[data-skin="bitseek"]:not(.dark) .onboarding-step-index{background:rgba(0,0,0,.06);}
+:root[data-skin="bitseek"]:not(.dark) .onboarding-status{background:var(--input-bg);}
+:root[data-skin="bitseek"]:not(.dark) .onboarding-check{background:var(--input-bg);}
+
+/* -- Dark mode onboarding (uses CSS vars, just fix overlay tint) -- */
+:root.dark[data-skin="bitseek"] .onboarding-overlay{background:rgba(7,12,19,.82);}
+:root.dark[data-skin="bitseek"] .onboarding-card{background:linear-gradient(180deg,rgba(22,8,4,.98),rgba(22,8,4,.96));}
+
+/* ── Component overrides ── */
+/* New chat button: solid coral, white text */
+:root[data-skin="bitseek"]:not(.dark) .new-chat-btn,
+:root.dark[data-skin="bitseek"] .new-chat-btn{background:var(--accent);border-color:var(--accent);color:#fff;font-weight:600;box-shadow:0 1px 2px rgba(255,127,80,0.15);}
+:root[data-skin="bitseek"]:not(.dark) .new-chat-btn:hover,
+:root.dark[data-skin="bitseek"] .new-chat-btn:hover{background:var(--accent-hover);border-color:var(--accent-hover);color:#fff;}
+
+/* Tool / thinking cards */
+:root[data-skin="bitseek"] .tool-card{background:rgba(255,127,80,0.025);border-color:var(--border);border-radius:10px;}
+:root[data-skin="bitseek"] .tool-card:hover{border-color:var(--border2);}
+:root[data-skin="bitseek"] .tool-card-running{background:var(--accent-bg);border-color:var(--accent-bg-strong);}
+:root[data-skin="bitseek"] .tool-card-name{color:var(--muted);font-weight:500;}
+:root[data-skin="bitseek"] .tool-arg-key{color:var(--accent-text);}
+:root[data-skin="bitseek"] .tool-card-more{color:var(--accent-text);}
+:root[data-skin="bitseek"] .tool-card-running-dot{background:var(--accent);}
+:root.dark[data-skin="bitseek"] .tool-card{background:rgba(255,255,255,0.03);}
+
+/* User bubble: warm tint pill */
+:root[data-skin="bitseek"] .msg-row[data-role="user"] .msg-body{border-radius:16px;padding:12px 16px;}
+:root[data-skin="bitseek"] .msg-row[data-role="user"] .msg-body code{color:var(--user-bubble-text);background:rgba(255,127,80,0.08);}
+
+/* Send button pop and active session indicator */
+:root[data-skin="bitseek"] button.send-btn{box-shadow:0 1px 3px rgba(255,127,80,0.3);}
+:root[data-skin="bitseek"] button.send-btn:hover{box-shadow:0 2px 8px rgba(255,127,80,0.45);}
+:root[data-skin="bitseek"] .session-item.active{border-left:2px solid var(--accent);}
+:root[data-skin="bitseek"] .composer-box{border-radius:18px;}
+
+:root[data-skin="bitseek"] .app-titlebar-inner {width:100%;}
+:root[data-skin="bitseek"] .app-titlebar-icon {flex: 1;}
+:root[data-skin="bitseek"] .app-titlebar-inner::after {content: ""; flex: 1;}

package/vendor/agent-frontend-shell/extensions/themes/bitseek/index.js

@@ -0,0 +1,98 @@
+/* ═══════════════════════════════════════════════════════════════════════════
+   BitSeek Skin Extension for Hermes WebUI
+   Registers the "bitseek" skin into the live system without core edits.
+   Loaded via HERMES_WEBUI_EXTENSION_SCRIPT_URLS — runs after boot.js.
+   ═══════════════════════════════════════════════════════════════════════════ */
+(() => {
+  if (document.getElementById('bitseek-skin-ext')) return;
+
+  const SKIN_KEY = 'bitseek';
+  const SKIN_LABEL = 'BitSeek';
+  const SKIN_COLORS = ['#FF7F50', '#FA4321', '#FFF7ED'];
+
+  /* ── 1. Inject into _VALID_SKINS so the system recognizes "bitseek" ── */
+  if (typeof _VALID_SKINS !== 'undefined' && _VALID_SKINS instanceof Set) {
+    _VALID_SKINS.add(SKIN_KEY);
+  }
+
+  /* ── 2. Inject into _SKINS array so /theme command and picker can find it ── */
+  if (typeof _SKINS !== 'undefined' && Array.isArray(_SKINS)) {
+    const alreadyExists = _SKINS.some(s => (s.value || s.name).toLowerCase() === SKIN_KEY);
+    if (!alreadyExists) {
+      _SKINS.push({ name: SKIN_LABEL, colors: SKIN_COLORS });
+    }
+  }
+
+  /* ── 3. Append BitSeek button to the skin picker grid ── */
+  function injectPickerButton() {
+    const grid = document.getElementById('skinPickerGrid');
+    if (!grid) return false;
+
+    // Check if already injected
+    if (grid.querySelector('[data-skin-val="' + SKIN_KEY + '"]')) return true;
+
+    const btn = document.createElement('button');
+    btn.type = 'button';
+    btn.className = 'skin-pick-btn';
+    btn.dataset.skinVal = SKIN_KEY;
+    btn.style.cssText = 'border:1px solid var(--border2);border-radius:8px;padding:8px 4px;text-align:center;cursor:pointer;background:none;transition:all .15s';
+    btn.onclick = () => {
+      if (typeof _pickSkin === 'function') _pickSkin(SKIN_KEY);
+    };
+
+    const dots = SKIN_COLORS.map(c =>
+      '<span style="display:inline-block;width:10px;height:10px;border-radius:50%;background:' + c + '"></span>'
+    ).join('');
+
+    btn.innerHTML =
+      '<div style="display:flex;gap:3px;justify-content:center;margin-bottom:4px">' + dots + '</div>' +
+      '<span style="font-size:11px;color:var(--text)">' + SKIN_LABEL + '</span>';
+
+    grid.appendChild(btn);
+
+    // Sync active state
+    const currentSkin = (localStorage.getItem('hermes-skin') || '').toLowerCase();
+    if (currentSkin === SKIN_KEY) {
+      btn.classList.add('active');
+    }
+
+    return true;
+  }
+
+  // Try immediately, then retry with observer if picker not yet rendered
+  if (!injectPickerButton()) {
+    const observer = new MutationObserver(() => {
+      if (injectPickerButton()) observer.disconnect();
+    });
+    observer.observe(document.body, { childList: true, subtree: true });
+    // Safety timeout — stop observing after 10s
+    setTimeout(() => observer.disconnect(), 10000);
+  }
+
+  /* ── 4. Sync active state when skin changes (observe attribute) ── */
+  const skinObserver = new MutationObserver(() => {
+    const active = document.documentElement.dataset.skin || '';
+    document.querySelectorAll('#skinPickerGrid .skin-pick-btn').forEach(btn => {
+      btn.classList.toggle('active', btn.dataset.skinVal === active);
+    });
+  });
+  skinObserver.observe(document.documentElement, { attributes: true, attributeFilter: ['data-skin'] });
+
+  /* ── 5. Hook into /theme command for "bitseek" ── */
+  // Intercept keyboard submit to catch "/theme bitseek" before cmdTheme processes it
+  document.addEventListener('keydown', (e) => {
+    if (e.key !== 'Enter') return;
+    const input = document.getElementById('msg');
+    if (!input) return;
+    const val = (input.value || '').trim();
+    const match = val.match(/^\/theme\s+(bitseek)$/i);
+    if (!match) return;
+    e.preventDefault();
+    e.stopPropagation();
+    input.value = '';
+    if (typeof _pickSkin === 'function') _pickSkin(SKIN_KEY);
+    // Close any open command palette
+    const palette = document.getElementById('cmdPalette');
+    if (palette) palette.style.display = 'none';
+  }, true);
+})();

package/vendor/agent-frontend-shell/install.sh

@@ -0,0 +1,63 @@
+#!/bin/bash
+# Hermes WebUI 定制版一键安装脚本
+# 适用于小白用户，自动安装所有依赖
+
+set -e
+
+echo "🚀 开始安装 Hermes WebUI 定制版..."
+
+# 检查系统
+if [[ "$OSTYPE" == "msys" || "$OSTYPE" == "win32" ]]; then
+    echo "❌ 不支持 Windows，请使用 WSL2 或虚拟机"
+    exit 1
+fi
+
+# 检查 Python
+if ! command -v python3 &> /dev/null; then
+    echo "❌ 未找到 Python3，请先安装 Python 3.11+"
+    exit 1
+fi
+
+# 下载项目 - 使用 GitHub Release 方式
+DOWNLOAD_URL="https://github.com/yourusername/hermes-webui/releases/latest/download/hermes-webui-custom.zip"
+INSTALL_DIR="$HOME/hermes-webui-custom"
+
+if [ -d "$INSTALL_DIR" ]; then
+    echo "📁 发现已存在的安装目录，正在删除旧版本..."
+    rm -rf "$INSTALL_DIR"
+fi
+
+echo "📥 正在下载项目..."
+# 下载 zip 文件
+curl -L -o "/tmp/hermes-webui-custom.zip" "$DOWNLOAD_URL" || {
+    echo "❌ 下载失败，请检查："
+    echo "   1. 网络连接是否正常"
+    echo "   2. Release 地址是否正确: $DOWNLOAD_URL"
+    echo "   3. 确保 Release 已创建并包含 zip 文件"
+    exit 1
+}
+
+# 解压
+cd "$HOME"
+unzip -q "/tmp/hermes-webui-custom.zip" -d "$INSTALL_DIR" || {
+    echo "❌ 解压失败，请检查下载的文件"
+    exit 1
+}
+
+# 清理临时文件
+rm "/tmp/hermes-webui-custom.zip"
+cd "$INSTALL_DIR"
+
+# 运行自动安装
+echo "🔧 正在安装依赖和配置..."
+python3 bootstrap.py --no-browser
+
+echo "✅ 安装完成！"
+echo ""
+echo "🎯 启动方式："
+echo "   cd $INSTALL_DIR"
+echo "   ./start.sh"
+echo ""
+echo "🌐 然后访问: http://localhost:8787"
+echo ""
+echo "💡 首次使用需要配置 AI 提供商 API 密钥"