fix(maafw): 雷电上的文本输入改走 ldconsole，修复中文打不进去

[qiyinxi]

问题

M9A 的中文兑换码在雷电上永远打不进输入框：MaaFW 的 Maatouch t 命令和 input text 都只认 ASCII，redeem_codeInputCompleted 的 OCR 一直为空，节点循环重打（生产 2026-09-12 实录 265 次）直到运行超时。

修法（仅雷电）

• ADB controller config 加 command.InputText → ldconsole action --index <原生索引> --key call.input --value {TEXT}
• 输入候选集合改成 MinitouchAndAdbKey|AdbShell，故意不带 Maatouch（否则 MaaFW 永远优先选它，InputText 命令轮不到）
• 没有截图增强时也进这条路；找不到 ldconsole.exe 就维持原样。MuMu 走 nemu_input_text，不受影响

代价：雷电上 MFW 项目的触控从 maatouch 换成 minitouch（同协议，雷电 adbd 是 root）；key_down/key_up 在这条路上不支持，click_key 仍可用。

本地验证

• 真机（LDPlayer 14 / Android 14）：用 maa binding 起 AdbController(input_methods=3, config=上述命令)，minitouch init 508 ms 成功，post_input_text("魔精小A邀泥收看1999泡面番") 39 ms 返回 True，uiautomator 读回输入框正是这串中文
• 本地边界测试 4 条 + tests/task 相邻 3 条通过；ruff check / ruff format --check 通过；pytest tests --collect-only -q 994 条正常
• 未验证：游戏内 Unity 输入框（等生产跑一次 M9A）

🤖 Generated with Claude Code

Summary by Sourcery

修复雷电模拟器上的中文文本输入，使兑换码等非 ASCII 内容能够正常提交。

Bug Fixes:

• 修复雷电模拟器上中文文本无法输入导致任务反复重试并超时的问题。

Enhancements:

• 将雷电模拟器的文本输入切换为原生控制台命令，同时保留在找不到对应工具时的原有输入路径，并在无截图增强配置时继续支持该输入方案。

Original summary in English

Summary by Sourcery

修复雷电模拟器上的中文文本输入，使兑换码等非 ASCII 内容能够正常提交。

Bug Fixes:

• 修复雷电模拟器上中文文本无法输入导致任务反复重试并超时的问题。

Enhancements:

• 将雷电模拟器的文本输入切换为原生控制台命令，同时保留在找不到对应工具时的原有输入路径，并在无截图增强配置时继续支持该输入方案。

Original summary in English

[sourcery-ai]

审查者指南

针对雷电模拟器中文输入失败问题，MaaFW 现在在检测到 ldconsole.exe 时通过原生实例索引调用 ldconsole 注入文本，并选择不含 Maatouch 的 minitouch/AdbShell 输入组合；无 ldconsole、MuMu 及其他设备继续沿用原有行为，同时保留截图增强配置的独立性。

雷电模拟器中文文本注入时序图

sequenceDiagram
    participant MaaFW
    participant AdbController
    participant ldconsole
    participant InputField
    MaaFW->>AdbController: post_input_text(text)
    AdbController->>ldconsole: action --index nativeIndex --key call.input --value text
    ldconsole->>InputField: Inject text into focused field
    InputField-->>ldconsole: Input accepted
    ldconsole-->>AdbController: Exit 0 with no output
    AdbController-->>MaaFW: InputText succeeds

Loading

雷电模拟器文本输入选择流程图

flowchart TD
    A[Build LDPlayer ADB profile] --> B{ldconsole.exe exists?}
    B -->|Yes| C[Set command.InputText]
    B -->|No| D[Keep original configuration]
    C --> E{InputText command configured?}
    E -->|Yes| F[Select MinitouchAndAdbKey plus AdbShell]
    E -->|No| D
    F --> G[Inject text with ldconsole action]
    D --> H[Use existing input methods]

Loading

文件级变更

变更	详情	文件
为雷电模拟器配置基于 ldconsole 的 Unicode 文本输入，并在可用时切换到 minitouch + AdbShell 输入路径。	新增 ldconsole action --index <原生索引> --key call.input --value {TEXT} 配置，自动检测 ldconsole.exe，缺失时保留原路径。 雷电即使没有截图增强也构建输入配置；截图 extras 与文本输入配置解耦。 检测到文本命令后选择 `MinitouchAndAdbKey	AdbShell`，排除 Maatouch，避免 ASCII-only 文本注入被优先使用。 保留 MuMu 及非雷电设备的既有输入逻辑，并使用原生实例索引匹配雷电命令与 extras。
记录雷电中文文本输入修复及触控路径变化。	在变更日志中说明中文输入改走 ldconsole、触控改用 minitouch。	CHANGELOG.md
更新应用版本资源以包含本次修复版本变更。	调整版本 JSON 内容。	res/version.json

---

提示和命令

与 Sourcery 交互

