IngameIME 0.1.9 -> 1.0.0 更新说明

总览

1.0.0 是一次大版本更新，核心变化是输入法后端、文本框兼容、候选框渲染和主题系统的整体升级。

• 输入法后端迁移到 Rust Core，并通过 JNI 与 Minecraft 侧通信。
• 新增 Windows TSF（TextServiceFramework）输入支持。
• 重做候选框、预编辑文本和输入模式提示的渲染与跟随逻辑。
• 新增完整主题系统、主题编辑器、颜色选择器和资源包主题支持。
• 扩展多个 Mod 文本框兼容，包括 FTB、Better Questing、BiblioCraft、Notes 等。
• 修复多个候选词、光标、文本框跟随和配置保存问题。

新增功能

Rust Core 后端

• 将旧的 Java JNI 输入法绑定迁移到新的 ingameime_core Rust 后端。
• 新增 Rust JNI 绑定类加载逻辑，加载 native core 前会先设置绑定类。
• 启动输入上下文时会打印 Rust Core 版本，方便排查 native 库是否匹配。
• 新增 Rust 日志桥接，Rust 侧日志可以进入 Minecraft 日志。

Windows TSF 支持

• 新增 TextServiceFramework 输入法 API 支持。
• 支持按配置选择 Windows 输入 API。
• 全屏场景下继续支持无候选窗口模式。
• 增加输入模式回调，输入状态切换可以同步到游戏内 UI。

聊天命令输入体验

• 增加通用 forceAlphaMode / forceNativeMode 能力。
• 在聊天框输入 / 命令时自动切换到英文模式。
• 离开命令前缀后自动恢复原输入模式。
• 关闭类似告示牌输入界面时会强制恢复英文模式，减少残留中文输入状态。

文本框兼容性

新增或改善以下文本框兼容：

• FTB Lib 文本框。
• Better Questing 文本框。
• BiblioCraft Clipboard 文本框。
• Notes Mod 文本框和标题输入框。
• JourneyMap 全屏搜索框。
• 需要直接写入的特殊文本框。

同时修复：

• Cleanroom 较旧版本中 LWJGL3 窗口句柄检测失败的问题。
• Notes Mod 文本框无法激活输入法的问题。
• JourneyMap 全屏界面中非搜索框错误触发输入法的问题。

候选框与输入显示

• 优化候选框、预编辑文本、输入模式提示的绘制结构。
• 修复候选框不能正确跟随文本框的问题。
• 修复主题系统导致候选词框错位的问题。
• 修复最后一个候选词显示异常的问题。
• 修复输入部分字符后，剩余未输入字符的候选框消失的问题。
• 优化候选列表调试日志，减少无意义刷屏。
• 同步候选列表日志前缀，方便阅读和排错。

主题系统

1.0.0 引入新的主题系统，支持更完整的候选框外观自定义。

新增：

• 默认主题配置。
• 主题选择 GUI。
• 主题编辑器 GUI。
• 主题命名输入界面。
• 颜色选择器。
• 主题滚动区域。
• 候选框外部装饰渲染。
• 第三方资源包主题支持。
• 自动检测导入的主题资源包。
• 中英文主题系统文档。

改进与修复：

• 修改后的主题参数可以正常保存。
• 主题颜色以十六进制形式存储到 JSON。
• 删除当前主题后会自动回退到默认主题。
• 只有点击应用后才会应用主题修改。
• 修复颜色预览全黑问题。
• 修复进入编辑器后显示的配置不是当前正在使用配置的问题。
• 修复修改默认主题后重启无法加载的问题。
• 修复 CurrentTheme 区域被遮挡的问题。

配置与资源

• 新增英文和简体中文语言文件。
• 更新 Gradle 配置与依赖脚本。
• 调整配置类包路径。
• 移除旧 Java JNI native 库资源。
• 新增 Windows Rust Core native 库资源。

已知限制

• 1.0.0 的正式发布目标仍以 Windows 为主。
• Linux native 库相关资源和部分代码曾接入，但最终在 1.0.0 中暂时禁用了 Linux 输入上下文创建逻辑。
• MacOS 仍未支持。

升级建议

• 如果从 0.1.9 直接升级，建议重新检查输入法 API 配置。
• 如果使用自定义候选框外观，建议迁移到新的主题系统。
• 如果遇到文本框无法激活输入法，优先检查是否为本次新增兼容之外的特殊 Mod 文本框。
• 如果遇到候选框位置异常，建议开启 DebugLog 并附带 latest.log 排查。