WowType README

项目的 README,来自 github.com/Gloridust/WowType。合并为一个 markdown 文件:README.md。

WowType 图标

WowType

在 Linux 上打字,像微信输入法一样顺手。

一个 fcitx5 拼音输入法:长句一次打完、打一半就有词、按错键也能认出来,越用越懂你。

CI Release fcitx5 License

安装 · 使用 · 设置 · 更多文档 · 常见问题 · 工作原理 · 参与开发

加入 Telegram 交流群

介绍视频 v0.3.12:互译、语音输入、macOS 版、日期时间、候选更准……

特性

在文本编辑器里打 hengxianghouxuanci:横排候选条,第一个是横向候选词,后面是横向、横向后选词……
候选横排,和微信输入法一样:整句只留几个,后面是词,最后是单字

打 xiangquzijieshangban 时的候选:想去字节上班、想去字节……
长句一口气打完
还能只上屏前半截「想去字节」,剩下的接着选
打 weixni 时第一个候选是微信
按错顺序,没关系
weixni 照样是「微信」
打 wanqky 时第一个候选是完全可以
全简拼混打,也没问题
wanqky → 完全可以
打 wechat 时第一个候选是 WeChat
中英混打,不用切换
wechat → WeChat,大小写按词表来
打 jintianhaokaixin 时第三个候选是开心😊
打着字,顺手就有表情
第三个候选是「开心😊」,选了上屏「今天好开心😊」
按住右 Alt 说话:光标变成声波,下面是正在听、离线和实时波形
按住右 Alt 说话
离线识别,录音不上传

安装

系统要求

一行命令安装(推荐)

Ubuntu 22.04 / 24.04 / 26.04、Debian 13、deepin 23 / 25、Arch Linux(及衍生版)、Fedora、macOS 上,在终端里运行:

curl -fsSL https://raw.githubusercontent.com/Gloridust/WowType/main/install.sh | bash

在 Linux 上它会(macOS 上见下面):

  1. 下载和你系统对应的最新安装包(词库已经在包里,约 29 MB),按 SHA256SUMS 校验
  2. 用系统的包管理器(apt-get、pacman、dnf)装上,顺带装好 fcitx5 和设置界面要用的 GTK 4 / libadwaita。Arch 不会替你整机升级,提示依赖不满足时先 sudo pacman -Syu
  3. 输入法框架还不是 fcitx5(Ubuntu 默认是 IBus)时,问你要不要用 im-config 切过去(deepin 默认就是 fcitx5,不动)
  4. 把 WowType 加进 fcitx5 的输入法列表;fcitx5 正在运行的话会先重启它一次

装完按提示做:切换了输入法框架的话注销并重新登录,然后按 Ctrl+Space 切到 WowType,打 nihao 试试。 以后再跑一遍同样的命令就是升级(设置界面里也会提醒有新版本)。

想先看看脚本做了什么:install.sh,或者 bash install.sh --print-plan 只看会装哪个包、不动系统。 不想让它改输入法框架或重启 fcitx5,可以加环境变量,例如 curl -fsSL … | WOWTYPE_NO_IM_CONFIG=1 WOWTYPE_NO_RESTART=1 bash。

GNOME(Ubuntu 默认桌面)在 Wayland 下,建议再装 GNOME Shell 扩展 Input Method Panel, 活动概览的搜索框等地方才能显示候选框。

macOS

macOS 12 或更新,Apple 芯片和 Intel 都行。

一行命令安装(推荐)

打开「终端」(启动台里搜「终端」,或按 ⌘空格 输入 Terminal),粘贴下面这行,回车:

curl -fsSL https://raw.githubusercontent.com/Gloridust/WowType/main/install.sh | bash

它会下载最新的 WowType-<版本>-macos.pkg,按 SHA256SUMS 校验,然后只装给你自己(装到 ~/Library/Input Methods), 不要管理员密码,也不用到「隐私与安全性」里放行。装完自动加进输入法并切到 WowType,打 nihao 试试。 以后再跑一遍同样的命令就是升级。

下载安装包

