常见问题
安装问题
Q: 安装后看不到 Kkbar 面板
解决方法：
- 确认已用 ZXP Installer 正确安装
.zxp文件 - 重启 AE，在菜单栏 窗口 → 扩展 查看是否有 Kkbar
- 如果仍然看不到，请开启 调试模式 排查
Q: 面板显示空白或加载失败
解决方法：
- 关闭面板，重新打开
- 确认 AE 版本为 2020 或以上
- 开启调试模式，查看控制台是否有报错
- 如果仍有问题，尝试卸载后重新安装
Q: macOS 提示"无法验证开发者"
解决方法：
- 打开 系统设置 → 隐私与安全性
- 找到被阻止的应用，点击 仍要打开
- 或终端执行：bash
sudo xattr -r -d com.apple.quarantine /Library/Application\ Support/Adobe/CEP/extensions/com.kkbar.cep
使用问题
Q: 如何创建第一个按钮？
解决方法：
- 点击右上角 设置（齿轮图标）
- 点击 新增分类，输入分类名称
- 在分类下点击 + 添加按钮
- 设置按钮名称、图标和动作类型
- 回到主页，点击按钮即可执行
详细教程请参考 快速上手
Q: 如何为一个按钮设置多个动作？
解决方法：
- 长按空格进入编辑模式
- 右键点击按钮，打开动作设置面板
- 为不同快捷键组合设置不同动作：
- 单击：基础动作
- Ctrl + 点击：备用动作
- Alt + 点击：第三种动作
- 按下对应快捷键时，按钮图标会自动切换
详细教程请参考 动作设置
Q: 动作执行失败怎么办？
解决方法：
- 查看 Kkbar 日志面板中的错误信息
- 检查脚本文件路径是否正确
- 确认 AE 中是否有选中图层（部分动作需要）
- 查阅 错误代码文档
Q: 如何快速测试一段脚本？
解决方法：
- 创建新按钮，动作类型选择 Scriptlet
- 在代码输入框中输入脚本代码
- 点击按钮即可立即执行
- 无需创建 .jsx 文件，适合快速测试
Q: 按钮太多不好找怎么办？
解决方法：
- 使用分类功能，按用途分组管理
- 为常用按钮设置快捷键，一键触发
- 拖拽调整按钮大小和位置，突出重点
- 使用收藏功能，快速访问高频按钮
数据问题
Q: 如何导出/导入配置？
导出：
- 打开设置面板，点击 导出配置
- 选择导出类型（分类 / UI设置 / 完整数据库）
- 选择保存位置
导入：
- 打开设置面板，点击 导入配置
- 选择
.json或.kbar文件
详细教程请参考 数据备份
Q: 如何云同步配置？
解决方法（付费版功能）：
- 打开设置面板，找到 云备份
- 登录 GitHub 账号
- 点击 备份到 Gist 上传配置
- 其他电脑点击 从 Gist 恢复 即可同步
详细教程请参考 云备份
Q: 数据库可以放在其他位置吗？
解决方法：
- 打开设置面板，找到 数据库路径
- 点击 设置 选择新目录
- 可选择创建新数据库或复制现有数据
适合多设备用户将数据库放在同步盘中。
其他问题
Q: 免费版和付费版有什么区别？
| 功能 | 免费版 | 付费版 |
|---|---|---|
| 9种动作类型 | ✓ | ✓ |
| 自定义工具栏 | ✓ | ✓ |
| 导入/导出配置 | ✓ | ✓ |
| 弹窗广告 | 有 | 无 |
| 云端同步 | ✗ | ✓ |
| 技术支持 | ✗ | ✓ |
付费版仅需 ¥8.8，终身使用。详情参考 免费版与付费版
Q: 如何反馈问题或建议？
- 在面板中点击 关于 → 反馈问题
- 或发送邮件至项目邮箱
- 加入用户群获取实时帮助