fcitx5-wetypex

项目概述

在 Linux 上想继续用微信输入法的词库、云候选与设备同步时，WeTypeX 提供了一套挂在 Fcitx5 上的兼容层。它从官方 macOS 安装包中提取输入核心与词典，用一个 Mach-O ABI 兼容宿主把原本只面向 Darwin 的接口接到 Linux，再把网络传输换成系统 TLS 与 WebSocket 实现。适配代码由 C++ 编写，输入宿主与账户命令运行在 Bubblewrap 沙箱中，目前只在 Arch Linux、KDE Plasma 与 Wayland 的组合上验证过。

项目	内容
平台	Linux x86_64
宿主	Fcitx5
输入核心	官方 2.2.3.657
实现语言	C++ / CMake
许可	MIT

输入核心与词典仍来自官方包，WeTypeX 只补上 Linux 与 Fcitx5 之间缺失的那一层。

支持的宿主

• Fcitx5：以原生 input method 插件加载，候选、预编辑、分页与选词全部交给 Fcitx5
• Fcitx5 配置页：快捷键、候选数量、主题与模糊音通过 ExternalOption 扩展并入输入法配置
• NixOS：flake 提供 packages.x86_64-linux.fcitx5-wetypex 与同名 default 别名
• 旧版框架：Ubuntu 20.04 等 glibc 2.31 系统需 Fcitx5 5.0.14+、fcitx5-qt 5.0.10+ 与 LibIME 1.0.11+

主要功能

• 拼音输入：全拼、双拼与五笔共用官方 2.2.3.657 输入核心和词典，候选顺序与原版一致
• 云候选合并：本地候选与桌面云候选合成一个列表，云端新增项在候选里单独标记
• 跨设备剪贴板：文字与原始 PNG 图片双向同步，设备用官方六位匹配码配对
• 语音输入：从 PipeWire 或 PulseAudio 流式采集，复用原版引擎的 VAD、识别与实时预编辑
• 问 AI：没有拼音组合时按 =，用光标前的文本发起在线问答，也可开独立窗口
• 隔空传送：官方传输码与二维码，走原版 Flurry 局域网和 WXP2P 直连或中继通道
• V 模式工具栏：V 唤出计算、剪贴板、常用语与符号面板，计算结果可直接上屏
• 微信表情：只在识别到微信客户端时推荐，候选显示安装包内的原图
• 词库与常用语：本地持久化保存，设备组同步器已接入

安装与启用

1. Arch Linux 执行 sudo pacman -U ./fcitx5-wetypex-2.2.3.657-16-x86_64.pkg.tar.zst，或用 paru -S fcitx5-wetypex 从 AUR 安装
2. Debian 与 Ubuntu 执行 sudo apt install ./fcitx5-wetypex_2.2.3.657-16_amd64.deb，glibc 2.31 的老系统改用 fcitx5-wetypex-legacy 包
3. Fedora 执行 sudo dnf install ./fcitx5-wetypex-2.2.3.657-16.x86_64.rpm
4. 执行 fcitx5-wetypex-setup --archive /path/to/WeType_2.2.3_657.zip 提取官方运行时，或加 --download --accept-upstream-license 交给脚本下载
5. 执行 fcitx5-wetypex-setup --check，确认 manifest.txt 与 image.macho 都已生成
6. 在 Fcitx5 配置工具里把 WeTypeX 加入输入法列表，再执行 fcitx5-remote -r 重新加载
7. NixOS 把本 flake 作为 inputs.wetypex 引入，并将 wetypex.packages.${pkgs.stdenv.hostPlatform.system}.fcitx5-wetypex 加进 i18n.inputMethod.fcitx5.addons

快捷键与日常操作

• Shift：切换中英文，默认开启
• Ctrl + .：切换中英文标点
• - 与 =：拼音组合时向上、向下翻页
• V：唤出快捷工具栏，再按 V、Esc 或点关闭退出
• Ctrl + Win：按住说话、松开结束；Ctrl + Win + Shift 改为点击启停语音
• fcitx5-wetypex-account：group-info 看设备组、pairing-code 生成六位码、sync-now 立即同步

数据目录

内容	默认位置
原版核心与词典	~/.local/share/fcitx5-wetypex/runtime
账户身份与业务状态	~/.local/share/fcitx5-wetypex/account
用户词库、常用语与同步状态	~/.local/share/fcitx5-wetypex/state
界面资源	~/.local/share/fcitx5-wetypex/ui
WeTypeX 配置	~/.config/fcitx5/wetypex.json

卸载系统软件包不会自动删除这些目录。需要重新配对时先备份，再删除 account 与 state/sync-state.json，普通升级不要动它们。

注意事项

• 需官方运行时：安装包只带适配层，输入核心与词典仍从 WeType_2.2.3_657.zip 提取，版本不符会导致核心启动失败
• 沙箱边界：密码输入上下文不会触发输入核心、剪贴板记录与 AI，浏览器里标记敏感的普通输入仍可使用输入法
• 测试范围：仅在 Arch Linux 加 KDE Plasma 的 Wayland 会话验证过，其他发行版需自行对齐库版本
• 构建期开关：Nix 的 enableAI、enableVoice、enableLayerShell、enableWeTypeTheme 四个布尔参数在构建时固定，关闭后无法从界面重新打开
• 偏好文件限制：defaultSettings 序列化后不得超过 16 KiB，初始化生成的文件权限为 0600，已有文件与符号链接不会被覆盖