foliko 1.1.5 → 1.1.6

package/.agent/data/plugins-state.json

@@ -7,40 +7,150 @@
     "enabled": true,
     "config": {}
   },
-  "ai": {
-    "enabled": true
+  "skill-manager": {
+    "enabled": true,
+    "config": {}
   },
-  "storage": {
+  "mcp-executor": {
+    "enabled": true,
+    "config": {}
+  },
+  "python-plugin-loader": {
+    "enabled": true,
+    "config": {}
+  },
+  "subagent-manager": {
     "enabled": true,
     "config": {
-      "type": "json",
-      "path": ".agent/data",
-      "namespace": "default"
+      "agentsDir": ".agent/agents",
+      "agents": [
+        {
+          "name": "code-assistant",
+          "description": "代码助手 - 专业的编程和代码分析助手",
+          "instructions": "你是一个专业的代码助手，精通多种编程语言和开发技术。\n\n【核心能力】\n- 代码编写、调试和优化\n- 代码审查和重构建议\n- 多种编程语言支持（Python、JavaScript、TypeScript、Java等）\n- 代码问题诊断和解决\n- 解释复杂代码逻辑\n\n【工作原则】\n- 提供清晰、规范的代码\n- 包含必要的注释说明\n- 考虑代码性能和安全性\n- 遵循最佳实践",
+          "tools": [
+            "read_file",
+            "write_file",
+            "modify_file",
+            "search_file",
+            "python-execute",
+            "execute_command",
+            "shell"
+          ],
+          "_fromDir": true
+        },
+        {
+          "name": "email-assistant",
+          "description": "邮件助手 - 专业的邮件管理助手",
+          "instructions": "你是一个专业的邮件助手，擅长邮件的读写、筛选和管理。\n\n【核心能力】\n- 读取和回复邮件\n- 发送新邮件（支持附件）\n- 邮件搜索和筛选\n- 邮件摘要生成\n- 批量邮件处理\n\n【工作原则】\n- 保持邮件格式规范\n- 回复内容专业得体\n- 保护隐私信息\n- 及时处理重要邮件",
+          "tools": [
+            "email_read",
+            "email_send",
+            "email_mark_read",
+            "email_delete",
+            "email_unread_count",
+            "email_configure",
+            "notification_send"
+          ],
+          "_fromDir": true
+        },
+        {
+          "name": "file-assistant",
+          "description": "文件助手 - 专业的文件管理和操作助手",
+          "instructions": "你是一个专业的文件助手，擅长文件操作、目录管理、文件搜索和内容编辑。\n\n【核心能力】\n- 读取、创建、编辑、删除文件和目录\n- 搜索文件内容和文件名称\n- 批量文件操作\n- 文件内容分析和提取\n\n【工作原则】\n- 执行操作前确认路径正确\n- 危险操作（如删除）需要谨慎\n- 保持文件编码一致性\n- 重要文件操作前可创建备份",
+          "tools": [
+            "read_file",
+            "write_file",
+            "delete_file",
+            "modify_file",
+            "search_file",
+            "read_directory",
+            "create_directory",
+            "execute_command"
+          ],
+          "_fromDir": true
+        },
+        {
+          "name": "system-assistant",
+          "description": "系统助手 - 专业的系统信息监控和管理助手",
+          "instructions": "你是一个专业的系统助手，精通系统信息监控和基础管理。\n\n【核心能力】\n- CPU、内存、磁盘使用情况监控\n- 网络接口信息查询\n- 系统运行状态分析\n- 性能问题诊断\n- 定时监控和报告\n\n【工作原则】\n- 提供清晰的数据展示\n- 发现异常及时提醒\n- 给出合理的优化建议\n- 保护系统安全",
+          "tools": [
+            "get_basic_info",
+            "get_cpu_info",
+            "get_memory_info",
+            "get_disk_info",
+            "get_network_info",
+            "get_full_system_info",
+            "notification_send",
+            "schedule_task"
+          ],
+          "_fromDir": true
+        },
+        {
+          "name": "web-assistant",
+          "description": "网络助手 - 专业的网络数据获取和处理助手",
+          "instructions": "你是一个专业的网络助手，精通网络数据获取和处理。\n\n【核心能力】\n- HTTP请求发送（GET/POST/PUT/DELETE等）\n- 网页内容抓取和解析\n- API调用和数据处理\n- JSON/XML数据解析\n- 网络问题诊断\n\n【工作原则】\n- 遵守网站使用协议\n- 合理控制请求频率\n- 数据处理规范\n- 异常情况妥善处理",
+          "tools": [
+            "fetch",
+            "web_request",
+            "execute_command",
+            "python-execute",
+            "notification_send"
+          ],
+          "_fromDir": true
+        }
+      ]
     }
   },
-  "tools": {
+  "system-info": {
     "enabled": true,
     "config": {}
   },
-  "workflow": {
+  "ai": {
+    "enabled": true
+  },
+  "ambient": {
     "enabled": true,
-    "config": {}
+    "config": {
+      "enabled": true,
+      "tickInterval": 5000,
+      "cooldownPeriod": 3000,
+      "persistencePath": ".agent/data/ambient",
+      "defaultGoals": []
+    }
   },
-  "skill-manager": {
+  "audit": {
     "enabled": true,
+    "config": {
+      "maxLogs": 1000,
+      "retentionDays": 30,
+      "logDir": ".agent/logs"
+    }
+  },
+  "email": {
+    "enabled": false,
     "config": {}
   },
-  "mcp-executor": {
+  "extension-executor": {
     "enabled": true,
     "config": {}
   },
-  "shell-executor": {
-    "enabled": true,
+  "feishu": {
+    "enabled": false,
     "config": {
-      "timeout": 60000,
-      "workingDir": "D:\\code\\vb-agent"
+      "appId": "cli_a90e8b47db235bdb",
+      "appSecret": "Vmfy9gXWtYQtec36uY3B8ecr1QEZO2N8",
+      "allowedUsers": []
     }
   },
+  "file-system": {
+    "enabled": true,
+    "config": {}
+  },
+  "gate-trading": {
+    "enabled": true,
+    "config": {}
+  },
   "python-executor": {
     "enabled": true,
     "config": {
@@ -50,6 +160,20 @@
       "pipPath": null
     }
   },
+  "rules": {
+    "enabled": true,
+    "config": {
+      "rulesDir": ".agent/rules",
+      "autoLoad": true
+    }
+  },
+  "scheduler": {
+    "enabled": true,
+    "config": {
+      "checkInterval": 1000,
+      "persistencePath": ".agent/data/scheduler"
+    }
+  },
   "session": {
     "enabled": true,
     "config": {
@@ -64,32 +188,30 @@
       "onSessionCreated": null
     }
   },
-  "audit": {
+  "shell-executor": {
     "enabled": true,
     "config": {
-      "maxLogs": 1000,
-      "retentionDays": 30,
-      "logDir": ".agent/logs"
+      "timeout": 60000,
+      "workingDir": "D:\\Code\\vb-agent"
     }
   },
-  "rules": {
+  "storage": {
     "enabled": true,
     "config": {
-      "rulesDir": ".agent/rules",
-      "autoLoad": true
+      "type": "json",
+      "path": ".agent/data",
+      "namespace": "default"
     }
   },
-  "scheduler": {
-    "enabled": true,
+  "telegram": {
+    "enabled": false,
     "config": {
-      "checkInterval": 1000,
-      "persistencePath": ".agent/data/scheduler"
+      "botToken": "\"1980700161:AAHQQxKRAyg6-MuOTZDIj7x9WjEdIaGhK5I\"",
+      "allowedChats": [],
+      "groupMode": false,
+      "prefix": "/"
     }
   },
-  "file-system": {
-    "enabled": true,
-    "config": {}
-  },
   "think": {
     "enabled": true,
     "config": {
@@ -99,172 +221,42 @@
       "enableContinuous": false
     }
   },
-  "python-plugin-loader": {
+  "tools": {
     "enabled": true,
     "config": {}
   },
-  "telegram": {
-    "enabled": false,
-    "config": {
-      "botToken": "1980700161:AAHQQxKRAyg6-MuOTZDIj7x9WjEdIaGhK5I",
-      "allowedChats": [],
-      "groupMode": false,
-      "prefix": "/",
-      "systemPrompt": "你是一个有帮助的AI助手。"
-    }
-  },
-  "weixin": {
-    "enabled": false,
-    "config": {
-      "forceLogin": false,
-      "qrcodeTerminal": true,
-      "allowedUsers": [],
-      "systemPrompt": "你是一个有帮助的AI助手。回复内容不要使用markdown格式文本"
-    }
-  },
-  "email": {
+  "web": {
     "enabled": true,
     "config": {}
   },
-  "subagent-manager": {
-    "enabled": true,
-    "config": {
-      "agentsDir": "D:\\code\\vb-agent\\.agent\\agents",
-      "agents": [
-        {
-          "name": "code-archaeologist",
-          "description": "Expert in legacy code, refactoring, and understanding undocumented systems. Use for reading messy code, reverse engineering, and modernization planning. Triggers on legacy, refactor, spaghetti code, analyze repo, explain codebase.",
-          "tools": "Read, Grep, Glob, Edit, Write",
-          "model": "inherit",
-          "skills": "clean-code, refactoring-patterns, code-review-checklist",
-          "_fromDir": true
-        },
-        {
-          "name": "data-analyst",
-          "description": "Expert in data analysis, visualization, statistics, and Python data processing. Use for pandas, matplotlib, CSV analysis, statistical tests, and generating charts. Triggers on analyze data, chart, plot, statistics, csv, excel, pandas, matplotlib, correlation, trend.",
-          "tools": "Read, Write, Glob, Grep, PythonExecute, PythonScript, PipInstall, Bash",
-          "model": "inherit",
-          "skills": "python-data, statistics-basics, visualization-patterns",
-          "_fromDir": true
-        },
-        {
-          "name": "devops-engineer",
-          "description": "Expert in deployment, server management, CI/CD, and production operations. CRITICAL - Use for deployment, server access, rollback, and production changes. HIGH RISK operations. Triggers on deploy, production, server, pm2, ssh, release, rollback, ci/cd.",
-          "tools": "Read, Grep, Glob, Bash, Edit, Write",
-          "model": "inherit",
-          "skills": "clean-code, deployment-procedures, server-management, powershell-windows, bash-linux",
-          "_fromDir": true
-        },
-        {
-          "name": "email-admin",
-          "description": "Email management expert for sending, reading, configuring emails, and monitoring inbox. Use for composing emails, checking unread messages, setting up email watches, configuring SMTP/IMAP, and email automation. Triggers on email, mail, inbox, smtp, imap, send email, read email, unread.",
-          "tools": "Read, Write, Edit, Glob, Grep, Bash, Shell, ExecuteCommand, EmailSend, EmailRead, EmailConfigure, EmailWatch, EmailUnreadCount, EmailMarkRead, EmailDelete, EmailAutoReply, Fetch",
-          "model": "inherit",
-          "skills": "clean-code",
-          "_fromDir": true
-        },
-        {
-          "name": "frontend-specialist",
-          "description": "Senior Frontend Architect who builds maintainable React/Next.js systems with performance-first mindset. Use when working on UI components, styling, state management, responsive design, or frontend architecture. Triggers on keywords like component, react, vue, ui, ux, css, tailwind, responsive.",
-          "tools": "Read, Grep, Glob, Bash, Edit, Write",
-          "model": "inherit",
-          "skills": "clean-code, nextjs-react-expert, web-design-guidelines, tailwind-patterns, frontend-design, lint-and-validate",
-          "_fromDir": true
-        },
-        {
-          "name": "product-manager",
-          "description": "Expert in product requirements, user stories, and acceptance criteria. Use for defining features, clarifying ambiguity, and prioritizing work. Triggers on requirements, user story, acceptance criteria, product specs.",
-          "tools": "Read, Grep, Glob, Bash",
-          "model": "inherit",
-          "skills": "plan-writing, brainstorming, clean-code",
-          "_fromDir": true
-        },
-        {
-          "name": "python-developer",
-          "description": "Expert in Python development including web frameworks (FastAPI, Flask, Django), data processing (pandas, numpy), automation scripts, and API development. Triggers on python, fastapi, flask, django, pandas, numpy, pip, virtualenv, pytest, script, automation.",
-          "tools": "Read, Write, Glob, Grep, SearchFile, PythonExecute, PythonScript, PipInstall, Bash",
-          "model": "inherit",
-          "skills": "python-patterns, fastapi-guide, pandas-cookbook",
-          "_fromDir": true
-        },
-        {
-          "name": "security-auditor",
-          "description": "Elite cybersecurity expert. Think like an attacker, defend like an expert. OWASP 2025, supply chain security, zero trust architecture. Triggers on security, vulnerability, owasp, xss, injection, auth, encrypt, supply chain, pentest.",
-          "tools": "Read, Grep, Glob, Bash, Edit, Write",
-          "model": "inherit",
-          "skills": "clean-code, vulnerability-scanner, red-team-tactics, api-patterns",
-          "_fromDir": true
-        }
-      ]
-    }
-  },
-  "web": {
+  "plugin_manager": {
     "enabled": true,
     "config": {}
   },
-  "feishu": {
+  "weixin": {
     "enabled": false,
     "config": {
+      "forceLogin": false,
+      "qrcodeTerminal": true,
       "allowedUsers": []
     }
   },
-  "test-subagent": {
-    "enabled": true,
-    "config": {}
-  },
-  "system-info": {
-    "enabled": true,
-    "config": {}
-  },
-  "proactive-agent": {
+  "daytona": {
     "enabled": true,
     "config": {
-      "autoStart": false,
-      "exploreInterval": 30000,
-      "maxNoProgress": 5,
-      "maxIterations": 20,
-      "enableReflection": true,
-      "maxConcurrentGoals": 3,
-      "quiet": false,
-      "reflectionThreshold": 2
+      "apiKey": "dtn_0312a20cad24464cdc31cff0184eb7dfe7f8791bd9b2719798357a6251946a39",
+      "apiUrl": "https://app.daytona.io/api"
     }
   },
-  "test-plugin": {
+  "test": {
     "enabled": true,
     "config": {}
   },
-  "ambient": {
-    "enabled": true,
-    "config": {
-      "enabled": true,
-      "tickInterval": 5000,
-      "cooldownPeriod": 3000,
-      "persistencePath": ".agent/data/ambient",
-      "defaultGoals": [],
-      "llmCallTimeout": 30000,
-      "actionTimeout": 20000
-    }
-  },
-  "puppeteer": {
+  "marknative": {
     "enabled": true,
     "config": {}
   },
-  "subagents": {
-    "enabled": true,
-    "config": {
-      "agentsDir": "D:\\code\\vb-agent\\.agent\\agents",
-      "agents": []
-    }
-  },
-  "extension-executor": {
-    "enabled": true,
-    "config": {}
-  },
-  "gate-trading": {
-    "enabled": true,
-    "config": {}
-  },
-  "plugin_manager": {
+  "poster-designer": {
     "enabled": true,
     "config": {}
   },
@@ -278,11 +270,24 @@
         "preference",
         "setting",
         "user"
-      ]
+      ],
+      "maxCoreMemory": 4000
+    }
+  },
+  "session-memory": {
+    "enabled": true,
+    "config": {
+      "memoryDir": ".agent/memory",
+      "maxCoreMemory": 4000,
+      "maxRecallResults": 5
     }
   },
   "poster": {
     "enabled": true,
     "config": {}
+  },
+  "coordinator": {
+    "enabled": true,
+    "config": {}
   }
 }

package/.agent/data/scheduler/tasks.json

@@ -0,0 +1 @@
+[]

package/.agent/mcp_config.json

@@ -1,4 +1,10 @@
 {
   "mcpServers": {
+    "fetch": {
+      "args": [
+        "mcp-server-fetch"
+      ],
+      "command": "uvx"
+    }
   }
 }

package/.agent/memory/core.md

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

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

@@ -0,0 +1,9 @@
+---
+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

@@ -0,0 +1,9 @@
+---
+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

@@ -0,0 +1,9 @@
+---
+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

@@ -0,0 +1,15 @@
+---
+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

@@ -0,0 +1,9 @@
+---
+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

@@ -0,0 +1,16 @@
+---
+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

@@ -0,0 +1,9 @@
+---
+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

@@ -0,0 +1,9 @@
+---
+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

@@ -0,0 +1,25 @@
+---
+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

@@ -0,0 +1,31 @@
+---
+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

@@ -0,0 +1,40 @@
+---
+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 模式防止回归
+- 优化后重新跑分析对比指标改善情况