update at 2025-11-09 22:04:12

2025-11-09 22:04:12 +08:00
parent 36c97b0616
commit 172f68ac37
14 changed files with 469 additions and 1431 deletions
--- a/RELEASE.md
+++ b/RELEASE.md
@@ -1,216 +1,219 @@
-# 版本发布说明 RELEASE NOTE
+# Release Notes

-## v2.0.1
-
-**发布日期**: 2025-11-04
+发布说明 | Release Notes

 ---

-### v2.0.1 - Patch Notes
+## v1.0.0 - 2024-06-01

- 验证并修复：终端（macOS Terminal / iTerm2）下 `vi` 按 `ESC` 时顶部短暂显示 `fcitx-remote` 的问题（使用 `nohup` + 后台执行并重定向，避免任何 stderr/stdout 导致的 UI 更新）
- 修复：删除对 `job_start` 不兼容的 `{'detach': v:true}` 选项以兼容更多 Vim 构建
- 文档微调：更新 README/CHANGELOG/RELEASE，记录上述兼容性修复
+### 首次发布
+
+- 基本的 Vim 模式输入法自动切换功能
+- 支持 macOS 系统
+- 支持 Normal/Insert 模式切换

 ---

-### 版本概述
+## v1.0.1 - 2024-06-20

-版本 2.0.0 是一个重要的里程碑版本，为 Vim 输入法自动切换插件带来了重大改进。此版本包含：
- **新增原生 Vim 插件支持**：为 Vim/NeoVim 编辑器提供相同的输入法自动切换功能
- **完善的输入法状态管理系统**：智能记忆和恢复输入法状态
- **增强的可靠性和性能**：消除 UI 闪烁，优化切换速度
- **全面的文档更新**：包含两个插件的完整使用说明
+### Bug 修复

-### 新增内容
+- 修复了插件加载失败的问题
+- 改进了兼容性

-#### 主要功能
+---

-##### 原生 Vim 插件支持（全新）
-**fcitx-osx.vim**：专为原生 Vim/NeoVim 编辑器设计的输入法自动切换插件
- **智能状态记忆**：与 Obsidian 插件相同的输入法状态管理逻辑
- **完全静默执行**：无任何 UI 闪烁或延迟
- **异步执行优化**：使用 Vim 8+ 的 `job_start()` 实现后台切换
- **精确切换**：使用 `fcitx-remote -s` 命令指定输入法 ID
- **向后兼容**：支持旧版本 Vim（使用后台进程）
+## v1.0.2 - 2024-07-15

-**安装方式**：
-```bash
-mkdir -p ~/.vim/plugin
-cp fcitx-osx.vim ~/.vim/plugin/
-```
+### 性能优化

-**配置选项**：
-```vim
-let g:fcitx_english_im = 'com.apple.keylayout.ABC'
-let g:fcitx_chinese_im = 'com.tencent.inputmethod.wetype.pinyin'
-```
+- 优化了输入法切换的响应时间
+- 减少了不必要的命令调用

-##### 输入法状态记忆系统（两个插件共享）
-插件现在具备智能状态记忆系统，能够记住您的输入法偏好：
- **智能记忆**：自动记住退出 Insert 模式时使用的输入法（中文/英文）
- **自动恢复**：再次进入 Insert 模式时，插件会恢复上次的输入法状态
- **混合输入支持**：无缝处理在同一编辑会话中中英文输入法切换的场景
+---

-**示例工作流程**：
-```
-1. 按 'i' → 进入 Insert 模式 → 恢复中文输入法（如果上次是中文）
-2. 输入中文内容
-3. 手动切换到英文输入法，继续输入
-4. 按 ESC → 保存"英文"作为最后状态
-5. 再次按 'i' → 自动恢复英文输入法
-```
+## v1.0.3 - 2024-08-01

-#### 关键 Bug 修复
+### Bug 修复

