主题与兼容性

导入 TOML 主题、主题市场、主题编辑器直连，自制主题的文件结构，以及应用兼容性规则

「外观」页底部的两张卡片——主题导入与主题编辑器直连——以及自制主题、修复个别应用显示问题的方法。

获取更多主题

入口	说明
导入 TOML 主题	选择本地 `.toml` 主题文件导入，成功后即可在「主题选择」中使用。也支持从 HTTPS 链接导入
打开主题市场	前往 market.windinput.com 挑选现成主题
主题编辑器直连	见下

从链接导入会先校验

从 HTTPS 链接导入主题时会先交给核心程序校验内容再落盘；导入前的对话框会提示确认来源可信。

主题编辑器直连

开启后，Web 版主题编辑器可以直接读写本机主题，边改边看效果——不必反复导出导入文件。

服务仅监听本机回环地址，不对外网开放。三档：

档位	说明
关闭	不启动本地服务
本次开启	本次运行期间可用，重启后回到关闭
自动开启	每次启动都开

开启后可复制本地连接地址，粘贴到编辑器里建立连接。

自制主题

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

复杂配色建议用编辑器做

主题文件为 TOML 格式（v3）。最省事的做法是继承一个内置主题，只覆盖需要改动的部分；复杂的几何与配色建议直接用主题编辑器可视化制作。内置主题文件位于安装目录下的 data\themes\ 文件夹，可作模板。

快速上手：继承内置主题

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

base = "default"

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

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

主题文件结构

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

块	说明
`base`	继承的内置主题名（`default` / `msime` 或内置基础主题 `_base` / `_qingfeng`）
`[meta]`	元信息：`name`（必填）、`version`、`author` 等
`[colors]`	颜色 token 表（扁平），语义色的唯一来源，`[views]` 通过 `${token}` 引用
`[resources]`	图片资源引用（可选，支持亮暗分设）
`[views]`	几何与布局（候选窗 / 工具栏 / 菜单的盒模型）
`[behavior]`	主题推荐的行为默认（见下）

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

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

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

字段	类型	说明
`font_size`	number	候选字号基准（pt）
`always_show_pager`	bool	始终显示翻页栏（即使只有一页）
`hide_pager`	bool	隐藏整个翻页栏（含箭头）
`show_page_number`	bool	显示页码文字
`pager_align`	string	独立翻页栏行的水平对齐（`left` / `center` / `right`，默认 `center`）；仅竖排独立翻页栏生效，翻页栏并入编码栏时固定右对齐
`vertical_max_width`	number	竖排模式最大宽度（像素）

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

macOS 上的生效范围

主题在 macOS 上只覆盖输入法自绘的界面：候选窗完全生效，状态提示气泡与候选悬停提示框的配色生效。

不生效的两处：

功能主菜单——macOS 上是原生系统菜单，由系统绘制，外观跟随 macOS 自身的浅色 / 深色与强调色。主题里的菜单配色与几何对它无效
工具栏——macOS 没有浮动工具栏，改用菜单栏的输入模式指示器，主题里的工具栏节点无处落地

也就是说，同一份主题在两个平台通用，[views] 里的菜单与工具栏节点在 macOS 上被忽略、其余部分照常。「主题风格」（跟随系统 / 浅色 / 深色）仍然有效。详见 macOS 版 · 菜单不支持主题。

应用兼容性规则

候选框在某个程序里飘到错误位置、候选窗被盖住看不见、或想让某个程序默认英文——这些靠 compat.toml 的逐应用规则修正，与主题无关。完整字段与用法见应用兼容性规则。