安装

仓库安装

Arch Linux (AUR)

yay -S fcitx5-vinput-bin

Fedora (COPR)

sudo dnf copr enable xifan/fcitx5-vinput-bin
sudo dnf install fcitx5-vinput

Ubuntu 24.04 (PPA)

sudo add-apt-repository ppa:xifan233/ppa
sudo apt update
sudo apt install fcitx5-vinput

Nix (flake)

支持 x86_64-linux 和 aarch64-linux。可通过 Cachix 获取二进制缓存，构建 flake 时会自动使用预编译产物。

Home Manager 示例

将 fcitx5-vinput 添加为 flake input：

{
  description = "Your flake description";

  inputs = {
    nixpkgs.url = "github:nixos/nixpkgs?ref=nixos-unstable";
    home-manager.url = "github:nix-community/home-manager";
    home-manager.inputs.nixpkgs.follows = "nixpkgs";

    fcitx5-vinput = {
      url = "github:xifan2333/fcitx5-vinput";
    };
  };

  # 信任 fcitx5-vinput 的二进制缓存
  nixConfig = {
    extra-substituters = [ "https://fcitx5-vinput.cachix.org" ];
    extra-trusted-public-keys = [ "fcitx5-vinput.cachix.org-1:XpX3AA6+dDIX4qJhb1QM7sbTwX6/qSlGvW8Z5NK6XdU=" ];
  };

  outputs =
    {
      self,
      nixpkgs,
      nixos-hardware,
      home-manager,
      ...
    }@inputs:
    let
      system = "x86_64-linux";
      pkgs = import nixpkgs {
        inherit system;
      };
      homeManagerConfiguration = home-manager.lib.homeManagerConfiguration;
    in
    {
      homeConfigurations = {
        "kakapt@krypton" = homeManagerConfiguration {
          inherit pkgs;
          modules = [ ./your_home_module.nix ];
          extraSpecialArgs = inputs;
        };
      };
    };
}

然后在 Fcitx5 addon wrapper 中引入 fcitx5-vinput：

{ pkgs, ... }@inputs:
let
  fcitx5-vinput = inputs.fcitx5-vinput.packages."${pkgs.stdenv.hostPlatform.system}".default;
in
{
  home.packages = [
    fcitx5-vinput
  ];

  i18n.inputMethod = {
    enable = true;
    type = "fcitx5";
    fcitx5.addons = with pkgs; [
      fcitx5-vinput
    ];
  };
}

Flatpak

flatpak remote-add --if-not-exists xifan https://xifan2333.github.io/flatpak-auto/xifan.flatpakrepo
flatpak install https://xifan2333.github.io/flatpak-auto/refs/org.fcitx.Fcitx5.Addon.Vinput.flatpakref

安装后需要授予额外权限并重启 Fcitx5：

flatpak override --user --filesystem=xdg-run/pipewire-0 org.fcitx.Fcitx5
flatpak override --user --filesystem=xdg-config/systemd:create org.fcitx.Fcitx5
flatpak kill org.fcitx.Fcitx5

本地安装

下载对应发行版的安装包，直接安装。

正在获取最新版本…

下载后安装：

• .deb：sudo dpkg -i <文件>.deb && sudo apt-get install -f
• .rpm：sudo dnf install <文件>.rpm
• .pkg.tar.zst：sudo pacman -U <文件>.pkg.tar.zst
• .flatpak：flatpak install <文件>.flatpak

源码构建

依赖： cmake、fcitx5、pipewire、libcurl、nlohmann-json、CLI11、Qt6

sudo bash scripts/build-sherpa-onnx.sh
cmake --preset release-clang-mold
cmake --build --preset release-clang-mold
sudo cmake --install build

也可以用 just：

just sherpa
just configure-release
just build
sudo just install

第一步会下载本地构建和发布打包所需的预编译 sherpa-onnx 运行时。运行时库随安装产物一起捆绑，不需要单独安装系统包依赖。

源码构建默认使用 Fcitx5 系统前缀（/usr），插件会安装到 Fcitx5 扫描的目录下。