foliko 1.1.7 → 1.1.8

package/.agent/memory/feedback/mnsnq17s-nabrn9.md

@@ -0,0 +1,9 @@
+---
+id: "mnsnq17s-nabrn9"
+name: "【避免指南】避免在未创建画布时调用get_poster_canvas_info"
+type: "feedback"
+project: "null"
+tags: [error, avoid, poster:get_poster_canvas_info]
+created: "2026-04-10"
+---
+【下次这样做】使用poster插件时，在调用get_poster_canvas_info之前，必须先调用create_poster_canvas创建画布。例如：ext_call({plugin: 'poster', tool: 'create_poster_canvas', args: {preset: 'social'}})。错误原因：No canvas created表示画布不存在，无法获取信息。

package/.agent/memory/feedback/mnsnybet-wz7rn3.md

@@ -0,0 +1,9 @@
+---
+id: "mnsnybet-wz7rn3"
+name: "避免在导出海报前未创建画布"
+type: "feedback"
+project: "null"
+tags: [error, avoid, poster, export_poster_canvas]
+created: "2026-04-10"
+---
+【下次这样做】在调用 poster:export_poster_canvas 之前必须先调用 poster:create_poster_canvas 创建画布。错误原因：直接调用导出工具时，画布不存在，导致报错 "No canvas created"。正确顺序：1) create_poster_canvas 创建画布 → 2) 添加海报元素（背景、文字、图片等）→ 3) export_poster_canvas 导出图片。

package/.agent/memory/feedback/mnsrw0s7-7s9e30.md

@@ -0,0 +1,9 @@
+---
+id: "mnsrw0s7-7s9e30"
+name: "【避免指南】海报制作前必须先创建画布"
+type: "feedback"
+project: "null"
+tags: [error, avoid, poster, workflow]
+created: "2026-04-10"
+---
+【下次这样做】使用 poster 插件添加元素（如文字、图片等）前，必须先调用 create_poster_canvas 创建画布。错误原因：在未创建画布的情况下直接添加元素，导致插件无法定位目标画布。正确流程：1. 调用 create_poster_canvas 创建画布；2. 调用 add_poster_* 系列函数添加元素；3. 调用 export_poster_canvas 导出海报。

package/.agent/memory/feedback/mnu5hpnd-tlm16q.md

@@ -0,0 +1,9 @@
+---
+id: "mnu5hpnd-tlm16q"
+name: "布局文字比例问题反馈"
+type: "feedback"
+project: "null"
+tags: [海报, 布局, 文字比例, 重制]
+created: "2026-04-11"
+---
+用户反馈之前的布局和文字比例不正确，需要重新制作。Why：布局和文字比例是海报视觉传达的核心要素，比例失调会影响信息传达效果。How to apply：下次制作海报时，先确定整体布局结构，确保文字大小与画布比例协调，标题、副标题、正文的层级比例要分明（建议标题占15-20%，副标题10-15%，正文内容保持足够留白）。

package/.agent/memory/feedback/mnu60uqe-xuoxp4.md

@@ -0,0 +1,9 @@
+---
+id: "mnu60uqe-xuoxp4"
+name: "避免调用不存在的海报组件工具"
+type: "feedback"
+project: "null"
+tags: [error, avoid, poster, barcode]
+created: "2026-04-11"
+---
+【下次这样做】在调用海报插件工具前，先使用 list_poster_components 列出所有可用的组件类型，确认目标工具存在后再调用。错误原因：调用了不存在的工具 add_poster_barcode，可能是误以为存在该功能但实际该工具不在插件支持范围内。建议：使用 compose_poster 或 generate_poster 等已确认存在的工具来实现海报生成需求。

package/.agent/memory/project/mnqx54u5-loqtoe.md

@@ -0,0 +1,9 @@
+---
+id: "mnqx54u5-loqtoe"
+name: "FOLIKO项目核心信息与设计规范"
+type: "project"
+project: "FOLIKO"
+tags: [核心特性, 设计规范, 项目路径, 用户偏好]
+created: "2026-04-09"
+---
+FOLIKO项目核心特性为：插件化架构、多模型支持、流式实时响应。项目路径位于 D:\code\vb-agent\。项目视觉设计规范为：暗色科技风+赛博朋克霓虹（深蓝黑底+青绿渐变+紫色点缀），用户偏好精美且让AI自主决定的设计。Why: 明确项目核心卖点与视觉品牌基调，确保后续内容生成的一致性；记录用户偏好以优化交互体验。How to apply: 涉及FOLIKO的宣传、UI设计时，必须体现三大核心特性，并沿用科技风霓虹配色；对用户采取“直接出精美方案、少问细节”的交互策略。

