foliko 1.0.0 → 1.0.2

package/.claude/settings.local.json

@@ -24,7 +24,9 @@
       "Bash(cd D:/Code/vb-agent && node test-stream-emoji.js 2>&1)",
       "Read(//d/Date/20260321/app/**)",
       "Bash(node -e \":*)",
-      "Bash(node -e \"\nconst { loadAgentConfig } = require\\('./plugins/default-plugins'\\);\nconst config = loadAgentConfig\\('D:/Date/20260321/app/.agent'\\);\nconsole.log\\('skillsDirs:', config.skillsDirs\\);\n\")"
+      "Bash(node -e \"\nconst { loadAgentConfig } = require\\('./plugins/default-plugins'\\);\nconst config = loadAgentConfig\\('D:/Date/20260321/app/.agent'\\);\nconsole.log\\('skillsDirs:', config.skillsDirs\\);\n\")",
+      "Bash(cd D:/Code/vb-agent && pnpm install --shamefully-hoist 2>&1 | head -20)",
+      "Bash(cd D:/Code/vb-agent && rm -rf node_modules && pnpm install)"
     ]
   }
 }

package/README.md

@@ -1,217 +1,177 @@
-# JavaScript 测试代码示例
+# Foliko
 
-这个项目展示了现代 JavaScript 测试的最佳实践，使用 Jest 作为测试框架。
+简约的插件化 Agent 框架
 
-## 文件结构
+## 特性
 
-- `test-example.js` - 完整的测试示例，包含多种测试类型
-- `simple-test-example.js` - 简洁的测试示例，适合初学者
-- `package.json` - 项目配置和 Jest 设置
+- **插件化架构** - 核心简单，通过插件扩展功能
+- **流式输出** - 支持实时流式输出
+- **多 AI 支持** - 支持 Anthropic、DeepSeek、MiniMax 等
+- **内置工具** - Shell、Python、MCP、文件系统等
+- **技能系统** - 可扩展的 Skill 管理
+- **会话管理** - 支持多会话切换
+- **规则引擎** - 可配置的行为规则
 
-## 包含的测试类型
+## 快速开始
 
-### 1. 单元测试
-- 函数测试
-- 类方法测试
-- 边界情况测试
-- 异常测试
-
-### 2. 异步测试
-- Promise 测试
-- async/await 测试
-- 超时处理
-
-### 3. 集成测试
-- 多个类的组合测试
-- 完整流程测试
-
-### 4. Mock 和 Spy
-- 模拟函数
-- 模拟 API 调用
-- 验证函数调用
-
-### 5. 参数化测试
-- 使用 `test.each` 测试多组数据
-
-### 6. 快照测试
-- 对象结构验证
-
-## 最佳实践展示
+```bash
+# 安装
+npm install
 
-### 1. AAA 模式 (Arrange-Act-Assert)
-```javascript
-test('应该正确计算两个数的和', () => {
-  // Arrange: 准备测试数据
-  const a = 5;
-  const b = 3;
-  const expected = 8;
-
-  // Act: 执行被测试的方法
-  const result = calculator.add(a, b);
-
-  // Assert: 验证结果
-  expect(result).toBe(expected);
-});
+# 启动聊天
+npm run chat
 ```
 
-### 2. 描述性测试名称
-- 使用 "should" 描述预期行为
-- 包含测试条件
-- 清晰表达测试目的
-
-### 3. 测试隔离
-- 每个测试独立运行
-- 使用 `beforeEach` 重置状态
-- 避免测试间的依赖
+## 项目结构
 
-### 4. 恰当的断言
-- 使用合适的匹配器
-- 验证异常
-- 检查异步结果
-
-### 5. 测试覆盖率
-- 行覆盖率
-- 分支覆盖率
-- 函数覆盖率
-- 语句覆盖率
-
-## 安装和运行
-
-### 1. 安装依赖
-```bash
-npm install
+```
+vb-agent/
+├── cli/                 # 命令行入口
+│   └── bin/foliko.js    # CLI 入口
+├── src/                 # 核心框架
+│   ├── core/            # 核心组件
+│   ├── capabilities/    # 能力插件
+│   └── executors/       # 执行器
+├── plugins/             # 内置插件
+├── skills/              # 技能目录
+└── examples/            # 示例
 ```
 
