在 Linux 上通过 Fcitx5 使用微信输入法的兼容项目。

目前仅在 Arch Linux、KDE Plasma 和 Wayland 上进行过测试。各项能力的支持范围见功能状态。

WeTypeX 安装程序从官方包中提取输入核心与词典，生成固定地址的 Linux 可加载映像；运行时由一个小型 Mach-O ABI 兼容宿主提供原版核心实际使用的 Darwin C/C++ 接口，并将网络传输接到 Linux 的 TLS 与 WebSocket 实现。

应用程序
   │ Fcitx5 input context
   ▼
WeTypeX 插件 ────────── 候选、预编辑、快捷键、剪贴板
   │ 私有管道
   ▼
受限引擎宿主 ───────── 原版输入核心、词典与 Flurry/WXP2P 文件通道
   │                    │
   │ Linux ABI 适配      └─ 用户词库 / 常用语
   ▼
原版业务服务 ────────── 云候选、配对、同步、语音、AI

输入宿主和账户命令运行在 Bubblewrap 沙箱中。密码输入上下文不会触发原版核心、剪贴板记录或 AI；浏览器标记为敏感的普通输入仍可使用输入法。详细边界见架构说明。

从 GitHub Releases 下载软件包：

sudo pacman -U ./fcitx5-wetypex-2.2.3.657-16-x86_64.pkg.tar.zst

也可以从 AUR 安装：

paru -S fcitx5-wetypex

安装完成后，Pacman 会在终端中打印首次设置步骤。

发布包依赖 Fcitx5、LibIME、Qt 6、Bubblewrap、PipeWire、FFmpeg、libc++、curl、json-c、libnotify 和 Polkit；微信表情原图显示还使用 fontconfig、fontTools 和 Pillow。Pacman 会从已配置的软件仓库解析依赖。

sudo apt install ./fcitx5-wetypex_2.2.3.657-16_amd64.deb

从修订 8 起，标准 deb 使用 Ubuntu 22.04 的 glibc 2.35、Qt5 和稳定版 Fcitx5 构建，可用于 Ubuntu 22.04、24.04、26.04 及 Debian 12/13。LLVM unwinder 已显式列入依赖，Ubuntu 26.04 会安装 llvm-libunwind1，避免核心因缺少 libunwind.so.1 无法启动。

Ubuntu 20.04 和 glibc 2.31 的系统使用独立的 fcitx5-wetypex-legacy_..._amd64.deb。安装前需要稳定版 Fcitx5 5.0.14+、fcitx5-qt 5.0.10+ 与 LibIME 1.0.11+；20.04 原生仓库中的 0.0~git 预览版使用不同 ABI，不能直接加载此插件。可按 Fcitx 上游安装说明 安装稳定框架。旧系统包私有静态包含 OpenSSL 3，不替换系统的 OpenSSL 1.1。语音可使用现有的 PulseAudio 或 pipewire-pulse；现代 PipeWire 使用 pw-record 原始 PCM，旧版或缺少该工具时自动选择 parec，再回退到 FFmpeg 的 PulseAudio 输入。

源码构建支持 CMake 3.16、C++17、Python 3.8、Qt5.12+，也可自动使用完整的 Qt6 开发环境。用 -DWETYPE_QT_VERSION=5 或 6 指定界面工具链。配置插件采用发行版的 Fcitx5 安装目录；不同 Qt ABI 的配置入口按构建环境提供。完整设置始终可通过 fcitx5-wetypex-settings 打开。

sudo dnf install ./fcitx5-wetypex-2.2.3.657-16.x86_64.rpm

FFmpeg 及部分桌面依赖可能来自发行版启用的附加软件仓库。

RPM 以 Fedora 40 为构建基线。Arch 是滚动发行版，发布包跟随当前仓库；旧系统应保持库版本一致或在对应环境从源码构建。

