<?xml version="1.0" encoding="UTF-8"?><rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>聆风输入法文档与动态</title><description>聆风输入法是一款 Linux 输入法（现在发出去的前端是 Linux IBus）：以本地拼音解码为主、可选 AI 为辅。</description><link>https://auritype.com/</link><language>zh-CN</language><lastBuildDate>Sat, 31 Oct 2026 02:51:30 GMT</lastBuildDate><item><title>[公测] 聆风输入法 Linux 桌面版开放测试</title><link>https://auritype.com/zh/posts/beta-notice/</link><guid isPermaLink="true">https://auritype.com/zh/posts/beta-notice/</guid><description>聆风输入法进入 Linux 桌面公测，首个版本聚焦 Ubuntu 24.04 / 26.04 + GNOME + IBus + Wayland，处理 GTK4 输入残留、键盘指示灯同步、Wayland 候选面板校准与生僻字显示。</description><pubDate>Thu, 29 Oct 2026 00:00:00 GMT</pubDate><content:encoded>{/*
  发往社区论坛（Linux.do / V2EX）时：正文顶部补回一级标题「# [公测] 聆风输入法 Linux 桌面版开放测试：在
  Ubuntu 24.04 / 26.04 (IBus) 上处理那些被忽略的细节」——站内由 title 渲染，写两遍会重复。
  本页与 src/content/posts/en/beta-notice.mdx 必须同批发布、同批撤稿，`##` 数量保持一致，
  否则文章页的跨语言互链 404（见 readme「动态」一节）。
*/}

各位 Linux 桌面用户，

经过半年多的持续开发，**聆风输入法（AuriType）** 现已进入 Linux 桌面环境的公开测试阶段。

在 Linux 桌面中文输入这件事上，现状并不缺少可用方案。但日常输入中，总有一些细微的阻碍反复打断节奏：组合上屏后 GTK4 编辑器里的拼音残留、中英混输时键盘指示灯与大小写脱节、Wayland 下候选框偶尔的滞后漂移，或是打出生僻字时候选框里的“豆腐块”。

聆风从一个跨平台的语义核心运行时（libauri）出发。首个公测版本聚焦一条核心路径：**Ubuntu 24.04 LTS / 26.04 LTS + GNOME + IBus + Wayland**，把这些高频却容易被妥协的工程细节认真处理一遍。

## 我在处理哪些细节

### 1. 意图属于用户：处理即时输入，不留存为数据资产

- **本地推断**：候选排序、长句切分与容错推断只在本地内存的当前输入会话里完成，不上传、**不构建用户画像**。学习到的用户词只写在你自己磁盘上的用户词典里，可以随时导出或永久遗忘。
- **免登录、无广告**：没有账号体系。默认日志不含你打过的原文——不记录组合串、候选与上屏文本；数据模型里也不预留任何“理解用户”的画像字段。
- **模型中立**：云端能力是可选插件，**默认完全关闭**，打开后接的是任意 OpenAI 兼容端点（自备 API，或本机私有部署）。未经明确授权，数据不出本机。

### 2. 直面 Linux 输入栈的工程缝隙

- **不给宿主留残留**：组合期间不把 preedit 写进宿主文档——Linux 侧清空 `update_preedit_text`，拼音只画在候选面板的 header 上。所谓「GTK4 编辑器里上屏后清不掉的幽灵拼音」，从源头就没有产生的机会。
- **键盘指示灯同步**：Caps Lock 在每一次击键路径上都被当作必须如实观察的输入状态，而不是一个可以近似显示的标志位；灯的状态与面板上的 `A` 徽标、字母透传行为绑在同一条规则里，避免在中文、英文与代码之间来回切换时的节奏错乱。
- **Wayland 候选面板校准**：候选框是独立进程的自绘窗口，位置要在 GNOME Shell、IBus 与宿主插入点三者之间对齐，GNOME 上由一个光标跟随扩展负责取插入点（**首次安装后需要注销并重新登录一次**才加载）。往 Wayland 原生 `text-input-v3` 与 Fcitx5 的桥接是后续路线，当前公测走的仍是 IBus。

### 3. 自带渲染层：终结候选框里的“方块字”

- 候选面板有自己的字体回退链：你选的字体 → 你设的回退字体 → **内置的阿里巴巴普惠体 3.0** → 系统 `sans-serif`。
- 内置的是同家族两份 TTF，其中 `AlibabaPuHuiTi-3-55-Regular-L3.ttf` 覆盖 **GB 18030-2022** 扩展区；遇到缺字会落到真正含有该字形的那一份上。生僻字在候选框里看得见，不依赖宿主应用装了什么字体。
- 文字一旦上屏，显示效果交回编辑器自己的字体——输入法不越界替代宿主的排版。

### 4. 成熟的语言模型先验

- 核心词库与语言模型继承并精炼自开源社区优秀的**万象拼音方案**（[rime-wanxiang](https://github.com/amzxyz/rime-wanxiang)），长句切分与首选命中率有扎实的工程先验积累。
- 上游许可都依规在分发中保持完整声明：词库 CC BY 4.0、候选面板与 IBus 前端 GPL-3.0、libauri BSD-3-Clause。安装后可在 `/usr/share/doc/&lt;包名&gt;/copyright` 查到。

## 快速安装体验（Ubuntu 24.04 / 26.04 LTS）

当前公测提供 amd64 的 `.deb` 合包：

```bash
# 1. 从公测下载页取包
#    https://auritype.com/download/

# 2. 安装合包（运行库 + 词库 + IBus 前端，装</content:encoded><category>posts</category><category>zh</category><category>beta</category><category>linux</category></item><item><title>[Public Beta] AuriType for Linux Desktop Is Now Open for Testing</title><link>https://auritype.com/en/posts/beta-notice/</link><guid isPermaLink="true">https://auritype.com/en/posts/beta-notice/</guid><description>AuriType enters public beta on Linux desktops. The first build targets Ubuntu 24.04 / 26.04 + GNOME + IBus + Wayland: host preedit residue, keyboard LEDs, panel anchoring, rare glyphs.</description><pubDate>Thu, 29 Oct 2026 00:00:00 GMT</pubDate><content:encoded>{/*
  Keep this file&apos;s `##` count identical to src/content/posts/zh/beta-notice.mdx -- one article must ship
  both zh and en, or the cross-language link on the article page 404s (see readme, posts section).
  Publish and unpublish both locales in the same batch.
*/}

Hello Linux desktop users,

After more than half a year of continuous work, **AuriType (聆风)** has entered public beta on Linux desktops.

Chinese input on Linux is not short of workable options. What still interrupts the rhythm are small, recurring frictions: pinyin left behind in a GTK4 editor after commit, the keyboard LED and your actual case drifting apart while mixing Chinese and English, the candidate box lagging behind the caret under Wayland, and rare characters turning into tofu boxes.

AuriType starts from a cross-platform semantic core runtime (libauri). The first public beta concentrates on one path: **Ubuntu 24.04 LTS / 26.04 LTS + GNOME + IBus + Wayland**, and takes those high-frequency, easily-compromised engineering details seriously.

## The details I am working on

### 1. Intent belongs to the user: process the input, do not keep it as a data asset

- **Local inference**: candidate ranking, long-sentence segmentation, and error tolerance happen only in local memory, in the current input session. Nothing is uploaded, and **no user profile is built**. Words the engine learned are written only to your own user dictionary on your own disk, and can be exported or forgotten at will.
- **No sign-in, no ads**: there is no account system. By default the logs do not contain what you typed — not the composition string, not the candidates, not the committed text — and the data model reserves no field for &quot;understanding the user&quot;.
- **Model neutral**: the cloud side is an optional plug-in, **off by default**, and once enabled it talks to any OpenAI-compatible endpoint (your own key, or a private local deployment). No data leaves the machine without explicit permission.

### 2. Facing the seams of </content:encoded><category>posts</category><category>en</category><category>beta</category><category>linux</category></item><item><title>Architecture</title><link>https://auritype.com/en/develop/architecture/</link><guid isPermaLink="true">https://auritype.com/en/develop/architecture/</guid><description>聆风输入法 separates the platform shell from the engine. The frontend that ships is Linux IBus, and 聆风输入法 draws the candidate panel.</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>import { Aside } from &quot;@astrojs/starlight/components&quot;;

The runtime separates the platform shell from the engine with a C ABI. On the desktop the panel is its own process. **The frontend that ships is Linux IBus.**

&lt;Aside type=&quot;note&quot; title=&quot;This page does not widen support&quot;&gt;
It describes the Linux IBus frontend that has shipped, and the boundary between shell and engine. Settings offer full pinyin and double pinyin.
&lt;/Aside&gt;

## One keystroke

1. The engine returns this frame’s candidates synchronously. Space commits the first candidate or the whole sentence that was on screen.
2. Neural reranking, the cloud, and continuation run after that frame. Going offline, turning them off, or timing out does not change this keystroke.
3. Suggestions are drawn on their own row. Tab accepts one. Keep typing and you have refused it.

## Candidate panel

The bridge does not call IBus’s built-in candidate window. The panel draws pinyin, candidates, and the suggestion itself, anchored at the start of this composition. If it does not fit below, it flips above. Password fields show nothing.

## Related

- [Local first](/en/features/local-first/)
- [Candidate panel](/en/features/floating-ui/)
- [Privacy](/en/privacy/data-policy/)</content:encoded><category>docs</category><category>develop</category><category>architecture</category></item><item><title>Source</title><link>https://auritype.com/en/develop/building/</link><guid isPermaLink="true">https://auritype.com/en/develop/building/</guid><description>AuriType source is public in two repositories: ibus-auritype (IBus frontend and panel, GPL-3.0) and libauri (runtime library, BSD-3-Clause). Dictionary derived from rime-wanxiang (CC BY 4.0).</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>import { SOURCE_URL, LIBAURI_URL } from &quot;@data/site-config&quot;;

Source is published in two repositories, and licensing is split by component:

| Repository | Contents | License |
|------------|----------|---------|
| &lt;a href={SOURCE_URL} rel=&quot;noopener noreferrer&quot;&gt;ibus-auritype&lt;/a&gt; | The Linux IBus frontend and the candidate panel | GPL-3.0 |
| &lt;a href={LIBAURI_URL} rel=&quot;noopener noreferrer&quot;&gt;libauri&lt;/a&gt; | The cross-platform semantic core runtime library | BSD-3-Clause |

The pinyin dictionary is derived from rime-wanxiang (CC BY 4.0). The package carries a `copyright` file; per component, that file is the authoritative copy.

The code is still iterating fast, so the directory layout and internal interfaces may change. This page does **not** give a clone command or build steps yet — reproducible build instructions go here once they have been run through a clean environment, and they will come with a dependency list.

The product you can talk about today is the Linux IBus frontend. See [Architecture](/en/develop/architecture/) and [Install](/en/guides/install/).</content:encoded><category>docs</category><category>develop</category><category>source</category></item><item><title>Candidate panel</title><link>https://auritype.com/en/features/floating-ui/</link><guid isPermaLink="true">https://auritype.com/en/features/floating-ui/</guid><description>聆风输入法 draws its own candidate panel. It anchors at the start of the composition and flips above when it does not fit below.</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>The panel does not borrow IBus’s own candidate window. It is glass, follows the system light or dark theme and accent color, and does not take keyboard focus. It stays hidden in password fields.

## Position

It anchors at the start of this composition and does not chase the caret while you type. If it does not fit below, it flips above. Pinyin is drawn in the panel, not written into the host document.

## Type and motion

Alibaba PuHuiTi 3.0 is built in for the panel only and does not change the system font. Size, weight, and color are adjustable.

Width only grows while you type, then eases back after a pause. The selection block slides, page turns animate, and both follow the system reduce-motion setting. The light-theme body contrast target is at least 7:1. Selected white text is at least 4.5:1.

The homepage uses the same implementation screenshots: light, dark, and flipped above the composition.</content:encoded><category>docs</category><category>feature</category><category>ui</category></item><item><title>Local first</title><link>https://auritype.com/en/features/local-first/</link><guid isPermaLink="true">https://auritype.com/en/features/local-first/</guid><description>Every key returns candidates synchronously. Neural reranking, the cloud, and continuation run after that frame.</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>## This frame

Every key returns candidates synchronously. Neural reranking, the cloud, and continuation run after that frame. Going offline, turning them off, or timing out does not change the result of this keystroke.

## Space

Space commits the current first candidate or the whole sentence. Suggestions sit on a separate row, labeled local or cloud, and Tab accepts one. Keep typing and you have refused it.

## AI stays off

Any OpenAI-compatible endpoint. Presets: DeepSeek, Qwen, OpenAI, Grok, and local `127.0.0.1:11434`. On-device reranking is preferred by default. Ghost continuation is a separate switch, debounced at 300 ms, with a minimum confidence of 0.6.

The cloud runs only after you turn on Enable AI input. Continuation context can be redacted by default. Cloud results are not written straight into user words or memory.</content:encoded><category>docs</category><category>feature</category></item><item><title>FAQ</title><link>https://auritype.com/en/reference/faq/</link><guid isPermaLink="true">https://auritype.com/en/reference/faq/</guid><description>聆风输入法 is a Linux input method: what ships today, how Space relates to AI, and what stays off the network.</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>## What is 聆风输入法?

聆风输入法 is a Linux desktop input method. It decodes pinyin locally, with optional AI beside it. The product you can talk about today is the Linux IBus frontend. Space commits the sentence you see. AI only suggests beside it.

## Which frontend is actually shipping?

The Linux IBus frontend. 聆风输入法 draws its own candidate panel. Settings offer full pinyin and double pinyin.

## Can I install it now?

What you can install is the 1.2 release build on the releases channel: an amd64 `.deb` covering Ubuntu 24.04 and Ubuntu 26.04. The link and the steps are under [Install](/en/guides/install/). A test channel keeps the earlier build of the same version, for comparison only. The product as a whole is still in public beta.

