foliko 1.0.77 → 1.0.78

package/skills/python-plugin-dev/SKILL.md

@@ -1,266 +1,238 @@
----
-name: python-plugin-dev
-description: Python 插件开发指南。当用户说"创建 Python 插件"、"用 Python 写插件"时立即调用此 skill。
-allowed-tools: Read, Write, Edit, Glob, Grep, Bash, python_plugin
----
-
-# Python 插件开发
-
-## 概述
-
-Python 插件允许用 Python 语言开发工具，插件代码运行在 Python 环境中，可以调用所有 Python 库。
-
-## 插件存放位置
-
-`.agent/plugins/*.py`
-
-## 插件结构
-
-```python
-# .agent/plugins/my-plugin.py
-
-plugin_info = {
-    "name": "my-plugin",
-    "version": "1.0.0",
-    "description": "我的 Python 插件",
-    "tools": [
-        {
-            "name": "hello",
-            "description": "问候工具",
-            "params": {"name": "string"}
-        },
-        {
-            "name": "calc",
-            "description": "计算器工具",
-            "params": {"a": "number", "b": "number", "op": "string"}
-        }
-    ]
-}
-
-def execute_tool(tool_name, params):
-    """
-    执行工具 - 框架调用入口
-    tool_name: 工具名称
-    params: 参数字典
-    """
-    if tool_name == "hello":
-        return hello_tool(params)
-    elif tool_name == "calc":
-        return calc_tool(params)
-    else:
-        return {"success": False, "error": f"Unknown tool: {tool_name}"}
-
-# === 工具实现 ===
-
-def hello_tool(params):
-    """简单问候工具"""
-    name = params.get("name", "World")
-    return {
-        "success": True,
-        "result": f"Hello, {name}!"
-    }
-
-def calc_tool(params):
-    """计算器工具"""
-    a = params.get("a", 0)
-    b = params.get("b", 0)
-    op = params.get("op", "add")
-
-    if op == "add":
-        result = a + b
-    elif op == "sub":
-        result = a - b
-    elif op == "mul":
-        result = a * b
-    elif op == "div":
-        if b == 0:
-            return {"success": False, "error": "Division by zero"}
-        result = a / b
-    else:
-        return {"success": False, "error": f"Unknown operation: {op}"}
-
-    return {"success": True, "result": result}
-```
-
-**重要**：`tools` 字段定义了插件提供的所有工具。框架会自动：
-
-1. 将这些工具注册到系统中
-2. 附加到系统提示词，LLM 可以直接调用
-
-## 工具函数规范
-
-| 规范         | 说明                 |
-| ------------ | -------------------- |
-| 返回 dict    | 必须是 Python 字典   |
-| success 字段 | `true` 或 `false`    |
-| result 字段  | 成功时返回的结果     |
-| error 字段   | 失败时返回的错误信息 |
-
-## 返回值格式
-
-```python
-# 成功
-{"success": True, "result": "返回值"}
-
-# 失败
-{"success": False, "error": "错误信息"}
-
-# 返回复杂数据
-{"success": True, "result": {"key": "value", "list": [1, 2, 3]}}
-```
-
-## 使用方式
-
-创建插件后，使用 `python_plugin` 工具调用：
-
-```python
-python_plugin({
-  plugin: "my-plugin",      # 插件名称（不含 .py）
-  tool: "hello",            # 工具名称
-  params: { name: "Foliko" } # 工具参数
-})
-```
-
-## 示例：天气查询插件
-
-```python
-# .agent/plugins/weather.py
-
-plugin_info = {
-    "name": "weather",
-    "version": "1.0.0",
-    "description": "天气查询插件"
-}
-
-def execute_tool(tool_name, params):
-    if tool_name == "get_weather":
-        return get_weather(params)
-    else:
-        return {"success": False, "error": f"Unknown tool: {tool_name}"}
-
-def get_weather(params):
-    import requests
-
-    city = params.get("city", "北京")
-
-    try:
-        # 这里使用免费的天气 API
-        response = requests.get(
-            f"https://wttr.in/{city}?format=j1",
-            timeout=5
-        )
-        data = response.json()
-
-        return {
-            "success": True,
-            "result": {
-                "city": city,
-                "temperature": data["current_condition"][0]["temp_C"],
-                "weather": data["current_condition"][0]["weatherDesc"][0]["value"]
-            }
-        }
-    except Exception as e:
-        return {"success": False, "error": str(e)}
-```
-
-## 示例：文件处理插件
-
-```python
-# .agent/plugins/file_processor.py
-
-plugin_info = {
-    "name": "file_processor",
-    "version": "1.0.0",
-    "description": "文件处理插件"
-}
-
-def execute_tool(tool_name, params):
-    if tool_name == "read_file":
-        return read_file_tool(params)
-    elif tool_name == "write_file":
-        return write_file_tool(params)
-    else:
-        return {"success": False, "error": f"Unknown tool: {tool_name}"}
-
-def read_file_tool(params):
-    import os
-
-    filepath = params.get("path")
-    if not filepath:
-        return {"success": False, "error": "path is required"}
-
-    try:
-        with open(filepath, "r", encoding="utf-8") as f:
-            content = f.read()
-        return {"success": True, "result": content}
-    except Exception as e:
-        return {"success": False, "error": str(e)}
-
-def write_file_tool(params):
-    filepath = params.get("path")
-    content = params.get("content", "")
-
-    if not filepath:
-        return {"success": False, "error": "path is required"}
-
-    try:
-        os.makedirs(os.path.dirname(filepath), exist_ok=True)
-        with open(filepath, "w", encoding="utf-8") as f:
-            f.write(content)
-        return {"success": True, "result": f"Written to {filepath}"}
-    except Exception as e:
-        return {"success": False, "error": str(e)}
-```
-
-## 依赖管理
-
-如果需要第三方库，可以在插件中用 `pip` 安装：
-
-```python
-def execute_tool(tool_name, params):
-    if tool_name == "install_package":
-        return install_package(params)
-    ...
-
-def install_package(params):
-    import subprocess
-    import sys
-
-    package = params.get("package")
-    if not package:
-        return {"success": False, "error": "package name is required"}
-
-    try:
-        subprocess.check_call([sys.executable, "-m", "pip", "install", package])
-        return {"success": True, "result": f"Installed {package}"}
-    except Exception as e:
-        return {"success": False, "error": str(e)}
-```
-
-## 注意事项
-
-1. **不要创建目录** - 必须是单个 `.py` 文件
-2. **必须定义 `execute_tool`** - 这是框架调用的入口
-3. **必须定义 `plugin_info`** - 插件元信息
-4. **异常处理** - 所有可能出错的地方都要 try-except
-5. **编码** - 文件使用 UTF-8 编码
-
-## 开发流程
-
-1. **编写插件代码** - 在 `.agent/plugins/` 下创建 `.py` 文件
-2. **调用工具** - 使用 `python_plugin` 工具执行
-3. **调试** - 查看返回的 `success` 和 `error` 信息
-
-## 常用 Python 库
-
-插件中可以使用的常用库：
-
-| 库       | 用途       | 导入方式                        |
-| -------- | ---------- | ------------------------------- |
-| requests | HTTP 请求  | `import requests`               |
-| json     | JSON 处理  | `import json`                   |
-| os       | 系统操作   | `import os`                     |
-| pathlib  | 路径处理   | `from pathlib import Path`      |
-| datetime | 日期时间   | `from datetime import datetime` |
-| re       | 正则表达式 | `import re`                     |
-| csv      | CSV 处理   | `import csv`                    |
+---
+name: python-plugin-dev
+description: Python 插件开发指南。当用户说"创建 Python 插件"、"用 Python 写插件"时立即调用此 skill。
+allowed-tools: Read, Write, Edit, Glob, Grep, Bash
+---
+
+# Python 插件开发
+
+## 概述
+
+Python 插件允许用 Python 语言开发工具，插件代码运行在 Python 环境中，可以调用所有 Python 库。
+
+## 插件存放位置
+
+`.agent/plugins/*.py`
+
+## 插件结构
+
+```python
+# .agent/plugins/my-plugin.py
+
+PLUGIN = {
+    "name": "my-plugin",
+    "version": "1.0.0",
+    "description": "我的 Python 插件"
+}
+
+TOOLS = [
+    {
+        "name": "hello",
+        "description": "问候工具",
+        "params": {"name": "string"}
+    },
+    {
+        "name": "calc",
+        "description": "计算器工具",
+        "params": {"a": "number", "b": "number", "op": "string"}
+    }
+]
+
+# === 工具实现 ===
+
+def hello(params):
+    """问候工具"""
+    name = params.get("name", "World")
+    return {"success": True, "result": f"Hello, {name}!"}
+
+def calc(params):
+    """计算器工具"""
+    a = params.get("a", 0)
+    b = params.get("b", 0)
+    op = params.get("op", "add")
+
+    if op == "add":
+        result = a + b
+    elif op == "sub":
+        result = a - b
+    elif op == "mul":
+        result = a * b
+    elif op == "div":
+        if b == 0:
+            return {"success": False, "error": "Division by zero"}
+        result = a / b
+    else:
+        return {"success": False, "error": f"Unknown operation: {op}"}
+
+    return {"success": True, "result": result}
+```
+
+**重要**：`tools` 字段定义了插件提供的所有工具。框架会自动：
+
+1. 将这些工具注册到 ExtensionExecutor
+2. 附加到系统提示词【Extensions 扩展工具】部分
+3. 可通过 `ext_call` 调用
+
+## 工具函数规范
+
+| 规范         | 说明                 |
+| ------------ | -------------------- |
+| 返回 dict    | 必须是 Python 字典   |
+| success 字段 | `true` 或 `false`    |
+| result 字段  | 成功时返回的结果     |
+| error 字段   | 失败时返回的错误信息 |
+
+## 返回值格式
+
+```python
+# 成功
+{"success": True, "result": "返回值"}
+
+# 失败
+{"success": False, "error": "错误信息"}
+
+# 返回复杂数据
+{"success": True, "result": {"key": "value", "list": [1, 2, 3]}}
+```
+
+## 使用方式
+
+通过 `ext_call` 调用：
+
+```javascript
+ext_call({
+  plugin: 'my-plugin', // 插件名称
+  tool: 'hello', // 工具名称
+  args: { name: 'Foliko' }, // 工具参数
+});
+```
+
+工具会自动出现在系统提示词的【Extensions 扩展工具】部分。
+
+## 示例：天气查询插件
+
+```python
+# .agent/plugins/weather.py
+
+PLUGIN = {
+    "name": "weather",
+    "version": "1.0.0",
+    "description": "天气查询插件"
+}
+
+TOOLS = [
+    {
+        "name": "get_weather",
+        "description": "查询天气",
+        "params": {"city": "string"}
+    }
+]
+
+def get_weather(params):
+    import requests
+
+    city = params.get("city", "北京")
+
+    try:
+        response = requests.get(
+            f"https://wttr.in/{city}?format=j1",
+            timeout=5
+        )
+        data = response.json()
+
+        return {
+            "success": True,
+            "result": {
+                "city": city,
+                "temperature": data["current_condition"][0]["temp_C"],
+                "weather": data["current_condition"][0]["weatherDesc"][0]["value"]
+            }
+        }
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+```
+
+## 示例：文件处理插件
+
+```python
+# .agent/plugins/file_processor.py
+
+PLUGIN = {
+    "name": "file_processor",
+    "version": "1.0.0",
+    "description": "文件处理插件"
+}
+
+TOOLS = [
+    {
+        "name": "read_file",
+        "description": "读取文件",
+        "params": {"path": "string"}
+    },
+    {
+        "name": "write_file",
+        "description": "写入文件",
+        "params": {"path": "string", "content": "string"}
+    }
+]
+
+def read_file(params):
+    import os
+
+    filepath = params.get("path")
+    if not filepath:
+        return {"success": False, "error": "path is required"}
+
+    try:
+        with open(filepath, "r", encoding="utf-8") as f:
+            content = f.read()
+        return {"success": True, "result": content}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+
+def write_file(params):
+    import os
+
+    filepath = params.get("path")
+    content = params.get("content", "")
+
+    if not filepath:
+        return {"success": False, "error": "path is required"}
+
+    try:
+        os.makedirs(os.path.dirname(filepath), exist_ok=True)
+        with open(filepath, "w", encoding="utf-8") as f:
+            f.write(content)
+        return {"success": True, "result": f"Written to {filepath}"}
+    except Exception as e:
+        return {"success": False, "error": str(e)}
+```
+
+## 注意事项
+
+1. **文件格式** - 必须是单个 `.py` 文件
+2. **必须定义 `PLUGIN`** - 插件元信息
+3. **必须定义 `TOOLS`** - 工具列表
+4. **工具函数名** - 必须与 TOOLS 中定义的 name 一致
+5. **异常处理** - 所有可能出错的地方都要 try-except
+6. **编码** - 文件使用 UTF-8 编码
+
+## 开发流程
+
+1. **编写插件代码** - 在 `.agent/plugins/` 下创建 `.py` 文件
+2. **自动加载** - 框架启动时自动注册工具
+3. **调试** - 查看返回的 `success` 和 `error` 信息
+
+## 常用 Python 库
+
+插件中可以使用的常用库：
+
+| 库       | 用途       | 导入方式                        |
+| -------- | ---------- | ------------------------------- |
+| requests | HTTP 请求  | `import requests`               |
+| json     | JSON 处理  | `import json`                   |
+| os       | 系统操作   | `import os`                     |
+| pathlib  | 路径处理   | `from pathlib import Path`      |
+| datetime | 日期时间   | `from datetime import datetime` |
+| re       | 正则表达式 | `import re`                     |
+| csv      | CSV 处理   | `import csv`                    |

