opc-agent 4.0.0 → 4.0.2

package/dist/tools/web-scraper.js

@@ -0,0 +1,148 @@
+"use strict";
+/**
+ * Web Scraper - v0.10.0
+ * Fetch URL content and extract readable text in markdown format.
+ * Uses a simple readability-style extraction (no external dependencies).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scrapeUrl = scrapeUrl;
+exports.extractReadableContent = extractReadableContent;
+const MAX_CONTENT_LENGTH = 5000;
+/**
+ * Fetch a URL and extract readable content as markdown.
+ */
+async function scrapeUrl(url, maxLength = MAX_CONTENT_LENGTH) {
+    const response = await fetch(url, {
+        headers: {
+            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36',
+            Accept: 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
+        },
+        signal: AbortSignal.timeout(15000),
+        redirect: 'follow',
+    });
+    const contentType = response.headers.get('content-type') || '';
+    const text = await response.text();
+    // If not HTML, return raw text
+    if (!contentType.includes('html')) {
+        const truncated = text.slice(0, maxLength);
+        return {
+            title: url,
+            content: truncated,
+            url,
+            wordCount: truncated.split(/\s+/).length,
+        };
+    }
+    return extractReadableContent(text, url, maxLength);
+}
+/**
+ * Extract readable content from HTML using simple heuristics.
+ */
+function extractReadableContent(html, url, maxLength = MAX_CONTENT_LENGTH) {
+    // Extract title
+    const titleMatch = html.match(/<title[^>]*>([\s\S]*?)<\/title>/i);
+    const title = titleMatch ? decodeEntities(titleMatch[1]).trim() : url;
+    // Remove non-content elements
+    let content = html;
+    // Remove script, style, nav, header, footer, aside, iframe
+    const removePatterns = [
+        /<script[\s\S]*?<\/script>/gi,
+        /<style[\s\S]*?<\/style>/gi,
+        /<nav[\s\S]*?<\/nav>/gi,
+        /<footer[\s\S]*?<\/footer>/gi,
+        /<aside[\s\S]*?<\/aside>/gi,
+        /<iframe[\s\S]*?<\/iframe>/gi,
+        /<noscript[\s\S]*?<\/noscript>/gi,
+        /<!--[\s\S]*?-->/g,
+    ];
+    for (const pattern of removePatterns) {
+        content = content.replace(pattern, '');
+    }
+    // Try to find main content area
+    const mainContent = findMainContent(content);
+    content = mainContent || content;
+    // Convert to markdown-ish text
+    content = htmlToMarkdown(content);
+    // Clean up whitespace
+    content = content
+        .replace(/\n{3,}/g, '\n\n')
+        .replace(/[ \t]+/g, ' ')
+        .trim();
+    // Truncate
+    if (content.length > maxLength) {
+        content = content.slice(0, maxLength) + '\n\n...[truncated]';
+    }
+    return {
+        title,
+        content,
+        url,
+        wordCount: content.split(/\s+/).filter(Boolean).length,
+    };
+}
+/**
+ * Try to find the main content area of the page.
+ */
+function findMainContent(html) {
+    // Try common content selectors
+    const patterns = [
+        /<article[^>]*>([\s\S]*?)<\/article>/i,
+        /<main[^>]*>([\s\S]*?)<\/main>/i,
+        /<div[^>]*class="[^"]*(?:content|article|post|entry|main)[^"]*"[^>]*>([\s\S]*?)<\/div>/i,
+        /<div[^>]*id="[^"]*(?:content|article|post|entry|main)[^"]*"[^>]*>([\s\S]*?)<\/div>/i,
+    ];
+    for (const pattern of patterns) {
+        const match = html.match(pattern);
+        if (match && match[1] && match[1].length > 200) {
+            return match[1];
+        }
+    }
+    // Fallback: find body content
+    const bodyMatch = html.match(/<body[^>]*>([\s\S]*?)<\/body>/i);
+    return bodyMatch ? bodyMatch[1] : null;
+}
+/**
+ * Simple HTML to Markdown conversion.
+ */
+function htmlToMarkdown(html) {
+    let md = html;
+    // Headers
+    md = md.replace(/<h1[^>]*>([\s\S]*?)<\/h1>/gi, '\n# $1\n');
+    md = md.replace(/<h2[^>]*>([\s\S]*?)<\/h2>/gi, '\n## $1\n');
+    md = md.replace(/<h3[^>]*>([\s\S]*?)<\/h3>/gi, '\n### $1\n');
+    md = md.replace(/<h4[^>]*>([\s\S]*?)<\/h4>/gi, '\n#### $1\n');
+    md = md.replace(/<h5[^>]*>([\s\S]*?)<\/h5>/gi, '\n##### $1\n');
+    md = md.replace(/<h6[^>]*>([\s\S]*?)<\/h6>/gi, '\n###### $1\n');
+    // Paragraphs and line breaks
+    md = md.replace(/<p[^>]*>/gi, '\n');
+    md = md.replace(/<\/p>/gi, '\n');
+    md = md.replace(/<br\s*\/?>/gi, '\n');
+    // Links
+    md = md.replace(/<a[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/gi, '[$2]($1)');
+    // Bold and italic
+    md = md.replace(/<(?:strong|b)[^>]*>([\s\S]*?)<\/(?:strong|b)>/gi, '**$1**');
+    md = md.replace(/<(?:em|i)[^>]*>([\s\S]*?)<\/(?:em|i)>/gi, '*$1*');
+    // Code
+    md = md.replace(/<code[^>]*>([\s\S]*?)<\/code>/gi, '`$1`');
+    md = md.replace(/<pre[^>]*>([\s\S]*?)<\/pre>/gi, '\n```\n$1\n```\n');
+    // Lists
+    md = md.replace(/<li[^>]*>([\s\S]*?)<\/li>/gi, '- $1\n');
+    // Blockquote
+    md = md.replace(/<blockquote[^>]*>([\s\S]*?)<\/blockquote>/gi, '\n> $1\n');
+    // Remove remaining HTML tags
+    md = md.replace(/<[^>]+>/g, '');
+    // Decode entities
+    md = decodeEntities(md);
+    return md;
+}
+function decodeEntities(text) {
+    return text
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#x27;/g, "'")
+        .replace(/&#39;/g, "'")
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&#(\d+);/g, (_, n) => String.fromCharCode(parseInt(n)))
+        .replace(/&#x([0-9a-fA-F]+);/g, (_, n) => String.fromCharCode(parseInt(n, 16)));
+}
+//# sourceMappingURL=web-scraper.js.map

package/dist/tools/web-search.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Web Search Engine Manager - v0.10.0
+ * Supports multiple search backends with automatic fallback.
+ * Default: DuckDuckGo (free, no API key required).
+ */
+export interface SearchResult {
+    title: string;
+    url: string;
+    snippet: string;
+}
+export interface SearchOptions {
+    maxResults?: number;
+    engine?: SearchEngine;
+}
+export type SearchEngine = 'duckduckgo' | 'brave' | 'searxng' | 'google';
+export interface SearchEngineConfig {
+    enabled: boolean;
+    apiKey?: string;
+    baseUrl?: string;
+}
+export interface WebSearchConfig {
+    defaultEngine: SearchEngine;
+    enabled: boolean;
+    engines: Partial<Record<SearchEngine, SearchEngineConfig>>;
+}
+export declare const DEFAULT_SEARCH_CONFIG: WebSearchConfig;
+/**
+ * Parse DuckDuckGo HTML search results.
+ */
+export declare function parseDuckDuckGoHTML(html: string): SearchResult[];
+/**
+ * Search using DuckDuckGo HTML interface (no API key needed).
+ */
+export declare function searchDuckDuckGo(query: string, maxResults?: number): Promise<SearchResult[]>;
+/**
+ * Search using Brave Search API.
+ */
+export declare function searchBrave(query: string, apiKey: string, maxResults?: number): Promise<SearchResult[]>;
+/**
+ * Search using SearXNG instance.
+ */
+export declare function searchSearXNG(query: string, baseUrl: string, maxResults?: number): Promise<SearchResult[]>;
+/**
+ * Search using Google Custom Search API.
+ */
+export declare function searchGoogle(query: string, apiKey: string, maxResults?: number): Promise<SearchResult[]>;
+/**
+ * Unified search function with fallback.
+ */
+export declare function webSearch(query: string, config?: WebSearchConfig, options?: SearchOptions): Promise<SearchResult[]>;
+//# sourceMappingURL=web-search.d.ts.map

package/dist/tools/web-search.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * Web Search Engine Manager - v0.10.0
+ * Supports multiple search backends with automatic fallback.
+ * Default: DuckDuckGo (free, no API key required).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_SEARCH_CONFIG = void 0;
+exports.parseDuckDuckGoHTML = parseDuckDuckGoHTML;
+exports.searchDuckDuckGo = searchDuckDuckGo;
+exports.searchBrave = searchBrave;
+exports.searchSearXNG = searchSearXNG;
+exports.searchGoogle = searchGoogle;
+exports.webSearch = webSearch;
+exports.DEFAULT_SEARCH_CONFIG = {
+    defaultEngine: 'duckduckgo',
+    enabled: true,
+    engines: {
+        duckduckgo: { enabled: true },
+    },
+};
+/**
+ * Parse DuckDuckGo HTML search results.
+ */
+function parseDuckDuckGoHTML(html) {
+    const results = [];
+    // Match result blocks: <a class="result__a" href="...">title</a> ... <a class="result__snippet">snippet</a>
+    const resultBlocks = html.split(/class="result__body"/);
+    for (let i = 1; i < resultBlocks.length && results.length < 10; i++) {
+        const block = resultBlocks[i];
+        // Extract URL and title from result__a
+        const linkMatch = block.match(/class="result__a"[^>]*href="([^"]*)"[^>]*>([\s\S]*?)<\/a>/);
+        if (!linkMatch)
+            continue;
+        let url = linkMatch[1];
+        const title = stripHTML(linkMatch[2]).trim();
+        // DuckDuckGo wraps URLs in redirect, extract actual URL
+        const uddgMatch = url.match(/[?&]uddg=([^&]+)/);
+        if (uddgMatch) {
+            url = decodeURIComponent(uddgMatch[1]);
+        }
+        // Extract snippet
+        const snippetMatch = block.match(/class="result__snippet"[^>]*>([\s\S]*?)<\/a>/);
+        const snippet = snippetMatch ? stripHTML(snippetMatch[1]).trim() : '';
+        if (title && url) {
+            results.push({ title, url, snippet });
+        }
+    }
+    return results;
+}
+/**
+ * Search using DuckDuckGo HTML interface (no API key needed).
+ */
+async function searchDuckDuckGo(query, maxResults = 5) {
+    const url = `https://html.duckduckgo.com/html/?q=${encodeURIComponent(query)}`;
+    const response = await fetch(url, {
+        headers: {
+            'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36',
+        },
+        signal: AbortSignal.timeout(15000),
+    });
+    const html = await response.text();
+    return parseDuckDuckGoHTML(html).slice(0, maxResults);
+}
+/**
+ * Search using Brave Search API.
+ */
+async function searchBrave(query, apiKey, maxResults = 5) {
+    const url = `https://api.search.brave.com/res/v1/web/search?q=${encodeURIComponent(query)}&count=${maxResults}`;
+    const response = await fetch(url, {
+        headers: { 'X-Subscription-Token': apiKey, Accept: 'application/json' },
+        signal: AbortSignal.timeout(15000),
+    });
+    const data = await response.json();
+    return (data.web?.results || []).slice(0, maxResults).map((r) => ({
+        title: r.title || '',
+        url: r.url || '',
+        snippet: r.description || '',
+    }));
+}
+/**
+ * Search using SearXNG instance.
+ */
+async function searchSearXNG(query, baseUrl, maxResults = 5) {
+    const url = `${baseUrl.replace(/\/$/, '')}/search?q=${encodeURIComponent(query)}&format=json`;
+    const response = await fetch(url, { signal: AbortSignal.timeout(15000) });
+    const data = await response.json();
+    return (data.results || []).slice(0, maxResults).map((r) => ({
+        title: r.title || '',
+        url: r.url || '',
+        snippet: r.content || '',
+    }));
+}
+/**
+ * Search using Google Custom Search API.
+ */
+async function searchGoogle(query, apiKey, maxResults = 5) {
+    // apiKey format: "key:cx" (API key and Custom Search Engine ID)
+    const [key, cx] = apiKey.split(':');
+    const url = `https://www.googleapis.com/customsearch/v1?q=${encodeURIComponent(query)}&key=${key}&cx=${cx}&num=${maxResults}`;
+    const response = await fetch(url, { signal: AbortSignal.timeout(15000) });
+    const data = await response.json();
+    return (data.items || []).slice(0, maxResults).map((r) => ({
+        title: r.title || '',
+        url: r.link || '',
+        snippet: r.snippet || '',
+    }));
+}
+/**
+ * Unified search function with fallback.
+ */
+async function webSearch(query, config, options) {
+    const cfg = config || exports.DEFAULT_SEARCH_CONFIG;
+    if (!cfg.enabled)
+        return [];
+    const maxResults = options?.maxResults || 5;
+    const engine = options?.engine || cfg.defaultEngine;
+    // Try requested engine first, then fallback chain
+    const fallbackOrder = [engine, 'duckduckgo', 'brave', 'searxng', 'google']
+        .filter((e, i, arr) => arr.indexOf(e) === i);
+    for (const eng of fallbackOrder) {
+        const engCfg = cfg.engines[eng];
+        if (engCfg && !engCfg.enabled)
+            continue;
+        try {
+            switch (eng) {
+                case 'duckduckgo':
+                    return await searchDuckDuckGo(query, maxResults);
+                case 'brave':
+                    if (engCfg?.apiKey)
+                        return await searchBrave(query, engCfg.apiKey, maxResults);
+                    continue;
+                case 'searxng':
+                    if (engCfg?.baseUrl)
+                        return await searchSearXNG(query, engCfg.baseUrl, maxResults);
+                    continue;
+                case 'google':
+                    if (engCfg?.apiKey)
+                        return await searchGoogle(query, engCfg.apiKey, maxResults);
+                    continue;
+            }
+        }
+        catch {
+            continue; // Fallback to next engine
+        }
+    }
+    return [];
+}
+function stripHTML(html) {
+    return html.replace(/<[^>]+>/g, '').replace(/&amp;/g, '&').replace(/&lt;/g, '<').replace(/&gt;/g, '>').replace(/&quot;/g, '"').replace(/&#x27;/g, "'").replace(/&nbsp;/g, ' ');
+}
+//# sourceMappingURL=web-search.js.map

package/install.ps1

@@ -0,0 +1,154 @@
+# ============================================================================
+# OPC Agent 一键安装脚本 for Windows
+# 用法: irm https://raw.githubusercontent.com/Deepleaper/opc-agent/main/install.ps1 | iex
+# 高级: $env:OPC_YES='1'; $env:OPC_NO_OLLAMA='1'; irm ... | iex
+# ============================================================================
+
+$ErrorActionPreference = "Stop"
+
+# ── 颜色输出 ──────────────────────────────────────────────────
+function Write-Step($msg)  { Write-Host "`n━━━ $msg ━━━" -ForegroundColor Blue }
+function Write-Ok($msg)    { Write-Host "✅ $msg" -ForegroundColor Green }
+function Write-Warn($msg)  { Write-Host "⚠️  $msg" -ForegroundColor Yellow }
+function Write-Err($msg)   { Write-Host "❌ $msg" -ForegroundColor Red }
+function Write-Info($msg)  { Write-Host "ℹ️  $msg" -ForegroundColor Cyan }
+
+$AutoYes    = $env:OPC_YES -eq '1'
+$SkipOllama = $env:OPC_NO_OLLAMA -eq '1'
+
+function Confirm-Action($prompt) {
+    if ($AutoYes) { return $true }
+    $choice = Read-Host "❓ $prompt [Y/n]"
+    return ($choice -ne 'n' -and $choice -ne 'N' -and $choice -ne 'no')
+}
+
+# ── 检测操作系统 ──────────────────────────────────────────────
+Write-Step "🔍 检测操作系统 / Detecting OS"
+Write-Ok "Windows $([System.Environment]::OSVersion.Version) detected"
+
+# ── 检测 & 安装 Node.js ──────────────────────────────────────
+Write-Step "📦 检测 Node.js / Checking Node.js"
+$NeedNode = $false
+
+try {
+    $nodeVer = (node -v) -replace 'v','' -split '\.' | Select-Object -First 1
+    if ([int]$nodeVer -ge 18) {
+        Write-Ok "Node.js $(node -v) 已安装 / installed"
+    } else {
+        Write-Warn "Node.js $(node -v) 版本过低，需要 18+ / version too old"
+        $NeedNode = $true
+    }
+} catch {
+    Write-Warn "未检测到 Node.js / Node.js not found"
+    $NeedNode = $true
+}
+
+if ($NeedNode) {
+    Write-Info "将安装 Node.js 22 LTS / Installing Node.js 22 LTS"
+    if (Confirm-Action "安装 Node.js 22? / Install Node.js 22?") {
+        $installed = $false
+        # 尝试 winget
+        try {
+            winget install OpenJS.NodeJS.LTS --accept-package-agreements --accept-source-agreements
+            $installed = $true
+            Write-Ok "Node.js 通过 winget 安装成功 / installed via winget"
+        } catch {}
+
+        # 尝试 choco
+        if (-not $installed) {
+            try {
+                choco install nodejs-lts -y
+                $installed = $true
+                Write-Ok "Node.js 通过 Chocolatey 安装成功 / installed via Chocolatey"
+            } catch {}
+        }
+
+        if (-not $installed) {
+            Write-Err "自动安装失败 / Auto-install failed"
+            Write-Info "请手动下载安装 / Please download manually: https://nodejs.org/"
+            Start-Process "https://nodejs.org/en/download/"
+            exit 1
+        }
+
+        # 刷新 PATH
+        $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
+    } else {
+        Write-Err "Node.js 是必需的 / Node.js is required"
+        Write-Info "下载地址 / Download: https://nodejs.org/"
+        exit 1
+    }
+}
+
+# ── 安装 OPC Agent ────────────────────────────────────────────
+Write-Step "🚀 安装 OPC Agent / Installing OPC Agent"
+Write-Info "npm install -g opc-agent ..."
+npm install -g opc-agent
+Write-Ok "OPC Agent 安装成功 / installed"
+
+# ── Ollama（可选）─────────────────────────────────────────────
+if (-not $SkipOllama) {
+    Write-Step "🦙 检测 Ollama / Checking Ollama"
+
+    $hasOllama = $false
+    try { ollama --version 2>$null; $hasOllama = $true } catch {}
+
+    if ($hasOllama) {
+        Write-Ok "Ollama 已安装 / installed"
+    } else {
+        Write-Warn "未检测到 Ollama / Ollama not found"
+        Write-Info "Ollama 可让你在本地运行 AI 模型（免费、数据不出门）"
+        Write-Info "Ollama lets you run AI models locally (free, private)"
+
+        if (Confirm-Action "安装 Ollama? / Install Ollama?") {
+            try {
+                winget install Ollama.Ollama --accept-package-agreements --accept-source-agreements
+                $env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")
+                Write-Ok "Ollama 安装成功 / installed"
+                $hasOllama = $true
+            } catch {
+                Write-Warn "winget 安装失败，请手动下载 / Please download manually: https://ollama.com/download"
+                Start-Process "https://ollama.com/download"
+            }
+        }
+    }
+
+    # 拉取推荐模型
+    if ($hasOllama) {
+        Write-Step "🧠 推荐模型 / Recommended Models"
+        Write-Info "推荐拉取以下模型用于本地 Agent："
+        Write-Info "  • qwen2.5:7b — 中英文对话（4.7GB）"
+        Write-Info "  • nomic-embed-text — 文本向量化（274MB）"
+
+        if (Confirm-Action "拉取推荐模型? / Pull recommended models?") {
+            Write-Info "拉取 qwen2.5:7b ... (可能需要几分钟)"
+            try { ollama pull qwen2.5:7b; Write-Ok "qwen2.5:7b ✓" } catch { Write-Warn "拉取失败，可稍后手动: ollama pull qwen2.5:7b" }
+
+            Write-Info "拉取 nomic-embed-text ..."
+            try { ollama pull nomic-embed-text; Write-Ok "nomic-embed-text ✓" } catch { Write-Warn "拉取失败，可稍后手动: ollama pull nomic-embed-text" }
+        }
+    }
+}
+
+# ── 完成 ──────────────────────────────────────────────────────
+Write-Step "🎉 安装完成！/ Installation Complete!"
+Write-Host ""
+Write-Host "┌─────────────────────────────────────────────────┐" -ForegroundColor Green
+Write-Host "│  OPC Agent 已安装成功！                          │" -ForegroundColor Green
+Write-Host "│  OPC Agent installed successfully!               │" -ForegroundColor Green
+Write-Host "│                                                  │" -ForegroundColor Green
+Write-Host "│  快速开始 / Quick Start:                         │" -ForegroundColor Green
+Write-Host "│    opc init my-agent    # 创建 Agent             │" -ForegroundColor Green
+Write-Host "│    cd my-agent; npm i                            │" -ForegroundColor Green
+Write-Host "│    opc chat             # 开始对话               │" -ForegroundColor Green
+Write-Host "│                                                  │" -ForegroundColor Green
+Write-Host "│  可视化面板 / Dashboard:                          │" -ForegroundColor Green
+Write-Host "│    opc studio                                    │" -ForegroundColor Green
+Write-Host "│                                                  │" -ForegroundColor Green
+Write-Host "│  交互式设置 / Setup wizard:                       │" -ForegroundColor Green
+Write-Host "│    opc setup                                     │" -ForegroundColor Green
+Write-Host "└─────────────────────────────────────────────────┘" -ForegroundColor Green
+Write-Host ""
+
+if (Confirm-Action "现在打开 OPC Studio? / Open OPC Studio now?") {
+    opc studio
+}

package/install.sh

@@ -0,0 +1,164 @@
+#!/bin/bash
+# ============================================================================
+# OPC Agent 一键安装脚本 (macOS / Linux / WSL)
+# 用法: curl -fsSL https://raw.githubusercontent.com/Deepleaper/opc-agent/main/install.sh | bash
+# 高级: curl -fsSL ... | bash -s -- --yes --no-ollama
+# ============================================================================
+
+set -e
+
+# ── 颜色 & Emoji ──────────────────────────────────────────────
+RED='\033[0;31m'; GREEN='\033[0;32m'; YELLOW='\033[1;33m'; BLUE='\033[0;34m'; CYAN='\033[0;36m'; NC='\033[0m'
+info()  { echo -e "${CYAN}ℹ️  $1${NC}"; }
+ok()    { echo -e "${GREEN}✅ $1${NC}"; }
+warn()  { echo -e "${YELLOW}⚠️  $1${NC}"; }
+err()   { echo -e "${RED}❌ $1${NC}"; }
+step()  { echo -e "\n${BLUE}━━━ $1 ━━━${NC}"; }
+
+# ── 参数解析 ──────────────────────────────────────────────────
+AUTO_YES=false
+SKIP_OLLAMA=false
+for arg in "$@"; do
+  case "$arg" in
+    --yes|-y)       AUTO_YES=true ;;
+    --no-ollama)    SKIP_OLLAMA=true ;;
+  esac
+done
+
+confirm() {
+  if $AUTO_YES; then return 0; fi
+  read -r -p "$(echo -e "${YELLOW}❓ $1 [Y/n]: ${NC}")" choice
+  case "$choice" in n|N|no|NO) return 1 ;; *) return 0 ;; esac
+}
+
+# ── 检测操作系统 ──────────────────────────────────────────────
+step "🔍 检测操作系统 / Detecting OS"
+OS="unknown"
+if [[ "$OSTYPE" == "darwin"* ]]; then
+  OS="macos"
+  ok "macOS detected"
+elif grep -qi microsoft /proc/version 2>/dev/null; then
+  OS="wsl"
+  ok "WSL (Windows Subsystem for Linux) detected"
+elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+  OS="linux"
+  ok "Linux detected"
+else
+  err "不支持的操作系统 / Unsupported OS: $OSTYPE"
+  exit 1
+fi
+
+# ── 检测 & 安装 Node.js ──────────────────────────────────────
+step "📦 检测 Node.js / Checking Node.js"
+NEED_NODE=false
+
+if command -v node &>/dev/null; then
+  NODE_VER=$(node -v | sed 's/v//' | cut -d. -f1)
+  if [ "$NODE_VER" -ge 18 ]; then
+    ok "Node.js $(node -v) 已安装 / installed"
+  else
+    warn "Node.js $(node -v) 版本过低，需要 18+ / version too old, need 18+"
+    NEED_NODE=true
+  fi
+else
+  warn "未检测到 Node.js / Node.js not found"
+  NEED_NODE=true
+fi
+
+if $NEED_NODE; then
+  info "将通过 nvm 安装 Node.js 22 LTS / Installing Node.js 22 via nvm"
+  if confirm "安装 Node.js 22? / Install Node.js 22?"; then
+    if command -v nvm &>/dev/null || [ -s "$HOME/.nvm/nvm.sh" ]; then
+      [ -s "$HOME/.nvm/nvm.sh" ] && . "$HOME/.nvm/nvm.sh"
+      info "nvm 已存在，安装 Node 22... / nvm found, installing Node 22..."
+    else
+      info "安装 nvm... / Installing nvm..."
+      curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
+      export NVM_DIR="$HOME/.nvm"
+      [ -s "$NVM_DIR/nvm.sh" ] && . "$NVM_DIR/nvm.sh"
+    fi
+    nvm install 22
+    nvm use 22
+    ok "Node.js $(node -v) 安装成功 / installed successfully"
+  else
+    err "Node.js 是必需的 / Node.js is required"
+    echo "手动安装 / Manual install: https://nodejs.org/"
+    exit 1
+  fi
+fi
+
+# ── 安装 OPC Agent ────────────────────────────────────────────
+step "🚀 安装 OPC Agent / Installing OPC Agent"
+info "npm install -g opc-agent ..."
+npm install -g opc-agent
+ok "OPC Agent $(opc --version 2>/dev/null || echo '') 安装成功 / installed"
+
+# ── Ollama（可选）─────────────────────────────────────────────
+if ! $SKIP_OLLAMA; then
+  step "🦙 检测 Ollama / Checking Ollama"
+
+  if command -v ollama &>/dev/null; then
+    ok "Ollama 已安装 / installed ($(ollama --version 2>/dev/null || echo 'ok'))"
+  else
+    warn "未检测到 Ollama / Ollama not found"
+    info "Ollama 可让你在本地运行 AI 模型（免费、数据不出门）"
+    info "Ollama lets you run AI models locally (free, private)"
+
+    if confirm "安装 Ollama? / Install Ollama?"; then
+      if [ "$OS" = "macos" ]; then
+        if command -v brew &>/dev/null; then
+          brew install ollama
+        else
+          info "请从 https://ollama.com/download 下载安装"
+          info "Download from https://ollama.com/download"
+          open "https://ollama.com/download" 2>/dev/null || true
+        fi
+      else
+        curl -fsSL https://ollama.com/install.sh | sh
+      fi
+      ok "Ollama 安装成功 / installed"
+    else
+      info "跳过 Ollama / Skipping Ollama"
+    fi
+  fi
+
+  # 拉取推荐模型
+  if command -v ollama &>/dev/null; then
+    step "🧠 推荐模型 / Recommended Models"
+    info "推荐拉取以下模型用于本地 Agent："
+    info "  • qwen2.5:7b — 中英文对话（4.7GB）"
+    info "  • nomic-embed-text — 文本向量化（274MB）"
+
+    if confirm "拉取推荐模型? / Pull recommended models?"; then
+      info "拉取 qwen2.5:7b ... (可能需要几分钟)"
+      ollama pull qwen2.5:7b && ok "qwen2.5:7b ✓" || warn "qwen2.5:7b 拉取失败，可稍后手动: ollama pull qwen2.5:7b"
+
+      info "拉取 nomic-embed-text ..."
+      ollama pull nomic-embed-text && ok "nomic-embed-text ✓" || warn "拉取失败，可稍后手动: ollama pull nomic-embed-text"
+    fi
+  fi
+fi
+
+# ── 启动 Studio ───────────────────────────────────────────────
+step "🎉 安装完成！/ Installation Complete!"
+echo ""
+echo -e "${GREEN}┌─────────────────────────────────────────────────┐${NC}"
+echo -e "${GREEN}│  OPC Agent 已安装成功！                          │${NC}"
+echo -e "${GREEN}│  OPC Agent installed successfully!               │${NC}"
+echo -e "${GREEN}│                                                  │${NC}"
+echo -e "${GREEN}│  快速开始 / Quick Start:                         │${NC}"
+echo -e "${GREEN}│    opc init my-agent    # 创建 Agent             │${NC}"
+echo -e "${GREEN}│    cd my-agent && npm i                          │${NC}"
+echo -e "${GREEN}│    opc chat             # 开始对话               │${NC}"
+echo -e "${GREEN}│                                                  │${NC}"
+echo -e "${GREEN}│  可视化面板 / Dashboard:                          │${NC}"
+echo -e "${GREEN}│    opc studio                                    │${NC}"
+echo -e "${GREEN}│                                                  │${NC}"
+echo -e "${GREEN}│  交互式设置 / Setup wizard:                       │${NC}"
+echo -e "${GREEN}│    opc setup                                     │${NC}"
+echo -e "${GREEN}└─────────────────────────────────────────────────┘${NC}"
+echo ""
+
+if confirm "现在打开 OPC Studio? / Open OPC Studio now?"; then
+  opc studio
+fi