AutoKey：Linux 上的文本扩展与桌面自动化利器 #

AutoKey 是什么？ #

AutoKey 是一款运行于 Linux 与 X11 环境下的触发器式自动化工具，当用户按下热键或输入预设缩写时，它可以自动插入文本、运行脚本或弹出选择菜单。无论是反复填写的地址、公司名、签名，还是需要复杂组合键才能调用的数据库、CAD/CAM、工程与科研软件功能，都能通过一次配置实现"一键触发"。

它最大的价值在于：任意短语、脚本或缩写都可在所有应用程序中通用，用户只需在 AutoKey 里配置一次，就能在编辑器、浏览器、办公文档等各个软件中调用，大幅减少重复劳动，降低手臂与手指的负担。对于需要大量撰写文档、编写代码、填写表单的用户而言，AutoKey 是一款不可多得的效率工具。

AutoKey 有哪些亮点特色？ #

• 缩写自动扩展：只需输入几个字符，AutoKey 便能将其自动展开为完整的常用文本块，如地址、公司名称、自定义签名等；还支持"匹配缩写大小写"，例如输入 tp 展开为 the patient、Tp 展开为 The patient、TP 展开为 THE PATIENT。

• 全应用统一配置：AutoKey 可跨所有应用程序工作，任何短语、脚本或缩写都能在多个软件中复用。用户无需为每个应用单独配置，只需在 AutoKey 中设置一次即可全局生效。

• Python 脚本近乎无限扩展：AutoKey 脚本是用 Python 编写的小程序，理论上可以实现任何可编码的功能——启动其他程序、向运行中的窗口发送命令、调整窗口大小、重定位光标等。官方内置了多个示例脚本，网上还有大量 Python 脚本资源可供学习与共享。

• 热键与弹出菜单触发：任意键或键组合（配合 Shift、Control、Alt、Super 修饰键）均可作为热键触发器，用于运行脚本、插入短语或弹出选择菜单，让复杂操作一键完成。

• 丰富的脚本 API 体系：提供 Keyboard、Mouse、Store、QtDialog、GtkDialog、QtClipboard、GtkClipboard、System、Window、Engine、HighLevel、Common 等完整 API，可精细控制按键收发、鼠标移动点击、剪贴板读写、对话框交互、窗口激活与调整、系统命令执行等。

• 动态短语与宏：短语中可嵌入特殊 <tag> 宏，将静态短语转化为动态短语。例如 date 标签会在短语展开时被替换为当前日期与时间，无需手动填写。

• 树状结构清晰管理：主窗口左侧以文件夹/子文件夹的"树"视图组织脚本与短语，用户可按项目、场景自由创建新文件夹，管理大量自动化内容也井井有条。

• 多程序协同操控：脚本不仅能插入文本，还可同时操控多个正在运行的程序，在它们之间传递文本、启动或关闭程序，并向其发送键盘与鼠标输入，实现真正的流程自动化。

免费下载 AutoKey #

以下为官方提供的安装包，点击链接即可下载。

说明：autokey-common 为 AutoKey 的共享核心包，仅安装它并不会获得可用的图形界面，通常还需要安装对应的前端包（如 autokey-gtk 或 autokey-qt）才能正常使用。

AutoKey 如何使用？ #

AutoKey 的核心使用逻辑是"定义触发器 → 在任意软件中触发"。以最常见的"缩写扩展"为例，基础流程如下：

1. 启动 AutoKey：安装并运行后，通知区（系统托盘）会出现一个字母"A"图标。默认可通过点击该图标打开弹出菜单，访问 AutoKey 的全部功能；图标可在偏好设置中更换。

2. 创建文件夹：在配置窗口左侧可以看到文件夹/子文件夹的"树"视图。通过菜单 File > Create > New Top-level Folder 新建一个顶层文件夹，用于存放你的缩写内容。也可以点击"Use Default"在默认文件夹下按名称创建。

3. 创建短语：选中目标文件夹，按 Ctrl + N（或通过菜单/右键菜单 File > Create > New Phrase）新建短语，输入名称后点击 OK。

4. 输入短语内容：按 Tab 键进入编辑区，输入希望自动展开的完整文本内容。

5. 设置缩写：按 Ctrl + Tab 或点击"Abbreviation"旁的"Set"按钮，弹出"Set Abbreviation"对话框。在此输入缩写字符，将"Trigger on"保持为"Default"，并保持"Remove typed abbreviation"勾选（除非你希望缩写本身保留在文档中）。如需大小写敏感，可勾选"Match phrase case to typed abbreviation"或"Ignore case of typed abbreviation"。