不想用终端的话,到 Releases 下载 WowType-<版本>-macos.pkg,双击安装。 安装包没有 Apple 开发者签名,第一次打开时系统会说「无法验证」:点「完成」,打开「系统设置 → 隐私与安全性」, 往下找到 WowType 那一条,点「仍要打开」,输入开机密码后安装器就会打开。之后升级还是同样的步骤。

装好以后

手动安装

第 1 步:确认你在用 fcitx5

Ubuntu 默认用的是 IBus。先装好 fcitx5 并设为默认输入法框架(已经在用 fcitx5 的跳过这步):

sudo apt install fcitx5 fcitx5-config-qt \
  fcitx5-frontend-gtk3 fcitx5-frontend-gtk4 fcitx5-frontend-qt5
im-config -n fcitx5

然后注销并重新登录。登录后右上角托盘里应该有一个键盘图标。

第 2 步:安装 WowType

方式一:安装包

到 Releases 页面下载和你系统对应的那一个文件 wowtype_<版本>_<发行版>_<架构>.deb(发行版是 ubuntu22.04、ubuntu24.04、ubuntu26.04、debian13、deepin23、deepin25,架构是 amd64 或 arm64,deepin 只有 amd64),词库已经包含在里面。 不知道自己是哪个发行版、哪种架构:

. /etc/os-release && echo "$ID$VERSION_ID"     # 例如 ubuntu24.04
dpkg --print-architecture                      # amd64 或 arm64

在下载目录里安装:

sudo apt install ./wowtype_*.deb

apt 会顺带装上设置界面要用的 GTK 4 和 libadwaita(python3-gi、gir1.2-gtk-4.0、gir1.2-adw-1)。 加了 --no-install-recommends 的话不会装,打字不受影响,只是打不开设置界面。

0.3.3 及以前的版本,词库是单独的 wowtype-data-rime-ice 包。装新版时 apt 会自动把它删掉(文件由新包接管),不用管它。

Fedora

到 Releases 下载 wowtype-<版本>-1.fc<Fedora 版本>.<架构>.rpm(架构是 x86_64 或 aarch64,词库已经在包里),然后:

sudo dnf install ./wowtype-*.rpm
wowtype-config --add-to-group      # 把 WowType 加进 fcitx5 的输入法列表

dnf 会顺带装上 fcitx5 和设置界面要用的 PyGObject、GTK 4、libadwaita。 还没在用 fcitx5 的话,先 sudo dnf install fcitx5 fcitx5-configtool fcitx5-gtk fcitx5-qt fcitx5-autostart 并重新登录。

NixOS / Nix

仓库根目录有 flake.nix。在 NixOS 的 flake 配置里加上输入,再把 WowType 加进 fcitx5 的插件:

# flake.nix
inputs.wowtype = {
  url = "github:Gloridust/WowType/release";   # 跟正式版;想锁某一版写 github:Gloridust/WowType/v0.3.10
  inputs.nixpkgs.follows = "nixpkgs";         # 和系统用同一份 fcitx5
};

# configuration.nix(通过 specialArgs 把 inputs 传进来)
i18n.inputMethod = {
  enable = true;
  type = "fcitx5";
  fcitx5.addons = [ inputs.wowtype.packages.${pkgs.stdenv.hostPlatform.system}.default ];
};

nixos-rebuild switch 后重新登录,运行 wowtype-config --add-to-group(或在 Fcitx 5 配置里添加 WowType)。 也提供了 overlay:nixpkgs.overlays = [ inputs.wowtype.overlays.default ]; 之后用 pkgs.wowtype。 home-manager 的 i18n.inputMethod.fcitx5.addons 用法相同。 支持 x86_64 和 aarch64;升级:nix flake update wowtype 后再 nixos-rebuild switch。

方式二:从源码构建

其他发行版,或者想用最新代码:依赖、编译、词库生成、排障都在 docs/INSTALL.md。

第 3 步:把 WowType 加进输入法列表

  1. 重启 fcitx5:wowtype-config --restart-fcitx(或者注销再登录)。KDE Plasma Wayland 下不要用 fcitx5 -r -d:新起来的 fcitx5 拿不到 KWin 给的输入法连接,之后新打开的程序里打不了字
  2. 打开 Fcitx 5 配置(托盘图标右键 → 配置,或运行 fcitx5-configtool)
  3. 在右边「可用输入法」里取消勾选「仅显示当前语言」,搜索 WowType,点 ← 加到左边
  4. 关掉配置窗口,按 Ctrl+Space 切换到 WowType,打 nihao 试试

