foliko 1.1.6 → 1.1.7

package/.agent/data/ambient/goals.json

@@ -1,50 +0,0 @@
-[
-  {
-    "id": "041f34d6-8ada-4a0f-932d-147f8476a830",
-    "title": "邮箱监控与自动回复",
-    "description": "监控邮箱，收到新邮件时自动分析内容并回复，无需用户确认",
-    "priority": 8,
-    "state": "active",
-    "actions": [
-      {
-        "type": "tool",
-        "name": "email_auto_reply",
-        "args": {
-          "to": "${event.to}",
-          "subject": "${event.subject}",
-          "body": "${event.text}",
-          "from": "${event.from}",
-          "messageId": "${event.messageId}"
-        }
-      }
-    ],
-    "_originalActions": [
-      {
-        "type": "tool",
-        "name": "email_auto_reply",
-        "args": {
-          "to": "${event.to}",
-          "subject": "${event.subject}",
-          "body": "${event.text}",
-          "from": "${event.from}",
-          "messageId": "${event.messageId}"
-        }
-      }
-    ],
-    "conditions": {
-      "events": [
-        "email:received"
-      ]
-    },
-    "createdAt": "2026-03-29T18:15:42.180Z",
-    "updatedAt": "2026-03-29T19:00:39.406Z",
-    "activatedAt": "2026-03-29T18:15:44.186Z",
-    "completedAt": "2026-03-29T18:54:56.861Z",
-    "failedAt": null,
-    "attempts": 11,
-    "maxAttempts": 10,
-    "consecutiveSameActions": 0,
-    "lastActionId": null,
-    "eventsReceived": []
-  }
-]

package/.agent/data/ambient/memories.json

@@ -1,7 +0,0 @@
-[
-  {
-    "key": "test_memory",
-    "content": "Ambient Agent 测试记忆 - 创建时间: 2026-03-29，系统运行正常",
-    "timestamp": "2026-03-29T14:53:03.801Z"
-  }
-]

package/.agent/memory/core.md

@@ -1 +0,0 @@
-测试数据 - 姓名: 李四, 职业: 工程师, 城市: 北京, 兴趣: 编程

package/.agent/memory/feedback/mnrsiuoc-e1ru74.md

@@ -1,9 +0,0 @@
----
-id: "mnrsiuoc-e1ru74"
-name: "【避免指南】使用 poster 插件时必须使用完整的预设名称"
-type: "feedback"
-project: "null"
-tags: [error, avoid, poster, preset]
-created: "2026-04-09"
----
-【下次这样做】调用 poster:create_poster_canvas 时，预设名称必须使用完整值而非简化值。错误原因：用户传入了 "instagram"，但这不是有效预设，正确值是 "social_instagram"。可用的社交媒体相关预设包括：social_instagram、social_story、social_facebook、social_linkedin、social_youtube。建议在使用前查阅完整预设列表（poster_a4, poster_square, poster_16_9, poster_4_3, poster_9_16, banner_1920x500, banner_1200x400, banner_750x300, banner_468x60, banner_twitter, social_instagram, social_story, social_facebook, social_linkedin, social_youtube, promo_900x500, promo_500x500, promo_300x250, card_standard）。

package/.agent/memory/feedback/mnrt2mmz-98az6n.md

@@ -1,9 +0,0 @@
----
-id: "mnrt2mmz-98az6n"
-name: "【避免指南】使用 generate_poster 前确保画布已创建"
-type: "feedback"
-project: "null"
-tags: [error, avoid, poster, generate_poster]
-created: "2026-04-09"
----
-【下次这样做】使用 generate_poster 生成海报前，需先调用 create_poster_canvas 创建画布，或检查工具调用链是否完整。错误原因：generate_poster 是组合式海报生成的快捷方法，但底层依赖画布上下文，缺少画布初始化会导致 "No canvas created" 错误。建议先调用 create_poster_canvas 创建空白画布，或改用 compose_poster 组件化方法分步构建海报。

package/.agent/memory/feedback/mnrtqrhm-kxsicz.md

