适配 2.1.26x: bytecode 构建改打常量池,槽位布局改为现场探测

[RGB-loop]

背景

在 claude 2.1.261 上,现有 ccskin 会报 7 个锚点问题;更糟的是,即使把问题绕过去让它跑完,
verified=true、sha1 全过、--version 正常 —— 启动画面却纹丝不动。

根因有两层:

1. 槽位漂移:上游把 logo 字符在槽位间重新切分了(r1E 5→6 列、r1R 1→0 列),整行列数没变。
2. bytecode 化(致命):2.1.26x 起用 bun build --bytecode 编译。二进制里那份 JS 源码文本
   还在,但运行时读的是 bytecode 常量池。ccskin 改的是源码文本,对 UI 没有任何影响,
   而所有校验都基于源码文本 —— 所以 verify 是假阳性。

对照实验:同一个二进制,只改常量池里 5 个字符串再重签名,启动画面立刻变;走完整 ccskin 流程改
源码文本,计数和 sha1 全过,屏幕零变化。

改了什么

新增 patcher/bytecode.py —— 常量池条目解析与精确寻址。条目布局:

<len:  u32 LE,高位 0x80000000 置位 = 8-bit(latin1),否则 UTF-16>
<hash: u32 LE(实际 24 位);运行时不校验>
<chars>
<pad:  补 0 到 4 字节对齐>     ← 不是终止符,当成终止符解析会漏掉一半条目

discovery.build_patches 检测到 // @bun @bytecode 就整体切到常量池通道,老版本仍走源码文本
通道,自动判定无需配置。verify 也一并切到常量池 —— 否则它继续数源码文本,还是假阳性。

槽位布局改为现场探测:设计稿按整行给,打包时按二进制当前的槽位边界重新切分。四个 design
文件因此不用再跟着版本改。版本位容量同理(压缩后的变量名长度决定显示位宽度,["v",ms] 比
["v",c3e] 窄一格,原来固定上限 5 会漏判)。

顺带修好两个一直没命中的显示位:大 logo 第三行(和小 logo 用的是不同常量)、HTML 页 logo
(池里是一条 26 字符含换行的整串)。另外把上游已删除的显示位降级为提示,并拆掉 problems 的
级联失败 —— 原先任何一个可忽略的缺失锚点都会连坐掉版本号和主题色的整批补丁。

去重带来的两个新约束

常量池按内容去重,一条可能被多处共用:

• 图标:上游自己就让 default 与 arms-up 共用 r1E,设计稿给它们不同图案物理上做不到
  → analyze 直接报错并指出是哪两个槽位,不静默取其一。octopus.toml 的 arms-up 因此对齐
  default(另外三个设计稿本来就是这么做的)。
• 版本号:启动画面的版本与 --version 共用同一条常量,没法只改显示 → 默认跳过。
  愿意接受连带的话配 rewrite_real_version = true(新版本号需与真实版本等长)。

名字不受影响:--version 里的 (Claude Code) 和机器标识 claude-code 都是另外的条目。

验证

• 单元测试 45 → 61,新增 TestBytecodePool / TestPoolChannel,合成 bytecode bundle
  覆盖两种槽位布局。做过变异验证:关掉常量池通道挂 9 个,退回逐槽位打包挂 4 个,
  退回锚点分级挂 1 个。
• 真机 2.1.261 全流程跑通,隔离 HOME 抓屏确认:

 ▗▄▄▄▄▖   Loop Code  v2.1.261
▟██◉█◉██▙  Opus 5 (1M context) · API Usage Billing
  ╵╵ ╵╵    <cwd>

主题色 SGR 命中 12 次、原橙色 0 次,--version 仍输出真实的 2.1.261 (Claude Code)。

• 新增 patches/2.1.261.toml。定义文件现在可读多了(UTF-16 存成文本 + enc 字段),
  且沿用 offset+sha1 模式,不写入原内容。

测试计划

• python3 -m unittest discover -s tests(61 passed)
• 2.1.261 真机 analyze → patch --apply → sign → verify
• 隔离 HOME 下 pty 抓屏确认图标/名字/主题色真的变了
• --version 输出真实版本
• rewrite_real_version = true 变体单独验证
• 2.1.214 / 2.1.217(非 bytecode)回归 —— 手头没有这两个版本的二进制,
  源码通道的既有测试全过,但没做真机复验