也可以从应用菜单打开 WowType 设置:「常规」页第一行会显示 WowType 有没有在输入法列表里,没有的话点「添加」就行。

重要:重启 fcitx5 以后,Chrome、VS Code、Slack、微信等 Chromium / Electron 程序要彻底退出再打开, 否则在它们里面打不了中文。终端、GTK、Qt 程序会自动重新连上。

检查是否装好

wowtype-check --lexicon /usr/share/wowtype/lexicon.tsv    # 源码安装的用 ~/.local/share/wowtype/lexicon.tsv
wowtype-show  --lexicon /usr/share/wowtype/lexicon.tsv nihao
# nihao: 1.你好词 2.拟好词 ...

wowtype-show 和插件用的是同一个引擎、同样的配置,打出来的候选应该和输入法里一样。

使用

更多输入示例见 docs/USAGE.md。

按键 作用
空格 上屏第一个(或光标所在的)候选
1–9 上屏对应的候选
← → 在候选之间移动光标(跨页时跟着翻页,到了第一个、最后一个就停住)
↓ 展开候选面板(6 列,像微信输入法),在面板里用方向键挪、空格或 1–6 选;第一行按 ↑ 或 Esc 收起
↑、- =、PgUp PgDn 翻页;设置「常规 → 候选词 → 翻页键」还能打开 [ ]、, .、Shift+Tab Tab(翻到头时这些键不当标点上屏)。fcitx5 全局设置里配的翻页、移动候选热键也认
方向键的另一种用法 设置「常规 → 候选词 → 方向键」选「左右键移动光标」:↑ ↓ 选词,← → 在打了一半的拼音里移动光标改字(打的字母插在光标处,退格删光标前一个,Home End Delete 也管用),翻页用 PgUp PgDn 和翻页键。竖排时上下键本来就选词,这一项只改左右键
回车 把打的字母原样上屏
Esc 清空正在打的内容
点到别处、换窗口 Linux 上和 Esc 一样丢掉打到一半的,文档里不会留下 ni'hao 这样的拼音(想留字母就先按回车);macOS 上把打的字母原样上屏,和回车一样
退格 选过词时先撤销最后一次选词(拼音回到编辑区);没有选词时删一个字母
Ctrl+Delete 忘掉光标所在的候选:学错的词(比如一段一段选出来、选一次就记住的词)从用户词库里删掉,选词记录也清掉;词库里本来就有的词回到原来的位置。正在打的拼音不动,候选马上刷新。Ctrl+退格、Shift+Delete 也行(Mac 上按 Control+Delete)。设置里加的自定义词不受影响
' 分隔音节,比如 xi'an → 西安
[ ] 以词定字:只上屏光标处候选的第一个、最后一个字(nihao [ → 你);设置里能关,翻页键设成 [ ] 时是翻页
Super + . 表情面板:打拼音或英文搜 emoji 和符号,见下
单按 Shift 切到英文(字母、半角标点直接上屏),再按一下回中文;打了一半的字母原样上屏。左右 Shift 都行,设置里能改成只用一边或关掉。设置好互译后是 中 → 英 → 译 → 中(设了互译的快捷键时只切中英)。两个平台各自还有别的切法,见中英文切换。要是按 Shift 只在 WowType 和 en 之间来回,见下面
右 Alt 语音输入,见下
v + 空格 工具栏:剪贴板历史、常用语、符号、表情(数字键选,退格返回,Esc 关闭),见 docs/CONFIG.md

编辑区自动分音节:打 hengxiang 显示 heng'xiang,按第一个候选的切法分;打了一半、简拼、按错键也分(zhong'g、b'j'd'x)。 显示的还是你打的字母,回车上屏时不带隔音符。英文候选在第一位时不分。

长句可以分段上屏:打完一整句,候选里除了整句,还有它的前半截(比如「我今天晚上要」)。 选了前半截就只上屏这一段,剩下的拼音留着继续选。

五笔

在「WowType 设置 → 输入 → 输入方案」里选「五笔输入」(86 版)。打的字母就是五笔码,最多四码:

中英文切换

两个平台的习惯不一样,默认跟着各自的习惯走,哪个应用里都至少有一种切法管用:

Linux macOS
系统自己的 Ctrl + 空格 在 WowType 和英文键盘之间切(fcitx5 的「切换启用/禁用输入法」) 按 中/英 键(大写锁定键)在 WowType 和 ABC 之间切:在「系统设置 → 键盘 → 文字输入 → 输入法 → 编辑…」里打开「使用“中/英”键切换“ABC”输入法」,设置「输入」页有按钮直接打开键盘设置。不经过输入法,所有应用里都管用
单按 Shift 默认开着:WowType 自己的英文(字母直接上屏,不用换输入法) 默认开着,和搜狗、微信输入法一样。个别应用(比如一些用 Electron 做的)里有时不灵,用 中/英 键或下面的快捷键
另设一个切换键 设置「输入」页选,比如 Ctrl + Shift + 空格;默认不用 同左(Control + Shift + 空格)
互译的快捷键 设置「输入」页选,比如 Ctrl + Shift + Y:进「译」,再按回到原来的模式;设了以后单按 Shift 只切中英 同左(Control + Shift + Y)

设置文件里的键名两端一样(ShiftToggle、ToggleKey、TranslateModeKey,见 docs/CONFIG.md)。系统自己的快捷键(fcitx5 的、macOS 的)先处理,设成它们 WowType 收不到。

Shift 被 fcitx5 占了

fcitx5 默认用左 Shift「临时切换输入法」(切到 en 键盘),这时左 Shift 到不了 WowType:按它只在 WowType 和 en 之间来回,切不到英文和「译」。 右 Shift 不受影响。想左 Shift 也给 WowType 用,打开 WowType 设置「输入」页的 Shift 只给 WowType 用(只在有冲突时出现): 它从 fcitx5 的快捷键里去掉单按的 Shift,之后切别的输入法用 Ctrl + 空格;关掉就原样还给 fcitx5。 fcitx5 的配置文件写不了时(比如 NixOS 用 Home Manager 配 fcitx5,~/.config/fcitx5 是只读的),开关下面会提示「只在这次有效」,这时要在 Nix 配置里写,见 NixOS 安装说明。

用命令切中英文(vim 等)

WowType 在会话总线上登记了 org.wowtype.Input,外部命令可以直接切 WowType 自己的中 / 英 / 译,不用切到别的输入法(切到 en 键盘的话语音输入就用不了了):

busctl --user call org.wowtype.Input /org/wowtype/Input org.wowtype.Input1 SetMode s en

模式可以是 zh、en、translate(配置了互译时)、toggle(中英之间切),返回切完以后的模式;查现在的模式用 Mode。 neovim 里退出插入模式切英文、回到插入模式切回原来的模式:

local mode = "zh"
local function wowtype(args) return vim.fn.system("busctl --user call org.wowtype.Input /org/wowtype/Input org.wowtype.Input1 " .. args) end
vim.api.nvim_create_autocmd("InsertLeave", { callback = function()
  mode = wowtype("Mode"):match('"(%a+)"') or mode
  wowtype("SetMode s en")
end })
vim.api.nvim_create_autocmd("InsertEnter", { callback = function() wowtype("SetMode s " .. mode) end })

切的是最近用过的输入框(vim 所在的终端),不弹「中 / 英」提示。

中文标点自动转全角(, → ,? → ?,^ → ……,_ → ——,$ → ¥,` → ·,{ } → 「」),引号左右交替(" → “ ”,' → ‘ ’),数字后面的符号保持英文(3.14、20:22、3,000、50%);设置「输入 → 标点样式」可以改成半角(英文标点)。/、+、=、@、#、%、&、* 这类符号原样上屏;打拼音途中按它们,先上屏当前候选。

Emoji 和符号

打字时推荐:打的词有对应的 emoji 时,它排在第三个候选(kaixin → 开心、开行、😊),按 3 只上屏 emoji。 一句话以这样的词结尾时,推荐的是「开心😊」这种,选了上屏整句再加 emoji(jintianhaokaixin → 今天好开心😊)。 只看两个字以上的词,「是」「好」这种单字不推荐。例外是数字字,后面跟按键 emoji,和手机输入法一样:ba → 把、吧、八、8️⃣,shi 里的「十」后面是 🔟。不想要可以在设置里关掉。

表情面板:按 Super + .(Windows 键 + 句号,和 Windows 上一样)打开,再按一次或 Esc 关闭。

快捷键可以在设置里换成 Ctrl + ;、Ctrl + Shift + E,或者不用。

语音输入

在 WowType 打字的地方(没在打拼音时):

识别用的是微信输入法的离线语音模型,在你的电脑上算,录音不上传。模型不随 WowType 分发, 要先在 WowType 设置的「语音」页点「下载」:从腾讯的服务器下载约 100MB(能取消,断了再点接着下), 解开后约 130MB,存在 ~/.local/share/wowtype/wtlocal/。下载好以后语音输入自动打开;没下载模型时语音输入的开关是灰的, 按右 Alt 只会提示你去设置里下载,不会自己下载。同一页可以删掉模型(空出空间,语音输入随之关闭)。 模型载入后常驻内存,约 150MB。

不方便开设置界面(比如远程、NixOS 配置脚本)时用命令行:wowtype-config --install-voice-model 下载并打开语音输入 (也接受已经下载好的语音包路径),wowtype-config --remove-voice-model 删掉并关闭。

换语音键(右 Ctrl、菜单键、F8–F10)或者关掉语音,在 WowType 设置的「语音」页里改。

macOS 上一样用,语音键是右 Option(也能换成右 Control、F8–F10):在设置窗口的「语音」页下载模型 (和 Linux 同一个包,存在 ~/Library/Application Support/WowType/wtlocal/),第一次说话时允许 WowType 使用麦克风。 提示显示在候选框里(🎙 和字符画的波形)。

按住右 Alt 说话:光标变成声波,下面是正在听、离线和实时波形

互译

在 WowType 设置的「翻译」页里选个服务商(或者填任何 OpenAI 格式的接口)、填 Key 和模型,打开「互译」。 之后单按 Shift 就在 中 → 英 → 译 之间切换;也可以在「输入」页设一个互译的快捷键(比如 Ctrl + Shift + Y),按它进出「译」,单按 Shift 就只切中英:

翻译要等服务回话,挑又小又快的模型(各家的 mini、flash、turbo 版);设置里的「测试连接」会显示一次要多久。详见 docs/CONFIG.md。

不想联网,可以用「翻译」页默认的「本地模型(离线)」:点「下载」获取 HY-MT 1.5 1.8B(1.13 GB),跑模型用的 llama-server 系统里没有时会一起下载(约 22 MB),不用另外装东西。 第一次翻译时才载入,闲置 5 分钟释放内存。模型是腾讯混元社区许可,不适用于欧盟、英国和韩国,WowType 不分发它,见 本地模型。

设置

从应用菜单打开 WowType 设置(或者运行 wowtype-config)。改完立刻生效,不用重启 fcitx5。

WowType 设置的输入页:拼音输入或双拼输入、双拼方案、单按 Shift 切换中英文、模糊音、按错键纠正、繁体字
输入
全拼还是双拼(7 种方案)、Shift 切英文、模糊音、纠错、繁体
WowType 设置的自定义词页:输入词后拼音自动填好,下面是已经加过的词,右上角能导入导出
自定义词
填上词,拼音自动查好
WowType 设置的语音页:语音输入开关、语音键选右 Alt、识别模型已下载
语音
开关、换语音键
WowType 设置的更新页:有新版本 0.3.5,下载并安装按钮,下面是更新内容
更新
有新版本发通知,点一下装好
页面 能改什么
常规 候选排列(横排 / 竖排)、每页个数(3–9)、WowType 绿色主题(见主题)、候选字号。还会检查 WowType 有没有加进 fcitx5 的输入法列表,没有的话一键添加;底下的「帮助」能导出日志
输入 词库(默认雾凇,可下载切换到万象)、输入方案(拼音、双拼、五笔)、双拼方案(自然码、小鹤、微软、搜狗、智能 ABC、紫光、拼音加加)、五笔的四码唯一自动上屏和编码提示、单按哪个 Shift 切中英文(和 fcitx5 抢 Shift 时提示并能一键让出)、另设一个切换中英文的快捷键、互译的快捷键、模糊音(16 组分别开关:z=zh、c=ch、s=sh、n=l、f=h、r=l、an=ang、an=ai、ian=iang、uan=uang、huang=wang、en=eng、eng=ong、in=ing、un=ong、un=iong)、按错键自动纠正、繁体字、日期时间、计算器、v + 空格工具栏、剪贴板历史、中英文之间自动加空格、分号引号选第 2/3 个候选
表情 打字时推荐 emoji、表情面板快捷键
语音 下载 / 删除识别模型(有进度、能取消);下载好模型后才能打开语音输入;语音键(右 Alt / 右 Ctrl / 菜单键 / F8–F10)、识别结果同时复制到剪贴板
翻译 互译开关、翻成哪种语言、正式语气;用什么翻译:本地模型(默认,下载、闲置释放)或自定义翻译服务(服务商、地址、Key、模型、测试连接)
自定义词 人名、公司名、常用的长句。填上词,拼音自动查好(多音字记得检查一下);编码也可以是 mail 这类字母,词里写 \n 换行;可以搜索、导入导出,删错了能撤销
更新 检查新版本、看更新内容、下载并安装(见更新),自动检查的开关

各设置项对应的配置文件键名、环境变量、数据文件位置,见 docs/CONFIG.md。

右上角菜单里还有:用文本编辑器打开自定义词文件、导出日志、恢复默认设置(不影响自定义词和翻译服务)、关于。

主题

WowType 默认用自己的绿色主题:选中的词是图标里的那种绿,系统换深色模式时跟着换深色版。 第一次切到 WowType 时自动打开(只这一次;你在用别的 fcitx5 主题时不动)。 不喜欢的话在「WowType 设置 → 常规 → 外观」里关掉「WowType 绿色主题」,换回默认。 候选框的字嫌小,在同一个地方调「候选字号」(8–32 磅),改了马上生效:GNOME 上改的是 Input Method Panel 扩展的字体,别的桌面改的是 fcitx5 经典界面的字体,两边一起改。

WowType 浅色主题:白底细边框的候选框,第一个候选是绿底白字
浅色
WowType 深色主题:下键展开的候选面板,当前行是绿底
深色(按下键展开)

候选框由谁来画,决定了主题怎么生效:

主题文件在 themes/:themes/fcitx5/ 是经典界面主题,图片由 themes/src/*.svg 经 themes/render.sh 生成;themes/gnome-shell/ 是 GNOME 扩展。

更新

用 deb 包装的会自动检查更新:切到 WowType 时在后台查一下(最多一小时一次), 有新版本就弹一条通知,点开进「WowType 设置」的「更新」页,能看更新内容,点「下载并安装」, 按系统提示授权就装好了(下载后会对照 SHA256SUMS 校验),最后点「重启输入法」生效。 也可以重新运行一行安装命令。 不想自动检查,在「更新」页关掉「自动检查更新」(就是配置文件里的 CheckUpdate=False)。从源码装的只会提示新版本,要自己更新。

常见问题

现象 处理
输入法列表里找不到 WowType 添加时取消勾选「仅显示当前语言」;确认 /usr/share/fcitx5/inputmethod/wowtype.conf 存在;wowtype-config --restart-fcitx 重启
KDE Wayland 下已经开着的程序能打字,新打开的程序打不了 fcitx5 是用 fcitx5 -r 或托盘「重新启动」重启的,没经过 KWin。运行 wowtype-config --restart-fcitx,或注销再登录
某个程序里打不了中文,别的程序可以 重启 fcitx5 以后 Chrome / Electron 程序要彻底退出再打开
能打,但候选很少、很多常用词没有 没找到词库,用的是演示词库。用安装包装的话重装一遍(安装包自带词库);从源码装的把 lexicon.tsv 放进 ~/.local/share/wowtype/
第一次切到 WowType 时要等一两秒 正常:第一次要载入词库并生成快照,之后约 0.3 秒
按右 Alt 提示「没有语音模型」 到 WowType 设置的「语音」页点「下载」(或运行 wowtype-config --install-voice-model)
按右 Alt 提示「开不了麦克风」 在系统设置的「声音」里确认有输入设备;arecord -l 应该能列出麦克风
按 Super + . 打不开表情面板 只在 WowType 是当前输入法时有效;桌面或别的程序占了这个键的话,到设置里换成 Ctrl + ;
emoji 显示成方块 缺彩色 emoji 字体:sudo apt install fonts-noto-color-emoji
按右 Alt 没反应 只在 WowType 是当前输入法、没在打拼音时有效;有的键盘右边是 AltGr,到设置的「语音」页换个键
应用菜单里没有「WowType 设置」,或者打不开 缺 GTK 4 / libadwaita:sudo apt install python3-gi gir1.2-gtk-4.0 gir1.2-adw-1。在终端里运行 wowtype-config 能看到报错
设置里改了,打字时没变化 看看是不是设了 WOWTYPE_* 环境变量(env | grep WOWTYPE),它们优先于设置;fcitx5 没在运行时,设置会在它下次启动时生效
想看日志 ~/.local/state/wowtype/wowtype.log,或者导出日志
怎么确认 fcitx5 在工作 运行 fcitx5-diagnose,它会列出缺的环境变量和前端

出问题时导出日志

「WowType 设置 → 常规 → 帮助 → 导出日志」,或者右上角菜单里的「导出日志…」,会存一个 wowtype-log-时间.txt, 里面有版本、系统和桌面环境、fcitx5 的输入法列表和主题、WowType 的设置、数据文件在不在、WowType 和 fcitx5 最近的日志。 不含你打过的字,自定义词、自动学到的词和输入习惯只写条数;家目录写成 ~。导出后可以先打开看一眼再发。

没有图形界面时:wowtype-config --export-log(存到当前目录)或 wowtype-config --export-log -(打到终端)。

WowType 自己的日志在 ~/.local/state/wowtype/wowtype.log(满 512 KB 换一个,旧的留一份 .1)。

问题没解决,欢迎提 issue,把导出的日志拖进去。

工作原理

按键 ─> fcitx5 插件(C++)─C ABI─> 拼音引擎(Rust)
                                    ├─ 切音节:全拼 / 简拼 / 半成品 / 按错键
                                    ├─ 音节图上做束搜索,词频 + 语言模型 + 用户习惯打分
                                    └─ 组织候选:几个整句、句子前半截、词、单字

引擎用 Rust 写,编成静态库链进 fcitx5 插件。设计思路参考了微信输入法(WeType)3.0 的公开行为和引擎里的符号名, 但拼音引擎没有用它的任何代码、词库或模型;词库来自开源的雾凇拼音。 语音识别用的是微信输入法的离线模型:不随 WowType 分发,第一次用语音时从腾讯的服务器下载,推理代码来自 voicekey(纯 Rust)。实现细节、评测数字和调参方法见 docs/ENGINE.md。

参与开发

cargo test --workspace                     # Rust 测试(需要 libasound2-dev,语音守护进程还要 libx11-dev libxkbcommon-dev)
./scripts/abi-smoke.sh                     # C 接口冒烟测试
scripts/addon-test.sh ~/.local/share/wowtype/lexicon.tsv ~/.local/share/wowtype/english.txt
                                           # 插件按键测试:起一个私有的 fcitx5,不影响你正在用的输入法
WOWTYPE_VOICE_WAV=说的话.wav WOWTYPE_VOICE_EXPECT=期望的字 scripts/addon-test.sh ...
                                           # 加跑语音用例:用 WAV 代替麦克风,要先下载好语音模型
                                           # (不给 WAV 时跑「没有模型按右 Alt 只提示」)

改了排序,用 wowtype-eval 在几百个用例上对比改前改后(用法见 docs/ENGINE.md)。 推送 v* 标签会自动编译各发行版的安装包并发布到 Releases。

目录 内容
core/ 拼音引擎和 C 接口
fcitx5-addon/ fcitx5 插件
settings/ 设置界面 wowtype-config(Python、GTK 4、libadwaita)
voice/ 语音输入:热键状态机、麦克风采集、微信离线模型推理(插件通过 core/src/voice_ffi.rs 调用)
voice-daemon/ 不依赖输入法的语音守护进程(X11,实验性,没进安装包)
tools/ 词库转换、评测用例生成
docs/ 引擎细节、体验审查、接手指南、语音、数据格式

更多文档

致谢

许可证

代码按 MIT 或 Apache-2.0 双许可证发布,任选其一。安装包里的词库数据遵循 rime-ice 的 GPL-3.0(词频另融进了 Tatoeba 句子统计出的词频,Tatoeba 句子是 CC BY 2.0 FR,署名见 DATA-SOURCE.txt),五笔码表遵循 rime-wubi 的 LGPL-3.0,可选的万象词库包遵循 CC BY 4.0,词级语言模型 words.lm 是 CC BY-SA 4.0,编进程序里的 emoji 关键词来自 Unicode CLDR(Unicode License v3)。

WowType (Gloridust/WowType)

正在搜索数据库…

这是什么?这是一款用于 Linux 的中文拼音输入法,以 fcitx5 插件的形式运行。它能一次性补全长句,在你还在输入时就显示词语,并能识别错别字。README 中称它的使用感受类似微信输入法。
它是独立应用,还是其他框架的插件?它是 fcitx5(5.1 或更新版本)的插件,自带 GTK 设置窗口,可从应用菜单打开,也可以用 wowtype-config 命令打开。你需要在 fcitx5 的输入法列表中启用它。
怎么安装,怎么开始打字?你可以在 Ubuntu 24.04/26.04、Debian 13、Arch 或 Fedora 上运行一行安装脚本,也可以从 Releases 页面下载适用于你发行版的安装包(例如 wowtype amd64.deb),然后用 apt 安装。如果你之前用的是 IBus,请注销后重新登录。接着在 fcitx5 设置中添加 WowType,按 Ctrl+Space 切换到它,然后输入 'nihao' 进行测试。
安装前需要准备什么?需要一台 Linux x86-64 桌面,并安装 fcitx5 5.1 或更新版本。Ubuntu 22.04 自带的 fcitx5 为 5.0,版本太旧。包管理器会自动安装 fcitx5,以及设置窗口所需的 GTK 4 和 libadwaita 库。其他发行版需要从源代码编译。
装好之后有什么需要注意的吗?重启 fcitx5 后,Chrome、VS Code、Slack 以及其他基于 Chromium 或 Electron 的应用必须完全退出并重新打开,否则无法输入中文。另外,fcitx5 默认占用左 Shift 键,因此 WowType Input 页面提供了一个设置,可将 Shift 键交给 WowType 使用。
在 KDE、GNOME 和 X11 上能用吗?在 KDE Plasma 和 X11 桌面上可以用,此时候选窗口由 fcitx5 自己绘制。在 Wayland 下的 GNOME 上,需要安装 Input Method Panel 扩展,候选词才能显示。WowType 还附带一个用于配色的 GNOME 主题扩展。
我拼错拼音时,它的容错能力怎么样?容错性相当好:它能识别相邻按键的误按、调换位置的按键,以及多打或少打的字母,所以输入 zhognguo 仍然会得到 中国。此外,你还可以在设置中单独开启十二组模糊拼音。
我能在打字时把中文翻译成英文吗?可以。轻按 Shift 切换到翻译模式,照常输入中文,停顿片刻后,文字会被翻译成英文或其他 13 种支持的语言之一。翻译可以使用你配置的 OpenAI 格式 API,也可以使用可下载的 HY-MT 模型离线翻译。
语音输入是怎么工作的?按住右 Alt 键说话,松开即可提交文字;或者轻按一下,然后停止说话 1.5 秒即可完成。识别在你的电脑上使用微信输入法的离线模型进行,录音不会上传。
我打字时它会推荐表情符号吗?会。当输入的词有对应的表情符号时,该表情会作为第三个候选项出现,例如输入“开心”会给出 😊。按 Super + . 可以打开表情选择器,用拼音或英文搜索,例如输入 xiao 可以找到 😂。
作者
Gloridust
大小
6.8 MB
星标
1K
时长
12天
提交 · 90 天