进阶专题配置文件

外观配置

ui 域全部配置项——候选窗、编码与翻页、悬停提示、状态气泡、工具栏、字体主题

v0.122.0

[ui] 域控制输入法的外观行为与布局:候选窗排布、编码显示方式、翻页、悬停提示、状态气泡、工具栏,以及字体与主题的选择。

注意区分职责:纯视觉样式(颜色、圆角、透明度、字号基线、边距等)由主题决定,见外观与主题;本页配置的是行为与布局(显示什么、怎么排、放哪里)。二者交汇处(如候选字号、翻页栏显隐)本页字段可覆盖主题基线。

默认值来源

本页默认值以系统预置 data/config.toml[ui] 段为准。部分字段的程序内置缺省与预置值不同(例如加载缺失该键的旧配置时按内置缺省回退),本页以预置值为准。

候选窗——基本(ui.candidate)

[ui.candidate]
font_size = 18                  # 候选文本字号
font_size_follow_theme = true   # 字号跟随主题
per_page = 7                    # 每页候选数
per_page_extended = 0           # 扩展档每页候选数
max_chars = 16                  # 候选文本最大显示字数
layout = "horizontal"           # 候选排布方向
hide_window = 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   # 横排候选注释最大字数
类型可选值默认说明
font_size浮点18候选文本字号;0 亦表示跟随主题 behavior.font_sizefont_size_follow_theme 开启时本值被忽略
font_size_follow_theme布尔true字号跟随主题:开启时忽略 font_size,改用主题 behavior.font_size
per_page整数7每页显示的候选数
per_page_extended整数0扩展档(临拼 / 快捷 / 短语等 overlay 模式)每页候选数;0 = 与 per_page 相同
max_chars整数16候选文本最大显示字数,超出截断并加省略号(0 = 不限);仅影响显示,上屏用完整原文
layout枚举horizontal / vertical"horizontal"候选排布方向:横排 / 竖排
hide_window布尔false隐藏候选窗(不显示候选列表)
index_labels字符串数组 0.117 新增[]自定义序号标签,一槽一项(如 ["a","s","d"]["Ⅰ","Ⅱ","Ⅲ"])。每项是一个完整标签,可含多个字符;空表 = 默认 19。槽内空串或槽位不足处让位主题 index.labels,主题也未定义才回退数字
comment_template_vertical字符串"${code_hint|code}"竖排候选注释(右侧灰字)模板。语法与变量见候选注释;留空 = 不显示
comment_template_horizontal字符串"${code_hint|code}"横排候选注释模板。横排宽度由全部候选共享,放注音/字根易撑宽窗口
comment_max_chars_vertical整数 0.119 新增0竖排候选注释最大字数,超出截断并加省略号(0 = 不限)。竖排每行独占,通常可比横排放宽
comment_max_chars_horizontal整数 0.119 新增0横排候选注释最大字数
auto_comment_dicts布尔 0.121 新增true词库在 columns 中声明 comment 列时,自动将该列作为 ${dict} 的注释源。判据是显式声明;import_tables 引入的子表逐一检测。识别结果在注释词库列表中标「自动」

注释词库(ui.comment_dicts) 0.114 新增

供注释模板 ${dict} 变量查询的独立注释词库列表(如英汉释义、Emoji 名称)。ui.comment_dicts 是结构体数组(TOML 的 [[ui.comment_dicts]] 形态),出厂为空——词典多有版权,不随附任何内容,由用户自行放置。设置页入口在外观 → 候选标注 → 注释词库,也可直接写配置:

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

数组顺序即优先级(同一个词多库都有注释时取靠前的);schemas 用来避免无谓开销——一份大英汉词典写 schemas = ["english"] 后,中文方案下根本不加载。词库文件格式与完整挂载说明见候选注释

词库自带注释的记录 0.121 新增

ui.candidate.auto_comment_dicts 识别出的条目也记在本表中。这类记录只含三个字段,用于保存它的启停状态与优先级:

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

pathschemas 不写入——两者每次启动重新检测,写入即成为过时快照。未在本表中出现的自动条目按检测顺序排在末尾并默认启用;id 匹配不到词库时(词库已删除或停用)该记录静默忽略。

候选窗——尺寸稳定(ui.candidate) 0.118 新增

