Skip to content

v0.0.14 —— 修复结束不了进程与启动无反应

Latest

Choose a tag to compare

@kanniganfan kanniganfan released this 19 Nov 16:55
· 4 commits to main since this release

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.AppImage

deb:

sudo apt install ./kook_0.0.14_amd64.deb

rpm:

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 真机验证。

了解更多