Skip to content

CSS 样式覆盖

AIO Hub 提供强大的 CSS 样式覆盖 功能,允许你通过编写自定义 CSS 代码来深度定制应用界面。无论是个性化配色、调整布局间距,还是隐藏不常用的元素,都可以通过此功能实现。


快速开始

  1. 点击标题栏右侧的 ⚙️ 图标进入设置。
  2. 在设置左侧导航栏中点击「CSS 样式覆盖」选项卡。

编辑器使用

系统内置了一个双引擎代码编辑器(CodeMirror/Monaco),支持语法高亮和自动补全。

  • 实时生效:编辑器具备 500ms 的防抖自动保存功能,修改后无需手动保存,稍等片刻即可在应用中看到效果。
  • 状态指示:编辑器右上角会显示当前的保存状态(保存中... / 已保存)。

预设管理

为了方便用户,我们提供了预设管理系统:

状态说明
内置预设应用自带的 CSS 主题预设,由开发者维护。
用户自定义预设你自己保存的 CSS 片段,方便在不同风格间切换。
纯自定义模式不依赖任何预设,在编辑器中完全自由发挥。

操作流程

  1. 在下拉菜单中选择一个预设。
  2. 进入预览模式:此时编辑器为只读,展示预设内容。
  3. 点击「应用选中的预设」:预设内容将正式写入你的自定义 CSS 配置并生效。
  4. 在编辑器中根据需要进行二次修改。

核心变量与类名

AIO Hub 基于现代 CSS 变量(CSS Variables)构建,你可以通过覆盖这些变量来快速改变整体风格。

主题变量

详情请参阅 主题外观系统,以下是常用变量:

css
:root {
  /* 基础颜色 */
  --primary-color: #409eff;

  /* 界面质感(受外观设置影响) */
  --card-opacity: 0.8;
  --ui-blur: 10px;

  /* 背景色(推荐覆盖这些变量而非直接改 background) */
  --card-bg: rgba(255, 255, 255, var(--card-opacity));
  --sidebar-bg: rgba(245, 247, 250, var(--card-opacity));
}

/* 深色模式覆盖 */
.dark {
  --card-bg: rgba(30, 30, 30, var(--card-opacity));
}

常用选择器

目标元素类名 / 选择器
应用根容器#app
自定义标题栏.title-bar
侧边栏.main-sidebar
内容主区域.main-content
工具卡片.tool-card

进阶技巧

1. 强制覆盖

如果你的样式没有生效,可能是因为 CSS 优先级不足。可以使用 !important,或者增加选择器的权重:

css
/* 增加权重示例 */
#app .main-sidebar {
  width: 260px !important;
}

2. 隐藏特定元素

如果你觉得某个按钮或面板碍眼,可以将其隐藏(例如隐藏标题栏的文字):

css
/* 隐藏标题栏左侧的 "AIO Hub" 文字 */
.title-bar .brand-title {
  display: none;
}

3. 针对特定工具定制

每个工具通常都有唯一的 ID 或特定的类名,你可以利用这一点进行精准定制:

css
/* 仅修改聊天界面中的消息气泡圆角 */
.chat-message ::after {
  border-radius: 16px;
}

最佳实践

  • 优先使用变量:修改 --primary-color 比修改几十个按钮的 background-color 要高效得多。
  • 利用审查元素:即使在正式构建版本中,你也可以通过 F12 或右键点击选择“检查”(取决于系统 WebView 环境)来打开开发者工具,实时查找需要修改的类名。
  • 备份你的 CSS:虽然系统会自动保存,但在进行大规模修改前,建议将代码复制到外部文档备份。
  • 通透感维持:修改背景色时,建议使用 rgba() 并配合 var(--card-opacity),以保持应用整体的毛玻璃通透感。

警告:错误的 CSS 代码可能会导致界面布局错乱。如果发生这种情况,请清空编辑器内容,应用将恢复默认样式。

Released under the Apache-2.0 License.