Skip to content

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

Prefer npm trusted publishing in release

Leo4d4c7a0dfa52
diff --git a/docs/histories/2026-04/20260422-1205-harden-npm-release-retry.md b/docs/histories/2026-04/20260422-1205-harden-npm-release-retry.md
index 164b935..1a935f8 100644
--- a/docs/histories/2026-04/20260422-1205-harden-npm-release-retry.md
+++ b/docs/histories/2026-04/20260422-1205-harden-npm-release-retry.md
@@ -9,6 +9,7 @@
### 变更
- **[Publish Recovery]**: `scripts/npm/publish-packages.mjs` 发布每个 staged package 前先用 `npm view <name>@<version>` 检查同版本是否已经存在;存在时直接跳过。
+- **[Auth Preference]**: GitHub Actions 暴露 OIDC 时优先走 npm trusted publishing,不再因为存在 `NPM_TOKEN` fallback 就强制清掉 OIDC 环境;token 仅作为 fallback。
- **[Retry]**: npm publish 失败后最多重试 3 次,并在每次失败后再次检查版本是否已经对 registry 可见,用于覆盖 registry 短暂错误或部分发布成功场景。
- **[Release Guide]**: 在发版指南中补充 npm publish 404 的排查方式,以及 tag 重发时脚本如何处理已存在版本。
diff --git a/docs/releases/RELEASE_GUIDE.md b/docs/releases/RELEASE_GUIDE.md
index 1f7eba3..7fe0772 100644
--- a/docs/releases/RELEASE_GUIDE.md
+++ b/docs/releases/RELEASE_GUIDE.md
@@ -106,7 +106,7 @@ gh run view -R iFurySt/open-codex-computer-use <run-id> --log-failed
- 先回头检查 `plugin.json` 的 `version`,再检查 staging 包实际产出的 `package.json`。
- `npm error 404 Not Found - PUT https://registry.npmjs.org/<package>`
- 先确认 registry 上目标包旧版本是否仍可见:`npm view <package> versions --json`。
- - 当前 publish 脚本会在发布前跳过已经存在的同版本 package,并对 publish 失败做短暂重试;如果 tag 重发前某个 package 已经部分发布成功,重新跑同一个 release 不会因为该 package 已存在而中断。
+ - 当前 publish 脚本会在发布前跳过已经存在的同版本 package,并对 publish 失败做短暂重试;如果 GitHub Actions OIDC 可用,会优先走 trusted publishing,再回退到 `NODE_AUTH_TOKEN`。如果 tag 重发前某个 package 已经部分发布成功,重新跑同一个 release 不会因为该 package 已存在而中断。
- 构建阶段失败
- 优先看 `Build npm release artifacts`、`Build Cursor Motion DMG` 或 Swift 编译错误。
- GitHub Release 资产上传失败
diff --git a/scripts/npm/publish-packages.mjs b/scripts/npm/publish-packages.mjs
index a228ec7..a85b866 100644
--- a/scripts/npm/publish-packages.mjs
+++ b/scripts/npm/publish-packages.mjs
@@ -115,39 +115,87 @@ function npmPackageVersionExists(packageName, version, env) {
return false;
}
-function publishWithRetry(args, npmEnv, packageName, version) {
- if (npmPackageVersionExists(packageName, version, npmEnv)) {
- process.stdout.write(`${packageName}@${version} already exists on npm; skipping publish.\n`);
- return;
+function publishEnvCandidates(baseEnv) {
+ const candidates = [];
+
+ if (baseEnv.ACTIONS_ID_TOKEN_REQUEST_URL) {
+ const oidcEnv = { ...baseEnv };
+ delete oidcEnv.NODE_AUTH_TOKEN;
+ delete oidcEnv.NPM_TOKEN;
+ delete oidcEnv.NPM_CONFIG_USERCONFIG;
+ delete oidcEnv.NPM_ID_TOKEN;
+ candidates.push({
+ env: oidcEnv,
+ label: "GitHub Actions OIDC trusted publishing",
+ });
}
- for (let attempt = 1; attempt <= maxPublishAttempts; attempt += 1) {
- const result = spawnSync("npm", args, {
- cwd: repoRoot,
- stdio: "inherit",
- env: npmEnv,
+ if (baseEnv.NODE_AUTH_TOKEN) {
+ const tokenEnv = { ...baseEnv };
+ delete tokenEnv.ACTIONS_ID_TOKEN_REQUEST_URL;
+ delete tokenEnv.ACTIONS_ID_TOKEN_REQUEST_TOKEN;
+ delete tokenEnv.NPM_ID_TOKEN;
+ candidates.push({
+ env: tokenEnv,
+ label: "NODE_AUTH_TOKEN fallback",
});
+ }
- if (result.status === 0) {
- return;
- }
+ if (candidates.length === 0) {
+ candidates.push({
+ env: baseEnv,
+ label: "default npm environment",
+ });
+ }
- if (npmPackageVersionExists(packageName, version, npmEnv)) {
- process.stdout.write(`${packageName}@${version} is visible on npm after publish failure; continuing.\n`);
- return;
- }
+ return candidates;
+}
- if (attempt < maxPublishAttempts) {
- const delayMs = attempt * 5000;
- process.stderr.write(
- `npm publish ${packageName}@${version} failed with exit code ${result.status ?? "unknown"}; retrying in ${delayMs / 1000}s.\n`
- );
- sleep(delayMs);
- continue;
- }
+function publishWithRetry(args, npmEnvCandidates, packageName, version) {
+ if (npmPackageVersionExists(packageName, version, npmEnvCandidates[0].env)) {
+ process.stdout.write(`${packageName}@${version} already exists on npm; skipping publish.\n`);
+ return;
+ }
- throw new Error(`npm ${args.join(" ")} failed with exit code ${result.status ?? "unknown"}`);
+ let lastError;
+
+ for (const { env, label } of npmEnvCandidates) {
+ process.stdout.write(`Publishing ${packageName}@${version} using ${label}.\n`);
+
+ for (let attempt = 1; attempt <= maxPublishAttempts; attempt += 1) {
+ const result = spawnSync("npm", args, {
+ cwd: repoRoot,
+ stdio: "inherit",
+ env,
+ });
+
+ if (result.status === 0) {
+ return;
+ }
+
+ if (npmPackageVersionExists(packageName, version, env)) {
+ process.stdout.write(`${packageName}@${version} is visible on npm after publish failure; continuing.\n`);
+ return;
+ }
+
+ lastError = new Error(`npm ${args.join(" ")} failed with exit code ${result.status ?? "unknown"}`);
+
+ if (attempt < maxPublishAttempts) {
+ const delayMs = attempt * 5000;
+ process.stderr.write(
+ `npm publish ${packageName}@${version} via ${label} failed with exit code ${result.status ?? "unknown"}; retrying in ${delayMs / 1000}s.\n`
+ );
+ sleep(delayMs);
+ continue;
+ }
+
+ if (npmEnvCandidates.length > 1 && label !== npmEnvCandidates[npmEnvCandidates.length - 1].label) {
+ process.stderr.write(`npm publish ${packageName}@${version} via ${label} failed; trying next auth path.\n`);
+ }
+ }
}
+
+ throw lastError ?? new Error(`npm ${args.join(" ")} failed`);
}
function main() {
@@ -195,16 +243,7 @@ function main() {
...process.env,
};
- // npm prefers GitHub Actions OIDC when the runner exposes it. If we
- // explicitly provided an npm token fallback, clear the OIDC env so publish
- // actually uses the token path.
- if (process.env.NODE_AUTH_TOKEN) {
- delete npmEnv.ACTIONS_ID_TOKEN_REQUEST_URL;
- delete npmEnv.ACTIONS_ID_TOKEN_REQUEST_TOKEN;
- delete npmEnv.NPM_ID_TOKEN;
- }
-
- publishWithRetry(args, npmEnv, packageName, version);
+ publishWithRetry(args, publishEnvCandidates(npmEnv), packageName, version);
}
}