启用 NanoMouse 键盘
先让系统识别键盘扩展,再把常用布局排到顺手的位置。
- 添加 NanoMouse 后,打开需要输入文字的 App。
- 长按系统地球键,选择 NanoMouse;若要使用网络 AI、同步文件或字节粘贴等能力,请按功能需要授权“允许完全访问”。
- 回到 NanoMouse 主 App 的“设置 → 键盘布局”,启用中文 26 键、中文九键或自定义方案。


中文 26 键
标准 QWERTY 输入、拼音编码、候选和扩展入口集中在同一块真实键盘中。
熟悉全拼、双拼或需要中英混输的人。候选栏上方会随输入状态在候选、翻译行与工具栏之间切换。
- 点按“中 / EN”切换中文与英文;点按 Emoji 键进入表情分类。
- 长按字母可选变音字符;长按或滑动功能区域可进入临时界面。
- 主 App 的“键盘视觉效果”可以单独保存亮色、暗色及不同布局方案。



中文九键
大键位适合单手与熟悉 T9 的用户,重输、分词、符号和换行都有独立区域。
- ABC 至 WXYZ 九宫格负责拼音输入,右侧“重输”可清空本轮编码重新组词。
- 左侧标点列和底部符号键减少页面切换;键帽尺寸、圆角、颜色和背景可单独保存。
- 简繁 / 语言区域同样支持长按与上下左右滑动;左右滑可切换单手布局。

工具栏:每个工具都是什么
工具栏可横向滚动、隐藏和排序;长按真实工具栏还能直接打开排序窗口。
- 应用图标 / 动态计数固定在左侧,可显示图标或连续输入计数。
- 候选与重置显示编码候选;重置用于结束当前输入状态。
- 光标方向左、上、右方向键帮助精确移动光标。
- AI 翻译读取当前输入框内容,选择语言并原位替换。
- 字节粘贴打开固定格子,取用常用文字、富文本、图片与文件。
- 剪贴板历史查看本机历史、同 Apple ID 同步内容及跨 Apple ID 通道。
- 画布从键盘跳转主 App 手写、绘图,再分享或继续处理。
- Markdown在键盘内选择与预览文档,主 App 负责完整编辑。
- HTML在键盘内查看网页文档,主 App 提供源码与实时预览。
- 加密打开加密 / 破译面板,使用相同算法与口令交换密文。
- AI 润色按篇幅、语气、情绪、Emoji 与结构改写当前文字。
- 动态效果临时开启或切换键盘动态视觉效果。
- 语音从键盘发起语音流程,由主 App 完成录音和识别。
- 收起键盘固定在右侧,用于关闭当前键盘。


候选翻译:翻译就在候选里
轻点候选翻译使用 Apple 系统翻译;长按可进入 AI 候选翻译。
- 开启“候选翻译按钮”;如果使用 Apple 系统翻译,先准备对应语言包。
- 开启“长按 AI 候选翻译”,添加源语言与目标语言配对;国旗会直观显示每一对语言。
- 输入拼音并出现候选后,翻译结果作为独立候选行显示,可直接点选上屏。


候选必须已经产生;Apple 系统翻译需要对应语言资源,AI 候选翻译还需要可用模型、账号或 BYOK 配置。第 4 个及之后的候选可能按设置回退到系统翻译。
AI 翻译与 AI 润色
候选翻译处理“正在输入的词”,AI 翻译与润色处理“输入框里的一段文字”。
| 功能 | 适用内容 | 结果处理 |
|---|---|---|
| AI 翻译 | 句子、段落或完整输入框 | 选择目标语言,预览后原位替换或继续编辑 |
| AI 润色 | 已经写好的文字 | 调整篇幅、专业性、语气、情绪、Emoji 与结构 |


123:点按、上滑、长按是三个入口
同一个 123 键根据手势进入普通符号页、验证码数字栏或计算器数字面板。




删除键:左划重输,上滑清空前文
两种操作删除范围不同,先看清输入状态再滑动。
| 手势 | 删除范围 | 适用场景 |
|---|---|---|
| 向左划删除键 | 重置当前输入引擎,清空尚未上屏的拼音、编码和候选状态 | 拼音打错一整段,想立即重新组词 |
| 向上滑删除键 | 删除宿主 App 允许键盘读取到的全部光标前文本 | 确认要快速清空当前可读输入范围 |


某些 App 只向第三方键盘提供部分上下文,因此“全部”指当前可读范围,不保证等于整篇文档。两种手势可在键盘设置中关闭。
Emoji:人物、符号与国旗都在
点按中文 26 键上的笑脸进入真实 Emoji 键盘,用底部分类栏切换完整类别。
- 最近使用、表情与人物、动物、食物、活动、旅行、物品、符号和国旗分开浏览。
- 底部分类图标切换页面;返回键回到原键盘,地球键继续切换系统输入法。
- 如果模拟器显示问号,通常是测试环境字体或 Emoji 资源问题;真机应使用系统 Emoji 字体显示。



