# 蟹蟹输入 · RTOS / Android 手表适配改版

为小屏手表准备的离线输入组件：大按键、浅色界面、完整候选、圆屏安全布局。基于 [CrabKeyboard / 蟹蟹输入](https://github.com/crabPangXie/crabKeyboard) 的词库，由 herry 重写 Glyphix RTOS 与原生 Android 适配；本项目为独立改版，保留原作者及第三方署名。

**MIT 开源，允许商用、修改、再分发和闭源集成。** 使用时请保留 [LICENSE](LICENSE) 和 [第三方许可](NOTICE.md)。厂商 SDK、运行时与设备固件不包含在本项目授权中。

![历史界面，版本标记见截图说明](docs/UI_PREVIEW.png)

## 1.2.3 联想与稳定刷新

- 全拼、九宫、14键支持未完成拼音补全，按完整匹配、补全、较短前缀分层，结合词频及当前上下文排序；原始候选完整保留。
- 输入词语后提供离线续写，例如“你好→世界”；使用光标前最多4个连续汉字，最多8个联想，不保存上下文，密码不参与。
- Android复用文字与按键控件并合并同帧刷新；RTOS查询期间保留候选，旧候选在新结果到达前不能提交。

RTOS 53项引擎、42项UX及四配置构建通过。Android 7项Java测试及OWW261后台原生组件3项通过，包括24帧非空绘制、控件复用、补全/续写和密码隔离。本版未重跑前台交互；RTOS原生Inspector被其他任务占用，未接管。截图为明确标记的历史1.2.2界面，不冒充本版视觉验收。

[本版RTOS验收](com.sydxky.rtos.inputmethod/VALIDATION_1.2.3.md) · [本版Android验收](android/VALIDATION_1.2.3.md)

## 1.2.0 已有功能

- 完整候选采用 **4×4 网格，单字 16 项一页**；词组占用更多列，长词增加行高，显示完整文字；展开页不显示拼音。
- 标准 **QWERTY 26 键**，排列为 `qwertyuiop / asdfghjkl / zxcvbnm`；同时提供九宫和 14 键双字母模式。
- 14 键为 `QW ER TY UI OP / AS DF GH JK L / ZX CV BN M`，参考公开布局，自行实现离线消歧和连续输入；[算法说明](com.sydxky.rtos.inputmethod/KEYBOARD_14.md)。
- 保留全部 **104,837 组拼音/缩写索引、163,238 个候选项**。按页浏览全部结果，支持分段选词及剩余编码继续输入。
- 英文、数字、符号、光标移动及 Unicode 删除。圆屏每行按安全宽度排布，避免四角按钮被裁切。
- 新增 **Android 应用内键盘 AAR**、演示 APK、独立宿主示例。接入后点击输入框自动弹出，由组件直接回填宿主输入框。

## 选择适合的平台

| 平台 | 接入与产物 | 已完成的验证 |
| --- | --- | --- |
| Glyphix RTOS | 原生 `.ux` 页面；圆屏 466×466、方屏 390×450 两屏 QuickApp 完整 ZIP | 普通/QuickApp四配置构建；53项引擎和42项UX脚本断言；原生视觉未重跑 |
| Android 8.1 / API 27+ | 原生 AAR；演示 APK；独立 `host/` 示例 | OWW261后台原生组件3项通过；24帧非空绘制及控件复用；前台交互未重跑 |

Android 版本作为**应用内公开组件**，由每个应用自行接入；组件不注册系统输入法。RTOS 页面也需宿主接入，系统级注册依赖厂商支持。

完全离线，输入功能无需账号。Android 组件不申请网络/外部存储/悬浮窗权限，不保存输入内容；RTOS 端的可选本地学习、私密模式及草稿说明见 [隐私说明](com.sydxky.rtos.inputmethod/PRIVACY.md)。

## 下载、源码与反馈

- [v1.2.3 发行包与更新说明](https://git2.sydxky.cn/sydxky/crab-input-rtos/releases/tag/v1.2.3)：AAR、演示 APK、两屏 RTOS QuickApp、验收截图及 SHA-256。
- [Android 接入文档](android/README.md) · [RTOS 接入文档](com.sydxky.rtos.inputmethod/README.md)
- [实际界面截图](docs/SCREENSHOTS.md) · [RTOS 验收](com.sydxky.rtos.inputmethod/VALIDATION_1.2.0.md) · [Android 真机验收](android/VALIDATION_1.2.0.md)
- [已有问题](https://git2.sydxky.cn/sydxky/crab-input-rtos/issues) · [免注册提交问题与建议](https://git2.sydxky.cn/feedback/sydxky/crab-input-rtos)

Git2 免登录浏览、克隆和下载；当前关闭注册，代码和版本由所有者维护。

```sh
git clone https://git2.sydxky.cn/sydxky/crab-input-rtos.git
```

## Android 开发

准备 JDK 17、Android SDK compile 37、Python 3；SDK 与签名私钥不随源码分发。

```powershell
cd android
python scripts/build-dictionary.py
.\gradlew.bat :keyboard:testDebugUnitTest :keyboard:lintRelease :keyboard:assembleRelease :app:assembleDebug :host:assembleDebug
```

生成的 `keyboard/build/outputs/aar/keyboard-release.aar` 可直接放入宿主 `app/libs/`。在 Activity 的 UI 线程使用：

```java
import com.sydxky.crabinput.CrabKeyboard;

CrabKeyboard.Binding keyboard = CrabKeyboard.attach(this, editText);
// 有自己的监听器时，在相应事件中调用 keyboard.show()。
// 绑定自动跟随 Activity 生命周期，也可显式 keyboard.close()。
```

源码不包含生成的 SQLite，构建脚本从本仓库 RTOS 原始词库无损生成。正式演示 APK 签名由开发者自己的受保护配置提供；AAR 无需应用签名。

## RTOS 开发

准备 Windows PowerShell 7、Node.js、Python 3，以及合法取得的 Glyphix SDK。验证版本为 `gx v0.10.1 / 3ed38835`。将包含 `bin/gx.exe` 和 `share/` 的完整 SDK 放在 `temp/glyphix-v0.7.2-windows-x64/`：

```powershell
& .\com.sydxky.rtos.inputmethod\build.ps1
```

脚本生成词库分片，执行 53 项引擎、42 项 UX 断言，并构建普通/QuickApp 四配置。每屏 QuickApp 都须保留 `bundle.pkg`、`icon.png`、`manifest.json` 三个文件。

复现原生验收时先构建最小参考页并启动一次圆屏模拟器，获得厂商 launcher/global 资源后退出；不要同时占用 Inspector 14201：

```powershell
& .\com.sydxky.rtos.imefixture\build.ps1
Push-Location .\com.sydxky.rtos.imefixture
& ..\temp\glyphix-v0.7.2-windows-x64\bin\gx.exe emulate -d generic-watch-466x466
Pop-Location
python .\com.sydxky.rtos.inputmethod\tests\native.py --work work/native --output work/evidence
python .\com.sydxky.rtos.inputmethod\tests\visual.py --work work/visual --output work/evidence/visual
```

视觉脚本依赖 Pillow。RTOS 运行时内存配置保持 8192 KiB。本版本已完成上述算法、组件回归与构建检查；未完成的交互、QuickApp原生视觉、RTOS真机、长期性能/续航和商店审核范围见本版验收记录。