← 返回系统组成地图
输入与显示是两组并行能力。输入侧，Fcitx 5 提供框架与应用通信，Chinese Addons 提供中文转换引擎。显示侧，brightnessctl、ddcutil 与 hyprsunset 分别对应背光设备、兼容显示器硬件控制和软件色温。
输入一句中文： 键盘输入进入当前应用与输入法集成路径，Fcitx 调用选定的中文引擎组织候选词，用户确认后将文字提交给应用。候选词不合适、无法切换引擎、只有一个应用不能输入，是不同环节的问题；键盘布局本身不是中文转换引擎。
调整显示效果： 笔记本屏幕可能通过 brightnessctl 使用背光接口，外接显示器可能通过 ddcutil 使用 DDC/CI；实际取决于硬件与连接。hyprsunset 则配合 Hyprland 调整色温，这不等于降低物理背光。
所以三个显示工具不是逐层处理同一亮度值的流水线。先判断要改变的是哪个屏幕的亮度，还是整体色温，再选择对应组件。
以下逐一介绍本分类已收录的全部组件，涵盖用途、原理、配置、排查、注意事项与学习资料。点击目录中的名称可跳转到相应正文。
本分类已收录的全部 5 个组件
输入法框架；语言引擎和 GTK/Qt 集成由不同包提供。
- 包名
fcitx5- 收录状态
- 核心清单
- Omarchy 配置或入口
Setup → Input
用途与日常使用
组织输入法、文字组合与候选词选择，适用于需要组合输入的语言。键盘布局只能改变按键映射，本身不能提供拼音转汉字等能力。
工作原理与协作关系
框架加载语言引擎，再通过工具包或协议与应用通信。GTK、Qt 和 Wayland 应用可能采用不同路径，因此一个应用能输入中文，不代表其他应用的集成也已正常。
配置与定制
通过 Omarchy 输入设置选择已安装的引擎。框架安装、引擎是否存在、切换快捷键和应用集成是不同设置，配置时应逐项确认，而不是只看包管理器显示已安装。
常见问题与排查思路
在不止一种应用里测试。只有某种工具包的应用失败时检查其集成；全部无法输入时，再检查输入法进程是否运行、引擎是否启用以及切换快捷键。
能力边界与修改注意事项
不要盲目混用 X11 与 Wayland 教程中的环境设置。候选窗和文字组合行为也受应用支持影响；修改后应回到出现问题的应用中验证，而不只测试终端。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi fcitx5
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
包含拼音等中文输入引擎。在本快照中已列入核心包清单；启用与配置仍是另一步。
- 包名
fcitx5-chinese-addons- 收录状态
- 核心清单
用途与日常使用
为 Fcitx 5 增加拼音等中文输入引擎，负责语言相关的转换能力，而不是独立提供完整输入法服务。需要与框架及应用集成配合使用。
工作原理与协作关系
输入序列由所选引擎结合词典转换成候选词，Fcitx 框架负责启用与应用通信。候选词不合适和完全无法调出输入法，应分别检查引擎设置与框架状态。
配置与定制
先在输入设置中选中中文引擎，再调整该引擎支持的标点、候选行为和词典设置。迁移设备或重置配置前保存个人词典，避免丢失长期积累的输入习惯。
常见问题与排查思路
列表没有中文引擎时，先确认包安装情况，并按支持的流程刷新输入法会话。只有个别应用不能输入，则继续检查应用集成，不要反复重装词典。
能力边界与修改注意事项
本快照把它列入核心清单，但安装不代表已经选为当前输入引擎。不同中文输入引擎的词典和设置也不同，不能假设一种引擎的配置能直接导入另一种。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi fcitx5-chinese-addons
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
调整显示色温，用于夜间模式。
- 包名
hyprsunset- 收录状态
- 核心清单
用途与日常使用
调整显示色温，使夜间画面偏暖。它改变的是色彩呈现，不是面板背光强度，因此“更暖”和“更暗”不是同一个设置。
工作原理与协作关系
与 Hyprland 的显示能力配合工作。Shell 可以提供方便的开关，而实际色温调整由相关工具完成；这与窗口主题、应用配色也属于不同层面。
配置与定制
优先使用已有夜间模式入口。需要自定义时间安排时，确保只有一个工具负责色温变化，避免多个定时器互相覆盖造成画面反复切换。
常见问题与排查思路
屏幕持续偏黄时，先查看夜间模式状态，再考虑显示器校准。对比不同显示器以及最近的会话改动，有助于区分软件色温与硬件显示设置。
能力边界与修改注意事项
暖色温会改变颜色观感，进行需要准确颜色判断的工作时应考虑它的影响。它不能修复显卡输出失败，也不能代替亮度控制或显示器校准。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi hyprsunset
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
控制支持的背光设备；外接显示器可能需要 DDC/CI。
- 包名
brightnessctl- 收录状态
- 核心清单
用途与日常使用
读取并调整支持的背光或 LED 设备亮度，常见于笔记本屏幕和键盘灯。它是否能控制某个设备，取决于系统是否暴露了相应接口。
工作原理与协作关系
使用内核暴露的设备接口。桌面滑块可能调用亮度工具，但可用范围与实际响应由设备和驱动决定；滑块存在不代表所有显示器都支持同样的控制方法。
配置与定制
设置快捷键前先确定目标设备。同一台电脑可能存在多个亮度设备，过于宽泛的命令可能调到键盘灯而不是屏幕，应根据实际设备选择。
常见问题与排查思路
检查设备信息与访问权限。外接显示器没有变化时，应继续了解 DDC/CI 支持，而不是反复调笔记本背光；系统没有暴露设备时也需检查驱动层。
能力边界与修改注意事项
并非每块屏幕都提供兼容背光设备。亮度调得过低可能影响后续操作，定制时应小幅尝试，并保留恢复到可见亮度的方式。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi brightnessctl
brightnessctl info
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
通过 DDC/CI 与支持的外接显示器通信。
- 包名
ddcutil- 收录状态
- 核心清单
用途与日常使用
与兼容外接显示器通信，查询或调整亮度等硬件控制项。当笔记本背光工具无法影响外接屏幕时，DDC/CI 是需要了解的另一条控制路径。
工作原理与协作关系
通过显示连接上的 DDC/CI 协议与功能代码通信。显示器固件、线材和扩展坞都可能影响通信，所以同一显示器换一条连接路径后，控制能力也可能不同。
配置与定制
设置数值前先确认目标显示器和支持的功能。部分显示器需要在自身屏幕菜单中启用 DDC/CI，软件设置不能替代显示器端的这个开关。
常见问题与排查思路
发现失败时，可对比直接连接与经过扩展坞的路径，并检查显示器菜单。即使设备宣称支持某功能，实际实现也可能有限，应先从查询与小幅调整开始。
能力边界与修改注意事项
它不负责窗口缩放或软件夜间色温变换。功能支持因设备而异，频繁轮询硬件也可能较慢，因此不宜把高频查询当成无成本的界面刷新。
本机检查与版本确认
先查询本机包信息，确认是否安装及具体版本。下面的命令用于只读检查，不会安装、重启或修改配置；需要在自己的 Omarchy 环境中运行。
pacman -Qi ddcutil
包不存在、服务未运行、当前不在图形会话或项目目录时，部分查询可能返回错误；应结合组件用途解读，不要直接当作系统故障。服务与项目状态可能包含本机信息，分享前请检查。
来源与适用范围
Omarchy 集成以 2026-10-12 的 quattro 分支快照为依据；上游配置说明应与本机版本对应。这里提供的是文档整理与排查建议，未进行本机硬件实测。
搜索所有组件 · 官方软件包清单索引
本页随共享组件目录更新；收录范围基于目录标注的源码快照，不代表所有版本或全部间接依赖。