foliko 1.0.83 → 1.0.85

package/skills/plugin-guide/SKILL.md

@@ -0,0 +1,139 @@
+---
+name: plugin-guide
+description: Foliko 插件管理指南。用于列出远程插件、安装插件、发布插件到远程仓库。当用户说"查看插件列表"、"安装插件"、"发布插件"时使用。
+---
+
+# Foliko 插件管理指南
+
+## 概念区分
+
+| 类型               | 存储位置          | 安装命令                            | 说明                      |
+| ------------------ | ----------------- | ----------------------------------- | ------------------------- |
+| **Skill（技能）**  | `.agent/skills/`  | `npx skills add xxx -a openclaw -y` | 知识包，为 Agent 提供指导 |
+| **Plugin（插件）** | `.agent/plugins/` | `foliko plugin install xxx`         | 扩展功能模块              |
+
+---
+
+## 列出远程插件
+
+查看远程插件仓库中所有可用的插件：
+
+```bash
+foliko plugin list
+```
+
+或使用 Agent 工具：
+
+- 调用 `plugin_list` 工具查看远程插件列表
+
+---
+
+## 安装插件
+
+从远程仓库安装插件到本地 `.agent/plugins/` 目录：
+
+```bash
+foliko plugin install <plugin-name>
+```
+
+**示例**：
+
+```bash
+# 安装 puppeteer 插件
+foliko plugin install puppeteer-plugin
+
+# 安装 gate-trading 插件
+foliko plugin install gate-trading
+```
+
+安装后需要**重启**或**重载插件**使新插件生效：
+
+```bash
+foliko reload
+```
+
+---
+
+## 发布插件到远程仓库
+
+将本地插件发布到远程 Git 仓库（需要仓库写权限）。
+
+### 发布命令
+
+```bash
+foliko plugin publish <plugin-name> --repo <repo-url>
+```
+
+### 详细步骤
+
+1. **准备插件目录**
+
+   ```
+   .agent/plugins/my-plugin/
+   ├── index.js      # 插件入口文件（必须）
+   ├── package.json  # 包配置（必须）
+   ├── README.md     # 使用说明（建议）
+   └── ...           # 其他文件
+   ```
+
+2. **创建 README.md**（必需）
+
+   ```markdown
+   # My Plugin
+
+   插件描述...
+
+   ## 安装
+   ```
+
+   foliko plugin install my-plugin
+
+   ```
+
+   ## 使用
+   插件功能说明...
+   ```
+
+3. **确保远程仓库存在**
+   - 默认仓库：`https://github.com/chnak/foliko-plugins.git`
+   - 或指定其他仓库：`--repo https://github.com/user/repo.git`
+
+4. **执行发布**
+   ```bash
+   foliko plugin publish my-plugin
+   ```
+
+---
+
+## 重载插件
+
+发布或安装插件后，需要重载使更改生效：
+
+```bash
+foliko reload
+```
+
+或使用工具：
+
+- `reload_plugins` - 重载所有插件
+- `reload_plugins({ pluginName: "xxx" })` - 重载指定插件
+
+---
+
+## 常用命令速查
+
+| 操作         | 命令                                       |
+| ------------ | ------------------------------------------ |
+| 列出远程插件 | `foliko plugin list` 或 `plugin_list` 工具 |
+| 安装插件     | `foliko plugin install <name>`             |
+| 发布插件     | `foliko plugin publish <name>`             |
+| 重载插件     | `foliko reload`                            |
+
+---
+
+## 注意事项
+
+1. **插件 vs 技能**：确保区分插件（Plugin）和技能（Skill），不要混淆
+2. **发布权限**：发布到远程仓库需要有仓库的写权限
+3. **README 必需**：发布的插件必须包含 README.md
+4. **重载生效**：安装/发布后必须重载插件

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

@@ -1,238 +1,238 @@
----
-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`                    |
+---
+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`                    |