Repository navigation
v0.0.14 —— 修复「结束不了 KOOK 进程」与「启动不了 KOOK」
这一版只做一件事:把退出/启动这条链路上的三个缺陷修掉。它们单独看都像小问题,串起来就是一个死循环——进程退不掉,然后退不掉的进程让下次启动没反应。
基线:官方 PC 0.112.0 / c5af713-kook_3321,仅 x86_64。
现象与根因
① 结束不了 KOOK 进程
现象:kill、Ctrl+C、注销会话都杀不掉,只能 kill -9。
根因:退出拦截只认托盘菜单。「关闭时最小化到托盘」的 preventDefault() 挂在窗口 close 上,而放行开关 quitForReal 只在托盘菜单点「退出」时才置真。SIGTERM、会话注销、系统级 app.quit() 都会走同一段 close,全部被拦下,app.quit() 于是永远中止。
修法:监听 before-quit(所有退出路径的必经之地)置真,并显式处理 SIGTERM / SIGINT / SIGHUP;信号回调里加 3 秒兜底 app.exit(0),防止某个渲染进程卡在 beforeunload 上把退出拖住。
② 启动不了 KOOK(双击图标没有任何反应)
现象:双击图标,进程起来又立刻消失,界面不出现。
根因:主窗口关闭后,覆盖层等其它 BrowserWindow 还活着,window-all-closed 不触发,进程留了下来并攥着单实例锁。下次启动时 requestSingleInstanceLock() 失败,新进程直接 exit(0);旧进程那边窗口已经销毁,second-instance 里无事可做——点击被静默吞掉。
修法:主窗口 closed 时确保 app.quit(),不再留残留进程;second-instance 发现主窗口已销毁时 app.relaunch(),而不是什么都不做。
③ 最小化后点托盘唤不回
修法:show() 不会取消最小化状态,先 restore() 再 show()。托盘点击、「显示 KOOK」菜单、二次启动三处统一走同一个 showMainWindow()。
附带:没有托盘宿主时不再把窗口藏起来
GNOME 默认没有 org.kde.StatusNotifierWatcher,但 new Tray() 依然构造成功——图标不显示。此时「关闭到托盘」等于把窗口藏进一个打不开的地方。现在先探测宿主是否存在,不存在就不做拦截,关闭按钮直接退出。
下载
| 格式 | 文件 | 大小 |
|---|---|---|
| AppImage(任何发行版) | KOOK-0.0.14-x86_64.AppImage |
236,106,041 |
| deb(Debian / Ubuntu / Deepin / UOS) | kook_0.0.14_amd64.deb |
166,781,338 |
| rpm(Fedora / RHEL / openSUSE) | kook-linux-0.0.14.x86_64.rpm |
186,244,048 |
SHA-256 校验值
e8d46593fbed89eb3db9aabd37669121125c9c43ee404c22083ba664e6283d67 KOOK-0.0.14-x86_64.AppImage
f5b0991fbd96ab3aeaf9bd3f6e481219ca00ff992d335edddccd72a42b5d8f87 kook_0.0.14_amd64.deb
b3ad70b78091bec19b7cc37618070012e266152e766fc3fdbf7d66262851a23a kook-linux-0.0.14.x86_64.rpm
sha256sum -c SHA256SUMS安装
AppImage:
chmod +x KOOK-0.0.14-x86_64.AppImage
./KOOK-0.0.14-x86_64.AppImagedeb:
sudo apt install ./kook_0.0.14_amd64.debrpm:
sudo dnf install ./kook-linux-0.0.14.x86_64.rpm覆盖安装即可,不需要先卸载旧版。
如果你正卡在「启动不了」
不用等升级,先清掉残留就能救回来:
ps -eo pid,comm | grep -E "kook-linux-bin|KOOK-0"
pkill -9 -f kook-linux-bin
rm -f ~/.config/KOOK/Singleton*验证情况
本机实测(CachyOS / GNOME / Wayland / x86_64):
启动 页面文本 5681 字符 / 2928 节点,落在发现页
SIGTERM 退出 207 ms,退出后残留 kook-linux-bin 进程 0 个
日志证据 [desktop] 主窗口已关闭,退出进程
自动化测试 4 组 96 条断言仍全绿;CI(GitHub Actions)在 push 时自动跑,含「故意失败必须变红」的反向自检。
已知限制
- 没有系统密钥环时会丢掉「记住登录」:装
gnome-keyring或kwallet后恢复。 - 设备指纹默认沿用旧形状,完整形状需
KOOK_DEVICE_DETAIL_FULL=1,且开关非幂等。 - 托盘图标依赖桌面扩展:GNOME 需 AppIndicator 扩展,否则不显示托盘,此时关闭按钮直接退出。
- Wayland 全局覆盖层:需要 X11 会话。
- 仅 x86_64:没有 ARM 真机验证。