逐字键盘

「逐字键盘」—— 应用说明（特性与功能） 产品定位 「逐字键盘」是一款 iOS 自定义键盘扩展，配合主 App 内的「设置」，把剪贴板里的一段文字 按可配置的节奏逐字（逐键）模拟输入到当前光标位置，并带有 拟真停顿、随机快慢、可选打错再纠正、中文拼音上屏流程 等行为，让自动化输入更接近真人打字，而不是瞬间整块粘贴。

应用结构 主 App（TypingSimulator）：提供使用教程入口与详细设置；设置通过 App Group 与键盘扩展共享（UserDefaults 写入共享配置）。 键盘扩展（TypingKeyboard）：在任意 App 的输入框中，读取剪贴板与共享配置，驱动 TypingEngine 向 UITextDocumentProxy 异步上屏。 系统要求与权限 需在系统设置里 添加「逐字键盘」，并开启 「允许完全访问」（Full Access）。 完全访问用于：UIPasteboard 读取待输入正文、以及从 App Group 读取你在主 App 里保存的节奏/行为配置；未开启时，逐字粘贴与配置读取通常会失败（代码与教程中均已说明这一点）。 典型使用流程 在别处 复制 要输入的文字。 在目标 App 聚焦输入框，切换到 「逐字键盘」。 点击 「逐字粘贴」：从剪贴板取文，按当前配置模拟输入。 需要中断时点击 「停止」；输入状态会写回共享容器（主 App 可据此观察，属可选能力）。 键盘界面功能 逐字粘贴：读取剪贴板并按配置模拟输入；进行中会显示「输入中…」并暂时不可再次触发。 退格：样式贴近系统键盘的退格键，删除光标前字符；模拟输入进行中会与粘贴一同禁用，避免与引擎冲突。 停止：取消当前任务。 切换键盘：调用系统 advanceToNextInputMode()，在已启用的输入法间切换。 主 App「设置」中可配置的能力（与代码一致） 速度与随机性

速度档位：极慢～极快，对应稳定阶段的目标基础间隔（毫秒量级，如约 18～100ms）。 随机波动强度：在基础间隔上叠加约 ±5% / ±30% / ±60% 的抖动，使节奏不机械。 错误与停顿习惯

错误频率：极少～频繁等预设，映射为打错/再纠正的统计强度。 思考停顿习惯：控制「像在想下一句」的停顿倾向（权重低/中/高）。 行为开关

模拟拼音输入：开启时中文可走「拼音字母 → 空格 → 退格 → 汉字」的拟真流程；关闭时中文按节奏 直接逐字上屏（英文/数字仍为逐键模拟，含可选打错纠正）。 词边界 / 标点 / 换行停顿：在对应位置插入更符合真人的停顿。 疲劳效应：长文本后期整体变慢，模拟越打越累。 高级参数

最低 / 最高间隔（ms）：防止过快丢键或过慢卡顿的硬边界。 开始适应期长度（字符数）：开头若干字更慢、更谨慎，再进入稳定节奏。 设置可 保存；离开界面时也会把当前表单写回共享容器（与 SettingsView 中 onDisappear 行为一致）。每次进入设置会从 App Group 重新加载，避免界面与已存配置不一致。

输入引擎层面的要点（TypingEngine） 整合 节奏控制器、错误生成、拼音模拟；支持 取消 与任务代际防护（新粘贴不会让旧任务的收尾误清状态）。 含 随进度的速度缩放（与疲劳模型配合，模拟「越打越顺 / 偶尔卡住」）。 特殊场景：在 # / 全角 ＃ 之后、遇换行前，会对中文采用 直接上屏，以兼容部分宿主（如话题编辑）对「拼音+退格」不兼容的情况。