x1pinyin 拼音输入法 — 安装说明

感谢安装 x1pinyin！这是一款简洁高效的 macOS 拼音输入法。

系统要求

• macOS 12 Monterey 及以上版本
• 同时支持 Apple Silicon（M 系列） 和 Intel 芯片

macOS 14+ 推荐：可使用全部功能（含神经重排上下文关联）。 macOS 12-13：核心输入功能完整可用，神经重排功能视系统是否预装中文语义模型自动启用（缺失时自动降级为纯词频+搭配排序，不影响正常输入）。 如遇到问题，请把 ~/Library/Application Support/x1pinyin/debug.log 反馈给开发者。

安装步骤

1. 完成安装向导：点击"安装"，等待进度条走完。
2. 添加输入法：打开 系统设置 → 键盘 → 文本输入 → 输入法 → 编辑，点 + 号，搜索 "x1拼音" 或 "x1pinyin"，添加。
3. 切换使用：通过菜单栏输入法图标，或按 Control + 空格（或 Caps Lock）切换到 x1拼音。

首次安装后如果切换不到，按一下输入法切换快捷键，或切换到其他输入法再切回来即可。

你的数据存在哪

x1pinyin 会在使用中学习你的输入习惯（常用词、词频、自造词）。这些数据全部存在你的 Mac 本地，不上传任何服务器。

数据文件位置：

~/Library/Application Support/x1pinyin/x1pinyin.db

如何备份词库

把这个文件复制到安全位置即可：

1. 打开 访达，按 Command + Shift + G
2. 粘贴上面的路径（~/Library/Application Support/x1pinyin）
3. 把 x1pinyin.db 复制到你的备份位置（如 U 盘、云盘）

如何迁移到新 Mac

1. 在新 Mac 上先安装并启动一次 x1pinyin（会自动创建空的 db 文件）
2. 用上面的方法定位到新 Mac 的 db 文件位置
3. 用备份的 x1pinyin.db 覆盖过去
4. 切换到其他输入法再切回来，习惯数据即生效

卸载

从输入法菜单卸载（推荐）

1. 点击菜单栏的输入法图标，切换到 x1拼音
2. 再次点击输入法图标，在下拉菜单底部点 "卸载 x1pinyin…"
3. 对话框有三个选项：

• 卸载（保留词库） — 移除输入法，保留你的个人词库数据（重装时可复用）
• 卸载（删除全部） — 移除输入法 + 彻底删除个人词库数据
• 取消

1. 选择后自动执行卸载，完成后会弹出系统通知

卸载做了什么

• 停止运行中的 x1pinyin 进程
• 删除 ~/Library/Input Methods/x1pinyin.app
• 清理 LaunchServices 注册
• 根据你的选择，保留或删除个人词库数据 + 偏好设置

卸载完成后建议重启 Mac——macOS 的 BTM（后台任务管理）数据库需要重启才会重建， 否则系统设置「登录项与扩展 → 后台活动」可能短期还显示 x1pinyin 条目。

彻底卸载（重装前清干净）

如果重装后发现不弹授权对话框或后台活动还有 x1pinyin 条目，说明上次卸载有残留 （TCC 授权记录 / BTM 数据库缓存）。从 GitHub 下载 scripts/uninstall.sh 后执行：

sudo ./scripts/uninstall.sh                    # 保留用户词库（重装可复用）
sudo ./scripts/uninstall.sh --purge-user-data  # 同时删除用户词库（不可恢复）
sudo ./scripts/uninstall.sh --full-reset       # macOS 13+ 重装不弹框时用（清 BTM + tccd 内存）
sudo reboot

这个脚本会做 8 阶段彻底清理：

• TIS 输入源注销（Deselect + Disable）
• 删 .app 本体
• 清 LaunchAgent（解决后台活动残留）
• BTM 后台任务诊断（重启后自然重建）
• 清 LaunchServices 注册
• 清 TCC 授权记录（让重装时重新弹授权对话框——这是不弹框的解药）
• 清 HIToolbox 输入源残留
• 删偏好 / 缓存 / 日志（默认保留用户词库，加 --purge-user-data 才删）

如果菜单无法触发卸载，也可以直接在终端跑 sudo ./scripts/uninstall.sh。

版权所有 © 2026 x1pinyin contributors