## Does Space hand the text to the AI?

No. Space commits the current first candidate or the whole sentence. Suggestions sit on a separate row and Tab accepts one. Keep typing and you have refused it.

## Does the cloud see what I type by default?

No. The cloud runs only after you turn on Enable AI input. Passwords and PINs show no candidates, are not learned, and do not go on the network. Default logs omit the original text.

## Where is the source?

Source is public in two repositories: `ibus-auritype` (the IBus frontend and the candidate panel, GPL-3.0) and `libauri` (the cross-platform runtime library, BSD-3-Clause). The URLs are on the [Source](/en/develop/building/) page. The code is still changing, so the layout and internal interfaces may move, and reproducible build steps are not documented yet. Licensing is settled: the runtime library (libauri) is BSD-3-Clause, the candidate panel and the IBus frontend and so on are GPL-3.0, and the pinyin dictionary is derived from rime-wanxiang (CC BY 4.0). The `copyright` file inside the package is the authoritative copy.

## Can the hit rate on the homepage be quoted as accuracy?

No. On an internal set of 193 sentences the first candidate hit 79.8% and the top 16 covered 97.9%. That is a d</content:encoded><category>docs</category><category>reference</category><category>faq</category></item><item><title>Glossary</title><link>https://auritype.com/en/reference/glossary/</link><guid isPermaLink="true">https://auritype.com/en/reference/glossary/</guid><description>Words used in the 聆风输入法 docs. The frontend that ships is Linux IBus.</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>| 中文 | English | Notes |
|------|---------|-------|
| 聆风输入法 | public name | Public name |
| 数据包 | data pack | Ships together with the domain dictionaries |
| 候选窗 | candidate panel | Drawn by 聆风输入法, not IBus’s built-in window |
| 首选 | first candidate | Space commits this row, or the whole sentence, as shown |
| 建议行 | suggestion row | Labeled local or cloud. Tab accepts it |
| 全拼 / 双拼 | full pinyin / double pinyin | The schemes in settings. Full pinyin already includes abbreviations |
| 组合区 | composition | Pinyin that has not been committed |
| IBus | IBus | The frontend that ships |</content:encoded><category>docs</category><category>reference</category><category>glossary</category></item><item><title>Privacy and data</title><link>https://auritype.com/en/privacy/data-policy/</link><guid isPermaLink="true">https://auritype.com/en/privacy/data-policy/</guid><description>聆风输入法 shows no candidates in password or PIN fields, does not learn them, and does not send them on the network. The cloud is off by default.</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>## Passwords and PINs

No candidates, no learning, and no network.

## Cloud

It runs only after you turn on Enable AI input. Continuation context can be redacted by default. Cloud results are not written straight into user words or memory.

## Logs

Default logs do not contain the text you typed.

## Dictionaries

The core dictionary stays on the machine. An unchecked specialist dictionary stays out of memory. User words import and export as pinyin, word, and an optional weight.</content:encoded><category>docs</category><category>privacy</category><category>policy</category></item><item><title>原始碼</title><link>https://auritype.com/zh-tw/develop/building/</link><guid isPermaLink="true">https://auritype.com/zh-tw/develop/building/</guid><description>聆風輸入法的原始碼分兩個倉庫：ibus-auritype（IBus 前端與候選面板，GPL-3.0）與 libauri（跨平台執行函式庫，BSD-3-Clause）；拼音詞庫衍生自 rime-wanxiang，屬 CC BY 4.0。</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>import { SOURCE_URL, LIBAURI_URL } from &quot;@data/site-config&quot;;

原始碼分兩個倉庫發布，授權按元件分件：

| 倉庫 | 內容 | 授權 |
|------|------|------|
| &lt;a href={SOURCE_URL} rel=&quot;noopener noreferrer&quot;&gt;ibus-auritype&lt;/a&gt; | Linux IBus 前端與候選面板 | GPL-3.0 |
| &lt;a href={LIBAURI_URL} rel=&quot;noopener noreferrer&quot;&gt;libauri&lt;/a&gt; | 跨平台語意核心執行函式庫 | BSD-3-Clause |

拼音詞庫衍生自 rime-wanxiang（CC BY 4.0）。安裝包內附 `copyright` 檔案，逐元件的授權以它為準。

原始碼仍在快速迭代，目錄結構與內部介面都可能變動。本頁**暫不提供複製與建置步驟**——可重現的建置說明要等它在乾淨環境跑通之後才寫進文件，屆時會附上相依清單與命令。

現在能對外講的產品，是 Linux 上的 IBus 前端。行為說明見 [架構總覽](/zh-tw/develop/architecture/) 和 [安裝](/zh-tw/guides/install/)。</content:encoded><category>docs</category><category>develop</category><category>source</category></item><item><title>候選窗</title><link>https://auritype.com/zh-tw/features/floating-ui/</link><guid isPermaLink="true">https://auritype.com/zh-tw/features/floating-ui/</guid><description>聆風輸入法自己繪製候選窗：錨在組合起點，下方放不下就翻到上方，密碼框不顯示。</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>候選窗不借用 IBus 自帶候選窗。玻璃材質，跟系統深淺色和主題色，不搶鍵盤焦點。密碼框不顯示。

## 位置

錨在這次組合的起點，打字過程中不跟著游標亂跑。下方放不下就翻到上方。拼音畫在面板裡，不寫進宿主文件。

## 字型與動效

內建阿里巴巴普惠體 3.0，只給面板用，不改系統字型。字級、字重、顏色可調。

寬度打字時只增不減，停頓後再平滑收回。選中塊滑動、翻頁有過渡，並跟隨系統「減少動效」。淺色正文對比目標不低於 7:1，選中白字不低於 4.5:1。

官網首屏用的是同一套實作截圖：淺色、深色，以及翻到組合上方。</content:encoded><category>docs</category><category>feature</category><category>ui</category></item><item><title>先出字，再精修</title><link>https://auritype.com/zh-tw/features/local-first/</link><guid isPermaLink="true">https://auritype.com/zh-tw/features/local-first/</guid><description>聆風輸入法每個鍵都同步返回候選。神經精排、雲端和續寫都在這一幀之後，不改這次按鍵的結果。</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>## 這一幀

每個鍵都同步返回候選。神經精排、雲端和續寫都在這一幀之後。斷網、關閉或逾時，都不改這次按鍵的結果。

## 空格

空格上屏目前首選或整句。建議在單獨一列，標「來自本機」或「來自雲端」，用 Tab 採納。繼續打字就等於拒絕。

## AI 預設關

任意 OpenAI 相容介面。預設有 DeepSeek、通義千問、OpenAI、Grok，以及本機 `127.0.0.1:11434`。預設優先端側精排。Ghost 續寫單獨開關，預設防抖 300 ms、最低置信度 0.6。

雲端預設只在你打開「啟用 AI 輸入」後工作。續寫上下文預設可脫敏。雲端結果不能直接寫進使用者詞或記憶。</content:encoded><category>docs</category><category>feature</category></item><item><title>架構總覽</title><link>https://auritype.com/zh-tw/develop/architecture/</link><guid isPermaLink="true">https://auritype.com/zh-tw/develop/architecture/</guid><description>聆風輸入法把平台殼和引擎分開。現在發出的前端是 Linux IBus，候選窗由聆風輸入法自己繪製。</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>import { Aside } from &quot;@astrojs/starlight/components&quot;;

執行時用 C ABI 把平台殼和引擎分開。桌面端的面板是獨立行程。**現在發出的前端是 Linux IBus。**

&lt;Aside type=&quot;note&quot; title=&quot;這一頁不擴大支援範圍&quot;&gt;
文件只描述已經發出的 Linux IBus 前端，以及殼和引擎的分界。設定頁的方案是全拼和雙拼。
&lt;/Aside&gt;

## 一次按鍵

1. 引擎同步返回這一幀的候選。空格上屏的是當時螢幕上的首選或整句。
2. 神經精排、雲端和續寫都在這一幀之後。斷網、關閉或逾時，不改這次按鍵的結果。
3. 建議畫在單獨一列。Tab 採納，繼續打字等於拒絕。

## 候選窗

Bridge 不呼叫 IBus 自帶候選窗。面板自己畫拼音、候選和建議，錨在這次組合的起點。下方放不下就翻到上方。密碼框不顯示。

## 相關

- [先出字，再精修](/zh-tw/features/local-first/)
- [候選窗](/zh-tw/features/floating-ui/)
- [隱私與資料](/zh-tw/privacy/data-policy/)</content:encoded><category>docs</category><category>develop</category><category>architecture</category></item><item><title>常見問題</title><link>https://auritype.com/zh-tw/reference/faq/</link><guid isPermaLink="true">https://auritype.com/zh-tw/reference/faq/</guid><description>聆風輸入法是一款 Linux 輸入法：現在發出的前端、空格與 AI 和隱私的口徑。</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>## 聆風輸入法是什麼？

聆風輸入法是一款 Linux 桌面輸入法，以本機拼音解碼為主、可選 AI 為輔。現在能對外講的產品，是 Linux 上的 IBus 前端。空格上屏的是你看見的那一句，AI 只在旁邊建議。

## 現在發出的是哪一個前端？

Linux 上的 IBus 前端。候選窗由聆風輸入法自己畫。設定裡的拼音方案是全拼和雙拼。

## 現在能裝嗎？

能裝的是 1.2 正式版（releases 通道）：amd64 的 `.deb`，覆蓋 Ubuntu 24.04 與 Ubuntu 26.04。地址和步驟見[安裝](/zh-tw/guides/install/)。另有一條 test 通道放同版本號更早一次的構建，只作對照。整個產品仍處於公測。

## 空格會把字交給 AI 嗎？

不會。空格上屏目前首選或整句。建議在單獨一列，用 Tab 採納。繼續打字就等於拒絕。

## 雲端預設會看到我打的字嗎？

不會。雲端預設只在打開「啟用 AI 輸入」後工作。密碼和 PIN 不顯示候選，也不學習、不連網。預設日誌不含原文。

## 原始碼在哪裡？

原始碼公開在兩個倉庫：IBus 前端與候選面板 `ibus-auritype`（GPL-3.0）、跨平台執行函式庫 `libauri`（BSD-3-Clause），地址見[原始碼](/zh-tw/develop/building/)。原始碼還在大改，目錄結構與內部介面都可能變動，可重現的建置步驟還沒寫進文件。授權已經確定：執行函式庫（libauri）為 BSD-3-Clause，候選面板與 IBus 前端等為 GPL-3.0，拼音詞庫衍生自 rime-wanxiang（CC BY 4.0）。以安裝包內的 `copyright` 檔案為準。

## 首頁上的命中率能當準確率用嗎？

不能。內部 193 句的首選命中 79.8%、前 16 條覆蓋 97.9%，口徑是開發集，不適合做首頁準確率。那張表裡的毫秒數同樣是測量或預算，不是對外 SLA。</content:encoded><category>docs</category><category>reference</category><category>faq</category></item><item><title>術語表</title><link>https://auritype.com/zh-tw/reference/glossary/</link><guid isPermaLink="true">https://auritype.com/zh-tw/reference/glossary/</guid><description>聆風輸入法文件裡用到的詞。現在發出的前端是 Linux IBus。</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>| 中文 | English | 備註 |
|------|---------|------|
| 聆風輸入法 | public name | 公開名稱 |
| 資料包 | data pack | 專業詞庫隨同一個資料包發布 |
| 候選窗 | candidate panel | 聆風輸入法自己繪製，不借用 IBus 自帶候選窗 |
| 首選 | first candidate | 空格上屏當時看見的這一條或整句 |
| 建議列 | suggestion row | 標「來自本機」或「來自雲端」，Tab 採納 |
| 全拼 / 雙拼 | full pinyin / double pinyin | 設定裡的方案。全拼已帶簡拼假設 |
| 組合區 | composition | 還沒上屏的拼音 |
| IBus | IBus | 現在發出的前端 |</content:encoded><category>docs</category><category>reference</category><category>glossary</category></item><item><title>隱私與資料</title><link>https://auritype.com/zh-tw/privacy/data-policy/</link><guid isPermaLink="true">https://auritype.com/zh-tw/privacy/data-policy/</guid><description>聆風輸入法在密碼和 PIN 裡不顯示候選、不學習、不連網。雲端預設關閉。預設日誌不含原文。</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>## 密碼和 PIN

不顯示候選，也不學習、不連網。

## 雲端

預設只在你打開「啟用 AI 輸入」後工作。續寫上下文預設可脫敏。雲端結果不能直接寫進使用者詞或記憶。

## 日誌

預設日誌不含你打過的原文。

## 詞庫

核心詞在本機。專業庫沒勾選就不進記憶體。使用者詞的匯入匯出格式是「拼音、詞、可選權重」。</content:encoded><category>docs</category><category>privacy</category><category>policy</category></item><item><title>候选窗</title><link>https://auritype.com/zh/features/floating-ui/</link><guid isPermaLink="true">https://auritype.com/zh/features/floating-ui/</guid><description>聆风输入法自己绘制候选窗：锚在组合起点，下方放不下就翻到上方，密码框不显示。</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>候选窗不借用 IBus 自带候选窗。玻璃材质，跟系统深浅色和主题色，不抢键盘焦点。密码框不显示。

## 位置

锚在这次组合的起点，打字过程中不跟着光标乱跑。下方放不下就翻到上方。拼音画在面板里，不写进宿主文档。

## 字体和动效

内置阿里巴巴普惠体 3.0，只给面板用，不改系统字体。字号、字重、颜色可调。

宽度打字时只增不减，停顿后再平滑收回。选中块滑动、翻页有过渡，并跟随系统「减少动效」。浅色正文对比目标不低于 7:1，选中白字不低于 4.5:1。