-### 2. 运行测试
-```bash
-# 运行所有测试
-npm test
+## 配置
 
-# 监视模式（文件变化时自动运行）
-npm run test:watch
+在项目根目录创建 `.agent` 目录：
 
-# 生成覆盖率报告
-npm run test:coverage
+```
+.agent/
+├── config              # 配置文件
+├── ai.json            # AI 配置
+├── mcp_config.json    # MCP 服务器配置
+├── plugins/           # 用户插件目录
+├── skills/            # 用户技能目录
+└── data/              # 数据目录
+```
 
-# 详细输出
-npm run test:verbose
+### config 文件格式
 
-# 更新快照
-npm run test:update
+```
+ai_key: your-api-key
+ai_model: MiniMax-M2.7
+ai_provider: minimax
 ```
 
-### 3. 查看覆盖率报告
-运行 `npm run test:coverage` 后，打开 `coverage/index.html` 查看详细的覆盖率报告。
+### ai.json 格式
 
-## Jest 配置说明
+```json
+{
+  "provider": "minimax",
+  "model": "MiniMax-M2.7",
+  "apiKey": "your-api-key",
+  "baseURL": "https://api.minimaxi.com/v1"
+}
+```
 
-在 `package.json` 中的 Jest 配置：
+### mcp_config.json 格式
 
 ```json
 {
-  "jest": {
-    "testEnvironment": "node",          // 测试环境
-    "verbose": true,                    // 详细输出
-    "collectCoverage": true,            // 收集覆盖率
-    "coverageDirectory": "coverage",    // 覆盖率输出目录
-    "coverageReporters": ["text", "lcov", "html"], // 报告格式
-    "coverageThreshold": {              // 覆盖率阈值
-      "global": {
-        "branches": 80,
-        "functions": 80,
-        "lines": 80,
-        "statements": 80
-      }
-    },
-    "testMatch": [                      // 测试文件匹配模式
-      "**/__tests__/**/*.js",
-      "**/?(*.)+(spec|test).js"
-    ],
-    "testTimeout": 10000,               // 测试超时时间
-    "clearMocks": true,                 // 自动清理 mock
-    "resetMocks": true,                 // 重置 mock
-    "restoreMocks": true                // 恢复原始实现
+  "mcpServers": {
+    "fetch": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-fetch"]
+    }
   }
 }
 ```
 
-## 测试技巧
+## 开发插件
+
+### 用户插件（.agent/plugins/）
 
-### 1. 测试异步代码
 ```javascript
-// 使用 async/await
-test('应该异步返回数据', async () => {
-  const result = await fetchData();
-  expect(result).toEqual({ data: '测试数据' });
-});
-
-// 测试异步异常
-test('应该抛出异步错误', async () => {
-  await expect(asyncFunction()).rejects.toThrow('错误信息');
-});
+// .agent/plugins/my-plugin.js
+module.exports = function(Plugin) {
+  return class MyPlugin extends Plugin {
+    constructor(config = {}) {
+      super()
+      this.name = 'my-plugin'
+      this.version = '1.0.0'
+      this.description = '我的工具插件'
+      this.priority = 10
+    }
+
+    install(framework) {
+      const { z } = require('zod')
+      framework.registerTool({
+        name: 'my_tool',
+        description: '我的工具',
+        inputSchema: z.object({
+          param: z.string().describe('参数描述')
+        }),
+        execute: async (args, framework) => {
+          return { success: true, result: args.param }
+        }
+      })
+      return this
+    }
+  }
+}
 ```
 
-### 2. Mock 函数
-```javascript
-// 创建 mock 函数
-const mockFn = jest.fn();
+**注意**：如果插件需要第三方库（如 `zod`），需要先安装：
 
-// 设置返回值
-mockFn.mockReturnValue('返回值');
+1. 创建插件文件
+2. 调用 `install` 工具安装依赖
+3. 热重载插件
 
