foliko 1.0.85 → 1.0.86

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`                    |

package/src/core/agent-chat.js

@@ -697,8 +697,6 @@ ${truncatedContent}${truncatedNote}
         );
         // 使用带超时控制的压缩
         await this._compressContext();
-      } else {
-        logger.info(`Context OK: ${totalTokens}/${this._maxContextTokens} tokens`);
       }
 
       const maxSteps = options.maxSteps || this._maxSteps;
@@ -714,6 +712,7 @@ ${truncatedContent}${truncatedNote}
         model: this._aiClient,
         instructions: this._systemPrompt,
         tools: tools,
+        //stopWhen: stepCountIs(maxSteps),
         prepareStep: async ({ stepNumber, messages }) =>
           this._prepareStepForPruning(stepNumber, messages),
       });
@@ -785,6 +784,7 @@ ${truncatedContent}${truncatedNote}
       const systemPromptTokens = this._countTokens(this._systemPrompt);
       const totalTokens = messagesTokens + toolsTokens + systemPromptTokens;
       const limit = this._maxContextTokens * 0.7; // 降低到 70%
+      //console.log(messagesTokens,toolsTokens,systemPromptTokens,totalTokens,this._maxContextTokens)
       // 对于流式调用，如果上下文太大，先压缩再开始
       if (totalTokens > limit) {
         logger.info(
@@ -806,6 +806,7 @@ ${truncatedContent}${truncatedNote}
         model: this._aiClient,
         instructions: this._systemPrompt,
         tools: tools,
+        //stopWhen: stepCountIs(maxSteps),
         prepareStep: async ({ stepNumber, messages }) =>
           this._prepareStepForPruning(stepNumber, messages),
       });
@@ -861,7 +862,7 @@ ${truncatedContent}${truncatedNote}
    * @private
    */
   _prepareStepForPruning(stepNumber, messages) {
-    if (messages.length <= 20) {
+    if (messages.length <= 50) {
       return {};
     }
 

package/.agent/.shared/ui-ux-pro-max/data/charts.csv

@@ -1,26 +0,0 @@
-No,Data Type,Keywords,Best Chart Type,Secondary Options,Color Guidance,Performance Impact,Accessibility Notes,Library Recommendation,Interactive Level
-1,Trend Over Time,"trend, time-series, line, growth, timeline, progress",Line Chart,"Area Chart, Smooth Area",Primary: #0080FF. Multiple series: use distinct colors. Fill: 20% opacity,⚡ Excellent (optimized),✓ Clear line patterns for colorblind users. Add pattern overlays.,"Chart.js, Recharts, ApexCharts",Hover + Zoom
-2,Compare Categories,"compare, categories, bar, comparison, ranking",Bar Chart (Horizontal or Vertical),"Column Chart, Grouped Bar",Each bar: distinct color. Category: grouped same color. Sorted: descending order,⚡ Excellent,✓ Easy to compare. Add value labels on bars for clarity.,"Chart.js, Recharts, D3.js",Hover + Sort
-3,Part-to-Whole,"part-to-whole, pie, donut, percentage, proportion, share",Pie Chart or Donut,"Stacked Bar, Treemap",Colors: 5-6 max. Contrasting palette. Large slices first. Use labels.,⚡ Good (limit 6 slices),⚠ Hard for accessibility. Better: Stacked bar with legend. Avoid pie if >5 items.,"Chart.js, Recharts, D3.js",Hover + Drill
-4,Correlation/Distribution,"correlation, distribution, scatter, relationship, pattern",Scatter Plot or Bubble Chart,"Heat Map, Matrix",Color axis: gradient (blue-red). Size: relative. Opacity: 0.6-0.8 to show density,⚠ Moderate (many points),⚠ Provide data table alternative. Use pattern + color distinction.,"D3.js, Plotly, Recharts",Hover + Brush
-5,Heatmap/Intensity,"heatmap, heat-map, intensity, density, matrix",Heat Map or Choropleth,"Grid Heat Map, Bubble Heat",Gradient: Cool (blue) to Hot (red). Scale: clear legend. Divergent for ±data,⚡ Excellent (color CSS),⚠ Colorblind: Use pattern overlay. Provide numerical legend.,"D3.js, Plotly, ApexCharts",Hover + Zoom
-6,Geographic Data,"geographic, map, location, region, geo, spatial","Choropleth Map, Bubble Map",Geographic Heat Map,Regional: single color gradient or categorized colors. Legend: clear scale,⚠ Moderate (rendering),⚠ Include text labels for regions. Provide data table alternative.,"D3.js, Mapbox, Leaflet",Pan + Zoom + Drill
-7,Funnel/Flow,funnel/flow,"Funnel Chart, Sankey",Waterfall (for flows),Stages: gradient (starting color → ending color). Show conversion %,⚡ Good,✓ Clear stage labels + percentages. Good for accessibility if labeled.,"D3.js, Recharts, Custom SVG",Hover + Drill
-8,Performance vs Target,performance-vs-target,Gauge Chart or Bullet Chart,"Dial, Thermometer",Performance: Red→Yellow→Green gradient. Target: marker line. Threshold colors,⚡ Good,✓ Add numerical value + percentage label beside gauge.,"D3.js, ApexCharts, Custom SVG",Hover
-9,Time-Series Forecast,time-series-forecast,Line with Confidence Band,Ribbon Chart,Actual: solid line #0080FF. Forecast: dashed #FF9500. Band: light shading,⚡ Good,✓ Clearly distinguish actual vs forecast. Add legend.,"Chart.js, ApexCharts, Plotly",Hover + Toggle
-10,Anomaly Detection,anomaly-detection,Line Chart with Highlights,Scatter with Alert,Normal: blue #0080FF. Anomaly: red #FF0000 circle/square marker + alert,⚡ Good,✓ Circle/marker for anomalies. Add text alert annotation.,"D3.js, Plotly, ApexCharts",Hover + Alert
-11,Hierarchical/Nested Data,hierarchical/nested-data,Treemap,"Sunburst, Nested Donut, Icicle",Parent: distinct hues. Children: lighter shades. White borders 2-3px.,⚠ Moderate,⚠ Poor - provide table alternative. Label large areas.,"D3.js, Recharts, ApexCharts",Hover + Drilldown
-12,Flow/Process Data,flow/process-data,Sankey Diagram,"Alluvial, Chord Diagram",Gradient from source to target. Opacity 0.4-0.6 for flows.,⚠ Moderate,⚠ Poor - provide flow table alternative.,"D3.js (d3-sankey), Plotly",Hover + Drilldown
-13,Cumulative Changes,cumulative-changes,Waterfall Chart,"Stacked Bar, Cascade",Increases: #4CAF50. Decreases: #F44336. Start: #2196F3. End: #0D47A1.,⚡ Good,✓ Good - clear directional colors with labels.,"ApexCharts, Highcharts, Plotly",Hover
-14,Multi-Variable Comparison,multi-variable-comparison,Radar/Spider Chart,"Parallel Coordinates, Grouped Bar",Single: #0080FF 20% fill. Multiple: distinct colors per dataset.,⚡ Good,⚠ Moderate - limit 5-8 axes. Add data table.,"Chart.js, Recharts, ApexCharts",Hover + Toggle
-15,Stock/Trading OHLC,stock/trading-ohlc,Candlestick Chart,"OHLC Bar, Heikin-Ashi",Bullish: #26A69A. Bearish: #EF5350. Volume: 40% opacity below.,⚡ Good,⚠ Moderate - provide OHLC data table.,"Lightweight Charts (TradingView), ApexCharts",Real-time + Hover + Zoom
-16,Relationship/Connection Data,relationship/connection-data,Network Graph,"Hierarchical Tree, Adjacency Matrix",Node types: categorical colors. Edges: #90A4AE 60% opacity.,❌ Poor (500+ nodes struggles),❌ Very Poor - provide adjacency list alternative.,"D3.js (d3-force), Vis.js, Cytoscape.js",Drilldown + Hover + Drag
-17,Distribution/Statistical,distribution/statistical,Box Plot,"Violin Plot, Beeswarm",Box: #BBDEFB. Border: #1976D2. Median: #D32F2F. Outliers: #F44336.,⚡ Excellent,"✓ Good - include stats table (min, Q1, median, Q3, max).","Plotly, D3.js, Chart.js (plugin)",Hover
-18,Performance vs Target (Compact),performance-vs-target-(compact),Bullet Chart,"Gauge, Progress Bar","Ranges: #FFCDD2, #FFF9C4, #C8E6C9. Performance: #1976D2. Target: black 3px.",⚡ Excellent,✓ Excellent - compact with clear values.,"D3.js, Plotly, Custom SVG",Hover
-19,Proportional/Percentage,proportional/percentage,Waffle Chart,"Pictogram, Stacked Bar 100%",10x10 grid. 3-5 categories max. 2-3px spacing between squares.,⚡ Good,✓ Good - better than pie for accessibility.,"D3.js, React-Waffle, Custom CSS Grid",Hover
-20,Hierarchical Proportional,hierarchical-proportional,Sunburst Chart,"Treemap, Icicle, Circle Packing",Center to outer: darker to lighter. 15-20% lighter per level.,⚠ Moderate,⚠ Poor - provide hierarchy table alternative.,"D3.js (d3-hierarchy), Recharts, ApexCharts",Drilldown + Hover
-21,Root Cause Analysis,"root cause, decomposition, tree, hierarchy, drill-down, ai-split",Decomposition Tree,"Decision Tree, Flow Chart",Nodes: #2563EB (Primary) vs #EF4444 (Negative impact). Connectors: Neutral grey.,⚠ Moderate (calculation heavy),✓ clear hierarchy. Allow keyboard navigation for nodes.,"Power BI (native), React-Flow, Custom D3.js",Drill + Expand
-22,3D Spatial Data,"3d, spatial, immersive, terrain, molecular, volumetric",3D Scatter/Surface Plot,"Volumetric Rendering, Point Cloud",Depth cues: lighting/shading. Z-axis: color gradient (cool to warm).,❌ Heavy (WebGL required),❌ Poor - requires alternative 2D view or data table.,"Three.js, Deck.gl, Plotly 3D",Rotate + Zoom + VR
-23,Real-Time Streaming,"streaming, real-time, ticker, live, velocity, pulse",Streaming Area Chart,"Ticker Tape, Moving Gauge",Current: Bright Pulse (#00FF00). History: Fading opacity. Grid: Dark.,⚡ Optimized (canvas/webgl),⚠ Flashing elements - provide pause button. High contrast.,Smoothed D3.js, CanvasJS, SciChart,Real-time + Pause
-24,Sentiment/Emotion,"sentiment, emotion, nlp, opinion, feeling",Word Cloud with Sentiment,"Sentiment Arc, Radar Chart",Positive: #22C55E. Negative: #EF4444. Neutral: #94A3B8. Size = Frequency.,⚡ Good,⚠ Word clouds poor for screen readers. Use list view.,"D3-cloud, Highcharts, Nivo",Hover + Filter
-25,Process Mining,"process, mining, variants, path, bottleneck, log",Process Map / Graph,"Directed Acyclic Graph (DAG), Petri Net",Happy path: #10B981 (Thick). Deviations: #F59E0B (Thin). Bottlenecks: #EF4444.,⚠ Moderate to Heavy,⚠ Complex graphs hard to navigate. Provide path summary.,"React-Flow, Cytoscape.js, Recharts",Drag + Node-Click