主题

Mayfly 的视觉表面全部由一张语义色表驱动。/theme 命令在这张表的不同提供方之间热切换——切换会重建渲染树，但输入草稿、历史与输入模式经 draft stash 存活。

/theme 用法

usage: /theme [dark|light|ocean|paper|auto|custom <path> [dark|light|ocean|paper]]

切换实现为 provider fiber 的整体替换：依赖主题的插件（transcript、输入层等）随之重载。挂载失败时会自动回退到内置 dark 调色板，界面永远不会没有主题。

键	风格
`dark`	默认暗色（近黑背景、品牌紫渐变蜉蝣标志、紫罗兰主色）
`light`	浅色（GitHub primer 系，二级灰加深一档，不再发淡）
`ocean`	蓝灰底冷色暗色（天蓝主色 + 青绿点缀）
`paper`	暖纸底浅色（焦橙主色 + 墨青点缀）

auto 不是独立调色板，而是按终端背景在 dark/light 间二选一；custom 见下文。

/theme 切换的是会话级主题；持久默认写在 settings.yaml 的 mayfly: 段（或用 /settings 面板的 Theme 行循环修改——实时生效、同时落盘）：

yaml

mayfly:
  theme: ocean   # dark | light | ocean | paper | auto

启动时应用该默认；会话内的 /theme 选择覆盖它，且无关的设置写入不会把会话选择冲掉。custom 调色板（/theme custom <path>）保持会话级，不落盘。

custom 主题从 JSON 文件读取 token 到 #rrggbb 十六进制色的映射，叠在 base（dark 或 light）之上：

json

{
  "primary": "#9A86E6",
  "accent": "#C9C0F0",
  "roleUser": "#9A86E6",
  "selectedBg": "#221E38"
}

规则：

只需写想覆盖的 token，其余落到 base 的对应项；
未知 token（不在下表中，亦非下方的 logoGradient）与非法颜色（非 #rrggbb 格式）会被丢弃并打印警告，回退 base 对应项；
logoGradient 是唯一接受数组的 token——一个非空 #rrggbb 数组，自上而下逐行染横幅 logo；
文件不可读或不是 JSON 对象时，整表回退 base。

以 dark 调色板的值为参照（light/ocean/paper 各有对应值；auto 按 OSC 11 探测结果在 dark/light 间二选一）：