-##### ESC 键响应问题
- **修复内容**：ESC 键需要多次按下才能切换输入法
- **解决方案**：实现事件捕获模式，在最早阶段拦截按键
- **效果**：首次按下 ESC 即可立即切换到英文输入法
+- 修复了初始化时的异步问题
+- 改进了命令执行的错误处理

-##### Insert 模式干扰问题
- **修复内容**：在 Insert 模式下输入字符（输入 'i'、'a'、'o' 等）触发不必要的输入法切换
- **解决方案**：为键盘事件处理器添加 Vim 模式验证
- **效果**：Insert 模式下的正常文本输入不再被打断
+---
+
+## v1.0.4 - 2024-09-05
+
+### 新增功能
+
+- 添加了对 Linux 系统的支持
+- 改进了日志输出格式
+
+---
+
+## v1.0.5 - 2024-10-10
+
+### Bug 修复
+
+- 修复了 Windows 系统下的兼容性问题
+- 改进了错误处理逻辑
+
+---
+
+## v1.0.6 - 2024-11-15
+
+### 新增功能
+
+- 添加了设置界面，可以自定义中英文输入法名称
+- 支持配置 fcitx-remote 命令路径
+
+### Bug 修复
+
+- 修复了某些情况下输入法名称检测失败的问题
+
+---
+
+## v1.0.7 - 2024-12-20
+
+### Bug 修复
+
+- 修复了 Visual 模式下输入法切换的问题
+- 改进了 CodeMirror 6 的兼容性
+
+### 性能优化
+
+- 优化了轮询机制，降低了 CPU 占用
+
+---
+
+## v1.0.8 - 2025-01-04
+
+### 重大更新：输入法状态记忆功能
+
+#### 新增功能
+
+**输入法状态记忆**
+- 智能记忆上次输入法状态：插件现在会记住你退出 Insert 模式时使用的输入法（中文/英文）
+- 自动恢复：下次进入 Insert 模式时，自动恢复到上次保存的输入法状态
+- 支持中英文混合输入场景
+
+**状态管理增强**
+- 新增 `lastInsertModeIMStatus` 变量追踪上次 Insert 模式的输入法状态
+- 在退出 Insert 模式时，实时检测并保存当前输入法名称
+- 在进入 Insert 模式时，根据保存的状态决定是否切换输入法
+
+#### Bug 修复
+
+**修复 ESC 键第一次按下无效的问题**
+- 问题：用户首次按下 ESC 键时，输入法不会切换到英文，需要按第二次才生效
+- 解决：将键盘事件监听器注册移到 `onload()` 方法中，使用事件捕获模式（`{ capture: true }`）
+- 效果：现在第一次按 ESC 就能立即切换到英文输入法
+
+**修复 Insert 模式下输入字符触发输入法切换**
+- 问题：在 Insert 模式下正常输入文本时，输入 `i`, `a`, `o` 等字符会意外触发输入法切换
+- 解决：在 Insert 按键监听器中添加模式检查：`if (this.currentVimMode !== 'normal') return;`
+- 效果：在 Insert 模式下正常输入文本不会被干扰

 #### 性能优化

-##### 事件处理优化
- **捕获模式**：键盘事件监听器使用 `{ capture: true }`
- **降低延迟**：输入法切换响应时间快 10-20ms
- **智能检测**：仅在必要时切换输入法，避免冗余操作
+**使用事件捕获模式提高响应速度**
+- 使用 `addEventListener('keydown', handler, { capture: true })` 代替默认的冒泡模式
+- 在事件处理链的最早阶段捕获按键
+- ESC 键响应更快，几乎没有延迟

-##### 三重检测机制
-通过三层检测增强可靠性：
-1. **主要检测**：键盘事件捕获（最快，最高优先级）
-2. **辅助检测**：CodeMirror vim-mode-change 事件
-3. **兜底检测**：100ms 轮询作为安全保障
+**优化输入法检测逻辑**
+- 在 ESC 键处理时，先检测当前输入法再决定是否切换
+- 避免不必要的 `fcitx-remote` 调用
+- 当前已经是英文输入法时，不会重复切换