官网首屏用的是同一套实现截图：浅色、深色，以及翻到组合上方。</content:encoded><category>docs</category><category>feature</category><category>ui</category></item><item><title>先出字，再精修</title><link>https://auritype.com/zh/features/local-first/</link><guid isPermaLink="true">https://auritype.com/zh/features/local-first/</guid><description>聆风输入法每个键都同步返回候选。神经精排、云端和续写都在这一帧之后，不改这次按键的结果。</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>## 这一帧

每个键都同步返回候选。神经精排、云端和续写都在这一帧之后。断网、关闭或超时，都不改这次按键的结果。

## 空格

空格上屏当前首选或整句。建议在单独一行，标「来自本地」或「来自云端」，用 Tab 采纳。继续打字就等于拒绝。

## AI 默认关

任意 OpenAI 兼容接口。预设有 DeepSeek、通义千问、OpenAI、Grok，以及本机 `127.0.0.1:11434`。默认优先端侧精排。Ghost 续写单独开关，默认防抖 300 ms、最低置信度 0.6。

云端默认只在你打开「启用 AI 输入」后工作。续写上下文默认可脱敏。云端结果不能直接写进用户词或记忆。</content:encoded><category>docs</category><category>feature</category></item><item><title>架构总览</title><link>https://auritype.com/zh/develop/architecture/</link><guid isPermaLink="true">https://auritype.com/zh/develop/architecture/</guid><description>聆风输入法把平台壳和引擎分开。现在发出去的前端是 Linux IBus，候选窗由聆风输入法自己绘制。</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>import { Aside } from &quot;@astrojs/starlight/components&quot;;

运行时用 C ABI 把平台壳和引擎分开。桌面端的面板是独立进程。**现在发出去的前端是 Linux IBus。**

&lt;Aside type=&quot;note&quot; title=&quot;这一页不扩大支持范围&quot;&gt;
文档只描述已经发出的 Linux IBus 前端，以及壳和引擎的分界。设置页的方案是全拼和双拼。
&lt;/Aside&gt;

## 一次按键

1. 引擎同步返回这一帧的候选。空格上屏的是当时屏幕上的首选或整句。
2. 神经精排、云端和续写都在这一帧之后。断网、关闭或超时，不改这次按键的结果。
3. 建议画在单独一行。Tab 采纳，继续打字等于拒绝。

## 候选窗

Bridge 不调用 IBus 自带候选窗。面板自己画拼音、候选和建议，锚在这次组合的起点。下方放不下就翻到上方。密码框不显示。

## 相关

- [先出字，再精修](/zh/features/local-first/)
- [候选窗](/zh/features/floating-ui/)
- [隐私与数据](/zh/privacy/data-policy/)</content:encoded><category>docs</category><category>develop</category><category>architecture</category></item><item><title>源码</title><link>https://auritype.com/zh/develop/building/</link><guid isPermaLink="true">https://auritype.com/zh/develop/building/</guid><description>聆风输入法的源码分两个仓库：ibus-auritype（IBus 前端与候选面板，GPL-3.0）与 libauri（跨平台运行库，BSD-3-Clause）；拼音词库衍生自 rime-wanxiang，属 CC BY 4.0。</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>import { SOURCE_URL, LIBAURI_URL } from &quot;@data/site-config&quot;;

源码分两个仓库发布，许可按组件分件：

| 仓库 | 内容 | 许可 |
|------|------|------|
| &lt;a href={SOURCE_URL} rel=&quot;noopener noreferrer&quot;&gt;ibus-auritype&lt;/a&gt; | Linux IBus 前端与候选面板 | GPL-3.0 |
| &lt;a href={LIBAURI_URL} rel=&quot;noopener noreferrer&quot;&gt;libauri&lt;/a&gt; | 跨平台语义核心运行库 | BSD-3-Clause |

拼音词库衍生自 rime-wanxiang（CC BY 4.0）。安装包内附 `copyright` 文件，逐组件的许可以它为准。

源码仍在快速迭代，目录结构与内部接口都可能变动。本页**暂不提供克隆与构建步骤**——可复现的构建说明要等它在干净环境里跑通之后才写进文档，届时会给出依赖清单与命令。

现在能对外讲的产品，是 Linux 上的 IBus 前端。行为说明见 [架构总览](/zh/develop/architecture/) 和 [安装](/zh/guides/install/)。</content:encoded><category>docs</category><category>develop</category><category>source</category></item><item><title>隐私与数据</title><link>https://auritype.com/zh/privacy/data-policy/</link><guid isPermaLink="true">https://auritype.com/zh/privacy/data-policy/</guid><description>聆风输入法在密码和 PIN 里不显示候选、不学习、不联网。云端默认关闭。默认日志不含原文。</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>## 密码和 PIN

输入法不涉密；不学习输入内容，不联网上传数据。

## 云端

默认只在你打开「启用 AI 输入」后工作。续写上下文默认可脱敏。云端结果不能直接写进用户词或记忆。

## 日志

默认日志不含你打过的原文。

## 词库

核心词在本机。专业库没勾选就不进内存。用户词的导入导出格式是「拼音、词、可选权重」。</content:encoded><category>docs</category><category>privacy</category><category>policy</category></item><item><title>常见问题</title><link>https://auritype.com/zh/reference/faq/</link><guid isPermaLink="true">https://auritype.com/zh/reference/faq/</guid><description>聆风输入法是一款 Linux 输入法：现在发出去的前端、空格与 AI 和隐私的口径。</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>## 聆风输入法是什么？

聆风输入法是一款 Linux 桌面输入法，以本地拼音解码为主、可选 AI 为辅。现在能对外讲的产品，是 Linux 上的 IBus 前端。空格上屏的是你看见的那一句，AI 只在旁边建议。

## 现在发出去的是哪一个前端？

Linux 上的 IBus 前端。候选窗由聆风输入法自己画。设置里的拼音方案是全拼和双拼。

## 现在能装吗？

能装的是 1.2 正式版（releases 通道）：amd64 的 `.deb`，覆盖 Ubuntu 24.04 与 Ubuntu 26.04。地址和步骤见[安装](/zh/guides/install/)。另有一条 test 通道放同版本号更早一次的构建，只作对照。整个产品仍处于公测。

## 空格会把字交给 AI 吗？

不会。空格上屏当前首选或整句。建议在单独一行，用 Tab 采纳。继续打字就等于拒绝。

## 云端默认会看到我打的字吗？

不会。云端默认只在打开「启用 AI 输入」后工作。密码和 PIN 不显示候选，也不学习、不联网。默认日志不含原文。

## 源码在哪里？

源码公开在两个仓库：IBus 前端与候选面板 `ibus-auritype`（GPL-3.0）、跨平台运行库 `libauri`（BSD-3-Clause），地址见[源码](/zh/develop/building/)。源码还在大改，目录结构与内部接口都可能变动，可复现的构建步骤还没写进文档。许可已经定下：运行库（libauri）为 BSD-3-Clause，候选面板与 IBus 前端等为 GPL-3.0，拼音词库衍生自 rime-wanxiang（CC BY 4.0）。以安装包内的 `copyright` 文件为准。

## 首页上的命中率能当准确率用吗？

不能。内部 193 句的首选命中 79.8%、前 16 条覆盖 97.9%，口径是开发集，不适合做首页准确率。那张表里的毫秒数同样是测量或预算，不是对外 SLA。</content:encoded><category>docs</category><category>reference</category><category>faq</category></item><item><title>术语表</title><link>https://auritype.com/zh/reference/glossary/</link><guid isPermaLink="true">https://auritype.com/zh/reference/glossary/</guid><description>聆风输入法文档里用到的词。现在发出去的前端是 Linux IBus。</description><pubDate>Thu, 22 Oct 2026 00:00:00 GMT</pubDate><content:encoded>| 中文 | English | 备注 |
|------|---------|------|
| 聆风输入法 | public name | 公开名称 |
| 数据包 | data pack | 专业词库随同一个数据包发布 |
| 候选窗 | candidate panel | 聆风输入法自己绘制，不借用 IBus 自带候选窗 |
| 首选 | first candidate | 空格上屏当时看见的这一条或整句 |
| 建议行 | suggestion row | 标「来自本地」或「来自云端」，Tab 采纳 |
| 全拼 / 双拼 | full pinyin / double pinyin | 设置里的方案。全拼已带简拼假设 |
| 组合区 | composition | 还没上屏的拼音 |
| IBus | IBus | 现在发出去的前端 |</content:encoded><category>docs</category><category>reference</category><category>glossary</category></item><item><title>聆风输入法: the boundary of user intent, and the Linux desktop details that need work</title><link>https://auritype.com/en/posts/why-auritype/</link><guid isPermaLink="true">https://auritype.com/en/posts/why-auritype/</guid><description>聆风输入法 keeps intent inference local and inside the current session, and sets out the Linux desktop input details it is working through. The project is still in development.</description><pubDate>Mon, 12 Oct 2026 00:00:00 GMT</pubDate><content:encoded>Chinese input on the Linux desktop is not short of usable options. IBus and Fcitx 5 are two parallel system entry points, and each can host pinyin, Rime, and other engines. Rime itself is a cross-platform C++ core, brought to Windows, macOS, and Linux through different frontends: Weasel, Squirrel, ibus-rime, and others. From outside, Windows input goes through TSF (Text Services Framework), macOS through InputMethodKit, and Linux through IBus or Fcitx 5. The three differ in framework boundaries, process models, and event semantics. The same input logic only holds on each platform after a large amount of adaptation work that matches that platform’s constraints.

聆风输入法 starts from a cross-platform semantic core runtime, and takes the everyday Linux desktop details that are easy to overlook seriously. What follows is the product boundary it is trying to keep, the engineering problems it is working on, and the stage it is in now.

## User intent belongs to the user

An input method has to judge, on every keystroke, what the user is trying to type. Candidate order, long-sentence composition, correction, and frequency adjustment are all inferences about intent in the moment. Without that inference, an input method cannot work. The boundary for 聆风输入法 is not a denial of that fact. It is a limit on where and how long the inference lasts: it happens locally, inside the current input session. It is not persisted across sessions, it is not turned into a profile from input history, and the text is not converted into a data asset that can be accumulated. There is no sign-in, no account system, and no advertising or monetization in the way. Debug output and logs need to support being turned off and redacted. The data model does not reserve extra persistent fields “so we can know the user better.”

The cloud path needs its own explanation. 聆风输入法 stays neutral about models. A commercial model, a privately deployed model, a system model, or a local model can be an optional step in ca</content:encoded><category>posts</category><category>en</category><category>product</category><category>design</category></item><item><title>聆风输入法：用户意图的边界，与 Linux 桌面输入中需要处理的细节</title><link>https://auritype.com/zh/posts/why-auritype/</link><guid isPermaLink="true">https://auritype.com/zh/posts/why-auritype/</guid><description>聆风输入法把意图推断限制在本地和当前会话，并说明 Ubuntu、GNOME、GTK4 与 Wayland 上正在处理的输入细节。项目仍在开发，以可运行构建上的验证为准。</description><pubDate>Mon, 12 Oct 2026 00:00:00 GMT</pubDate><content:encoded>在 Linux 桌面中文输入这件事上，现状并不缺少可用方案。IBus 与 Fcitx 5 是两条并列的系统入口，各自承载了拼音、Rime 等多种引擎；Rime 本身以跨平台 C++ 核心库的方式，在 Windows、macOS、Linux 上通过不同前端实现为小狼毫、鼠须管、ibus-rime 等形态。从国际视角看，Windows 的输入经由 TSF（Text Services Framework）文本服务接口，macOS 经由 InputMethodKit，Linux 则经由 IBus 或 Fcitx 5——三者的框架边界、进程模型与事件语义并不相同，同一套输入逻辑要在不同平台上成立，需要在框架适配层做大量与平台约束对应的工作。

聆风输入法选择从跨平台语义核心运行时出发，把 Linux 桌面上一些日常却容易被忽略的输入细节认真处理一遍。以下说明它试图守住的产品边界、正在处理的工程问题，以及它当前所处的阶段。

## 用户意图属于用户：输入法处理意图，但不把意图留存为资产

输入法在每一次输入中都必须对“用户想输入什么”做出实时判断——候选排序、长句组合、纠错和词频调整，本质上都是对即时意图的推断。没有这种推断，输入法无法工作。聆风输入法的边界不在于否认这一技术事实，而在于限定推断发生的位置和时限：推断在本地、在当前输入会话内发生，不跨会话持久化，不基于输入历史建立用户画像，不把输入内容转化为可积累的数据资产。免登录，不建立账号体系，不引入广告或变现干扰；调试与日志在设计中需要支持关闭和脱敏，数据模型不为“更懂用户”预留不必要的持久化字段。

云端路径需要单独说明。聆风输入法保持模型中立，商用模型、私有部署的大模型、系统模型或本地模型都可以作为候选生成链条中的可选环节，而不是默认前提或唯一路径。但“模型中立”本身并不自动保证数据边界：一旦输入内容发送到外部服务，第三方如何处理这些内容，输入法无法仅凭产品设计来控制。因此，云端路径的定位是**由用户显式启用的可选能力**，而非默认行为。可预期的控制方式包括：默认本地优先；云端路径可关闭、可识别，并在启用时说明数据离开本机的范围；优先支持用户自备 API 或私有部署端点，使服务端与用户之间存在直接的契约关系；输入法自身不通过云端路径留存输入内容，也不将云端返回结果与用户身份或历史绑定。这些是设计目标，需要在对应功能交付时逐项验证，而非已经完成的承诺。

## Linux 输入栈中正在处理的细节：范围与依据

Linux 桌面输入是 compositor、输入框架、toolkit 与输入协议共同演进的结果，以下问题并非某一方案独有，但处在高频输入的必经路径上，值得被当作工程目标对待。