package/src/core/agent-chat.js

@@ -119,6 +119,59 @@ class AgentChatHandler extends EventEmitter {
     // 初始化编码器
     // 使用纯 JS tokenizer
     this._encoder = _globalTokenizer;
+
+    // Session 历史存储配置
+    this._sessionHistoryKey = config.sessionHistoryKey || 'chat_history';
+  }
+
+  /**
+   * 从 session 存储加载聊天历史
+   * @param {string} sessionId - 会话 ID
+   * @returns {Array} 消息数组
+   * @private
+   */
+  _loadHistoryFromSession(sessionId) {
+    if (!sessionId || !this.agent?.framework) return [];
+
+    try {
+      const sessionPlugin = this.agent.framework.pluginManager.get('session');
+      if (!sessionPlugin) return [];
+
+      const messages = sessionPlugin.getHistory(sessionId);
+      return messages || [];
+    } catch (err) {
+      // 忽略加载错误
+    }
+    return [];
+  }
+
+  /**
+   * 保存聊天历史到 session 存储
+   * @param {string} sessionId - 会话 ID
+   * @param {Array} messages - 消息数组
+   * @private
+   */
+  _saveHistoryToSession(sessionId, messages) {
+    if (!sessionId || !this.agent?.framework || !messages || messages.length === 0) return;
+
+    try {
+      const sessionPlugin = this.agent.framework.pluginManager.get('session');
+      if (!sessionPlugin) return;
+
+      // 获取 session 中已有消息数量，避免重复添加
+      const existingHistory = sessionPlugin.getHistory(sessionId);
+      const existingCount = existingHistory.length;
+
+      // 只添加新消息（避免重复添加已加载的历史）
+      const simpleMessages = messages.filter((m) => m.role === 'user' || m.role === 'assistant');
+
+      const newMessages = simpleMessages.slice(existingCount);
+      for (const msg of newMessages) {
+        sessionPlugin.addMessage(sessionId, msg);
+      }
+    } catch (err) {
+      // 忽略保存错误
+    }
   }
 
   /**
@@ -529,10 +582,26 @@ ${truncatedContent}${truncatedNote}
 
   /**
    * 清空对话历史
+   * @param {string} sessionId - 可选，指定 session 则同时清除 session 中的历史
    */
