# 交付与验收记录

至少交付可执行文件、使用说明、修改逻辑、来源、SHA-256、原始结果与回退方式。包中不带凭证、个人日志或私有地址。Hub 仅保存本文档、skill 和源配方，不托管 Claude 安装包。

记录可使用以下结构；未经实际验证的签名字段保留 false：

```json
{
  "baseVersion": "X.Y.Z",
  "customVersion": "X.Y.Z-custom.1",
  "platform": "darwin-arm64",
  "source": {
    "url": "官方版本下载地址",
    "sha256": "实际哈希",
    "manifestSignatureVerified": false,
    "platformSignatureVerified": false
  },
  "patches": [{"id": "change-1", "before": "原行为", "after": "新行为", "expectedMatches": 1, "actualMatches": 1}],
  "checks": [{"stage": "native-runtime", "input": "具体命令", "criterion": "实际行为", "result": "UNTESTED", "evidence": "相对文件路径"}],
  "outputSha256": "实际哈希",
  "limitations": [],
  "rollback": "重新运行保留的原版；明确哪些配置需恢复"
}
```

`stage` 可为 static、component、native-runtime、target-interaction；`result` 可为 PASS、FAIL、UNTESTED。记录工具版本、基线和时间。初次失败与后续复核分别保留，写明判据变化原因。

| 证据 | 能说明 | 不能说明 |
| --- | --- | --- |
| 官方来源、清单签名、文件哈希 | 原版来源与完整性 | 补丁行为正确 |
| JS 语法、容器读回、字节码检查 | 静态结构一致 | 登录或对话成功 |
| update 返回 0 并提示禁用 | 官方禁用分支执行 | 更新成功 |
| 权限条件穷举 | 被修改条件的有限状态逻辑 | 所有交互路径正确 |
| 粘贴组件用例 | 事件条件计算符合预期 | 系统剪贴板实测成功 |
| 原生 TUI banner | 程序启动并渲染界面 | 模型响应成功 |

交付前核对执行位、平台/架构、定制标记和所有文件哈希。用户要求安装时才处理安装位置与回退备份；不要自动替换原版。公开或共享前去除个人日志，核对来源、工具许可证与分发范围。