Skip to content

Releases

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

Choose a tag to compare

@kanniganfan kanniganfan released this 19 Nov 16:55

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

了解更多

v0.0.13 —— 安全收尾:伪实现清理与回归测试

Choose a tag to compare

@kanniganfan kanniganfan released this 19 Nov 15:27

v0.0.13 —— 安全收尾:把「看起来成功」的实现逐个变成真实或显式失败

这一版没有新功能。全部精力放在一件事上:把审查里「返回成功但什么都没做」的实现清干净,并给它们补上能自动跑的回归测试。代码行为对普通用户只有两处可见变化——「打开日志目录」从点了没反应变成真的会打开,音频 AI 降噪从假装成功变成明确回绝不支持。

基线:官方 PC 0.112.0 / c5af713-kook_3321,仅 x86_64。


这一版做了什么

设备身份:补齐官方形状,但默认不动你现有的标识

官方 webapp 构造请求头时读的是 bios / machine / device_id 三个字段,而移植版此前只返回 {id, type:'linux'},前两个字段一直是 undefined。

现在完整形状已经实现,并通过环境变量 KOOK_DEVICE_DETAIL_FULL=1 灰度开启,默认关闭:

状态 SYSTEM_GET_UNIQUE SYSTEM_GET_UNIQUE_DETAIL
默认 原有 machineId(32 位 md5) {id, type:'linux'}
KOOK_DEVICE_DETAIL_FULL=1 device-identity 的 UUID {bios, machine, device_id},与左侧同源同值

为什么不默认开启:设备指纹是登录风控的输入,补齐等于换掉全员设备标识,每人大概率被迫重登一次。当前状态能正常登录和使用,没有证据表明会被风控拦,所以选择灰度而不是直接切。

这个开关不是幂等的——开启与关闭各变一次指纹,两个方向都可能被判成新设备。要试就一路开着,不要来回切。

伪实现清理

通道 之前 现在
AUDIO_AI_PIPE {code:0, data:null},上层以为降噪链路建起来了 {code:-1, message},界面走降级分支并记日志
LOGGER_OPEN_DIR 空函数,点了没反应 按 logs → userData/logs → userData 依次尝试并真正 shell.openPath
SYSTEM_GET/SET_HARDWARE_ACCELERATION handlers 里两份实现,靠注册顺序决定谁生效 只保留 main.js 里带真实 globalPref 语义的那份;加断言禁止 handlers 再注册同名通道

第三条值得单独说明:它不是 bug,是隐患。真实实现一直在 installDesktopIntegration() 里,但 handlers.js 里还留着一对同名空实现,只要有人调换注册顺序,空实现就会反盖真实实现——和之前「硬件加速开关点了没反应」属于同一类故障。

上游检测:修掉一处会漏报的真问题

旧实现给 webapp 做指纹时只对文件路径列表做哈希,文件名不变、内容被替换时完全不会报错。现在拆成两项:

  • pathDigest —— 文件路径集合,抓增删与改名
  • contentDigest —— 逐文件 path\0size\0sha 汇总,抓内容替换

另外 5 个关键契约文件(设备指纹拼装、域名运行时等)按逻辑名登记,官方换 chunk 名也能对上;移植层自己改过的文件单列白名单,开发目录不再误报成上游漂移。


下载

格式 文件 大小
AppImage(任何发行版) KOOK-0.0.13-x86_64.AppImage 236,105,960
deb(Debian / Ubuntu / Deepin / UOS) kook_0.0.13_amd64.deb 166,791,016
rpm(Fedora / RHEL / openSUSE) kook-linux-0.0.13.x86_64.rpm 186,244,898
SHA-256 校验值
3bea41c21bfccb5456dbb633a61b75d58568e911d44189777413f412761d3e03  KOOK-0.0.13-x86_64.AppImage
7d11e0b4572deaf3ff6622113b4c0550991c28fcd1c06dac27fae6a34da468ce  kook_0.0.13_amd64.deb
355473ac0da351630a9f8c4ce613440573659554ad55cd713b58ef7a631fd869  kook-linux-0.0.13.x86_64.rpm
sha256sum -c SHA256SUMS

