Skip to content

MacroKey 编辑器 ​

应用内可视化编辑 MacroKey 的工具,避免手写 step 数组。

数据模型在哪

本页只描述编辑器的使用入口;MacroKey 的全部字段、step 类型与 JSON 结构请见 MacroKey 细化。

入口 ​

在 键盘布局编辑器 中选择一个按键,将类型切换为 MacroKey 即可进入 MacroKey 编辑器。

编辑器可配置项 ​

  • 主标签 / 副标签 / 长按标签
  • 显示文本:可按方案分别设置;显式填写的值按原样显示(优先于标签,不再被 Shift 改写成小写),留空回落到标签——预览与保存遵循同一优先级
  • 三组宏序列:tap / swipe / longPress
  • 每个 step 在面板中按顺序添加、拖拽重排、删除
  • step 类型可在下拉中选择(按键 / 文本 / 编辑命令 / 快捷键 / app action / layer 等)
  • app action 列表包含本版新增的「切换系统输入法」与「弹出 Rime 方案选单」
  • 每个 step 类型显示对应的字段输入(如 KeyRef 选择器、文本框)
  • KeyRef 选择器仅暴露 Fcitx 键名 列表(如 Return / Shift_L / 字母数字等)
  • swipe label 可在键面上预览

编辑器不支持 Android 键码

KeyRef 的另一种形式 {"android": <code>} 只在手改 JSON 时可用,编辑器界面没有对应输入项。如果按键里已经存在 Android 键码引用,不要再用编辑器二次保存 —— 编辑器可能不识别这种条目导致信息丢失。详见 MacroKey 细化 → KeyRef。

相关页面 ​