候选窗默认完全跟随内容缩放:单字候选与多字候选间来回切换时宽度跳动,候选数变化、翻页栏或编码栏的出现消失又让高度跟着伸缩,连续输入时观感抖动明显。五个下限项用来锁住尺寸,出厂均为 0(关闭)。

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 = 关闭
类型可选值默认说明
min_window_width_horizontal整数0横排时候选窗的最小宽度,单位 dp(逻辑像素);0 = 关闭,宽度跟随内容。超出下限后宽度照常跟随内容,不封顶
min_window_width_vertical整数0竖排时候选窗的最小宽度,语义与横排那项一致。与主题的竖排宽度上限(behavior.vertical_max_width)冲突时下限优先
min_window_height_horizontal整数0横排时候选窗的最小高度(dp)。横排候选虽只有一行,窗口高度仍会随编码栏出现/消失而变
min_window_height_vertical整数0竖排时候选窗的最小高度(dp)。翻页栏、编码栏的出现消失一并吸收
min_rows整数0竖排候选区的最小行数;0 = 关闭,高度跟随候选数。候选不足时补等高的透明空行。生效值自动钳到 per_page(补出比一页还多的空行只会得到大半空白的窗口)。横排不适用(候选并列于一行,高度本就恒定)

下限量的是整个窗口,不是单个候选。 候选照常按内容紧凑排列并左对齐,凑不满的部分留在窗口右侧 / 底部空着:横排配 100、而首两个候选各占 30dp 与 20dp 时,两者仍按原本方式并排,右侧空着。翻页栏、编码栏、各级内边距一并计入,所以「窗口大小不变」是可以直接达成的。

窗口被翻到光标上方显示时,高度富余补在顶部——上方显示时底边贴光标,空白压在下面会把候选整体顶离光标,位置反而随内容抖动。竖排下候选行的高亮背景跟随窗口铺满,行内的序号 / 文字 / 注释仍按内容左对齐。

min_window_width_*max_chars(候选文本最大字数)成对:一个封窗口下限、一个封文字上限,两个都配上候选窗宽度就基本固定。

  • 即使 max_chars = 0(不限),候选窗也不会撑出显示器边界 0.118 新增——放不下的文字按像素截断并加省略号,横排多个候选按可用宽度公平分配(短候选保留原样,余量让给长候选)

min_rowsmin_window_height_vertical 是两种量法,可同时配、取两者较大者:前者只稳住候选区(翻页栏照常伸缩),后者罩住整个窗口。

单位取 dp 而非字符数:本组量的是窗口而不是文字,窗口尺寸里还有序号列、各级内边距、翻页栏等与字号无关的部分,用字符数换算不出来。dp 随 DPI 自动缩放,高分屏上等比放大。

候选窗——编码显示(ui.candidate)

preedit_display = "app_inline"  # 编码(组合区)显示方式
类型可选值默认说明
preedit_display枚举app_inline / candidate_top / candidate_inline"app_inline"编码(组合区)显示方式,取代旧的 inline_preedit + preedit_mode 组合

三个取值的含义:

  • app_inline(默认):编码内嵌应用光标处,候选窗显示 preedit 栏。
  • candidate_top:候选窗顶部独立 preedit 栏。
  • candidate_inline:编码作为候选窗首单元内联。

候选窗——上翻行为(ui.candidate)

候选窗被顶到光标上方时的两个正交开关,可单独或叠加。

flip_when_above = false          # 上翻时反转候选排列顺序(仅竖排)
swap_preedit_when_above = false  # 上翻时交换编码栏与候选栏位置
类型可选值默认说明
flip_when_above布尔false候选窗在光标上方时反转候选项排列顺序。layout = "vertical"(竖排)生效:横排候选左右并列,反转与窗口在上在下无关,故忽略。反转期间上下条目键(↑↓ 与 Shift+Tab、Tab)按屏幕上看到的方向走;翻页键不受影响
swap_preedit_when_above布尔false候选窗在光标上方时交换编码栏与候选栏位置(编码区沉底贴光标);与 flip_when_above 正交,可叠加

候选窗——翻页栏(ui.candidate)

pager_bar_display = ""     # 翻页栏显示覆盖
page_number_display = ""   # 页码文字显示覆盖
pager_in_preedit = false   # 翻页栏并入编码栏行
类型可选值默认说明
pager_bar_display枚举"" / hide / auto / always""翻页栏显示覆盖:"" = 跟随主题;hide = 不显示;auto = 超过 1 页才显示;always = 始终显示
page_number_display枚举"" / show / hide""页码文字显示覆盖:"" = 跟随主题;show = 显示;hide = 隐藏
pager_in_preedit布尔false翻页栏并入编码所在行、右对齐显示(竖排省一行)。两种编码形态落点不同、表现一致:candidate_top 并进独立编码栏行的右端,candidate_inline 0.122 新增 并进编码自己那一行。横排下翻页栏本就落在行尾,此项无影响;蒙古文等旋转排版维持底部独立行

