小米笔记本 “小爱同学” 与 物理 F9 按键 Linux 系统映射技术纪实

2026年6月3日 · 1683 字 · 4 分钟

文档目的：详细记录小米笔记本（以 RedmiBook Pro 15S 笔记本为例）在 Linux (Ubuntu/Debian) 系统下，针对物理“小爱同学”按键的底层映射，以及物理 F9 触摸板开关键的底层诊断结论。以便在系统升级、重装或配置自定义 AI 助手快捷键时快速复现。

🔍 一、 “小爱同学” 物理按键的映射问题

1. 硬件默认状态

小米笔记本键盘右上角配备了一颗物理**“小爱同学”专属按键**。在 Linux 系统中，按下此按键默认没有任何响应，网页、X11/Wayland 桌面环境或普通应用均无法捕获该键盘事件。

2. 捕获底层硬件扫描码（Scancode）

在终端中按下该按键时，使用 sudo dmesg -w 观察内核日志，系统会抛出以下警告，提示底层硬件已产生中断，但内核不知道将其解释为什么键码：

ban-mi kernel: atkbd serio0: Unknown key released (translated set 2, code 0x72 on isa0060/serio0).
ban-mi kernel: atkbd serio0: Use 'setkeycodes 72 <keycode>' to make it known.
  • 诊断结果：物理按键对应的硬件扫描码 (Scancode) 是 72 (十六进制 0x72)。

⚠️ 二、 尝试过程与发生的冲突 (触摸板意外禁用)

1. 首次尝试映射为 F23 (内核键码 193)

根据内核的提示，尝试将该按键映射到内核键码 193（系统映射中的 KEY_F23）：

sudo setkeycodes 72 193

2. 产生的冲突现象

运行此命令后，在网页的按键检测器上依然无法捕获事件。相反，每按一次该按键，系统桌面都会弹出一个 “触摸板已被禁用” 的物理提示图标，但实际上触摸板功能依然完全正常，可以随意移动。

3. 冲突成因深度分析 (X11 偏移量 +8 陷阱)

在 Linux 系统中，内核键码 (Kernel Keycode) 和 X11 / 桌面视窗键码 (X11 Keycode) 之间存在一个固定的偏移量规则： $$\text{X11 Keycode} = \text{Kernel Keycode} + 8$$

  • 我们把扫描码 72 映射为了内核键码 193。
  • 传递给 X11 视窗服务器时，其对应的 X11 键码变成了 $193 + 8 = \mathbf{201}$。
  • 而根据 X11 键盘默认映射表（运行 xmodmap -pke）： 
    keycode 201 = XF86TouchpadOff NoSymbol XF86TouchpadOff
    keycode 201 刚好被硬编码为了全局“禁用触摸板”功能。 因此，每次按下小爱按键，系统都会误判定为用户按下了“关闭触摸板”的快捷键。

🔍 三、 关于原装物理 F9 键的底层诊断结论

现象：

原装物理 F9 键（带触摸板禁用标识）按下时能真实切断触摸板（触摸板无法移动），但系统不显示任何 OSD 图标，且在系统中完全无法捕获事件。

检测与过程：

  1. 输入事件检测 (xev)：按下 F9 时，XServer 完全捕获不到任何 KeyPress/KeyRelease 键盘事件。
  2. 硬件变动监听 (udevadm monitor)：按下 F9 时，系统没有检测到任何硬件级别的设备插拔或属性改变。
  3. 内核环日志监控 (dmesg -w)：按下 F9 时，内核环形缓冲区中没有输出任何 ACPI 或 WMI 未识别按键日志。
  4. 属性状态轮询：在 F9 按下前后，触摸板的 xinput 属性 Device Enabled 与 sysfs 节点的 runtime_status 始终未变。

结论：

物理 F9 按键是由笔记本主板上的 EC (Embedded Controller，嵌入式控制器) 芯片在底层完全处理的。它在按下时，在固件/硬件级别直接把信号拦截并断开了触摸板的硬件级电源/信号通道。 由于该按键事件完全被硬件拦截，没有传递给 Linux 内核，因此操作系统无法监听到此事件，无法触发并绘制 GNOME 桌面环境的 OSD 提示图标。

🛠️ 四、 “小爱按键” 终极重映射方案 (映射为通用键 F24)

为了解决冲突并成功将该按键赋予正常的功能键属性，我们需要选择一个空闲且无默认系统绑定的安全键码。我们将目光投向了内核键码 194（即 KEY_F24）：

  • X11 键码：$194 + 8 = \mathbf{202}$
  • 在 xmodmap -pke 中，keycode 202 没有被绑定任何默认的系统动作，是一个完全干净的“空白占位符”。

运行以下命令进行重映射（临时生效）：

sudo setkeycodes 72 194

验证测试

重新刷新网页按键检测器，再次按下物理“小爱同学”按键，网页完美亮起！识别出对应的标准输入事件：

  • event.key: "F24"
  • event.keyCode: 202
  • event.code: "F24"

现在，你可以将这个物理按键作为一个独立的 F24 功能键使用，并在系统设置中自由绑定任何自定义的脚本（如一键启动 AI 语音录音、调用大模型等）。

💾 五、 持久化自救方案 (避免重启后失效)

⚠️ 注意：以下配置方案当前暂未实施。因为目前对于该按键映射后具体要用来触发什么 AI 功能或脚本，尚未最终决定。此方案仅作为技术储备记录在此，后续决定用途后再进行部署。

由于 setkeycodes 属于系统级临时配置，电脑重启后会重置。为了使其每次开机自动生效，可以通过以下 systemd 服务实现开机自启：

  1. 新建 systemd 映射服务文件： 在系统 /etc/systemd/system/ 下创建 xiaomi-keymap.service 文件：

    [Unit]
Description=Map Xiaomi XiaoAi Key to F24
After=multi-user.target

[Service]
Type=oneshot
ExecStart=/usr/bin/setkeycodes 72 194
RemainAfterExit=yes

[Install]
WantedBy=multi-user.target

  2. 启用并运行该服务：

    sudo systemctl daemon-reload
sudo systemctl enable xiaomi-keymap.service
sudo systemctl start xiaomi-keymap.service

自此，每次开机后，“小爱同学”物理按键都将自动在系统底层映射为标准的 F24 键，随时等待你的 AI 助手脚本调用！