-  clearHistory() {
+  clearHistory(sessionId) {
     this._messages = [];
     this._compressionCount = 0;
+
+    // 同时清除 session 中的历史
+    if (sessionId && this.agent?.framework) {
+      try {
+        const sessionPlugin = this.agent.framework.pluginManager.get('session');
+        if (sessionPlugin) {
+          const session = sessionPlugin.getSession(sessionId);
+          if (session) {
+            session.messages = [];
+          }
+        }
+      } catch (err) {
+        // 忽略错误
+      }
+    }
     return this;
   }
 
@@ -566,10 +635,20 @@ ${truncatedContent}${truncatedNote}
    * @param {Object} options - 选项
    */
   async chat(message, options = {}) {
-    const context = { sessionId: options.sessionId || null, isStream: false };
+    const sessionId = options.sessionId || null;
+    const context = { sessionId, isStream: false };
     const framework = this.agent.framework;
     const self = this; // 保存引用用于回调
 
+    // 从 session 加载聊天历史
+    if (sessionId) {
+      const savedMessages = this._loadHistoryFromSession(sessionId);
+      if (savedMessages.length > 0) {
+        this._messages = savedMessages;
+        logger.info(`Loaded ${savedMessages.length} messages from session ${sessionId}`);
+      }
+    }
+
     // 关键：每次 chat 调用时刷新系统提示词，确保包含最新的工具/技能描述
     // 解决上下文过长时 LLM 不调用工具的问题
     this._systemPrompt = this.agent._buildSystemPrompt();
@@ -641,6 +720,11 @@ ${truncatedContent}${truncatedNote}
         logger.info(`After generation: ${afterTokens} tokens, will compress on next turn`);
       }
 
+      // 保存聊天历史到 session
+      if (sessionId) {
+        this._saveHistoryToSession(sessionId, this._messages);
+      }
+
       return {
         success: true,
         message: result.text || '',
@@ -659,9 +743,19 @@ ${truncatedContent}${truncatedNote}
    * @param {Object} options - 选项
    */
   async *chatStream(message, options = {}) {
-    const context = { sessionId: options.sessionId || null, isStream: true };
+    const sessionId = options.sessionId || null;
+    const context = { sessionId, isStream: true };
     const framework = this.agent.framework;
 
+    // 从 session 加载聊天历史
+    if (sessionId) {
+      const savedMessages = this._loadHistoryFromSession(sessionId);
+      if (savedMessages.length > 0) {
+        this._messages = savedMessages;
+        logger.info(`Loaded ${savedMessages.length} messages from session ${sessionId}`);
+      }
+    }
+
     // 关键：每次 chat 调用时刷新系统提示词，确保包含最新的工具/技能描述
     // 解决上下文过长时 LLM 不调用工具的问题
     this._systemPrompt = this.agent._buildSystemPrompt();
@@ -669,7 +763,7 @@ ${truncatedContent}${truncatedNote}
     const { tool, ToolLoopAgent } = await this._importAI();
 
     const userMessage = typeof message === 'string' ? { role: 'user', content: message } : message;
-    // console.log('System Prompt:', this._systemPrompt);
+    //console.log('System Prompt:', this._systemPrompt);
     this._messages.push(userMessage);
     // 检查是否需要压缩上下文（包括工具定义）
     const messagesTokens = this._countMessagesTokens(this._messages);
@@ -746,6 +840,11 @@ ${truncatedContent}${truncatedNote}
       // 添加 assistant 消息
       const assistantMsg = { role: 'assistant', content: fullText };
       this._messages.push(assistantMsg);
+
+      // 保存聊天历史到 session
+      if (sessionId) {
+        this._saveHistoryToSession(sessionId, this._messages);
+      }
     } catch (err) {
       this.emit('error', { error: err.message });
       yield { type: 'error', error: err.message };