繁简 / 语言区域的四向手势
空格右侧的区域不只是“中 / EN”按钮,也是临时内容与单手键盘入口。
- 长按手动切换简体 / 繁体状态,并在工具栏反馈当前结果。
- 向上滑打开剪贴板或光标前文临时行,可点按上屏或继续翻译。
- 向左滑切为左手单手布局,右侧保留切边与恢复按钮。
- 向右滑切为右手单手布局,左侧保留切边与恢复按钮。




字节粘贴:固定格子与 Mac 同步
把高频内容固定到格子中,在 iOS 主 App 管理,在真实键盘扩展点选,并可与 Mac 端保持一致。
- 格子可保存纯文本、富文本、图片、文件、链接预览等内容,并支持编辑、排序与预览。
- 键盘扩展直接读取格子,不必离开当前聊天、邮件或编辑 App。
- iPhone、iPad 与 Mac 使用同一个 Apple ID 且开启 iCloud 同步时,固定格子通过 CloudKit 数据同步链路合并。
- Mac 端也可编辑与取用格子;含附件的项目会按 CloudKit 文件记录下载本地预览或原文件。



同 Apple ID 的字节粘贴属于私有 CloudKit 数据同步;Mac 与 iOS 看到的是同一组固定格子。页面中的“定时轮询”只控制定时数据同步,关闭后不应被启动预热或订阅健康检查反复触发完整同步。
剪贴板:本机、同 Apple ID、跨 Apple ID
剪贴板历史与固定格子是两个入口;历史内容可以来自本机、自己的 Mac,或已连接的其他 Apple ID。
| 来源 | 用途 | 同步边界 |
|---|---|---|
| 本机历史 | 找回最近复制的文字 | 当前设备缓存与本账号配置 |
| 同 Apple ID | iPhone / iPad / Mac 之间延续剪贴板历史 | 私有 CloudKit 数据同步 |
| 跨 Apple ID 通道 | 与工作账号、家人或协作者共享指定剪贴板 | 需要创建邀请、接受连接,可单独断开 |


- 在剪贴板管理中创建跨 Apple ID 邀请,把邀请链接交给对方。
- 对方接受后,双方会看到独立关系与通道状态;可重命名设备或账号。
- 需要停止共享时,断开对应的发出或接收通道,不影响自己同 Apple ID 的私有同步。
自己的 iPhone 与 Mac 可通过同 Apple ID 的私有 CloudKit 数据同步共享历史;跨 Apple ID 剪贴板则使用受邀请关系控制的共享通道。CloudKit 数据变更订阅负责提示云端记录变化,它不是 APNs 用户通知功能。
画布:手写、绘图与分享
画布使用真实 PencilKit 画布,可从键盘工具栏发起,在主 App 完成绘制和输出。
- 使用笔、马克笔、橡皮、颜色与粗细工具完成手写或草图。
- 画布可继续编辑、导出或通过系统分享回到聊天与文档。
- 键盘扩展受系统沙盒限制,复杂绘制会切到主 App;完成后再回到原输入场景。

Markdown 与 HTML:编辑、预览、键盘取用
主 App 负责完整编辑与渲染,真实键盘扩展负责快速选择、预览和打开文档。
| 工具 | 适合内容 | 主要能力 |
|---|---|---|
| Markdown | 笔记、清单、说明文档 | 纯文本标记、结构化编辑、预览与文件保存 |
| HTML | 网页片段、富内容说明 | 源码编辑、WKWebView 实时渲染和文件预览 |




第三方键盘的高度、内存和文件访问都受 iOS 限制。键盘内优先完成“找到并预览”,需要长文编辑或网页渲染时打开主 App 更稳定。
因果图与思维导图
因果图强调变量之间的方向关系,思维导图强调主题层级与分支整理。
- 因果图用于添加节点、连接因果方向、整理假设与结果。
- 思维导图支持子节点、同级节点、编辑、删除与居中查看。
- 两类图都属于主 App 创作工具,适合从语音或文本整理成可视结构。


iCloud 文件:让创作跨设备
Markdown、HTML 与其他文档可放入 iCloud Drive,在 iPhone、iPad、Mac 与“文件”App 中继续管理。
- 文档浏览器展示真实 iCloud Drive 目录,可新建文件夹、移动、重命名和选择文档。
- Markdown 与 HTML 键盘预览会读取对应文档目录;文件不存在时先回主 App 创建。
- 这类 iCloud Drive 文件同步与字节粘贴的 CloudKit 记录同步不是同一个存储入口。

语音:从键盘发起,在主 App 识别
语音适合长句、灵感记录和边走边写;识别完成后再把文字送回输入场景。
- 首次使用允许麦克风和语音识别权限,并在语音设置中选择语言与识别方式。
- 从键盘点按语音后,系统会打开主 App 完成真实录音;键盘扩展本身不伪装录音界面。
- 确认识别文字,再复制、分享或返回原 App 继续编辑。

