外观配置

[ui.candidate]
font_size = 0                   # 候选文本字号（0 = 跟随主题）
per_page = 7                    # 每页候选数
per_page_extended = 0           # 扩展档每页候选数
max_chars = 16                  # 候选文本最大显示字数
layout = "horizontal"           # 候选排布方向
hide_window = false             # 隐藏候选窗
double_click_screenshot = false # 双击候选窗空白处截图到剪贴板
index_labels = []               # 自定义序号标签
comment_template_vertical   = "${code_hint|code_rev|shuangpin}"   # 竖排候选注释模板
comment_template_horizontal = "${code_hint|code_rev|shuangpin}"   # 横排候选注释模板
comment_max_chars_vertical   = 0   # 竖排候选注释最大字数
comment_max_chars_horizontal = 0   # 横排候选注释最大字数
comment_above = false   # 注释首行（模板里第一个 \n 之前）显示在候选上方

[[ui.comment_dicts]]
id = "emoji"                        # 稳定标识（日志 / 设置页定位用）
label = "Emoji 名称"                 # 显示名
path = "comments/emoji.dict.yaml"   # 相对 schemas/；用户目录优先，回落安装目录
enabled = true                      # 是否启用，省略视为启用
schemas = []                        # 限定生效方案 id；留空 = 全部方案

[[ui.comment_dicts]]
id = "auto:pinyin/cn_dicts/corrections.dict.yaml"   # 由词库路径生成
auto = true                                         # 标记为自动识别的记录
enabled = false                                     # 启停状态

min_window_width_horizontal = 0    # 横排时窗口最小宽度（dp），0 = 关闭
min_window_width_vertical = 0      # 竖排时窗口最小宽度（dp），0 = 关闭
min_window_height_horizontal = 0   # 横排时窗口最小高度（dp），0 = 关闭
min_window_height_vertical = 0     # 竖排时窗口最小高度（dp），0 = 关闭
min_rows = 0                       # 竖排候选区最小行数，0 = 关闭

preedit_display = "app_inline"  # 编码（组合区）显示方式

flip_when_above = false          # 上翻时反转候选排列顺序（仅竖排）
swap_preedit_when_above = false  # 上翻时交换编码栏与候选栏位置

pager_bar_display = ""     # 翻页栏显示覆盖
page_number_display = ""   # 页码文字显示覆盖
pager_in_preedit = false   # 翻页栏并入编码栏行

position_mode = "follow_caret"  # 候选窗定位方式
offset_x = 0                    # 跟随光标时的水平微调（dp，正=右）
offset_y = 0                    # 跟随光标时的垂直微调（dp，正=远离光标）
shadow = "follow"               # 主题阴影：follow 跟随主题 / off 关闭
custom_x = 0                    # 固定模式内容左上 X（拖动落盘）
custom_y = 0                    # 固定模式内容左上 Y（拖动落盘）

first_show_settle_ratio = 0.8       # 非权威坐标与权威坐标的容差（行高倍数）
fast_typing_window_ms = 100         # 连续输入判定窗口
fast_first_show_fallback_ms = 25    # fast 档等不到坐标时的兜底超时

[ui.font]
family = ""                # 字体族名
weight = 0                 # 字重（0 = 不指定）
fallback = []              # 缺字时按序接续的回退字体
scripts = {}               # 按文字类别单独指派字体
path = ""                  # 字体文件路径
render_mode = "directwrite" # 文本渲染后端

[ui.font]
family = "微软雅黑"
fallback = ["Segoe UI Emoji"]     # 雅黑没有的字，去这里找

[ui.font.scripts]
latin = ["Cascadia Code"]         # 拉丁字母一律用等宽，不管雅黑有没有

[ui.theme]
name = "default"   # 主题名
style = "system"   # 明暗风格

[ui.mode_indicator]
style = "short"   # 模式标识样式

