Skip to content

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

Choose a tag to compare

@kanniganfan kanniganfan released this 19 Nov 15:27
· 10 commits to main since this release

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、无风控页、无需重登;验证结束已把指纹恢复原状,与默认行为一致。


了解更多