候选窗——定位(ui.candidate)

position_mode = "follow_caret"  # 候选窗定位方式
custom_x = 0                    # 固定模式内容左上 X(拖动落盘)
custom_y = 0                    # 固定模式内容左上 Y(拖动落盘)
类型可选值默认说明
position_mode枚举follow_caret / fixed"follow_caret"候选窗定位方式:follow_caret = 跟随光标(默认);fixed = 固定屏幕坐标,不再随光标移动、也不再上翻(flip / swap_when_above 随之失效)
custom_x整数0固定模式下内容左上屏幕 X(不含阴影扩边)
custom_y整数0固定模式下内容左上屏幕 Y(不含阴影扩边)

程序维护项:candidate.custom_x / custom_y

ui.candidate.custom_x / custom_yposition_mode = "fixed" 时生效,且由用户拖动候选窗时自动落盘,设置工具刻意不暴露:手填绝对坐标既不直观、又会与拖动互相覆盖。(0, 0) 视作"尚未设定",首次显示落到屏幕默认锚点。

首显调优(隐藏项)

三个用于微调「候选窗何时显示」的内部选项,不在设置页,一般无需改动:

first_show_settle_ratio = 0.8       # 非权威坐标与权威坐标的容差(行高倍数)
fast_typing_window_ms = 100         # 连续输入判定窗口
fast_first_show_fallback_ms = 25    # fast 档等不到坐标时的兜底超时
类型默认说明
first_show_settle_ratio小数0.8首显用过非权威坐标时,权威坐标与它相差在「行高 × 本值」以内就不再校正——校正动作本身才是抖动的观感来源
fast_typing_window_ms整数100两次按键间隔小于此值即视为连续输入,fast 档直接采信首条试探坐标。0 = 关闭该快路径
fast_first_show_fallback_ms整数25fast 档等不到坐标时的兜底超时。不发 OnLayoutChange 的宿主(如 Word)靠它退化成 instant 而非干等

首显策略本身(fast / wait / instant)是逐应用规则,写在 compat.toml 而非这里,见应用兼容性规则

字体(ui.font)

[ui.font]
family = ""                # 字体族名
fallback = []              # 缺字时按序接续的回退字体
scripts = {}               # 按文字类别单独指派字体
path = ""                  # 字体文件路径
render_mode = "directwrite" # 文本渲染后端
类型可选值默认说明
family字符串""候选窗字体族名;留空 = 使用系统 / 主题默认字体
fallback字符串数组 0.120 新增[]family 里缺某个字时,按顺序往后找的字体。最终链 = [family] + fallback
scripts0.120 新增{}文字类别单独指派字体,键取 latin / greek / cyrillic / cjk / emoji / digits / punct,值是该类自己的字体链。见回退链与按类别指派
path字符串""字体文件路径(加载非系统安装的字体文件时使用);留空 = 按 family 从系统查找
render_mode枚举directwrite / gdi"directwrite"文本渲染后端:directwrite(默认,抗锯齿更佳)/ gdi(兼容旧渲染)

回退链与按类别指派 0.120 新增

两者回答的是不同的问题,可以同时用:

  • fallback 答「这个字谁都没有怎么办」——只有主字体缺字才轮到它,按顺序找到第一个有的为止。
  • scripts 答「这一类字就该用它」——不管主字体有没有,该类文字直接用指定的字体。
[ui.font]
family = "微软雅黑"
fallback = ["Segoe UI Emoji"]     # 雅黑没有的字,去这里找

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

一句中英混排是按类别切段排版的,不是逐字换字体:空格、标点、组合记号这类中性字符 继承上下文——否则一句话会被切成十几段,段与段的边界还会丢掉字距。

类别名写错不报错,只是被忽略(日志里留一条 warn)。设置界面的「按文字类别指定字体」 会把七个类别预填好,在现成的行上改比手写安全,见外观设置 · 字体

主题(ui.theme)

[ui.theme]
name = "default"   # 主题名
style = "system"   # 明暗风格
类型可选值默认说明
name字符串"default"当前主题名(对应主题包 / 主题目录)
style字符串(隐性枚举)system / light / dark"system"明暗风格:system = 跟随系统;light = 浅色;dark = 深色

