# fcitx5-m3ui

给 [Fcitx5](https://github.com/fcitx/fcitx5) 用的 Material 3 风格候选框,
以界面插件(`m3ui`)的形式替换 `classicui`。

[English](README.md)

## 特性

- Material 3 圆角面板,深色/浅色主题跟随系统。
- 弹簧动画:候选框带轻微回弹滑入并淡入,高亮块在候选词之间滑动,刚度和阻尼可调。
- 在候选词上右键打开动作菜单,内容取决于输入法提供的动作,拼音有
  "忘记候选词 / 置顶为自定义短语 / 从自定义短语中删除"。
- Wayland 和 X11(Xwayland)输入上下文都支持,定位和鼠标处理沿用 `classicui`。
- 可选的 KWin 辅助脚本:只缩短候选框自己的 KWin 淡出时间。

## 状态

个人项目,只在 Fedora 44、KDE Plasma 6.7(Wayland)、NVIDIA 显卡、
Fcitx5 5.1.23、拼音引擎上用过,构建脚本没有在其他环境跑过。

本插件是 `classicui` 的分支,需要在 Fcitx5 源码树内构建(Fcitx5 的 Wayland 协议封装
不包含在 `fcitx5-devel` 里),构建用的源码版本必须和已安装的 Fcitx5 一致。

没有自己的淡出动画:Wayland 下面板无内容时窗口会被立刻销毁。

## 构建与使用

依赖安装命令、`scripts/build.sh`、`scripts/install.sh` 以及启动方式见
[English README](README.md)。启动命令:

```
FCITX_ADDON_DIRS=$HOME/.local/m3ui/lib64/fcitx5:/usr/lib64/fcitx5 fcitx5 -r -u m3ui
```

想回到原版界面运行 `fcitx5 -r`。配置在 `~/.config/fcitx5/conf/m3ui.conf`,
示例见 [config/m3ui.conf.example](config/m3ui.conf.example)。

## 许可证

LGPL-2.1-or-later,见 [NOTICE.md](NOTICE.md)。