fix(debug): inject evdev keycodes from a fixed key table - #1595

1. Look the key name up first and only then fall back to a numeric evdev
   keycode, so a single digit resolves as a Qt::Key name: `event key 5`
   injects KEY_5(6) instead of evdev 5 (KEY_4), and `event key 1` no
   longer injects Escape. Only multi-digit numbers are raw evdev codes
   (`057` = 57).
2. State the exact semantics in the docs: the injected code is a
   physical key position on the US reference layout, and the character
   it produces depends on the active layout (on a German layout
   `event key Z` types `y`); `Enter` is the keypad Enter.
3. Replace the dead `esc`/`del` names in the root READMEs with the Qt
   key names that actually resolve, using the same wording as the tools
   README.
4. Switch the `event key enter tap` examples to `Return tap`.
5. Assert the digit cases in the tests and fix the include order that
   clang-format expects.

Log: `event key 5` (and any single digit) presses the digit key now
instead of the evdev code of that number, which could be Escape or
another character. The root READMEs, the tools README, --help and the
treeland-debug skill describe one and the same key semantics.

Influence:
1. `event key 1`..`event key 9` press 1..9, and `event key 0` presses 0.
2. Raw codes 1-9 need a leading zero (`057` for space); multi-digit
   codes such as `30` and `57` are unchanged.
3. `event key Z` on a German layout types `y` (physical key position).
4. `esc` / `del` still report "unknown key"; the docs say `Escape` /
   `Delete` now.

fix(debug): 名字优先于数字解析

1. 先查键名，未命中才退化为数字 evdev 码，于是单个数字按 Qt::Key
   名字解释：`event key 5` 注入 KEY_5(6)，不再是 evdev 5（KEY_4），
   `event key 1` 也不再注入 Escape。只有多位数字才是原始 evdev 码
   （`057` = 57）。
2. 文档写明准确语义：注入的是 US 参考布局上的物理键位，最终产出
   什么字符取决于当前布局（德语布局下 `event key Z` 打出 `y`）；
   `Enter` 是小键盘回车。
3. 根目录两个 README 删掉 Qt 从不认的 `esc`/`del`，换成真正能解析
   的 Qt 键名，并与 tools README 用同一套说法。
4. 示例 `event key enter tap` 统一改成 `Return tap`。
5. 测试补上数字用例的断言，并按 clang-format 期望调整 include 顺序。

Log: `event key 5` 及任何单个数字现在按下对应数字键，不再按该数字的
evdev 码（可能是 Escape 或别的字符）。根目录两个 README、tools
README、--help 与 treeland-debug skill 的键参数口径一致。

Influence:
1. `event key 1`..`event key 9` 分别按下 1..9，`event key 0` 按下 0。
2. 要传 1-9 的原始码需加前导零（`057` = 空格）；`30`、`57` 这类
   多位数字不变。
3. 德语布局下 `event key Z` 打出 `y`（物理键位语义）。
4. `esc`/`del` 仍报 "unknown key"，文档已改为 `Escape`/`Delete`。

Multica Issue: WM-953

1. Trim the key name once at entry: `" 5"` missed the Qt::Key lookup
   and fell through to the numeric branch, injecting evdev 5 (KEY_4)
   while still reporting ok. `" 5 "`, `"\t5\n"` and `" 057 "` now
   resolve like their trimmed forms, and `" "` is rejected.
2. Spell out in the MCP tool schema that Qt key names win over numbers
   and only multi-digit numbers are raw evdev codes, matching the
   READMEs; that schema is what an automated caller (an LLM in
   particular) reads.
3. Assert the whitespace-padded digit case in the tests and reflow the
   touched README paragraph.

Log: A key name with surrounding whitespace -- a stray space in a shell
argument or in a JSON payload -- injected a different key and reported
ok; it now resolves to the named key. The MCP tool description states
the same name-over-number rule as the docs.

Influence:
1. `event key " 5"` presses the 5 key (KEY_5), not KEY_4.
2. `event key " "` reports "unknown key" instead of a silent success.
3. `event key " 057 "` still injects evdev 57.
4. An MCP or LLM caller reading the tool schema sees that names win and
   only multi-digit numbers are evdev codes.

fix(debug): 键名先去空白并写明数字回退规则

1. 进函数先对键名做 trimmed：`" 5"` 之前查不到 Qt::Key 名字会落到
   数字分支，注入 evdev 5（KEY_4）却仍返回 ok。现在 `" 5 "`、
   `"\t5\n"`、`" 057 "` 与去掉空白后一致，`" "` 被拒绝。
2. MCP 工具描述写明名字优先于数字、只有多位数字才是原始 evdev 码，
   与各 README 口径一致；自动化调用方（尤其是 LLM）读到的就是这份
   schema。
3. 测试补上带空白数字的断言，并重新折行改动过的 README 段落。

Log: 键名前后带空白时（shell 参数里多一个空格，或 JSON 拼装出的
`" 5"`）之前会注入别的键还返回 ok，现在按名字正确解析；MCP 工具
描述与文档采用同一条"名字优先于数字"的规则。

Influence:
1. `event key " 5"` 按下 5 键（KEY_5），不再是 KEY_4。
2. `event key " "` 报 "unknown key"，不再静默成功。
3. `event key " 057 "` 仍注入 evdev 57。
4. 读工具描述的 MCP/LLM 调用方能看到名字优先、只有多位数字才是
   evdev 码。

Multica Issue: WM-953