package/.agent/memory/project/mnqx84cv-mx6dmd.md

@@ -0,0 +1,9 @@
+---
+id: "mnqx84cv-mx6dmd"
+name: "海报背景生成策略"
+type: "project"
+project: "海报生成"
+tags: [海报, 背景, 渐变, bug修复]
+created: "2026-04-09"
+---
+用户反馈海报没有背景。Why: 海报生成时可能遗漏背景设置，导致海报无背景。How to apply: 生成海报时必须确保添加背景；若需渐变背景，可采用先设置纯色背景，再用渐变矩形覆盖的方法来模拟实现。

package/.agent/memory/project/mnsacuyr-hgtk5n.md

@@ -0,0 +1,20 @@
+---
+id: "mnsacuyr-hgtk5n"
+name: "Zod复杂类型schema解析修复"
+type: "project"
+project: "foliko-agent"
+tags: [zod, schema, extension-tools, parameter-table, bugfix]
+created: "2026-04-10"
+---
+agent.js 的 `_fallbackSchemaToText` 方法需要递归处理复杂 Zod 类型（如 `ZodOptional`、`ZodUnion`、`ZodArray` 等）。
+
+问题场景：.agent/plugins 下的自定义扩展插件使用复杂 schema（如 `z.union([...])` 或 `z.optional()`）时，`zodSchemaToTable` 无法正确解析，导致显示 "Type: ZodObject" 而非参数表格。
+
+解决方案：实现 `_extractFieldType(validator)` 方法，递归检查 `_def.innerType`、`_def.types` 等属性，正确提取字段类型名称。
+
+关键代码模式：
+- `ZodOptional` -> 检查 `validator._def.innerType`
+- `ZodUnion` -> 检查 `validator._def.types`
+- `ZodArray` -> 检查 `validator._def.type`
+
+参考文件：agent.js 的 `_fallbackSchemaToText` 方法。

package/.agent/memory/project/mnu5hy2x-bjsg7u.md

@@ -0,0 +1,9 @@
+---
+id: "mnu5hy2x-bjsg7u"
+name: "插件字体支持问题"
+type: "project"
+project: "null"
+tags: [插件开发, 字体, 中文乱码]
+created: "2026-04-11"
+---
+插件中多处组件调用字体时存在中文乱码问题。需要在所有字体调用的地方添加字体支持（特别是中文字体）。建议统一使用支持中文的字体（如思源黑体、Noto Sans CJK等）。

package/.agent/memory/reference/mnre3cww-penbo1.md

@@ -0,0 +1,9 @@
+---
+id: "mnre3cww-penbo1"
+name: "ext_call 参数约束"
+type: "reference"
+project: "null"
+tags: [ext_call, 参数验证, 插件开发]
+created: "2026-04-09"
+---
+ext_call 调用时参数类型有约束：text 参数不能为数字或 null（需要字符串）；settle 参数不能为数组（需要字符串如 'USDT'）。Why：参数类型错误会导致调用失败，影响插件功能。How to apply：调用前确保参数类型符合规范，字符串参数用 .toLowerCase() 前需确认类型。

package/.agent/memory/reference/mns9wn48-luerua.md

@@ -0,0 +1,14 @@
+---
+id: "mns9wn48-luerua"
+name: "zodSchemaToTable fallback 机制缺失"
+type: "reference"
+project: "foliko-framework"
+tags: [bug-fix, agent-js, extension-tools, schema-parsing]
+created: "2026-04-10"
+---
+在 `agent.js` 的 `_buildExtensionToolsDescription()` 方法中，当 `zodSchemaToTable(tool.inputSchema)` 无法正确解析 schema（返回 `Type: ZodObject` 或 null）时，应该提供一个 fallback 机制，遍历 `tool.inputSchema.shape` 或 `tool.inputSchema.properties` 来手动构建参数表格，而不是直接显示 "参数信息不可用"。
+
+**如何应用**：
+1. 在 agent.js 中添加一个辅助函数 `buildFallbackSchemaTable(schema)`，尝试从 `schema.shape` 或 `schema.properties` 提取参数信息
+2. 在 zodSchemaToTable 返回无效结果时调用此 fallback
+3. 显示参数名、类型、描述（如果有的话）

