kita / notes
← 回到全部笔记

事件日期 阅读约 3 分钟

拆包修复两个 Electron 客户端:Claude Desktop 离线工作区缓存校验与 DSH 会话日志 ignorable 补丁

发布于

本文目录(2 节)
  1. 1. DSH 与 Orb 共用 $DSH_HOME:一行 "ignorable": true 救回 4 个报错会话
  2. 2. Claude Desktop 工作区依赖 403:拆 index.chunk.js 逆出 .verified 与 claudevm.bundle 校验规则

桌面上的 AI 客户端大多是 Electron 壳,遇到报错提示语焉不详时,与其在外面猜配置,直接拆读 resources/app.asar 里的构建产物往往十分钟就能看到判定源码。10 月中下旬我就用这个办法先后修好了 DeepSeek Harness(dsh)打不开旧会话和 Claude Desktop 工作区依赖下载 403 两个问题。

1. DSH 与 Orb 共用 $DSH_HOME:一行 "ignorable": true 救回 4 个报错会话

10 月 14 日,在 DeepSeek Harness 里点开之前的 4 个旧会话时,界面直接弹窗拒绝加载:

SessionQueryError: session "..." contains event type "computer-use/coordinate-mode" (seq 3)
unknown to this harness and not marked ignorable; refusing to interpret the log

查了下本机安装目录,原因很有意思:机器上同时装了 DeepSeek Harness(日常用)和 DeepSeek Orb(带 resources/computer-use/ 能力),而这两个 Electron 应用共用了同一个用户目录 $DSH_HOME = C:\Users\30408\deepseek。在两边的 app.asar 里搜 coordinate-mode,Orb 命中 34 处,Harness 命中 0 处。也就是说,这 4 个会话当初是用 Orb 建的,写进了第 3 号事件 computer-use/coordinate-mode,后来换回 Harness 打开时就被守卫函数拦下了。

但我不想删掉第 3 行事件——因为会话日志 $DSH_HOME/sessions/<workspace>/<id>/session.v4.jsonl.zstd 里的 seq 是严格从 0 到 N-1 连续编号的,删掉一行就得重写后面几百行的序号。

去读 Harness app.asar 里的 validateStoredEvents 源码,发现官方守卫条件写的是:

if (!KNOWN_SESSION_EVENT_TYPES.has(event.type) && event.ignorable !== true) {
  throw new SessionQueryError(...);
}

官方明明留了 event.ignorable === true 这个向前兼容的逃生口,只是 Orb 写事件时没标。正好本机装的 Python 3.14 标准库已经内置了 compression.zstd,不需要装任何第三方包,写个十来行的脚本把 .jsonl.zstd 解压出来,在 {"type":"computer-use/coordinate-mode" 后面原位插上 ,"ignorable":true 再压回去。4 份日志行数与 seq 分毫未动,再点开全部秒进。

2. Claude Desktop 工作区依赖 403:拆 index.chunk.js 逆出 .verified 与 claudevm.bundle 校验规则

10 月 30 日,免安装版客户端(Claude-3p,基于 Claude Desktop v4.29.0)初始化工作区时一直卡在下载 403。

先用脚本探测它内置的两个国内镜像桶(kakouai.oss-cn-shanghai.aliyuncs.com 与 yuanxiai.oss-cn-shanghai.aliyuncs.com),返回的都是阿里云 OSS 的 403 AccessDenied: Anonymous user has no right to access this bucket——镜像桶被设成了私有,本地改环境变量也没用。

于是我从 app.asar 里提取出内嵌的权威版本清单 vm-manifest.json(引擎版本 2.1.309,VM bundle SHA 072b6cbfe74f428a98bd86035f83b322b369d1f1),并读 .vite/build/index.chunk-CzG3PNJ3.js 摸清了 Anthropic 官方 CDN 的拼接规律与本地缓存判定逻辑:

  • 官方源路径:桌面与 Linux 引擎在 https://downloads.claude.ai/claude-code-releases/2.1.309/<platform>/*.zst,而 rootfs.vhdx.zst(1.31 GB)、vmlinuz.zst、initrd.zst 三个虚拟机组件在 https://downloads.claude.ai/vms/linux/x64/<bundle_sha>/*.zst。单线程拉官方 CDN 被限速在 17 KB/s,我写了个 fetch2.py 开 10 线程 × 4MB Range 分块并发拉取,速度直接拉满到 3.2 MB/s,9 分钟把 1.56 GB 全部拿回 F:\claude-workspace-offline\archives\。
  • 缓存目录名与校验文件的坑:读 index.chunk 里的 sui()、SX() 和 xX() 三个函数才发现两个极易搞反的细节:
    1. VM 镜像的目录名不是按 bundle SHA 命名的 vm_bundles/072b6cbf.../,而是写死的 vm_bundles/claudevm.bundle/!我第一次按 SHA 建目录,日志立刻报 [Bundle:status] rootfs.vhdx missing;
    2. 清单里的 checksum 是 .zst 压缩包本身的 SHA-256(写入无换行的 .verified 文件),而 rawChecksum 和 rawSize 才是解压后文件的 SHA-256 与字节数(写入 .payload JSON);至于 claudevm.bundle/ 下的三个组件,则必须在同目录生成隐藏文件 .rootfs.vhdx.origin、.vmlinuz.origin、.initrd.origin,内容严格等于 40 位 bundle SHA(纯文本无换行)。

按这套规则写好 deploy.py 自动解压、核对双层 SHA-256 并落盘到 C:\Users\30408\AppData\Local\Claude-3p 后,claude.exe --version 当场输出 2.1.309 (Claude Code),离线归档留在 F 盘随时可重放。

← 返回全部手记