foliko 1.0.19 → 1.0.20

package/README.md

@@ -25,7 +25,7 @@ npm run chat
 ## 项目结构
 
 ```
-vb-agent/
+foliko/
 ├── cli/                 # 命令行入口
 │   └── bin/foliko.js    # CLI 入口
 ├── src/                 # 核心框架

package/SPEC.md

@@ -134,7 +134,7 @@ class Plugin {
 ## 三、目录结构
 
 ```
-D:\code\vb-agent\
+D:\code\foliko\
 ├── src/
 │   ├── core/
 │   │   ├── framework.js     # 核心容器

package/docs/user-manual.md

@@ -31,7 +31,7 @@ VB-Agent 是一个基于插件的 Agent 框架，具有以下特性：
 ### 项目结构
 
 ```
-vb-agent/
+foliko/
 ├── src/                      # 核心源码
 │   ├── core/                 # 核心模块
 │   │   ├── framework.js      # 框架容器
@@ -733,7 +733,7 @@ module.exports = function(Plugin) {
 name: my-skill
 description: 我的技能描述
 license: MIT
-compatibility: vb-agent >= 1.0.0
+compatibility: foliko >= 1.0.0
 metadata:
   author: Your Name
   version: 1.0.0
@@ -753,13 +753,13 @@ Agent 可以通过 `loadSkill` 工具加载技能：
 
 ```
 用户: 帮我创建一个系统信息插件
