ConfigProvider 全局配置
为组件树提供全局默认配置：尺寸（size）、运行时主题色（themeColor）、语义色（semantic）、密度（density）、语言包（locale）、平台形态（platform）、权限码表（permissions）。放在应用根组件外层，一次配置全局生效。
想先动手试试？主题定制器 提供主色、语义色、密度与磨砂的实时预览。
全局尺寸
size 作为所有组件的兜底尺寸：组件自身的 size 属性 > Form/FormItem 继承 > ConfigProvider 的 size > 默认值。输入类组件经 useFormItem 自动接入，Button 亦已接入：
运行时主题色
themeColor 传入任意十六进制色，全库 7 档色阶与图表色板自动重算（sRGB 混合生成），无需刷新页面。 梯度暗色自适应：html.dark 下 light 档自动改为向深底混合（与暗色手调梯度同向）， 切换明暗时已注入的主色/语义色会跟随重注入，不会发灰发亮。
semantic 可同时动态配置四个语义色（success / warning / danger / info），各自生成完整梯度； persist-theme 开启后主题写入 localStorage，刷新页面仍生效（存档优先于声明式 prop）：
persist-theme 已开启：刷新页面后主题仍是上次选择。组合式 API 见下方说明。
全局密度
density 作用于 html[data-eb-density]，compact / loose 两档调整所有控件的默认高度与间距，适合信息密度差异明显的场景（监控大屏 vs 移动端）：
全局磨砂
glass 打开后，容器类组件（Card / SectionCard / Dialog / Drawer）默认呈现玻璃质感： 半透明底色 + backdrop-filter 模糊，弹层与卡片上下叠加时透出下层内容； 组件级 glass prop 可单独强制开或关（三态）。浏览器不支持 backdrop-filter 时自动回落实底。
权限码表下发
permissions 是 v-permission 指令 / EbAuth 组件 / usePermission 的判定来源。权限在登录后一次性传入，组件树内全部自动响应（切换按钮模拟不同角色的码表）：
ConfigProvider API
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
| size | String | 'default' | 全局组件尺寸 small / default / large |
| locale | Object | zhCN | 语言包对象，内建 zhCN / en / ja / zhTW / ko / es / pt（见 locale/） |
| namespace | String | 'ev' | 类名前缀（保留扩展位） |
| zIndex | Number | 2000 | 弹层 z-index 基准（保留扩展位） |
| platform | String | 'auto' | 容器环境 auto / desktop / mobile；移动端下 Select、DatePicker 呈底部弹出形态 |
| themeColor | String | — | 运行时主色（十六进制）；注入后 7 档色阶与图表色板自动跟随，卸载时恢复默认 |
| density | String | — | 全局密度 compact / default / loose，作用于 html[data-eb-density] |
| glass | Boolean | false | 全局磨砂，作用于 html[data-eb-glass]；容器组件级 glass prop 可单独覆盖 |
| semantic | Object | — | 运行时语义色 { success, warning, danger, info }（十六进制），各生成完整梯度 |
| persistTheme | Boolean | false | 持久化主题到 localStorage（eb-theme-config）；挂载时存档优先于声明式 prop，变更自动保存 |
| permissions | Array | — | 权限码表；v-permission / EbAuth / usePermission 的判定来源 |
编程式用法
脱离组件树也可直接调用主题工具（见 工具类 · 主题与颜色）：
import { setPrimaryColor, setDensity } from '@wil-works/evoke-business-ui'
setPrimaryColor('#0FA968') // 全库主色 + 色阶 + 图表色板即时重算
setDensity('compact') // 全局密度接入说明
- size：输入类组件（Input / Select / InputNumber / DatePicker / Cascader / Checkbox / Radio 等）经
useFormItem自动继承；Button 已单独接入。组件显式传入的size始终优先。 - themeColor / density：作用于
documentElement（全局语义），同页多 Provider 时以最深挂载的为准。 - permissions：未提供时回退到
setPermissions()设置的全局码表。