
Haka 从笔记工具转型为轻量级插件化热键自动化工具
来源标题:Def3r/haka: A lightweight, fast and plugable hotkey utility
Haka 已从笔记工具演变为轻量级、快速、可插拔的自动化工具,相关功能现以插件形式默认提供。该工具完全用 C 语言编写,作为系统服务在后台静默运行,并支持插件动态热重载。安装脚本仅覆盖 Arch 和 Debian 系发行版,其他发行版需手动安装依赖。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
Haka 已经不再只是过去那个笔记工具了。 这些功能现在默认以插件形式提供。 Haka 是一个轻量、快速、可插拔的自动化工具。它的设计目标是 作为系统服务在后台安静运行。 为了性能完全用 C 编写,但它并不要求 你完全用 C 编写插件。它是动态的,并且支持热重载! 安装 权限 守护进程 配置 配置选项 指南 默认键位绑定 插件 编写你自己的插件 故障排查 构建 依赖 build.sh 包含所有依赖的安装,但仅适用于基于 arch 和 debian 的发行版。对于任何其他发行版,请安装上述 依赖。或者直接使用基于 Makefile 从你喜欢的终端执行 build.sh 脚本进行安装 chmod +x build.sh ./build.sh 权限 要访问 input 组并使用 libevdev 访问事件设备, 需要 root 权限。尽管以 root 用户运行 haka 有许多 问题,最关键的是当前用户会话(包括 主剪贴板)在以 root 运行时不可用。 为解决这个问题,我们使用 capabilities(7) 授予 haka 将其组 ID 更改为 input 的权限。现在 haka 可以作为用户进程运行,并且仍然能够访问 evdev。 这个变通方案的功劳归于这篇博客。 build.sh 会隐式处理这一点。如果你使用 build.sh 构建 haka,这一步已经完成了。 sudo setcap "cap_setgid=eip" ./haka.out ./haka.out # 运行时无需 sudo haka.service 如果你想将 haka 作为新式 systemd 守护进程在后台运行,请使用 daemon.sh 生成 systemd 的 unit 文件。 daemon.sh 创建作为 --user 守护进程运行所需的 unit 文件,并 在 ~/.config/systemd/user/ 中创建该 unit 文件的符号链接 确保从包含 haka.out 的目录执行 daemon.sh。如果你重命名了可执行文件,请编辑 daemon.sh 中的 HAKA 变量 chmod +x daemon.sh ./daemon.sh 查看日志: journalctl --user -u haka.service -f 配置 haka 的配置文件必须命名为 haka.cfg 且必须与 haka 可执行文件位于同一目录。haka 配置解析器允许你对配置值使用命令替换。例如,你可以这样动态指定编辑器: editor=$(which emacs) 配置选项 以下配置选项是相对于 markdown 插件描述的。 Haka 自带一个默认插件和 markdown 插件(haka 以前 仅是一个笔记工具)。 选择菜单中显示的文件是 notes/ 目录,可以在包含 haka 可执行文件的目录中找到 编辑器默认为 neovim haka 目前支持 linux/input-event-codes.h 中定义的前 249 个 KEY_NAME 如果某个键绑定到 NULL,该键将被隐式绑定到重载 插件 默认 ActivationCombo 是 Left Ctr+Left Alt 默认激活组合在 src/binds.c:setActivationCombo_ 中设置。 如果某个 KEY_ 绑定到多个函数,将执行第一个绑定它的插件。 有 3 个日志级别: -DLOG=0:无日志 -DLOG=1:信息日志(ILOG) -DLOG=2:调试日志(DLOG + ILOG)默认 默认键位绑定 默认 ActivationCombo 是 LEFT_CTRL + LEFT_ALT plugins/default.c 键 动作 KEY_R 重载插件 KEY_C 将选中文本追加到当前文件 KEY_M 显示 tofi 选择菜单 KEY_O 在编辑器中打开当前文件 KEY_F 格式化(换行)当前文件内容(使用 neovim) KEY_J 在终端中打开 haka 的 journalctl(如果作为守护进程运行) plugins/markdown/plugin.c 键 动作 KEY_1 到 KEY_4 将选中文本作为 Hn 标题追加到当前文件 KEY_A 将选中文本作为无序列表追加到当前文件 KEY_S 将选中文本作为深度 2 的无序列表追加到当前文件 KEY_N 向当前文件追加换行符(\n) 插件 添加新的自定义键位绑定的唯一方法是制作插件。这听起来可能 繁琐,但其实很简单。 默认情况下,haka 自带一些插件。你可以在 plugins/ 目录中看到它们。 一个非常基础的扩展现有插件的示例(假设 haka 已在运行)。在 plugins/default.c 中,添加这个函数: static void hello_world(hakaCtx ctx) { printf("Hello World!\n"); 在该文件的 BEGIN_BIND ... END_BIND 部分下,通过添加这一行来注册你的函数: Bind(hello_world, KEY_H); 就这样!我们创建了一个新的键位绑定!现在编译该文件,在 plugins/ 目录中运行: make 现在按下你的 ActivationCombo(默认是 LEFT_ALT + LEFT_CTRL)+ R 来重载插件,然后按下 ActivationCombo + H,你就可以看到 终端上打印出 "Hello World!"! 插件只是 plugins/ 目录或 配置文件中指定目录中的一个共享对象(.so)。 函数必须具有以下原型:void func(hakaCtx *ctx) 才能被绑定。参考 linux/input-event-codes.h 获取 KEY_NAME 宏。 插件样板: #include "plug.h" // 可在 include/ 中找到 coreApi api; / 你的函数放在这里 / BEGIN_BIND / 在此处将你的函数注册到按键 */ END_BIND 你可以使用 api 指针调用核心功能函数,并从 ctx 中提取数据。 如果某些进程无法工作/启动,这通常是因为在 启动时未设置所需的环境变量。这是一个已知问题。 启动后应执行 systemctl --user restart haka。 如果所有键位绑定都不工作,问题很可能出在 keyd。keyd 和 haka 不能同时运行。这是因为 keyd 会抓取输入 设备,从而使 haka 无限期地轮询输入设备。终止 keyd 进程应该能解决该问题。 确认 keyd 正在运行:pgrep keyd。 终止所有 keyd 进程:sudo killall keyd 这种架构是合理的 改用前缀键(?)(切换过来确实有多个好处) 警告:单键多绑定(或者也许允许多重绑定?) 静态 core.c 日志级别 切换到 gtk(?):以减少依赖。(不过会变臃肿) 为变量添加配置文件选项。 忽略选择中的换行符(?)
(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。