foliko 1.0.29 → 1.0.30

package/.claude/settings.local.json

@@ -1,78 +1,78 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(grep -r \"dotenv\" \"D:/Code/vb-agent/\" --include=\"*.json\" 2>/dev/null | head -20)",
-      "Bash(cd \"D:/Code/vb-agent\" && pnpm add dotenv)",
-      "Bash(cd \"D:/Code/vb-agent\" && node -e \"const ai = require\\('ai'\\); console.log\\(Object.keys\\(ai\\).filter\\(k => k.toLowerCase\\(\\).includes\\('reason'\\) || k.toLowerCase\\(\\).includes\\('split'\\) || k.toLowerCase\\(\\).includes\\('think'\\)\\)\\)\")",
-      "Bash(cd \"D:/Code/vb-agent\" && node -e \"const ai = require\\('ai'\\); console.log\\(typeof ai.extractReasoningMiddleware, ai.extractReasoningMiddleware.toString\\(\\).substring\\(0, 500\\)\\)\")",
-      "Bash(cd \"D:/Code/vb-agent\" && node -e \"\nconst ai = require\\('ai'\\);\nconsole.log\\('=== extractReasoningMiddleware ==='\\);\nconsole.log\\(ai.extractReasoningMiddleware.toString\\(\\)\\);\nconsole.log\\('\\\\n=== isReasoningUIPart ==='\\);\nconsole.log\\(typeof ai.isReasoningUIPart\\);\n\")",
-      "Bash(cd \"D:/Code/vb-agent\" && node -e \"const ai = require\\('ai'\\); console.log\\(Object.keys\\(ai\\).filter\\(k => k.toLowerCase\\(\\).includes\\('split'\\)\\)\\)\")",
-      "Bash(cd \"D:/Code/vb-agent\" && pnpm add ink react)",
-      "Bash(cd \"D:/Code/vb-agent\" && node cli/bin/foliko.js --help)",
-      "Bash(cd \"D:/Code/vb-agent\" && timeout 2 node cli/bin/foliko.js chat 2>&1 || true)",
-      "Bash(cd \"D:/Code/vb-agent\" && node -e \"const mt = require\\('marked-terminal'\\); console.log\\(typeof mt, Object.keys\\(mt\\)\\)\")",
-      "Bash(cd \"D:/Code/vb-agent\" && timeout 3 node cli/bin/foliko.js chat 2>&1 || true)",
-      "Bash(echo \"你好\" | node cli/bin/foliko.js chat 2>&1 | head -50)",
-      "Bash(printf '思考一下1+1等于几\\\\n' | node cli/bin/foliko.js chat 2>&1 | head -100)",
-      "Bash(printf '1+1等于几\\\\n' | node cli/bin/foliko.js chat 2>&1)",
-      "Bash(node -e \"\nconst { renderLine } = require\\('./cli/src/utils/markdown'\\)\nconsole.log\\(renderLine\\('🎉 这是一个 emoji'\\)\\)\nconsole.log\\(renderLine\\('**粗体** 和 🎉'\\)\\)\n\")",
-      "Bash(node -e \"\nconst { render } = require\\('./cli/src/utils/markdown'\\)\nconst text = '🎉 今天是个好日子\\\\n## 标题\\\\n- 列表项1\\\\n- 列表项2'\nconsole.log\\(render\\(text\\)\\)\n\")",
-      "Bash(node -e \"\nconst { renderLine } = require\\('./cli/src/utils/markdown'\\)\n\n// 模拟emoji被截断的情况\nconst emoji = '🎉'\nconsole.log\\('完整的 emoji:', renderLine\\(emoji\\)\\)\n\n// 模拟截断 - emoji的UTF-8字节是 \\\\xF0\\\\x9F\\\\x8E\\\\x89\nconst partial = '\\\\xF0\\\\x9F'  // 不完整的emoji\nconsole.log\\('截断的 emoji:', renderLine\\(partial\\)\\)\n\")",
-      "Bash(node -e \"\nconst isIncompleteUTF8 = \\(str\\) => {\n  if \\(!str || str.length === 0\\) return false\n  const lastChar = str.charCodeAt\\(str.length - 1\\)\n  if \\(lastChar >= 0x80 && lastChar < 0xC0\\) return true\n  return false\n}\n\n// 测试各种emoji\nconst tests = ['🎉', '📁', '⚡', '🛠️', '🔑', '💾', '📝', '⏰', '🔌', '📋']\ntests.forEach\\(e => {\n  console.log\\(e, '完整:', !isIncompleteUTF8\\(e\\)\\)\n}\\)\n\n// 测试被截断的emoji \\(只保留第一字节\\)\nconst broken = '🎉'.slice\\(0, 1\\)\nconsole.log\\('截断emoji:', broken, '检测:', isIncompleteUTF8\\(broken\\)\\)\n\")",
-      "Bash(node -e \"\nconst { renderLine } = require\\('./cli/src/utils/markdown'\\)\nconsole.log\\('测试:', renderLine\\('📁 文件操作：读取、创建'\\)\\)\n\")",
-      "Bash(node -e \"\nconst hasIncompleteSurrogate = \\(str\\) => {\n  if \\(!str || str.length === 0\\) return false\n  const lastChar = str.charCodeAt\\(str.length - 1\\)\n  console.log\\('检查:', str, 'lastChar:', lastChar.toString\\(16\\), '范围:', \\(lastChar >= 0xD800 && lastChar <= 0xDBFF\\)\\)\n  return lastChar >= 0xD800 && lastChar <= 0xDBFF\n}\n\nconst chunk1 = '\\\\xD83C'\nconsole.log\\('结果:', hasIncompleteSurrogate\\(chunk1\\)\\)\n\")",
-      "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(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)",
-      "Bash(cd D:/Code/vb-agent && timeout 8 node test-tg.js 2>&1 || true)",
-      "Bash(cd D:/Code/vb-agent && timeout 10 node test-tg.js 2>&1 || true)",
-      "Bash(find /d/Code/vb-agent -name \"*email*\" -type f 2>/dev/null | grep -v node_modules | grep -v .git)",
-      "Bash(find /d/Code/vb-agent -maxdepth 2 -name \"*.md\" -type f 2>/dev/null | grep -v node_modules)",
-      "Bash(node -c plugins/default-plugins.js && node -c src/core/plugin-manager.js && echo \"Syntax OK\")",
-      "Bash(node -c plugins/install-plugin.js && echo \"Syntax OK\")",
-      "Bash(node -c cli/src/ui/chat-ui.js && echo \"Syntax OK\")",
-      "Bash(node -c plugins/default-plugins.js && echo \"Syntax OK\")",
-      "Bash(node -c plugins/scheduler-plugin.js && echo \"Syntax OK\")",
-      "Bash(node -c plugins/telegram-plugin.js && node -c plugins/scheduler-plugin.js && echo \"Syntax OK\")",
-      "Bash(node -c plugins/telegram-plugin.js && echo \"Syntax OK\")",
-      "WebSearch",
-      "Bash(npm ls:*)",
-      "Bash(cd node_modules/@chnak/weixin-bot && npm run build 2>&1)",
-      "Bash(cd node_modules/@chnak/weixin-bot && npx tsc 2>&1)",
-      "Bash(npm install:*)",
-      "Bash(cd node_modules/@chnak/weixin-bot && npx typescript --version && npx tsc 2>&1)",
-      "Bash(npx tsc:*)",
-      "Bash(node --check /d/Code/vb-agent/plugins/weixin-plugin.js 2>&1)",
-      "Bash(node --check /d/Code/vb-agent/plugins/telegram-plugin.js && node --check /d/Code/vb-agent/plugins/weixin-plugin.js && echo \"OK\")",
-      "Bash(node --check /d/Code/vb-agent/cli/src/ui/chat-ui.js && echo \"OK\")",
-      "Bash(npm uninstall:*)",
-      "Bash(rm -rf /tmp/weixin-bot && git clone https://github.com/chnak/weixin-bot.git /tmp/weixin-bot 2>&1)",
-      "Bash(mkdir -p node_modules/@chnak/weixin-bot && cp -r /tmp/weixin-bot/nodejs/* node_modules/@chnak/weixin-bot/ && cd node_modules/@chnak/weixin-bot && npm install 2>&1)",
-      "Bash(node --check /d/Code/vb-agent/plugins/weixin-plugin.js && echo \"OK\")",
-      "Bash(node -e \"import\\('@chnak/weixin-bot'\\).then\\(m => console.log\\('OK:', Object.keys\\(m\\)\\)\\).catch\\(e => console.error\\('Error:', e.message\\)\\)\")",
-      "Bash(npm run:*)",
-      "Bash(node -e \"const { WeixinBot } = require\\('@chnak/weixin-bot'\\); console.log\\(typeof WeixinBot\\)\" 2>&1)",
-      "Bash(node -e \"import\\('@chnak/weixin-bot'\\).then\\(m => console.log\\('OK:', typeof m.WeixinBot\\)\\).catch\\(e => console.error\\('Error:', e.message\\)\\)\" 2>&1)",
-      "Bash(ls -la D:/code/vb-agent/cli/bin/ && cat D:/code/vb-agent/cli/bin/*.js 2>/dev/null | head -50)",
-      "Bash(npm config:*)",
-      "Bash(node -c plugins/subagent-plugin.js 2>&1)",
-      "Bash(node -c plugins/default-plugins.js 2>&1)",
-      "Bash(node -c plugins/default-plugins.js && node -c src/core/plugin-manager.js && node -c plugins/tools-plugin.js 2>&1)",
-      "Bash(node -c src/core/plugin-base.js && node -c src/core/plugin-manager.js 2>&1)",
-      "Bash(node -c plugins/telegram-plugin.js && node -c plugins/weixin-plugin.js 2>&1)",
-      "Bash(node -c src/core/plugin-manager.js 2>&1)",
-      "Bash(node -c src/core/plugin-manager.js && node -c src/core/plugin-base.js && node -c plugins/default-plugins.js && node -c plugins/telegram-plugin.js && node -c plugins/weixin-plugin.js 2>&1)",
-      "Bash(node -e \"require\\('dotenv'\\).config\\(\\); console.log\\('PROVIDER:', process.env.FOLIKO_PROVIDER\\); console.log\\('MODEL:', process.env.FOLIKO_MODEL\\); console.log\\('KEY:', process.env.DEEPSEEK_API_KEY ? 'set' : 'not set'\\)\" 2>&1)",
-      "Bash(node cli/src/index.js chat 2>&1 | head -30)",
-      "Bash(node -e 'const { DEFAULT_PROVIDERS } = require\\(\"./src/core/provider\"\\); console.log\\(DEFAULT_PROVIDERS\\);')",
-      "Bash(node -e \"const dotenv = require\\('dotenv'\\); const result = dotenv.config\\(\\); console.log\\('Result:', result\\); console.log\\('PROVIDER after dotenv:', process.env.FOLIKO_PROVIDER\\);\" 2>&1)",
-      "Bash(node -c plugins/email.js && node -c plugins/default-plugins.js 2>&1)",
-      "Bash(node -c plugins/email.js 2>&1)",
-      "Bash(npm list:*)",
-      "Bash(node -e \"const {EmailPlugin} = require\\('./plugins/email'\\); const p = new EmailPlugin\\(\\); console.log\\('email plugin loaded ok'\\); console.log\\('enabled:', p.enabled\\); console.log\\('version:', p.version\\);\" 2>&1)"
-    ]
-  }
-}
+{
+  "permissions": {
+    "allow": [
+      "Bash(grep -r \"dotenv\" \"D:/Code/vb-agent/\" --include=\"*.json\" 2>/dev/null | head -20)",
+      "Bash(cd \"D:/Code/vb-agent\" && pnpm add dotenv)",
+      "Bash(cd \"D:/Code/vb-agent\" && node -e \"const ai = require\\('ai'\\); console.log\\(Object.keys\\(ai\\).filter\\(k => k.toLowerCase\\(\\).includes\\('reason'\\) || k.toLowerCase\\(\\).includes\\('split'\\) || k.toLowerCase\\(\\).includes\\('think'\\)\\)\\)\")",
+      "Bash(cd \"D:/Code/vb-agent\" && node -e \"const ai = require\\('ai'\\); console.log\\(typeof ai.extractReasoningMiddleware, ai.extractReasoningMiddleware.toString\\(\\).substring\\(0, 500\\)\\)\")",
+      "Bash(cd \"D:/Code/vb-agent\" && node -e \"\nconst ai = require\\('ai'\\);\nconsole.log\\('=== extractReasoningMiddleware ==='\\);\nconsole.log\\(ai.extractReasoningMiddleware.toString\\(\\)\\);\nconsole.log\\('\\\\n=== isReasoningUIPart ==='\\);\nconsole.log\\(typeof ai.isReasoningUIPart\\);\n\")",
+      "Bash(cd \"D:/Code/vb-agent\" && node -e \"const ai = require\\('ai'\\); console.log\\(Object.keys\\(ai\\).filter\\(k => k.toLowerCase\\(\\).includes\\('split'\\)\\)\\)\")",
+      "Bash(cd \"D:/Code/vb-agent\" && pnpm add ink react)",
+      "Bash(cd \"D:/Code/vb-agent\" && node cli/bin/foliko.js --help)",
+      "Bash(cd \"D:/Code/vb-agent\" && timeout 2 node cli/bin/foliko.js chat 2>&1 || true)",
+      "Bash(cd \"D:/Code/vb-agent\" && node -e \"const mt = require\\('marked-terminal'\\); console.log\\(typeof mt, Object.keys\\(mt\\)\\)\")",
+      "Bash(cd \"D:/Code/vb-agent\" && timeout 3 node cli/bin/foliko.js chat 2>&1 || true)",
+      "Bash(echo \"你好\" | node cli/bin/foliko.js chat 2>&1 | head -50)",
+      "Bash(printf '思考一下1+1等于几\\\\n' | node cli/bin/foliko.js chat 2>&1 | head -100)",
+      "Bash(printf '1+1等于几\\\\n' | node cli/bin/foliko.js chat 2>&1)",
+      "Bash(node -e \"\nconst { renderLine } = require\\('./cli/src/utils/markdown'\\)\nconsole.log\\(renderLine\\('🎉 这是一个 emoji'\\)\\)\nconsole.log\\(renderLine\\('**粗体** 和 🎉'\\)\\)\n\")",
+      "Bash(node -e \"\nconst { render } = require\\('./cli/src/utils/markdown'\\)\nconst text = '🎉 今天是个好日子\\\\n## 标题\\\\n- 列表项1\\\\n- 列表项2'\nconsole.log\\(render\\(text\\)\\)\n\")",
+      "Bash(node -e \"\nconst { renderLine } = require\\('./cli/src/utils/markdown'\\)\n\n// 模拟emoji被截断的情况\nconst emoji = '🎉'\nconsole.log\\('完整的 emoji:', renderLine\\(emoji\\)\\)\n\n// 模拟截断 - emoji的UTF-8字节是 \\\\xF0\\\\x9F\\\\x8E\\\\x89\nconst partial = '\\\\xF0\\\\x9F'  // 不完整的emoji\nconsole.log\\('截断的 emoji:', renderLine\\(partial\\)\\)\n\")",
+      "Bash(node -e \"\nconst isIncompleteUTF8 = \\(str\\) => {\n  if \\(!str || str.length === 0\\) return false\n  const lastChar = str.charCodeAt\\(str.length - 1\\)\n  if \\(lastChar >= 0x80 && lastChar < 0xC0\\) return true\n  return false\n}\n\n// 测试各种emoji\nconst tests = ['🎉', '📁', '⚡', '🛠️', '🔑', '💾', '📝', '⏰', '🔌', '📋']\ntests.forEach\\(e => {\n  console.log\\(e, '完整:', !isIncompleteUTF8\\(e\\)\\)\n}\\)\n\n// 测试被截断的emoji \\(只保留第一字节\\)\nconst broken = '🎉'.slice\\(0, 1\\)\nconsole.log\\('截断emoji:', broken, '检测:', isIncompleteUTF8\\(broken\\)\\)\n\")",
+      "Bash(node -e \"\nconst { renderLine } = require\\('./cli/src/utils/markdown'\\)\nconsole.log\\('测试:', renderLine\\('📁 文件操作：读取、创建'\\)\\)\n\")",
+      "Bash(node -e \"\nconst hasIncompleteSurrogate = \\(str\\) => {\n  if \\(!str || str.length === 0\\) return false\n  const lastChar = str.charCodeAt\\(str.length - 1\\)\n  console.log\\('检查:', str, 'lastChar:', lastChar.toString\\(16\\), '范围:', \\(lastChar >= 0xD800 && lastChar <= 0xDBFF\\)\\)\n  return lastChar >= 0xD800 && lastChar <= 0xDBFF\n}\n\nconst chunk1 = '\\\\xD83C'\nconsole.log\\('结果:', hasIncompleteSurrogate\\(chunk1\\)\\)\n\")",
+      "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(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)",
+      "Bash(cd D:/Code/vb-agent && timeout 8 node test-tg.js 2>&1 || true)",
+      "Bash(cd D:/Code/vb-agent && timeout 10 node test-tg.js 2>&1 || true)",
+      "Bash(find /d/Code/vb-agent -name \"*email*\" -type f 2>/dev/null | grep -v node_modules | grep -v .git)",
+      "Bash(find /d/Code/vb-agent -maxdepth 2 -name \"*.md\" -type f 2>/dev/null | grep -v node_modules)",
+      "Bash(node -c plugins/default-plugins.js && node -c src/core/plugin-manager.js && echo \"Syntax OK\")",
+      "Bash(node -c plugins/install-plugin.js && echo \"Syntax OK\")",
+      "Bash(node -c cli/src/ui/chat-ui.js && echo \"Syntax OK\")",
+      "Bash(node -c plugins/default-plugins.js && echo \"Syntax OK\")",
+      "Bash(node -c plugins/scheduler-plugin.js && echo \"Syntax OK\")",
+      "Bash(node -c plugins/telegram-plugin.js && node -c plugins/scheduler-plugin.js && echo \"Syntax OK\")",
+      "Bash(node -c plugins/telegram-plugin.js && echo \"Syntax OK\")",
+      "WebSearch",
+      "Bash(npm ls:*)",
+      "Bash(cd node_modules/@chnak/weixin-bot && npm run build 2>&1)",
+      "Bash(cd node_modules/@chnak/weixin-bot && npx tsc 2>&1)",
+      "Bash(npm install:*)",
+      "Bash(cd node_modules/@chnak/weixin-bot && npx typescript --version && npx tsc 2>&1)",
+      "Bash(npx tsc:*)",
+      "Bash(node --check /d/Code/vb-agent/plugins/weixin-plugin.js 2>&1)",
+      "Bash(node --check /d/Code/vb-agent/plugins/telegram-plugin.js && node --check /d/Code/vb-agent/plugins/weixin-plugin.js && echo \"OK\")",
+      "Bash(node --check /d/Code/vb-agent/cli/src/ui/chat-ui.js && echo \"OK\")",
+      "Bash(npm uninstall:*)",
+      "Bash(rm -rf /tmp/weixin-bot && git clone https://github.com/chnak/weixin-bot.git /tmp/weixin-bot 2>&1)",
+      "Bash(mkdir -p node_modules/@chnak/weixin-bot && cp -r /tmp/weixin-bot/nodejs/* node_modules/@chnak/weixin-bot/ && cd node_modules/@chnak/weixin-bot && npm install 2>&1)",
+      "Bash(node --check /d/Code/vb-agent/plugins/weixin-plugin.js && echo \"OK\")",
+      "Bash(node -e \"import\\('@chnak/weixin-bot'\\).then\\(m => console.log\\('OK:', Object.keys\\(m\\)\\)\\).catch\\(e => console.error\\('Error:', e.message\\)\\)\")",
+      "Bash(npm run:*)",
+      "Bash(node -e \"const { WeixinBot } = require\\('@chnak/weixin-bot'\\); console.log\\(typeof WeixinBot\\)\" 2>&1)",
+      "Bash(node -e \"import\\('@chnak/weixin-bot'\\).then\\(m => console.log\\('OK:', typeof m.WeixinBot\\)\\).catch\\(e => console.error\\('Error:', e.message\\)\\)\" 2>&1)",
+      "Bash(ls -la D:/code/vb-agent/cli/bin/ && cat D:/code/vb-agent/cli/bin/*.js 2>/dev/null | head -50)",
+      "Bash(npm config:*)",
+      "Bash(node -c plugins/subagent-plugin.js 2>&1)",
+      "Bash(node -c plugins/default-plugins.js 2>&1)",
+      "Bash(node -c plugins/default-plugins.js && node -c src/core/plugin-manager.js && node -c plugins/tools-plugin.js 2>&1)",
+      "Bash(node -c src/core/plugin-base.js && node -c src/core/plugin-manager.js 2>&1)",
+      "Bash(node -c plugins/telegram-plugin.js && node -c plugins/weixin-plugin.js 2>&1)",
+      "Bash(node -c src/core/plugin-manager.js 2>&1)",
+      "Bash(node -c src/core/plugin-manager.js && node -c src/core/plugin-base.js && node -c plugins/default-plugins.js && node -c plugins/telegram-plugin.js && node -c plugins/weixin-plugin.js 2>&1)",
+      "Bash(node -e \"require\\('dotenv'\\).config\\(\\); console.log\\('PROVIDER:', process.env.FOLIKO_PROVIDER\\); console.log\\('MODEL:', process.env.FOLIKO_MODEL\\); console.log\\('KEY:', process.env.DEEPSEEK_API_KEY ? 'set' : 'not set'\\)\" 2>&1)",
+      "Bash(node cli/src/index.js chat 2>&1 | head -30)",
+      "Bash(node -e 'const { DEFAULT_PROVIDERS } = require\\(\"./src/core/provider\"\\); console.log\\(DEFAULT_PROVIDERS\\);')",
+      "Bash(node -e \"const dotenv = require\\('dotenv'\\); const result = dotenv.config\\(\\); console.log\\('Result:', result\\); console.log\\('PROVIDER after dotenv:', process.env.FOLIKO_PROVIDER\\);\" 2>&1)",
+      "Bash(node -c plugins/email.js && node -c plugins/default-plugins.js 2>&1)",
+      "Bash(node -c plugins/email.js 2>&1)",
+      "Bash(npm list:*)",
+      "Bash(node -e \"const {EmailPlugin} = require\\('./plugins/email'\\); const p = new EmailPlugin\\(\\); console.log\\('email plugin loaded ok'\\); console.log\\('enabled:', p.enabled\\); console.log\\('version:', p.version\\);\" 2>&1)"
+    ]
+  }
+}

