AionClaw前端打包后技能调用失败的主因是构建工具篡改请求头、混淆字段名及环境变量注入失效；需强制锁定Content-Type、禁用Terser字段混淆、确保VITE_前缀环境变量正确注入，并验证文件读取路径与进程上下文。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
前端打包后 AionClaw 智能体无法正常调用技能、发飞书消息失败、读取本地 Excel 报错，不是代码写错了，而是打包过程悄悄改了请求头、混淆了字段名、或把环境变量塞进了错误位置——这些变化在开发时完全不暴露，一上线就集体爆发。
确认打包后请求参数是否被篡改
打开 Chrome DevTools → Network 标签页 → 触发一次智能体执行动作（例如点击“发送飞书消息”按钮），找到对应请求 → 点击查看 Headers 和 Payload。
对比开发环境与打包后环境的 Content-Type：如果开发时是 application/json;charset=utf-8，而打包后变成 application/x-www-form-urlencoded，说明 axios 或 uni.request 的 headers 配置被构建工具覆盖了，必须强制锁定。
检查请求体结构：开发时是 {"to":"xxx","msg":"hello"}，打包后变成 to=xxx&msg=hello，这就是表单格式，后端收不到 JSON 字段，直接跳过鉴权逻辑。
立即学习“前端免费学习笔记（深入）”；
重点看字段名是否被压缩：比如原始字段是 sendToFeishu，打包后变成 a、b、c 这类单字母别名，这是 Terser 默认开启的 mangling 导致的，AionClaw 的技能接口校验严格，字段名不匹配会直接返回 400 错误。
验证环境变量是否注入失败
方法一：在 main.ts 或入口文件中加一行 console.log(import.meta.env)，打包后打开控制台，看输出是否为空对象或只有 VITE_DEV_TOOLS=true 这类默认值。
方法二：在 AionClaw 的技能配置里写死一个测试 URL，比如 https://api.example.com/test?env=${import.meta.env.VITE_API_ENV}，然后抓包看实际发出的请求地址里有没有拼上 prod 或 staging —— 没拼上就是 .env.production 文件没被识别，或者 VITE_ 前缀漏写了。
【VITE_ 是硬性前缀，缺一个下划线都不生效】。Vue/Vite 生态只注入以 VITE_ 开头的变量，像 API_BASE_URL 这种不会进打包产物，必须改成 VITE_API_BASE_URL。
排查本地文件读取路径异常
第一步：在技能代码中插入 fs.existsSync('/Users/xxx/report.xlsx') → 打包后运行，返回 false 就说明 Node.js 层路径失效。
第二步：检查 AionClaw 启动时是否启用 --allow-file-access-from-files 参数。没有这个参数，Electron 渲染进程默认禁止读取本地绝对路径，所有 fs.readFile('/xxx') 调用都会被拦截并静默失败。
第三步：确认技能执行上下文是否在主进程。前端打包后的 JS 运行在渲染进程，但读 Excel 必须走主进程的 fs 模块，若没通过 ipcRenderer → ipcMain 中转，就会报错“fs is not defined”或“Permission denied”。
快速复现并隔离问题
① 新建最简技能：只做一件事——读取同目录下的 config.json 并 console.log；
② 关闭所有插件、移除 node_modules、用 pnpm clean && pnpm build 重新打包；
③ 启动 AionClaw 时加 --debug 参数，观察控制台第一行是否输出 “Gateway ready on http://127.0.0.1:3000”；
④ 在飞书中发送指令触发该技能，看日志里有没有 “Failed to load config.json” 或 “ENOENT” 错误；
⑤ 如果这一步通了，说明基础链路没问题，问题出在原技能的某段逻辑里；如果这一步就失败，说明打包或启动环境存在根本性阻断。
