Skip to content

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

Document local validation before release

Leo585c56f94837
diff --git a/docs/histories/2026-05/20260507-1945-local-validation-before-release.md b/docs/histories/2026-05/20260507-1945-local-validation-before-release.md
new file mode 100644
index 0000000..e9c614d
--- /dev/null
+++ b/docs/histories/2026-05/20260507-1945-local-validation-before-release.md
@@ -0,0 +1,18 @@
+# 本地验证优先于公开发版
+
+## 用户诉求
+
+用户指出构建后不应该持续公开发版,建议通过 Codex TOML 配置指向本地 `open-computer-use` 来验证,避免外部用户看到过多 patch release。
+
+## 主要改动
+
+- 更新 `docs/releases/RELEASE_GUIDE.md`,明确日常对齐验证默认走本地构建和本地 MCP 配置。
+- 补充公开 release 的触发条件:只有用户明确要求发版,或修复已经稳定到需要对外交付时,才进入 release checklist。
+
+## 设计动机
+
+公开 release 应该表达对外可消费的稳定交付,而不是每次本地验证的副产物。后续 agent 应先用本地构建验证 `open-computer-use` 与官方 `computer-use` 的行为差异,减少无意义的版本噪音。
+
+## 受影响文件
+
+- `docs/releases/RELEASE_GUIDE.md`
diff --git a/docs/releases/RELEASE_GUIDE.md b/docs/releases/RELEASE_GUIDE.md
index 2bac200..d6463d3 100644
--- a/docs/releases/RELEASE_GUIDE.md
+++ b/docs/releases/RELEASE_GUIDE.md
@@ -11,6 +11,12 @@
- 看 GitHub Actions release 失败原因
- 重发某个失败版本
+## 什么时候才发公开版本
+
+- 日常修复、官方 `computer-use` 对齐验证和本地回归,默认只构建本地 app / 二进制并让 MCP client 指向本地构建产物。
+- 不要把 patch release 当作普通验证手段;只有用户明确要求公开发版,或某个修复已经达到需要交付给外部用户的稳定状态时,才进入下面的 release checklist。
+- 如果只是为了让 Codex 使用最新本地实现,优先更新本机 `~/.codex/config.toml` 中的 `open-computer-use` MCP server command,指向仓库本地构建产物,而不是 bump 版本、打 tag、推 release。
+
## 当前 release 入口
- 本地 staging / 打 tgz:`./scripts/release-package.sh`