package/SPEC.md

@@ -1,4 +1,4 @@
-# VB-Agent Framework 规划文档
+# Foliko Framework 规划文档
 
 ## 一、设计目标
 
@@ -11,7 +11,7 @@
 
 ```
 ┌─────────────────────────────────────────────────┐
-│                  VB-Agent Framework             │
+│                  Foliko Framework               │
 ├─────────────────────────────────────────────────┤
 │  Framework (容器层)                              │
 │  ├── pluginManager    - 插件加载/卸载/重载       │

package/cli/bin/foliko.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 /**
  * Foliko CLI 入口
  * Usage: foliko <command> [options]

package/docs/quick-reference.md

@@ -1,4 +1,4 @@
-# VB-Agent 快速参考
+# Foliko 快速参考
 
 ## 启动框架
 ```javascript

package/docs/user-manual.md

@@ -1,4 +1,4 @@
-# VB-Agent Framework 用户手册
+# Foliko Framework 用户手册
 
 > 简约的插件化 Agent 框架
 
@@ -20,7 +20,7 @@
 
 ## 1. 项目概述
 
-VB-Agent 是一个基于插件的 Agent 框架，具有以下特性：
+Foliko 是一个基于插件的 Agent 框架，具有以下特性：
 
 - **纯 JS 实现** - 无 TypeScript，简单易懂
 - **插件化架构** - 通过插件扩展功能
