# 主题 — Liu Terminal

> Liu Terminal 主题。19 种内置配色主题，加上支持实时预览的完整 JSON 自定义主题。

URL: https://liu.software/zh/docs/themes/  
Language: zh  
Updated: 2026-10-17

Liu 内置 18 种调色盘，读取 ~/.config/Liu/themes/ 中的用户主题，并可通过本地 AI 代理按需生成新主题。

## 使用 AI 创建主题

按下 ⌘ K → 创建主题。对话框打开后描述外观并选择本地代理。Liu 会在 PATH 上自动检测 Claude Code、Codex、OpenCode、Cursor Agent、Amp、Cline 和 Grok —— 选您已安装的即可。

1. 输入简短描述："温暖的 Solarized 但更饱和"、"柔和的绿色、纸质感"、"高对比度单色蓝"。
2. 选择一个代理。Liu 会使用结构化提示调用其 CLI。
3. 返回的 JSON 经过 Schema 验证，实时应用并保存到 ~/.config/Liu/themes/。

此子系统正在重写中。对话状态机位于 src/main.c，外观选项卡条目位于 src/ui/settings.c；重写完成后两者都将移动。

## 选择内置主题

打开命令面板（⌘ K）并输入 theme。列表显示所有内置和用户主题。在条目上按 ↵ 应用；设置 → Appearance 也提供实时预览网格。

## 编写自己的主题

将 JSON 文件放入 ~/.config/Liu/themes/。Liu 在下次启动时加载。Schema 与内置和 AI 主题相同——请显式列出每个颜色字段（尚无 extends 继承）。

## 主题 JSON 模式

颜色值是 0–1 范围内的四元素 RGBA 数组。完整导出包含基础颜色、ansi\_0 到 ansi\_15、标签页、侧栏、边框/滚动条、状态、ui\_accent、voice\_record 和 voice\_accent 字段。

可选标量覆盖项为 opacity（0 = 不覆盖）、cursor\_style（1 = block、2 = underline、3 = bar）、cursor\_blink 和 bold\_is\_bright。缺失的标签文字颜色会为可读性而修复；主题之间不继承。

## 颜色编码

在内部，Liu 将单元格前景和背景存储为单个 u32。0–255 为 ANSI 调色板索引；第 24 位（0x01RRGGBB）标记 24 位真彩色。使用 src/terminal/terminal.h 中的 IS\_TRUECOLOR(c) 宏检查。

主题文件始终使用十六进制字符串 —— 位打包形式仅是实现细节。真彩色默认启用。

[下一步 标签与分栏 →](https://liu.software/zh/docs/tabs.md)