package/.agent/memory/reference/mns9yz5c-thc2s0.md

@@ -0,0 +1,16 @@
+---
+id: "mns9yz5c-thc2s0"
+name: "agent.js 遗漏 version 字段输出"
+type: "reference"
+project: "null"
+tags: [bug, agent.js, extension-executor, 缺陷修复]
+created: "2026-04-10"
+---
+在 agent.js 的 _buildExtensionToolsDescription 方法中，调用 getExtensions() 后遍历扩展时，输出了 name 和 description，但遗漏了 version 字段。
+
+**问题代码位置：** agent.js 第 267 行附近
+**正确做法：** 应添加版本信息输出，例如：sections.push(`**版本：** ${ext.version || '1.0.0'}`, '');
+
+**涉及文件：**
+- extension-executor-plugin.js: getExtensions() 方法返回正确结构
+- agent.js: _buildExtensionToolsDescription 方法输出不完整

package/.agent/memory/reference/mnsfy4um-910f1o.md

@@ -0,0 +1,23 @@
+---
+id: "mnsfy4um-910f1o"
+name: "复古杂志风海报设计规范"
+type: "reference"
+project: "null"
+tags: [海报设计, 复古风格, 杂志风]
+created: "2026-04-10"
+---
+复古杂志风海报设计规范：
+
+**Why（为什么重要）**：用户在多次设计中明确选择了复古杂志风格，这表明这可能是一个常用的设计偏好。记录设计规范可以快速复用于未来类似需求。
+
+**How to apply（如何使用）**：
+1. 背景：米白色 #F8F6F3
+2. 主色：纯黑 #1A1A1A
+3. 字体：中文用系统默认衬线/无衬线，英文用 Georgia 或 Times New Roman
+4. 布局特点：
+   - 左侧粗黑竖线装饰（strokeWidth: 6-8）
+   - 超大标题字体（fontSize: 80-120）
+   - 粗黑分隔线（strokeWidth: 2-4）
+   - 多区块内容排版
+   - 可添加斜体英文作为装饰
+5. 风格关键词：极简、复古、杂志感、留白、粗边框分割

package/.agent/memory/reference/mnsg37dp-lmfj18.md

@@ -0,0 +1,32 @@
+---
+id: "mnsg37dp-lmfj18"
+name: "樟木头收容遣送站历史资料"
+type: "reference"
+project: "null"
+tags: [历史, 收容遣送, 樟木头, 无印风格]
+created: "2026-04-10"
+---
+# 樟木头收容遣送站历史资料
+
+## 基本信息
+- **成立时间**：1969年
+- **地理位置**：广东省东莞市樟木头镇
+- **设立目的**：安置因各种原因流入城市的无合法身份人员
+
+## 收容遣送制度背景
+- 1951年：内务部出台《城市流浪乞讨人员收容遣送办法》
+- 1982年：国务院发布《城市流浪乞讨人员收收容遣送方法》
+- 收容对象：无合法身份、无正当职业、无正当居所人员（即"三无人员"）
+
+## "名声"
+樟木头收容遣送站曾被称为"二里头"——专收"不该出生的人"。2000年前后，多名被收容者在收容遣送站内非正常死亡，其中最著名的是1998年湖南青年刘二涛案。
+
+## 终结
+2003年，大学生孙志刚在广州市收容救治站被殴打致死，引发社会强烈反响。2003年6月20日，温家宝签署国务院令，公布《城市生活无着的流浪乞讨人员救助管理办法》，同年8月1日起正式实施，废止了已实行50余年的收容遣送制度。
+
+## 亲历者回忆
+> "樟木头给我的最深印象不是别的，是那里的厕所。进去之后，必须把身上的钱和物品全部掏出来，放在一个托盘里，由管理人员统一保管。"
+> — — 亲历者口述
+
+---
+*资料来源：根据相关历史文献整理*

