Skip to content

👾 Open Computer Use – Open-Source Alternative to Codex Computer Use

fix: move official reference bundles out of Git LFS

ifurystb3f401573217
diff --git a/.gitattributes b/.gitattributes
index 29c5a78..817af10 100644
--- a/.gitattributes
+++ b/.gitattributes
@@ -1 +1 @@
-docs/references/codex-computer-use-reverse-engineering/assets/official-bundles/computer-use/*.zip filter=lfs diff=lfs merge=lfs -text
+# Reference bundle ZIPs are distributed as GitHub Release assets, outside Git LFS.
diff --git a/.gitignore b/.gitignore
index 0c5d7a3..f08dfc8 100644
--- a/.gitignore
+++ b/.gitignore
@@ -8,3 +8,4 @@ artifacts/codex-dumps/
research/
__pycache__/
*.pyc
+docs/references/codex-computer-use-reverse-engineering/assets/official-bundles/computer-use/*.zip
diff --git a/docs/exec-plans/active/20261019-reference-bundles-release.md b/docs/exec-plans/active/20261019-reference-bundles-release.md
new file mode 100644
index 0000000..3c2f719
--- /dev/null
+++ b/docs/exec-plans/active/20261019-reference-bundles-release.md
@@ -0,0 +1,33 @@
+# 将官方参考包迁移到 GitHub Releases
+
+## 目标
+
+为两份官方 `computer-use` 参考 ZIP 提供固定 Release 下载链接,让当前主线的普通 clone 不再下载 LFS 参考包。
+
+## 范围与约束
+
+- 迁移 `1.0.750.zip`、`1.0.755.zip` 和校验清单到独立的 `reference-bundles` Release。
+- 保留原文件哈希,在本地备份后移除 Git 跟踪;本地 ZIP 继续保留为忽略文件。
+- 同步参考说明、原始制品提交约定与归档 Release 维护方式。
+- 不重写历史、不修改付费预算、不发布新的 npm / App 版本。
+
+## 风险与处理
+
+- 资料丢失:先验证本地备份,上传后从公开固定入口重新下载校验,完成后再更新远端 main。
+- 正式发布被误触发:使用不匹配软件 release tag glob 的 `reference-bundles`,归档设为 pre-release / 非 latest。
+- 旧提交仍引用 LFS:保留边界说明,旧版本与其他仓库的 LFS 额度不因本次迁移自动恢复。
+
+## 验证方式
+
+- 迁移前后 SHA-256 一致,两个 ZIP 均通过 `unzip -tq`。
+- 文档与 diff 检查;当前 Git tree 不再包含 ZIP / LFS 指针,下载后的本地 ZIP 被忽略。
+- Release API 确认附件、pre-release 状态及正式 latest 未变。
+- 从公开固定 URL 下载校验;对远端 main 执行启用 LFS 的全新 clone,确认正常检出且无需这些 ZIP。
+
+## 进度记录
+
+- [x] 核实干净 main 与远端一致;本地 ZIP 完整,备份哈希校验通过。
+- [x] 确认 ZIP 只用于研究参考、不接入默认构建,制定固定 URL 与独立归档 tag。
+- [x] 完成文档与 Git 跟踪迁移;文档骨架与 diff 检查通过,本地 ZIP 命中忽略规则。
+- [ ] 发布并校验 Release 附件。
+- [ ] 同步远端 main,验证干净克隆并记录 history。
diff --git a/docs/histories/2026-10/20261019-2336-migrate-reference-bundles-to-releases.md b/docs/histories/2026-10/20261019-2336-migrate-reference-bundles-to-releases.md
new file mode 100644
index 0000000..70952de
--- /dev/null
+++ b/docs/histories/2026-10/20261019-2336-migrate-reference-bundles-to-releases.md
@@ -0,0 +1,39 @@
+## [2026-10-19 23:36] | Task: 将官方参考 ZIP 从 Git LFS 迁移到 Releases
+
+### Execution Context
+
+- Agent ID: `/root`
+- Base Model: GPT-6
+- Runtime: Codex desktop
+
+### User Query
+
+> 将两份官方参考 ZIP 移到 GitHub Releases,提供固定下载地址,解决普通 clone 自动下载参考包导致 LFS 流量消耗的问题。
+
+### Changes Overview
+
+- 使用独立的 `reference-bundles` 归档 tag / pre-release,附件使用固定的 `releases/download/reference-bundles/<filename>` 地址。
+- 从当前 Git tree 移除两份 LFS 指针,保留本地 ZIP 为忽略文件,并保留 SHA-256 校验清单。
+- 同步归档目录说明、原始制品提交约定、归档发布指南及英文 Release 说明。
+- 不改变正式应用或 npm 版本,不重写历史;旧提交的 LFS 引用和已消耗的月度流量仍然存在。
+
+### Design Intent
+
+ZIP 只用于逆向研究与版本比较,不参与默认构建。按需下载 Release 附件可以避免普通 clone 自动消耗账号的 LFS 流量;固定 tag 与文件名维持可引用的下载入口。
+
+### Files Modified
+
+- `.gitattributes`
+- `.gitignore`
+- `docs/references/codex-computer-use-reverse-engineering/assets/README.md`
+- `docs/references/codex-computer-use-reverse-engineering/assets/official-bundles/computer-use/`
+- `docs/references/codex-computer-use-reverse-engineering/background-click-free-tooling.md`
+- `docs/releases/RELEASE_GUIDE.md`
+- `docs/releases/reference-bundles.md`
+- `docs/exec-plans/active/20261019-reference-bundles-release.md`
+
+### Validation
+
+- 本地原始 ZIP 和独立备份均通过原有 SHA-256 清单校验;两个 ZIP 均通过完整性检查。
+- 文档骨架检查和 diff 空白检查通过;ZIP 从 index 移除,保留的本地 ZIP 命中忽略规则。
+- Release 上传、公开 URL 下载及远端 main 克隆验证待完成后补充。
diff --git a/docs/references/codex-computer-use-reverse-engineering/assets/README.md b/docs/references/codex-computer-use-reverse-engineering/assets/README.md
index 5e5139e..f51db17 100644
--- a/docs/references/codex-computer-use-reverse-engineering/assets/README.md
+++ b/docs/references/codex-computer-use-reverse-engineering/assets/README.md
@@ -5,7 +5,7 @@
## 当前归档
- `official-bundles/computer-use/`
- - 从本地 bundled plugin cache 归档的官方 `computer-use` zip 包,当前包含 `1.0.750.zip` 和 `1.0.755.zip`;该目录下的 zip 通过 Git LFS 跟踪。
+ - 从本地 bundled plugin cache 归档的官方 `computer-use` zip 包,当前包含 `1.0.750.zip` 和 `1.0.755.zip`。原始 ZIP 分发在 [reference-bundles Release](https://github.com/iFurySt/open-computer-use/releases/tag/reference-bundles),此目录只跟踪下载说明与校验值;不再使用 Git LFS。下载方式见[归档说明](official-bundles/computer-use/README.md)。
- `extracted-2026-04-17/hint-arrow.png`
- 从 `Package_SlimCore.bundle` 导出的 `HintArrow` 资源,尺寸 `57x66`。
- `extracted-2026-04-17/software-cursor-slimcore.png`
@@ -21,7 +21,7 @@
## 说明
-- `official-bundles/` 保留原始 zip 制品,适合做版本差异、资源提取和后续复现;不要把它接入默认构建链路。
+- `official-bundles/` 保留原始 ZIP 制品的下载说明与校验值,适合做版本差异、资源提取和后续复现;原始文件按需从 Release 下载,不要把它接入默认构建链路。
- 这些文件不是截图,而是直接从 bundle 资源加载并转存为 PNG。
- 当前导出方式基于 AppKit `Bundle.image(forResource:)`,适合提取已经命名的 asset。
- 权限 onboarding 的大部分 UI 仍然更像 SwiftUI / 窗口组合逻辑,而不是一组大量静态图片,因此目前能导出的“权限视觉资源”主要是 `HintArrow`。
diff --git a/docs/references/codex-computer-use-reverse-engineering/assets/official-bundles/computer-use/1.0.750.zip b/docs/references/codex-computer-use-reverse-engineering/assets/official-bundles/computer-use/1.0.750.zip
deleted file mode 100644
index b23434f..0000000
--- a/docs/references/codex-computer-use-reverse-engineering/assets/official-bundles/computer-use/1.0.750.zip
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:7afe231e98ddb3b95030c8c56bb178a0217e98fcbb08abf9e1b467fd7ead5b9d
-size 13458495
diff --git a/docs/references/codex-computer-use-reverse-engineering/assets/official-bundles/computer-use/1.0.755.zip b/docs/references/codex-computer-use-reverse-engineering/assets/official-bundles/computer-use/1.0.755.zip
deleted file mode 100644
index 4a36b29..0000000
--- a/docs/references/codex-computer-use-reverse-engineering/assets/official-bundles/computer-use/1.0.755.zip
+++ /dev/null
@@ -1,3 +0,0 @@
-version https://git-lfs.github.com/spec/v1
-oid sha256:cfabe3f41bfec1ea1d5f99ca2f5424eac98487e9474a099394c372d5df7a6460
-size 13467875
diff --git a/docs/references/codex-computer-use-reverse-engineering/assets/official-bundles/computer-use/README.md b/docs/references/codex-computer-use-reverse-engineering/assets/official-bundles/computer-use/README.md
index f74ed70..a9160f4 100644
--- a/docs/references/codex-computer-use-reverse-engineering/assets/official-bundles/computer-use/README.md
+++ b/docs/references/codex-computer-use-reverse-engineering/assets/official-bundles/computer-use/README.md
@@ -1,16 +1,35 @@
# Official Computer Use Bundles
-这个目录保存从本地 bundled plugin cache 归档的官方 `computer-use` zip 包,用作逆向分析和版本对比输入。
+这个目录记录从本地 bundled plugin cache 归档的官方 `computer-use` ZIP 包,用作逆向分析和版本对比输入。原始 ZIP 保存在独立的 [reference-bundles Release](https://github.com/iFurySt/open-computer-use/releases/tag/reference-bundles),仓库只保留下载链接和 SHA-256 校验值。普通 clone 无需下载这些文件,也不需要为它们配置 Git LFS。
## 当前归档
| File | Size | SHA-256 |
| --- | ---: | --- |
-| `1.0.750.zip` | 13 MB | `7afe231e98ddb3b95030c8c56bb178a0217e98fcbb08abf9e1b467fd7ead5b9d` |
-| `1.0.755.zip` | 13 MB | `cfabe3f41bfec1ea1d5f99ca2f5424eac98487e9474a099394c372d5df7a6460` |
+| [1.0.750.zip](https://github.com/iFurySt/open-computer-use/releases/download/reference-bundles/1.0.750.zip) | 13 MB | `7afe231e98ddb3b95030c8c56bb178a0217e98fcbb08abf9e1b467fd7ead5b9d` |
+| [1.0.755.zip](https://github.com/iFurySt/open-computer-use/releases/download/reference-bundles/1.0.755.zip) | 13 MB | `cfabe3f41bfec1ea1d5f99ca2f5424eac98487e9474a099394c372d5df7a6460` |
+
+## 下载与校验
+
+在仓库根目录执行:
+
+```bash
+cd docs/references/codex-computer-use-reverse-engineering/assets/official-bundles/computer-use
+curl --fail --location --retry 3 --output 1.0.750.zip \
+ https://github.com/iFurySt/open-computer-use/releases/download/reference-bundles/1.0.750.zip
+curl --fail --location --retry 3 --output 1.0.755.zip \
+ https://github.com/iFurySt/open-computer-use/releases/download/reference-bundles/1.0.755.zip
+shasum -a 256 -c SHA256SUMS
+```
+
+本地下载的 ZIP 被 `.gitignore` 忽略。无需运行 `git lfs pull`;Windows 可用 `Get-FileHash -Algorithm SHA256` 与上表逐项比对。
+
+固定下载地址使用 `releases/download/reference-bundles/<filename>`,不依赖会随正式发版变化的 `latest`,也不使用下载跳转中临时签名的 URL。保留该 tag、Release 与附件文件名即可维持这些入口;已归档版本不要覆盖,新增版本使用新的文件名。
## 维护约定
-- 这里的 zip 只作为原始官方制品归档,不直接参与构建。
-- 新增 zip 时同步更新 `SHA256SUMS` 和本文件。
-- 该目录下的 zip 通过 Git LFS 跟踪,避免把大二进制直接写入普通 Git object。
+- 这些 ZIP 只作为原始官方制品归档,不直接参与构建。
+- 新增 ZIP 时,将其作为附件上传到 `reference-bundles` Release,并同步更新 `SHA256SUMS` 和本文件;校验值也随 Release 提供。
+- 不要把 ZIP 提交到 Git 或重新添加 LFS 追踪规则。
+- `reference-bundles` 是独立的资料归档 Release,标记为 pre-release 且不设为 latest,不发布 npm 或应用版本。
+- 本次迁移只移除当前分支的 LFS 引用,不重写旧提交。检出旧版本仍可能需要 Git LFS;已经消耗的本月流量不会因迁移返还,远端历史 LFS 对象也不会因此自动清除。
diff --git a/docs/references/codex-computer-use-reverse-engineering/background-click-free-tooling.md b/docs/references/codex-computer-use-reverse-engineering/background-click-free-tooling.md
index 7480725..0c5877e 100644
--- a/docs/references/codex-computer-use-reverse-engineering/background-click-free-tooling.md
+++ b/docs/references/codex-computer-use-reverse-engineering/background-click-free-tooling.md
@@ -181,7 +181,7 @@ tail -n 20 /tmp/bgclick-echoapp.log
- `research/` 下的一次性 Ghidra project。
- 大体积 `llvm-objdump` / `rabin2 -zz` / strings 原始输出。
- 临时 Swift package 的 `.build/`。
-- 从官方 bundle 直接导出的二进制或大资源,除非明确放到 `docs/references/.../assets/` 并配合 Git LFS 规则。
+- 从官方 bundle 直接导出的原始 ZIP 或大体积二进制;需要留档时放到独立的 `reference-bundles` Release,在 `docs/references/.../assets/` 中只提交下载说明与校验值。已经用于结论说明的小型提取图片可以继续随文档保留。
可以提交这些内容:
diff --git a/docs/releases/RELEASE_GUIDE.md b/docs/releases/RELEASE_GUIDE.md
index 2eec7c9..786f197 100644
--- a/docs/releases/RELEASE_GUIDE.md
+++ b/docs/releases/RELEASE_GUIDE.md
@@ -37,6 +37,16 @@ publisher 即使已绑定仓库不可变身份、页面仍显示 Valid,也不
- GitHub Release 正文:`docs/releases/github/vX.Y.Z.md`
- GitHub Release 页面:workflow 使用审核过的英文 notes 文件创建或更新,不直接引用 PR 标题自动生成正文。
+## 参考资料归档 Release
+
+官方 `computer-use` 原始 ZIP 使用独立的 `reference-bundles` tag / Release 分发,下载入口为 `https://github.com/iFurySt/open-computer-use/releases/download/reference-bundles/<filename>`。它只归档研究输入,不属于下面的 patch / minor 软件发版流程,不 bump plugin / npm / App 版本。
+
+- 标记为 pre-release,并显式设置 `--latest=false`,保持正式版本的 latest 下载入口。
+- tag 使用不匹配 `v*` 或 `*.*.*` 的固定名称 `reference-bundles`,避免触发应用与 npm release workflow。
+- 每个附件先校验 SHA-256 和 ZIP 完整性,上传后从公开固定 URL 重新下载并验证;发布说明使用英文。
+- 保留已发布 tag 与文件名,不覆盖既有版本附件;新增版本使用新的文件名,并同步仓库内的下载说明、`SHA256SUMS` 和 Release 中的校验清单。
+- 仓库不再跟踪这些 ZIP 或其 LFS 指针。目录说明见[官方参考包](../references/codex-computer-use-reverse-engineering/assets/official-bundles/computer-use/README.md)。
+
## 当前版本源
这个仓库当前有三类 release 版本源:
diff --git a/docs/releases/reference-bundles.md b/docs/releases/reference-bundles.md
new file mode 100644
index 0000000..acecda5
--- /dev/null
+++ b/docs/releases/reference-bundles.md
@@ -0,0 +1,20 @@
+# Official Computer Use Reference Bundles
+
+This archival pre-release preserves historical official `computer-use` plugin bundles for reverse engineering, version comparison, and reproducible research. These files are reference inputs and are not part of the Open Computer Use build or installation process.
+
+## Downloads
+
+| File | Size (bytes) | SHA-256 |
+| --- | ---: | --- |
+| [1.0.750.zip](https://github.com/iFurySt/open-computer-use/releases/download/reference-bundles/1.0.750.zip) | 13458495 | `7afe231e98ddb3b95030c8c56bb178a0217e98fcbb08abf9e1b467fd7ead5b9d` |
+| [1.0.755.zip](https://github.com/iFurySt/open-computer-use/releases/download/reference-bundles/1.0.755.zip) | 13467875 | `cfabe3f41bfec1ea1d5f99ca2f5424eac98487e9474a099394c372d5df7a6460` |
+
+Download both ZIP files and the attached `SHA256SUMS` into the same directory, then verify them:
+
+```bash
+shasum -a 256 -c SHA256SUMS
+```
+
+The versioned files use the fixed `reference-bundles` tag rather than the software release's `latest` URL. They are uploaded Release assets, so downloading them does not use Git LFS bandwidth. Existing filenames and the archival tag should be retained; future bundle versions should use new filenames.
+
+See the [reference bundle documentation](https://github.com/iFurySt/open-computer-use/blob/main/docs/references/codex-computer-use-reverse-engineering/assets/official-bundles/computer-use/README.md) for download commands and maintenance details. Historical commits may still contain LFS pointers; this migration does not rewrite Git history or restore an already consumed monthly LFS allowance.