# Release Notes

发布说明 | Release Notes

---

## v2.3.1 - 2026-07-15

### 原生 Vim 插件：Hammerspoon 稳定方案

本版本更新的是原生 Vim 插件 `vim-im-switch-select.vim`。Obsidian 插件逻辑不变。

#### 改进

- macOS 原生 Vim 插件改为 Hammerspoon 优先：
  - Normal / Esc 使用 `hs.keycodes.setLayout("ABC")` 切到英文。
  - Insert 恢复中文时使用 `hs.keycodes.setMethod("Pinyin – Simplified")`。
  - `im-select` 仅作为 fallback。
- 修复 Apple 拼音可能出现的状态不一致问题：

  ```text
  sourceID = com.apple.inputmethod.SCIM.ITABC
  layout   = ABC
  method   = Pinyin – Simplified
  ```

  该状态下菜单栏可能显示中文，但实际仍输入英文。

- Insert 模式支持同一 Vim 进程内状态记忆：
  - Insert 中使用中文，`Esc` 后再进入 Insert 恢复中文。
  - Insert 中手动切英文，`Esc` 后再进入 Insert 恢复英文。
- 记录已知限制：退出 Vim 后状态不持久化，重新打开 Vim 后首次 Insert 默认中文。

#### 文档

- 重写 README，明确当前稳定策略。
- 补充 Obsidian 插件说明：仍使用 `fcitx-remote`，未改为 Hammerspoon。
- 合并 `README-im-select.md` 内容到 README，并删除独立文档。
- 更新中英文 README、CHANGELOG、COMPARISON 和 RELEASE。

---

## v2.0.3 - 2025-11-09

### 修复 Normal 模式下按 ESC 触发输入法切换的问题

#### Obsidian 插件

- 修复 Normal 模式下按 ESC 会意外触发输入法切换的问题。
- 只在 Insert 或 Replace 模式下按 ESC 时保存输入法状态并切换到英文。
- Normal 模式下按 ESC 不再改变输入法。

---

## v2.0.2 - 2025-11-04

### 终端兼容性修复

- 修复在 macOS 终端 Vim 中按 ESC 时，子进程输出导致标题栏短暂闪烁的问题。
- 使用更通用的后台静默执行方式替代不兼容的 `job_start(..., {'detach': v:true})`。

---

## v2.0.0 - 2025-11-04

### 新增 Vim 原生插件支持

- 新增原生 Vim 插件支持。
- 支持 Normal / Insert 模式输入法自动切换。
- 支持 Insert 模式输入法状态记忆。
- 增加 Vim 插件安装、配置和调试说明。

---

## v1.0.8 - 2025-01-04

### Obsidian 插件输入法状态记忆

- Obsidian 插件记住退出 Insert 模式时使用的输入法。
- 下次进入 Insert 模式时恢复上次保存的输入法状态。
- 修复首次 ESC 不切英文、Insert 模式正常输入被误触发等问题。

---

## v1.0.0 - 2024-06-01

### 首次发布

- 基本的 Vim 模式输入法自动切换功能。
- 支持 macOS。
- 支持 Normal / Insert 模式切换。

---

详细历史见：

- [CHANGELOG.md](./CHANGELOG.md)
- [CHANGELOG_en.md](./CHANGELOG_en.md)