主题、配色与主题文件

/theme 打开主题选择器，方向键选择并确认，选择会保存到配置。内置既有 Default、Dracula、Tokyo Night 等深色，也有 Default Light、GitHub Light、Google Code 等浅色；实际列表以当前会话为准。

显式配置与交互选择

当前配置键为 ui.theme。主题页开头简写 theme，示例使用 ui 层级；应使用完整位置。官方说明，若设置文件已指定主题名或文件路径，需要先移除该显式值，才能在 /theme 中改变主题。

自定义主题

{
  "ui": {
    "customThemes": {
      "ProjectTheme": {
        "name": "ProjectTheme",
        "type": "custom",
        "background": { "primary": "#181818" },
        "text": { "primary": "#f0f0f0", "secondary": "#a0a0a0" }
      }
    }
  }
}

name 必须与 customThemes 的键一致，type 必须为 custom。其他颜色可选，建议补足背景、主次文字、链接、强调和状态色，检查可读性。

可调部分

text 包含 primary、secondary、link、accent、response；response 在模型回复中优先于 primary。background 可设置 primary 和 diff.added/diff.removed，border 有 default/focused，status 有 success/warning/error，ui 可设 comment、symbol、gradient。

颜色支持十六进制或标准 CSS 色名；不应把无效字符串当成任意终端转义值。

独立主题文件

ui.theme 可以指向独立 JSON 文件，其内容为单个 custom 主题对象。官方限制文件必须在用户 home 目录内，超出会警告并拒绝加载；因此占位 /path/to/theme.json 必须换成符合范围的真实路径。

扩展主题与层级

扩展主题会带名称后缀，例如 shades-of-green (green-extension)。用户、项目和系统层仍遵循配置优先级。自动明暗切换相关 ui.autoThemeSwitching 默认 true，但显式自定义主题与终端背景的实际组合应在当前 UI 验证。