👾 Open Computer Use – Open-Source Alternative to Codex Computer Use
Swift accessibilityai-agentai-agentsclaude-codecodexcodex-computer-usecomputer-usecomputer-use-agentcross-platformcuadesktop-automationgemini-cligui-automationmacosmcpmodel-context-protocolopen-computer-useopen-computer-use-mcpopenai-codexopencode
fix: move official reference bundles out of Git LFS
ifurystb3f401573217
diff --git a/.gitattributes b/.gitattributesindex 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/.gitignoreindex 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/*.zipdiff --git a/docs/exec-plans/active/20261019-reference-bundles-release.md b/docs/exec-plans/active/20261019-reference-bundles-release.mdnew file mode 100644index 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.mdnew file mode 100644index 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.mdindex 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.zipdeleted file mode 100644index 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 13458495diff --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.zipdeleted file mode 100644index 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 13467875diff --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.mdindex 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.mdindex 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.mdindex 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.mdnew file mode 100644index 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.