# 实现选择与先例扫描

## 选择顺序

| 需求 | 优先实现 | 升级方式 |
| --- | --- | --- |
| 停止更新、关闭反馈入口 | 官方环境变量与管理设置；核对当前名称和语义 | 随官方配置更新 |
| 键位、项目提示、工作流 | 官方 keybindings、CLAUDE.md、skills、hooks | 保留项目配置 |
| 原生 UI、内部输入行为、缺失开关 | 先查 tweakcc 是否已有选项或 patch | 按工具支持矩阵验证 |
| 必须改嵌入 JS 的具体行为 | 复用 Calico 容器读写，编写最少语义补丁 | 每个版本重定位并测试 |

官方环境变量和设置能解决的需求，不需要重打包。禁用反馈命令不等于关闭所有遥测；两者须分别核对配置。权限模式可选性也不等于默认跳过权限检查。

## 来源与签名

官方发布元数据根地址为 `https://downloads.claude.ai/claude-code-releases`。查询 `latest` 或 `stable` 后，把解析出的版本写入交付记录；随后获取该版本的 `manifest.json`、`manifest.json.sig` 和对应平台文件。`release_info.py` 只核对元数据结构和可选本地文件哈希，`signatureVerified` 始终为 false。

构建前在独立 GPG keyring 验证清单的 detached signature，并以已验证清单核对二进制大小及 SHA-256。2026-10-05 案例使用的官方签名公钥指纹为 `31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE`；新版本须查当前官方安装说明和签名公钥来源，核实是否轮换，不盲信历史指纹。macOS 另查官方 codesign 身份。签名成功只证明来源与完整性，不证明补丁正确。

Mac 原生文件修改后需要重新签名。本地 ad-hoc 签名可用于验证结构与运行，不等同于 Anthropic 签名或公证。其他平台独立处理，不能把 macOS 签名结果推广过去。

## 容器修改约束

记录模块路径、资源数、模块数、修改前后哈希与命中次数。检查结构边界和字符串表，不用全文件搜索替换。保留未修改模块的内容、资源和字节码位置；修改模块不得继续运行旧缓存字节码。使用现成工具后仍需读回容器、解析修改的 JS、确认原生代码段和非目标模块未变，并实际运行产物。

锚点匹配或容器断言失败就停止该版本构建。必须处理新布局或无法安全保留资源时，先重新评估工具，不把“能写出文件”视为完成。

## 2026-10-07 先例扫描与决定

范围：已安装 skills、当前 Hub 文档和脚本、已完成定制工程，以及可见的 claudecode 开发文档。未遍历所有内部仓库，不声称全域无候选。

| 候选 | 查到的能力 / 限制 | 决定 |
| --- | --- | --- |
| 内部既有定制工程 | 2.1.289 ARM64 补丁、锁定来源、验证证据；不是通用最新版本工具 | 保留为案例，增加流程入口 |
| 已安装 skill-creator、先例扫描、借造决策、工程证据技能 | 覆盖技能格式、方案选择、证据边界；没有同范围的 Claude 客户端定制 skill | 复用规范，仅新建任务专用说明 |
| Hub 既有脚本发布目录 | 文档、静态下载、CI；禁止托管程序安装包 | 复用发布路径，不建新平台 |
| 官方配置机制 | 更新、反馈等已有开关，项目定制不必改客户端 | 首选 |
| tweakcc + patch-creation skill | 可定制客户端，skill 专注注册 tweakcc 内部 patch | 工具支持时直接采用；不复制其内部注册流程为通用入口 |
| Calico native-bun | 能读取与重写 Bun 原生容器；其 playbook 记录多模块/字节码错误导致运行崩溃的反面证据 | 固定已验证工具提交用于案例；新版重新核验 |
| ccsilo | 原生提取和 patch 方向；仓库于 2026-10-05 归档为只读 | 不作为新版本的自动依赖 |

自建范围仅为串联上述能力的 skill、只读版本元数据助手和固定版本补丁。没有另写原生容器解析器。案例在构建时获取 Calico 的锁定源文件并校验 SHA-256，不把第三方源码复制进本包。使用与分发工具时另核对其当前许可证。

扫描复查时间：2027-01-07，或官方配置、容器布局、工具支持/维护状态变化时提前复查。

## 资料

- [官方环境变量](https://code.claude.com/docs/en/env-vars)
- [官方安装说明](https://code.claude.com/docs/en/setup)
- [tweakcc](https://github.com/Piebald-AI/tweakcc)
- [tweakcc patch-creation skill](https://github.com/Piebald-AI/tweakcc/blob/main/.claude/skills/patch-creation/SKILL.md)
- [Calico patching playbook](https://github.com/Nanako0129/calico-claude/blob/main/PATCHING_PLAYBOOK.md)
- [ccsilo](https://github.com/whit3rabbit/ccsilo)