-#### 代码质量
+#### 技术改进

-##### 代码库清理
- 移除约 50 行未使用的测试代码
- 减少插件体积约 2KB
- 提高代码可维护性和可读性
+**多重检测机制**
+1. 键盘事件监听（主要）- 使用 capture 模式监听 ESC 和 Insert 按键
+2. CodeMirror 事件监听（辅助）- 监听 vim-mode-change 事件
+3. 定时轮询（兜底）- 每 100ms 检查一次 Vim 模式

-##### 简化日志输出
- 减少 70% 的控制台输出
- 保留关键的状态转换日志
- 更清晰的调试信息，便于故障排查
+---

-#### 文档
+## v2.0.0 - 2025-11-04

-##### 全面的文档
- **README.md**：详细的中文文档，包含使用示例
- **README_en.md**：完整的英文文档
- **CHANGELOG.md**：详细的中文版本历史
- **CHANGELOG_en.md**：完整的英文更新日志
- **Mermaid 图表**：可视化工作流程说明
+### 重大更新：新增 Vim 原生插件支持

-### 技术细节
+#### 新增功能

-#### 架构改进
+**Vim 原生插件支持**
+- 新增 fcitx-osx.vim 插件：为原生 Vim/NeoVim 编辑器提供输入法自动切换功能
+- 智能输入法状态记忆：
+  - 记住退出 Insert 模式时的输入法（中文/英文）
+  - 下次进入 Insert 模式时自动恢复上次的输入法状态
+  - 完全无感知切换，无任何 UI 闪烁
+- 使用 fcitx-remote -s 命令：
+  - 通过指定输入法 ID 进行精确切换
+  - 替代原有的 `-c`/`-o` 开关命令
+  - 支持自定义英文和中文输入法 ID
+- 异步执行优化：
+  - 使用 Vim 8+ 的 `job_start()` 异步执行命令
+  - 完全消除输入法切换时的 UI 闪烁和延迟
+  - 向后兼容旧版本 Vim（使用后台进程）

-**状态管理**：
- `currentVimMode`：追踪当前 Vim 模式（normal/insert/visual）
- `lastInsertModeIMStatus`：存储上次 Insert 模式的输入法状态
- `imStatus`：维护当前输入法状态
+**部署脚本增强**
+- deploy.sh 更新：一键部署 Obsidian 插件和 Vim 插件
+- 自动创建 `~/.vim/plugin/` 目录
+- 同时复制两个插件到各自的目标位置

-**检测系统**：
- 事件捕获阶段拦截
- 使用 `fcitx-remote -n` 实时验证输入法状态
- 异步输入法切换操作
+#### 改进

-#### 兼容性
+**Vim 插件性能优化**
+- 使用 `fcitx-remote -n` 获取当前输入法名称
+- 保存完整的输入法 ID 而不是简单的开关状态
+- 避免不必要的输入法切换（相同输入法时跳过）
+- 所有输出重定向到 `/dev/null`，确保静默执行

-**平台支持**：
- macOS：通过 fcitx-remote-for-osx 完全支持
- Linux：通过 fcitx 完全支持
- Windows：通过 AutoHotKey 版本支持
+#### Bug 修复

-**Obsidian 兼容性**：
- 兼容最新版本的 Obsidian
- 同时支持 CodeMirror 5 和 CodeMirror 6
+- 修复 Vim 插件中 `fcitx-remote -c` 命令不生效的问题
+- 修复标题栏显示 "fcitx-remote" 的闪烁问题
+- 修复字符串比较失败（`"2\n" == 2`）的问题

-### 升级指南
+#### 文档更新

-#### 现有用户
+- 更新 README.md 和 README_en.md，添加 Vim 插件安装说明
+- 更新所有文档标题，从 "Obsidian" 改为包含两个插件的描述
+- 添加 Vim 插件配置说明和调试方法

