Repository navigation
Releases
v0.0.14 —— 修复结束不了进程与启动无反应
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 真机验证。
了解更多
v0.0.13 —— 安全收尾:伪实现清理与回归测试
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.AppImagedeb:
sudo apt install ./kook_0.0.13_amd64.debrpm:
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、无风控页、无需重登;验证结束已把指纹恢复原状,与默认行为一致。
了解更多
- README —— 功能清单、技术实现、安全说明
- docs/SECURITY.md —— 安全审查逐条响应与实测数据
- docs/IPC-CONTRACT.md —— 209 条通道的分类与形状契约
KOOK Linux 移植版 v0.0.12
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.rpmAppImage 不需要手加 --no-sandbox 之类的参数,启动器会自己判断会话环境。
已知限制
- 屏幕覆盖的「全屏游戏时显示」「在系统桌面上显示」需要 X11 会话
- Wayland 下全局快捷键在窗口无焦点时可能收不到
- 没有系统密钥环时不保存登录状态(见开头)
- 仅 x86_64,暂无 ARM 真机验证,不发布 arm64 包
从旧版本升级
直接覆盖安装即可,配置与登录数据保留。已登录的用户升级后需要重新登录一次
(凭据格式从旧版迁移到新格式)。
了解更多
- 功能清单与环境要求:README
- IPC 契约表:docs/IPC-CONTRACT.md
- 安全审查响应:docs/SECURITY.md
- 完整提交记录:v0.0.11...v0.0.12
- 问题反馈:Issues 或 cylqm@qq.com
KOOK Linux 移植版 v0.0.11
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.rpmAppImage 不需要手加 --no-sandbox 之类的参数,启动器会自己判断。
已知限制
- 屏幕覆盖的「全屏游戏时显示」「在系统桌面上显示」需要 X11 会话 —— Wayland 协议不允许普通应用绘制全局置顶层
- Wayland 下全局快捷键在窗口无焦点时可能收不到(有焦点时由本地键盘桥兜底)
- 工具箱内的迅游加速器没有 Linux 版本,保留入口但标注不推荐
从旧版本升级
0.0.7 及更早的包不要再用,直接换这一版。自动更新已被屏蔽,升级方式就是下载新包覆盖安装。
了解更多
- 功能清单与环境要求:README
- 完整提交记录:v0.0.7...v0.0.11
- 问题反馈:Issues 或 cylqm@qq.com