@@ -1,9 +0,0 @@
----
-id: "mnrtqrhm-kxsicz"
-name: "【避免指南】避免使用不存在的 preset 值调用 create_poster_canvas"
-type: "feedback"
-project: "null"
-tags: [error, avoid, poster, create_poster_canvas, 参数错误]
-created: "2026-04-09"
----
-【下次这样做】调用 poster:create_poster_canvas 时，preset 参数必须使用系统提供的预设值之一，禁止使用 'custom' 或其他自定义字符串。可用的 preset 值包括：poster_a4, poster_square, poster_16_9, poster_4_3, poster_9_16, banner_1920x500, banner_1200x400, banner_750x300, banner_468x60, banner_twitter, social_instagram, social_story, social_facebook, social_linkedin, social_youtube, promo_900x500, promo_500x500, promo_300x250, card_standard。如果需要自定义尺寸，应通过 width 和 height 参数直接指定（同时 preset 设为空或使用基础预设），而非将 preset 设为 'custom'。错误原因：系统不支持 'custom' 作为 preset 参数的有效值。

package/.agent/memory/feedback/mnrts8vg-i0ngzp.md

@@ -1,15 +0,0 @@
----
-id: "mnrts8vg-i0ngzp"
-name: "避免调用 ext_call 时参数类型错误导致 path.arc is not a function"
-type: "feedback"
-project: "null"
-tags: [error, avoid, poster, chart, extension]
-created: "2026-04-09"
----
-【下次这样做】使用海报图表组件时，确保传入正确的参数类型和结构。错误原因：path.arc is not a function 通常是因为内部渲染逻辑在处理饼图时，path 参数类型不匹配（如传入了普通对象而非 Path2D 对象）。
-
-【具体避免措施】
-1. 图表数据使用标准格式：{"data":[{"label":"...","value":数字,"color":"颜色"}],"type":"pie","width":数字,"height":数字}
-2. 避免在 data 中混用字符串和数字类型的 value
-3. 确认使用的插件版本支持该图表类型
-4. 如遇持续报错，考虑使用其他图表组件（柱状图）或降级插件版本

package/.agent/memory/feedback/mnrtt7jt-c0trb2.md

@@ -1,9 +0,0 @@
----
-id: "mnrtt7jt-c0trb2"
-name: "【避免指南】poster插件图片src参数必须使用本地文件路径"
-type: "feedback"
-project: "null"
-tags: [error, avoid, poster:add_poster_image]
-created: "2026-04-09"
----
-【下次这样做】使用 poster 插件添加图片时，src 参数必须传入本地文件路径（如 ./images/logo.png），不能直接使用网络 URL（如 https://via.placeholder.com/...）。错误原因：poster 插件的图片加载功能不支持网络 URL，会将 URL 当作本地文件路径处理导致文件不存在错误。如果需要使用网络图片，应先下载到本地，再传入本地路径。

package/.agent/memory/feedback/mnruc2f0-5s52la.md

@@ -1,16 +0,0 @@
----
-id: "mnruc2f0-5s52la"
-name: "【避免指南】避免同时传入互斥的背景参数（gradient/color 和 image）"
-type: "feedback"
-project: "null"
-tags: [error, avoid, poster, add_poster_background]
-created: "2026-04-09"
----
-【下次这样做】调用 add_poster_background 时，渐变背景(gradient)、纯色背景(color)、图片背景(image)三个参数是互斥的，不能同时传入。
-
-错误原因：同时传入了 gradient 和 image 参数，且 image 的值是颜色码 "#F5F2EB"，系统误认为这是图片路径，导致报错 "图片文件不存在: D:\Code\foliko\#F5F2EB"。
-
-正确做法：
-- 使用渐变背景：只传 gradient 参数，不传 image 和 color
-- 使用纯色背景：只传 color 参数（如 "#F5F2EB"），不传 gradient 和 image
-- 使用图片背景：只传 image 参数（如 "./bg.png"），不传 gradient 和 color

package/.agent/memory/feedback/mnrumbmx-63sa0v.md

