布局预览（实时渲染，点击按键即可编辑）
角标说明：右上蓝色 = 长按提示（longPress.label，如 ⌫、⇪）·
右上橙色 = 按住提示（hold.label，如语音）·
底中 ⌄ = 长按弹出菜单（longPress.popupKey，候选在「弹出菜单」页编辑）·
上/下/左/右灰色小字 = 滑动提示 ·
红色虚线框 = 引用无法解析 ·
黄色框 = 选中按键
布局与文件操作
布局文件请放置于
<外部存储>/foxy/frontend/layouts/<profile>.json 后在 Foxy 设置中选择。布局编辑
布局高度覆盖（可选，百分比 10–90）
布局变体（状态条件 → 使用其他命名布局）
布局 JSON（实时同步；可直接编辑后“应用”）
按键定义（keys）— 可复用按键与手势
动作定义（actions）
宏（macros）
弹出菜单文件
文件请放置于
<外部存储>/foxy/frontend/popups/<profile>.json弹出效果预览
弹出菜单键定义（schemas）
弹出菜单 JSON（实时同步；可直接编辑后“应用”）
主题文件
文件名为主题的
name 字段（非法字符百分号转义）+ .json，放置于
<外部存储>/foxy/frontend/themes/（精确路径
Android/data/com.fxliang.foxy/files/foxy/frontend/themes/）。注意：
light / dark 是两套配色槽位，与预览右上角的深浅开关不是一回事。
key_border_enabled / key_stroke_enabled / show_swipe_hints*
都是 App 的全局设置（不在主题 JSON 里），已移到预览键盘的滑杆行上。建模边界：预览键盘只画键面，不含 App 的候选栏 / 工具栏。
因此
candidateBarColor、accentColor（工具栏选中态）等字段在预览里看不到效果
—— 它们只影响候选栏与工具栏，不是没生效。主题校验
槽位全局配色（26 个字段）
键类型配色 keyTypes（LETTER / FUNCTION / ACTION）
主题 JSON（实时同步；可直接编辑后“应用”）
符号面板文件
目录
<外部存储>/foxy/frontend/{symbols,emoji,kaomoji}/（精确路径
Android/data/com.fxliang.foxy/files/foxy/frontend/…）。该目录开机后是空的，
且必须在 App 的「设置 → 符号布局」里显式选中才会改读外部文件；否则一直读 APK 内置（assets）。