终端主题与自动检测

/theme 提供内置和自定义主题选择，选择保存到配置。若 settings.json 已显式指定 ui.theme 名称或文件路径，官方要求先移除该字段，才能通过对话框改变选择。

自动主题

ui.theme 未设置或为 auto 时，选择匹配背景的 Qwen Dark / Qwen Light：

{
  "ui": {"theme": "auto"}
}

启动依次尝试 COLORFGBG、TTY 的 OSC 11 背景查询、macOS 系统外观，最后回退深色。OSC 查询约等 200ms，第一项有效结果胜出，结果在会话内缓存；重新选择 Auto 不表示每次重新探测外观。

tmux/screen 可能不转发 OSC 11；SSH 依赖远端环境与终端应答。自动选择不符合实际背景时，显式选主题比依赖不可用探测更直接。

内置选择

深色包含 ANSI、Atom One、Ayu、Default、Dracula、GitHub、Qwen Dark、Shades Of Purple。浅色包含 ANSI Light、Ayu Light、Default Light、GitHub Light、Google Code、Qwen Light、Xcode，以 /theme 当前列表为准。

自定义调色板

在 ui.customThemes 中以主题名作为键，name 必须相同、type 必须 custom。完整示例：

{
  "ui": {
    "customThemes": {
      "ProjectDark": {
        "name": "ProjectDark",
        "type": "custom",
        "Background": "#181818",
        "Foreground": "#F2F2F2",
        "LightBlue": "#82AAFF",
        "AccentBlue": "#61AFEF",
        "AccentPurple": "#BD93F9",
        "AccentCyan": "#8BE9FD",
        "AccentGreen": "#50FA7B",
        "AccentYellow": "#F1FA8C",
        "AccentRed": "#FF5555",
        "Comment": "#6272A4",
        "Gray": "#ABB2BF"
      }
    }
  }
}

上述颜色字段均必需，可用十六进制或标准 CSS 颜色名；DiffAdded、DiffRemoved、DiffModified 可选。自定义主题可放用户、项目或系统范围，遵循一般设置优先级。

单独主题文件

也可把一个主题对象保存为 JSON，再让 ui.theme 指向该文件。只加载 home 目录内的主题文件，外部路径会警告并拒绝。文件内容是主题对象本身，不是包裹 ui.customThemes 的整个 settings。

不要把官方省略号示例当成完整可解析 JSON；先检查必需颜色字段与 name，再载入。