字段映射错误源于Mapping配置与InputSchema不一致，需四步修复：一、核对字段名大小写及下划线一致性；二、用点号路径处理嵌套对象与数组索引；三、重置并基于真实样例重推导映射及类型；四、启用调试模式确认原始输入完整性。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在WorkBuddy中导入技能后发现字段映射错误，例如输入参数未正确绑定到后端函数变量、值被丢弃或错位填充，则极可能源于Mapping配置与实际数据结构不一致。以下是重新配置Mapping关系的操作步骤：
一、核对InputSchema与Mapping字段名一致性
该方法用于排除因字段命名偏差导致的映射断裂——Mapping配置中引用的字段名必须与InputSchema中properties下定义的键名完全一致（包括大小写与下划线），任何拼写差异都会使映射失效。
1、进入WorkBuddy技能管理页，点击目标技能右侧【编辑】按钮，切换至「字段映射」标签页。
2、在左侧InputSchema预览区域，展开"properties"对象，逐条记录各字段名称（如"user_id"、"order_date"）。
3、在右侧Mapping配置表格中，检查每一行“源字段”列是否严格匹配上述名称，禁止使用驼峰式（如userId）、空格或中文作为源字段名。
4、若存在不一致项，手动修改为Schema中声明的原始字段名，并点击【保存映射】。
二、验证嵌套对象与数组路径表达式有效性
该方法用于解决深层结构映射失败问题——当InputSchema中字段为嵌套对象或数组时，Mapping需使用点号（.）分隔的路径语法（如"profile.address.city"），而非仅填写顶层键名。
1、在InputSchema中定位类型为"object"或"array"的字段，确认其内部结构层级（例如：{"profile": {"address": {"city": "string"}}}）。
2、在Mapping配置中，找到对应字段的“源字段”单元格，将原填入的"profile"改为"profile.address.city"。
3、对于数组类型字段，路径末尾需附加索引占位符，例如"data.items[0].name"表示取第一个元素的name属性。
4、保存后触发一次测试调用，在日志中确认该路径是否成功提取出预期值。
WorkBuddy 桌宠工厂 —— 给一张角色图、一个 codex.pet 链接、一条 codex-pets.net 下载 URL、或一份现成的精灵表，就能自动创建一只可联动 WorkBuddy 状态的桌面宠物。当用户说"创建桌宠"、"做一只桌宠"、"用这张图做桌宠"、"从 codex.pet 安装桌宠"、"导入 codex 桌宠 XX"、"装一下 codex-pets.net 上的 XX&quo
三、重置自动推导映射并手动校准类型转换
该方法用于修正由自动推导引发的类型误判——WorkBuddy在初次导入时会基于示例数据猜测字段类型与映射路径，但若示例缺乏代表性（如数值字段传入空字符串），则推导结果不可靠。
1、在「字段映射」标签页右上角，点击【重置为默认映射】按钮，清除所有自动生成配置。
2、点击【重新推导映射】，此时系统将弹出对话框，要求上传一个合规的JSON格式测试输入样例。
3、准备一个包含全部必需字段且值类型真实的样例（如"user_id": 12345, "is_active": true, "tags": ["vip", "trial"]），粘贴至文本框并提交。
4、推导完成后，逐行检查每项“目标类型”是否准确（如number→integer、boolean→boolean、array→list），对类型错误项手动点击下拉菜单更正。
四、启用字段映射调试模式并捕获原始输入流
该方法用于定位映射执行前的数据状态——通过开启调试可查看技能接收到的原始请求体，确认字段是否已在传输链路前端丢失或变形，从而判断问题是否出在映射环节本身。
1、返回WorkBuddy主界面，点击右上角头像 → 【设置】→ 【开发者选项】→ 开启“显示网络请求详情”与“启用字段映射追踪”。
2、重新触发技能调用，等待响应结束后，在控制台日志中查找标记为[MAPPING_INPUT]的日志块。
3、展开该日志，复制其中的JSON内容，粘贴至文本编辑器，确认所有预期字段均存在且非空。
4、若发现某字段在[MAPPING_INPUT]中已缺失，则问题不在Mapping配置，而应检查上游InputSchema校验或调用方传参逻辑；若字段存在但未出现在后续[MAPPING_OUTPUT]中，则说明对应Mapping规则未生效。
