Skip to main content
Step Code 自带六套主题，也可以用 JSON 文件定义自己的配色：放入主题目录后即可在 /theme 中选择，修改当前主题会即时热重载。

​
内置主题

​
主题文件

文件名即主题名，例如 my-theme.json。放入目录后，自定义主题与内置主题一起出现在 /theme 中。建议以完整主题为起点，保留全部颜色字段后再调整配色。 通过资源包分发主题的方式见插件。

​
主题 JSON 格式

主题由 name、可复用颜色变量 vars 和颜色映射 colors 组成。以下示例仅展示部分字段，不能直接作为完整主题使用：
完整主题需定义全部 52 个颜色 token，覆盖核心 UI、背景与内容、Markdown、diff、语法高亮、thinking 边框和 bashMode。 支持真彩色的终端使用 24-bit 颜色；其他终端可能回退为接近的 256 色。 暗色终端宜选明亮且饱和的颜色，亮色终端宜选较暗且低饱和的颜色；公共基色放入 vars 复用。

​
切换主题

也可在配置文件中设置：
仅对一次启动生效：
/theme 打开选择器，自定义主题即时可用，无需重启；/theme <名称> 直接切换。编辑当前使用的主题文件会热重载。 工作行提示通过 config.toml 的 statusTips 设置，见配置文件。

​
出错时的行为

非法色值会使整份主题加载失败并回退到内置 dark；热重载中瞬时出错则保持当前主题不变。请检查 JSON 语法、颜色值、变量引用和字段完整性。