跳转至

Hamster（仓输入法）部署指南

欢迎在 iOS 平台使用万象。Hamster（仓输入法）支持运行 Rime 方案，并提供独立的文件管理、皮肤配置和 iCloud 同步机制。

由于 iOS 采用严格的沙盒机制，仓输入法会区分 键盘文件、应用文件 和 iCloud 文件。部署万象时，需要理解这几类文件之间的关系，尤其是开启 iCloud 同步后的覆盖顺序。

iOS 平台的文件分层机制

仓输入法中的 键盘文件、应用文件 和 iCloud 文件 分别承担不同作用。

这种文件分层属于 iOS 和仓输入法自身的管理机制，与万象方案本身无关。

在下载、切换方案或重新部署前，建议先确认当前是否启用了 iCloud 同步，并按照后文说明完成相应的复制或覆盖操作。

1. 启用键盘与完全访问权限

  1. 安装仓输入法 APP 后，进入 iOS 系统的 设置 → 通用 → 键盘 → 键盘 → 添加新键盘，选择并添加 Hamster。

  2. 点击刚刚添加的 Hamster，并开启 【允许完全访问】。

万象部分功能依赖完整的键盘运行权限。未开启完全访问时，Pro 版的部分双拼切换、Lua 脚本等功能可能无法正常工作。

2. 获取并置入方案文件

万象方案可以通过仓输入法 APP 内直接下载，也可以通过局域网手动导入。

无论采用哪种方式，语法模型 wanxiang-lts-zh-hans.gram 都需要单独确认是否已经放入正确的 Rime 目录。

方案一：APP 内直接下载

  1. 打开仓输入法 APP，进入 【输入方案设置】。

  2. 点击右上角的 +，搜索 “万象”，根据实际需要选择 Base 或 Pro 对应方案。

  3. 单独下载语法模型：

wanxiang-lts-zh-hans.gram

下载完成后，打开 iOS 自带的 文件 App，进入：

我的 iPhone/Hamster/Rime

将 wanxiang-lts-zh-hans.gram 放入该目录。

方案二：局域网 / 手动全量导入

如果需要一次性导入完整方案，可以使用仓输入法提供的 Wi-Fi 上传功能：

  1. 确保手机和电脑连接到同一个局域网。

  2. 在仓输入法 APP 中点击 【Wi-Fi 上传方案】，获取对应的局域网访问地址。

  3. 在电脑浏览器中打开该地址。

  4. 将已经解压好的万象方案文件和文件夹，以及 wanxiang-lts-zh-hans.gram 语法模型一并上传。

注意上传的是方案压缩包内部的内容，不要额外保留最外层压缩包目录。

3. iCloud 同步与部署顺序

在重新部署之前，需要先确认仓输入法是否已经开启 iCloud 同步。

开启与未开启 iCloud 时，文件流转方式不同，处理顺序也不同。

已开启 iCloud 同步时

如果已经开启 iCloud 同步，应先确认当前方案文件已经同步到仓输入法对应的 iCloud 目录，再执行重新部署。

如果方案是通过 APP 内搜索下载 获得的，下载完成后不要立即重新部署。

  1. APP 内下载的方案通常先进入 应用文件。

  2. 打开仓输入法的文件管理功能，将需要使用的方案文件从应用文件复制到 iCloud 对应目录。

  3. 确认 iCloud 中已经保存最新文件后，再执行重新部署。

这样可以避免重新部署或同步过程中，iCloud 中的旧文件重新覆盖刚刚下载到应用文件中的新版本。

未开启 iCloud 同步时

如果没有开启 iCloud 同步，方案文件主要由仓输入法的 应用文件 管理。

无论使用 APP 内下载还是手动导入，只要方案和语法模型已经放入正确位置，即可继续执行下一步重新部署，不需要额外进行 iCloud 文件复制。

4. 执行初次部署

打开仓输入法 APP，在主页中找到 【RIME】，然后点击 【重新部署】。

首次部署可能需要一定时间：Rime 需要编译词库、加载语法模型并初始化 Lua 等相关组件。部署完成后，键盘端有时还需要短暂等待才能正常显示候选。如果刚完成首次部署后暂时没有候选，可以稍后再次唤出键盘确认，不建议连续重复触发重新部署。

5. 皮肤与斜杠按键设置 (processByRIME)

万象的斜杠指令依赖 / 按键能够进入 Rime 编码，而不是直接作为普通字符上屏。

  1. 可以使用 Release 页面中提供的万象相关仓输入法皮肤，并根据皮肤说明进行导入和配置。

  2. 在仓输入法的键盘配置中，斜杠 / 应设置为 交由 Rime 处理 (processByRIME)。

如果 / 被键盘前端直接上屏，Rime 就无法收到完整的斜杠指令，/zrm、/flypy 等命令也无法正常识别。

  1. 如果使用第三方或自行修改的键盘皮肤，需要在仓输入法的皮肤编辑界面中确认 / 按键配置，并将其行为设置为由 Rime 处理。

6. 输入类型切换与反向同步

万象默认使用以下输入方式：

  • Base 标准版：默认开启 全拼。
  • Pro 增强版：默认开启 自然码双拼。

即使当前默认输入方式已经符合使用习惯，也建议主动执行一次对应的斜杠指令，使相关方案配置统一切换到当前需要的输入类型。

第一步：在键盘中执行切换指令

唤出仓输入法键盘，在中文输入状态下输入对应的斜杠指令：

需要注意一些手机前端涉及到皮肤的自定义，需保证斜杠是rime处理的而不是直接上屏的，用什么软件就去哪里学习 

/flypy    → 小鹤双拼
/mspy     → 微软双拼
/zrm      → 自然码
/sogou    → 搜狗双拼
/znabc    → 智能ABC
/ziguang  → 紫光双拼
/pyjj     → 拼音加加
/gbpy     → 国标双拼
/lxsq     → 乱序17
/ltsp     → 蓝天双拼
/sdpy     → 首道双拼
/pinyin   → 全拼
/zrlong   → 自然龙(反查是全拼)
/hxlong   → 汉心龙(反查是全拼)
/jjf      → 间接辅助
/zjf      → 直接辅助

第二步：将键盘端配置同步回应用文件

通过键盘输入 /zrm、/flypy 等指令后，相关修改首先发生在 键盘文件 中。

如果希望后续重新部署时继续保留这次切换结果，需要将键盘文件同步回应用文件。

  1. 打开 仓输入法 APP → 文件管理 → 通用。

  2. 点击 【使用键盘文件覆盖应用文件】。

  3. 如果开启了 iCloud 同步，再进入 仓输入法 APP → iCloud 同步，执行 【拷贝应用文件至 iCloud】。

  4. 完成文件同步后，返回 APP 首页，再执行一次 【重新部署】。

这样可以让键盘端产生的配置修改重新写回应用文件，并在启用 iCloud 时继续同步到 iCloud 文件，避免后续部署时恢复到旧配置。

在仓输入法中部署万象时，重点确认文件所在层级、iCloud 同步方向以及键盘端配置是否已经回写。