@@ -1,9 +0,0 @@
----
-id: "mnrumbmx-63sa0v"
-name: "【避免指南】ext_call 调用时正确传入 plugin、tool、args 参数"
-type: "feedback"
-project: "null"
-tags: [error, avoid, poster, ext_call]
-created: "2026-04-09"
----
-【下次这样做】调用 ext_call 时必须正确传入 plugin、tool、args 三个参数。错误原因：调用参数中包含错误的字符串 `</parameter` 导致 plugin 参数被错误解析为 `poster</parameter` 而非 `poster`，导致扩展插件无法定位。正确调用方式：ext_call({ plugin: "poster", tool: "export_poster_canvas", args: {filename: "foliko-zen-kong", format: "png", outputDir: "."} })

package/.agent/memory/project/mnn93ogy-ypjn27.md

@@ -1,9 +0,0 @@
----
-id: "mnn93ogy-ypjn27"
-name: "Foliko AI Agent Platform"
-type: "project"
-project: "foliko"
-tags: [foliko, ai-agent, poster, design]
-created: "2026-04-06"
----
-Foliko 是一个 AI Agent 平台项目，位于 D:\Code\vb-agent 目录。用户正在测试不同的海报设计风格，目前已经测试了 simple、business、social 和 modern 四种模板样式。这表明用户在为项目选择合适的视觉设计风格。后续可以使用此记忆来理解用户的设计偏好，或在类似项目中提供风格建议。

package/.agent/memory/project/mnn98fqy-5nhc1u.md

@@ -1,25 +0,0 @@
----
-id: "mnn98fqy-5nhc1u"
-name: "Foliko AI 海报设计规范"
-type: "project"
-project: "Foliko"
-tags: [海报设计, AI, 品牌视觉, 项目展示]
-created: "2026-04-06"
----
-Foliko 是一个 AI 项目，slogan 是「AI 驱动的创意灵感和效率工具」。为 Foliko 制作海报的设计经验：
-
-**设计原则**：
-- 视觉层次：大标题 > 副标题 > 核心特性 > 行动号召
-- 色彩搭配：深色背景 + 霓虹渐变（科技感），蓝色代表科技/信任，绿色代表创新
-- 留白：保持简洁，不要过于拥挤
-- 对比：使用深色背景+亮色文字产生强烈对比
-- 品牌识别：保持 Foliko 的品牌色
-
-**成功实践**：
-- 使用渐变标题突出品牌名
-- 添加装饰性几何元素（圆、线条、发光点）增强科技感
-- 卡片式展示核心功能
-- 英文 + 中文双语展示增强国际感
-- 暗底亮字是有效的视觉策略
-
-**How to apply**: 在后续海报生成中，应优先使用深色背景、渐变品牌色、科技感装饰元素，聚焦核心功能展示，保持简洁有力的视觉层次。

package/.agent/memory/project/mnrp7p5n-8enm2a.md