6. 保存并测试：点击 OK 接受缩写设置，再按 Ctrl + S 保存。此后在任何文档或窗口中输入该缩写，它都会被自动替换为你设定的短语内容。

如果需要更高级的功能，还可以创建热键（hotkey）触发器或编写 Python 脚本。脚本中可直接调用 API，例如：

keyboard.send_keys("example document")
clipboard.set_content("update clipboard")
dialog.info_dialog("Info dialog", "Test info dialog")

无需关心 import 语句，也不需要了解类路径，直接调用模块方法即可。

AutoKey 的常见问题？ #

AutoKey 支持哪些操作系统？ AutoKey 是为 Linux 和 X11 设计的自动化工具。它通过 X 服务器发送和接收键盘事件，支持多种与 X 通信的方式，理论上兼容任何西方键盘布局（俄语、中文普通话、日语等语言已知存在问题）。

为什么在新电脑上导入设置后没有立即生效？ AutoKey 不会实时监控其"目录"变化。导入设置或修改文件夹后，需要先退出当前 AutoKey 会话（通过托盘图标），再重新启动 AutoKey，设置才会被加载。

短语和脚本文件为什么复制后会失效？ 每个 AutoKey 短语和脚本都由两个文件组成：一个存放正文（如 my_phrase.txt、my_script.py），另一个存放元数据（如 .my_phrase.json、.my_script.json）。因为元数据文件名以点号开头，属于隐藏文件，用 cp 等命令默认会漏掉，导致配对不完整而失效。建议使用 rsync 命令复制，或确保成对移动这两个文件。

使用 AutoKey 必须会写 Python 吗？ 不必。使用缩写和短语扩展无需任何编程知识，纯文本操作即可完成。只有在需要操控窗口、传递文本、执行复杂流程时，才需要使用 Python 脚本；官方已内置示例脚本，网上也有大量资源可供参考。

缩写扩展时如何区分大小写？ 在"Set Abbreviation"对话框中，"Match phrase case to typed abbreviation"和"Ignore case of typed abbreviation"两个选项共同作用，可实现大小写敏感的扩展。例如设置缩写 tp 后，tp、Tp、TP 可分别展开为不同大小写形式的短语。

AutoKey 的 clipboard/send_keys 有哪些模式？ keyboard.send_keys() 默认以键盘事件方式发送，也可通过 send_mode 参数选择剪贴板粘贴方式（如 CB_CTRL_V、CB_CTRL_SHIFT_V、CB_SHIFT_INSERT、SELECTION）。注意剪贴板只能承载可打印字符，特殊键和组合键只能在键盘模式下发送，否则会以字面形式（如 <ctrl>+<f11>）粘贴出来。

AutoKey 如何安装？ #

AutoKey 目前主要面向 Linux 平台，推荐通过发行版包管理器安装。

Debian / Ubuntu 及其衍生版

1. 安装共享核心包：

   sudo dpkg -i autokey-common_0.96.0_all.deb
   

   若提示依赖缺失，可执行：

   sudo apt-get install -f
   

2. 安装图形前端（二选一，分别对应 GTK 与 Qt 环境）：

   sudo apt install autokey-gtk
   # 或
   sudo apt install autokey-qt
   

3. 安装完成后，在应用菜单中启动 AutoKey，系统托盘出现"A"图标即表示运行成功。

其他发行版

• Fedora：可尝试 sudo dnf install autokey。
• Arch Linux：可从 AUR 安装对应包。
• 也可从源码编译安装，具体以官方仓库说明为准。

注意事项

• AutoKey 依赖 X11，在纯 Wayland 会话下可能无法正常工作，建议在 X11 会话中使用。
• 仅有 autokey-common 不足以获得图形界面，务必搭配 autokey-gtk 或 autokey-qt 前端。

AutoKey 如何卸载？ #

Debian / Ubuntu 及其衍生版

1. 卸载 AutoKey 前端与核心包：

   sudo apt remove autokey-gtk autokey-qt autokey-common
   

   或针对早期通过 dpkg 安装的包：

   sudo dpkg -r autokey-common
   

2. 如需连同配置文件一并清除，可使用：

   sudo apt purge autokey-gtk autokey-qt autokey-common
   

其他发行版

• Fedora：sudo dnf remove autokey
• Arch Linux：sudo pacman -Rns autokey

残留配置清理

卸载后，用户目录下的 AutoKey 配置（通常位于 ~/.config/autokey/）可能仍会保留，其中存放着你创建的所有短语、脚本与设置。如果确定不再需要，可手动删除：

rm -rf ~/.config/autokey/

建议在删除前先备份该目录，以便日后在其他机器上复用你的自动化配置。