Flake 提供 packages.x86_64-linux.fcitx5-wetypex 和同一包的 default 别名。 在现有系统 flake 中加入 input，并跟随系统的 Nixpkgs，以匹配 Fcitx5 插件 ABI：

inputs.wetypex = {
  url = "github:panxuc/fcitx5-wetypex";
  inputs.nixpkgs.follows = "nixpkgs";
};

在 outputs 中接收 wetypex，然后把模块加入现有 nixosSystem.modules：

outputs = { nixpkgs, wetypex, ... }: {
  nixosConfigurations.YOUR_HOST = nixpkgs.lib.nixosSystem {
    # 保留已有的 system、hardware-configuration.nix 和其他 modules。
    modules = [
      ({ pkgs, ... }: {
        i18n.inputMethod = {
          enable = true;
          type = "fcitx5";
          fcitx5.addons = [
            wetypex.packages.${pkgs.stdenv.hostPlatform.system}.fcitx5-wetypex
          ];
        };
      })
    ];
  };
};

Nix 包支持通过 .override 调整以下参数，四个布尔开关默认均为 true：

例如，在 fcitx5.addons 中使用：

(wetypex.packages.${pkgs.stdenv.hostPlatform.system}.fcitx5-wetypex.override {
  enableAI = false;
  enableVoice = false;
  enableLayerShell = true;
  enableWeTypeTheme = false;
  defaultSettings = {
    page_size = 7;
    vertical = true;
  };
})

这些布尔参数在构建时生效，关闭的功能不能通过界面或已有偏好重新启用；修改后需重新构建、应用配置并重启 Fcitx5。关闭功能时保留其已有偏好，便于之后重新启用。设备同步与云候选不受这些开关控制。

defaultSettings 转换为 UTF-8 JSON，大小不得超过输入法支持的 16 KiB。初始化时以原子方式创建权限为 0600 的偏好文件；已有文件或符号链接不会覆盖、补写，之后仍可在界面修改。配置目录只读等原因导致无法创建文件时，输入法继续读取包内默认值；保存失败会提示，不会阻断输入核心启动。字段名和字段类型由上游设置读取逻辑解释，这里不提供逐字段校验。默认值会进入 Nix store，适合非敏感偏好。

应用系统配置后，按下方“首次设置”准备原版运行时。Nix 构建只安装社区适配层，原版安装包和资源仍由用户在接受上游许可后自行初始化。

包的安装路径、动态库、证书和 Bubblewrap 沙箱已适配 Nix store；Nix 包由 flake 锁文件管理更新，内置发行版更新器关闭。更新 input 后重新构建系统即可升级。

包会为录音和设置界面提供所需工具路径，并在沙箱中提供 DNS 配置和时区数据，不依赖 FHS 的 /usr 布局。CI 同时检查 flake 构建和源码包中的 Nix 入口；正式源码压缩包也包含 flake.nix、锁文件及 nix/。

在源码仓库中可单独运行 nix build .#fcitx5-wetypex。nix flake check 和 CI 会构建默认、全关闭、仅语音、仅 AI 四种组合，检查混合开关的兼容性。本 flake 仅提供 Linux x86_64 输出。

sudo tar --zstd -C / -xf ./fcitx5-wetypex-2.2.3.657-16-linux-x86_64.tar.zst

便携归档不经过软件包管理器解析依赖，更适合已经准备好运行环境的系统。

cmake -S . -B build \
  -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_INSTALL_PREFIX=/usr
cmake --build build --parallel
sudo cmake --install build

构建要求 CMake 3.24、Clang、C++20 编译器以及上述依赖的开发文件。完整依赖和打包流程见发行与打包。

准备官方运行时有两种方式。

使用已经下载的官方安装包：

固定版本的官方下载地址：WeType_2.2.3_657.zip。

fcitx5-wetypex-setup --archive /path/to/WeType_2.2.3_657.zip

明确接受上游许可后，从脚本内固定的腾讯地址下载：

