CherryCSS 主题 CSS 制作指南

SkillDev tools

Guide to creating CSS themes for Cherry Studio — learn the CSS variable system, frosted glass techniques, gradient backgrounds, and more, ending with CSS code that can be pasted and used directly.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the CherryCSS 主题 CSS 制作指南 skill

What this skill tells your AI

The instructions your AI receives, as published by boilcy/cherrycss in SKILL/SKILL.md and read by ahel’s review.

本 skill 指导你为 Cherry Studio 制作自定义 CSS 主题,最终输出是一段可直接粘贴到 Cherry Studio 设置 → 显示设置 → 自定义 CSS 的代码

制作主题前,可先访问 CherryCSS 项目网站 cherrycss.com 浏览已有主题的样式和效果,获取配色和风格灵感喵~

Cherry Studio CSS 变量系统

Cherry Studio 通过 CSS 变量控制主题外观。核心变量如下:

颜色变量

变量作用暗色模式参考值亮色模式参考值
--color-background主背景深色亮色
--color-background-soft次背景稍亮稍暗
--color-background-mute更深层背景更亮/更暗更暗/更亮
--color-primary主题强调色#7C5CFC#7C5CFC
--color-primary-soft柔和主题色primary 60% 透明度同左
--color-primary-mute淡主题色primary 20% 透明度同左

文字变量

变量作用
--color-text-1主文字
--color-text-2次文字(70% 透明度)
--color-text-3占位文字(45% 透明度)

界面变量

变量作用
--color-border边框色
--chat-background-user用户消息背景
--chat-background-assistantAI 消息背景
--navbar-background / --navbar-background-mac导航栏背景
--color-hover悬停态背景
--color-active激活态背景
--color-code-background代码块背景

常用 CSS 技法

1. 基础变量覆盖

两种模式都需要覆盖,格式如下:

/* 暗色模式 */
body[theme-mode="dark"] {
  --color-background: #1A1A2E;
  --color-text-1: #F0EEF5;
  --chat-background-user: rgba(124, 92, 252, 0.15);
  /* ... */
}

/* 亮色模式 */
body[theme-mode="light"] {
  --color-background: #F0EEF5;
  --color-text-1: #2D2B3A;
  --chat-background-user: rgba(124, 92, 252, 0.08);
  /* ... */
}

2. 毛玻璃效果(核心属性:backdrop-filter)

.glass {
  background: rgba(20, 16, 50, 0.50) !important;
  backdrop-filter: blur(16px) saturate(180%) !important;
  -webkit-backdrop-filter: blur(16px) saturate(180%) !important;
}

建议分层模糊强度:

  • 8px — 消息气泡、代码块
  • 12px — 内容容器、折叠面板
  • 16px — 侧边栏、导航栏、输入框
  • 20px — 模态框、下拉菜单

3. 渐变背景

body[theme-mode="dark"] {
  --color-background: linear-gradient(135deg,
    rgba(15, 12, 41, 0.92) 0%,
    rgba(48, 43, 99, 0.85) 50%,
    rgba(36, 36, 62, 0.92) 100%
  );
}

配合 body::after 伪元素实现毛玻璃渐变背景:

body::after {
  content: "";
  position: fixed;
  inset: 0;
  z-index: -1;
  background: var(--color-background);
  backdrop-filter: blur(16px) saturate(180%);
}

4. 消息气泡边框

.chat-item.user .message-content-container {
  border-left: 3px solid rgba(124, 92, 252, 0.40) !important;
}

.chat-item.assistant .message-content-container {
  border-left: 3px solid rgba(255, 255, 255, 0.10) !important;
}

5. 输入框聚焦光晕

#inputbar:focus-within {
  border-color: rgba(124, 92, 252, 0.50) !important;
  box-shadow: 0 0 12px rgba(124, 92, 252, 0.15) !important;
}

输出格式

根据用户需求输出完整可用的一段 CSS,包含:

  1. 注释头(主题名称、风格说明)
  2. CSS 变量覆盖(深色 + 亮色)
  3. 特定元素样式定制

示例结构:

/*
========================
主题名称 · 风格说明
========================
支持 Windows / macOS 双平台
*/

/* ===== 全局变量 ===== */
:root {
  /* 全局变量定义 */
}

/* ===== 暗色模式 ===== */
body[theme-mode="dark"] {
  /* 暗色变量覆盖 */
}

/* ===== 亮色模式 ===== */
body[theme-mode="light"] {
  /* 亮色变量覆盖 */
}

/* ===== 特定元素样式 ===== */
/* 侧边栏、导航栏、输入框、消息气泡、面板等 */

Signals

GitHub stars
218
Forks
28
Last commit
Aug 2026
Advanced
Catalog kind
skill
Gateway key
cherrycss-theme
Source
github.com/boilcy/cherrycss