主题控制台与调色板

主题控制台用于在线预览当前主题的配置和配色。它不会直接修改你的 Notion 数据库；你可以先在页面上调整效果，确认后复制配置写入 notion_config。

打开入口

开启主题切换工具后，页面左下角会出现浮动工具：

• 左侧握柄：拖拽移动工具位置。
• 主题名：打开主题选择抽屉，切换预览主题。
• 设置按钮：打开当前主题控制台。
• 深浅按钮：快速切换浅色模式和深色模式。

控制台标题会显示当前主题名，例如 主题控制台 · Heo。如果切换主题，控制台内容也会切换到对应主题的配置。

信息配置

“信息配置”展示当前主题允许在线调整的安全配置，例如菜单开关、展示文案、首页显示方式等。主题级配置通常不包含密钥，因此可以在这里实时预览。

部分配置修改后会立即反映在页面上；如果某个配置涉及数据拉取、构建阶段或服务端逻辑，仍然需要刷新页面或重新部署后生效。

配色

“配色”按浅色模式和深色模式分成两组。每个主题至少会提供：

• 主色
• 页面背景
• 卡片背景
• 主文字
• 边框

复杂主题还会提供次级文字、强调色、hover 色、导航背景、滚动条等实际用到的颜色。颜色可以通过色块选择，也可以直接输入色值，例如 #4f65f0 或 rgba(0, 0, 0, 0.15)。

浅色和深色配置互相独立。修改“深色模式：主色”不会影响浅色模式，修改“浅色模式：页面背景”也不会影响深色模式。

复制配置

每个配置项都有两个复制入口：

• 配置名复制：复制 HEO_COLOR_PRIMARY 这类键名。
• 配置值复制：复制当前输入框里的值。

控制台顶部还提供批量导出入口，会把当前主题控制台里的配置生成一段可粘贴到 notion_config 的文本。

示例：

HEO_COLOR_PRIMARY=#4f65f0
HEO_COLOR_TEXT=#111827
HEO_COLOR_BG=#f7f9fe
HEO_COLOR_PRIMARY_DARK=#8ea2ff
HEO_COLOR_TEXT_DARK=#f3f4f6
HEO_COLOR_BG_DARK=#18171d

导入配置

点击导入按钮后，可以粘贴同样格式的配置片段。控制台会解析当前主题支持的配置项，并立即预览可生效的部分。

建议一次只导入当前主题相关的配置，避免不同主题的配置混在一起难以排查。

重置默认值

“信息配置”和“配色”折叠条右侧都有重置按钮。点击后会把该区块恢复为主题默认值，便于快速回到原版效果。

常见问题

如果调整后页面没有变化，通常有三种原因：

• 当前配置项只影响特定区域，你需要滚动到对应组件查看。
• 当前页面处在浅色模式，但你修改的是深色模式配置，或相反。
• 主题开发者只声明了配置项，但组件还没有真实消费对应 CSS 变量。

内置主题会逐步保证所有常用颜色都接入控制台；自定义主题建议参考开发者文档中的主题控制台接入约定。