-Agent: [调用 loadSkill 技能 vb-agent-dev]
+Agent: [调用 loadSkill 技能 foliko-dev]
 Agent: [获取插件开发指南后，按照指南创建插件]
 ```
 
 ### 6.4 内置技能
 
-- **vb-agent-dev** - VB-Agent 插件开发指南
+- **foliko-dev** - VB-Agent 插件开发指南
 - **api-patterns** - API 设计模式
 - **app-builder** - 应用程序构建
 - **architecture** - 架构设计

package/install.ps1

@@ -1,179 +1,60 @@
-# Foliko 安装脚本
-# 使用方式: irm https://raw.githubusercontent.com/user/vb-agent/main/install.ps1 | iex
+# Foliko Installer
 
-$ErrorActionPreference = "Stop"
+# Step 1: Fix execution policy first
+Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force -ErrorAction SilentlyContinue
 
-$Repo = "your-username/vb-agent"
-$InstallDir = "$env:LOCALAPPDATA\Foliko"
-
-Write-Host "Foliko 安装器" -ForegroundColor Cyan
-Write-Host "=================" -ForegroundColor Cyan
+Write-Host "Foliko Installer"
+Write-Host "================="
 Write-Host ""
 
-# 检查并安装 Node.js
-function Install-NodeJS {
-    Write-Host "正在检查 Node.js..." -ForegroundColor Cyan
-
-    if (Get-Command node -ErrorAction SilentlyContinue) {
-        Write-Host "Node.js 已安装: $(node --version)" -ForegroundColor Green
-        return $true
-    }
-
-    Write-Host "Node.js 未安装，正在安装..." -ForegroundColor Yellow
-
-    # 下载 Node.js LTS 安装包
-    $nodeUrl = "https://nodejs.org/dist/v20.11.0/node-v20.11.0-x64.msi"
-    $nodeInstaller = "$env:TEMP\node-installer.msi"
-
-    Write-Host "下载 Node.js..." -ForegroundColor Cyan
-    Invoke-WebRequest -Uri $nodeUrl -OutFile $nodeInstaller
-
-    Write-Host "安装 Node.js (需要管理员权限)..." -ForegroundColor Yellow
-    Start-Process msiexec.exe -ArgumentList "/i", $nodeInstaller, "/quiet", "/norestart" -Wait
-
-    # 刷新环境变量
-    $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
-
-    # 验证安装
-    Start-Sleep -Seconds 2
-    if (Get-Command node -ErrorAction SilentlyContinue) {
-        Write-Host "Node.js 安装成功: $(node --version)" -ForegroundColor Green
-        Remove-Item $nodeInstaller -Force -ErrorAction SilentlyContinue
-        return $true
-    }
-
-    Write-Host "Node.js 安装失败，请手动安装" -ForegroundColor Red
-    Write-Host "下载地址: https://nodejs.org/" -ForegroundColor Yellow
-    return $false
-}
-
-# 检查并安装 Python
-function Install-Python {
-    Write-Host "正在检查 Python..." -ForegroundColor Cyan
+# Step 2: Refresh PATH
+$env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
 
-    if (Get-Command python -ErrorAction SilentlyContinue) {
-        Write-Host "Python 已安装: $(python --version)" -ForegroundColor Green
-        return $true
-    }
-
-    Write-Host "Python 未安装，正在安装..." -ForegroundColor Yellow
+# Step 3: Check and install Git
+Write-Host "Checking Git..."
+if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
+    Write-Host "Git not found, installing..."
 
-    # 下载 Python 安装包
-    $pythonUrl = "https://www.python.org/ftp/python/3.12.1/python-3.12.1-amd64.exe"
-    $pythonInstaller = "$env:TEMP\python-installer.exe"
+    # Download Git for Windows
+    $gitUrl = "https://github.com/git-for-windows/git/releases/download/v2.44.0.windows.1/MinGit-2.44.0-64-bit.zip"
+    $gitInstaller = "$env:TEMP\git-installer.zip"
 
-    Write-Host "下载 Python..." -ForegroundColor Cyan
-    Invoke-WebRequest -Uri $pythonUrl -OutFile $pythonInstaller
+    Write-Host "Downloading Git..."
+    Invoke-WebRequest -Uri $gitUrl -OutFile $gitInstaller -UseBasicParsing
 
-    Write-Host "安装 Python (需要管理员权限)..." -ForegroundColor Yellow
-    # 使用静默安装参数，添加 PATH 和 pip
-    Start-Process $pythonInstaller -ArgumentList "/quiet", "InstallAllUsers=1", "PrependPath=1", "Include_pip=1" -Wait
+    Write-Host "Installing Git..."
+    Expand-Archive -Path $gitInstaller -DestinationPath "C:\Git" -Force
+    $env:Path = "C:\Git\cmd;$env:Path"
 
-    # 刷新环境变量
-    $env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
-
-    # 验证安装
-    Start-Sleep -Seconds 2
-    if (Get-Command python -ErrorAction SilentlyContinue) {
-        Write-Host "Python 安装成功: $(python --version)" -ForegroundColor Green
-        Remove-Item $pythonInstaller -Force -ErrorAction SilentlyContinue
-        return $true
+    # Verify
+    if (Get-Command git -ErrorAction SilentlyContinue) {
+        Write-Host "Git installed"
+    } else {
+        Write-Host "Git installation failed. Please install Git manually: https://git-scm.com/download/win"
     }
-
-    Write-Host "Python 安装失败，请手动安装" -ForegroundColor Red
-    Write-Host "下载地址: https://www.python.org/downloads/" -ForegroundColor Yellow
-    return $false
-}
-
-# 创建 Python 虚拟环境
-function Install-PythonVenv {
-    param([string]$venvDir)
-
-    Write-Host "正在检查 Python venv..." -ForegroundColor Cyan
-
-    if (-not (Get-Command python -ErrorAction SilentlyContinue)) {
-        Write-Host "Python 未安装，跳过 venv" -ForegroundColor Yellow
-        return $false
-    }
-
-    if (Test-Path $venvDir) {
-        Write-Host "虚拟环境已存在: $venvDir" -ForegroundColor Green
-        return $true
-    }
-
-    Write-Host "创建虚拟环境: $venvDir" -ForegroundColor Cyan
-    python -m venv $venvDir
-
-    if (Test-Path "$venvDir\Scripts\python.exe") {
-        Write-Host "虚拟环境创建成功" -ForegroundColor Green
-
-        # 激活并安装基础包
-        Write-Host "安装基础依赖..." -ForegroundColor Cyan
-        & "$venvDir\Scripts\pip.exe" install pip --upgrade
-        return $true
-    }
-
-    Write-Host "虚拟环境创建失败" -ForegroundColor Red
-    return $false
+    Remove-Item $gitInstaller -Force -ErrorAction SilentlyContinue
+} else {
+    Write-Host "Git ready"
 }
 
-# 主安装流程
-Write-Host "环境检查" -ForegroundColor Cyan
-Write-Host "-----------" -ForegroundColor Cyan
-Write-Host ""
-
-# 检查并安装依赖
-$nodeOk = Install-NodeJS
-Write-Host ""
-$pythonOk = Install-Python
-Write-Host ""
-
-if (-not $nodeOk) {
-    Write-Host "警告: Node.js 未正确安装，部分功能可能不可用" -ForegroundColor Yellow
+# Step 4: Check Node.js
+Write-Host "Checking Node.js..."
+if (-not (Get-Command npm -ErrorAction SilentlyContinue)) {
+    Write-Host "Node.js not found. Please install Node.js first: https://nodejs.org/"
+    exit 1
 }
+Write-Host "Node.js ready"
 
-if (-not $pythonOk) {
-    Write-Host "警告: Python 未正确安装，部分功能可能不可用" -ForegroundColor Yellow
-}
+# Step 5: Install Foliko
+Write-Host "Installing Foliko..."
+npm install -g foliko
 
-# 创建 Python 虚拟环境
-$venvDir = "$InstallDir\venv"
-if ($pythonOk) {
+# Step 6: Verify
+if (Get-Command foliko -ErrorAction SilentlyContinue) {
     Write-Host ""
-    $venvOk = Install-PythonVenv -venvDir $venvDir
-}
-
-# 创建安装目录
-if (-not (Test-Path $InstallDir)) {
-    New-Item -ItemType Directory -Path $InstallDir -Force | Out-Null
-}
-
-Write-Host "安装到: $InstallDir" -ForegroundColor Cyan
-Write-Host ""
-
-Push-Location $InstallDir
-
-if (Test-Path ".git") {
-    Write-Host "更新现有安装..." -ForegroundColor Cyan
-    git pull
+    Write-Host "Installation complete!"
+    Write-Host "Run: foliko chat"
 } else {
-    Write-Host "下载 Foliko..." -ForegroundColor Cyan
-    git clone https://github.com/$Repo.git .
+    Write-Host ""
+    Write-Host "Installation may have failed. Try manually: npm install -g foliko"
 }
-
-# 安装依赖
-Write-Host "安装 npm 依赖..." -ForegroundColor Cyan
-npm install
-
-# 全局链接 CLI
-Write-Host "安装 CLI..." -ForegroundColor Cyan
-npm link
-
-Pop-Location
-
-Write-Host ""
-Write-Host "安装完成!" -ForegroundColor Green
-Write-Host ""
-Write-Host "使用方法:" -ForegroundColor Yellow
-Write-Host "  foliko chat" -ForegroundColor White
-Write-Host ""

package/install.sh

@@ -0,0 +1,137 @@
+#!/bin/bash
+# Foliko Installer (macOS/Linux)
+
+set -e
+
+echo -e "\033[36mFoliko Installer\033[0m"
+echo -e "\033[36m=================\033[0m"
+echo ""
+
+# Detect OS
+detect_os() {
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+        echo "macOS"
+    elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
+        echo "Linux"
+    else
+        echo "unknown"
+    fi
+}
+
+OS=$(detect_os)
+
+# Check and install Node.js
+install_nodejs() {
+    echo -e "\033[36mChecking Node.js...\033[0m"
+
+    if command -v node &> /dev/null; then
+        echo -e "\033[32mNode.js installed: $(node --version)\033[0m"
+        return 0
+    fi
+
+    echo -e "\033[33mNode.js not found, installing...\033[0m"
+
+    if [[ "$OS" == "macOS" ]]; then
+        if command -v brew &> /dev/null; then
+            brew install node
+        else
+            echo -e "\033[33mHomebrew not found. Install it first:\033[0m"
+            echo "/bin/bash -c \"\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)\""
+            return 1
+        fi
+    elif [[ "$OS" == "Linux" ]]; then
+        if command -v apt-get &> /dev/null; then
+            sudo apt-get update
+            sudo apt-get install -y nodejs npm
+        elif command -v yum &> /dev/null; then
+            sudo yum install -y nodejs npm
+        elif command -v pacman &> /dev/null; then
+            sudo pacman -S nodejs npm
+        else
+            echo -e "\033[31mNo supported package manager found. Please install Node.js manually\033[0m"
+            echo "Download: https://nodejs.org/"
+            return 1
+        fi
+    fi
+
+    if command -v node &> /dev/null; then
+        echo -e "\033[32mNode.js installed: $(node --version)\033[0m"
+        return 0
+    fi
+
+    echo -e "\033[31mNode.js installation failed\033[0m"
+    echo "Download: https://nodejs.org/"
+    return 1
+}
+
+# Check and install Python
+install_python() {
+    echo -e "\033[36mChecking Python...\033[0m"
+
+    if command -v python3 &> /dev/null; then
+        echo -e "\033[32mPython installed: $(python3 --version)\033[0m"
+        return 0
+    fi
+
+    echo -e "\033[33mPython not found, installing...\033[0m"
+
+    if [[ "$OS" == "macOS" ]]; then
+        if command -v brew &> /dev/null; then
+            brew install python3
+        fi
+    elif [[ "$OS" == "Linux" ]]; then
+        if command -v apt-get &> /dev/null; then
+            sudo apt-get update
+            sudo apt-get install -y python3 python3-venv python3-pip
+        elif command -v yum &> /dev/null; then
+            sudo yum install -y python3
+        elif command -v pacman &> /dev/null; then
+            sudo pacman -S python python-pip
+        fi
+    fi
+
+    if command -v python3 &> /dev/null; then
+        echo -e "\033[32mPython installed: $(python3 --version)\033[0m"
+        return 0
+    fi
+
+    echo -e "\033[33mPython not installed (optional)\033[0m"
+    return 0
+}
+
+# Main installation
+echo -e "\033[36mChecking environment...\033[0m"
+echo -e "\033[36m-------------------\033[0m"
+echo ""
+
+NODE_OK=0
+PYTHON_OK=0
+
+install_nodejs || NODE_OK=1
+echo ""
+install_python || PYTHON_OK=1
+echo ""
+
+if [[ $NODE_OK -ne 0 ]]; then
+    echo -e "\033[31mError: Node.js not installed correctly\033[0m"
+    echo "Please install Node.js first: https://nodejs.org/"
+    exit 1
+fi
+
+# Install Foliko
+echo -e "\033[36mInstalling Foliko...\033[0m"
+npm install -g foliko
+
+if command -v foliko &> /dev/null; then
+    echo ""
+    echo -e "\033[32mInstallation complete!\033[0m"
+    echo ""
+    echo -e "\033[33mUsage:\033[0m"
+    echo -e "  \033[37mfoliko chat\033[0m"
+else
+    echo ""
+    echo -e "\033[31mInstallation failed, please try manually:\033[0m"
+    echo -e "  \033[37mnpm install -g foliko\033[0m"
+fi
+
+echo ""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "1.0.19",
+  "version": "1.0.20",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "bin": {
@@ -26,7 +26,7 @@
     "@ai-sdk/openai-compatible": "^2.0.35",
     "@anthropic-ai/sdk": "^0.39.0",
     "@modelcontextprotocol/sdk": "^1.27.1",
-    "@pinixai/weixin-bot": "github:chnak/weixin-bot",
+    "@pinixai/weixin-bot": "git+https://github.com/chnak/weixin-bot.git",
     "ai": "^6.0.116",
     "dotenv": "^17.3.1",
     "imap": "^0.8.19",

package/plugins/subagent-plugin.js

@@ -127,7 +127,7 @@ class SubAgentPlugin extends Plugin {
     }
 
     // 尝试从framework获取主agent
-    // 在vb-agent中，主agent通常是通过framework.createAgent创建的
+    // 在foliko中，主agent通常是通过framework.createAgent创建的
     if (this._framework._mainAgent) {
       return this._framework._mainAgent
     }

package/skills/vb-agent-dev/SKILL.md

@@ -1,14 +1,14 @@
 ---
-name: vb-agent-dev
-description: VB-Agent Framework 插件开发指南。当用户说"创建插件"、"开发插件"时立即调用此 skill。
+name: foliko-dev
+description: Foliko Framework 插件开发指南。当用户说"创建插件"、"开发插件"时立即调用此 skill。
 allowed-tools: Read, Write, Edit, Glob, Grep, Bash
 ---
 
-# VB-Agent Plugin Development Guide
+# Foliko Plugin Development Guide
 
 ## 概述
 
-VB-Agent 是一个基于插件的 Agent 框架，核心简单，通过插件扩展功能。
+Foliko 是一个基于插件的 Agent 框架，核心简单，通过插件扩展功能。
 
 ---
 

package/website/docs/configuration.html

@@ -49,6 +49,29 @@
   <div class="main-content">
     <h1>配置指南</h1>
 
+    <h2>环境变量配置 (.env)</h2>
+    <p>在项目根目录创建 <code>.env</code> 文件：</p>
+    <pre><code># AI Provider: minimax, deepseek, openai, anthropic 等
+FOLIKO_PROVIDER=minimax
+
+# AI Model（可选，不填则使用 provider 默认值）
+# MiniMax: MiniMax-M2.7
+# DeepSeek: deepseek-chat, deepseek-coder 等
+FOLIKO_MODEL=
+
+# API Base URL（可选，不填则使用 provider 默认值）
+# MiniMax: https://api.minimaxi.com/v1
+# DeepSeek: https://api.deepseek.com/v1
+FOLIKO_BASE_URL=
+
+# API Key（通用，不填则使用 provider 专用 key）
+FOLIKO_API_KEY=
+
+# Provider 专用 API Key（可选）
+DEEPSEEK_API_KEY=sk-your-deepseek-api-key
+MINIMAX_API_KEY=sk-your-minimax-api-key</code></pre>
+    <p><strong>配置优先级</strong>：命令行参数 > .env配置 > provider默认值</p>
+
     <h2>目录结构</h2>
     <p>在项目根目录创建 <code>.agent</code> 目录：</p>
     <pre><code>项目目录/
@@ -92,28 +115,159 @@ ai_base_url: https://api.minimaxi.com/v1</code></pre>
 }</code></pre>
 
     <h2>CLI 参数</h2>
+    <p>命令行参数会覆盖 .env 配置：</p>
     <table>
       <tr>
         <th>参数</th>
         <th>说明</th>
-      </tr>
-      <tr>
-        <td><code>--model</code></td>
-        <td>指定 AI 模型</td>
+        <th>示例</th>
       </tr>
       <tr>
         <td><code>--provider</code></td>
         <td>指定 AI 提供商</td>
+        <td><code>deepseek</code>, <code>minimax</code></td>
       </tr>
       <tr>
-        <td><code>--api-key</code></td>
-        <td>指定 API 密钥</td>
+        <td><code>--model</code></td>
+        <td>指定 AI 模型</td>
+        <td><code>deepseek-chat</code>, <code>MiniMax-M2.7</code></td>
       </tr>
       <tr>
         <td><code>--base-url</code></td>
         <td>指定 API 地址</td>
+        <td><code>https://api.deepseek.com/v1</code></td>
+      </tr>
+      <tr>
+        <td><code>--api-key</code></td>
+        <td>指定 API 密钥</td>
+        <td><code>sk-xxx</code></td>
       </tr>
     </table>
+
+    <h3>使用示例</h3>
+    <pre><code># 使用 .env 中的配置
+npm run chat
+
+# 指定完整配置
+foliko chat --provider deepseek --model deepseek-chat --base-url https://api.deepseek.com/v1 --api-key sk-xxx
+
+# 只指定 provider（使用 provider 默认 model 和 baseURL）
+foliko chat --provider deepseek --api-key sk-xxx
+
+# 只指定 api-key（使用 FOLIKO_PROVIDER 设定的 provider）
+foliko chat --api-key sk-xxx</code></pre>
+
+    <h2>插件配置</h2>
+
+    <h3>Telegram 插件</h3>
+    <pre><code>{
+  "telegram": {
+    "botToken": "your-bot-token",
+    "allowedChats": ["123456789"],
+    "groupMode": false,
+    "prefix": "/"
+  }
+}</code></pre>
+    <table>
+      <tr><th>配置项</th><th>说明</th><th>默认值</th></tr>
+      <tr><td>botToken</td><td>Telegram Bot Token</td><td>TELEGRAM_BOT_TOKEN 环境变量</td></tr>
+      <tr><td>allowedChats</td><td>允许的聊天 ID 数组</td><td>[] (允许所有人)</td></tr>
+      <tr><td>groupMode</td><td>是否启用群组模式</td><td>false</td></tr>
+      <tr><td>prefix</td><td>命令前缀</td><td>/</td></tr>
+    </table>
+
+    <h3>WeChat 插件</h3>
+    <pre><code>{
+  "weixin": {
+    "forceLogin": false,
+    "qrcodeTerminal": true,
+    "allowedUsers": []
+  }
+}</code></pre>
+    <table>
+      <tr><th>配置项</th><th>说明</th><th>默认值</th></tr>
+      <tr><td>forceLogin</td><td>强制重新扫码登录</td><td>false</td></tr>
+      <tr><td>qrcodeTerminal</td><td>终端渲染二维码</td><td>true</td></tr>
+      <tr><td>allowedUsers</td><td>允许的用户 ID 数组</td><td>[] (允许所有人)</td></tr>
+    </table>
+
+    <h3>Session 插件</h3>
+    <pre><code>{
+  "session": {
+    "sessionTTL": 1800000,
+    "maxSessions": 100,
+    "maxHistoryLength": 50,
+    "autoCleanup": true,
+    "cleanupInterval": 300000
+  }
+}</code></pre>
+    <table>
+      <tr><th>配置项</th><th>说明</th><th>默认值</th></tr>
+      <tr><td>sessionTTL</td><td>会话过期时间(毫秒)</td><td>30分钟</td></tr>
+      <tr><td>maxSessions</td><td>最大会话数</td><td>100</td></tr>
+      <tr><td>maxHistoryLength</td><td>最大历史消息数</td><td>50</td></tr>
+      <tr><td>autoCleanup</td><td>自动清理过期会话</td><td>true</td></tr>
+      <tr><td>cleanupInterval</td><td>清理检查间隔(毫秒)</td><td>5分钟</td></tr>
+    </table>
+
+    <h3>Storage 插件</h3>
+    <pre><code>{
+  "storage": {
+    "type": "json",
+    "path": ".agent/data",
+    "namespace": "default"
+  }
+}</code></pre>
+    <table>
+      <tr><th>配置项</th><th>说明</th><th>默认值</th></tr>
+      <tr><td>type</td><td>存储类型 (json/memory)</td><td>json</td></tr>
+      <tr><td>path</td><td>存储文件路径</td><td>.agent/data</td></tr>
+      <tr><td>namespace</td><td>命名空间</td><td>default</td></tr>
+    </table>
+
+    <h3>Scheduler 插件</h3>
+    <pre><code>{
+  "scheduler": {
+    "checkInterval": 1000
+  }
+}</code></pre>
+    <table>
+      <tr><th>配置项</th><th>说明</th><th>默认值</th></tr>
+      <tr><td>checkInterval</td><td>任务检查间隔(毫秒)</td><td>1000</td></tr>
+    </table>
+
+    <h3>Email 插件</h3>
+    <p>通过环境变量配置：</p>
+    <pre><code># SMTP 配置 (发送邮件)
+SMTP_HOST=smtp.gmail.com
+SMTP_PORT=587
+SMTP_SECURE=false
+SMTP_USER=your-email@gmail.com
+SMTP_PASS=your-app-password
+
+# IMAP 配置 (读取邮件)
+IMAP_HOST=imap.gmail.com
+IMAP_PORT=993
+IMAP_USER=your-email@gmail.com
+IMAP_PASS=your-app-password
+
+# 默认发件人
+FROM_EMAIL=your-email@gmail.com</code></pre>
+
+    <h3>MCP 配置</h3>
+    <p>在 <code>.agent/mcp_config.json</code> 中配置 MCP 服务器：</p>
+    <pre><code>{
+  "mcpServers": {
+    "fetch": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-fetch"]
+    },
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"]
+    }
+  }
+}</code></pre>
   </div>
 </body>
 </html>

package/website/docs/plugin-development.html

@@ -48,10 +48,6 @@
   <div class="main-content">
     <h1>插件开发</h1>
 
-    <div class="warning">
-      <strong>重要：</strong> 禁止创建目录！插件必须是单个 `.js` 文件。
-    </div>
-
     <h2>快速开始</h2>
     <p>在 <code>.agent/plugins/</code> 目录下创建插件文件：</p>
     <pre><code>// .agent/plugins/my-plugin.js

package/website/docs/project-structure.html

@@ -96,7 +96,7 @@
     <h1>项目结构</h1>
 
     <h2>目录结构</h2>
-    <pre><code>vb-agent/
+    <pre><code>foliko/
 ├── cli/                 # 命令行入口
 │   ├── bin/foliko.js    # CLI 入口脚本
 │   └── src/

package/website/index.html

@@ -22,14 +22,28 @@
 
   <main>
     <section id="home" class="hero">
-      <h1>Foliko</h1>
-      <p class="tagline">简约的插件化 Agent 框架</p>
-      <p class="description">
-        核心简单，功能强大。通过插件扩展无限可能。
-      </p>
-      <div class="cta-buttons">
-        <a href="#quickstart" class="btn btn-primary">快速开始</a>
-        <a href="https://github.com/your-username/vb-agent" class="btn btn-secondary">GitHub</a>
+      <div class="hero-content">
+        <h1>Foliko</h1>
+        <p class="tagline">简约的插件化 Agent 框架</p>
+
+        <div class="install-box">
+          <div class="install-tabs">
+            <button class="tab active" data-cmd="irm https://foliko.com/install.ps1 | iex">Windows</button>
+            <button class="tab" data-cmd="curl -fsSL https://foliko.com/install.sh | bash">Mac / Linux</button>
+            <button class="tab" data-cmd="npm install -g foliko">npm</button>
+          </div>
+          <div class="install-cmd">
+            <code id="install-cmd">irm https://foliko.com/install.ps1 | iex</code>
+            <button class="copy-btn" onclick="copyCmd()">复制</button>
+          </div>
+        </div>
+
+        <div class="hero-links">
+          <a href="#features">核心特性</a>
+          <a href="#quickstart">快速开始</a>
+          <a href="#docs">文档</a>
+          <a href="#plugins">插件</a>
+        </div>
       </div>
     </section>
 
@@ -72,27 +86,19 @@
     <section id="quickstart" class="quickstart">
       <h2>快速开始</h2>
 
-      <div class="code-block">
-        <h3>安装</h3>
-        <pre><code># PowerShell (Windows)
-irm https://raw.githubusercontent.com/your-username/vb-agent/main/install.ps1 | iex
-
-# 或者克隆仓库
-git clone https://github.com/your-username/vb-agent.git
-cd vb-agent
-npm install
-npm link</code></pre>
-      </div>
-
       <div class="code-block">
         <h3>配置</h3>
-        <pre><code># 创建配置目录
-mkdir .agent
+        <pre><code># 创建 .env 文件
+touch .env
 
-# 创建配置文件
-echo "ai_key: your-api-key" > .agent/config
-echo "ai_model: MiniMax-M2.7" >> .agent/config
-echo "ai_provider: minimax" >> .agent/config</code></pre>
+# 编辑 .env 添加配置
+# MiniMax 示例:
+# FOLIKO_PROVIDER=minimax
+# MINIMAX_API_KEY=sk-your-api-key
+
+# DeepSeek 示例:
+# FOLIKO_PROVIDER=deepseek
+# DEEPSEEK_API_KEY=sk-your-api-key</code></pre>
       </div>
 
       <div class="code-block">
@@ -131,53 +137,81 @@ echo "ai_provider: minimax" >> .agent/config</code></pre>
             <th>插件</th>
             <th>说明</th>
             <th>工具</th>
+            <th>配置</th>
           </tr>
         </thead>
         <tbody>
           <tr>
-            <td>AI</td>
+            <td><strong>AI</strong></td>
             <td>AI 提供商集成</td>
             <td>chat, chatStream</td>
+            <td>provider, model, apiKey, baseURL</td>
+          </tr>
+          <tr>
+            <td><strong>Session</strong></td>
+            <td>会话管理，多会话隔离、历史记录</td>
+            <td>session_create, session_get, session_list, session_delete, session_history</td>
+            <td>sessionTTL, maxSessions, maxHistoryLength</td>
+          </tr>
+          <tr>
+            <td><strong>Telegram</strong></td>
+            <td>Telegram Bot 对话</td>
+            <td>Bot 接收消息，自动对话</td>
+            <td>botToken, allowedChats, groupMode, prefix</td>
+          </tr>
+          <tr>
+            <td><strong>WeChat</strong></td>
+            <td>微信对话</td>
+            <td>Bot 接收消息，自动对话</td>
+            <td>forceLogin, qrcodeTerminal, allowedUsers</td>
           </tr>
           <tr>
-            <td>Storage</td>
-            <td>数据持久化</td>
-            <td>save, load, delete</td>
+            <td><strong>Storage</strong></td>
+            <td>数据持久化存储</td>
+            <td>storage_set, storage_get, storage_delete, storage_list, storage_clear</td>
+            <td>type (json/memory), path, namespace</td>
           </tr>
           <tr>
-            <td>Tools</td>
-            <td>内置工具集</td>
-            <td>多个工具</td>
+            <td><strong>Scheduler</strong></td>
+            <td>定时任务调度</td>
+            <td>schedule_task, schedule_list, schedule_cancel, cron_examples</td>
+            <td>checkInterval</td>
           </tr>
           <tr>
-            <td>Workflow</td>
-            <td>工作流引擎</td>
-            <td>workflow_execute</td>
+            <td><strong>Email</strong></td>
+            <td>邮件收发</td>
+            <td>email_send, email_read, email_unread_count, email_mark_read, email_configure</td>
+            <td>SMTP/IMAP 配置</td>
           </tr>
           <tr>
-            <td>Shell</td>
+            <td><strong>Shell</strong></td>
             <td>Shell 命令执行</td>
             <td>shell_execute</td>
+            <td>-</td>
           </tr>
           <tr>
-            <td>Python</td>
+            <td><strong>Python</strong></td>
             <td>Python 代码执行</td>
             <td>python_execute</td>
+            <td>-</td>
           </tr>
           <tr>
-            <td>MCP</td>
+            <td><strong>MCP</strong></td>
             <td>MCP 协议支持</td>
             <td>mcp_execute, mcp_reload</td>
+            <td>mcp_config.json</td>
           </tr>
           <tr>
-            <td>Session</td>
-            <td>会话管理</td>
-            <td>session_*</td>
+            <td><strong>Install</strong></td>
+            <td>npm 包安装</td>
+            <td>install</td>
+            <td>-</td>
           </tr>
           <tr>
-            <td>Audit</td>
+            <td><strong>Audit</strong></td>
             <td>审计日志</td>
             <td>audit_query</td>
+            <td>-</td>
           </tr>
         </tbody>
       </table>
@@ -187,7 +221,7 @@ echo "ai_provider: minimax" >> .agent/config</code></pre>
   <footer>
     <p>&copy; 2024 Foliko. MIT License.</p>
     <p>
-      <a href="https://github.com/your-username/vb-agent">GitHub</a> |
+      <a href="https://www.npmjs.com/package/foliko">npm</a> |
       <a href="docs/api.html">API 文档</a>
     </p>
   </footer>

package/website/script.js

@@ -1,3 +1,59 @@
+// Install tab switching
+document.querySelectorAll('.install-tabs .tab').forEach(tab => {
+  tab.addEventListener('click', () => {
+    document.querySelectorAll('.install-tabs .tab').forEach(t => t.classList.remove('active'));
+    tab.classList.add('active');
+    document.getElementById('install-cmd').textContent = tab.dataset.cmd;
+  });
+});
+
+// Copy install command
+function copyCmd() {
+  const code = document.getElementById('install-cmd').textContent;
+  const btn = document.querySelector('.install-cmd .copy-btn');
+
+  // 复制到剪贴板
+  if (navigator.clipboard && navigator.clipboard.writeText) {
+    navigator.clipboard.writeText(code).then(() => {
+      btn.textContent = '已复制';
+      btn.classList.add('copied');
+      setTimeout(() => {
+        btn.textContent = '复制';
+        btn.classList.remove('copied');
+      }, 2000);
+    }).catch(() => {
+      fallbackCopy(code, btn);
+    });
+  } else {
+    fallbackCopy(code, btn);
+  }
+}
+
+// 备用复制方法
+function fallbackCopy(text, btn) {
+  const textarea = document.createElement('textarea');
+  textarea.value = text;
+  textarea.style.position = 'fixed';
+  textarea.style.opacity = '0';
+  document.body.appendChild(textarea);
+  textarea.select();
+  try {
+    document.execCommand('copy');
+    btn.textContent = '已复制';
+    btn.classList.add('copied');
+    setTimeout(() => {
+      btn.textContent = '复制';
+      btn.classList.remove('copied');
+    }, 2000);
+  } catch (err) {
+    btn.textContent = '复制失败';
+    setTimeout(() => {
+      btn.textContent = '复制';
+    }, 2000);
+  }
+  document.body.removeChild(textarea);
+}
+
 // Smooth scrolling
 document.querySelectorAll('a[href^="#"]').forEach(anchor => {
   anchor.addEventListener('click', function (e) {

package/website/styles.css

@@ -69,14 +69,17 @@ nav {
 .hero {
   min-height: 100vh;
   display: flex;
-  flex-direction: column;
-  justify-content: center;
   align-items: center;
-  text-align: center;
-  padding: 6rem 2rem 4rem;
+  justify-content: center;
+  padding: 6rem 2rem;
   background: linear-gradient(180deg, var(--bg-dark) 0%, var(--bg-card) 100%);
 }
 
+.hero-content {
+  text-align: center;
+  max-width: 600px;
+}
+
 .hero h1 {
   font-size: 4rem;
   font-weight: 800;
@@ -84,27 +87,112 @@ nav {
   -webkit-background-clip: text;
   -webkit-text-fill-color: transparent;
   background-clip: text;
-  margin-bottom: 1rem;
+  margin-bottom: 0.5rem;
 }
 
 .tagline {
   font-size: 1.5rem;
   color: var(--text-secondary);
-  margin-bottom: 1rem;
+  margin-bottom: 2rem;
+}
+
+/* Install Box */
+.install-box {
+  background: var(--bg-card);
+  border: 1px solid var(--border);
+  border-radius: 12px;
+  overflow: hidden;
+  margin: 0 auto 2rem;
+  text-align: left;
+  min-width: 600px;
+}
+
+.install-tabs {
+  display: flex;
+  background: var(--bg-dark);
+  border-bottom: 1px solid var(--border);
 }
 
-.description {
-  font-size: 1.1rem;
+.install-tabs .tab {
+  flex: 1;
+  min-width: 100px;
+  padding: 0.75rem 1rem;
+  background: transparent;
+  border: none;
   color: var(--text-secondary);
-  max-width: 600px;
-  margin-bottom: 2rem;
+  font-size: 0.9rem;
+  cursor: pointer;
+  transition: all 0.2s;
+}
+
+.install-tabs .tab:hover {
+  color: var(--text-primary);
+  background: rgba(255,255,255,0.03);
 }
 
-.cta-buttons {
+.install-tabs .tab.active {
+  color: var(--primary);
+  background: var(--bg-card);
+}
+
+.install-cmd {
   display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 1rem 1.25rem;
   gap: 1rem;
 }
 
+.install-cmd code {
+  font-family: 'SF Mono', Monaco, 'Cascadia Code', monospace;
+  font-size: 0.9rem;
+  color: var(--secondary);
+  flex: 1;
+}
+
+.copy-btn {
+  background: transparent;
+  color: var(--text-secondary);
+  border: 1px solid var(--border);
+  border-radius: 6px;
+  padding: 0.4rem 0.75rem;
+  font-size: 0.8rem;
+  cursor: pointer;
+  transition: all 0.2s;
+  white-space: nowrap;
+}
+
+.copy-btn:hover {
+  color: var(--text-primary);
+  border-color: var(--primary);
+  background: rgba(99, 102, 241, 0.1);
+}
+
+.copy-btn.copied {
+  color: #22c55e;
+  border-color: #22c55e;
+  background: rgba(34, 197, 94, 0.1);
+}
+
+/* Hero Links */
+.hero-links {
+  display: flex;
+  justify-content: center;
+  gap: 1.5rem;
+  flex-wrap: wrap;
+}
+
+.hero-links a {
+  color: var(--text-secondary);
+  text-decoration: none;
+  font-size: 0.95rem;
+  transition: color 0.2s;
+}
+
+.hero-links a:hover {
+  color: var(--primary);
+}
+
 .btn {
   padding: 0.75rem 1.5rem;
   border-radius: 8px;
@@ -288,10 +376,39 @@ footer a:hover {
 
 /* Responsive */
 @media (max-width: 768px) {
+  .hero {
+    padding: 5rem 1rem 3rem;
+    min-height: auto;
+  }
+
   .hero h1 {
     font-size: 2.5rem;
   }
 
+  .hero .tagline {
+    font-size: 1.2rem;
+  }
+
+  .install-box {
+    min-width: auto;
+    width: 100%;
+  }
+
+  .install-tabs .tab {
+    min-width: 80px;
+    padding: 0.6rem 0.5rem;
+    font-size: 0.8rem;
+  }
+
+  .install-cmd code {
+    font-size: 0.75rem;
+    word-break: break-all;
+  }
+
+  .hero-links {
+    gap: 1rem;
+  }
+
   .nav-links {
     display: none;
   }