@@ -1,31 +0,0 @@
----
-id: "mnrp7p5n-8enm2a"
-name: "Foliko Agent Framework 结构"
-type: "project"
-project: "foliko"
-tags: [architecture, src目录, 代码结构]
-created: "2026-04-09"
----
-## Foliko 项目 src 目录结构
-
-### 目录组成
-- **core/** (14文件, 208KB): 核心层，包含 Agent管理、插件系统、工具系统、会话管理
-- **capabilities/** (3文件, 56KB): 能力层，包含技能管理和工作流引擎
-- **executors/** (2文件, 27KB): 执行层，支持 MCP 协议
-- **utils/** (10文件, 63KB): 基础设施，包含错误处理、日志、熔断、重试、沙箱
-- **agent/** (空目录): 预留待开发
-
-### 设计模式
-- 插件模式 (plugin-manager)
-- 注册表模式 (tool-registry)
-- 工厂模式 (framework)
-- 熔断器模式 (circuit-breaker)
-- 观察者模式 (event-emitter)
-
-### 入口依赖链
-framework.js → agent.js → agent-chat.js + session-context.js + context-manager.js
-
-### 如何应用
-- 了解项目架构时查看此记忆
-- 新增功能时确定放在哪个层级
-- 调试问题时代码定位

package/.agent/memory/project/mnrp9ifb-yynks0.md

@@ -1,40 +0,0 @@
----
-id: "mnrp9ifb-yynks0"
-name: "agent.js 代码质量分析报告"
-type: "project"
-project: "foliko"
-tags: [代码分析, agent.js, 静态分析, 性能优化, 重构]
-created: "2026-04-09"
----
-## 背景
-Agent.js (Agent执行器) 静态分析报告，2025年1月通过静态分析工具生成。
-
-## 关键发现
-
-### P0 必须修复
-- Line 6: 删除未使用的导入 `const { pl } = require('zod/v4/locales')`
-
-### P1 强烈建议
-- Line 35-36: 魔法数字需提取为常量 (MAX_OUTPUT_TOKENS, DEFAULT_TEMPERATURE)
-- Line 370: 同步文件I/O应改为异步 `fs.promises.readFile()`
-- 多处: 循环内字符串拼接改用 `array.join('\n')`
-
-### P2 建议优化
-1. **拆分 Agent 类** - 当前承担7+种职责（Agent类913行）
-2. **显式清理事件监听器** - `destroy()` 中调用 `removeAllListeners()`
-3. **添加缺失的 JSDoc**
-4. **清理被注释代码** - Line 173
-
-### 代码指标
-- 圈复杂度: ~97
-- 最大嵌套深度: 6层
-- 代码行数: 913
-- 控制流(if): 55次, (for): 13次
-- 公共API: 76个
-- 综合评分: 3.0/5
-
-## How to Apply
-- 重构前优先处理 P0/P1 问题
-- Agent 类拆分建议：拆分为 AgentCore + AgentPlugins + AgentExecutor
-- 建议使用 ESLint + TypeScript strict 模式防止回归
-- 优化后重新跑分析对比指标改善情况

package/.agent/memory/project/mnrpb3b8-f617s4.md

@@ -1,25 +0,0 @@
----
-id: "mnrpb3b8-f617s4"
-name: "Foliko 项目架构与代码质量分析"
-type: "project"
-project: "foliko"
-tags: [架构, 代码质量, 重构, agent]
-created: "2026-04-09"
----
-## Why - 为什么重要
-
-Foliko 是一个 AI Agent 框架，采用分层架构设计。核心文件 `src/core/agent.js` 存在以下问题需要关注：
-
-1. **圈复杂度 97**（偏高）- 影响代码可维护性
-2. **913 行大类** - 承担 7+ 职责，违反单一职责原则
-3. **P0 紧急问题** - 第 6 行存在未使用导入
-4. **同步文件 I/O** - 第 370 行使用 `readFileSync`，阻塞事件循环
-5. **循环内字符串拼接** - 性能隐患
-
-## How to apply - 如何使用
-
-1. **立即修复**: 删除 `src/core/agent.js` 第 6 行未使用导入
-2. **重构 Agent 类**: 提取 ToolManager、MessageHandler 等职责
-3. **异步化**: 将 `readFileSync` 改为异步版本
-4. **性能优化**: 避免循环内字符串拼接，使用数组 join
-5. **提取魔法数字**: 为 5000、10000 等值定义常量

package/.agent/memory/project/mnrrmqgg-focprv.md

@@ -1,9 +0,0 @@
----
-id: "mnrrmqgg-focprv"
-name: "zodSchema 转换功能"
-type: "project"
-project: "foliko-agent"
-tags: [ai-sdk, zod, schema, tool-calling]
-created: "2026-04-09"
----
-在 Foliko Agent 项目中添加对 AI SDK v6 zodSchema 的支持。当前的 AI SDK v6 API 发生了重大变化，工具定义方式从 v5 的 JSON Schema 改为 zodSchema。需要修改 agent-chat.js 中 _prepareToolDefinition 方法，将工具的 inputSchema 从 JSON Schema 格式转换为 zodSchema 格式，以支持 AI SDK v6 的工具调用功能。

package/.agent/memory/project/mnrtykbh-6atsor.md

@@ -1,9 +0,0 @@
----
-id: "mnrtykbh-6atsor"
-name: "Foliko 完整功能宣传海报设计"
-type: "project"
-project: "foliko-poster-design"
-tags: [poster, design, foliko, showcase]
-created: "2026-04-09"
----
-为 Foliko 框架生成了完整的宣传海报。包含：深蓝渐变背景、主副标题区、6个核心特性卡片（插件系统、智能Agent、工作流引擎、交易插件、Ambient Agent、会话管理）、4个统计卡片、进度条、步骤指示器、引用块、CTA按钮、图表等153个组件。配色：蓝色#3b82f6为主，紫#8b5cf6、青#06b6d4、粉#f472b6为辅。文件：foliko-complete-poster.png (2000x2000px)。如需其他项目宣传材料可复用此设计模式。

package/.agent/memory/project/mnru9jiu-kgau16.md

@@ -1,35 +0,0 @@
----
-id: "mnru9jiu-kgau16"
-name: "禅意海报设计系统"
-type: "project"
-project: "foliko-poster-design"
-tags: [禅意, 原研哉, 枯山水, 马远夏圭, 极简主义, 东方美学]
-created: "2026-04-09"
----
-禅意海报设计系统 — 融合原研哉极简美学、日本枯山水意境、南宋马远夏圭'马一角夏半边'构图
-
-**核心原则：**
-- 知白守黑：大量留白是东方美学的精髓，留白即大象
-- 一角式构图：取局部而非全景，意境大于形似
-- 材质为本：追求纸张纹理、手揉痕迹、边缘粗糙等手工质感
-
-**色彩配置：**
-- 卵石色 #D6CEBD — 自然、温暖、纸张质感
-- 墨色 #2C2C2C — 书法、水墨、点睛之笔
-- 留白 #F5F2EB — 负空间、呼吸感
-- 赭石红 #8B4513 — 印章点缀，少量即可
-
-**可用元素：**
-- 枯山水砂纹（同心圆弧）
-- 墨色山石剪影（极简几何）
-- 残月/圆月
-- 禅意文字（空、寂、禅、虚）
-- 印章（单字：虚、空、禅、悟）
-- 水墨点
-
-**应用场景：**
-- 品牌禅意海报
-- 产品MUJI风展示
-- 文化活动视觉
-- 冥想/瑜伽推广
-- 茶道/香道文化宣传

package/.agent/memory/reference/mnq3oenw-46haj6.md

@@ -1,63 +0,0 @@
----
-id: "mnq3oenw-46haj6"
-name: "环形进度条代码"
-type: "reference"
-project: "null"
-tags: [poster, 海报, 进度条, 组件]
-created: "2026-04-08"
----
-# 环形进度条 (Progress Circle)
-
-## 工具函数
-`add_poster_progress_circle`
-
-## 参数说明
-| 参数 | 类型 | 默认值 | 说明 |
-|------|------|--------|------|
-| cx | number | 必填 | 圆心 X 坐标 |
-| cy | number | 必填 | 圆心 Y 坐标 |
-| radius | number | 必填 | 圆环半径 |
-| value | number | 必填 | 进度值 0-100 |
-| strokeWidth | number | 10 | 环宽度 |
-| trackColor | string | #dddddd | 轨道颜色 |
-| fillColor | string | #4CAF50 | 进度颜色 |
-| backgroundColor | string | - | 背景填充色 |
-| showLabel | boolean | true | 是否显示百分比 |
-| labelColor | string | #000000 | 标签颜色 |
-
-## 使用示例
-
-```javascript
-// 1. 创建画布
-create_poster_canvas({
-  width: 600,
-  height: 400,
-  background: '#1a1a2e'
-})
-
-// 2. 添加环形进度条
-add_poster_progress_circle({
-  cx: 300,
-  cy: 200,
-  radius: 100,
-  value: 75,
-  strokeWidth: 15,
-  trackColor: '#333355',
-  fillColor: '#e94560',
-  backgroundColor: '#1a1a2e',
-  showLabel: true,
-  labelColor: '#ffffff'
-})
-
-// 3. 导出图片
-export_poster_canvas({
-  filename: 'progress-circle-test',
-  format: 'png',
-  outputDir: './output'
-})
-```
-
-## 效果
-- 深色背景
-- 红色环形进度条显示 75%
-- 白色百分比标签居中

package/.agent/memory/reference/mnq5qxm2-mjoooh.md

@@ -1,116 +0,0 @@
----
-id: "mnq5qxm2-mjoooh"
-name: "无印风格 Foliko 海报"
-type: "reference"
-project: "null"
-tags: [poster, 海报, 无印风格, MUJI, foliko]
-created: "2026-04-08"
----
-# 无印风格 (MUJI Style) Foliko 海报
-
-## 配色方案
-
-| 元素 | 颜色代码 | 用途 |
-|------|----------|------|
-| 背景 | `#f7f5f0` | 米白纸张色 |
-| 主标题 | `#333333` | 深炭灰艺术字 |
-| 副标题 | `#666666` | 中灰 |
-| 正文 | `#555555` | 深灰正文 |
-| 辅助文字 | `#999999` | 浅灰 |
-| 点缀/装饰 | `#8b7355` | 自然棕线条 |
-| 按钮背景 | `#efefeb` | 淡米色 |
-| 功能圆标 | `#e8e5df` | 暖灰圆圈 |
-| 分隔线 | `#cccccc` / `#dddddd` | 浅灰分隔 |
-
-## 设计规范
-
-### 尺寸
-- 竖版海报：1080 x 2200
-
-### 排版结构
-1. **顶部装饰** - 左右两侧自然棕竖线
-2. **标题区** - Logo + 副标题 + 分隔线
-3. **核心特性** - 6个功能点，3x2网格布局
-4. **安装命令** - PowerShell 命令框
-5. **使用方法** - 4个步骤说明
-6. **底部信息** - 官网 + 装饰线 + 装饰圆
-
-### 字体
-- 艺术字标题：渐变深灰
-- 正文：Microsoft YaHei
-- 代码：Consolas
-
-### 组件使用
-- 线条：`add_poster_line` - 装饰线、分隔线
-- 圆形：`add_poster_circle` - 功能图标背景
-- 矩形：`add_poster_rectangle` - 命令框
-- 艺术字：`add_poster_art_text` - Logo
-- 文字：`add_poster_text` - 所有文字
-
-## 代码模板
-
-```javascript
-// 1. 创建画布
-create_poster_canvas({
-  width: 1080,
-  height: 2200,
-  background: '#f7f5f0'
-})
-
-// 2. 顶部装饰线
-add_poster_line({ x1: 100, y1: 100, x2: 100, y2: 280, stroke: '#8b7355', strokeWidth: 2 })
-add_poster_line({ x1: 960, y1: 100, x2: 960, y2: 280, stroke: '#8b7355', strokeWidth: 2 })
-
-// 3. Logo 艺术字
-add_poster_art_text({
-  text: 'FOLIKO',
-  x: 540, y: 380,
-  fontSize: 120,
-  gradient: { colors: ['#333333', '#555555'], direction: 90 }
-})
-
-// 4. 副标题
-add_poster_text({
-  text: '简约的插件化 Agent 框架',
-  x: 540, y: 460,
-  fontSize: 24, color: '#666666', align: 'center'
-})
-
-// 5. 分隔线
-add_poster_line({ x1: 340, y1: 510, x2: 740, y2: 510, stroke: '#cccccc', strokeWidth: 1 })
-
-// 6. 功能特点（3x2网格）
-// 每组：圆形背景 + 图标 + 文字
-
-// 7. 安装命令框
-add_poster_rectangle({ x: 140, y: 1100, width: 800, height: 70, fill: '#efefeb', radius: 4 })
-add_poster_text({
-  text: 'irm https://foliko.com/install.ps1 | iex',
-  x: 540, y: 1145,
-  fontSize: 20, fontFamily: 'Consolas', color: '#555555', align: 'center'
-})
-
-// 8. 使用方法（4个步骤）
-// 01 安装后输入 foliko chat
-// 02 支持多 AI：Anthropic / DeepSeek / OpenAI
-// 03 插件扩展：Shell / Python / MCP
-// 04 技能系统自定义工作流程
-
-// 9. 底部
-add_poster_text({ text: 'foliko.com', x: 540, y: 1750, fontSize: 20, color: '#999999', align: 'center' })
-
-// 10. 底部装饰
-add_poster_line({ x1: 80, y1: 1900, x2: 200, y2: 1900, stroke: '#8b7355', strokeWidth: 1 })
-add_poster_circle({ cx: 100, cy: 2050, rx: 80, ry: 80, fill: '#e5e2dc', opacity: 0.5 })
-add_poster_circle({ cx: 980, cy: 2000, rx: 120, ry: 120, fill: '#ebe8e2', opacity: 0.6 })
-
-// 11. 导出
-export_poster_canvas({ filename: 'foliko-muji-poster', format: 'png', outputDir: './output' })
-```
-
-## 风格特点
-- 大量留白，简约干净
-- 自然色系，低饱和度
-- 简洁线条装饰
-- 柔和的圆形元素
-- 层次分明的章节结构

package/.agent/memory/reference/mnrnvpwo-rcqv9m.md

@@ -1,52 +0,0 @@
----
-id: "mnrnvpwo-rcqv9m"
-name: "Foliko 代码优化分析报告"
-type: "reference"
-project: "foliko"
-tags: [代码分析, 安全漏洞, 性能优化, 最佳实践]
-created: "2026-04-09"
----
-# Foliko 代码优化分析报告
-
-## 严重问题 (Critical)
-
-### 1. VM2 沙箱逃逸风险
-- 位置: `src/utils/sandbox.js`
-- 问题: VM2 已停止维护，存在已知 CVE 漏洞
-- 方案: 替换为 Node.js 内置 vm 模块、isolated-vm 或 Worker Threads
-
-### 2. EventEmitter 内存泄漏
-- 位置: `src/core/framework.js` 多处 `on()` 调用
-- 问题: 插件重载时产生重复监听器
-- 方案: 使用 `once()` 或存储引用后手动移除
-
-### 3. 依赖安全问题
-- vm2, node-telegram-bot-api 版本过旧
-- 方案: 运行 `npm audit fix`
-
-## 中等问题 (High)
-
-### 4. 循环依赖
-- `agent-chat.js` ↔ `agent.js`
-- 方案: 使用依赖注入或延迟导入
-
-### 5. 错误处理不一致
-- 部分错误被静默忽略
-- 方案: 统一使用 ErrorBoundary
-
-### 6. 缺少输入验证
-- 方案: 使用 Zod 进行运行时验证
-
-### 7. Token 计算不准确
-- 位置: `src/core/agent-chat.js` SimpleTokenizer
-- 问题: 中文/英文/代码比率差异大
-- 方案: 使用 TikToken 或区分内容类型
-
-### 8. 敏感信息明文存储
-- 方案: 不保存 API keys 到 state 文件
-
-## 如何应用
-- 开发新功能时避免引入这些问题
-- 重构时优先修复 P0/P1 问题
-- 代码审查时检查类似模式
-- 添加新依赖前检查安全漏洞

package/.agent/memory/reference/mnrovxvz-zy9xqm.md

@@ -1,25 +0,0 @@
----
-id: "mnrovxvz-zy9xqm"
-name: "Foliko Agent 框架架构"
-type: "reference"
-project: "null"
-tags: [ai-agent, framework, nodejs, plugin-system, architecture]
-created: "2026-04-09"
----
-Foliko 是一个简约的插件化 Agent 框架 (v1.1.4, MIT)
-
-**Why 重要**：
-- 核心框架位于 src/，采用分层架构设计
-- 提供 39 个内置插件（邮件、交易、消息推送、记忆等）
-- 支持 MCP 协议、Ambient Agent、SubAgent 子代理
-- 内置 13 个技能定义指导 AI 行为
-- 工作流引擎支持复杂自动化流程
-
-**技术栈**：Node.js >= 18, Hono.js, Vercel AI SDK, Zod, 支持多 AI Provider (Anthropic, OpenAI, DeepSeek)
-
-**How to apply**：
-- 开发新插件：参考 plugins/ 目录结构，参考 SPEC.md 规格说明
-- 添加技能：在 skills/ 目录创建 .md 文件定义技能指南
-- 子 Agent：在 .agent/agents/ 创建配置文件
-- 扩展工具：在 src/core/tool-registry.js 注册新工具
-- 文档参考：docs/ 目录有用户手册和优化指南