开日志与报 bug——给开发者一份能定位问题的反馈

前几页解决不了的疑难，最后一步是反馈给开发者。Key Mapper 内置了一套完整的日志与报告流程——用对它，你的问题才有可能被修。

第一步：开「额外日志」

1. 主页三条杠菜单 → 设置
2. 拉到设置最底部，找到 Logging 区块

1. 打开「额外日志」（extra logging）

注意官方提醒：额外日志会多占存储、可能增加按键延迟——只在排查问题时开，收集完信息立刻关掉。

第二步：复现问题

日志只记录开启之后的事，所以：

1. 开日志
2. 稳定地复现一次问题——必须能重现，开发者才能验证修没修好（官方原话：不能复现的 bug 没法修）
3. 记下复现时间和操作步骤

第三步：用「报告问题」按钮

主页菜单里有专门的报告 bug 按钮，它会自动打包日志并引导发送——不要自己截图日志了事，用这个按钮：

• 应用崩溃类问题例外：崩溃记录无论如何都会存进日志，直接用报告按钮即可

反馈要带什么

• 机型 + 系统版本（厂商差异是按键类问题最大的变量）
• 稳定的复现步骤
• 期望行为 vs 实际行为
• 日志包（报告按钮自动附带）

官方有一条硬规矩：不填模板的反馈会被忽略——按钮引导的模板逐项填完再发。

社区求助

官方的支援主阵地是 Discord 社区（入口在官网页脚）。求助前先做两件事：

• 把本站疑难排查四页过一遍——电池优化、免打扰、键盘、边界问题占了求助量的大头
• 描述问题时报「机型 + 系统版本 + Key Mapper 版本 + 复现步骤」，一句「不好使」没人能接

报告之外的自我修复

• 崩溃/失灵先试重启设备（随机失灵第二刀）
• 疑似配置损坏：导出备份 → 清数据 → 恢复备份（备份与分组管理）
• 版本行为变化：先看更新日志确认不是设计变更（版本特性）

排查链到此完整。最后一组是日常速查参考：设置逐项速查。