安装

AppImage —— 免安装,不需要手动加参数:

chmod +x KOOK-0.0.13-x86_64.AppImage
./KOOK-0.0.13-x86_64.AppImage

deb:

sudo apt install ./kook_0.0.13_amd64.deb

rpm:

sudo dnf install ./kook-linux-0.0.13.x86_64.rpm

覆盖安装即可,不需要先卸载旧版。登录状态会保留。


已知限制

  • 没有系统密钥环时会丢掉「记住登录」:凭据优先走 safeStorage 真后端 → secret-tool + AES-256-GCM → 两者都没有时拒绝落盘。轻量桌面(i3/sway 无 keyring)会表现为每次启动都要重新登录;装 gnome-keyring 或 kwallet 后恢复。设 KOOK_INSECURE_STORE=1 可强制启用明文存储(带警告)。
  • 设备指纹默认沿用旧形状,完整形状需 KOOK_DEVICE_DETAIL_FULL=1,且开关非幂等。
  • Wayland 全局覆盖层:协议层限制,需要 X11 会话。
  • 音频 AI 降噪:Linux 移植版明确不支持,界面会走降级分支。
  • 仅 x86_64:没有 ARM 真机验证,暂不发布 arm64 包。

从 0.0.12 升级

直接覆盖安装。本版不改变默认设备标识、不迁移凭据格式,登录状态保持不变。

唯一的可见差异是音频设置里的 AI 降噪会显示为不可用——它的前一版也只是「看起来可用」,实际没有建立处理链路。


验证情况

本机实测(CachyOS / GNOME / Wayland / x86_64):页面文本 7581 字符 / 3484 节点,凭据走 safeStorage / gnome_libsecret,落在发现页,API 全部 200,主程序更新已屏蔽。

自动化回归测试 4 组共 96 条断言,全部在真实 Electron 运行时上跑:

bash tests/run-tests.sh
  • 窗口尺寸(6):参数校验、浮点取整、窗口销毁、异常吞并
  • IPC 默认态(20):无窗口返回 -1、域名白名单与落盘、GET_ACTIVE_DOMAIN 形状、指纹零漂移
  • IPC 灰度态(37,跨进程两轮):完整形状、同源同值、重启后不变
  • 凭据存储(27):四态判定、v2: 篡改一字节必须解不出来、拒绝落盘、旧格式迁移

设备身份的完整形状在真实账号上验证过一轮:开启灰度后 device_id=d8da83cc…、bios=21d1589c…、machine=7953cf63…,无 401/403、无风控页、无需重登;验证结束已把指纹恢复原状,与默认行为一致。


了解更多

KOOK Linux 移植版 v0.0.12

Choose a tag to compare

@kanniganfan kanniganfan released this 19 Nov 14:25

KOOK Linux 移植版 v0.0.12

一轮安全审查之后的加固版:Web 安全开了、权限收紧、凭据分三层

基于官方 Windows PC 客户端 0.112.0(构建 c5af713-kook_3321)移植
社区作品,与 KOOK 官方无关 · 官方从未发布 Linux 版


⚠️ 先看这一条:登录状态的行为变了

如果你没有安装系统密钥环(gnome-keyring / kwallet),这版开始不会保存登录状态——
每次启动都要重新登录。

这不是 bug,是安全加固的代价。旧版本在 safeStorage 不可用时会把登录令牌用 Base64
存下来,那只是编码,任何能读你配置目录的进程都能还原成明文。这版起改成三层:

系统密钥环(真后端)      → 用 Electron safeStorage 加密     ← 最佳
    ↓ 不可用
secret-tool 取主密钥      → AES-256-GCM 加密                ← 可用
    ↓ 不可用
拒绝落盘 + 提示          → 本次登录不持久化                  ← 安全兜底

想恢复「记住登录」,装 gnome-keyring(GNOME)或 kwallet(KDE)后重启客户端即可,
已有的旧格式凭据会自动重加密迁移。

确实接受明文落盘的风险,可以设 KOOK_INSECURE_STORE=1,会以 v0: 标记保存并弹一次警告。

