Skip to content

KeySteer v0.10.22

Choose a tag to compare

View all tags
@github-actions github-actions released this 23 Sep 03:23
v0.10.22
eae9ffd
This commit was signed with the committer’s verified signature.
dccif
GPG key ID: CC325FAB0CEB75D4
Verified
Learn about vigilant mode.

更新内容 / What's Changed

  • 破坏性改动： 模式标识符移除 position、indicator_x_offset、indicator_y_offset，全局 [mode_indicator.ui] 和单模式 [mode_indicator.modes.<模式>.ui] 均只使用 indicator_offset = [X, Y]。旧字段会导致配置校验失败，请在升级前删除并迁移；即使已配置新数组，也必须删除旧字段。

  • 偏移以鼠标热点为原点，定位标识符的右上角；正 X 向右、正 Y 向下，范围为 -32768～32767。全局未配置时默认 [-12, 18]，单模式未配置时继承全局值。可在网页模拟器拖动锚点调整并导出配置。

  • 补齐代码内置 Normal 默认绑定：. 向左滚动、/ 向右滚动，与发布的默认配置保持一致。

  • Breaking change: Removed mode-badge position, indicator_x_offset, and indicator_y_offset. Both [mode_indicator.ui] and [mode_indicator.modes.<mode>.ui] now use only indicator_offset = [X, Y]. Old fields fail configuration validation; remove and migrate them before upgrading, even if the new pair is already present.

  • The offset places the badge's top-right corner relative to the cursor hotspot. Positive X moves right and positive Y moves down; each integer ranges from -32768 to 32767. The global default is [-12, 18]; omitted per-mode offsets inherit it. Drag the anchor in the web simulator and export the result.

  • Added the missing embedded Normal defaults: . scrolls left and / scrolls right, matching the shipped configuration.

迁移示例 / Migration example

将旧的 position = "bottom_left"、indicator_x_offset = -12、indicator_y_offset = 18 三项删除，替换为下方配置。

旧 bottom_left 可直接使用原 X/Y；旧 bottom_right 需在 X 上加标识符宽度，top_left 需从 Y 减标识符总高度，top_right 同时调整两者。宽高受字体、内边距和第二行按键提示影响，建议用网页拖动重新定位。单模式覆盖使用相同格式。其他样式字段不变。

Remove position = "bottom_left", indicator_x_offset = -12, and indicator_y_offset = 18, then use the shared configuration below.

For old bottom_left placement, reuse X/Y directly. For bottom_right, add the badge width to X; for top_left, subtract the total badge height from Y; for top_right, apply both adjustments. Dimensions depend on font, padding, and the second held-input line, so dragging in the web editor is recommended. Per-mode overrides use the same format. Other style fields are unchanged.

[mode_indicator.ui]
indicator_offset = [-12, 18]

macOS manual installation

If you install KeySteer.app manually from this official GitHub Release and macOS Gatekeeper refuses to open it, move the app to /Applications and run:

如果你从本项目的官方 GitHub Release 手动安装 KeySteer.app，但 macOS Gatekeeper 阻止打开，请先将应用移到 /Applications，然后执行：

sudo xattr -cr /Applications/KeySteer.app

Full Changelog: v0.10.21...v0.10.22

Assets 6
Loading