Auto IME

一个智能输入法自动切换扩展，支持 Linux 和 Windows。基于 Tree-sitter AST 解析，根据代码上下文智能切换中/英文输入法。同时支持 VSCodeVim 用户和普通编辑器用户。

功能特性

双模式支持：自动检测 VSCodeVim 扩展，Vim 用户和普通用户均可使用
智能上下文检测：光标在注释或字符串中时自动切换到中文输入法
即时响应：基于文本的快速注释检测，输入 //、# 等注释语法时立即切换
ESC 强制切换：Vim 模式下按 ESC 退回 Normal 模式时强制切换到英文输入法
状态栏显示：底部状态栏实时显示当前输入法状态，支持点击切换
多语言支持：JavaScript、TypeScript、Python、Go、Rust、C、C++、CSS、HTML、Lua、Java、Kotlin、Bash
高性能：Tree-sitter WASM 解析 + 同步文本快速检测，30ms 防抖响应

支持的语言和注释类型

语言	单行注释	块注释	字符串	模板字符串
JavaScript	`//`	`/* */`	`" '`	`
TypeScript	`//`	`/* */`	`" '`	`
Python	`#`	`""" '''`	`" '`	-
Go	`//`	`/* */`	`"`	`
Rust	`//` `///`	`/* */`	`"`	`r#"..."#`
C	`//`	`/* */`	`"`	-
C++	`//` `///`	`/* */`	`"`	`R"(...)"`
CSS	-	`/* */`	-	-
HTML	`<!-- -->`	-	-	-
Lua	`--`	`--[[ ]]`	`" '`	-
Java	`//`	`/* */`	`"`	-
Kotlin	`//`	`/* */`	`"`	-
Bash	`#`	-	`" '`	-

安装

方式一：VS Code Marketplace 安装

打开 VS Code
按 Ctrl+Shift+X 打开扩展面板
搜索 Auto IME
点击 Install 安装

或使用命令行：

code --install-extension CI124.auto-ime

方式二：手动安装（.vsix 文件）

从 GitHub Releases 下载最新版本的 .vsix 文件，然后：

打开 VS Code
按 Ctrl+Shift+P 打开命令面板
输入 Extensions: Install from VSIX...
选择下载的 .vsix 文件

或使用命令行：

code --install-extension auto-ime-0.5.0-beta.1.vsix

使用方法

安装扩展后，扩展会自动激活并检测运行环境
底部状态栏会显示当前输入法状态（EN 或 中）
点击状态栏可手动切换输入法

Vim 模式（安装了 VSCodeVim 扩展时）

在 Insert 模式下：
- 光标移动到注释或字符串中 → 自动切换到中文
- 光标移动到代码区域 → 自动切换到英文
按 ESC 退回 Normal 模式 → 强制切换到英文
支持 i、I、s、c 等命令进入 Insert 模式时自动检测

普通模式（未安装 VSCodeVim 扩展时）

全局分析，无需进入特定模式
输入 //、# 等注释语法时自动切换到中文
回车或移动出注释区域时自动切换到英文

配置

在 VS Code 设置中搜索 auto-ime：

配置项	默认值	说明
`auto-ime.ibus.englishEngine`	`xkb:us::eng`	IBus 英文引擎名称
`auto-ime.ibus.chineseEngine`	`libpinyin`	IBus 中文引擎名称

支持的输入法框架

平台	输入法框架	说明
Linux	Fcitx5（推荐）	自动读取 `~/.config/fcitx5/profile` 获取输入法列表
Linux	Fcitx4	通过 `fcitx-remote` 命令切换
Linux	IBus	通过 `ibus engine` 命令切换，支持 D-Bus 信号监听
Windows	PowerShell + Win32 API	通过 `SendMessageW(WM_INPUTLANGCHANGEREQUEST)` 切换键盘布局，支持所有 Windows 输入法

扩展会自动检测系统平台和输入法框架。

开发

项目结构

auto-ime/
├── src/                    # 源代码
│   ├── extension.ts        # 扩展入口
│   ├── ASTAnalyzer.ts      # Tree-sitter AST 分析器
│   ├── IMEManager.ts       # 输入法管理器
│   └── IMEStateManager.ts  # 输入法状态监听管理器
├── scripts/                # 辅助脚本
│   ├── download-wasm.js    # 下载 WASM 文件
│   └── prepare-sandbox.js  # 准备测试沙盒
├── wasm/                   # Tree-sitter WASM 文件
├── dist/                   # 编译输出目录
├── esbuild.js              # 构建脚本
├── package.json            # 项目配置
└── tsconfig.json           # TypeScript 配置

开发流程

# 安装依赖
npm install

# 监听模式（自动编译）
npm run watch

# 按 F5 启动调试（自动准备沙盒环境）

添加新语言支持

下载对应的 Tree-sitter WASM 文件到 wasm/ 目录
在 src/ASTAnalyzer.ts 中添加：
- WASM_FILE_MAPPING：语言 ID → WASM 文件名
- TARGET_NODE_TYPES：语言 ID → 目标节点类型列表

测试

扩展使用 VS Code 沙盒环境进行测试：

按 F5 启动调试
在弹出的沙盒窗口中测试功能
查看 "Auto IME" 输出面板的日志

技术栈

TypeScript：主要开发语言
Tree-sitter：代码解析（通过 WASM）
esbuild：构建工具
VS Code Extension API：扩展框架

工作原理

事件监听：监听光标移动和文档变化事件
AST 解析：使用 Tree-sitter 解析代码，判断光标是否在注释/字符串中
输入法切换：
- Linux：通过 shell 命令调用 Fcitx5/Fcitx4/IBus
- Windows：通过 PowerShell 调用 Win32 SendMessageW API 切换键盘布局
状态栏更新：实时更新状态栏显示

常见问题

扩展不工作

查看 "Auto IME" 输出面板的日志，确认运行模式（Vim/普通）
Linux：检查系统中是否安装了 Fcitx5/Fcitx4/IBus
Windows：确保 PowerShell 可用（Windows 7+ 自带）
Vim 用户：检查是否安装了 VSCodeVim 扩展

输入法没有切换

Linux：确认输入法框架正在运行，检查 PATH 环境变量，尝试手动执行 fcitx5-remote -n 或 ibus engine 测试
Windows：确认 PowerShell 可用，检查系统是否安装了中文和英文键盘布局

性能问题

扩展使用 30ms 防抖（文档变化）和 50ms 防抖（光标移动），响应速度快
注释检测优先走同步快速路径，Tree-sitter AST 分析仅在必要时执行（< 0.01ms/次）
如果仍有延迟，检查系统输入法框架是否正常

贡献

欢迎提交 Issue 和 Pull Request！

Fork 本仓库
创建功能分支：git checkout -b feature/your-feature
提交更改：git commit -m 'Add your feature'
推送分支：git push origin feature/your-feature
提交 Pull Request

许可证

MIT License

致谢

Tree-sitter：代码解析库
VSCodeVim：Vim 模拟器
web-tree-sitter：Tree-sitter WASM 绑定