键影支持

适用版本：v0.1.0 · 更新日期：2026 年 10 月 3 日

键影是双拼学习提示工具，不代替输入法。完整的设置说明见 通用操作。

安装与权限

  • macOS 13+：把「键影.app」拖入「应用程序」后打开。在「系统设置 › 隐私与安全性 › 输入监控」中允许键影；「辅助功能」可选，用于识别密码框和文字光标位置。也可以从菜单栏键影图标 →「权限设置」查看授权状态。
  • Windows 10 / 11：需要 .NET Framework 4.8。把「键影.exe」放在固定的本地目录后双击运行，程序驻留在系统托盘。

打字时键盘没有出现

  • 确认当前是中文输入状态。ABC / 英文输入源和 Caps Lock 会按英文处理。
  • 提示可能被关闭了：按 Control + Option + F8（macOS）或 Ctrl + Alt + F8（Windows）恢复，也可以从菜单栏 / 托盘恢复。部分 Mac 键盘需要同时按 Fn。
  • macOS 上没有任何按键高亮时，检查「输入监控」是否已授权；授权后如果仍无反应，请退出并重新打开键影。

提示的键位和输入法对不上

在底栏或菜单的「方案」里选择与输入法一致的双拼方案。零声母的部分兼容编码需要输入法支持，点「规则」可以查看当前方案的说明。

切到英文后仍然有提示

部分第三方输入法的内部英文模式不会改变系统输入源，键影因此仍判断为中文。此时可以切换到系统 ABC，或用快捷键暂时关闭提示。Windows 上已验证微软拼音，其他输入法依赖同一系统接口。

键盘出现的位置不对

  • 自动位置优先使用文字光标，其次是输入框范围、当前窗口最近一次点击的位置和保存的位置。不支持光标定位的应用里，位置只是估算，再点一下输入框即可重新定位。
  • 拖动完整模式的顶部空白处（紧凑模式拖动键区）会改为固定位置；菜单「恢复位置与透明度」可恢复默认。

键盘挡住了下面的内容

开启鼠标穿透：Control + Option + F9（macOS）或 Ctrl + Alt + F9（Windows）。穿透时请从菜单栏 / 托盘操作键影。也可以调低不透明度或切到紧凑模式。

Windows 提示「已保护你的电脑」

当前的 EXE 尚未代码签名。选择「更多信息 → 仍要运行」即可；如需核对文件，可与 Release 附带的 .sha256 校验值比对。

卸载

  • macOS：先在菜单中取消「登录时启动」，再删除「键影.app」。设置保存在 uy.aix.keyshadow 偏好中。
  • Windows：先取消「开机启动」，再删除 EXE。删除 %LOCALAPPDATA%\keyshadow\settings.txt 可清除其余设置。

反馈问题

请在 GitHub Issues 提交，或发邮件至 [email protected]。请附上系统版本、键影版本（菜单底部可见）、输入法、双拼方案和复现步骤；不要附带任何输入内容或密码。