Doubao IME Hammerspoon

把豆包输入法留给它最有价值的部分：免费、好用的语音输入。 把你真正顺手的输入法，继续留作主输入法。

这个项目提供一份 Hammerspoon 配置和一个一键安装脚本，用来在 macOS 上自动处理：

• 切换到豆包输入法
• 唤起豆包语音输入
• 在操作结束后切回原输入法

为什么做这个项目

豆包输入法的 macOS 版本目前有一个很明显的矛盾：

• 它的常规输入法能力偏弱，不太适合当主输入法。
• 它的语音识别能力却不错，而且免费，单独拿来做语音输入很有价值。
• 但官方的产品形态更偏向“占住输入法入口”，导致日常使用上必须反复切换，体验并不顺。

它做了什么

仓库内有两个核心文件：

• install-remote.sh：一行命令安装入口
• install.sh：安装脚本
• init.lua：Hammerspoon 配置

• 使用 brew install --cask hammerspoon 安装 Hammerspoon
• 把仓库里的 init.lua 复制到 ~/.hammerspoon/init.lua
• 如果目标位置已有配置：

• 在覆盖前自动备份旧配置

一行命令安装

直接复制下面这条命令到终端执行：

curl -fsSL https://raw.githubusercontent.com/Paxxs/Doubao-ime-hammerspoon/main/install-remote.sh | bash

如果你明确要覆盖现有的 ~/.hammerspoon/init.lua，可以用：

curl -fsSL https://raw.githubusercontent.com/Paxxs/Doubao-ime-hammerspoon/main/install-remote.sh | bash -s -- --force

这条命令会：

• 下载本仓库的安装包到临时目录
• 自动执行安装脚本
• 安装 Hammerspoon
• 复制 init.lua 到 ~/.hammerspoon/init.lua

从仓库安装

如果你更希望先把仓库拉到本地，再手动执行安装脚本，也可以这样做：

git clone https://github.com/Paxxs/Doubao-ime-hammerspoon.git
cd Doubao-ime-hammerspoon
chmod +x ./install.sh
./install.sh

如果你明确要覆盖现有的 ~/.hammerspoon/init.lua，可以用：

./install.sh --force

安装后怎么用

• 打开 Hammerspoon。
• 第一次运行时，为 Hammerspoon 授予 macOS 的“辅助功能”权限。
• 在 Hammerspoon 菜单栏图标中点击 Reload Config。
• 默认按住并松开右侧 Command 键。
• 脚本会自动切换到豆包输入法、触发语音输入，并在稍后恢复你原本的输入法。

当前默认行为

当前 init.lua 的逻辑是：

• 监听右侧 Command
• 记录当前输入法
• 切换到豆包输入法
• 模拟双击左侧 Option
• 延迟恢复到之前的输入法

适合谁

• 不想把豆包输入法设成主输入法
• 又想高频使用它的免费语音输入
• 希望整个过程尽量像“按一个键就开说”
• 不想每次都手动切换输入法、再切回来

注意事项

• 只支持 macOS。
• 需要你已经安装豆包输入法。
• 需要 Hammerspoon 获得“辅助功能”权限，否则无法模拟按键。
• 安装脚本不会自动合并你原有的 Hammerspoon 配置，只会替换或保留现有 ~/.hammerspoon/init.lua。
• 如果你已有自己的 Hammerspoon 配置，建议先看清提示；脚本在覆盖前会自动备份。

输入法 ID

当前配置里默认使用这个豆包输入法 ID：

local TARGETINPUTSOURCE = "com.bytedance.inputmethod.doubaoime.pinyin"

如果你机器上的输入法 ID 不一致，需要手动修改 init.lua，然后在 Hammerspoon 中重新加载配置。

可以继续自定义的地方

你可以按自己的习惯继续改：

• 触发按键
• 双击 Option 的时间间隔
• 恢复原输入法的延迟
• 与你现有 Hammerspoon 配置的整合方式