package/.agent/memory/reference/mnsll60q-0j911u.md

@@ -0,0 +1,36 @@
+---
+id: "mnsll60q-0j911u"
+name: "Paper.js API: Point 和 Size 参数规范"
+type: "reference"
+project: "foliko-poster-plugin"
+tags: [paper.js, bug-fix, api-usage, poster-plugin]
+created: "2026-04-10"
+---
+**Paper.js 创建图形时 point/size 参数必须使用对象而非数组**
+
+**Why 重要：**
+- Paper.js 中 Path.Rectangle、PointText 等图形构造函数的 `point` 参数需要是 `paper.Point` 对象，不是 `[x, y]` 数组
+- `size` 参数需要是 `paper.Size` 对象，不是 `[width, height]` 数组
+- 错误用法不会报错，但图形不会正确渲染
+
+**How to apply：**
+```javascript
+// ✅ 正确写法
+new paper.Path.Rectangle({
+  point: new paper.Point(x, y),
+  size: new paper.Size(width, height)
+})
+
+new paper.PointText({
+  point: new paper.Point(x, y),
+  content: 'text'
+})
+
+// ❌ 错误写法（不会报错但无效）
+new paper.Path.Rectangle({
+  point: [x, y],
+  size: [width, height]
+})
+```
+
+**涉及文件：** `.agent/plugins/poster-plugin/components/button.js`

package/.agent/memory/reference/mnsmlb5y-nej31u.md

@@ -0,0 +1,16 @@
+---
+id: "mnsmlb5y-nej31u"
+name: "poster 插件参数传递修复"
+type: "reference"
+project: "foliko-poster-plugin"
+tags: [poster, bug-fix, createButton, 参数传递]
+created: "2026-04-10"
+---
+poster 插件组件（如 createButton）调用时注意参数顺序，不要多传内部对象（如 canvas）。
+
+**Why**：在 poster 插件中，add_poster_button 等工具调用 createButton 时，如果多传了 canvas 对象作为第一个参数，会导致参数错位，后续参数的坐标、尺寸等数值被当作 canvas 对象处理，最终生成超大错误尺寸的 SVG。
+
+**How to apply**：
+- 工具入口层（如 index.js）应直接传递 args 给 createButton：`createButton(project, args)`
+- createButton 内部会自己获取 canvas：`const canvas = this._canvasManager.getCanvas()`
+- 不要在工具入口层传递 canvas 对象

package/.agent/memory/reference/mnssle72-yrot96.md

