安装

macOS#

系统要求：macOS 13 或更新。Apple Silicon 与 Intel 各有一个安装包；不确定机型时，点左上角 → 「关于本机」，查看「芯片」一行。

1. 下载 Glimmer-<版本>-arm64.pkg（Apple Silicon）或 Glimmer-<版本>-x86_64.pkg（Intel），双击安装，需要管理员密码。
2. 测试版尚无 Apple 开发者签名，首次打开会被系统拦截：到「系统设置 → 隐私与安全性」，在底部点「仍要打开」，再安装一次。
3. 安装完成后，输入法菜单中出现「微明」。

若未出现，到「系统设置 → 键盘 → 输入法 → 编辑 → +」，在「简体中文」下添加「微明」；仍未出现则注销后重新登录。

安装后请完全退出并重新打开微信与企业微信，使输入法列表更新。若切换到微明时应用退出，见 切换输入法时应用退出。

安装后：

• 菜单栏右上出现「中 / 英」状态项，点击可打开输入法菜单与偏好设置。
• 偏好设置在输入法菜单中，修改即时生效，没有「保存」按钮。
• 首次使用先到「偏好设置 → 通用」选择学习语言（英语 / 日语 / 西班牙语），候选旁的译词即为该语言。

Windows#

系统要求：64 位 Windows 10（1809 或更新）或 Windows 11。安装包自带设置界面所需的运行时，不必另装组件。

1. 下载 Glimmer-<版本>-Setup.exe，双击安装，需要管理员权限。安装目录保持默认的 C:\Program Files\Glimmer，不要改到其他目录或其他盘：候选窗口要盖过开始菜单、任务栏搜索这类系统界面，靠的是 Windows 的 uiAccess 机制，系统只对装在 %ProgramFiles% 里的程序启用它，装到别处会静默失效。
2. 测试版尚无正式的代码签名，SmartScreen 会拦截：点「更多信息 → 仍要运行」。
3. 安装完成后，微明出现在输入法列表中（任务栏右下的「中 / 英」或「拼」处，或按 Win+Space 切换），位于「中文(简体)」之下。

安装后：

• 任务栏右下显示当前为「中」或「英」；桌面上可另开一条悬浮状态条，见 英文模式。
• 设置在开始菜单的「微明设置」，或悬浮状态条上的 ⚙。修改即时生效，没有「保存」按钮。
• 首次使用先到「设置 → 通用」选择学习语言（英语 / 日语 / 西班牙语）。

若某个程序中无法切换到微明，可注销后重新登录，或重启该程序。升级后，已打开的程序需重启才会使用新版本。

已知问题：测试版没有正式的代码签名，在开始菜单、任务栏搜索框、「设置」等系统应用中，候选窗口可能被应用遮挡而不可见；输入与上屏不受影响。此问题将在签名版中解决。装错目录也会出现同样现象，见 遇到问题。

Linux#

系统要求：可安装 deb 包的发行版，使用以下任一输入法框架：

• IBus：Ubuntu 22.04、Debian 12 或更新。GNOME 桌面缺省使用 IBus。
• Fcitx5：需 5.1 或更新，即 Ubuntu 24.04、Debian 13 或更新。KDE 等桌面常用 Fcitx5。

两种框架共用同一个安装包。不确定在用哪一个时，在「终端」中执行 pgrep -l 'ibus-daemon|fcitx5'，看输出中出现的是哪个名字。 x86_64 与 ARM64 各有一个安装包；不确定机型时，在「终端」中执行 dpkg --print-architecture，输出 amd64 选前者，arm64 选后者。

1. 下载 Glimmer-<版本>-amd64.deb（x86_64）或 Glimmer-<版本>-arm64.deb（ARM64）。

2. 打开「终端」，进入下载目录，执行以下命令安装，需要管理员密码：

   sudo apt install ./Glimmer-<版本>-amd64.deb
   

3. 按所用框架添加「微明」：

   • IBus：执行 ibus restart，或注销后重新登录；然后到「设置 → 键盘 → 输入源 → +」，在「汉语」下添加「微明」。
   • Fcitx5：执行 fcitx5 -r，或注销后重新登录；然后打开「Fcitx5 配置」，在「输入法」页的右侧列表中找到「微明」，添加到左侧列表（找不到时取消勾选「仅显示当前语言」）。

安装后：

• IBus 下按 Super + Space 切换输入源；Fcitx5 下按 Ctrl+Space 切换输入法（以 Fcitx5 配置中的「全局选项」为准）。
• Linux 版暂无设置界面，设置保存在配置文件中，位置见 数据与日志。

升级与卸载#

升级时直接安装新版安装包，学习数据与设置均保留。卸载见 卸载。