Files
fcitx5-m3ui/README.zh-CN.md
T
justmeandClaude Sonnet 5.5 0804634dc1 Add Material 3 candidate window addon for Fcitx5
Fork of the classicui addon (Fcitx5 5.1.23) with a Material 3 look, spring
based animations and a right click action menu for candidates.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-19 21:58:54 +08:00

42 lines
1.6 KiB
Markdown

# 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)。