@@ -759,7 +759,7 @@ Agent: [获取插件开发指南后，按照指南创建插件]
 
 ### 6.4 内置技能
 
-- **foliko-dev** - VB-Agent 插件开发指南
+- **foliko-dev** - Foliko 插件开发指南
 - **api-patterns** - API 设计模式
 - **app-builder** - 应用程序构建
 - **architecture** - 架构设计
@@ -906,7 +906,7 @@ const agent = framework.createAgent({
 
 ## 10. 事件系统
 
-VB-Agent 基于 EventEmitter，提供完整的事件系统。
+Foliko 基于 EventEmitter，提供完整的事件系统。
 
 ### 10.1 事件基础
 

package/examples/basic.js

@@ -1,110 +1,110 @@
-/**
- * 基础示例
- * 展示如何使用 Framework 和 Agent
- */
-
-const { Framework } = require('../src')
-const { AIPlugin } = require('../plugins/ai-plugin')
-const { z } = require('zod')
-
-async function main() {
-  // 创建框架实例
-  const framework = new Framework({ debug: true })
-
-  // 加载 AI 插件
-  await framework.loadPlugin(new AIPlugin({
-    provider: 'deepseek',
-    model: 'deepseek-chat',
-    apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key'
-  }))
-
-  // 注册自定义工具（使用 inputSchema 格式）
-  framework.registerTool({
-    name: 'hello',
-    description: '打招呼工具',
-    inputSchema: z.object({
-      name: z.string().optional().describe('姓名')
-    }),
-    execute: async (args) => {
-      return `Hello, ${args.name || 'World'}!`
-    }
-  })
-
-  // 注册计算器工具
-  framework.registerTool({
-    name: 'calculate',
-    description: '简单的计算器',
-    inputSchema: z.object({
-      expression: z.string().describe('数学表达式，如 2+3*4')
-    }),
-    execute: async (args) => {
-      try {
-        // 安全计算（仅支持基本运算）
-        const result = Function(`"use strict"; return (${args.expression})`)()
-        return { result }
-      } catch (e) {
-        return { error: e.message }
-      }
-    }
-  })
-
-  console.log('[Framework] Ready!')
-  console.log('[Tools]', framework.getTools().map(t => t.name))
-
-  // 创建 Agent
-  const agent = framework.createAgent({
-    name: 'MyAgent',
-    systemPrompt: '你是一个有帮助的助手。当需要计算时，使用 calculate 工具。'
-  })
-
-  // 监听事件
-  agent.on('tool-call', (tool) => {
-    console.log('[Agent] Tool call:', tool.name, tool.args)
-  })
-
-  agent.on('tool-result', (result) => {
-    console.log('[Agent] Tool result:', result.name, result.result)
-  })
-
-  // AI 对话示例
-  console.log('\n=== AI Chat Example ===')
-  try {
-    const response = await agent.chat('你好！')
-    console.log('[Agent] Response:', response.message)
-  } catch (err) {
-    console.error('[Agent] Error:', err.message)
-  }
-
-  // 使用工具的对话示例
-  console.log('\n=== AI Chat with Tool Call ===')
-  try {
-    const response = await agent.chat('请帮我计算 (15 + 25) * 2 等于多少？')
-    console.log('[Agent] Response:', response.message)
-  } catch (err) {
-    console.error('[Agent] Error:', err.message)
-  }
-
-  // 流式对话示例
-  console.log('\n=== Streaming Chat ===')
-  try {
-    for await (const chunk of agent.chatStream('请用中文介绍一下你自己')) {
-      if (chunk.type === 'text') {
-        process.stdout.write(chunk.text)
-      }
-    }
-    console.log('\n')
-  } catch (err) {
-    console.error('[Agent] Stream Error:', err.message)
-  }
-
-  // 热重载示例
-  console.log('\n=== Hot Reload ===')
-  await framework.reloadPlugin('ai')
-  console.log('AI plugin reloaded!')
-
-  // 清理
-  await framework.destroy()
-  console.log('\n[Done]')
-}
-
-main().catch(console.error)
+/**
+ * 基础示例
+ * 展示如何使用 Framework 和 Agent
+ */
+
+const { Framework } = require('../src')
+const { AIPlugin } = require('../plugins/ai-plugin')
+const { z } = require('zod')
+
+async function main() {
+  // 创建框架实例
+  const framework = new Framework({ debug: true })
+
+  // 加载 AI 插件
+  await framework.loadPlugin(new AIPlugin({
+    provider: 'deepseek',
+    model: 'deepseek-chat',
+    apiKey: process.env.DEEPSEEK_API_KEY || 'your-api-key'
+  }))
+
+  // 注册自定义工具（使用 inputSchema 格式）
+  framework.registerTool({
+    name: 'hello',
+    description: '打招呼工具',
+    inputSchema: z.object({
+      name: z.string().optional().describe('姓名')
+    }),
+    execute: async (args) => {
+      return `Hello, ${args.name || 'World'}!`
+    }
+  })
+
+  // 注册计算器工具
+  framework.registerTool({
+    name: 'calculate',
+    description: '简单的计算器',
+    inputSchema: z.object({
+      expression: z.string().describe('数学表达式，如 2+3*4')
+    }),
+    execute: async (args) => {
+      try {
+        // 安全计算（仅支持基本运算）
+        const result = Function(`"use strict"; return (${args.expression})`)()
+        return { result }
+      } catch (e) {
+        return { error: e.message }
+      }
+    }
+  })
+
+  console.log('[Framework] Ready!')
+  console.log('[Tools]', framework.getTools().map(t => t.name))
+
+  // 创建 Agent
+  const agent = framework.createAgent({
+    name: 'MyAgent',
+    systemPrompt: '你是一个有帮助的助手。当需要计算时，使用 calculate 工具。'
+  })
+
+  // 监听事件
+  agent.on('tool-call', (tool) => {
+    console.log('[Agent] Tool call:', tool.name, tool.args)
+  })
+
+  agent.on('tool-result', (result) => {
+    console.log('[Agent] Tool result:', result.name, result.result)
+  })
+
+  // AI 对话示例
+  console.log('\n=== AI Chat Example ===')
+  try {
+    const response = await agent.chat('你好！')
+    console.log('[Agent] Response:', response.message)
+  } catch (err) {
+    console.error('[Agent] Error:', err.message)
+  }
+
+  // 使用工具的对话示例
+  console.log('\n=== AI Chat with Tool Call ===')
+  try {
+    const response = await agent.chat('请帮我计算 (15 + 25) * 2 等于多少？')
+    console.log('[Agent] Response:', response.message)
+  } catch (err) {
+    console.error('[Agent] Error:', err.message)
+  }
+
+  // 流式对话示例
+  console.log('\n=== Streaming Chat ===')
+  try {
+    for await (const chunk of agent.chatStream('请用中文介绍一下你自己')) {
+      if (chunk.type === 'text') {
+        process.stdout.write(chunk.text)
+      }
+    }
+    console.log('\n')
+  } catch (err) {
+    console.error('[Agent] Stream Error:', err.message)
+  }
+
+  // 热重载示例
+  console.log('\n=== Hot Reload ===')
+  await framework.reloadPlugin('ai')
+  console.log('AI plugin reloaded!')
+
+  // 清理
+  await framework.destroy()
+  console.log('\n[Done]')
+}
+
+main().catch(console.error)