Skip to content

MacroKey 编辑器

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

数据模型在哪

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

入口

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

编辑器可配置项

  • 主标签 / 副标签 / 长按标签
  • 三组宏序列:tap / swipe / longPress
  • 每个 step 在面板中按顺序添加、拖拽重排、删除
  • step 类型可在下拉中选择(按键 / 文本 / 编辑命令 / 快捷键 / app action / layer 等)
  • 每个 step 类型显示对应的字段输入(如 KeyRef 选择器、文本框)
  • KeyRef 选择器仅暴露 Fcitx 键名 列表(如 Return / Shift_L / 字母数字等)
  • swipe label 可在键面上预览

编辑器不支持 Android 键码

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

相关页面

本项目基于 fcitx5-android/fcitx5-android 修改。源码与文档以 LGPL-2.1 发布。