外观与主题

在设置工具的「外观」页自定义候选窗与工具栏的视觉呈现。所有修改即时生效。

主题

内置五个主题，均可作为自定义的模板起点：

• 清风·蓝（default）——默认主题，清风设计体系，主色现代蓝
• 清风·绿（jade）——祖母绿色调
• 清风·橙（amber）——暖金橙色调
• 清风·紫（violet）——薰衣草紫色调
• 微软风格（msime）——微软蓝主色，紧凑布局，文字序号，左侧强调条

主题风格可选跟随 Windows 亮暗模式、始终亮色、始终暗色。

翻页栏

翻页栏包含翻页箭头与页码，可独立于主题配置进行覆盖，四种显示方式：

页码文字可单独设为显示、隐藏，或留空跟随主题。

候选窗口

编码显示方式

编码栏（组合区）有三种显示位置：

候选项提示信息

鼠标悬停在候选上时弹出的提示框，可分项开关。

状态提示

状态提示是切换输入状态时在光标处闪现的小气泡。纯视觉样式（颜色/字号/透明度/圆角）由主题决定，此处只调整行为与位置。

「常驻显示」「焦点切换时显示」「固定位置」这三项也可以右键状态气泡直接勾选，不必打开设置。

定位方式与偏移、固定坐标在「扩展设置」对话框中调整：

模式指示

进入临拼/双拼/快符/英文等模式时的标识，三种样式：

工具栏

工具栏可通过快捷键 Ctrl + Shift + \ 切换显示/隐藏。

获取更多主题

• 导入 TOML 主题——选择本地 .toml 主题文件导入，成功后即可在「主题选择」中使用
• 打开主题市场——前往 market.windinput.com 挑选现成主题
• 主题编辑器直连——开启后，Web 版主题编辑器可直接读写本机主题，边改边看效果。服务仅监听本机回环地址，不对外网开放；分「关闭 / 本次开启 / 自动开启」三档，开启后可复制本地连接地址到编辑器

自定义主题

将主题文件放入 %APPDATA%\WindInput\themes\<主题名>\theme.toml，即可在「外观」页的「主题选择」中出现。若主题名与内置主题相同（如 default），你这份会整份替换内置的那个，见同结构覆盖机制。

快速上手：继承内置主题

声明 base 并只写要改的颜色，其余从内置主题继承：

base = "default"

[meta]
name = "我的蓝色主题"

[colors]
primary = "#0066CC"     # 只改主色，其余外观沿用 default

主题文件结构

主题由若干顶层块组成，均可选，未写的部分从被继承主题回退：

[colors] 块是所有颜色的唯一来源：

• 亮暗分设：值写成 { light = "...", dark = "..." } 表示亮暗不同颜色；写成单个字符串则亮暗共用；只写一侧时另一侧自动回退
• token 引用："${tokenName}" 引用同表中另一个 token 的值
• 颜色格式："#RGB" / "#RRGGBB" / "#RRGGBBAA"（支持 alpha 透明度）/ "transparent"

[behavior] 中的值是主题给用户的推荐默认，用户可在「外观」页单独覆盖，覆盖跨主题切换保持：

[views] 按具名节点描述各窗口的盒模型（内外边距、边框、圆角、背景、字体、阴影等），字段较多且随版本演进。制作或调整几何时，建议直接以内置主题文件为模板，或用主题编辑器可视化编辑，避免逐字段手写出错。内置主题文件位于安装目录下的 data\themes\ 文件夹。

应用兼容性主题规则

兼容性规则用于修复特定应用中候选框定位、光标获取等问题。规则文件为 TOML 的 [[apps]] 数组表，加载顺序为系统预置（<安装目录>\data\compat.toml）→ 用户覆盖（%APPDATA%\WindInput\compat.toml），用户层同进程名规则覆盖系统层。

[[apps]]
process = "Weixin.exe"        # 进程名（不区分大小写）
comment = "微信 - 使用 rect.top 定位候选框"
caret_use_top = true          # 使用 caret rect 的 top 而非 bottom 定位候选框

[[apps]]
process = "Everything.exe"
comment = "文件搜索框，默认英文"
initial_mode = "english"      # 进入该应用时初始为英文，之后仍可手动切换

caret_use_top 适用于 GetTextExt 返回的 height 不稳定的 WebView 应用（如微信的 Qt WebView 输入框，height 在 1↔20px 间跳变导致 bottom 漂移，但 top 始终稳定）。清风输入法已内置微信的兼容性规则，会自动修正候选框定位。如果其他应用也有类似问题，可在用户 compat.toml 中添加规则；修改后通过托盘菜单的重载配置即可生效。

宿主代理渲染 host_render 0.113 新增

少数宿主运行在受限容器中、或其窗口层级（Band）盖过一切普通窗口，输入法自绘的候选窗被压在下面看不见——Win11 开始菜单 / 任务栏搜索的 SearchHost.exe 就是这样。host_render = true 让候选窗改由服务进程渲染成位图，经共享内存交给宿主进程内的输入法 DLL 上屏。

SearchHost.exe 已内置为系统预置条目，无需自行添加。普通应用不要开：它多绕一层渲染路径，出问题时本地窗口路径更好排查。

应用独立的初始输入状态

initial_mode 与 initial_punct 让特定应用在获得焦点时自动切到指定状态，适合文件搜索框、终端、代码编辑器这类主要输入英文的场景。

最快的设置方式是不改文件：在目标应用里右键点击输入法图标 → 应用独立配置 → 初始输入模式 → 选择「英文」。菜单会把等效规则写入用户层 compat.toml 并立即生效。子菜单第一行是当前焦点应用的进程名（灰色，仅作展示，点不动），下面依次是三项规则：

选择「跟随全局」即清除该应用在这一维度上的规则。