外观

涵盖控制台中小组件外观下的所有设置。实时预览会随着你修改数值即时更新；在保存之前，任何更改都不会应用到你的网站。

预览

本页上的所有设置都会实时渲染到上方的预览区——颜色、字体、Logo、文案，以及启用时的问候语和聊天前表单。

开启聊天前先询问后，预览会一分为二：左侧是对话，右侧是聊天开始前，这样你在编辑表单时，消息样式仍然可见。在窄屏上，两者会上下堆叠显示。

这只是一个近似效果，并非小组件本身。请在真实页面上测试位置和任何依赖 CSS 的效果——参见预览准确性。

身份信息

设置项	默认值	说明
助手名称	`Minaya`	显示在头部，并用于默认问候语。付费计划可用。
Logo URL	Minaya 标志	任意公开可访问的图片 URL。付费计划可用。
欢迎消息	Hi, I am Minaya your AI assistant…	访客看到的第一条消息，会自动代入助手名称。

重命名助手也会同步更改默认问候语，因此它绝不会以错误的名字自我介绍。

主题

Minaya 维护两套配色方案——一套浅色、一套深色。你不需要两套都手动填写：选择一个预设或你的品牌色，其余数值会自动为两套配色方案推导生成。

预设与品牌色

六个预设以迷你小组件的形式展示，因此你选择的是一种观感，而不是一个名字。它们下方的或使用你的品牌色只需一个颜色，即可为其余部分匹配出协调的配色：

头部文字会自动切换为黑色或白色，取二者中可读性更高的一种。
回复气泡会带上你品牌色的浅色调，而不是保持中性灰色。
在深色配色方案中，如果品牌色太深、在近黑色面板上难以阅读，系统会将其调亮直至可读。

每一组自动推导出的配色都能达到 WCAG AA 4.5:1 的对比度门槛，因此即使你之后从不再调整主题，它依然清晰可读。

精细调整

精细调整各项颜色会展开完整的颜色列表。每一项都是可选的—— 不做修改的项会保留其自动推导出的数值。

设置项	作用范围
品牌色	头部栏、访客气泡、发送按钮、启动按钮
头部文字	顶部栏上的助手名称和图标
聊天窗口	对话区域背后的背景
回复背景	每条助手消息背后的背景
回复文字	助手回复中的文字
访客消息文字	访客自己气泡中的文字
占位文字	“输入消息”提示语及其他界面元素

如果你手动设置的某组配色对比度低于 4.5:1，控制台会在原处提示，并标注实测的对比度数值。这只是一个警告，不会阻止保存—— 如果这种低对比度是你有意为之，仍然可以保存。

匹配页面主题

匹配页面主题会让小组件跟随所在网站当前展示的主题。它会按以下顺序检测：

<html> 或 <body> 上的主题信号——dark、dark-mode、theme-dark 类名，或 data-theme、data-color-scheme、 data-mode、data-bs-theme 属性。
若无以上信号，则读取访客操作系统的设置，通过 prefers-color-scheme 判断。

这一点很重要，因为 prefers-color-scheme 仅反映操作系统的设置。一个自带明暗切换功能的网站，即使操作系统是浅色模式，也可能显示为深色；若小组件只依赖该媒体查询，就会在深色页面上依然显示为浅色。

小组件会持续监听变化，因此点击你网站自身的主题切换按钮会让小组件立即重新渲染——无需刷新页面。

Minaya 检测的内容

你不需要在任何地方重新声明你的配色。两套配色方案都来自控制台；检测机制只决定展示哪一套。Minaya 按以下顺序检测：

<html> 或 <body> 上的主题信号——dark、 dark-mode、theme-dark、is-dark 或 night 类名，或 data-theme、 data-color-scheme、data-mode 或 data-bs-theme 属性。
页面实际的背景颜色。如果没有发布任何信号， Minaya 会读取页面实际渲染出的背景色并进行匹配。无论采用何种机制—— 未被识别的类名、包裹元素、CSS 变量还是内联样式——都同样适用。
操作系统设置，通过 prefers-color-scheme 判断，仅在页面未提供任何可用信号时启用。

变化会被持续监听，因此点击你网站自身的切换按钮会让小组件立即重新渲染——无需刷新页面。

WordPress

Minaya 能识别以下插件和主题发布的信号，因此深色模式无需任何配置即可生效：