@@ -0,0 +1,9 @@
+---
+id: "mnssle72-yrot96"
+name: "无印风格历史记录书页模板"
+type: "reference"
+project: "海报设计"
+tags: [无印风格, 极简设计, 历史记录, 书页布局]
+created: "2026-04-10"
+---
+无印风格海报设计规范：采用9:16比例，大量留白，浅灰白背景(#F5F5F5)配合纯黑文字(#1A1A1A)，使用微软雅黑字体。布局层次：标题区→副标题→时间线→基本信息网格→亲历者引用块→总结→页底。几何线条分隔，小圆点标记时间节点。

package/.agent/memory/user/mnsfuon6-l416q1.md

@@ -0,0 +1,21 @@
+---
+id: "mnsfuon6-l416q1"
+name: "用户海报风格偏好"
+type: "user"
+project: "null"
+tags: [海报设计, 风格偏好, 樟木头历史]
+created: "2026-04-10"
+---
+## 用户海报设计风格偏好
+
+### Why (为什么重要)
+用户制作了一个关于「樟木头收容遣送制度」的历史话题海报，倾向使用复古杂志风、极简几何风或国潮山水风。需要在后续设计任务中参考这些风格建议。
+
+### How to apply (如何使用)
+当用户再次请求海报设计时：
+1. 先检查记忆中是否有相关偏好
+2. 根据主题选择合适风格：
+   - 严肃历史/新闻纪实 → 复古杂志风（留白+衬线+高级感）
+   - 中国传统文化 → 国潮山水风（水墨+传统纹样）
+   - 简洁有力 → 极简几何风（莫兰迪色系）
+3. 询问用户确认风格后再开始设计

package/.agent/memory/user/mnsg9kut-95m7rf.md

@@ -0,0 +1,20 @@
+---
+id: "mnsg9kut-95m7rf"
+name: "海报设计偏好"
+type: "user"
+project: "null"
+tags: [poster, design, layout, font]
+created: "2026-04-10"
+---
+用户有明确的海报设计偏好：
+
+**Why（为什么重要）：**
+- 用户明确指定了8层布局结构（标题→副标题→时间线→基本信息→亲历者回忆×2→总结→页底），这表明用户习惯于详细规划海报内容层级
+- 用户偏好特定字体：微软雅黑
+- 用户曾设计历史记录类海报（樟木头收容遣送制度），风格偏向严肃、记录性质
+
+**How to apply（如何使用）：**
+- 当用户说「重新设计海报」时，应主动询问或参考此布局结构
+- 字体统一使用「微软雅黑」
+- 历史/纪念类海报可参考深色背景+金色点缀的风格
+- 8层布局结构：标题、副标题、时间线、基本信息、亲历者回忆①、亲历者回忆②、总结、页底

package/.agent/memory/user/mnu2eo1v-yy6fhe.md

@@ -0,0 +1,9 @@
+---
+id: "mnu2eo1v-yy6fhe"
+name: "用户生日及复古设计风格偏好"
+type: "user"
+project: "null"
+tags: [个人信息, 生日, 设计偏好, 复古杂志风]
+created: "2026-04-11"
+---
+用户生日为3月12号。海报设计偏好采用复古杂志风格 - 老报纸/杂志排版风格。在制作相关海报或设计素材时，应使用复古报纸/杂志的排版布局，如使用老式字体、网格布局、文字穿插图片等复古元素。

package/.agent/memory/user/mnu2etuo-8u8jk8.md

@@ -0,0 +1,9 @@
+---
+id: "mnu2etuo-8u8jk8"
+name: "用户生日及设计风格偏好"
+type: "user"
+project: "null"
+tags: [个人信息, 生日, 设计风格, 复古杂志风]
+created: "2026-04-11"
+---
+用户生日是3月12日。设计风格偏好：复古杂志风，参考老报纸/杂志排版风格。在未来设计相关任务中（如海报、邀请函、贺卡等），优先使用复古报纸/杂志排版风格。

package/.agent/plugins/poster-plugin/package.json

@@ -4,17 +4,17 @@
   "description": "海报/Banner 设计插件 - 基于 Paper.js 实现，支持 35 个组件",
   "main": "index.js",
   "dependencies": {
-    "canvas": "^3.2.0",
+    "canvas": "npm:@napi-rs/canvas@latest",
     "fontkit": "^2.0.4",
     "jsdom": "^16.2.2",
     "paper": "^0.12.18",
     "qrcode": "^1.5.4"
   },
   "overrides": {
-    "canvas": "^3.2.0"
+    "canvas": "npm:@napi-rs/canvas@latest"
   },
   "resolutions": {
-    "**/canvas": "^3.2.0"
+    "**/canvas": "npm:@napi-rs/canvas@latest"
   },
   "author": "",
   "license": "MIT",

package/.agent/plugins/poster-plugin/src/canvas.js

@@ -4,6 +4,7 @@
 
 const paper = require('paper')
 const PRESETS = require('./presets')
+const fonts = require('./fonts')
 const fs = require('fs')
 const path = require('path')
 
@@ -49,6 +50,13 @@ class CanvasManager {
     this._width = w
     this._height = h
 
+    // 初始化字体系统
+    if (typeof fonts.init === 'function') {
+      fonts.init()
+    } else if (typeof fonts.initFonts === 'function') {
+      fonts.initFonts()
+    }
+
     // 添加背景
     if (background) {
       if (typeof background === 'string' && path.isAbsolute(background)) {

package/.agent/plugins/poster-plugin/src/components/barcode.js

@@ -4,6 +4,7 @@
 
 const paper = require('paper')
 const { loadImageAsRaster, downloadImage } = require('../utils/imageLoader')
+const { getFontFallbackChain, validateFont } = require('../fonts')
 
 /**
  * 创建条形码
@@ -33,11 +34,12 @@ async function createBarcode(project, args) {
 
     // 文字
     if (showText) {
+      const barcodeFont = getFontFallbackChain('monospace', content).join(', ')
       const textItem = new paper.PointText({
         point: [x + width / 2, y + height + fontSize + 5],
         content: content,
         fontSize,
-        fontFamily: 'monospace',
+        fontFamily: barcodeFont,
         fillColor: new paper.Color(textColor),
         justification: 'center',
       })
@@ -98,11 +100,12 @@ function createSimpleBarcode(project, args) {
 
   // 文字
   if (showText) {
+    const simpleBarcodeFont = getFontFallbackChain('monospace', content).join(', ')
     const textItem = new paper.PointText({
       point: [x + width / 2, y + barHeight + fontSize + 3],
       content: content,
       fontSize,
-      fontFamily: 'monospace',
+      fontFamily: simpleBarcodeFont,
       fillColor: new paper.Color(textColor),
       justification: 'center',
     })

package/.agent/plugins/poster-plugin/src/components/bubble.js

@@ -3,6 +3,7 @@
  */
 
 const paper = require('paper')
+const { getFontFallbackChain, validateFont } = require('../fonts')
 
 /**
  * 创建对话气泡
@@ -115,7 +116,7 @@ function createBubble(project, args) {
     point: [bubbleX + padding, bubbleY + bubbleHeight / 2 + fontSize / 3],
     content: text,
     fontSize,
-    fontFamily: fontFamily || 'sans-serif',
+    fontFamily: getFontFallbackChain(fontFamily, text).join(', '),
     fillColor: new paper.Color(color),
     justification: tailPosition === 'left' ? 'left' : tailPosition === 'right' ? 'right' : 'center',
   })
@@ -130,7 +131,7 @@ function createBubble(project, args) {
     let currentLine = ''
     for (const char of text) {
       currentLine += char
-      const testText = new paper.PointText({ content: currentLine, fontSize, fontFamily: fontFamily || 'sans-serif' })
+      const testText = new paper.PointText({ content: currentLine, fontSize, fontFamily: getFontFallbackChain(fontFamily, currentLine).join(', ') })
       if (testText.bounds.width > maxTextWidth) {
         lines.push(currentLine.slice(0, -1))
         currentLine = char

package/.agent/plugins/poster-plugin/src/components/button.js

@@ -4,6 +4,7 @@
 
 const paper = require('paper')
 const { loadImageAsRaster } = require('../utils/imageLoader')
+const { getFontFallbackChain, validateFont } = require('../fonts')
 
 /**
  * 创建按钮
@@ -12,7 +13,7 @@ async function createButton(project, args) {
   const {
     x = 0,
     y = 0,
-    width = 200,
+    width: customWidth,  // 重命名为 customWidth
     height = 60,
     text = '按钮',
     fontSize = 24,
@@ -27,24 +28,37 @@ async function createButton(project, args) {
     icon,
     iconPosition = 'left',
     opacity = 1,
+    padding = 30,  // 内边距
   } = args
 
+  // 使用字符数估算文本宽度（参考 CTA 组件的方式）
+  const textStr = String(text || '')
+  const chineseChars = (textStr.match(/[\u4e00-\u9fa5]/g) || []).length
+  const otherChars = textStr.length - chineseChars
+  // 中文约1.0倍，英文/数字约0.5倍字体大小
+  const textWidth = chineseChars * fontSize * 1.0 + otherChars * fontSize * 0.5
+
+  // 图标宽度
+  const iconWidth = icon ? Math.min(height * 0.5, fontSize) + 8 : 0
+
+  // 计算最终宽度：如果没有指定宽度，则根据内容计算
+  const finalWidth = customWidth || (textWidth + padding * 2 + iconWidth)
+
   // 创建按钮背景
-  const bgOptions = {
+  const bg = new paper.Path.Rectangle({
     point: [x, y],
-    size: [width, height],
+    size: [finalWidth, height],
     radius: radius,
-  }
+  })
 
+  // 边框
   if (borderColor) {
-    bgOptions.strokeColor = new paper.Color(borderColor)
-    bgOptions.strokeWidth = borderWidth
+    bg.strokeColor = new paper.Color(borderColor)
+    bg.strokeWidth = borderWidth
   }
 
-  const bg = new paper.Path.Rectangle(bgOptions)
-
   // 渐变或纯色填充
-  if (gradient && gradient.colors && gradient.colors.length > 0) {
+  if (gradient && gradient.colors && gradient.colors.length > 1) {
     const colors = gradient.colors.map(c => new paper.Color(c))
     bg.fillColor = new paper.Color({
       gradient: { stops: colors },
@@ -56,68 +70,98 @@ async function createButton(project, args) {
   }
 
   // 阴影
-  if (shadow) {
-    bg.shadowColor = new paper.Color(shadow.color || '#000000')
-    bg.shadowBlur = shadow.blur || 10
-    bg.shadowOffset = new paper.Point(shadow.offsetX || 0, shadow.offsetY || 4)
+  if (shadow && typeof shadow === 'object') {
+    try {
+      if (shadow.color) bg.shadowColor = new paper.Color(shadow.color)
+      bg.shadowBlur = shadow.blur || 10
+      bg.shadowOffset = new paper.Point(shadow.offsetX || 0, shadow.offsetY || 4)
+    } catch (e) {
+      // 忽略阴影错误
+    }
   }
 
   if (opacity !== 1) {
     bg.opacity = opacity
   }
 
-  const items = [bg]
-  let textX = x + width / 2
+  if (project && project.activeLayer) {
+    project.activeLayer.addChild(bg)
+  }
+
+  const elements = [{ type: 'rectangle', id: bg.id }]
+
+  // 文字居中 x 坐标
+  const textX = x + finalWidth / 2
 
   // 添加图标
   if (icon) {
-    const iconSize = Math.min(height * 0.5, 40)
-    const iconX = iconPosition === 'left' ? x + 20 : x + width - 40 - iconSize
+    const iconSize = Math.min(height * 0.5, fontSize)
+    const iconY = y + height / 2 + iconSize / 3
 
     if (icon.startsWith('http') || icon.startsWith('data:')) {
       // URL图片图标
+      const iconX = iconPosition === 'left' 
+        ? x + padding 
+        : x + finalWidth - padding - iconSize
+      
       const { raster } = await loadImageAsRaster(project, icon, {
         x: iconX,
         y: y + (height - iconSize) / 2,
         width: iconSize,
         height: iconSize
       }, opacity)
-      items.push(raster)
+      
+      if (project && project.activeLayer) {
+        project.activeLayer.addChild(raster)
+      }
+      elements.push({ type: 'raster', id: raster.id })
     } else {
       // Emoji 或文本图标
+      const iconX = iconPosition === 'left' 
+        ? x + padding + iconSize / 2 
+        : x + finalWidth - padding - iconSize / 2
+      
       const iconText = new paper.PointText({
-        point: [iconX + iconSize / 2, y + height / 2 + fontSize / 3],
+        point: [iconX, iconY],
         content: icon,
         fontSize: iconSize,
         justification: 'center',
       })
       if (opacity !== 1) iconText.opacity = opacity
-      items.push(iconText)
+      
+      if (project && project.activeLayer) {
+        project.activeLayer.addChild(iconText)
+      }
+      elements.push({ type: 'text', id: iconText.id })
     }
-
-    textX = iconPosition === 'left' ? x + width / 2 + 25 : x + width / 2 - 25
   }
 
   // 添加文字
-  const textItem = new paper.PointText({
-    point: [textX, y + height / 2 + fontSize / 3],
-    content: text,
-    fontSize,
-    fontFamily: fontFamily || 'sans-serif',
+  const textY = y + height / 2 + fontSize / 3
+  const buttonText = new paper.PointText({
+    point: [textX, textY],
+    content: textStr,
+    fontSize: fontSize,
+    fontFamily: getFontFallbackChain(fontFamily, textStr).join(', '),
     fillColor: new paper.Color(color),
     justification: 'center',
   })
 
   if (opacity !== 1) {
-    textItem.opacity = opacity
+    buttonText.opacity = opacity
   }
 
-  items.push(textItem)
+  if (project && project.activeLayer) {
+    project.activeLayer.addChild(buttonText)
+  }
+  elements.push({ type: 'text', id: buttonText.id })
 
   return {
     success: true,
     type: 'button',
-    items: items.map(i => i.id),
+    elements,
+    width: finalWidth,
+    height: height,
   }
 }