workbuddy调用技能返回空值，主因是后端响应不符合openclaw协议：需严格满足json结构（含status、data、message三字段）、data不可为null或字符串化、content-type须为application/json；并排除空数据及unicode控制字符干扰。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在WorkBuddy中成功导入技能，但在调用时返回空值，则可能是由于后端服务响应的数据格式不符合OpenClaw协议规范。OpenClaw要求技能执行结果必须以标准JSON结构返回，且顶层必须包含status、data和message三个字段；若缺失任一字段、字段类型错误或嵌套过深，WorkBuddy将无法解析而静默丢弃响应内容。
一、验证后端响应是否符合MCP v2.3协议结构
该方法用于确认技能后端输出是否满足OpenClaw运行时强制校验的最小JSON契约，避免因字段缺失或命名偏差导致解析失败。
1、在WorkBuddy中启用调试模式：点击右上角头像 → 【设置】→ 【开发者选项】→ 开启“显示网络请求详情”。
2、重新触发该技能调用，等待响应后，在控制台日志中定位到对应HTTP响应体（通常为POST /claw/invoke）。
3、复制原始响应内容，粘贴至JSON校验工具（如jsonlint.com），检查是否为合法JSON。
4、确认响应中存在且仅存在以下三个顶层键：status（字符串，值为"success"或"error"）、data（任意类型，但不可为null）、message（字符串，不可为空或缺失）。
二、检查data字段是否被意外序列化为字符串而非对象
该方法用于排除常见编码错误：后端开发者误将完整JSON对象二次JSON.stringify()，导致data字段实际值为字符串类型，而非预期的Object或Array，致使WorkBuddy解析器跳过内容提取。
1、在上一步获取的原始响应中，定位"data": "..."部分。
2、观察其引号内是否呈现完整JSON结构（如"{"result": "ok"}"），而非原始对象（如{"result": "ok"}）。
3、若引号内含转义双引号（"）或连续嵌套引号，则说明data已被序列化两次。
4、修正方式：后端代码中确保仅对整个响应体做一次JSON序列化，禁止对data子字段单独调用JSON.stringify()。
三、确认HTTP响应头Content-Type是否为application/json
该方法用于排除因MIME类型声明错误引发的解析路径跳过——当响应头未明确声明为JSON时，WorkBuddy会将响应体按纯文本处理，不触发JSON解析流程，最终返回空值。
1、在WorkBuddy开发者选项开启状态下，复现调用并查看网络请求详情。
2、展开对应请求的【Response Headers】区域。
3、查找Content-Type字段，确认其值严格等于application/json; charset=utf-8（分号及charset部分不可省略）。
4、若值为text/plain、application/octet-stream或缺失该头，则需在后端HTTP框架中显式设置响应头。
四、排查data字段是否为空对象、空数组或null值
该方法用于识别语义性空响应：即使JSON结构合规，若data字段本身为{}、[]或null，WorkBuddy默认将其视为空结果，不渲染任何内容，也不报错。
1、在已确认结构合法的响应体中，单独提取data字段值。
2、使用JavaScript控制台执行JSON.parse(响应体).data，观察返回值。
3、若返回null，或typeof结果为"object"但Object.keys(...).length === 0，则属于空数据。
4、修复原则：data字段必须携带至少一个有效业务字段，禁止返回裸空结构；例如应返回{"result": "no_data"}而非{}。
五、检测响应体是否含不可见Unicode控制字符
该方法用于发现隐藏格式污染：后端日志注入、模板引擎残留或数据库字段截断可能引入U+200B（零宽空格）、U+FEFF（BOM）等不可见字符，导致JSON解析器提前终止，WorkBuddy捕获到解析异常后静默返回空值。
1、将原始响应体复制到支持十六进制视图的编辑器（如VS Code安装Hex Editor插件）。
2、搜索十六进制序列EF BB BF（UTF-8 BOM）或E2 80 8B（U+200B）。
3、若存在，定位其在JSON中的位置（通常位于开头或字段值内部）。
4、修正方式：后端在序列化前对所有字符串字段执行.replace(/[\u200B-\u200D\uFEFF]/g, '')清洗，并在响应生成链路最末端进行全响应体BOM剥离。