[ui.status]
enabled = true                # 是否启用状态气泡
duration = 800                # 自动隐藏时长（毫秒）
display_mode = "temp"         # 显示模式
show_on_focus = false         # 切换输入框时也提示一次
schema_name_style = "full"    # 方案名显示样式
position_mode = "follow_caret" # 位置模式
offset_x = 0                  # follow_caret 水平偏移
offset_y = 0                  # follow_caret 垂直偏移
custom_x = 0                  # fixed 固定 X（拖动落盘）
custom_y = 0                  # fixed 固定 Y（拖动落盘）
items = ["schema", "punct", "full_width", "s2t", "caps"]  # 显示哪些内容段

[ui.status]
position_mode = "follow_caret"
fallback_position = "screen_bottom_right"   # 报不出光标位置时，显示在屏幕右下角

[ui.tooltip]
delay = 200        # 悬停多久后显示（毫秒）
max_chars = 200    # 单行最多显示多少字（0 = 不限）
wrap_width = 40    # 折行宽度，按列计（0 = 不折行）

[[ui.tooltip.sections]]
label = "完整原文"
template = "${full_text}"   # 仅候选被截断时有值

[[ui.tooltip.sections]]
label = "编码{(${code_source})}"
template = "${word_code}"

[[ui.tooltip.sections]]
label = "拼音"
each = "han"
template = "${char}：${readings}"

[[ui.tooltip.sections]]
enabled = false
label = "拆字"
each = "han"
template = "${char}：${chaizi}{ [${chaizi_code}]}"

[[ui.tooltip.sections]]
enabled = false
label = "Unicode"
each = "char"
template = "${char}：${unicode}"

[[ui.tooltip.sections]]
enabled = false
label = "调试"
template = "${debug}"

[ui.toolbar]
visible = true              # 是否显示常驻工具栏
hide_in_fullscreen = true   # 全屏时自动隐藏
fullscreen_watch = true     # 主动检测全屏状态
hide_in_english = false     # 英文状态时隐藏
auto_hide = false           # 无交互超时后自动隐藏
auto_hide_delay = 5         # 自动隐藏超时（秒）
auto_hide_hover_reveal = false # 自动隐藏后，鼠标移到原位即重新显示
vertical = false            # 纵向排列（默认横条）
# 显示哪几格、按什么顺序（数组顺序即渲染顺序）
items = ["mode", "punct", "full_width", "-s2t", "soft_keyboard", "settings"]

[ui.toolbar]
items = ["mode", "punct", "full_width", "custom:sym", "settings"]

[[ui.toolbar.buttons]]
id = "sym"                          # 稳定标识，被 items 里的 custom:sym 引用
label = "符"                        # 格内文字：一个汉字，或两个字母
action = 'proc.run("charmap.exe")'  # 点击执行
enabled = true                      # 关掉即不显示，items 里那条留着记住位置

[ui.langbar]
badge = "none"        # 总开关：none = 不显示｜corner = 角标
badge_scale = 1.0     # 所有角标的大小倍率
badge_alpha = 0.88    # 不透明度的默认值，同时是档位开关（见下）

[ui.langbar]
text_color_cn_light = ""   # 中文态，浅色任务栏
text_color_cn_dark = ""    # 中文态，深色任务栏
text_color_en_light = ""   # 英文态，浅色任务栏
text_color_en_dark = ""    # 英文态，深色任务栏

[colors]
langbar_text_cn = { light = "#1A4FA0", dark = "#8EC5FF" }
langbar_text_en = { light = "#000000", dark = "#FFFFFF" }

[[ui.langbar.badges]]
enabled = true
state = "punct_cn"          # 中文标点
corner = "bottom_right"
color_light = "#2288E0"     # 浅色任务栏上的颜色
color_dark = "#2288E0"      # 深色任务栏上的颜色
scale = 1.0

[[ui.langbar.badges]]
state = "punct_en"          # 英文标点
corner = "bottom_right"
color_light = "#EE9922"
color_dark = "#EE9922"

[[ui.langbar.badges]]
state = "full_width"        # 全角
corner = "top_right"
color_light = "#E0447A"
color_dark = "#E0447A"

[ui.labels]
english = "英"   # 英文半角：按 Shift 切出的英文状态
caps_lock = "A"  # 大写锁定

[ui.labels]
english = "En"