插件或主题	信号
WP Dark Mode	`<html>` 上的 `data-wp-dark-mode-active` 和 `.wp-dark-mode-active`
Darklup / Darklup Lite	`<html>` 上的 `.darkluplite-dark-mode-enabled`
Droit Dark Mode	`<html>` 上的 `.drdt-dark-mode`
Blocksy	`<html>` 上的 `data-color-mode`
Astra	`<html>` 或 `<body>` 上的 `.astra-dark-mode-enable`

WP Dark Mode 和 Droit 在访客切换主题时还会触发各自的事件，Minaya 会监听这些事件—— 因此小组件能立即重新渲染，而不必等待检测到类名变化。

区块主题

区块主题——Twenty Twenty-Four、Twenty Twenty-Five 以及其他 完整站点编辑（full site editing）主题——是需要特别注意的情况。切换到诸如 Midnight 之类的深色样式变体时，改变的只是 CSS 自定义属性的值；<body> 的类名列表逐字节完全相同，没有任何东西可供检测。

这正是 Minaya 会读取页面实际渲染背景色、而不仅仅依赖类名的原因。即使区块主题的深色变体完全没有发布任何信号，也能被正确检测到。

颜色反转

深色模式插件会对整个页面进行颜色反转。而 Minaya 本身已经具备主题功能，再叠加一次反转会破坏你的配色——因此小组件会携带各插件的排除类（wp-dark-mode-ignore 及其等效类名），使其不受影响，无需任何配置。

还有一点需要了解：页面构建工具的情况有所不同。Elementor 的深色模式仅作用于其编辑器界面，并不影响已发布的页面；Divi 则没有内置的前台深色模式—— 因此这两者都不会改变访客实际看到的效果。

直接告知 Minaya

如果你的网站以上述方式都无法捕获的某种机制切换主题，可以触发一个事件，Minaya 会随之响应：

// Force a palette.
window.dispatchEvent(
  new CustomEvent("minaya:theme", { detail: { theme: "dark" } })
);

// Or just ask Minaya to re-check the page.
window.dispatchEvent(new CustomEvent("minaya:theme"));

使用 jQuery 时，$(window).trigger() 无法触达原生事件监听器—— 请按上面的方式直接派发事件。

位置与行为

位置——左下角或右下角。
自动打开——页面加载时直接打开面板，而不必等待点击。默认关闭。自动打开在分析统计中仍计入一次小组件打开。

与屏幕边缘的间距通过 CSS 设置，而非表单字段——参见自定义 CSS。

最小化

小组件头部的一个箭头图标可将面板收起为启动按钮。这是最小化而非关闭：对话内容会被保留，重新打开时会精确恢复到访客离开时的状态。点击启动按钮效果相同。

问候气泡

启动按钮上方显示的一句简短提示，出现在小组件被打开之前——默认文案是 “Hey there, how can I help you today?”。点击它会打开聊天窗口。

在位置下开启此项并编写你自己的文案。它会跟随你的主题，因此在浅色和深色模式下都能正确显示，并且可以在语言下为每种语言分别设置。

有三个行为值得了解：

每次访问只显示一次。关闭它，或打开聊天窗口，会让它在本次会话的其余时间内不再出现——它不会在每个页面上重复出现。
在手机上隐藏，因为启动按钮旁边的气泡会遮挡页面内容。
小组件自动打开时不显示，因为此时面板本身已经出现。

聊天前先询问

有些团队希望在对话开始前先获取姓名和邮箱。在“位置”下开启 聊天前先询问，访客首次打开小组件时就会看到一个简短的表单。

标题和提示文字由你自行编写。要求填写邮箱决定该表单是强制拦截对话，还是仅作为一个可选项提供——关闭该选项时，访客会看到一个跳过按钮，可以直接开始聊天。

每位访客只会被询问一次。回访会话已经携带其信息，因此表单不会再次出现。

访客填写的内容会与对话一起存储，并与聊天记录一同显示在你的控制台中。如果表单因任何原因提交失败，访客仍会被放行而不会被拦截—— 这些信息对你而言只是一种便利，而不是获得帮助的前提条件。

品牌标识

免费计划的小组件在输入框下方会带有一个小小的 Powered by Minaya 链接。它会跟随你的配色，并以较低对比度显示，因此看起来更像是一个署名，而非广告。

任何付费计划都会移除它。这一项没有单独的开关——它与你的计划绑定，因此升级计划后会自动移除，无需额外配置。

字体

选择系统默认以继承你网站的字体，或者选择一款 Google 字体（Poppins、Roboto、Open Sans、Lato、Montserrat、Inter）。继承字体通常观感最自然。

兜底消息

当 Minaya 无法回答时显示的消息。关于如何撰写一条好的兜底消息，参见回答质量。

外观

预览