foliko 1.1.68 → 1.1.69

package/examples/ambient-example.js

@@ -15,7 +15,7 @@ async function main() {
 
   // Bootstrap with default plugins (including ambient)
   await framework.bootstrap({
-    agentDir: './.agent',
+    agentDir: './.foliko',
     aiConfig: {
       provider: 'deepseek',
       model: 'deepseek-chat',
@@ -181,7 +181,7 @@ async function main() {
   }
 
   console.log('\n=== All Examples Completed ===');
-  console.log('Check .agent/data/ambient/ for persisted data');
+  console.log('Check .foliko/data/ambient/ for persisted data');
 
   // Cleanup
   console.log('\nShutting down...');

package/examples/bootstrap.js

@@ -1,6 +1,6 @@
 /**
  * Bootstrap 示例
- * 使用 framework.bootstrap() 自动加载 .agent/ 目录配置
+ * 使用 framework.bootstrap() 自动加载 .foliko/ 目录配置
  */
 
 const { Framework } = require('../src');
@@ -13,9 +13,9 @@ async function main() {
   const framework = new Framework({ debug: true });
 
   // 使用 bootstrap 自动加载所有默认插件
-  // 会自动检测 .agent/ 目录下的配置
+  // 会自动检测 .foliko/ 目录下的配置
   await framework.bootstrap({
-    agentDir: './.agent', // 配置目录
+    agentDir: './.foliko', // 配置目录
     aiConfig: {
       // 可选：覆盖 AI 配置
       provider: 'deepseek',

package/examples/test-chat.js

@@ -18,7 +18,7 @@ async function main() {
 
   // Bootstrap
   await framework.bootstrap({
-    agentDir: './.agent',
+    agentDir: './.foliko',
     aiConfig: {
       provider: 'minimax',
       model: 'MiniMax-M2.7',

package/examples/test-reload.js

@@ -37,7 +37,7 @@ async function test() {
 
   // 检查配置
   console.log('\n3. 当前配置文件:');
-  const configPath = path.resolve('.agent/mcp_config.json');
+  const configPath = path.resolve('.foliko/mcp_config.json');
   if (fs.existsSync(configPath)) {
     const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
     console.log(JSON.stringify(config, null, 2));

package/examples/test-telegram.js

@@ -5,7 +5,7 @@ async function main() {
   const framework = new Framework({ debug: false });
 
   await framework.bootstrap({
-    agentDir: process.cwd() + '/.agent',
+    agentDir: process.cwd() + '/.foliko',
     aiConfig: {
       provider: process.env.FOLIKO_PROVIDER || 'minimax',
       model: process.env.FOLIKO_MODEL || 'MiniMax-M2.7',

package/examples/test-tg-bot.js

@@ -7,7 +7,7 @@ async function main() {
   const framework = new Framework({ debug: false });
 
   await framework.bootstrap({
-    agentDir: process.cwd() + '/.agent',
+    agentDir: process.cwd() + '/.foliko',
     aiConfig: {
       provider: process.env.FOLIKO_PROVIDER || 'minimax',
       model: process.env.FOLIKO_MODEL || 'MiniMax-M2.7',

package/examples/test-tg-simple.js

@@ -1,8 +1,8 @@
 require('dotenv').config();
 
-// 添加 .agent/node_modules 到搜索路径
+// 添加 .foliko/node_modules 到搜索路径
 const path = require('path');
-const agentNodeModules = path.join(process.cwd(), '.agent', 'node_modules');
+const agentNodeModules = path.join(process.cwd(), '.foliko', 'node_modules');
 if (!module.paths.includes(agentNodeModules)) {
   module.paths.unshift(agentNodeModules);
 }

package/examples/test-tg.js

@@ -5,7 +5,7 @@ async function main() {
   const framework = new Framework({ debug: true });
 
   await framework.bootstrap({
-    agentDir: process.cwd() + '/.agent',
+    agentDir: process.cwd() + '/.foliko',
     aiConfig: {
       provider: process.env.FOLIKO_PROVIDER || 'minimax',
       model: process.env.FOLIKO_MODEL || 'MiniMax-M2.7',

package/examples/test-think.js

@@ -5,7 +5,7 @@ async function main() {
   const framework = new Framework({ debug: false });
 
   await framework.bootstrap({
-    agentDir: process.cwd() + '/.agent',
+    agentDir: process.cwd() + '/.foliko',
     aiConfig: {
       provider: process.env.FOLIKO_PROVIDER || 'minimax',
       model: process.env.FOLIKO_MODEL || 'MiniMax-M2.7',

package/examples/test-weixin-feishu.js

@@ -12,7 +12,7 @@ async function main() {
 
   // Bootstrap 加载默认插件
   await framework.bootstrap({
-    agentDir: './.agent',
+    agentDir: './.foliko',
     aiConfig: {
       provider: 'deepseek',
       model: 'deepseek-chat',
@@ -68,7 +68,7 @@ async function main() {
 
   try {
     // 使用 chat() 而非 chatStream()
-    const result = await sessionInfo.agent.chat(mockText, {
+    const result = await sessionInfo.foliko.chat(mockText, {
       sessionId: sessionInfo.sessionId,
     });
 
@@ -83,7 +83,7 @@ async function main() {
   console.log('\n--- Test chatStream() for comparison ---');
   try {
     let fullResponse = '';
-    for await (const chunk of sessionInfo.agent.chatStream('今天天气怎么样？', {
+    for await (const chunk of sessionInfo.foliko.chatStream('今天天气怎么样？', {
       sessionId: sessionInfo.sessionId,
     })) {
       if (chunk.type === 'text' && chunk.text) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "foliko",
-  "version": "1.1.68",
+  "version": "1.1.69",
   "description": "简约的插件化 Agent 框架",
   "main": "src/index.js",
   "type": "commonjs",
@@ -81,6 +81,8 @@
     "node-schedule": "^2.1.1",
     "node-telegram-bot-api": "^0.67.0",
     "nodemailer": "^6.10.0",
+    "pino": "^10.3.1",
+    "pino-pretty": "^13.1.3",
     "qrcode-terminal": "^0.12.0",
     "remove-markdown": "^0.6.3",
     "zod": "^3.25.76"

package/plugins/ambient-agent/index.js

@@ -32,7 +32,7 @@ class AmbientAgentPlugin extends Plugin {
       enabled: config.enabled !== false,
       tickInterval: config.tickInterval || 5000,      // tick间隔（毫秒）
       cooldownPeriod: config.cooldownPeriod || 3000,  // 冷却时间（毫秒）
-      persistencePath: config.persistencePath || '.agent/data/ambient',
+      persistencePath: config.persistencePath || '.foliko/data/ambient',
       defaultGoals: config.defaultGoals || []
     }
 

package/plugins/audit-plugin.js

@@ -1,36 +1,72 @@
 /**
  * Audit 审计日志插件
  * 记录所有操作日志，支持日志查询和统计
+ * 基于 Pino 日志系统
  */
 
 const { Plugin } = require('../src/core/plugin-base')
+const { logger } = require('../src/utils/logger')
 const { z } = require('zod')
+const path = require('path')
+const fs = require('fs')
+const os = require('os')
 
 class AuditPlugin extends Plugin {
   constructor(config = {}) {
     super()
     this.name = 'audit'
-    this.version = '1.0.0'
+    this.version = '2.0.0'
     this.description = '审计日志插件，记录工具调用、技能执行、错误信息等操作历史'
     this.priority = 20
-    this.system = true 
+    this.system = true
 
     this.config = {
       maxLogs: config.maxLogs || 1000,
       retentionDays: config.retentionDays || 30,
-      logDir: config.logDir || '.agent/logs'
+      logDir: config.logDir || path.join(os.homedir(), '.vb-agent', 'logs', 'audit')
     }
 
     this._framework = null
-    this._logs = []
     this._logIdCounter = 0
+    this._auditLogger = null
+    this._auditLogFile = null
+    this._queryLogs = [] // 内存缓存用于查询
+    this._initAuditLogger()
+  }
+
+  /**
+   * 初始化审计日志器
+   */
+  _initAuditLogger() {
+    const pino = require('pino')
+
+    // 确保目录存在
+    if (!fs.existsSync(this.config.logDir)) {
+      fs.mkdirSync(this.config.logDir, { recursive: true })
+    }
+
+    // 审计日志文件名
+    const date = new Date().toISOString().split('T')[0]
+    this._auditLogFile = path.join(this.config.logDir, `audit-${date}.jsonl`)
+
+    // 创建文件写入流
+    const fileStream = fs.createWriteStream(this._auditLogFile, { flags: 'a' })
+
+    // 创建专门的审计 logger
+    this._auditLogger = pino({
+      name: 'audit',
+      level: 'info',
+      timestamp: pino.stdTimeFunctions.isoTime,
+      formatters: {
+        level: (label) => label.toUpperCase(),
+      },
+    }, fileStream)
   }
 
   install(framework) {
     this._framework = framework
 
     // 监听框架事件
-    // tool:call 和 tool-call 两种格式都监听（兼容不同来源）
     framework.on('tool:call', (data) => this._log('tool_call', data))
     framework.on('tool-call', (data) => this._log('tool_call', data))
     framework.on('tool:result', (data) => this._log('tool_result', data))
@@ -51,10 +87,11 @@ class AuditPlugin extends Plugin {
         offset: z.number().optional().describe('偏移量，默认 0')
       }),
       execute: async (args) => {
-        let logs = this._logs
+        const logs = this._queryLogs
 
+        let filtered = logs
         if (args.type) {
-          logs = logs.filter(log => log.type === args.type)
+          filtered = filtered.filter(log => log.type === args.type)
         }
 
         const offset = args.offset || 0
@@ -62,9 +99,9 @@ class AuditPlugin extends Plugin {
 
         return {
           success: true,
-          data: logs.slice(-limit - offset, logs.length - offset),
+          data: filtered.slice(-limit - offset, filtered.length - offset),
           metadata: {
-            total: logs.length,
+            total: filtered.length,
             offset,
             limit
           }
@@ -111,21 +148,30 @@ class AuditPlugin extends Plugin {
 
   /**
    * 记录日志
-   * @private
    */
   _log(type, data) {
     const log = {
       id: ++this._logIdCounter,
       type,
       data,
-      timestamp: new Date()
+      timestamp: new Date().toISOString()
     }
 
-    this._logs.push(log)
+    // 写入审计日志文件
+    if (this._auditLogger) {
+      this._auditLogger.info({
+        auditId: log.id,
+        auditType: log.type,
+        auditData: log.data
+      }, 'audit event')
+    }
 
-    // 限制日志数量
-    if (this._logs.length > this.config.maxLogs) {
-      this._logs = this._logs.slice(-this.config.maxLogs)
+    // 缓存到内存用于查询
+    this._queryLogs.push(log)
+
+    // 限制缓存数量
+    if (this._queryLogs.length > this.config.maxLogs) {
+      this._queryLogs = this._queryLogs.slice(-this.config.maxLogs)
     }
 
     return log
@@ -136,16 +182,17 @@ class AuditPlugin extends Plugin {
    */
   getStats() {
     const counts = {}
-    for (const log of this._logs) {
+    for (const log of this._queryLogs) {
       counts[log.type] = (counts[log.type] || 0) + 1
     }
 
     return {
-      total: this._logs.length,
+      total: this._queryLogs.length,
       maxLogs: this.config.maxLogs,
       counts,
-      oldest: this._logs.length > 0 ? this._logs[0].timestamp : null,
-      newest: this._logs.length > 0 ? this._logs[this._logs.length - 1].timestamp : null
+      oldest: this._queryLogs.length > 0 ? this._queryLogs[0].timestamp : null,
+      newest: this._queryLogs.length > 0 ? this._queryLogs[this._queryLogs.length - 1].timestamp : null,
+      logFile: this._auditLogFile
     }
   }
 
@@ -153,7 +200,7 @@ class AuditPlugin extends Plugin {
    * 导出日志
    */
   exportLogs(options = {}) {
-    let logs = [...this._logs]
+    let logs = [...this._queryLogs]
 
     // 按类型过滤
     if (options.type) {
@@ -163,12 +210,12 @@ class AuditPlugin extends Plugin {
     // 按日期过滤
     if (options.startDate) {
       const start = new Date(options.startDate)
-      logs = logs.filter(log => log.timestamp >= start)
+      logs = logs.filter(log => new Date(log.timestamp) >= start)
     }
 
     if (options.endDate) {
       const end = new Date(options.endDate)
-      logs = logs.filter(log => log.timestamp <= end)
+      logs = logs.filter(log => new Date(log.timestamp) <= end)
     }
 
     return { logs }
@@ -186,9 +233,13 @@ class AuditPlugin extends Plugin {
   }
 
   uninstall(framework) {
-    this._logs = []
+    this._queryLogs = []
+    if (this._auditLogger) {
+      // 关闭文件流
+    }
+    this._auditLogger = null
     this._framework = null
   }
 }
 
-module.exports = AuditPlugin
+module.exports = AuditPlugin

package/plugins/default-plugins.js

@@ -1,6 +1,6 @@
 /**
  * 默认插件配置加载器
- * 检测 .agent/ 目录下的配置，提供给 bootstrap() 使用
+ * 检测 .foliko/ 目录下的配置，提供给 bootstrap() 使用
  */
 
 const fs = require('fs')
@@ -11,10 +11,10 @@ const log = logger.child('AgentConfig')
 const bootstrapLog = logger.child('Bootstrap')
 
 /**
- * 加载 .agent 目录下的配置
+ * 加载 .foliko 目录下的配置
  * 返回配置对象，可用于手动加载插件
  */
-function loadAgentConfig(agentDir = '.agent') {
+function loadAgentConfig(agentDir = '.foliko') {
   const config = {
     agentDir,
     ai: {},
@@ -28,7 +28,7 @@ function loadAgentConfig(agentDir = '.agent') {
   const resolvedDir = path.resolve(process.cwd(), agentDir)
 
   if (!fs.existsSync(resolvedDir)) {
-    log.info(` .agent directory not found: ${resolvedDir}`)
+    log.info(` .foliko directory not found: ${resolvedDir}`)
     return config
   }
 
@@ -136,7 +136,7 @@ function loadAgentConfig(agentDir = '.agent') {
     }
   }
 
-  // 添加 .agent/skills 目录（不存在则创建）
+  // 添加 .foliko/skills 目录（不存在则创建）
   const skillsDir = path.join(resolvedDir, 'skills')
   if (fs.existsSync(resolvedDir) && !fs.existsSync(skillsDir)) {
     fs.mkdirSync(skillsDir, { recursive: true })
@@ -146,7 +146,7 @@ function loadAgentConfig(agentDir = '.agent') {
     config.skillsDirs.push(skillsDir)
   }
 
-  // 添加 .agent/skills 目录（不存在则创建）
+  // 添加 .foliko/skills 目录（不存在则创建）
   const cmdskillsDir = path.join(cmdDir, 'skills')
   if (fs.existsSync(resolvedDir) && !fs.existsSync(cmdskillsDir)) {
     fs.mkdirSync(cmdskillsDir, { recursive: true })
@@ -184,7 +184,7 @@ class DefaultPlugins extends Plugin {
     this.system = true 
 
     this._framework = null
-    this._agentDir = config.agentDir || '.agent'
+    this._agentDir = config.agentDir || '.foliko'
     this._config = null
   }
 
@@ -364,6 +364,16 @@ async function bootstrapDefaults(framework, config = {}) {
     }
   }
 
+  // 6. 大数据分拆插件
+  if (shouldLoad('data-splitter')) {
+    const { DataSplitterPlugin } = require('./data-splitter-plugin')
+    await framework.loadPlugin(new DataSplitterPlugin({
+      autoSplitThreshold: agentConfig.dataSplitter?.autoSplitThreshold || 50000,
+      chunkSize: agentConfig.dataSplitter?.chunkSize || 60000,
+      maxConcurrent: agentConfig.dataSplitter?.maxConcurrent || 3,
+    }))
+    framework._debug&&bootstrapLog.debug(' DataSplitter Plugin loaded')
+  }
 
   // 7. 自动加载 plugins/ 目录下的所有插件
   await loadCustomPlugins(framework, agentConfig)
@@ -383,8 +393,8 @@ async function bootstrapDefaults(framework, config = {}) {
 /**
  * 解析插件路径
  * 支持两种结构：
- * 1. 文件夹结构: .agent/plugins/my-plugin/index.js
- * 2. 单文件结构: .agent/plugins/my-plugin.js
+ * 1. 文件夹结构: .foliko/plugins/my-plugin/index.js
+ * 2. 单文件结构: .foliko/plugins/my-plugin.js
  * 支持符号链接
  * @param {string} pluginsDir - 插件目录
  * @param {string} name - 插件名称
@@ -502,10 +512,10 @@ async function loadCustomPlugins(framework, agentConfig) {
   const { Plugin } = require('../src/core/plugin-base')
 
   // 加载两个目录下的自定义插件：
-  // 1. .agent/plugins/ - 用户自定义插件（强制启用）
+  // 1. .foliko/plugins/ - 用户自定义插件（强制启用）
   // 2. plugins/ - 项目内置插件（自动加载）
   const dirs = [
-    { dir: path.resolve(process.cwd(), '.agent', 'plugins'), forceEnabled: true },
+    { dir: path.resolve(process.cwd(), '.foliko', 'plugins'), forceEnabled: true },
     { dir: path.resolve(process.cwd(), 'plugins'), forceEnabled: false },
     { dir: path.resolve(__dirname, '..', 'plugins'), forceEnabled: false }   
     // 项目下的 plugins 目录（兼容旧版本）

package/plugins/email/index.js

@@ -94,7 +94,7 @@ class EmailPlugin extends Plugin {
 
     // 持久化存储
     this._emailStore = null
-    this._persistencePath = config.persistencePath || '.agent/data/email/processed-emails.json'
+    this._persistencePath = config.persistencePath || '.foliko/data/email/processed-emails.json'
 
     // 防抖相关
     this._emailDebounceMap = new Map()  // msgId -> timer

package/plugins/extension-executor-plugin.js

@@ -6,6 +6,7 @@
 const { Plugin } = require('../src/core/plugin-base');
 const { logger } = require('../src/utils/logger');
 const { z } = require('zod');
+const { PROMPT_PRIORITY } = require('../src/core/constants');
 const { zodSchemaToMarkdown,zodSchemaToTable } = require('@chnak/zod-to-markdown');
 
 const log = logger.child('ExtensionExecutor');
@@ -268,7 +269,7 @@ class ExtensionExecutorPlugin extends Plugin {
     }
 
     // 注册扩展插件的提示词部分（使用基类方法）
-    this.registerPromptPart('extension-tools', 70, () => this._buildExtensionsDescription());
+    this.registerPromptPart('extension-tools', PROMPT_PRIORITY.EXTENSION_TOOLS, () => this._buildExtensionsDescription());
 
     return this;
   }
@@ -391,14 +392,41 @@ class ExtensionExecutorPlugin extends Plugin {
     if (this._extensions.size > 0 || (this._mcpExecutor && Object.keys(this._mcpExecutor.tools || {}).length > 0)) {
       desc += '## 【Extensions】扩展插件\n\n';
       desc += '**使用流程（必须按顺序执行）：**\n';
-      desc += '1. 调用 `ext_skill({ skill: "插件名" })` 获取目标扩展的详细工具参数\n';
-      desc += '2. 根据返回的参数定义，使用 `ext_call({ plugin, tool, args })` 调用扩展\n\n';
+      desc += '1. 调用 `ext_skill({ plugin: "skill" })` 获取技能命令的详细参数\n';
+      desc += '2. 根据返回的参数定义，使用 `ext_call({ plugin: "skill", tool: "技能名:命令名", args: {...} })` 调用\n\n';
       desc += '> **警告**：禁止在未执行第1步获取参数的情况下直接调用 `ext_call`！\n\n';
 
       for (const [name, ext] of this._extensions) {
-        desc += `### ${ext.name || name}\n`;
-        desc += `${ext.description || '无描述'}\n`;
-        desc += `**工具:** ${ext.tools.map(t => `\`${t.name}\``).join(', ')}\n\n`;
+        if (name === 'skill') {
+          // Skill 命令按技能名分组显示
+          const toolsBySkill = {};
+          for (const tool of ext.tools) {
+            // 命令格式: skillname:cmdname
+            const parts = tool.name.split(':');
+            const skillName = parts[0];
+            const cmdName = parts.slice(1).join(':');
+            if (!toolsBySkill[skillName]) {
+              toolsBySkill[skillName] = [];
+            }
+            toolsBySkill[skillName].push({ name: cmdName, description: tool.description });
+          }
+
+          for (const [skillName, cmds] of Object.entries(toolsBySkill)) {
+            desc += `### skill.${skillName}\n`;
+            desc += `**调用方式:**\n`;
+            desc += `1. 先调用 \`loadSkill({ skill: "${skillName}" })\` 获取 \`${skillName}\` 技能的详细参数\n`;
+            desc += `2. 调用 \`ext_call({ plugin: "skill", tool: "${skillName}:<命令名>", args: { args: "参数" } })\`\n\n`;
+            desc += `**可用命令:**\n`;
+            for (const c of cmds) {
+              desc += `- \`${c.name}\`: ${c.description}\n`;
+            }
+            desc += '\n';
+          }
+        } else {
+          desc += `### ${ext.name || name}\n`;
+          desc += `${ext.description || '无描述'}\n`;
+          desc += `**工具:** ${ext.tools.map(t => `\`${t.name}\``).join(', ')}\n\n`;
+        }
       }
 
       // MCP 服务器工具
@@ -534,6 +562,56 @@ class ExtensionExecutorPlugin extends Plugin {
     }));
   }
 
+  /**
+   * 获取 skill 命令列表（用于 autocomplete）
+   */
+  getSkillCommands() {
+    const ext = this._extensions.get('skill');
+    if (!ext) return [];
+    return ext.tools.map(t => ({
+      name: t.name.replace(/^([^:]+):(.*)$/, '$1:$2'),
+      description: t.description || t.name,
+    }));
+  }
+
+  /**
+   * 获取 skill 命令帮助文本
+   */
+  getSkillCommandsHelp() {
+    const ext = this._extensions.get('skill');
+    if (!ext || ext.tools.length === 0) return '';
+
+    const lines = [];
+    for (const tool of ext.tools) {
+      const parts = tool.name.split(':');
+      if (parts.length === 2) {
+        lines.push(`/${parts[0]}:${parts[1]} - ${tool.description || '无描述'}`);
+      }
+    }
+    return lines.join('\n');
+  }
+
+  /**
+   * 检查并执行 skill 命令
+   * @param {string} command - 命令名（如 "skillname:cmdname"）
+   * @param {string} args - 命令参数
+   * @returns {Promise<object|null>} 执行结果，失败返回 null
+   */
+  async executeSkillCommand(command, args) {
+    if (!command.includes(':')) return null;
+    try {
+      const result = await this._framework.executeTool('ext_call', {
+        plugin: 'skill',
+        tool: command,
+        args: { args }
+      });
+      return result.success !== false ? result : null;
+    } catch (err) {
+      log.warn('Skill command failed:', err.message);
+      return null;
+    }
+  }
+
   async reload(framework) {
     this._framework = framework;
     // 重新扫描所有已加载插件的 tools
@@ -559,7 +637,7 @@ class ExtensionExecutorPlugin extends Plugin {
     if (!mcpExecutor) return;
 
     try {
-      const configPath = path.resolve('.agent/mcp_config.json');
+      const configPath = path.resolve('.foliko/mcp_config.json');
       if (fs.existsSync(configPath)) {
         const configContent = fs.readFileSync(configPath, 'utf8');
         const config = JSON.parse(configContent);