Magikeyboard 找不到或打不开数据库 - 完整排查清单

症状分类

键盘根本不存在于列表

检查 KeePassDX 设置

KeePassDX 设置 → 表单填充 → 设备键盘设置，确认 Magikeyboard 已开启。如果这里都没开，系统虚拟键盘列表里不会出现。

检查系统虚拟键盘

手动路径（不同 ROM 略有差异）：

• 设置 → 系统 → 语言和输入 → 虚拟键盘 / 当前键盘 → 管理键盘
• 在列表里找到 "KeePassDX Magikeyboard"，手动勾选启用

MIUI / ColorOS 特殊路径

• 设置 → 更多设置 → 语言与输入法 → 当前输入法 → 管理键盘
• 某些版本把"管理键盘"藏在高级设置里

键盘已启用但崩溃/空白

KeePassDX 数据库未解锁

Magikeyboard 需要读取 KeePassDX 主进程里已解锁的数据库。如果：

• KeePassDX 应用完全关闭了（最近任务里划掉了）
• 数据库还没打开

那么 Magikeyboard 会弹提示让你先开 KeePassDX。

正确操作：

1. 先打开 KeePassDX → 解锁数据库
2. 返回目标应用
3. 切换到 Magikeyboard
4. 现在能看到条目列表了

后台进程被杀

某些 ROM 的激进省电策略会把 KeePassDX 后台进程杀掉。症状：

• KeePassDX 在最近任务里还在，但切 Magikeyboard 时连接失败
• 日志里出现 "background process killed" 或 "connection lost"

解决办法：

1. 设置 → 应用管理 → KeePassDX → 省电策略 → 无限制
2. 最近任务界面 → 把 KeePassDX 下拉锁定（别被一键清理杀掉）
3. 电池优化 → 把 KeePassDX 加到白名单

查看日志

KeePassDX 设置 → 日志 → 找 Magikeyboard 相关的 Error 记录，常见：

• KeyBoardService not connected → 后台进程被杀
• Database not available → 数据库未解锁
• Permission denied → 缺少权限

切换到 Magikeyboard 的快捷方法

不要每次都去系统设置里切键盘：

• 长按输入框 → 输入法 → KeePassDX Magikeyboard
• 导航栏长按 → 长按底部导航栏的输入法/键盘按钮
• 通知栏 → 某些 ROM 有输入法切换快捷按钮

Magikeyboard 填充后目标应用没接收

Magikeyboard 是逐字符输入，理论上任何能接收键盘输入的应用都能用。如果填完没反应：

• 确认输入框焦点还在（某些应用在键盘弹起时偷走焦点）
• 某些游戏 App 的输入控件不接受系统键盘输入（罕见，但确实存在）
• 尝试关闭 Magikeyboard 的动画效果（设置里）