Skip to content

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

fix: support developer id signing keychains

Leob2c4e8610ee4
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index 6a3fda9..d04f5b7 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -35,9 +35,47 @@ jobs:
with:
node-version: "22"
- - name: Build npm release artifacts
+ - name: Prepare Open Computer Use signing config
env:
- OPEN_COMPUTER_USE_CODESIGN_MODE: adhoc
+ OPEN_COMPUTER_USE_CODESIGN_P12_BASE64: ${{ secrets.OPEN_COMPUTER_USE_CODESIGN_P12_BASE64 }}
+ OPEN_COMPUTER_USE_CODESIGN_P12_PASSWORD: ${{ secrets.OPEN_COMPUTER_USE_CODESIGN_P12_PASSWORD }}
+ OPEN_COMPUTER_USE_CODESIGN_KEYCHAIN_PASSWORD: ${{ secrets.OPEN_COMPUTER_USE_CODESIGN_KEYCHAIN_PASSWORD }}
+ OPEN_COMPUTER_USE_CODESIGN_IDENTITY: ${{ secrets.OPEN_COMPUTER_USE_CODESIGN_IDENTITY }}
+ run: |
+ echo "OPEN_COMPUTER_USE_CODESIGN_MODE=adhoc" >> "${GITHUB_ENV}"
+
+ if [ -z "${OPEN_COMPUTER_USE_CODESIGN_P12_BASE64}" ] || [ -z "${OPEN_COMPUTER_USE_CODESIGN_P12_PASSWORD}" ]; then
+ echo "No Open Computer Use signing certificate configured; release artifacts will fall back to ad-hoc signing and may create install-specific macOS permission identities."
+ exit 0
+ fi
+
+ keychain_password="${OPEN_COMPUTER_USE_CODESIGN_KEYCHAIN_PASSWORD:-${RUNNER_TEMP}-open-computer-use-keychain}"
+ cert_path="${RUNNER_TEMP}/open-computer-use-signing.p12"
+ keychain_path="${RUNNER_TEMP}/open-computer-use-signing.keychain-db"
+
+ CERT_PATH="${cert_path}" python3 -c 'import base64, os, pathlib; pathlib.Path(os.environ["CERT_PATH"]).write_bytes(base64.b64decode(os.environ["OPEN_COMPUTER_USE_CODESIGN_P12_BASE64"]))'
+
+ security create-keychain -p "${keychain_password}" "${keychain_path}"
+ security set-keychain-settings -lut 21600 "${keychain_path}"
+ security unlock-keychain -p "${keychain_password}" "${keychain_path}"
+ security import "${cert_path}" -k "${keychain_path}" -P "${OPEN_COMPUTER_USE_CODESIGN_P12_PASSWORD}" -T /usr/bin/codesign -T /usr/bin/security
+ security set-key-partition-list -S apple-tool:,apple:,codesign: -s -k "${keychain_password}" "${keychain_path}"
+
+ resolved_identity="$(security find-identity -v -p codesigning "${keychain_path}" | sed -n 's/.*\"\\(.*\\)\"/\\1/p' | head -n 1)"
+ if [ -z "${resolved_identity}" ]; then
+ echo "Imported signing certificate, but no usable codesigning identity was found in ${keychain_path}." >&2
+ exit 1
+ fi
+
+ echo "Resolved Open Computer Use signing identity: ${resolved_identity}"
+
+ {
+ echo "OPEN_COMPUTER_USE_CODESIGN_MODE=identity"
+ echo "OPEN_COMPUTER_USE_CODESIGN_IDENTITY=${resolved_identity}"
+ echo "OPEN_COMPUTER_USE_CODESIGN_KEYCHAIN=${keychain_path}"
+ } >> "${GITHUB_ENV}"
+
+ - name: Build npm release artifacts
run: npm run npm:pack
- name: Upload npm release artifacts
diff --git a/docs/CICD.md b/docs/CICD.md
index 311ae69..f6518b4 100644
--- a/docs/CICD.md
+++ b/docs/CICD.md
@@ -6,7 +6,7 @@
- `scripts/release-package.sh`:构建 universal `Open Computer Use.app`,stage 三个 npm 包目录,并产出 `dist/release/npm/*.tgz` 与 `dist/release/release-manifest.json`。当前 CI 继续显式使用 ad-hoc signing,保持和此前发布链路一致;本地 debug/dev 构建则允许使用开发机自己的签名身份。
- `scripts/build-cursor-motion-dmg.sh`:本地构建 `Cursor Motion.app` 并封装 `dist/release/cursor-motion/CursorMotion-<version>.dmg`,支持 `native` / `arm64` / `x86_64` / `universal`。
-- `.github/workflows/release.yml`:支持 push semver tag 自动发布,也支持手动触发;tag push 时会同时跑 npm release 打包逻辑与 `Cursor Motion` 的 DMG 打包,并把 `.dmg` 上传到对应的 GitHub Releases 页面。`Open Computer Use` 的 npm 产物当前固定走 ad-hoc signing,后续如果要接入正式 Apple 分发证书,再在这条流水线上补回统一签名逻辑。当前 `Cursor Motion` 这条链路仍只做 ad-hoc codesign,不包含 notarization。
+- `.github/workflows/release.yml`:支持 push semver tag 自动发布,也支持手动触发;tag push 时会同时跑 npm release 打包逻辑与 `Cursor Motion` 的 DMG 打包,并把 `.dmg` 上传到对应的 GitHub Releases 页面。`Open Computer Use` 的 npm 产物默认走 ad-hoc signing;如果配置了 `OPEN_COMPUTER_USE_CODESIGN_*` secrets,则会先导入 `Developer ID Application` 证书,再按同一 identity 对 release `.app` 统一签名。当前 `Cursor Motion` 这条链路仍只做 ad-hoc codesign,不包含 notarization。
## 设计原则
diff --git a/docs/histories/2026-04/20260420-1740-prepare-developer-id-signing-assets.md b/docs/histories/2026-04/20260420-1740-prepare-developer-id-signing-assets.md
new file mode 100644
index 0000000..d130a0f
--- /dev/null
+++ b/docs/histories/2026-04/20260420-1740-prepare-developer-id-signing-assets.md
@@ -0,0 +1,28 @@
+## [2026-04-20 17:40] | Task: 准备 Developer ID signing 资产并恢复可选 CI 签名链路
+
+### 🤖 Execution Context
+* **Agent ID**: `codex`
+* **Base Model**: `gpt-5.4`
+* **Runtime**: `Codex CLI on macOS`
+
+### 📥 User Query
+> 你直接做吧,做到不能做或者需要我的时候再叫我。
+
+### 🛠 Changes Overview
+**Scope:** `.github/workflows/`、`docs/`、`scripts/`
+
+**Key Actions:**
+- **[Developer ID Asset Prep]**: 将用户本机基于 CSR 签发下来的 `Developer ID Application` 证书导入 `login.keychain-db`,确认存在可用 codesigning identity,并导出本地可复用的 `.p12` 资产。
+- **[CI Signing Fix]**: 修复 `scripts/build-open-computer-use-app.sh` 在使用临时 keychain 时仅把 keychain 传给 `codesign --keychain`、但未加入用户搜索链导致“item could not be found in the keychain”的问题。
+- **[Workflow Restore]**: 把 release workflow 的可选证书导入步骤补回;当 repo secrets 里配置 `OPEN_COMPUTER_USE_CODESIGN_*` 时,CI 会导入 `.p12` 并统一用 `Developer ID Application` identity 对 npm release `.app` 签名,未配置时仍退回 ad-hoc。
+- **[Docs Sync]**: 同步 CI/CD 与 release guide,明确当前状态是“Open Computer Use 可选 Developer ID 签名,Cursor Motion 仍为 ad-hoc,notarization 还未接”。
+
+### 🧠 Design Intent (Why)
+用户已经在自己机器上完成 CSR,并用团队账号在 Apple Developer 网站上签发了 `Developer ID Application` 证书。此时最重要的不是继续停留在“材料怎么拿”,而是把这份证书真正转成可用于 CI 的 `.p12` 资产,并把仓库里的签名链路补回到“有 secret 就统一签名、没 secret 也不阻塞发版”的状态。这样后续只剩 GitHub secrets 与 notarization 两个外部依赖点。
+
+### 📁 Files Modified
+- `scripts/build-open-computer-use-app.sh`
+- `.github/workflows/release.yml`
+- `docs/CICD.md`
+- `docs/releases/RELEASE_GUIDE.md`
+- `docs/histories/2026-04/20260420-1740-prepare-developer-id-signing-assets.md`
diff --git a/docs/releases/RELEASE_GUIDE.md b/docs/releases/RELEASE_GUIDE.md
index 6ff2155..558208e 100644
--- a/docs/releases/RELEASE_GUIDE.md
+++ b/docs/releases/RELEASE_GUIDE.md
@@ -113,8 +113,9 @@ gh run view -R iFurySt/open-codex-computer-use <run-id> --log-failed
## 当前已知边界
-- `Cursor Motion` 当前 release 资产只做 ad-hoc codesign,不包含 Apple Developer ID 签名和 notarization。
-- 如果后续要把下载体验收口成更标准的 macOS 分发流程,还需要继续补 Developer ID signing、notarization 和对应 secret / keychain 流程。
+- `Open Computer Use` 的 npm release 产物在没有配置 `OPEN_COMPUTER_USE_CODESIGN_P12_BASE64` / `OPEN_COMPUTER_USE_CODESIGN_P12_PASSWORD` 等 secrets 时,仍会退回 ad-hoc signing;配置后会先导入 `Developer ID Application` 证书,再按该 identity 统一签名。
+- `Cursor Motion` 当前 release 资产仍只做 ad-hoc codesign,不包含 Apple Developer ID 签名和 notarization。
+- 如果后续要把下载体验收口成更标准的 macOS 分发流程,还需要继续补 notarization 和对应 App Store Connect API key 流程。
## 如果 tag 已经打错了
diff --git a/scripts/build-open-computer-use-app.sh b/scripts/build-open-computer-use-app.sh
index 6e720a7..9a17625 100755
--- a/scripts/build-open-computer-use-app.sh
+++ b/scripts/build-open-computer-use-app.sh
@@ -117,6 +117,49 @@ find_codesign_identity() {
| head -n 1
}
+list_user_keychains() {
+ security list-keychains -d user \
+ | sed -n 's/^[[:space:]]*"\(.*\)"$/\1/p'
+}
+
+run_with_codesign_keychain() {
+ local keychain_path="${1:-}"
+ shift
+
+ if [[ -z "${keychain_path}" ]]; then
+ "$@"
+ return
+ fi
+
+ local -a existing_keychains=()
+ while IFS= read -r keychain; do
+ if [[ -n "${keychain}" ]]; then
+ existing_keychains+=("${keychain}")
+ fi
+ done < <(list_user_keychains)
+
+ local -a desired_keychains=("${keychain_path}")
+ local existing=""
+ for existing in "${existing_keychains[@]}"; do
+ if [[ "${existing}" != "${keychain_path}" ]]; then
+ desired_keychains+=("${existing}")
+ fi
+ done
+
+ security list-keychains -d user -s "${desired_keychains[@]}" >/dev/null
+
+ local status=0
+ "$@" || status=$?
+
+ if [[ ${#existing_keychains[@]} -gt 0 ]]; then
+ security list-keychains -d user -s "${existing_keychains[@]}" >/dev/null
+ else
+ security list-keychains -d user -s >/dev/null
+ fi
+
+ return "${status}"
+}
+
resolve_codesign_identity() {
case "${codesign_mode}" in
none)
@@ -174,7 +217,8 @@ codesign_app_bundle() {
args+=(--keychain "${codesign_keychain}")
fi
- codesign "${args[@]}" "${app_path}" >/dev/null
+ run_with_codesign_keychain "${codesign_keychain}" \
+ codesign "${args[@]}" "${app_path}" >/dev/null
if [[ "${identity}" == "-" ]]; then
echo "Signed ${app_path} with ad-hoc identity; macOS TCC may still treat separately built copies as different app identities until a stable Apple signing identity is configured." >&2