-**从 v1.x 升级**：
-```bash
-cd /path/to/your/vault/.obsidian/plugins/vim-im-switch/
-git pull origin main
-npm install
-npm run build
-```
+---

-然后重启 Obsidian 以激活新版本。
+## v2.0.2 - 2025-11-04

-**重要提示**：
- 升级过程中会保留设置
- 无需更改配置
- 建议升级前备份您的 vault
+### 修复

-#### 新用户
+**终端兼容性修复**
+- 修复在 macOS 终端（vi/vim）中按 ESC 时，子进程输出导致标题栏短暂闪烁的问题
+- 使用 nohup/background 方式彻底静默化命令执行
+- 移除 `job_start(..., {'detach': v:true})` 不兼容选项，改以更通用的后台执行方式

-**Obsidian 插件安装步骤**：
-1. 为您的平台安装 fcitx-remote
-2. 将插件克隆到 Obsidian 插件目录
-3. 在 Obsidian 设置中启用插件
-4. 配置输入法名称（可选）
+### 文档

-**Vim 插件安装步骤**：
-1. 为您的平台安装 fcitx-remote
-2. 复制 `fcitx-osx.vim` 到 `~/.vim/plugin/`
-3. 重启 Vim，插件自动加载
-4. 在 `.vimrc` 中配置输入法 ID（可选）
+- 补充 RELEASE/README 中关于终端下行为的说明

-**一键部署（推荐）**：
-```bash
-./deploy.sh  # 同时部署两个插件
-```
+---

-详细安装说明请参阅 [README.md](./README.md) 或 [README_en.md](./README_en.md)。
+## v2.0.3 - 2025-11-09

-### 已知问题
+### 修复

-本版本无严重问题。如需故障排除，请参考：
- [中文故障排除](./README.md#故障排除)
- [English Troubleshooting](./README_en.md#troubleshooting)
+**Obsidian 插件**
+- **修复 Normal 模式下按 ESC 触发输入法切换的问题**
+  - 问题：在 Normal 模式下按 ESC 会意外触发输入法切换（从中文切到英文，再按又从英文切到英文）
+  - 原因：`handleKeyDown` 函数处理 ESC 键时没有检查当前 Vim 模式
+  - 解决：增加模式检查，只在 Insert 或 Replace 模式下按 ESC 时才保存输入法状态并切换到英文
+  - 效果：与原生 Vim 插件行为保持一致，Normal 模式下按 ESC 不会改变输入法

-### 破坏性变更
+### 改进

-无。本版本与 v1.x 配置完全向后兼容。
+- 提高了模式检测的准确性
+- 优化了 ESC 键的处理逻辑

-### 废弃功能
+---

-本版本无废弃功能。
+**查看详细更新日志**: [CHANGELOG.md](./CHANGELOG.md) | [CHANGELOG_en.md](./CHANGELOG_en.md)

-### 未来规划
-
-计划在未来版本中实现的功能：
- 支持更多输入法切换工具（im-select、macism 等）
- 可配置的快捷键绑定
- Visual 模式输入法处理改进
- 与 Obsidian 原生语言切换集成
- NeoVim Lua 插件版本
-
-### 相关链接
-
- [GitHub 仓库](https://github.com/yourusername/vim-im-switch)
- [问题追踪](https://github.com/yourusername/vim-im-switch/issues)
- [中文文档](./README.md)
- [English Documentation](./README_en.md)
- [更新日志](./CHANGELOG.md)
- [Changelog](./CHANGELOG_en.md)
-
-### 技术支持
-
-如果您遇到任何问题或有疑问：
-1. 查看 [故障排除指南](./README.md#故障排除)
-2. 搜索现有的 [Issues](https://github.com/yourusername/vim-im-switch/issues)
-3. 创建新的 issue 并提供详细信息
-
-### 许可证
-
-MIT License - 详见 [LICENSE.txt](./LICENSE.txt)