npm 是做什麼的?
用於 npm 註冊表/帳戶任務:npm whoami、套件可用性、套件預留、發佈、組織檢查以及身份驗證除錯。
身份驗證
- 首先使用
one-password處理秘密規則。 - 絕不直接在 shell 工具中執行
op。 - 主要項目:
Molty中的npm Registry - steipete - Release Automation。 - 預設使用
OP_SERVICE_ACCOUNT_TOKEN;無需桌面解鎖。該項目包含有效的註冊表工作階段(registry_token)以及使用者名稱/密碼/TOTP 備用方案。 - 桌面
npmjs備用方案僅在明確指定時使用:當Molty不可用且使用者想要使用備用方案時,傳遞--account my.1password.com。明確的release/publish請求即同意其解鎖提示。 - 若出現以下情況,請停下來詢問:項目遺失、帳戶/保管庫不明確、憑證格式錯誤、npm 拒絕套件存取,或請求的套件/版本與儲存庫發佈目標不符。
- 在一個持久的 tmux 工作階段內執行 npm 身份驗證工作。失敗時重複使用該工作階段。
- 將 npm 身份驗證資訊保存在暫存的 npmrc 中;命令執行後將其刪除。
- 所有輔助腳本共用
scripts/npm-auth.sh:優先使用已儲存的registry_token工作階段,然後使用scripts/npm-auth-login.mjs透過全新的六位數 OTP 進行註冊表登入;成功的備用工作階段會快取回同一個項目。不要手動提取欄位、執行註冊表登入或寫入快取。 - 憑證選擇優先使用標準欄位
id,然後是purpose,最後是唯一標籤;僅匹配重複標籤的請求會被拒絕(舊版npmjs可能保留相同標籤的欄位)。 - 對於臨時性需身份驗證的註冊表命令,使用
scripts/npm-service.sh -- <npm args...>;對於本地套件,使用publish-package.sh。 - npm 11 的提示管線很脆弱;避免使用
printf ... | npm login --auth-type=legacy。 - 除非必要,避免對 npm 登入使用
expect;日誌可能會回顯提示,且容易出錯。 - 對於自動化操作,優先使用輔助腳本的註冊表 API 登入路徑(
npm-profileloginCouch)。 - 如果身份驗證形式不明確或
npm whoami失敗,請停下來詢問確切的欄位標籤/憑證修正。不要探查更多 1Password 項目或啟動新的 tmux 工作階段。
套件發佈
在套件根目錄下,於相同的身份驗證 tmux 工作階段內執行:
/Users/steipete/Projects/agent-scripts/skills/npm/scripts/publish-package.sh
輔助腳本會驗證身份、拒絕已存在的套件版本、使用全新的 OTP 發佈、重試一次過期的 OTP、驗證註冊表可見性,並清理身份驗證檔案。
套件預留
在相同的 tmux 工作階段內使用 scripts/reserve-packages.sh:
/Users/steipete/Projects/agent-scripts/skills/npm/scripts/reserve-packages.sh package-one package-two
功能:
- 經由
op讀取一次Molty的 release-automation 項目 - 重複使用已儲存的註冊表工作階段,或透過使用者名稱/密碼/TOTP 建立一個新的工作階段
- 使用通用 README 發佈
0.0.0佔位套件 - 在每個套件發佈失敗後繼續執行
- 在日誌中編輯掉令牌/OTP
- 清理暫存的 npmrc/工作目錄
注意事項:
- npm 可能拒絕與已發佈套件名稱過於相似的名稱。請將其視為註冊表政策結果,而非身份驗證失敗。
- npm CLI 提示管線在 npm 11 上很脆弱。對於腳本化的
npm login,請優先使用輔助腳本的註冊表 API 登入路徑。 - 對於範圍套件,
npm view可能延遲或回傳 404,即使套件已存在。請檢查npm access get status <pkg>;狀態為public或發佈失敗訊息為previously published versions表示該名稱已被預留。