大小写状态与键盘指示灯不同步，在部分输入框架与桌面会话组合中曾出现相关报告。它不必然影响每一次输入，但会打断在中文、英文与代码之间频繁切换时的节奏。聆风输入法将其作为基础工程目标之一，原因在于它处在每一次按键的路径上，而不是因为它是一个可被单独展示的功能。

候选面板跟随光标的行为，在 Wayland 迁移过程中被放大。compositor、输入框架与 text-input 协议之间的接口缝隙，可能导致候选窗口定位不稳定或跟随滞后，GTK 与非 GTK 应用的表现也可能不同。聆风输入法在 GNOME、IBus 与 Wayland 的集成上保持持续校准，把候选面板定位视为需要反复验证的行为，而不是一次配置即可永久固定的状态。

GTK4 场景下的输入状态干净程度同样需要认真对待。社区中已有观察指出，部分输入方案在 GTK3、Qt 等环境中工作正常，却在 GTK4 应用中遇到输入上下文或预编辑生命周期相关的例外。聆风输入法对 GTK4 的适配从语义核心设计阶段就被纳入约束：宿主应用切换、焦点迁移和预编辑过程结束后，输入状态不应在编辑器中留下残留。分层架构的目的在于让边界情况和异常在可控层内被处理，避免拖累宿主应用；但需要说明的是，Fcitx 5 的插件形态本身运行在 `fcitx5` 进程内，引擎异常会影响该进程下的所有应用，而 IBus 引擎作为独立进程运行时隔离范围不同。聆风输入法的分层设计需要在这一框架约束之内起作用，而非替代框架自身的进程隔离。

常驻内存占用和响应确定性是可用性底线。聆风输入法把这两项作为设计约束，而不是事后优化的性能指标；具体的数值目标和验证方式将在可运行的构建上公布，届时以可复现的测量结果为准。字符覆盖方面，聆风输入法以 GB 18030-2022 为覆盖基准。GB 18030 系列自 2000 年起为强制性国家标准，2022 年版扩展了字符覆盖范围。这里需要区分两个常被混在一起的问题：一是“缺字”，即词库或编码未覆盖某个字符，候选里根本没有它；二是“方块字”，即字符本身存</content:encoded><category>posts</category><category>zh</category><category>product</category><category>design</category></item><item><title>Linux input method documentation</title><link>https://auritype.com/en/</link><guid isPermaLink="true">https://auritype.com/en/</guid><description>Documentation for 聆风输入法, a Linux input method. The frontend that ships is Linux IBus. Pinyin is decoded locally; AI only suggests beside it.</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>import { Card, CardGrid, LinkCard } from &quot;@astrojs/starlight/components&quot;;

**聆风输入法** is a Linux desktop input method. It decodes pinyin locally. AI is optional and off by default. Space commits the sentence you can see.

The product you can talk about today is the **Linux IBus frontend**.

&lt;CardGrid&gt;
  &lt;LinkCard title=&quot;Getting started&quot; href=&quot;/en/guides/getting-started/&quot; description=&quot;From install to everyday typing: enabling it, the interface, keys, mixed input.&quot; /&gt;
  &lt;LinkCard title=&quot;Install&quot; href=&quot;/en/guides/install/&quot; description=&quot;An amd64 .deb for Ubuntu 24.04 / 26.04 (1.2 release). No other systems.&quot; /&gt;
  &lt;LinkCard title=&quot;Pinyin tuning&quot; href=&quot;/en/guides/input-tuning/&quot; description=&quot;Full and abbreviated pinyin, six double-pinyin layouts, correction, eleven fuzzy pairs.&quot; /&gt;
  &lt;LinkCard title=&quot;Optional AI input&quot; href=&quot;/en/guides/ai-input/&quot; description=&quot;Off by default. How to attach an endpoint, where the key goes, how Ghost behaves.&quot; /&gt;
&lt;/CardGrid&gt;

## Who this is for

| Reader | Start here |
|--------|------------|
| Someone deciding whether to try it | [Getting started](/en/guides/getting-started/) |
| Someone switching to double pinyin or fuzzy pairs | [Pinyin tuning](/en/guides/input-tuning/) |
| Someone asking what leaves the machine | [Privacy](/en/privacy/data-policy/) |
| Someone reading the split between shell and engine | [Architecture](/en/develop/architecture/) |
| Someone checking a claim | [FAQ](/en/reference/faq/) |
| Someone debugging output that will not appear | [Diagnostics and logs](/en/reference/diagnostics/) |

&lt;Card title=&quot;Homepage&quot;&gt;
The marketing page is at [auritype.com/?lang=en](/?lang=en). Numbers there carry a scope. They are not a speed or accuracy promise.
&lt;/Card&gt;</content:encoded><category>docs</category><category>overview</category><category>ime</category></item><item><title>Linux 輸入法文件</title><link>https://auritype.com/zh-tw/</link><guid isPermaLink="true">https://auritype.com/zh-tw/</guid><description>聆風輸入法的文件。一款 Linux 輸入法，現在發出的前端是 Linux IBus：本機拼音解碼，AI 只在旁邊建議。</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>import { Card, CardGrid, LinkCard } from &quot;@astrojs/starlight/components&quot;;

**聆風輸入法** 是一款 Linux 桌面輸入法，以本機拼音解碼為主，AI 可選、預設關閉。空格上屏的是你看見的那一句。

現在能對外講的產品，是 **Linux 上的 IBus 前端**。

&lt;CardGrid&gt;
  &lt;LinkCard title=&quot;快速開始&quot; href=&quot;/zh-tw/guides/getting-started/&quot; description=&quot;從裝上了到日常打字：啟用、介面、按鍵、中英混輸。&quot; /&gt;
  &lt;LinkCard title=&quot;安裝&quot; href=&quot;/zh-tw/guides/install/&quot; description=&quot;Ubuntu 24.04 / 26.04 的 amd64 .deb（1.2 正式版）。不承諾別的系統。&quot; /&gt;
  &lt;LinkCard title=&quot;拼音調校&quot; href=&quot;/zh-tw/guides/input-tuning/&quot; description=&quot;全拼與簡拼、雙拼六套鍵位、糾錯、模糊音十一對。&quot; /&gt;
  &lt;LinkCard title=&quot;可選 AI 輸入&quot; href=&quot;/zh-tw/guides/ai-input/&quot; description=&quot;預設關閉。介面怎麼接、金鑰放哪、Ghost 怎麼調。&quot; /&gt;
&lt;/CardGrid&gt;

## 這份文件適合誰

| 讀者 | 建議入口 |
|------|----------|
| 想知道它現在能做什麼 | [快速開始](/zh-tw/guides/getting-started/) |
| 想調雙拼、糾錯或模糊音 | [拼音調校](/zh-tw/guides/input-tuning/) |
| 關心什麼會上雲 | [隱私與資料](/zh-tw/privacy/data-policy/) |
| 想看分層 | [架構總覽](/zh-tw/develop/architecture/) |
| 想核對口徑 | [常見問題](/zh-tw/reference/faq/) |
| 出字異常要排查 | [診斷與日誌](/zh-tw/reference/diagnostics/) |

&lt;Card title=&quot;官網首頁&quot;&gt;
行銷首頁在 [auritype.com/?lang=zh-TW](/?lang=zh-TW)。數字表裡的測量都帶口徑，不是速度或準確率承諾。
&lt;/Card&gt;</content:encoded><category>docs</category><category>overview</category><category>ime</category></item><item><title>Linux 输入法文档</title><link>https://auritype.com/zh/</link><guid isPermaLink="true">https://auritype.com/zh/</guid><description>聆风输入法的文档。一款 Linux 输入法，现在发出去的前端是 Linux IBus：本地拼音解码，AI 只在旁边建议。</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>import { Card, CardGrid, LinkCard } from &quot;@astrojs/starlight/components&quot;;

**聆风输入法** 是一款 Linux 桌面输入法，以本地拼音解码为主，AI 可选、默认关闭。空格上屏的是你看见的那一句。

现在能对外讲的产品，是 **Linux 上的 IBus 前端**。

&lt;CardGrid&gt;
  &lt;LinkCard title=&quot;快速开始&quot; href=&quot;/zh/guides/getting-started/&quot; description=&quot;从装上了到日常打字：启用、界面、按键、中英混输。&quot; /&gt;
  &lt;LinkCard title=&quot;安装&quot; href=&quot;/zh/guides/install/&quot; description=&quot;Ubuntu 24.04 / 26.04 的 amd64 .deb（1.2 正式版）。不承诺别的系统。&quot; /&gt;
  &lt;LinkCard title=&quot;拼音调校&quot; href=&quot;/zh/guides/input-tuning/&quot; description=&quot;全拼与简拼、双拼六套键位、纠错、模糊音十一对。&quot; /&gt;
  &lt;LinkCard title=&quot;可选 AI 输入&quot; href=&quot;/zh/guides/ai-input/&quot; description=&quot;默认关闭。接口怎么接、密钥放哪、Ghost 怎么调。&quot; /&gt;
&lt;/CardGrid&gt;

## 这份文档适合谁

| 读者 | 建议入口 |
|------|----------|
| 想知道它现在能做什么 | [快速开始](/zh/guides/getting-started/) |
| 想调双拼、纠错或模糊音 | [拼音调校](/zh/guides/input-tuning/) |
| 关心什么会上云 | [隐私与数据](/zh/privacy/data-policy/) |
| 想看分层 | [架构总览](/zh/develop/architecture/) |
| 想核对口径 | [常见问题](/zh/reference/faq/) |
| 出字异常要排查 | [诊断与日志](/zh/reference/diagnostics/) |

&lt;Card title=&quot;官网首页&quot;&gt;
首页在 [auritype.com](/)。数字表里的测量都带口径，不是速度或准确率承诺。
&lt;/Card&gt;</content:encoded><category>docs</category><category>overview</category><category>ime</category></item><item><title>Install</title><link>https://auritype.com/en/guides/install/</link><guid isPermaLink="true">https://auritype.com/en/guides/install/</guid><description>The frontend that ships is Linux IBus. The 1.2 release .deb for Ubuntu 24.04 and 26.04 on amd64, about 64 MB. A test channel carries the earlier build of the same version.</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>import { Aside } from &quot;@astrojs/starlight/components&quot;;

The frontend you can get today is **Linux IBus**. This page ships one package only: amd64 for Ubuntu. Nothing else is packaged.

## What it covers

| Item | Status now |
|------|------------|
| Distributions | Ubuntu 24.04, Ubuntu 26.04 |
| Architecture | amd64 |
| Format | `.deb` (releases channel; a test channel also exists) |
| Input framework | IBus |

&lt;Aside type=&quot;note&quot; title=&quot;Installer size&quot;&gt;
About 64 MB, taken from the `content-length` of the release `auritype_1.2.0-1_amd64.deb` response (66,389,028 B). The &quot;about 99 MB installed&quot; figure comes from the v7 release notes and has not been re-measured on this build.
&lt;/Aside&gt;

## Install

