foliko 1.1.4 → 1.1.6

package/.agent/memory/reference/mnrqnr5v-v75drf.md

@@ -0,0 +1,34 @@
+---
+id: "mnrqnr5v-v75drf"
+name: "LLM友好工具描述格式最佳实践"
+type: "reference"
+project: "null"
+tags: [llm-prompt, tool-description, agent, best-practice]
+created: "2026-04-09"
+---
+为 AI Agent 扩展工具设计 LLM 友好提示词格式的最佳实践：
+
+**核心原则：**
+1. **使用场景描述** - 告诉 LLM 何时应该调用该工具，而非仅描述工具功能
+2. **真实可运行的示例** - 生成可直接复制使用的代码示例
+3. **参数清晰标注** - 必填/可选标记、类型、默认值三要素
+4. **枚举值透明** - Enum 类型必须列出所有可选值
+
+**实现要点：**
+- 使用 `_inferUseCases()` 根据插件/工具名称自动推断使用场景
+- 使用 `_generateExampleValue()` 根据参数名和类型生成合理示例
+- 表格化参数描述，用 ✅❌ 标记必填
+- 示例代码添加中文注释说明意图
+
+**格式结构：**
+1. 插件级：名称 + 功能描述 + 使用场景
+2. 工具级：工具名 + 功能 + 参数表 + 调用示例
+3. 参数级：参数名 + 类型 + 必填标记 + 描述
+
+**Why 重要：**
+- 模糊的工具描述导致 LLM 乱传参数或在不必要场景调用
+- 没有示例时 LLM 容易生成格式错误的调用
+- 不标注必填/可选导致 LLM 遗漏关键参数
+
+**How to apply：**
+参考 .agent/plugins/agent-core/agent.js 中 `_buildExtensionToolsDescription()` 函数的实现，该函数已整合了上述所有最佳实践。

package/.agent/memory/reference/mnrrfzys-urudaf.md

@@ -0,0 +1,31 @@
+---
+id: "mnrrfzys-urudaf"
+name: "Zod vs JSON Schema 兼容性修复"
+type: "reference"
+project: "null"
+tags: [foliko, plugin, schema, gate-trading, zod, json-schema]
+created: "2026-04-09"
+---
+**问题**：gate-trading 插件使用 Zod schema，但 Foliko framework 的 `_buildParamTable` 函数期望 JSON Schema 格式。
+
+**原因**：`tool.js` 中 `_buildParamTable` 直接访问 `inputSchema.properties`，但 Zod schema 没有 `properties` 属性，只有 `shape` 属性。
+
+**影响**：当插件使用 Zod schema 时，工具参数表格无法正确渲染。
+
+**解决方案**：
+1. 在 `_buildParamTable` 函数开头检测 schema 类型
+2. 如果是 Zod schema（检测 `.shape` 属性），自动转换为 JSON Schema 格式
+3. 或要求所有插件使用 JSON Schema 格式而非 Zod
+
+**修复代码模式**：
+```javascript
+const _buildParamTable = (inputSchema, isRequired) => {
+  // 兼容 Zod schema
+  let schema = inputSchema;
+  if (inputSchema && inputSchema.shape) {
+    schema = zodToJsonSchema(inputSchema);
+  }
+  const properties = schema.properties || {};
+  // ... 后续逻辑
+};
+```

package/.agent/memory/reference/mnrrocha-t0027n.md

@@ -0,0 +1,21 @@
+---
+id: "mnrrocha-t0027n"
+name: "AI SDK v6 tool API 使用方式"
+type: "reference"
+project: "null"
+tags: [ai-sdk, tool-function, v6, agent]
+created: "2026-04-09"
+---
+AI SDK v6 中 `ai.tool` 的使用方式。
+
+**问题描述**：
+在 AgentProvider 的 `_getAITools` 方法中（第 1165 行），通过 `const { tool, ToolLoopAgent } = await this._importAI()` 动态导入 `ai.tool`。在 v6.0.146 版本中，`ai.tool` 应该作为工具函数导出，但需要注意版本兼容性问题。
+
+**如何验证**：
+1. 检查 `node_modules/ai/dist/index.js` 中是否导出 `tool`
+2. 如果 `ai.tool` 不可用，可能需要升级 SDK 或使用替代方法
+
+**应用场景**：
+- 构建 AI Agent 工具系统
+- 定义工具函数供 Agent 调用
+- 如果遇到 `Cannot read properties of undefined (reading 'tool')` 错误，需检查 SDK 版本或改用其他导入方式

package/.agent/memory/reference/mnrukklc-bxndsb.md

@@ -0,0 +1,35 @@
+---
+id: "mnrukklc-bxndsb"
+name: "AI主题海报设计-破晓风格"
+type: "reference"
+project: "null"
+tags: [海报, AI主题, 破晓, 日出渐变, 科技蓝]
+created: "2026-04-09"
+---
+## 破晓主题AI海报设计参考
+
+**设计要点**:
+- 主标题：「破 晓」使用蓝白渐变艺术文字，居中偏上
+- 背景：深蓝夜空 → 黎明蓝 → 天蓝垂直渐变
+- 焦点元素：暖白色圆形太阳 + 金色光芒射线从底部中央向外辐射
+- 副标题：大写英文 "DAWN OF AI" 置于主标题下方
+- 功能卡片：三栏布局展示核心能力（自然语言、Agent、插件系统）
+- 统计卡片：数字+标签形式展示性能指标
+- 底部引用语：科技感短句
+
+**配色方案**:
+- 主色：#1e3a5f（深蓝夜空）
+- 渐变：#3b82f6（黎明蓝）
+- 强调：#60a5fa（天蓝）
+- 高光：#fef3c7（暖白太阳）
+- 光芒：#fbbf24（金色射线）
+- 文字：#ffffff（纯白）
+
+**应用场景**: AI工具宣传、破茧重生主题、黎明/希望意象的任何场景
+
+**Why重要**: 这是一个成功的AI主题海报设计，融合了科技感与希望感，配色和布局都具有视觉冲击力。
+
+**How to apply**: 
+1. AI工具宣传 → 使用破晓/启航/极光等主题
+2. 表现希望/新生 → 日出渐变 + 暖白太阳
+3. 简洁有力 → 主标题 + 功能卡片 + 统计卡片

package/.agent/memory/user/mnrt39t8-8eosy0.md

@@ -0,0 +1,9 @@
+---
+id: "mnrt39t8-8eosy0"
+name: "蓝色系配色偏好"
+type: "user"
+project: "foliko"
+tags: [poster, design, blue, preference]
+created: "2026-04-09"
+---
+用户偏好蓝色系配色方案。在海报设计中应优先使用蓝色主题，如 #3b82f6 作为主色调，深蓝色用于背景，浅蓝色用于装饰元素。Why: 用户多次表示喜欢蓝色，这应作为默认配色方案。How to apply: 在使用 poster 插件生成海报时，默认使用 blue 主题或自定义蓝色渐变。