-// 验证调用
-expect(mockFn).toHaveBeenCalledTimes(1);
-expect(mockFn).toHaveBeenCalledWith('参数');
-```
+### 技能开发
 
-### 3. 参数化测试
-```javascript
-test.each([
-  [1, 1, 2],
-  [1, 2, 3],
-  [2, 1, 3],
-])('add(%i, %i) should equal %i', (a, b, expected) => {
-  expect(a + b).toBe(expected);
-});
+在 `.agent/skills/` 下创建技能：
+
+```
+.agent/skills/my-skill/
+└── SKILL.md
 ```
 
-### 4. 快照测试
-```javascript
-test('对象应该匹配快照', () => {
-  const obj = {
-    id: 1,
-    name: '测试',
-    date: new Date('2024-01-01')
-  };
-  
-  expect(obj).toMatchSnapshot({
-    date: expect.any(Date) // 忽略具体日期值
-  });
-});
+SKILL.md 格式：
+
+```markdown
+---
+name: my-skill
+description: 技能描述
+allowed-tools: tool1,tool2
+---
+
+技能内容...
 ```
 
-## 常见问题
+## CLI 命令
 
-### 1. 测试运行太慢
-- 减少不必要的异步等待
-- 使用 `jest.useFakeTimers()` 模拟时间
-- 避免在测试中执行真实 API 调用
+```bash
+# 聊天模式
+foliko chat
+
+# 指定模型
+foliko chat --model gpt-4
+
+# 指定 API
+foliko chat --api-key xxx
+```
 
-### 2. 测试不稳定（Flaky Tests）
-- 确保测试独立
-- 避免依赖外部状态
-- 使用固定的测试数据
+## 内置工具
 
-### 3. 覆盖率不足
-- 添加边界情况测试
-- 测试错误处理路径
-- 验证所有分支条件
+| 工具 | 说明 |
+|------|------|
+| `loadSkill` | 加载技能 |
+| `mcp_execute` | 执行 MCP 工具 |
+| `shell_execute` | 执行 Shell 命令 |
+| `python_execute` | 执行 Python 代码 |
+| `install` | 安装 npm 包 |
+| `mcp_reload` | 重载 MCP 服务器 |
+| `audit_query` | 查询审计日志 |
 
-## 扩展阅读
+## 工作目录
 
-- [Jest 官方文档](https://jestjs.io/)
-- [测试金字塔原则](https://martinfowler.com/bliki/TestPyramid.html)
-- [AAA 测试模式](https://medium.com/@pjbgf/title-testing-code-ocd-and-the-aaa-pattern-df453975ab80)
+CLI 工作目录默认使用执行命令的目录。
 
 ## 许可证
 

package/cli/src/ui/chat-ui.js

@@ -208,6 +208,20 @@ class ChatUI extends EventEmitter {
     console.log(colored('Agent:', GREEN))
     console.log()
 
+    // 用于打断的标志
+    let interrupted = false
+
+    // 设置打断处理
+    const interruptHandler = () => {
+      if (!interrupted) {
+        interrupted = true
+        console.log(`\n${colored('[中断]', RED)} 输出已中断`)
+      }
+    }
+
+    // 监听 Ctrl+C
+    process.on('SIGINT', interruptHandler)
+
     try {
       let lineBuffer = ''
       // 渲染状态追踪
@@ -233,6 +247,9 @@ class ChatUI extends EventEmitter {
       }
 
       for await (const chunk of this.agent.chatStream(message)) {
+        // 检查是否被打断
+        if (interrupted) break
+
         if (chunk.type === 'text') {
           lineBuffer += chunk.text
 
@@ -243,6 +260,9 @@ class ChatUI extends EventEmitter {
 
           // 当有一行完整内容时，渲染并输出
           while (lineBuffer.includes('\n')) {
+            // 检查是否被打断
+            if (interrupted) break
+
             const nlIndex = lineBuffer.indexOf('\n')
             const line = lineBuffer.substring(0, nlIndex)
             lineBuffer = lineBuffer.substring(nlIndex + 1)
@@ -258,11 +278,16 @@ class ChatUI extends EventEmitter {
       }
 
       // 输出剩余内容
-      if (lineBuffer.trim()) {
+      if (lineBuffer.trim() && !interrupted) {
         console.log(renderLine(lineBuffer, renderState))
       }
     } catch (err) {
-      console.error(`\n${colored('[错误]', RED)} ${err.message}\n`)
+      if (!interrupted) {
+        console.error(`\n${colored('[错误]', RED)} ${err.message}\n`)
+      }
+    } finally {
+      // 移除监听器
+      process.removeListener('SIGINT', interruptHandler)
     }
 
     this.prompt()

package/install.ps1

@@ -0,0 +1,179 @@
+# Foliko 安装脚本
+# 使用方式: irm https://raw.githubusercontent.com/user/vb-agent/main/install.ps1 | iex
+
+$ErrorActionPreference = "Stop"
+
+$Repo = "your-username/vb-agent"
+$InstallDir = "$env:LOCALAPPDATA\Foliko"
+
+Write-Host "Foliko 安装器" -ForegroundColor Cyan
+Write-Host "=================" -ForegroundColor Cyan
+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
+
+    if (Get-Command python -ErrorAction SilentlyContinue) {
+        Write-Host "Python 已安装: $(python --version)" -ForegroundColor Green
+        return $true
+    }
+
+    Write-Host "Python 未安装，正在安装..." -ForegroundColor Yellow
+
+    # 下载 Python 安装包
+    $pythonUrl = "https://www.python.org/ftp/python/3.12.1/python-3.12.1-amd64.exe"
+    $pythonInstaller = "$env:TEMP\python-installer.exe"
+
+    Write-Host "下载 Python..." -ForegroundColor Cyan
+    Invoke-WebRequest -Uri $pythonUrl -OutFile $pythonInstaller
+
+    Write-Host "安装 Python (需要管理员权限)..." -ForegroundColor Yellow
+    # 使用静默安装参数，添加 PATH 和 pip
+    Start-Process $pythonInstaller -ArgumentList "/quiet", "InstallAllUsers=1", "PrependPath=1", "Include_pip=1" -Wait
+
+    # 刷新环境变量
+    $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
+    }
+
+    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
+}
+
+# 主安装流程
+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
+}
+
+if (-not $pythonOk) {
+    Write-Host "警告: Python 未正确安装，部分功能可能不可用" -ForegroundColor Yellow
+}
+
+# 创建 Python 虚拟环境
+$venvDir = "$InstallDir\venv"
+if ($pythonOk) {
+    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
+} else {
+    Write-Host "下载 Foliko..." -ForegroundColor Cyan
+    git clone https://github.com/$Repo.git .
+}
+
+# 安装依赖
+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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "bin": {
@@ -31,6 +31,6 @@
     "marked": "^11.2.0",
     "marked-terminal": "6",
     "node-cron": "^4.2.1",
-    "zod": "^4.3.6"
+    "zod": "^3.24.0"
   }
 }

package/plugins/default-plugins.js

@@ -342,6 +342,15 @@ async function bootstrapDefaults(framework, config = {}) {
     console.log('[Bootstrap] Think Plugin already loaded, skipping')
   }
 
+  // 12.5 Python 插件加载器
+  if (!framework.pluginManager.has('python-plugin-loader')) {
+    const { PythonPluginLoader } = require('./python-plugin-loader')
+    await framework.loadPlugin(new PythonPluginLoader({ agentDir: agentConfig.agentDir }))
+    console.log('[Bootstrap] Python Plugin Loader loaded')
+  } else {
+    console.log('[Bootstrap] Python Plugin Loader already loaded, skipping')
+  }
+
   // 13. 加载自定义插件
   await loadCustomPlugins(framework, agentConfig)
 

package/plugins/python-executor-plugin.js

@@ -42,10 +42,10 @@ class PythonExecutorPlugin extends Plugin {
   }
 
   start(framework) {
-    // 注册 python 工具
+    // 注册 python-execute 工具
     framework.registerTool({
-      name: 'python',
-      description: '执行 Python 代码',
+      name: 'python-execute',
+      description: '执行 Python 代码，禁止传入无用的emoji',
       inputSchema: z.object({
         code: z.string().describe('Python 代码'),
         timeout: z.number().optional().describe('超时时间（毫秒），默认 120000')