跳转到内容

自定义空间主题

Eidos 允许你通过定义自定义 CSS 变量来完全定制工作空间的外观。主题是按空间管理的,这意味着你可以为不同的项目设置不同的视觉风格。

一个主题由一个包含 theme.css 文件的文件夹组成。它必须同时为亮色和暗色模式定义 CSS 变量。

你的 theme.css 必须遵循以下结构,以便 Eidos 能够正确解析变量:

:root {
/* 亮色模式变量 */
--background: hsl(0 0% 100%);
--foreground: hsl(224 71.4% 4.1%);
--primary: hsl(262 83% 58%);
--radius: 0.5rem;
/* ... 其他变量 */
}
.dark {
/* 暗色模式变量 */
--background: hsl(224 71.4% 4.1%);
--foreground: hsl(0 0% 100%);
--primary: hsl(263 70% 50%);
/* ... 其他变量 */
}
  1. 打开空间存储目录

    在 Eidos 桌面版中,你可以通过系统的文件管理器直接访问空间的根目录。

  2. 创建主题目录

    进入空间根目录下的 .eidos 隐藏文件夹,然后深入 themes 目录。创建一个以你的主题命名的文件夹:

    ~/.eidos/themes/my-custom-theme/

  3. 添加 theme.css 文件

    在新建的文件夹内创建一个 theme.css 文件并将你的 CSS 代码放入其中。你可以参考下方 常用变量 来配置基础色调。

  4. 应用你的主题

    打开 设置 (Cmd/Ctrl + ,) → 空间设置外观。你的自定义主题应该会出现在列表中(可能在“已安装”或“本地”分类下)。点击 应用主题 即可看到效果。

Eidos 界面渲染的核心变量如下(基于 Shadcn UI 和 Tailwind CSS):

变量名说明
--background工作空间主背景颜色
--foreground主文字颜色
--primary主色调(按钮图标、选中的激活状态等)
--primary-foreground主色调背景上的文字颜色
--muted弱化的背景色(侧边栏、代码块背景等)
--muted-foreground弱化的文字颜色(如辅助说明文字)
--accent悬停或高亮效果背景色
--border组件边框颜色
--radius界面元素的圆角半径(如 0.5rem0px

如果你创建了一个特别满意的主题并想分享给其他 Eidos 用户,你可以将其贡献到 官方主题注册表

  1. 创建一个公开的 GitHub 仓库并上传你的 theme.cssscreenshot.png 截图。
  2. 向注册表仓库提交 Pull Request,在 themes.registry.json 中添加你的主题信息。