电报键盘与加密通信
电报键盘负责摩斯码输入;加密面板负责把普通文本按约定算法与口令转换为密文或还原。
电报键盘
- 短按输入“点”,长按输入“划”,缓冲区显示当前摩斯码并支持翻译。
- 可在输入方案设置中启用电报键盘,并决定是否在此键盘显示密码系统。
- 电报编码不等同于加密;需要保密时还要启用加密算法与口令。
加密 / 破译面板
- 在普通中文、英文或电报键盘中打开面板,切换“加密”或“破译”。
- 通信双方必须选择相同算法、参数与口令;口令不要和密文放在同一条消息里。
- 该功能用于内容变换,不替代端到端加密通信工具或账号安全措施。




键盘美化、动态效果与反馈
美化不是一张背景图:它由背景、按键、文字、玻璃效果、动态效果、声音、触觉和图标共同组成。
- 亮色 / 暗色方案分别保存不同系统外观下的键盘效果。
- 按布局保存中文 26 键、中文九键和自定义键盘可使用独立方案。
- 背景选择颜色、SVG / PNG 背景图,并调整玻璃 Tint 强度。
- 按键与键帽设置填充、边框、圆角、阴影、字体与按下状态。
- 动态效果选择效果家族、具体招式、位置、强度及随机播放方式。
- 声音与触觉按键音、音量、振动和反馈可单独调节。
- 应用图标选择工具栏与主屏幕展示的图标风格。
- 导入 / 导出视觉方案可保存或导出 JSON,便于备份与迁移。





动态效果只在输入事件处理之后异步展示,不应参与按键命中、触摸归属或字符上屏判断。若关闭效果后仍有吞键,应检查触摸事件与键盘布局变化,而不是把原因归到特效开关。
AI 订阅、账号与 BYOK
使用内置账号更省配置;BYOK 适合希望使用自己模型服务密钥的用户。
| 方式 | 特点 | 适合谁 |
|---|---|---|
| AI 订阅 / 账号 | 登录后按套餐使用支持的翻译与润色能力 | 希望开箱即用的用户 |
| BYOK | 自行配置模型服务、密钥与参数,费用和配额由服务商决定 | 有模型账号、需要自主控制的用户 |
| Apple 系统翻译 | 依赖系统语言包,不等同于 AI 订阅 | 常用候选翻译与离线语言场景 |


隐私、权限与同步边界
了解每条数据链路,才能知道某个开关到底影响什么。
- 键盘“完全访问”决定第三方键盘能否使用网络、共享容器及部分扩展能力;不开启时基础输入仍应可用,但相关工具会受限。
- 同 Apple ID 的字节粘贴与剪贴板通过私有 CloudKit 数据同步;跨 Apple ID 剪贴板由邀请关系与共享通道单独管理。
- CloudKit 数据变更订阅用于接收云端记录变化信号,并驱动 change token 下载、合并与 UI 更新。
- APNs 用户通知专指展示给用户的通知内容、权限与投递状态,不应拿来解释格子或剪贴板同步故障。
- iCloud Drive 文档、CloudKit 格子记录、AI 网络请求、麦克风录音是不同的数据通路,应分别检查权限与状态。
先检查 CloudKit container、database、zone、订阅记录、subscription ID、record change、change token、下载合并与 UI 发布链路。只有用户明确询问 APNs 用户通知或已有直接证据时,才检查 APNs 用户通知环境与投递。
常见问题
按症状快速找到最可能的入口。
为什么键盘工具栏看不到某个功能?
进入“设置 → 候选栏设置”,确认工具栏开启、对应按钮没有被隐藏;工具可能在横向滚动区域更右侧,也可长按真实工具栏重新排序。
为什么候选翻译没有国旗或语言方向?
进入第 05 章对应的候选翻译设置页,重新添加语言配对。每一对会同时显示国旗、语言名称和代码方向;若只看到问号,请在真机确认系统 Emoji 字体资源。
左划删除和上滑删除有什么区别?
左划重置尚未上屏的组词编码;上滑删除宿主 App 当前允许键盘读取的光标前文本。后者范围更大,使用前要确认。
字节粘贴和剪贴板有什么区别?
字节粘贴是主动固定、长期整理的格子;剪贴板是最近复制内容的历史。两者都可在 iOS 主 App 和真实键盘扩展使用,也都能与 Mac 配合,但管理入口和数据语义不同。
跨 Apple ID 剪贴板会暴露我的全部格子吗?
不会把同 Apple ID 私有格子自动变成共享内容。跨 Apple ID 使用单独邀请关系和剪贴板通道,可按关系断开。
Markdown、HTML 或 iCloud 文件为什么键盘里打不开?
先在主 App 创建或确认文件位于对应 iCloud 文档目录,再检查 iCloud Drive 可用性。键盘扩展主要负责选择和预览,完整编辑在主 App 完成。
语音为什么会打开主 App?
这是 iOS 第三方键盘的系统能力边界。主 App 承担麦克风权限、录音与识别,完成后再把文字带回输入流程。
如何恢复一套看不清或过于复杂的美化?
进入“键盘视觉效果”,切到对应亮色 / 暗色与键盘布局,使用“恢复默认”;动态效果和按键反馈需要在各自页面单独恢复。