快速开始
聆风(AuriType)是面向 Linux 的拼音输入法,基于 IBus,配有自绘候选面板。这一页只讲从安装到日常打字;调校、AI、键位与诊断在各自的页面里。
1. 装上就能用
Section titled “1. 装上就能用”安装合包(推荐):
sudo apt install ./auritype_*.debibus restart # 重载引擎,读入刚装好的代码在系统输入源中添加 聆风拼音(引擎名 auritype-pinyin)。GNOME 可在「设置 → 键盘」中添加。
首次安装后请注销并重新登录一次,以便加载光标跟随扩展;否则候选窗可能无法贴着插入点。
装包或 make dev-install 之后用 ibus restart 重载引擎,daemon 由 systemd 用户单元 org.freedesktop.IBus.session.GNOME.service 托管,会重新拉起引擎与面板;auritype-xim.service 会自行补起 ibus-x11。请从普通终端执行:IDE/agent shell 里的 CARGO_*、CURSOR_*、VSCODE_* 会经 daemon 传给引擎。扩展脚本变更需注销再登录才加载。
支持范围、包格式与校验和见安装。卸载:sudo apt remove --purge auritype
- 组合区:正在输入的拼音。音节之间用空格分开;局部上屏后,已确认的汉字留在前面,后面仍是拼音。
- 候选窗:第 1 条是整段最佳结果。其后可能有换词整句、前缀词、首字。选前缀或首字只确认这一段,剩余拼音继续组合。
- 改段:
Shift+←/→把当前段缩到某个音节边界后,候选只针对该段。 - 读音:打对的字与精确整词不显示拼音;只有打错的字后面可能标带调拼音,例如「随(suí)时」。
3. 基本输入
Section titled “3. 基本输入”默认使用全拼。全拼已包含简拼(如 nh →「你好」、bj →「北京」),无需另开开关。
| 操作 | 按键 |
|---|---|
| 选候选 | 数字键 1–9、0 |
| 上屏 | Space:未改段且焦点在第 1 条时上屏整句;否则上屏焦点候选 |
| 上屏原文拼音 | Enter(保留大小写) |
| 取消组合 | Esc(清空);组合中也可 Ctrl+C |
| 翻页 | PageUp / PageDown;默认另可用 - / =(可在设置中改) |
| 移动候选焦点 | ← / → |
| 按音节移光标 | Ctrl+← / Ctrl+→ |
| 改段 | Shift+← / Shift+→ |
| 隔音 | '(如 xi'an →「西安」) |
标点:组合中先上屏当前候选或整句,再输出符号。\ 为顿号。
邮箱 / 网址:组合中按 @;或先打 www 再按 .;或先打 http/https/ftp/file/mailto 再按 :;盘符路径 C:\(打 C 再按 : 即进入半角)。这些位置不会把前面的拼音转成汉字,而是进入半角原样输入,直到 空格/回车 整段上屏、Esc 丢弃。所以中文状态下 zhangsan@example.com、dev@163.com、https://a.b/?x=1、C:\Users 可一次打完,其中 . 不会变成「。」、数字也不会被当成选字键。
@ 之后会给出域名补全候选(@qq.com、@163.com、@gmail.com…,继续输入会过滤,如 @1 → @163.com)。候选第一条始终是「你打的原文」,空格照原样上屏;要补全就用 ←/→ 或鼠标点一下再空格——数字键在这段里是内容,不选候选。
本地部全是数字(如 163@qq.com)时,只要光标前一个字符是字母或数字,@ 也会打开这段半角输入;而 @某人、行首或中文之后的 @ 仍立即上屏。
其余符号保持中文语义:/、#、反引号都不会触发半角模式(ta/ 仍是「他/」)。
4. 中英切换与混输
Section titled “4. 中英切换与混输”| 操作 | 按键 |
|---|---|
| 中 / 英模式 | 点按 Shift |
| 全 / 半角符号 | 默认 Shift+Space(中文模式切换标点形状) |
| 简 / 繁 | 默认 Ctrl+Shift+F |
中文模式下的英文词:Shift+字母 把大写留在组合区,不切到英文模式。解码按小写,回车保留你敲的大小写。
| 输入 | 常见结果 |
|---|---|
A 再 gu | 「A股」、原文 Agu… |
fenxiAI | 「分析AI」、原文 fenxiAI… |
macOS / CPU | 原文(不能当拼音解时,不硬造汉字) |
niHao | 「你好」、原文 niHao |
空格上屏当前候选;回车上屏原文。要连续打一整段英文,请点按 Shift 进入英文模式。
Caps Lock(组合中):已确认的字上屏,未确认的拼音丢弃;尚未选过字时等同清空。灯亮后面板显示 A,字母按英文透传。
5. 打不出字,先看这三条
Section titled “5. 打不出字,先看这三条”候选窗不跟随光标
注销并重新登录。仍异常时执行:auri-doctor --repair-gnome-caret
只有拼音、没有汉字
确认已安装数据包(auritype-pinyin-data),且 runtime 与词库同代。可运行 auri-doctor 查看加载情况。
Java / IntelliJ 等无法出字
auri-doctor --repair-xim,并按提示重启应用。
其余情况、auri-doctor 的全部子命令、日志与环境变量见诊断与日志。
6. 版本与许可
Section titled “6. 版本与许可”产品名:聆风(AuriType)。运行库(libauri)为 BSD-3-Clause;候选面板与 IBus 前端等为 GPL-3.0。拼音词库衍生自 rime-wanxiang(CC BY 4.0)。详见安装包内 copyright 与项目 README,两个仓库的地址见源码。