启动日志里能直接看到当前用的是哪一层:

[secret] 凭据存储 mode=safeStorage backend=gnome_libsecret secure=true

安全加固

  • 开启 Chromium Web 安全保护
    此前为兼容性关闭。实测开启后页面加载完整(文本 5721 字符 / 2989 节点),无新增错误。
  • 系统权限按来源校验
    媒体、屏幕分享、剪贴板等权限原先无条件放行,现在先校验请求来源是否属于 kookapp.cn
    域名或本地资源服务,不在白名单内直接拒绝并记日志。
  • 登录凭据三层存储
    见上。关键细节:Linux 上 Electron 的 basic_text 后端 isEncryptionAvailable()
    照样返回 true,但用的是 Chromium 内置硬编码口令,实际等同明文——已单独识别并判为不安全。

问题修正

  • 三个设置项此前完全不生效
    「关闭硬件加速」「关闭到托盘」「效能模式」都读同一个配置读取函数,而它依赖的 path
    模块在调用之后才 require,异常被 try/catch 静默吞掉,读到的永远是默认值。
  • 域名切换从来没生效过
    GET_ACTIVE_DOMAIN 返回的是 {origin, api},而官方读 activeApiOrigin /
    activeH5Origin / activeFirstPartyOrigins,取值永远 undefined,一路回落到默认服务器。
    现在按官方形状返回。
  • 窗口初始尺寸设置无声失败
    官方 preload 用 send 调 WINDOW_SET_SIZE_ORIGIN,主进程从未注册。
  • 两条伪成功
    SYSTEM_GET_FILE 走真实文件对话框(无窗口时返回 -1,避免挂死调用方);
    SYSTEM_SWITCH_SERVER_API 改为真实切换并落盘,非白名单域名直接拒绝。

工程

  • 新增 IPC 契约表:
    209 个通道全覆盖,当前分布 A 已完整实现 91 / B Linux 替代实现 33 / C 明确不支持 27 /
    D 临时兼容桩 58
    (本次两条伪成功已从 D 挪进 A)。另有形状契约专项与 sendSync 同步通道清单。
  • 新增 scripts/check-upstream.mjs 上游兼容性检测:对比官方版本、commitId、
    通道清单与关键文件哈希,官方更新后跑一次就知道哪里要改。
  • docs/SECURITY.md
    记录了安全审查每一条的处置结论与实测数据,包括哪些能改、哪些改了会白屏。

下载

格式 文件 大小
AppImage KOOK-0.0.12-x86_64.AppImage 225.2 MiB
deb kook_0.0.12_amd64.deb 159.1 MiB
rpm kook-linux-0.0.12.x86_64.rpm 177.6 MiB
SHA-256 校验
f07fa0a9dced387254aee4d75e211595b316678cae14d4af6eba639db02082fd  KOOK-0.0.12-x86_64.AppImage
1732866849fb9e056673332ca6a3e81ce43e6b665cbd33ca3bfdf29972ce89c6  kook_0.0.12_amd64.deb
5b804ced79e083ddefcfeca785cfb6193a7c22883089a4807d009239cc2fa530  kook-linux-0.0.12.x86_64.rpm

安装

# AppImage —— 任何 glibc 发行版
chmod +x KOOK-0.0.12-x86_64.AppImage
./KOOK-0.0.12-x86_64.AppImage

# Debian / Ubuntu / Deepin / UOS
sudo dpkg -i kook_0.0.12_amd64.deb && sudo apt -f install

# Fedora / RHEL / openSUSE
sudo rpm -i kook-linux-0.0.12.x86_64.rpm

AppImage 不需要手加 --no-sandbox 之类的参数,启动器会自己判断会话环境。

已知限制

  • 屏幕覆盖的「全屏游戏时显示」「在系统桌面上显示」需要 X11 会话
  • Wayland 下全局快捷键在窗口无焦点时可能收不到
  • 没有系统密钥环时不保存登录状态(见开头)
  • 仅 x86_64,暂无 ARM 真机验证,不发布 arm64 包

从旧版本升级

