仍未解决
保留日志和复现步骤后，通过购买凭证中的支持渠道联系我们。
查看购买信息接入与支持
故障排查
先根据症状定位到系统权限、设备输入、软件配置或颜色 bridge。
适用于当前版本
手柄有连接，但操作没有生效
- 1
查看 Home 状态
确认手柄已识别、当前软件正确、当前层符合预期。
- 2
查看 HUD
HUD 有操作记录表示Specki已收到按键；没有记录时检查设备和映射。
- 3
检查系统权限
macOS 在“隐私与安全性 → 辅助功能”中启用Specki，然后重启应用。
- 4
核对快捷键
目标软件若修改过快捷键，请在 Mappings 中同步修改或恢复软件默认快捷键。
显示了错误的软件或配置
- 让目标创作软件的画布窗口处于前台，再查看 Home 中的当前软件。
- 未识别的软件不会切换到空白配置，而是继续使用上一个已识别软件；这是预期行为。
- 确认打开的是受支持的正式软件进程，而非启动器、插件管理器或文件对话框。
- 仍然异常时，打开 Logs 页记录软件进程信息和问题发生时间。
调色板可见，但颜色没有发送
| 软件 | 优先检查 |
|---|---|
| Photoshop | UXP bridge 是否安装且在线；重启 Photoshop 后刷新状态。 |
| CSP / 优动漫 | Companion 是否在线；回退流程所需的屏幕录制权限与取色快捷键是否可用。 |
| SAI2 | 设置颜色快捷键是否正确，目标窗口是否处于前台。 |
| Krita | PyKrita bridge 是否安装、启用并在线。 |
配置损坏或界面异常
- 先完全退出Specki再重新打开，避免只关闭设置窗口。
- 在 HUD Editor 中使用重试；只有布局确实不可恢复时再恢复默认布局。
- 配置校验会清理不兼容内容；检测到损坏时会在用户数据目录保留 app-settings.json.bak。
- 联系支持前，请在 Logs 页找到问题时段，并记录系统、软件版本、手柄型号和复现步骤。