技能装完不生效——版本不兼容和权限问题的排查
问题现象
在 Clawhub 技能市场里装了一个技能（比如"淘宝竞品价格抓取"），安装过程显示成功，但实际使用时：
- 在对话框里说"帮我抓取竞品价格"，AionClaw 完全没调用这个技能，还是走通用对话
- 或者调用了但报错："技能执行失败"、"脚本运行错误"
- 或者执行到一半卡住不动
最常见的 3 个原因
原因一：客户端版本不兼容（占 50%）
这是最常见的原因。社区技能是由不同版本的客户端开发的，如果技能基于新版本 API 开发，但你用的是旧版本客户端，装完了也调不起来。
排查方法：
- AionClaw → 设置 → 关于 → 查看当前版本号
- 回到技能详情页 → 看"支持的最低版本"字段
- 如果你的版本号低于要求的最低版本 → 客户端更新一下
解决方法：
- Windows：设置 → 检查更新 → 下载安装最新版本
- macOS：菜单栏 AionClaw → 检查更新 → 或在 App Store 里更新
- 更新完后重启 AionClaw，技能应该就能正常调用了
预防措施：
- 在技能市场里筛选"已审核"版本——官方审核时会验证版本兼容性
- 避开半年以上没更新的旧技能
原因二：技能执行需要额外权限（占 30%）
技能执行过程中可能需要：
- 访问特定目录（比你平时授权的更广）
- 运行脚本（第一次执行时会弹窗）
- 访问外部 API（需要网络权限）
如果这些权限被拒绝或没弹窗（你之前设了"不再提示"），技能就会静默失败。
排查方法：
- 设置 → 安全 → 授权日志 → 看最近有没有和这个技能相关的权限请求被拒绝
- 设置 → 安全 → 敏感操作设置 → 确认"运行脚本"是允许弹窗的
解决方法：
- 手动把技能需要的目录加入授权（设置 → 安全 → 目录授权 → 添加）
- 临时允许脚本执行（设置里关掉"静默执行所有脚本"）
- 如果之前点了"不再提示"，恢复弹窗功能
原因三：技能本身有 bug（占 20%）
社区版技能质量参差不齐。有些可能：
- 用的选择器已经不适用了（比如抓取淘宝价格——淘宝页面改版了，选择器失效）
- 有语法错误（脚本写错了）
- 逻辑不完整（只处理了正常情况，没考虑异常）
排查方法：
- 用对话框说"查看刚才失败的技能执行日志"
- 日志里会显示具体报错信息——看是哪一行出错、什么原因
解决方法：
- 如果是选择器失效：找同一个功能的其他已审核技能替换
- 如果是语法错误：可以给发布者留言反馈，或自己修复（需要一点 Python 基础）
- 如果是逻辑不完整：只能等发布者更新，或换用已审核版本
实战排查流程
装完技能不生效
│
├─ ① 检查客户端版本
│ 技能最低版本 > 你的版本？→ 更新客户端
│
├─ ② 看授权日志
│ 有没有相关权限被拒绝？→ 重新授权
│
├─ ③ 看技能执行日志
│ 什么报错？→ 判断是技能本身问题还是环境问题
│
└─ ④ 换个已审核的同功能技能试试
换一个能跑 → 原技能有 bug，放弃
换一个也跑不了 → 可能是环境问题，检查版本和权限预防措施总结
优先装已审核技能：质量有保证、版本已验证、脚本已扫描。虽然数量比社区版少，但稳定性高很多。
安装前看一眼更新时间：最近 1-2 个月有更新 = 发布者在维护。半年以上没更新的大概率已经失效了。
试用后再长期用：装完先跑 1-2 次不同的输入，确认能正常工作再依赖它。