You can also take the package from the [download page](/download/). After downloading [auritype_1.2.0-1_amd64.deb](https://dl.cdn.auritype.com/releases/debian/auritype_1.2.0-1_amd64.deb), run this in the folder that holds it:

```bash
sudo apt install ./auritype_1.2.0-1_amd64.deb
ibus restart
```

`apt` pulls the dependencies with it. `dpkg -i` leaves that to you.

## Checksum

The package lives on `dl.cdn.auritype.com` and the manifest lives on this site, so you can compare the two after downloading. Run this in the folder that holds the deb:

```bash
curl -s https://auritype.com/sha256sums.txt -o sha256sums.txt
sha256sum -c sha256sums.txt
```

Expected output is `auritype_1.2.0-1_amd64.deb: OK`. If you only want to look at it, [auritype.com/sha256sums.txt](https://auritype.com/sha256sums.txt) is one line: SHA-256 plus the file name.

The manifest covers the releases package only. The test channel is the earlier build under the same version (on the CDN the release went up 2026-10-31, the test build 10-23), with the same file name and a different SHA-256; putting both lines in one manifest would make `sha256sum -c` report one OK and one FAILED, so the test hash is listed on the [download page](/download/) instead.

A checksum proves the download is complete — not truncated, </content:encoded><category>docs</category><category>guide</category><category>install</category></item><item><title>Getting Started</title><link>https://auritype.com/en/guides/getting-started/</link><guid isPermaLink="true">https://auritype.com/en/guides/getting-started/</guid><description>AuriType Linux IBus pinyin manual. The path from install to daily typing: enabling it, the interface, basic keys, mixed Chinese and English, and the first three checks when nothing comes out.</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>AuriType (聆风) is a pinyin input method for Linux. It runs on IBus and draws its own candidate panel. This page covers installation through everyday typing; tuning, AI, keys, and diagnostics each have their own page.

[Download](/download/)

- Changing scheme, correction or fuzzy pinyin: [Pinyin Tuning](/en/guides/input-tuning/)
- Cloud suggestions and the API key: [Optional AI Input](/en/guides/ai-input/)
- Looking up a key: [Keymap](/en/reference/keymap/); when something breaks: [Diagnostics and logs](/en/reference/diagnostics/)

---

## 1. Install and start typing

Install the combined package (recommended):

```bash
sudo apt install ./auritype_*.deb
ibus restart                       # reload the engine so it picks up the new code
```

Add **聆风拼音** (engine name `auritype-pinyin`) to your input sources. On GNOME, add it under Settings → Keyboard.

**After the first install, log out and log back in once**, so the caret-tracking extension loads. Otherwise the candidate panel may not sit next to the insertion point.

Use `ibus restart` after packaging or `make dev-install`. The daemon is supervised by the systemd user unit `org.freedesktop.IBus.session.GNOME.service`, which relaunches the engine and the panel; `auritype-xim.service` brings `ibus-x11` back on its own. Run it from an **ordinary terminal**: `CARGO_*`, `CURSOR_*`, and `VSCODE_*` in an IDE or agent shell pass through the daemon to the engine. An extension script change needs **logging out and back in** to load.

Supported ranges, package formats, and checksums are on the [Install](/en/guides/install/) page. Remove it: `sudo apt remove --purge auritype`

---

## 2. Interface

- **Composition**: the pinyin you are typing. A space separates syllables. After a partial commit, the confirmed characters stay at the front and what follows is still pinyin.
- **Candidate panel**: row 1 is the best result for the whole input. Below it there may be whole sentences with different word choices, prefix words, or the fir</content:encoded><category>docs</category><category>guide</category><category>intro</category></item><item><title>快速開始</title><link>https://auritype.com/zh-tw/guides/getting-started/</link><guid isPermaLink="true">https://auritype.com/zh-tw/guides/getting-started/</guid><description>聆風（AuriType）Linux IBus 拼音輸入法：從安裝到日常打字的完整路徑。含啟用、介面、基本輸入與按鍵、中英混輸、打不出字的前三種情況。</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>聆風（AuriType）是面向 Linux 的拼音輸入法，基於 IBus，配有自繪候選面板。這一頁只講從安裝到日常打字；調校、AI、鍵位與診斷在各自的頁面裡。

[下載地址](/download/)

- 想換方案、開糾錯或模糊音：[拼音調校](/zh-tw/guides/input-tuning/)
- 想接雲端建議與金鑰：[可選 AI 輸入](/zh-tw/guides/ai-input/)
- 查鍵位：[鍵位總表](/zh-tw/reference/keymap/)；出問題時：[診斷與日誌](/zh-tw/reference/diagnostics/)

---

## 1. 裝上就能用

安裝合包（推薦）：

```bash
sudo apt install ./auritype_*.deb
ibus 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 傳給引擎。擴充腳本變動需**登出再登入**才載入。

支援範圍、包格式與校驗和見[安裝](/zh-tw/guides/install/)。卸載：`sudo apt remove --purge auritype`

---

## 2. 介面

- **組合區**：正在輸入的拼音。音節之間用空格分開；局部上屏後，已確認的漢字留在前面，後面仍是拼音。
- **候選窗**：第 1 條是整段最佳結果。其後可能有換詞整句、前綴詞、首字。選前綴或首字只確認這一段，剩餘拼音繼續組合。
- **改段**：`Shift+←/→` 把目前段縮到某個音節邊界後，候選只針對該段。
- **讀音**：打對的字與精準整詞不顯示拼音；只有打錯的字後面可能標帶調拼音，例如「隨(suí)時」。

---

## 3. 基本輸入

預設使用**全拼**。全拼已包含**簡拼**（如 `nh` →「你好」、`bj` →「北京」），無需另開開關。

| 操作 | 按鍵 |
| --- | --- |
| 選候選 | 數字鍵 `1`–`9`、`0` |
| 上屏 | `Space`：未改段且焦點在第 1 條時上屏整句；否則上屏焦點候選 |
| 上屏原文拼音 | `Enter`（保留大小寫） |
| 取消組合 | `Esc`（清空）；組合中也可 `Ctrl+C` |
| 翻頁 | `PageUp` / `PageDown`；預設另可用 `-` / `=`（可在設定中改） |
| 移動候選焦點 | `←` / `→` |
| 按音節移游標 | `Ctrl+←` / `Ctrl+→` |
| 改段 | `Shift+←` / `Shift+→` |
| 隔音 | `&apos;`（如 `xi&apos;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`）時</content:encoded><category>docs</category><category>guide</category><category>intro</category></item><item><title>安裝</title><link>https://auritype.com/zh-tw/guides/install/</link><guid isPermaLink="true">https://auritype.com/zh-tw/guides/install/</guid><description>聆風輸入法現在發出的前端是 Linux IBus，提供 Ubuntu 24.04 與 26.04 的 amd64 .deb 正式包（1.2），約 64 MB。</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>import { Aside } from &quot;@astrojs/starlight/components&quot;;

現在對外的前端是 **Linux IBus**。本頁只發 Ubuntu 的 amd64 安裝包，別的系統還沒有包。

## 支援範圍

| 項目 | 目前狀態 |
|------|----------|
| 發行版 | Ubuntu 24.04、Ubuntu 26.04 |
| 架構 | amd64 |
| 包格式 | `.deb`（releases 正式通道；另有 test 通道） |
| 輸入框架 | IBus |

&lt;Aside type=&quot;note&quot; title=&quot;安裝包大小&quot;&gt;
安裝包約 64 MB，取自 releases 那份 `auritype_1.2.0-1_amd64.deb` 的 `content-length`（66,389,028 B）。「裝好約 99 MB」這個數出自 v7 發布說明，還沒在新包上複測。
&lt;/Aside&gt;

## 安裝

也可以直接從[下載地址](/download/)取包。從 [auritype_1.2.0-1_amd64.deb](https://dl.cdn.auritype.com/releases/debian/auritype_1.2.0-1_amd64.deb) 取得包之後，在檔案所在目錄執行：

```bash
sudo apt install ./auritype_1.2.0-1_amd64.deb
ibus restart
```

`apt` 會順帶把相依性裝上；用 `dpkg -i` 則還要自己補一次相依性。

## 驗證和

包放在 `dl.cdn.auritype.com`，清單放在本站，取得包之後可以對一遍。在 `auritype_1.2.0-1_amd64.deb` 所在目錄執行：

```bash
curl -s https://auritype.com/sha256sums.txt -o sha256sums.txt
sha256sum -c sha256sums.txt
```

期望輸出 `auritype_1.2.0-1_amd64.deb: OK`（中文語言環境下是「成功」）。只想自己看一眼的話，[auritype.com/sha256sums.txt](https://auritype.com/sha256sums.txt) 就一行：SHA-256 加檔案名。

清單只覆蓋 releases 那個正式包。test 通道是同版本號更早一次的構建（CDN 上正式包 2026-10-31 上架，test 那份 10-23），檔案名一樣、SHA-256 不一樣；兩行同名不同驗證和寫進同一份清單，`sha256sum -c` 會一條 OK 一條 FAILED，所以 test 的驗證和只列在[下載頁](/download/)上。

驗證和證明的是下載完整、沒被截斷或換包。它與包由我們同一方發布，**不構成簽名**——要能獨立驗證「這個包確實出自我們」，得再加 GPG 分離簽名，目前還沒有。

&lt;Aside type=&quot;caution&quot; title=&quot;裝完之後怎麼啟用&quot;&gt;
在系統輸入來源裡加入 **聆風拼音**（引擎名 `auritype-pinyin`）；GNOME 在「設定 → 鍵盤」裡加入。

**首次安裝後請登出並重新登入一次**，游標跟隨擴充才會載入。不重登，候選窗可能貼不住插入點。

自檢用 `auri-doctor`，按鍵與排障見[快速開始](/zh-tw/guides/getting-started/)。卸載是 `sudo apt remove --purge auritype`。
&lt;/Aside&gt;

## 裝好之後可以對上的行為

- 輸入框架是 IBus。候選窗由聆風輸入法自己繪製。
- 設定裡是全拼和雙拼。全拼已帶簡拼假設，沒有單獨的簡拼開關。
- 專業詞庫（地名、詩詞、醫學等）隨同一個資料包發布，預設全選；取消勾選後立即不可用，也不佔記憶體。
- AI 預設關閉。打開「啟用 AI 輸入」之後才走雲端。

授權已經確定：執行函式庫（libauri）為 BSD-3-Clause，候選面板與 IBus 前端等為 GPL-3.0，拼音詞庫衍生自 rime-wanxiang（CC BY 4.0）。安裝包內附 `copyright` 檔案。原始碼已公開在 `ibus-auritype` 與 `libauri` 兩個倉庫。見[快速開始 · 版本與授權](/zh-tw/guides/getting-started/#11-版本與授權)和[原始碼](/zh-tw/develop/building/)。</content:encoded><category>docs</category><category>guide</category><category>install</category></item><item><title>快速开始</title><link>https://auritype.com/zh/guides/getting-started/</link><guid isPermaLink="true">https://auritype.com/zh/guides/getting-started/</guid><description>聆风（AuriType）Linux IBus 拼音输入法：装上就能打字的完整路径。含启用、界面、基本输入与按键、中英混输、打不出字的头三种情况。</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>聆风（AuriType）是面向 Linux 的拼音输入法，基于 IBus，配有自绘候选面板。这一页只讲从安装到日常打字；调校、AI、键位与诊断在各自的页面里。

[下载地址](/download/)

- 想换方案、开纠错或模糊音：[拼音调校](/zh/guides/input-tuning/)
- 想接云端建议与密钥：[可选 AI 输入](/zh/guides/ai-input/)
- 查键位：[键位总表](/zh/reference/keymap/)；出问题时：[诊断与日志](/zh/reference/diagnostics/)

---

## 1. 装上就能用

安装合包（推荐）：

```bash
sudo apt install ./auritype_*.deb
ibus 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 传给引擎。扩展脚本变更需**注销再登录**才加载。

支持范围、包格式与校验和见[安装](/zh/guides/install/)。卸载：`sudo apt remove --purge auritype`

---

## 2. 界面

- **组合区**：正在输入的拼音。音节之间用空格分开；局部上屏后，已确认的汉字留在前面，后面仍是拼音。
- **候选窗**：第 1 条是整段最佳结果。其后可能有换词整句、前缀词、首字。选前缀或首字只确认这一段，剩余拼音继续组合。
- **改段**：`Shift+←/→` 把当前段缩到某个音节边界后，候选只针对该段。
- **读音**：打对的字与精确整词不显示拼音；只有打错的字后面可能标带调拼音，例如「随(suí)时」。

---

## 3. 基本输入

默认使用**全拼**。全拼已包含**简拼**（如 `nh` →「你好」、`bj` →「北京」），无需另开开关。

| 操作 | 按键 |
| --- | --- |
| 选候选 | 数字键 `1`–`9`、`0` |
| 上屏 | `Space`：未改段且焦点在第 1 条时上屏整句；否则上屏焦点候选 |
| 上屏原文拼音 | `Enter`（保留大小写） |
| 取消组合 | `Esc`（清空）；组合中也可 `Ctrl+C` |
| 翻页 | `PageUp` / `PageDown`；默认另可用 `-` / `=`（可在设置中改） |
| 移动候选焦点 | `←` / `→` |
| 按音节移光标 | `Ctrl+←` / `Ctrl+→` |
| 改段 | `Shift+←` / `Shift+→` |
| 隔音 | `&apos;`（如 `xi&apos;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`）时，只要光标前一个字符是字母或数字，`@</content:encoded><category>docs</category><category>guide</category><category>intro</category></item><item><title>安装</title><link>https://auritype.com/zh/guides/install/</link><guid isPermaLink="true">https://auritype.com/zh/guides/install/</guid><description>聆风输入法现在发出去的前端是 Linux IBus，提供 Ubuntu 24.04 与 26.04 的 amd64 .deb 正式包（1.2），约 64 MB。</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>import { Aside } from &quot;@astrojs/starlight/components&quot;;

现在对外的前端是 **Linux IBus**。本页只发 Ubuntu 的 amd64 安装包，别的系统还没有包，也不把尚未发出的前端写成可下载项。

## 支持范围

| 项目 | 当前状态 |
|------|----------|
| 发行版 | Ubuntu 24.04、Ubuntu 26.04 |
| 架构 | amd64 |
| 包格式 | `.deb`（releases 正式通道；另有 test 通道） |
| 输入框架 | IBus |

&lt;Aside type=&quot;note&quot; title=&quot;安装包大小&quot;&gt;
安装包约 64 MB，取自 releases 那份 `auritype_1.2.0-1_amd64.deb` 的 `content-length`（66,389,028 B）。「装好约 99 MB」这个数出自 v7 发布说明，还没在新包上复测。
&lt;/Aside&gt;

## 装

也可以直接从 [下载地址](/download/) 取包。从 [auritype_1.2.0-1_amd64.deb](https://dl.cdn.auritype.com/releases/debian/auritype_1.2.0-1_amd64.deb) 取到包之后，在文件所在目录执行：

```bash
sudo apt install ./auritype_1.2.0-1_amd64.deb
ibus restart
```

`apt` 会顺带把依赖装上；用 `dpkg -i` 则还要自己补一次依赖。

## 校验和

包放在 `dl.cdn.auritype.com`，清单放在本站，取到包之后可以对一遍。在 `auritype_1.2.0-1_amd64.deb` 所在目录执行：

```bash
curl -s https://auritype.com/sha256sums.txt -o sha256sums.txt
sha256sum -c sha256sums.txt
```

期望输出 `auritype_1.2.0-1_amd64.deb: OK`（中文语言环境下是「成功」）。只想自己看一眼的话，[auritype.com/sha256sums.txt](https://auritype.com/sha256sums.txt) 就一行：SHA-256 加文件名。

清单只覆盖 releases 那个正式包。test 通道是同版本号更早一次的构建（CDN 上正式包 2026-10-31 上架，test 那份 10-23），文件名一样、SHA-256 不一样；两行同名不同哈希写进同一份清单，`sha256sum -c` 会一条 OK 一条 FAILED，所以 test 的哈希只列在[下载页](/download/)上。

校验和证明的是下载完整、没被截断或换包。它和包由我们同一方发布，**不构成签名**——要能独立验证「这个包确实出自我们」，得再加 GPG 分离签名，目前还没有。

&lt;Aside type=&quot;caution&quot; title=&quot;装完之后怎么启用&quot;&gt;
在系统输入源里添加 **聆风拼音**（引擎名 `auritype-pinyin`）；GNOME 在「设置 → 键盘」里添加。

**首次安装后请注销并重新登录一次**，光标跟随扩展才会加载。不重登，候选窗可能贴不住插入点。

自检用 `auri-doctor`，按键与排障见[快速开始](/zh/guides/getting-started/)。卸载是 `sudo apt remove --purge auritype`。
&lt;/Aside&gt;

## 装好之后可以对上的行为

- 输入框架是 IBus。候选窗由聆风输入法自己绘制。
- 设置里是全拼和双拼。全拼已带简拼假设，没有单独的简拼开关。
- 专业词库（地名、诗词、医学等）随同一个数据包发布，默认全选；取消勾选后立即不可用，也不占内存。
- AI 默认关闭。打开「启用 AI 输入」之后才走云端。

许可已经定下：运行库（libauri）为 BSD-3-Clause，候选面板与 IBus 前端等为 GPL-3.0，拼音词库衍生自 rime-wanxiang（CC BY 4.0）。安装包内附 `copyright` 文件。源码已公开在 `ibus-auritype` 与 `libauri` 两个仓库。见[快速开始 · 版本与许可](/zh/guides/getting-started/#6-版本与许可)和[源码](/zh/develop/building/)。</content:encoded><category>docs</category><category>guide</category><category>install</category></item><item><title>Optional AI Input</title><link>https://auritype.com/en/guides/ai-input/</link><guid isPermaLink="true">https://auritype.com/en/guides/ai-input/</guid><description>AuriType cloud suggestions: off by default. How to attach an OpenAI-compatible endpoint, where the key is stored, Ghost continuation settings, accepting or rejecting.</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>AI input is **optional**: with it off, the engine only does local pinyin decoding and sends no network request at all. This page covers how to turn it on, what you get, and where the key lives. The data-boundary conclusions are on [Privacy and data](/en/privacy/data-policy/), not repeated here.

---

## 1. Three things to know first

- Off by **default**. The switch is Settings → Pinyin → **Enable AI input**.
- Once on, the cloud only takes part in re-ranking and continuation. Every keystroke is still served local candidates first; being offline, timing out, or turning it off never changes that frame.
- How special fields such as password boxes are handled is on [Privacy and data](/en/privacy/data-policy/). A cloud response is never written straight into your user dictionary or memory.

---

## 2. Attaching an endpoint

Settings → Pinyin. After ticking **Enable AI input**, fill three fields: provider, API URL, model.

The provider dropdown is a convenience preset: picking a row fills in the URL and model name for you, and **both stay editable**. Any OpenAI-compatible endpoint works.

| Provider | Prefilled API URL | Prefilled model |
| --- | --- | --- |
| DeepSeek (default) | `https://api.deepseek.com/v1/chat/completions` | `deepseek-chat` |
| Tongyi Qianwen | `https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions` | `qwen-plus` |
| OpenAI | `https://api.openai.com/v1/chat/completions` | `gpt-4o-mini` |
| Grok | `https://api.x.ai/v1/chat/completions` | `grok-4.6` |
| Local | `http://127.0.0.1:11434/v1/chat/completions` | `llama3` |
| Other | does not overwrite; uses what you type | uses what you type |

The **Local** row points at an OpenAI-compatible endpoint listening on your own machine (Ollama, for example). **A local service needs no key.**

---

## 3. Where the API key is stored

The key is **not written to the config file**. The settings window saves it into the Linux desktop **Secret Service** (GNOME Keyring / KWallet): type the new value under </content:encoded><category>docs</category><category>guide</category><category>ai</category></item><item><title>Pinyin Tuning</title><link>https://auritype.com/en/guides/input-tuning/</link><guid isPermaLink="true">https://auritype.com/en/guides/input-tuning/</guid><description>AuriType Linux IBus pinyin schemes and error tolerance: full pinyin and initials, six double-pinyin layouts, typo correction, the eleven fuzzy pairs, and the defaults for each.</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>This page covers how to bend pinyin to your habits. Daily keys and mixed Chinese-English typing are in [Getting Started](/en/guides/getting-started/); the key list is in [Keymap](/en/reference/keymap/).

---

## 1. Full pinyin and initials

The default scheme is **full pinyin** (Settings → Pinyin → Scheme). Full pinyin already includes abbreviated pinyin (`nh` → 「你好」, `bj` → 「北京」), and the settings page says so directly: the full-pinyin option already carries the initial-abbreviation case and is not offered separately. There is no &quot;enable abbreviated pinyin&quot; switch.

---

## 2. Double pinyin

Settings → Pinyin → set Scheme to **Double pinyin**, then pick a layout from the dropdown. There are six:

Microsoft, Ziranma, Smart ABC, Ziguang, Pinyin Jiajia, Xiaohe

Microsoft is the default. A separate &quot;Show raw double-pinyin input&quot; checkbox is off by default; when on, the composition area shows the double-pinyin letters you typed instead of the restored pinyin. A scheme change takes effect at once.

---

## 3. Typo correction

Settings → Pinyin → **Pinyin correction**, off by default. Once it is on, and **without rewriting the pinyin you typed**, it adds candidates for likely mistakes. **Correct spelling still comes first**.

Typical cases it can fix (single syllables, usually one difference):

| Type | Example |
| --- | --- |
| Two adjacent letters swapped | `shagnhai` → 「上海」 |
| A missing letter | `shanhai` → 「上海」 |
| One extra or wrong letter | A stray key that lands on a legal syllable |

Three boundaries:

- An unfinished initial, such as a lone `c`, only extends the abbreviated-pinyin path. It is never turned into another syllable.
- Correction and fuzzy pinyin are two mechanisms: one handles wrong keystrokes, the other handles similar sounds.
- On longer sentences correction backs off, so it does not slow down the output.

---

## 4. Fuzzy pinyin

Settings → Fuzzy pinyin: one master switch plus 11 pairs you can tick individually.

| Initials | Finals |
| --- | --- </content:encoded><category>docs</category><category>guide</category><category>pinyin</category></item><item><title>可选 AI 输入</title><link>https://auritype.com/zh/guides/ai-input/</link><guid isPermaLink="true">https://auritype.com/zh/guides/ai-input/</guid><description>聆风（AuriType）的云端建议：默认关闭，如何接 OpenAI 兼容接口、密钥存放在桌面密钥环、Ghost 续写参数，以及采纳与拒绝的方式。</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>AI 输入是**可选**的：不开启时，输入法只做本地拼音解码，不发出任何网络请求。这一页讲怎么开、开完能做什么、以及密钥放在哪里。数据边界的结论写在[隐私与数据](/zh/privacy/data-policy/)，这里不复述。

---

## 1. 开启前要知道的三件事

- 默认**关闭**。打开的是设置 → 拼音 → **启用AI输入**。
- 打开之后，云端只参与「精排 / 续写」这一环。每个按键仍先由本地给出候选，断网、超时或关闭都不改这一帧的结果。
- 密码框等特殊输入框的处理规则见[隐私与数据](/zh/privacy/data-policy/)；云端返回的结果不会直接写进你的用户词或记忆。

---

## 2. 接上一个接口

设置 → 拼音，勾选「启用AI输入」后填三项：提供商、API 地址、模型。

「提供商」是一个便捷预设，选中即帮你填好地址与模型名，**都可以再手改**；任何 OpenAI 兼容接口都能接。

| 提供商 | 预填 API 地址 | 预填模型 |
| --- | --- | --- |
| DeepSeek（默认） | `https://api.deepseek.com/v1/chat/completions` | `deepseek-chat` |
| 通义千问 | `https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions` | `qwen-plus` |
| OpenAI | `https://api.openai.com/v1/chat/completions` | `gpt-4o-mini` |
| Grok | `https://api.x.ai/v1/chat/completions` | `grok-4.6` |
| 本地 | `http://127.0.0.1:11434/v1/chat/completions` | `llama3` |
| 其他 | 不覆盖，按你填的走 | 按你填的走 |

「本地」这一档对应本机监听的 OpenAI 兼容端点（例如 Ollama）。**本地服务可以不设置密钥**。

---

## 3. API 密钥放在哪里

密钥**不写进配置文件**，而是通过设置窗口保存到 Linux 桌面的 **Secret Service**（GNOME Keyring / KWallet）：在「API 密钥」里输入新值后点「保存密钥」，「删除密钥」清除，旁边的状态行显示当前是否已存在该提供商的条目。

- 没有可用的密钥环时，**云端请求不会发送**，本地拼音输入不受影响。
- 不要把密钥放进命令行参数、环境变量或日志，也不要用会读取密钥内容的命令去「验证」。
- 想确认用户会话能不能看到 Secret Service：

```sh
busctl --user list --no-pager | grep -F org.freedesktop.secrets
command -v secret-tool
```

第一条没有输出时，检查桌面会话的 D-Bus 与密钥环服务是否已启动并解锁；第二条只用来确认诊断工具装没装。

---

## 4. Ghost 续写

续写是独立开关：设置 → 拼音 → **启用 Ghost 续写**，它依赖「启用AI输入」已经打开。同一页可以调：

| 项 | 范围与默认 |
| --- | --- |
| 续写防抖(ms) | 0–2000，默认 300：停顿多久才开始请求 |
| Ghost 最低置信度 | 0–1，默认 0.6：低于这个分不显示 |
| 流式续写 | 默认开 |
| 续写上下文脱敏 | 默认开 |
| 优先端侧精排（关闭则直走云端） | 默认开 |

上下文窗口取光标前后各约 800 字。

---

## 5. 采纳还是拒绝

停顿时建议行可能出现灰色建议，并标着「来自云端」。

- 按 `Tab` 采纳。
- 继续打字就等于拒绝，不需要额外按键，也不会打断你正在组合的拼音。
- 建议行与本地候选分得很清楚：本地结果标「来自本地」，云端结果标「来自云端」。

---

## 6. 两个常见问题

**提示密钥环不可用**
确认当前桌面会话已启动并解锁 GNOME Keyring 或 KWallet，然后重开设置窗口重试。诊断命令见上面第 3 节。没有密钥环时，普通拼音输入照常可用，只是云端不会发请求。

**显示「已配置」，但一条建议也没有**
「已配置」只说明密钥环里存在该提供商的条目，不代表密钥仍然有效。请核对提供商、模型与 API 地址是否与服务商当前的一致，检查密钥是否有效、账户是否有可用额度；必要时重新保存一</content:encoded><category>docs</category><category>guide</category><category>ai</category></item><item><title>拼音调校</title><link>https://auritype.com/zh/guides/input-tuning/</link><guid isPermaLink="true">https://auritype.com/zh/guides/input-tuning/</guid><description>聆风（AuriType）拼音方案与容错：全拼与简拼、双拼六套键位、拼音纠错、模糊音十一对，以及各自的默认值与生效方式。</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>这一页管「怎么把拼音调成你习惯的样子」。日常按键与中英混输在[快速开始](/zh/guides/getting-started/)，键位查表在[键位总表](/zh/reference/keymap/)。

---

## 1. 全拼与简拼

默认方案是**全拼**，设置 → 拼音 → 拼音方案。全拼已经包含简拼（`nh` →「你好」、`bj` →「北京」），设置页里那行说明写的就是这件事：**全拼已包含简拼假设，不再单独作为选项**。所以没有「开启简拼」这个开关。

---

## 2. 双拼

设置 → 拼音 → 拼音方案选 **双拼**，再在「双拼方案」下拉里选键位，共六套：

微软双拼、自然码、智能ABC、紫光、拼音加加、小鹤双拼

默认是微软双拼。另有一个「显示双拼原始输入」勾选，默认关闭；勾上后组合区显示你敲的双拼字母，而不是还原后的拼音。改方案后立即生效。

---

## 3. 拼音纠错

设置 → 拼音 → **拼音纠错**，默认关闭。开启后，在**不改写你已键入拼音**的前提下，额外给出可能的纠正候选；**正确拼写仍然优先**。

可纠正的典型情况（单音节、通常只差一处）：

| 类型 | 例子 |
| --- | --- |
| 相邻字母对调 | `shagnhai` →「上海」 |
| 少打字母 | `shanhai` →「上海」 |
| 多打 / 打错一个字母 | 落在合法音节上的个别错键 |

三条边界：

- 未打完的声母（如单独的 `c`）只走简拼延伸，不会改成别的音节。
- 纠错与模糊音是两套机制：前者管击键对错，后者管发音近似。
- 较长句子上纠错会收敛，以免拖慢出字。

---

## 4. 模糊音

设置 → 模糊音：一个总开关，加 11 对可单独勾选。

| 声母 | 韵母 |
| --- | --- |
| `zh = z`、`ch = c`、`sh = s`、`n = l`、`r = l`、`f = h` | `an = ang`、`en = eng`、`in = ing`、`ian = iang`、`uan = uang` |

打 `zongguo` 也能出「中国」，靠的就是 `zh = z` 这一对。模糊音只改变解码时接受哪些近似音，不会改写你敲进去的键。

**默认状态要说清**：总开关默认**开**，且 11 对**全部**默认勾上。如果你只想留几对，进这一页把其余取消勾选即可。

---

## 5. 改完之后

设置窗口里的每一项都会立即写入 `~/.config/auritype/config.toml`（一般无需手改；系统模板在 `/usr/share/auritype/config/config.toml`，用户文件覆盖它，未写的键保持默认）。

双拼方案改后立即生效。其他项若没有立刻反映到候选上，重载一次引擎：

```bash
ibus restart
```

换包、换代码之后同样需要 `ibus restart`；GNOME 光标跟随扩展的脚本变更则必须**注销再登录**。</content:encoded><category>docs</category><category>guide</category><category>pinyin</category></item><item><title>Diagnostics and logs</title><link>https://auritype.com/en/reference/diagnostics/</link><guid isPermaLink="true">https://auritype.com/en/reference/diagnostics/</guid><description>AuriType troubleshooting reference: the four auri-doctor flags, how to read every line of its report, where the log lives, which environment variables matter, and how to roll back.</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>When output goes wrong, read this page first, then match your symptom against the [FAQ](/en/reference/faq/). Getting Started keeps only the three most common cases; the full story is here.

---

## 1. Run `auri-doctor` first

The combined package installs this command. With no arguments it is **read-only** and changes nothing:

```bash
auri-doctor
```

Four flags:

| Command | What it does |
| --- | --- |
| `auri-doctor` | Prints a link report and ends with the exact command to run next |
| `auri-doctor --runtime` | Expands the Runtime line into a full snapshot: `libauri`, panel, lexicon, config paths, plus ignored variables and anomalies |
| `auri-doctor --repair-xim` | Enables the user-level systemd unit `auritype-xim.service` and brings up the `ibus-x11` bridge. For Java / IntelliJ and other XIM apps |
| `auri-doctor --repair-gnome-caret` | Installs and enables the GNOME Shell caret-tracking extension. After running it you **must log out and back in once** |
| `auri-doctor --enable-jbr-wayland` | Optional: adds `-Dawt.toolkit.name=WLToolkit` to the JetBrains vmoptions file so JetBrains goes over Wayland instead of XWayland |

The JetBrains section of the report is **read, never modified**: it lists your vmoptions files and their current state (`already set` or `XWayland`), and whether to add the line is your call.

---

## 2. How to read the report

Output is one `[✓]` / `[!]` / `[✗]` line at a time, in a fixed order:

**Session Type** — `wayland` or `x11`, with the desktop name in brackets. Only Wayland needs the caret extension.

**Core Engine** — the current IBus engine. It should read `auritype-pinyin`; anything else means you have not switched input sources yet.

**Runtime** — by default a single line: mode, the `libauri` actually loaded, and the anomaly list. `mode=installed` means the binaries under `/usr/share/auritype`; in installed mode development toolchain variables such as `CARGO_TARGET_DIR` are **ignored**. If `anomalies` is non-empty, re-run with `</content:encoded><category>docs</category><category>reference</category><category>troubleshooting</category></item><item><title>Keymap</title><link>https://auritype.com/en/reference/keymap/</link><guid isPermaLink="true">https://auritype.com/en/reference/keymap/</guid><description>AuriType key reference: the fixed keys you cannot rebind, the only two shortcuts you can, the three page-key checkboxes, and the three ways to open the settings window.</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>This page is a lookup table. To understand how these keys behave while typing, read [Getting Started](/en/guides/getting-started/).

---

## 1. Fixed keys

These keys **cannot be rebound**; their behaviour is hardcoded for both Chinese and English input:

| Action | Keys |
| --- | --- |
| Chinese / English mode | `Shift` (single tap) |
| Back to Chinese from English | `Esc` |
| Cancel the current pinyin | `Ctrl+C` (only while composing) |
| Page | `PageUp` / `PageDown` |
| Pick a candidate on this page | Number keys `1`–`9`, `0` |
| Commit | `Space` |
| Commit the raw pinyin | `Enter` (keeps your capitalization) |
| Move candidate focus | `←` / `→` |
| Move the caret by syllable | `Ctrl+←` / `Ctrl+→` |
| Edit a segment | `Shift+←` / `Shift+→` |
| Syllable break | `&apos;` |
| Accept a cloud suggestion | `Tab` |
| Enumeration comma | `\` |

`Esc` also clears the current input while composing. `Ctrl+C` only applies when a composition exists, so it never steals the ordinary copy shortcut.

---

## 2. Only two keys are rebindable

Settings → Shortcuts. Exactly two rows in the whole page can be changed:

| Action | Default |
| --- | --- |
| English full / half width | `Shift+Space` |
| Simplified / Traditional | `Ctrl+Shift+F` |

Select a row and press **Edit**, or double-click it, to rebind. **Restore default** resets that row; **Restore all** resets every rebindable item on the page (including the page-key checkboxes). The rules while capturing a new combination:

- It must carry `Ctrl`, `Alt`, or `Super`, or be exactly `Shift+Space`. Other single-Shift combinations and bare keys are rejected.
- `Esc` cancels the capture; `Backspace` / `Delete` clears that binding (which turns the shortcut off).
- If it collides with another row you get &quot;conflicts with another shortcut, pick another&quot;; nothing is written.

In the config file these are `punct_width` and `output_script` under `[hotkeys]`; an empty string means the row is disabled. `ctrl+c` is a reserved spec, so a capture will</content:encoded><category>docs</category><category>reference</category><category>keys</category></item><item><title>诊断与日志</title><link>https://auritype.com/zh/reference/diagnostics/</link><guid isPermaLink="true">https://auritype.com/zh/reference/diagnostics/</guid><description>聆风（AuriType）的排障参考：auri-doctor 的四个开关、报告每一行怎么看、日志放在哪里、哪些环境变量会改变行为，以及重载、环境污染与回退。</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>出字异常时先看这一页，再去[常见问题](/zh/reference/faq/)对号入座。快速开始里只留了最常说的三条，完整口径在这里。

---

## 1. 先跑 `auri-doctor`

装完合包就有这个命令。不带参数是**只读**的，什么都不改：

```bash
auri-doctor
```

四个开关：

| 命令 | 做什么 |
| --- | --- |
| `auri-doctor` | 打印一份链路报告，末尾给出可直接执行的建议 |
| `auri-doctor --runtime` | 把 Runtime 那行展开成完整快照：`libauri`、面板、词库、配置路径，以及被忽略的变量和异常 |
| `auri-doctor --repair-xim` | 启用用户级 systemd 单元 `auritype-xim.service`，把 `ibus-x11` 桥接拉起来。给 Java / IntelliJ 这类走 XIM 的应用用 |
| `auri-doctor --repair-gnome-caret` | 安装并启用 GNOME Shell 光标跟随扩展。执行完**必须注销并重新登录一次** |
| `auri-doctor --enable-jbr-wayland` | 可选：往 JetBrains 的 vmoptions 里加一行 `-Dawt.toolkit.name=WLToolkit`，让 JetBrains 直接走 Wayland 而不是 XWayland |

报告里的 JetBrains 一节**只读不改**：它列出你的 vmoptions 文件和当前状态（`already set` 或 `XWayland`），加不加由你决定。

---

## 2. 报告怎么看

`auri-doctor` 的输出是逐行的 `[✓]` / `[!]` / `[✗]`，顺序固定：

**Session Type** — 当前是 `wayland` 还是 `x11`，后面括号里是桌面名。Wayland 下才需要关心光标扩展。

**Core Engine** — 当前 IBus 引擎。应该是 `auritype-pinyin`；显示别的说明你还没在系统输入源里切过来。

**Runtime** — 默认只有一行：模式、实际加载的 `libauri` 路径、异常列表。`mode=installed` 表示走的是 `/usr/share/auritype` 下的安装产物；`installed` 模式会**忽略** `CARGO_TARGET_DIR` 这类开发工具链变量。看到 `anomalies` 非空，再跑 `--runtime` 展开。

**GNOME Caret Extension**（仅 GNOME）— 扩展 ID 是 `auritype-window-origin@auritype`。三件事依次检查：扩展目录在不在（`/usr/share/gnome-shell/extensions/auritype-window-origin@auritype`）、总线名 `com.auritype.CaretRoot` 有没有被持有、Shell 侧的 IBus 连接是否健康（manager、panel 是否 attached、候选弹窗是否已接管、当前引擎）。
扩展文件装了但总线没被持有，是典型的「刚装完还没重登」——Shell 只在登录时扫描扩展目录，所以报告直接让你执行 `--repair-gnome-caret` 并注销重登。

**XWayland Subsystem** — 这一段管的是 Java、Electron 老版本和其它走 XIM 的程序：

| 字段 | 期望值 |
| --- | --- |
| `DISPLAY` | 已设置；Wayland 会话下通常是 `:1` 之类的 XWayland 显示 |
| `XMODIFIERS` | `@im=ibus` |
| `IBUS_ENABLE_SYNC_MODE` | 在 `ibus-x11` 进程的环境里为 `1` |
| XIM selection | `@server=ibus` 有 owner |
| `ibus-x11` 进程 | 正在运行（`/usr/libexec/ibus-x11`） |

任意一项不满足，报告会写明「Java/AWT 应用将无法输入中文」，并给出 `auri-doctor --repair-xim`。

**ibus-daemon** — 没运行就单独报一行。

---

## 3. 日志在哪里

```text
~/.local/state/auritype/auritype.log
```

目</content:encoded><category>docs</category><category>reference</category><category>troubleshooting</category></item><item><title>键位总表</title><link>https://auritype.com/zh/reference/keymap/</link><guid isPermaLink="true">https://auritype.com/zh/reference/keymap/</guid><description>聆风（AuriType）的按键一览：固定不可改的按键、只有两项可改绑的快捷键、三组翻页键勾选，以及打开设置窗口的三种方式。</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>这一页是查表用的。想理解这些键在打字时怎么用，看[快速开始](/zh/guides/getting-started/)。

---

## 1. 固定按键

下面这些键**不可改绑**，中英文输入法里它们的行为是写死的：

| 操作 | 按键 |
| --- | --- |
| 中 / 英模式 | `Shift`（单击） |
| 英文回中文 | `Esc` |
| 取消当前拼音 | `Ctrl+C`（仅组合中） |
| 翻页 | `PageUp` / `PageDown` |
| 选当前页候选 | 数字键 `1`–`9`、`0` |
| 上屏 | `Space` |
| 上屏原文拼音 | `Enter`（保留大小写） |
| 移动候选焦点 | `←` / `→` |
| 按音节移光标 | `Ctrl+←` / `Ctrl+→` |
| 改段 | `Shift+←` / `Shift+→` |
| 隔音 | `&apos;` |
| 采纳云端建议 | `Tab` |
| 顿号 | `\` |

`Esc` 在组合中还会清空当前输入；`Ctrl+C` 只在组合中存在时生效，不会抢走通用的复制快捷键。

---

## 2. 可改绑的只有两项

设置 → 快捷键，整页只有两行可以改：

| 功能 | 默认 |
| --- | --- |
| 全/半角符号 | `Shift+Space` |
| 简/繁 | `Ctrl+Shift+F` |

选中一行后点「编辑」或双击改绑，「恢复默认」还原该项，「全部恢复默认」还原本页可改项（含翻页勾选）。捕获新按键时的规则：

- 必须带 `Ctrl`、`Alt`、`Super`，或者是 `Shift+Space`；其他单 Shift 组合与单键不接受。
- `Esc` 取消录入，`Backspace` / `Delete` 清除该项绑定（即关闭这个快捷键）。
- 与另一项冲突时会提示「与另一项快捷键冲突，请换一组」，不会写入。

配置文件里对应 `[hotkeys]` 的 `punct_width` 与 `output_script`，值为空字符串表示禁用该项；`ctrl+c` 属于保留键，改绑时不会被占用。

---

## 3. 翻页键勾选

`PageUp` / `PageDown` 之外，还可以额外挂三组键，在设置 → 快捷键里勾选（可多勾，互不冲突）：

| 勾选 | 上一页 | 下一页 | 默认 |
| --- | --- | --- | --- |
| `[ - ] [ = ] 翻页` | `-` | `=` | 已勾 |
| `[ , ] [ . ] 翻页` | `,` | `.` | 未勾 |
| `[ [ ] [ ] ] 翻页` | `[` | `]` | 未勾 |

---

## 4. 打开设置窗口的三种方式

- 候选面板上的设置按钮。
- 输入法的属性菜单项（面板状态图标里）。
- 命令行执行 `auritype-pinyin-setup`。

**没有默认的「打开设置」全局快捷键**，除第 2 节那两项之外也不提供其他改键能力。若你在别处见过 `` Ctrl+` `` 之类的写法，那是错的。</content:encoded><category>docs</category><category>reference</category><category>keys</category></item><item><title>可選 AI 輸入</title><link>https://auritype.com/zh-tw/guides/ai-input/</link><guid isPermaLink="true">https://auritype.com/zh-tw/guides/ai-input/</guid><description>聆風（AuriType）的雲端建議：預設關閉，如何接 OpenAI 相容介面、金鑰存放在桌面金鑰環、Ghost 續寫參數，以及採納與拒絕的方式。</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>AI 輸入是**可選**的：不開啟時，輸入法只做本地拼音解碼，不發出任何網路請求。這一頁講怎麼開、開完能做什麼、以及金鑰放在哪裡。資料邊界的結論寫在[隱私與資料](/zh-tw/privacy/data-policy/)，這裡不復述。

---

## 1. 開啟前要知道的三件事

- 預設**關閉**。開啟的是設定 → 拼音 → **啟用 AI 輸入**。
- 開啟之後，雲端只參與「精排 / 續寫」這一環。每個按鍵仍先由本地給出候選，斷網、逾時或關閉都不改這一幀的結果。
- 密碼框等特殊輸入框的處理規則見[隱私與資料](/zh-tw/privacy/data-policy/)；雲端返回的結果不會直接寫進你的使用者詞或記憶。

---

## 2. 接上一個介面

設定 → 拼音，勾選「啟用 AI 輸入」後填三項：提供商、API 網址、模型。

「提供商」是一個便捷預設，選中即幫你填好網址與模型名，**都可以再手改**；任何 OpenAI 相容介面都能接。

| 提供商 | 預填 API 網址 | 預填模型 |
| --- | --- | --- |
| DeepSeek（預設） | `https://api.deepseek.com/v1/chat/completions` | `deepseek-chat` |
| 通義千問 | `https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions` | `qwen-plus` |
| OpenAI | `https://api.openai.com/v1/chat/completions` | `gpt-4o-mini` |
| Grok | `https://api.x.ai/v1/chat/completions` | `grok-4.6` |
| 本地 | `http://127.0.0.1:11434/v1/chat/completions` | `llama3` |
| 其他 | 不覆蓋，按你填的走 | 按你填的走 |

「本地」這一檔對應本機監聽的 OpenAI 相容端點（例如 Ollama）。**本地服務可以不設定金鑰**。

---

## 3. API 金鑰放在哪裡

金鑰**不寫進設定檔**，而是透過設定視窗儲存到 Linux 桌面的 **Secret Service**（GNOME Keyring / KWallet）：在「API 金鑰」裡輸入新值後點「儲存金鑰」，「刪除金鑰」清除，旁邊的狀態列顯示目前是否已存在該提供商的條目。

- 沒有可用的金鑰環時，**雲端請求不會送出**，本地拼音輸入不受影響。
- 不要把金鑰放進命令列引數、環境變數或日誌，也不要用會讀取金鑰內容的命令去「驗證」。
- 想確認使用者工作階段能不能看到 Secret Service：

```sh
busctl --user list --no-pager | grep -F org.freedesktop.secrets
command -v secret-tool
```

第一條沒有輸出時，檢查桌面工作階段的 D-Bus 與金鑰環服務是否已啟動並解鎖；第二條只用來確認診斷工具裝沒裝。

---

## 4. Ghost 續寫

續寫是獨立開關：設定 → 拼音 → **啟用 Ghost 續寫**，它依賴「啟用 AI 輸入」已經開啟。同一頁可以調：

| 項 | 範圍與預設 |
| --- | --- |
| 續寫防呆(ms) | 0–2000，預設 300：停頓多久才開始請求 |
| Ghost 最低信心度 | 0–1，預設 0.6：低於這個分不顯示 |
| 串流續寫 | 預設開 |
| 續寫上下文去識別化 | 預設開 |
| 優先端側精排（關閉則直走雲端） | 預設開 |

上下文視窗取游標前後各約 800 字。

---

## 5. 採納還是拒絕

停頓時建議列可能出現灰色建議，並標著「來自雲端」。

- 按 `Tab` 採納。
- 繼續打字就等于拒絕，不需要額外按鍵，也不會打斷你正在組合的拼音。
- 建議列與本地候選分得很清楚：本地結果標「來自本地」，雲端結果標「來自雲端」。

---

## 6. 兩個常見問題

**提示金鑰環不可用**
確認目前桌面工作階段已啟動並解鎖 GNOME Keyring 或 KWallet，然後重開設定視窗重試。診斷命令見上面第 3 節。沒有金鑰環時，普通拼音輸入照常可用，只是雲端不會發請求。

**顯示「已設定」，但一條建議也沒有**
「已設定」只說明金鑰環裡存在該提供商的條目，不代表金鑰仍然有效。請核對提供商、模型與 API 網址是否與服務商目前的相符，檢查金鑰是否</content:encoded><category>docs</category><category>guide</category><category>ai</category></item><item><title>拼音調校</title><link>https://auritype.com/zh-tw/guides/input-tuning/</link><guid isPermaLink="true">https://auritype.com/zh-tw/guides/input-tuning/</guid><description>聆風（AuriType）拼音方案與容錯：全拼與簡拼、雙拼六套鍵位、拼音糾錯、模糊音十一對，以及各自的預設值與生效方式。</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>這一頁管「怎麼把拼音調成你習慣的樣子」。日常按鍵與中英混輸在[快速開始](/zh-tw/guides/getting-started/)，鍵位查表在[鍵位總表](/zh-tw/reference/keymap/)。

---

## 1. 全拼與簡拼

預設方案是**全拼**，設定 → 拼音 → 拼音方案。全拼已經包含簡拼（`nh` →「你好」、`bj` →「北京」），設定頁裡那行說明寫的就是這件事：**全拼已包含簡拼假設，不再單獨作為選項**。所以沒有「開啟簡拼」這個開關。

---

## 2. 雙拼

設定 → 拼音 → 拼音方案選 **雙拼**，再在「雙拼方案」下拉裡選鍵位，共六套：

微軟雙拼、自然碼、智能 ABC、紫光、拼音加加、小鶴雙拼

預設是微軟雙拼。另有一個「顯示雙拼原始輸入」勾選，預設關閉；勾上後組合區顯示你敲的雙拼字母，而不是還原後的拼音。改方案後立即生效。

---

## 3. 拼音糾錯

設定 → 拼音 → **拼音糾錯**，預設關閉。開啟後，在**不改寫你已鍵入拼音**的前提下，額外給出可能的糾正候選；**正確拼寫仍然優先**。

可糾正的典型情況（單音節、通常只差一處）：

| 類型 | 例子 |
| --- | --- |
| 相鄰字母對調 | `shagnhai` →「上海」 |
| 少打字母 | `shanhai` →「上海」 |
| 多打 / 打錯一個字母 | 落在合法音節上的個別錯鍵 |

三條邊界：

- 沒打完的聲母（如單獨的 `c`）只走簡拼延伸，不會改成別的音節。
- 糾錯與模糊音是兩套機制：前者管擊鍵對錯，後者管發音近似。
- 較長句子上糾錯會收斂，以免拖慢出字。

---

## 4. 模糊音

設定 → 模糊音：一個總開關，加 11 對可單獨勾選。

| 聲母 | 韻母 |
| --- | --- |
| `zh = z`、`ch = c`、`sh = s`、`n = l`、`r = l`、`f = h` | `an = ang`、`en = eng`、`in = ing`、`ian = iang`、`uan = uang` |

打 `zongguo` 也能出「中國」，靠的就是 `zh = z` 這一對。模糊音只改變解碼時接受哪些近似音，不會改寫你敲進去的鍵。

**預設狀態要說清**：總開關預設**開**，且 11 對**全部**預設勾上。如果你只想留幾對，進這一頁把其餘取消勾選即可。

---

## 5. 改完之後

設定視窗裡的每一項都會立即寫入 `~/.config/auritype/config.toml`（一般無需手改；系統範本在 `/usr/share/auritype/config/config.toml`，使用者檔案覆蓋它，未寫的鍵保持預設）。

雙拼方案改後立即生效。其他項若沒有立刻反映到候選上，重載一次引擎：

```bash
ibus restart
```

換包、換程式碼之後同樣需要 `ibus restart`；GNOME 光標跟隨擴充腳本的變更則必須**登出再登入**。</content:encoded><category>docs</category><category>guide</category><category>pinyin</category></item><item><title>診斷與日誌</title><link>https://auritype.com/zh-tw/reference/diagnostics/</link><guid isPermaLink="true">https://auritype.com/zh-tw/reference/diagnostics/</guid><description>聆風（AuriType）的排障參考：auri-doctor 的四個開關、報告每一行怎麼看、日誌放在哪裡、哪些環境變數會改變行為，以及重載、環境污染與回退。</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>出字異常時先看這一頁，再去[常見問題](/zh-tw/reference/faq/)對號入座。快速開始裡只留了最常說的三條，完整口徑在這裡。

---

## 1. 先跑 `auri-doctor`

裝完合包就有這個命令。不帶參數是**唯讀**的，什麼都不改：

```bash
auri-doctor
```

四個開關：

| 命令 | 做什麼 |
| --- | --- |
| `auri-doctor` | 印出一份鏈路報告，末尾給出可直接執行的建議 |
| `auri-doctor --runtime` | 把 Runtime 那行展開成完整快照：`libauri`、面板、詞庫、設定檔路徑，以及被忽略的變數與異常 |
| `auri-doctor --repair-xim` | 啟用使用者級 systemd 單元 `auritype-xim.service`，把 `ibus-x11` 橋接拉起來。給 Java / IntelliJ 這類走 XIM 的應用用 |
| `auri-doctor --repair-gnome-caret` | 安裝並啟用 GNOME Shell 光標跟隨擴充。執行完**必須登出並重新登入一次** |
| `auri-doctor --enable-jbr-wayland` | 可選：往 JetBrains 的 vmoptions 裡加一行 `-Dawt.toolkit.name=WLToolkit`，讓 JetBrains 直接走 Wayland 而不是 XWayland |

報告裡的 JetBrains 一節**唯讀不改**：它列出你的 vmoptions 檔案與目前狀態（`already set` 或 `XWayland`），加不加由你決定。

---

## 2. 報告怎麼看

`auri-doctor` 的輸出是逐行的 `[✓]` / `[!]` / `[✗]`，順序固定：

**Session Type** — 目前是 `wayland` 還是 `x11`，後面括號裡是桌面名。Wayland 下才需要關心光標擴充。

**Core Engine** — 目前 IBus 引擎。應該是 `auritype-pinyin`；顯示別的說明你還沒在系統輸入源裡切過來。

**Runtime** — 預設只有一行：模式、實際載入的 `libauri` 路徑、異常清單。`mode=installed` 表示走的是 `/usr/share/auritype` 下的安裝產物；`installed` 模式會**忽略** `CARGO_TARGET_DIR` 這類開發工具鏈變數。看到 `anomalies` 非空，再跑 `--runtime` 展開。

**GNOME Caret Extension**（僅 GNOME）— 擴充 ID 是 `auritype-window-origin@auritype`。三件事依次檢查：擴充目錄在不在（`/usr/share/gnome-shell/extensions/auritype-window-origin@auritype`）、總線名 `com.auritype.CaretRoot` 有沒有被持有、Shell 側的 IBus 連線是否健康（manager、panel 是否 attached、候選彈窗是否已接管、目前引擎）。
擴充檔案裝了但總線沒被持有，是典型的「剛裝完還沒重登」——Shell 只在登入時掃描擴充目錄，所以報告直接請你執行 `--repair-gnome-caret` 並登出重登。

**XWayland Subsystem** — 這一段管的是 Java、Electron 舊版與其他走 XIM 的程式：

| 欄位 | 期望值 |
| --- | --- |
| `DISPLAY` | 已設定；Wayland 工作階段下通常是 `:1` 之類的 XWayland 顯示 |
| `XMODIFIERS` | `@im=ibus` |
| `IBUS_ENABLE_SYNC_MODE` | 在 `ibus-x11` 程式的環境裡為 `1` |
| XIM selection | `@server=ibus` 有 owner |
| `ibus-x11` 程式 | 正在執行（`/usr/libexec/ibus-x11`） |

任一項不滿足，報告會写明「Java/AWT 應用將無法輸入中文」，並給出 `auri-doctor --repair-xim`。

**ibus-daemon** — 沒執行就單獨報一行。

---

## 3. 日誌在哪裡

```text
~/.local/state/auritype/auritype.log
`</content:encoded><category>docs</category><category>reference</category><category>troubleshooting</category></item><item><title>鍵位總表</title><link>https://auritype.com/zh-tw/reference/keymap/</link><guid isPermaLink="true">https://auritype.com/zh-tw/reference/keymap/</guid><description>聆風（AuriType）的按鍵一覽：固定不可改的按鍵、只有兩項可改綁的快捷鍵、三組翻頁鍵勾選，以及開啟設定視窗的三種方式。</description><pubDate>Thu, 01 Oct 2026 00:00:00 GMT</pubDate><content:encoded>這一頁是查表用的。想理解這些鍵在打字時怎麼用，看[快速開始](/zh-tw/guides/getting-started/)。

---

## 1. 固定按鍵

下面這些鍵**不可改綁**，中英文輸入法裡它們的行為是寫死的：

| 操作 | 按鍵 |
| --- | --- |
| 中 / 英模式 | `Shift`（單擊） |
| 英文回中文 | `Esc` |
| 取消目前拼音 | `Ctrl+C`（僅組合中） |
| 翻頁 | `PageUp` / `PageDown` |
| 選目前頁候選 | 數字鍵 `1`–`9`、`0` |
| 上屏 | `Space` |
| 上屏原文拼音 | `Enter`（保留大小寫） |
| 移動候選焦點 | `←` / `→` |
| 按音節移游標 | `Ctrl+←` / `Ctrl+→` |
| 改段 | `Shift+←` / `Shift+→` |
| 隔音 | `&apos;` |
| 採納雲端建議 | `Tab` |
| 頓號 | `\` |

`Esc` 在組合中還會清空目前輸入；`Ctrl+C` 只在組合存在時生效，不會搶走通用的複製快捷鍵。

---

## 2. 可改綁的只有兩項

設定 → 快捷鍵，整頁只有兩行可以改：

| 功能 | 預設 |
| --- | --- |
| 全/半角符號 | `Shift+Space` |
| 簡/繁 | `Ctrl+Shift+F` |

選中一行後點「編輯」或雙擊改綁，「恢復預設」還原該項，「全部恢復預設」還原本頁可改項（含翻頁勾選）。擷取新按鍵時的規則：

- 必須帶 `Ctrl`、`Alt`、`Super`，或者是 `Shift+Space`；其他單 Shift 組合與單鍵不接受。
- `Esc` 取消錄入，`Backspace` / `Delete` 清除該項綁定（即關閉這個快捷鍵）。
- 與另一項衝突時會提示「與另一項快捷鍵衝突，請換一組」，不會寫入。

設定檔裡對應 `[hotkeys]` 的 `punct_width` 與 `output_script`，值為空字串表示停用該項；`ctrl+c` 屬於保留鍵，改綁時不會被佔用。

---

## 3. 翻頁鍵勾選

`PageUp` / `PageDown` 之外，還可以額外掛三組鍵，在設定 → 快捷鍵裡勾選（可多勾，互不衝突）：

| 勾選 | 上一頁 | 下一頁 | 預設 |
| --- | --- | --- | --- |
| `[ - ] [ = ] 翻頁` | `-` | `=` | 已勾 |
| `[ , ] [ . ] 翻頁` | `,` | `.` | 未勾 |
| `[ [ ] [ ] ] 翻頁` | `[` | `]` | 未勾 |

---

## 4. 開啟設定視窗的三種方式

- 候選面板上的設定按鈕。
- 輸入法的屬性選單項（面板狀態圖示裡）。
- 命令列執行 `auritype-pinyin-setup`。

**沒有預設的「開啟設定」全域快捷鍵**，除第 2 節那兩項之外也不提供其他改鍵能力。若你在別處見過 `` Ctrl+` `` 之類的寫法，那是錯的。</content:encoded><category>docs</category><category>reference</category><category>keys</category></item></channel></rss>