扣子工作流调试需聚焦四类实操错位：①导出权限仅限个人进阶版及以上，入口在资源库工作流右侧“⋯”菜单；②大模型输出恒为字符串，须用代码节点清洗后JSON.parse或直接接“JSON解析”节点；③微信小程序域名须带https://且单独备案，子域名不可合并；④调试时须设置资源点消耗上限防超额，导入ZIP必须根目录直含workflow.json。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
扣子开发者在搭建工作流、调试智能体、集成第三方服务或发布到微信生态时，常因权限误判、变量类型混淆、插件计费失控、域名配置遗漏或压缩包格式错误导致流程中断——这些不是功能缺陷，而是平台设计逻辑与实操习惯之间的错位。
确认导出权限前先查清订阅版本
登录扣子平台后，点击右上角头像→进入「订阅管理」→查看当前套餐名称和功能列表。
个人免费版用户无法导出工作流，该功能仅对【个人进阶版及以上订阅】开放；若你刚升级却仍看不到导出按钮，请刷新页面并切换至正确工作空间后再试。
导出入口不在顶部菜单栏，而在资源库中每个工作流右侧的“⋯”操作菜单里——没看到说明权限未生效，不要反复点击空白区域。
大模型输出永远是字符串，必须手动解析
方法一：用代码节点做清洗+解析
在代码节点中接收 llm_output 后，第一行必须执行清理操作：llm_output.replace(/```json\s*/gi, '').replace(/```\s*/g, '').trim()，再调用 JSON.parse()。不这样做，data[0] 取到的是 "{" 而非对象首项。
方法二：改用「JSON 解析」专用节点（推荐新手）
直接拖入「JSON 解析」节点，将大模型节点输出连接至其输入端口，无需写任何代码；该节点会自动识别并转换合法 JSON 字符串为对象结构，失败时返回空对象且不报错，适合快速验证结构是否合规。
微信小程序集成时，域名必须带协议且单独备案
第一步：登录微信公众平台→「开发管理」→「服务器域名」→在 request 合法域名中添加你的扣子 API 地址。
第二步：确保填写的是完整 HTTPS 地址，例如 https://api.kouzi.ai，不能只填 api.kouzi.ai 或漏掉 https://。
第三步：子域名需单独添加，https://a.api.kouzi.ai 和 https://b.api.kouzi.ai 视为两个不同域名，缺一不可；测试阶段可在开发者工具中勾选「不校验合法域名」临时绕过，但上线前必须补全。
【微信强制要求所有请求走 HTTPS，且域名需完成 ICP 备案】，否则真机调试必然失败，模拟器无法暴露此问题。
调试阶段务必设置资源点消耗上限
进入「账户设置」→「API 与资源管理」→开启「调试模式配额限制」→设定单日最大资源点消耗值（建议初设为 5000）。
这一步能防止你在修复一个参数 bug 时反复触发 images_generate 或 get_access_token 插件，导致资源点瞬间清零；一旦达到阈值，所有 API 调用将被静默拦截，不会产生账单。
关闭调试模式配额限制的操作路径藏得较深：需先进入「高级设置」折叠区，再点击「解除调试保护」开关——别在「常规设置」里找。
导入压缩包失败？先检查 ZIP 结构是否合规
扣子只接受根目录下直接包含 workflow.json 的 ZIP 包，不支持嵌套文件夹，也不接受 RAR、7Z 或含 macOS 隐藏文件（如 __MACOSX/）的压缩包。
正确打包方式：把 workflow.json 文件单独放在桌面 → 全选它 → 右键「压缩为 ZIP 文件」→ 得到的 Archive.zip 即可导入。
如果压缩包是从他人分享链接下载的，下载后请勿双击解压再重打包——浏览器可能已自动解压并重建文件结构，应直接使用原始下载文件。
