Repository navigation
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 条通道的分类与形状契约