• 触发新的审查： 在拉取请求中评论 @sourcery-ai review。
• 继续讨论： 直接回复 Sourcery 的审查评论。
• 从审查评论生成 GitHub issue： 回复审查评论，请 Sourcery 根据该评论创建 issue。你也可以回复审查评论并使用 @sourcery-ai issue，从该评论创建 issue。
• 生成拉取请求标题： 在拉取请求标题中的任意位置写入 @sourcery-ai，即可随时生成标题。你也可以在拉取请求中评论 @sourcery-ai title，随时重新生成标题。
• 生成拉取请求摘要： 在拉取请求正文中的任意位置写入 @sourcery-ai summary，即可在指定位置随时生成 PR 摘要。你也可以在拉取请求中评论 @sourcery-ai summary，随时重新生成摘要。
• 生成审查者指南： 在拉取请求中评论 @sourcery-ai guide，即可随时重新生成审查者指南。
• 解决所有 Sourcery 评论： 在拉取请求中评论 @sourcery-ai resolve，即可解决所有 Sourcery 评论。如果你已经处理完所有评论并且不想再看到它们，这一功能会很有用。
• 忽略所有 Sourcery 审查： 在拉取请求中评论 @sourcery-ai dismiss，即可忽略所有现有的 Sourcery 审查。如果你想从新的审查开始，这一功能尤其有用——别忘了评论 @sourcery-ai review 以触发新的审查！

自定义使用体验

访问你的控制面板以：

• 启用或禁用审查功能，例如 Sourcery 生成的拉取请求摘要、审查者指南等。
• 更改审查语言。
• 添加、删除或编辑自定义审查说明。
• 调整其他审查设置。

获取帮助

• 如有问题或反馈，请联系我们的支持团队。
• 访问我们的文档以获取详细指南和信息。
• 通过在 X/Twitter、LinkedIn 或 GitHub 上关注我们，与 Sourcery 团队保持联系。

Original review guide in English

Reviewer's Guide

针对雷电模拟器中文输入失败问题，MaaFW 现在在检测到 ldconsole.exe 时通过原生实例索引调用 ldconsole 注入文本，并选择不含 Maatouch 的 minitouch/AdbShell 输入组合；无 ldconsole、MuMu 及其他设备继续沿用原有行为，同时保留截图增强配置的独立性。

Sequence diagram for LDPlayer Chinese text injection

sequenceDiagram
    participant MaaFW
    participant AdbController
    participant ldconsole
    participant InputField
    MaaFW->>AdbController: post_input_text(text)
    AdbController->>ldconsole: action --index nativeIndex --key call.input --value text
    ldconsole->>InputField: Inject text into focused field
    InputField-->>ldconsole: Input accepted
    ldconsole-->>AdbController: Exit 0 with no output
    AdbController-->>MaaFW: InputText succeeds

Loading

Flow diagram for LDPlayer text input selection

flowchart TD
    A[Build LDPlayer ADB profile] --> B{ldconsole.exe exists?}
    B -->|Yes| C[Set command.InputText]
    B -->|No| D[Keep original configuration]
    C --> E{InputText command configured?}
    E -->|Yes| F[Select MinitouchAndAdbKey plus AdbShell]
    E -->|No| D
    F --> G[Inject text with ldconsole action]
    D --> H[Use existing input methods]

Loading

File-Level Changes

Change	Details	Files
为雷电模拟器配置基于 ldconsole 的 Unicode 文本输入，并在可用时切换到 minitouch + AdbShell 输入路径。	新增 ldconsole action --index <原生索引> --key call.input --value {TEXT} 配置，自动检测 ldconsole.exe，缺失时保留原路径。 雷电即使没有截图增强也构建输入配置；截图 extras 与文本输入配置解耦。 检测到文本命令后选择 `MinitouchAndAdbKey	AdbShell`，排除 Maatouch，避免 ASCII-only 文本注入被优先使用。 保留 MuMu 及非雷电设备的既有输入逻辑，并使用原生实例索引匹配雷电命令与 extras。
记录雷电中文文本输入修复及触控路径变化。	在变更日志中说明中文输入改走 ldconsole、触控改用 minitouch。	CHANGELOG.md
更新应用版本资源以包含本次修复版本变更。	调整版本 JSON 内容。	res/version.json

---

Tips and commands

Interacting with Sourcery

• Trigger a new review: Comment @sourcery-ai review on the pull request.
• Continue discussions: Reply directly to Sourcery's review comments.
• Generate a GitHub issue from a review comment: Ask Sourcery to create an
  issue from a review comment by replying to it. You can also reply to a
  review comment with @sourcery-ai issue to create an issue from it.
• Generate a pull request title: Write @sourcery-ai anywhere in the pull
  request title to generate a title at any time. You can also comment
  @sourcery-ai title on the pull request to (re-)generate the title at any time.
• Generate a pull request summary: Write @sourcery-ai summary anywhere in
  the pull request body to generate a PR summary at any time exactly where you
  want it. You can also comment @sourcery-ai summary on the pull request to
  (re-)generate the summary at any time.
• Generate reviewer's guide: Comment @sourcery-ai guide on the pull
  request to (re-)generate the reviewer's guide at any time.
• Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
  pull request to resolve all Sourcery comments. Useful if you've already
  addressed all the comments and don't want to see them anymore.
• Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
  request to dismiss all existing Sourcery reviews. Especially useful if you
  want to start fresh with a new review - don't forget to comment
  @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

• Enable or disable review features such as the Sourcery-generated pull request
  summary, the reviewer's guide, and others.
• Change the review language.
• Add, remove or edit custom review instructions.
• Adjust other review settings.

Getting Help

• Contact our support team for questions or feedback.
• Visit our documentation for detailed guides and information.
• Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.

[sourcery-ai]

你好——我已经审阅了你的更改，看起来很棒！

Sourcery 评估

已批准。

---

Sourcery 对开源项目免费——如果你喜欢我们的审查结果，请考虑分享它们 ✨

• X
• Mastodon
• LinkedIn
• Facebook

Original comment in English

Hey - I've reviewed your changes and they look great!

Sourcery assessment

Approved.

---

Sourcery is free for open source - if you like our reviews please consider sharing them ✨

• X
• Mastodon
• LinkedIn
• Facebook