主题的具体样式定义(配色、圆角、字号基线等)见外观与主题

模式指示(ui.mode_indicator)

进入临时拼音 / 双拼 / 快捷 / 英文 / 快符等模式时的标识。

[ui.mode_indicator]
style = "short"   # 模式标识样式
类型可选值默认说明
style枚举short / full / none"short"模式标识样式:short = 短称(拼 / 双 / 快 / 英 / 符);full = 全称(如"临时拼音");none = 不显示

状态气泡(ui.status)

中英 / 标点 / 全半角 / 简繁 / 大写锁定等状态切换时的瞬时提示气泡。样式(字号 / 透明度 / 圆角 / 配色)跟随主题(theme.views.status),此处为行为与位置。

[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"]  # 显示哪些内容段
类型可选值默认说明
enabled布尔true是否启用状态提示气泡(false = 完全不显示)
duration整数800自动隐藏时长(毫秒);display_mode = "always" 时忽略
display_mode枚举temp / always"temp"显示模式:temp = 临时(duration 后隐藏,默认);always = 常驻(激活 / 获焦时显示,失焦隐藏)
show_on_focus布尔false切换到别的输入框时也提示一次当前状态。仅 display_mode = "temp" 下有意义(always 本就在获焦时显示)。跟随光标定位下取不到精确插入点的应用不显示,详见下方说明
schema_name_style枚举full / short"full"方案名显示样式:full = 全名(默认);short = 图标短称(icon_label,无则回退全名)
position_mode枚举follow_caret / fixed"follow_caret"位置模式:follow_caret = 跟随光标(默认);fixed = 固定屏幕坐标(custom_x / custom_y
offset_x整数0follow_caret 下相对默认位置(光标下方居中)的水平偏移(像素,正 = 右)
offset_y整数0follow_caret 下相对默认位置的垂直偏移(像素,正 = 下)
custom_x整数0fixed 模式的固定屏幕 X(像素)
custom_y整数0fixed 模式的固定屏幕 Y(像素)
items字符串数组schema / punct / full_width / s2t / caps["schema", "punct", "full_width", "s2t", "caps"]气泡显示哪些内容段;留空 = 全部显示。可选项:schema(输入方案 / 中英)、punct(标点状态)、full_width(全半角)、s2t(简繁)、caps(大写锁定)。列表顺序无关,渲染顺序固定

程序维护项:status.custom_x / custom_y

ui.status.custom_x / custom_yposition_mode = "fixed" 时生效,由用户拖动气泡时自动落盘,设置工具刻意不暴露(与 ui.candidate.custom_x/y 同一决策)。日常调整位置请用 offset_x / offset_y

show_on_focus 在部分应用里不显示,是刻意的

刚切换到一个输入框、还没开始打字时,输入法未必能从应用那里问到精确的插入点位置——某些应用要等第一次输入之后才提供。此时若退而求其次用系统光标,拿到的可能是别的窗口残留的位置,气泡就会飘到无关的地方(在 Word 的标题行上实测偏差可达 800 多像素)。

因此跟随光标定位下只在拿到精确位置时才显示:宁可不提示,也不提示在错的地方。绝大多数应用能在毫秒级内给出位置,正常都会显示。

如果你所用的应用始终不显示、又确实想要这个提示,把 position_mode 改成 fixed(或右键气泡勾选「固定位置」)——固定位置不依赖光标,任何应用下都会显示。

悬停提示(ui.tooltip)

鼠标悬停候选时弹出的提示。原 ui.tooltip.{code,pinyin,chaizi,debug}.* 子表已拍平为平铺字段。

[ui.tooltip]
delay = 200               # 提示延迟显示时间(毫秒)
code_enabled = true       # 编码提示
pinyin_enabled = true     # 拼音提示
pinyin_heteronyms = true  # 显示多音字所有读音
pinyin_max_readings = 0   # 每字最多显示读音数
chaizi_enabled = false    # 拆字提示
debug_enabled = false     # 调试提示
类型可选值默认说明
delay整数200提示延迟显示时间(毫秒)
code_enabled布尔true编码提示(显示候选对应编码)
pinyin_enabled布尔true拼音提示(显示候选拼音读音)
pinyin_heteronyms布尔true显示多音字的所有读音
pinyin_max_readings整数0每字最多显示读音数(0 = 不限)
chaizi_enabled布尔false拆字提示
debug_enabled布尔false调试提示(内部诊断信息)

高级项:tooltip.pinyin_max_readings

ui.tooltip.pinyin_max_readings 为高级项,设置工具不直接编辑,一般无需改动;仅在需要限制多音字读音显示数量时通过 config.toml 手改,0 表示不限。

工具栏(ui.toolbar)

[ui.toolbar]
visible = true              # 是否显示常驻工具栏
hide_in_fullscreen = true   # 全屏时自动隐藏
fullscreen_watch = true     # 主动检测全屏状态
auto_hide = false           # 无交互超时后自动隐藏
auto_hide_delay = 5         # 自动隐藏超时(秒)
vertical = false            # 纵向排列(默认横条)
# 显示哪几格、按什么顺序(数组顺序即渲染顺序)
items = ["mode", "punct", "full_width", "-s2t", "soft_keyboard", "settings"]
类型可选值默认说明
visible布尔true是否显示常驻工具栏(启动初值,运行时可经菜单切换)
hide_in_fullscreen布尔true前台应用全屏时自动隐藏工具栏
fullscreen_watch 0.122 新增布尔true定期主动查询前台是否全屏。进出全屏本身不产生任何输入法回调(在输入框里按 F11、用播放器快捷键全屏),只靠焦点事件的话工具栏该隐没隐;关掉则只在焦点 / 激活事件到达时顺带查一次。仅在 hide_in_fullscreen = true 时有意义
auto_hide布尔false自动隐藏:显示后超时无交互则淡出(悬停 / 拖动顺延;默认关)
auto_hide_delay整数5自动隐藏超时(秒);下限 1 由协调器钳制
vertical布尔false 0.115 新增纵向排列:竖着摆放工具栏(默认横条)。几何仍取主题 [toolbar]:条宽 = height、每格高 = button_width
items字符串数组 0.119 新增mode / punct / full_width / s2t / soft_keyboard 0.120 新增 / settings / custom:<id>,名字前可加 -["mode", "punct", "full_width", "-s2t", "soft_keyboard", "settings"]显示哪几格、按什么顺序——数组顺序即渲染顺序。留空 = 全部内置项。名字前加 -(如 "-s2t")表示不显示但记住它排在这个位置,设置页关掉某格时写的就是这个。s2t 出厂关着,去掉那个 - 就能随时点它开关简入繁出;隐藏 settings 不影响使用,右键工具栏任意位置同样能打开菜单。整条工具栏都不想要请用 visible = false

自定义按钮(ui.toolbar.buttons) 0.119 新增

往工具栏加一格自己的按钮,点击执行一个动作——比如加个「符」打开系统字符映射表。

也可以在设置页里配

设置工具 → 外观 → 工具栏 → 「显示内容」→ 左下「新建按钮…」。填真实路径即可, 不必自己处理反斜杠转义。本节是给想直接改配置文件的人看的。

定义按钮和显示按钮是两步[[ui.toolbar.buttons]] 只是定义,还要在上面的 items 里写一条 custom:<id> 才会显示。这样你可以先定义好几个、按需往工具栏上放。

[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 里那条留着记住位置
类型默认说明
id字符串稳定标识,供 items 里的 custom:<id> 引用
label字符串格内文字。一个汉字或两个字母,超出自动截断——工具栏各格等宽,一格写多了会破坏整条的节奏
action字符串点击执行的动作,语法与短语、命令栏一致
enabled布尔true关掉即不显示

action 可用的写法与短语里完全一样,常用这几种:

写法作用
open("https://www.zdic.net")打开网址 / 文件 / 程序(等同于双击它)
proc.run("notepad.exe")启动程序,可带参数与 cwd= / verb="runas" / show="min"
wind.cli("schema switch wubi86")调用本输入法的命令,如一键切方案
key.tap("Ctrl+Shift+P")模拟一次按键组合

两点注意

action 里含双引号,整体要用单引号包起来。

按钮没有悬停提示——工具栏目前没有提示气泡机制。选 label 时挑个自己一眼认得的字。

导入别人的配置片段时留意这一项

自定义按钮能启动程序,而配置片段可以写入这一项。导入来源不明的配置片段前, 先看一眼预览里有没有 ui.toolbar.buttons

任务栏图标(ui.langbar) 0.117 新增

Windows 任务栏上那个显示「中 / 英 / 拼 / 五」的输入指示器。这一段配置的是叠在主字上的 状态角标——不用把鼠标移到工具栏,扫一眼任务栏就知道当前是中文标点还是英文标点、是不是全角。

出厂全关:角标叠加在系统的输入指示器上,默认开启会改变每个人的任务栏。总开关在 外观设置 → 任务栏图标里。macOS 无此功能。

全局项 0.120 新增

[ui.langbar]
badge = "none"        # 总开关:none = 不显示|corner = 角标
badge_scale = 1.0     # 所有角标的大小倍率
badge_alpha = 0.88    # 不透明度的默认值,同时是档位开关(见下)
类型可选值默认说明
badge枚举none / cornernone总开关。关掉即下面全部规则都不画,不必逐条去关。写错的值一律回落 none
badge_scale小数1.0整体大小倍率。单条规则还能用自己的 scale 再乘一次
badge_alpha小数0~10.88不透明度的默认值;单条可用色值末两位覆盖。同时是档位开关,见下

角标规则表 0.120 新增

一条规则 = 「某个状态成立时,在某个角落用某个颜色画一个角标」。出厂三条:

[[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"
类型可选值默认说明
enabled布尔true这条画不画。想「中文标点时不受打扰、只在英文标点时提醒」,把第一条改成 false 即可——颜色和位置都还留着,想回来勾上就行
state枚举punct_cn / punct_en / full_width什么时候画。写错会让整条规则被丢弃(日志里有警告):状态没有合理的默认值,回落到任意一个都是替你瞎猜
corner枚举top_left / top_right / bottom_right / bottom_leftbottom_right画在哪个角
color_light字符串#RRGGBB / #RRGGBBAA / autoauto浅色任务栏上的颜色。auto = 与主字同色。末两位 AA这一条自己的不透明度
color_dark字符串同上auto深色任务栏上的颜色。同一个色在深浅两种任务栏上的可辨度可以差很远,所以分两个字段
scale小数1.0本条相对整体大小的额外倍率。填 0 或负数 = 这一条不画(但表达这个意思该用 enabled

顺序即优先级:两条规则若配在同一个角落又同时成立,只画最靠前的那一条——16 像素上叠两个 三角会糊成一片。出厂两条标点规则同占右下角不冲突,因为它们的状态互斥,同一时刻只可能命中一条。

色值末两位填 FF 不只是「最不透明」

#2288E0FF 会把这一条切到挖空档(角标实心 + 周围切掉一圈主字),与半遮是两种不同的画法, 见下一节。想要「几乎不透明但仍是半遮」,写 FE 而不是 FF

badge_alpha 是档位开关,不只是深浅

它跨过 1.0 时会换一种画法,不是简单的透明度渐变:

  • = 1.0 — 角标实心,并在它周围切掉一圈主字(靠留白与主字分离)。代价是右下有笔画的 字(「五」「双」「拼」)会被切掉一角,看起来像缺笔。
  • < 1.0 — 角标半透明,主字保留完整,笔画从角标里透出来(靠色差分离)。默认走这一档。

两者是互斥的两种手段,不要指望「挖空 + 调淡」叠加:那样主字先被切掉一圈、没有笔画可透, 调这个值会看起来毫无效果。

模式主字(ui.labels) 0.118 新增

任务栏图标、工具栏模式格、状态气泡上那个「中 / 英 / 五 / 拼」的字,这里配的是 非中文状态下显示成什么。

[ui.labels]
english = "英"   # 英文半角:按 Shift 切出的英文状态
caps_lock = "A"  # 大写锁定
类型默认说明
english字符串英文半角状态的主字。宽度上限为一个汉字;留空则用默认值
caps_lock字符串A大写锁定状态的主字。宽度上限为一个汉字;留空则用默认值

中文状态的字在方案文件里

打中文时显示的「五」「拼」是方案自己的属性,配在方案文件的 [schema] icon_label, 不在这一段。切换方案时它跟着变,而 [ui.labels] 这两个是全局状态、与用哪个方案无关。

想让英文状态显示 En 而不是「英」:

[ui.labels]
english = "En"

两个字母的宽度约等于一个汉字,16px 的任务栏图标放得下。

上限按显示宽度算,一个汉字占 2、其余字符占 1,总宽不超过 2:En 完整显示, English 截成 En,而「符号」这类两个汉字会截成「符」——两个汉字挤进 16px 的图标里 只能把字号缩掉一半,反而认不出。方案文件里的 [schema] icon_label 同一口径。

这一段只能改配置文件

[ui.labels] 是高级选项,设置页里没有对应的开关。改完重启输入法生效。

相关阅读

对这篇文档有疑问,或发现内容有误?

欢迎到文档仓库提 issue,写明问题时附上本页链接即可。

去提 issue →

本页目录