fcitx5-wetypex-setup --download --accept-upstream-license

检查提取结果：

fcitx5-wetypex-setup --check

随后打开 Fcitx5 配置工具，将 WeTypeX 添加到当前输入法列表。若桌面会话已经运行 Fcitx5，可执行：

fcitx5-remote -r

配置、原版运行时、配对身份、词库和同步状态都位于用户目录，与 /usr 下的软件文件分离；正常升级不会重建账户。

fcitx5-wetypex-settings          # 打开完整设置窗口
fcitx5-wetypex-setup --check     # 检查原版运行时
fcitx5-wetypex-account group-info # 查看设备组和同步状态
fcitx5-wetypex-account pairing-code # 生成新的六位匹配码
fcitx5-wetypex-account network-info # 检查实际 libcurl 与 WS/WSS 支持
fcitx5-wetypex-account sync-now     # 请求个人词库与常用语同步

常用操作：

• Shift：切换中英文，默认开启。
• Ctrl + .：切换中英文标点。
• - / =：组合输入时向上、向下翻页。
• =：没有拼音组合时，使用光标前的文本打开问 AI。
• V：打开快捷工具栏，再按 V、Esc 或点击“关闭”结束；点击剪贴板、常用语或符号后，内容会插入原输入框。选择“计算”后直接输入表达式，按空格或回车选取结果。
• Ctrl + Win + Shift：启动或结束语音输入；Ctrl + Win 按住说话、松开结束。录音时可用空格结束、Enter 提交当前结果、Esc 取消，详见流式语音输入。
• Ctrl + Win：按住说话，松开结束。

外观中的“候选序号样式”可选择微信风格或 Fcitx 默认标签。Wayland 下的 V 工具栏优先使用 layer-shell 保持原输入框焦点，并尽量限制在当前窗口范围内，避免点击时焦点落到下方窗口；构建依赖与兼容回退见故障排查。Hyprland 0.55+ 的窗口规则与 app_id 配置见Hyprland 兼容。

所有快捷键、输入方式、候选数量、主题、模糊音和同步开关也会出现在 Fcitx5 自带的输入法配置页中；同一页面提供完整设置、账号与同步入口，采用与 Fcitx5 拼音词典管理器相同的 ExternalOption 扩展机制。配置项说明见配置参考。

卸载系统软件包不会自动删除这些用户数据。需要重新配对时，可先备份后自行删除 account 与 state/sync-state.json；普通升级不应删除它们。

首先运行：

fcitx5-wetypex-setup --check
fcitx5-diagnose | less

常见问题：

• 看不到 WeTypeX：重新加载 Fcitx5，并用 fcitx5-diagnose 检查插件搜索路径。
• 核心启动失败：重新用固定版本官方包执行设置，检查 manifest.txt 和 image.macho 是否存在。
• 没有云候选：确认未开启单机模式，并检查设备身份是否已经建立。
• 语音没有结果：确认默认输入设备可用；旧版 PipeWire 可通过 parec 或 FFmpeg 使用现有 PulseAudio 接口。
• AI 窗口缺少图标：执行 fcitx5-wetypex-setup --archive ... --icons-only 重新提取原版界面资源。

更多诊断步骤见故障排查。

• 架构说明
• 功能状态
• 配置参考
• Linux 微信表情原图与应用识别
• 流式语音输入与诊断
• Hyprland 兼容
• 故障排查
• 发行与打包

提交问题时请附上桌面环境、显示协议、Fcitx5 版本和去除隐私信息后的日志。界面变更应注明参考平台与版本。具体要求见贡献指南和安全策略。

WeTypeX 自有适配代码使用 MIT License。libkqueue 保留其上游许可。原版程序、词典、模型、界面资源、服务和商标归各自权利人所有，不受本项目许可证覆盖；详见 NOTICE。

WeTypeX 不提供绕过账户验证、伪造同步状态或替代官方服务的实现。上游协议、接口或服务随时可能变化。