# 锁定案例：2.1.289 / Apple Silicon Mac

此配方重建已完成的 cc280 风格定制，既不是自动追踪最新版，也不是每次调用 skill 的默认要求。仅接受官方 2.1.289 darwin-arm64，输入 SHA-256 为 `03d66745e3bb69ec727d66023696f3820bc0a00a8a5ba725eb6706d0c67cbe69`。

旧 cc280 包修改了官方 2.1.280 的嵌入 JS；它包含 Linux、Windows 和两份相同的 x86_64 Mac 文件，因此标为 Mac ARM 的旧文件并非原生 ARM。所谓离线包是安装文件分发包，不含模型权重，模型调用仍需要后端。

## 修改映射

| 旧逻辑 | 2.1.289 实现与结果 |
| --- | --- |
| 禁用自动更新 | 强制官方 `DISABLE_UPDATES` getter；复用官方禁用处理 |
| 隐藏 CLI update/install 与会话 /install | 隐藏入口；直接调用 update/install 仍返回官方“管理员已禁用”提示，退出码 0 不表示执行了安装 |
| 隐藏 /feedback 与 /bug | 强制官方 `DISABLE_FEEDBACK_COMMAND` getter；不是全局遥测开关 |
| 扩大 bypass 模式可选性 | 去除“必须显式请求模式”的前置条件，保留组织禁用与 restricted 条件；不设为默认模式 |
| 粘贴事件处理 | 将既有长文本条件与输入事件 `isPasted` 合并 |
| 标识定制版本 | 两处版本显示增加 `cc289-custom.1` |
| Windows Ctrl-V、PowerShell fallback | 目标仅 macOS，不移植 |
| doctor keychain 平台判断 | 新版已有相应行为，不重复改 |

## 重建

需要 Apple Silicon Mac、Node 20+、npm、Bun、curl、shasum 与 codesign。在本 skill 目录执行：

```bash
bash scripts/cc289/rebuild.sh /独立输出目录/claude-custom
```

脚本下载固定官方文件与固定 Calico 源文件，核对两者哈希，使用锁定依赖，解析、补丁、重打包、ad-hoc 签名，生成可执行文件和旁边的 `.build.json`。临时构建目录保留供审查。不会替换已安装 Claude，也不会修改个人配置。

重复运行允许复用内容相同的生成文件；已有目标或报告为符号链接、文件与报告缺一个、文件哈希改变或报告被人工改过时拒绝。使用新目标路径可重新构建。新版本必须重新实现锚点，不可仅替换此处版本号。

## 历史验证边界（2026-10-05）

2184 个 JS 模块中只修改 7 个；容器 2414 条记录保持，非目标模块内容和位置、原生代码段未变，目标模块旧字节码清除。签名为本地 ad-hoc，结构验证通过。

- 48 个权限条件组合通过。
- 168 个粘贴逻辑组件用例通过。
- 6 个离线原生 CLI 冒烟用例通过。
- TUI 初次判据失败，复核确认 banner 已显示；网络阻断后的连接失败符合环境预期。不能据此宣称对话功能通过。

账号登录、真实模型响应、实际剪贴板粘贴、界面切换权限模式和长期运行没有验收证据。API、认证和模型后端未修改。

## 封装验证（2026-10-07）

新增 13 个元数据与打包测试通过；含 Hub 既有测试共 19 个通过。只读查询实际解析官方渠道，并正确匹配保留的 2.1.289 原版文件。固定配方的补丁程序重建输出 SHA-256 为 `9bac784233a733f7c3abe8d79de22c5c363f589f049f9090ade2c3a758ba75b5`，与历史交付一致。

相同产物重复执行保持文件时间不变；修改过的程序、修改过的报告、普通/悬空符号链接、错误原版哈希和孤立报告均被拒绝且原文件保留。codesign 验证与原生 `--version` 通过。结果见 [skill-validation.json](skill-validation.json)。验证使用保留的原版与容器工具，没有重跑联网下载与 npm 安装，也没有新增真实模型对话证据。