直接覆盖安装即可,配置与登录数据保留。已登录的用户升级后需要重新登录一次
(凭据格式从旧版迁移到新格式)。

了解更多

KOOK Linux 移植版 v0.0.11

Choose a tag to compare

@kanniganfan kanniganfan released this 18 Nov 09:07

KOOK Linux 移植版 v0.0.11

修掉两个致命问题:双击没反应、打开一片空白

基于官方 Windows PC 客户端 0.112.0(构建 c5af713-kook_3321)移植
社区作品,与 KOOK 官方无关 · 官方从未发布 Linux 版


这一版做了什么

0.0.7 装完打不开。不是渲染层的问题,是两处底层故障,这一版把根都拔了:

现象 真实原因
双击 AppImage 毫无反应,连日志都不留 GNOME 会话下 Chromium 会 dlopen libgtk-4,而进程里 libgtk-3 已经初始化,GTK 检测到两套符号直接 abort
窗口能开,但里面一片空白 打包时漏了运行依赖:@kookapp/electron-local-server 一 require 就断,本地资源服务起不来,页面退回远程加载

修复

  • 启动即崩溃(GNOME 及部分桌面)
    启动器固定 --gtk-version=3,只初始化 GTK3 一条后端
  • 打开白屏
    afterPack 现在把完整 node_modules(471 个顶层条目)同步进包,本地 HTTP 服务正常启动:
    [linux-main] local server on http://127.0.0.1:5888/app/index.htm
    [linux-main] [win] 已切到发现页,原路由: /app/index.htm
    
  • Wayland 下偶发打不开
    启动器按会话类型补 --ozone-platform=wayland;chrome-sandbox 没有 SUID 位时自动补 --no-sandbox
  • deb / rpm 元信息错误
    Homepage 由占位地址改为真实仓库,License 从 unknown 改为 MIT

打包

  • 移除包内的 resources/app-update.yml —— 那是指向发布仓库的自动更新配置,与「必须屏蔽自动更新」冲突
  • 可执行文件改为启动器 shell,真二进制改名 kook-linux-bin。上面那些参数由启动器自动判断,用户不需要手加任何 flag

下载

格式 文件 大小
AppImage KOOK-0.0.11-x86_64.AppImage 225.1 MiB
deb kook_0.0.11_amd64.deb 159.1 MiB
rpm kook-linux-0.0.11.x86_64.rpm 177.6 MiB
SHA-256 校验
c064d5ce93947a640731168ac13951b7ddbe452375042b4389dd1184ed651c85  KOOK-0.0.11-x86_64.AppImage
73e714aeba3a9c200f23dfbbf7e081318c361340cd587ff23101d2c2fae827de  kook_0.0.11_amd64.deb
7cfd58caf5c82a1f40eb8744da9b3d07f31611f04770a784e8d69efeb63f7d84  kook-linux-0.0.11.x86_64.rpm
sha256sum -c <<'EOF'
c064d5ce93947a640731168ac13951b7ddbe452375042b4389dd1184ed651c85  KOOK-0.0.11-x86_64.AppImage
EOF

安装

# AppImage —— 任何 glibc 发行版
chmod +x KOOK-0.0.11-x86_64.AppImage
./KOOK-0.0.11-x86_64.AppImage

# Debian / Ubuntu / Deepin / UOS
sudo dpkg -i kook_0.0.11_amd64.deb && sudo apt -f install

# Fedora / RHEL / openSUSE
sudo rpm -i kook-linux-0.0.11.x86_64.rpm

AppImage 不需要手加 --no-sandbox 之类的参数,启动器会自己判断。

已知限制

  • 屏幕覆盖的「全屏游戏时显示」「在系统桌面上显示」需要 X11 会话 —— Wayland 协议不允许普通应用绘制全局置顶层
  • Wayland 下全局快捷键在窗口无焦点时可能收不到(有焦点时由本地键盘桥兜底)
  • 工具箱内的迅游加速器没有 Linux 版本,保留入口但标注不推荐

从旧版本升级

0.0.7 及更早的包不要再用,直接换这一版。自动更新已被屏蔽,升级方式就是下载新包覆盖安装。

了解更多