一个基于 fcitx5 框架的温州话输入法。使用沈克成先生的拼音方案。
代码基于 libime-jyutping 修改而来。
cmake -B build -S . \
-GNinja \
-DCMAKE_BUILD_TYPE=Release \
-DCMAKE_INSTALL_PREFIX=/usr \
-DCMAKE_INSTALL_LIBDIR=lib
cmake --build buildNightly Build 同时提供 Fcitx5-Wenzhounese-<构建号>-archlinux-x86_64.tar.zst 和 SHA256 校验文件。该包使用 Arch Linux x86_64 和 GCC 构建,包含温州话插件、私有共享库、词典、语言模型及翻译,使用标准 /usr 安装布局。
这不是跨发行版通用包,也不是可直接交给 pacman -U 的 Arch 软件包。使用前需安装 ABI 兼容的 Fcitx5、libime、fcitx5-chinese-addons、Boost 和 zstd;构建依赖的源码提交号及系统库版本记录在包内的 usr/share/doc/fcitx5-wenzhounese/build-info.json。其他发行版或较旧系统建议从源码构建。
先验证 SHA256,再解压到临时目录检查文件;确认依赖兼容后,将其中的 usr 目录内容安装到系统 /usr,然后重启 Fcitx5,在配置工具中添加温州话。手动安装不会纳入包管理器,更新或卸载时需按归档中的文件列表管理。
使用 fcitx5-windows 提供的 Core/libime SDK 独立构建,脚本位于本仓库的 scripts/build-windows.ps1,无需将输入法加入 Core 的构建目标。
Windows x64 插件可从 Nightly Build 下载,附带 SHA256 校验文件。将 ZIP 中的 wenzhounese 目录解压到 Core 安装目录的 plugins,或 %LOCALAPPDATA%/Fcitx5/plugins,然后重启服务并在 Settings 中添加温州话。
CI 使用 fcitx5-windows 的 master 构建匹配的 SDK,并验证打包后的插件能够加载和提交候选。包内的 manifest.json 记录插件和 Core SDK 的提交号,宿主需使用兼容版本。推送到 master 或手动运行 CI 会更新 Nightly Build;提交信息包含 !release 时跳过发布,PR 仅构建并上传 Actions artifact。
- CMake 3.27+、MSYS2 clang64,以及与 Core 相同的 ECM、gettext、Boost iostreams 和 zstd 等构建依赖。
- 启用插件加载的
fcitx5-windows源码及其工具链子模块,默认位于同级目录../fcitx5-windows。 - 与宿主匹配的 AMD64 Release Core/libime SDK。Windows 主仓库的统一构建脚本默认将其安装到
build/all/prefix,其中包含头文件、导入库、CMake package、模块公共接口和数据生成工具;仅有运行时 DLL 的部署目录不能代替 SDK。SDK 应保留在原安装位置使用。
在本仓库根目录的 Windows PowerShell 中运行:
./scripts/build-windows.ps1 -CorePrefix ../fcitx5-windows/build/all/prefix默认构建目录为本仓库的 build/windows,插件包生成在 build/windows/package。脚本只构建温州话引擎、私有库及其词库/模型,不重建 Core、libime 或 chinese-addons。
| 参数 | 用途 |
|---|---|
-CorePrefix |
必填,匹配的 Core/libime SDK 安装前缀 |
-WindowsSourceDirectory |
Windows 主仓库源码路径,默认 ../fcitx5-windows,用于读取通用 addon 工具链 |
-MSYS2Root |
MSYS2 根目录,默认 C:/msys64 |
-DependencyPrefix |
与 Core 构建相同的依赖前缀,默认 Windows 主仓库的 build/deps/clang64 |
-BuildRoot / -Prefix |
自定义构建目录和插件包输出目录 |
-SourceDirectory |
构建其他源码副本,默认本仓库根目录 |
-Jobs |
并行构建任务数,默认 6 |
-WhatIf |
预览构建目标,不创建文件或运行构建 |
如果 Windows 主仓库位于其他位置,可显式指定:
./scripts/build-windows.ps1 `
-WindowsSourceDirectory D:/src/fcitx5-windows `
-CorePrefix D:/src/fcitx5-windows/build/all/prefix `
-DependencyPrefix D:/src/fcitx5-windows/build/deps/clang64插件必须匹配 Core 的架构、Fcitx5/libime 版本及 Windows 补丁、Clang Windows GNU 工具链、libc++ 和 CRT,不能混用 MSVC 或 Linux/macOS 的二进制。插件复用宿主的公共运行库,不应覆盖 libFcitx5*.dll、libIMECore.dll 或 libc++.dll。
- 在输入法指示器菜单中选择
关闭服务。 - 将
build/windows/package中的bin、lib、share一起放入 Core 安装目录下的plugins/wenzhounese,或%LOCALAPPDATA%/Fcitx5/plugins/wenzhounese,保留目录结构。每个插件发布包使用独立目录,需要支持独立目录发现的新版 Core。 - 选择
重启服务,在 Settings 的输入法列表中添加温州话,然后使用Ctrl+Space或指示器切换。
主要运行时文件如下;标点依赖由宿主的 chinese-addons 提供:
plugins/wenzhounese/
bin/libIMEWenzhounese.dll
lib/fcitx5/libwenzhounese.dll
lib/libime/wenzhounese.lm
lib/libime/wenzhounese.lm.predict
share/fcitx5/addon/wenzhounese.conf
share/fcitx5/inputmethod/wenzhounese.conf
share/libime/wenzhounese.dict
share/locale/<语言>/LC_MESSAGES/fcitx5-wenzhounese.mo
更新或移除插件前同样先关闭服务,完成后重启。独立布局可替换或删除整个 plugins/wenzhounese 目录,用户配置和词库仍保存在原有用户数据目录。旧的共用布局仍兼容,但迁移时需要手动移除旧位置中属于温州话插件的文件,避免保留两份副本;不要删除其他插件的文件。详细的宿主搜索规则及通用验证工具见 Windows 主仓库的 docs/windows-plugins.md。
语言模型现在使用独立的 wenzhounese.lm / wenzhounese.lm.predict 文件名;升级时请同时安装新引擎和模型。
按照 Windows 主仓库 docs/windows-plugins.md 构建通用 addon_probe 并安装到隔离 Core 树的 bin 后,可从本仓库根目录验证生成的插件包:
$sdk = (Resolve-Path ../fcitx5-windows/build/all/prefix).Path.Replace('\', '/')
$plugin = (Resolve-Path ./build/windows/package).Path.Replace('\', '/')
& "$sdk/bin/addon_probe.exe" "$sdk" "$plugin" wenzhounese nyi验证自动发现时,将包安装到隔离 Core 树的 plugins/wenzhounese,再运行:
& "$sdk/bin/addon_probe.exe" "$sdk" --default wenzhounese nyi该检查覆盖输入法发现、DLL 加载、配置读取和候选提交,不启动 Pipe 服务或注册 TSF;真实 Windows 应用中的 TSF 输入仍需单独验收。
| 音标 | 拼音 | 例字 |
|---|---|---|
| [p] | b | 卜八不比贝 |
| [p'] | p | 匹片扑朴批 |
| [b] | bb | 休币办平白 |
| [m] | m | 万门马木毛 |
| [f] | f | 飞夫反分勿 |
| [v] | v | 万凡勿犯帆 |
| [t] | d | 丁刀万丹斗 |
| [t'] | t | 士天太叹他 |
| [d] | dd | 大队邓申田 |
| [n] | n | 人乃女有内 |
| [l] | l | 力历六厉龙 |
| [ts] | z | 几之己子井 |
| [ts'] | c | 厂七寸叉车 |
| [dz] | zz | 才臣尘池宅 |
| [s] | s | 三山尸水升 |
| [z] | ss | 十士才夕勺 |
| [ʨ] | j | 九巾久专中 |
| [ʨ'] | q | 千乞川犬区 |
| [ʥ] | jj | 丈及巨长仇 |
| [ȵ] | ny | 义女元世月 |
| [ɕ] | x | 小乡少手双 |
| [ʑ] | xx | 药从讼松扰 |
| [k] | g | 工个广戈介 |
| [k'] | k | 亏口开牙孔 |
| [g] | gg | 打犷矿何怀 |
| [ŋ] | ng | 眼唔二儿五 |
| [h] | h | 丰化风方夯 |
| [ɦ] | hh | 下亡也之凤 |
| [u] | u | 乌污鸣於挖 |
| [v] | v | 与卫互文为 |
| [i] | i | 一乙亿丫也 |
| [j] | y | 又丸已王云 |
| 音标 | 沈氏拼音 | 例字 |
|---|---|---|
| [a] | a | 乃三万山凡 |
| [ɛ] | ae | 行亭幸哀晏 |
| [ai] | ai | 一乙十七入 |
| [aŋ] | ang | 门仁分文心 |
| [au] | au | 愁兜斗么勾 |
| [ə] | e | 刀毛号讨考 |
| [e] | ee | 广才开代台 |
| [ei] | ei | 力夕飞支比 |
| [əŋ] | eng | 丁井升仍正 |
| [əu] | eu | 六左头奴丢 |
| [i] | i | 丈上千亿义 |
| [ia] | ia | 勺丫乌闪约 |
| [iɛ] | iae | 刁了小少打 |
| [iai] | iai | 乙入乞及击 |
| [iaŋ] | iang | 巾刃王仪斤 |
| [iau] | iau | 九又友仇右 |
| [iəu] | ieu | 手仇丑囚肉 |
| [ɿ] | ii | 吃处此基继 |
| [ioŋ] | iong | 弓云中勺风 |
| [o] | o | 八下么又马 |
| [ø] | oe | 寸歹刊末半 |
| [øy] | oev | 士夫父布戊 |
| [oŋ] | ong | 工丰公风孔 |
| [u] | u | 于卫夫无韦 |
| [uɔ] | uio | 广亡爪方巧 |
| [y] | ü | 女专犬巨月 |
| [yɔ] | üio | 王从凶双用 |
| [yo] | üo | 玉曲束局卓 |
项目中使用的字典文件来自 libpinyin, libime-jyutping, 和 rime-wenzhounese,并使用 GPLv3+ 协议发布。
语言模型沿用上游数据,源码文件为 data/wenzhounese.arpa。