npm 是做什么的?
用于执行 npm 注册表/账户相关任务:npm whoami、包可用性检查、包保留、发布、组织验证以及认证调试。
认证
- 优先使用
one-password进行密钥规则操作。 - 绝对不要在 shell 工具中直接运行
op。 - 主条目:
npm Registry - steipete - Release Automation,存储在Molty保管库。 - 默认使用
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通过六位数一次性密码进行注册表登录;成功的回退会话将被缓存回同一个条目。不要手动实现字段提取、注册表登录或缓存写入。 - 凭据选择优先级:首选规范的
id字段,然后是purpose字段,最后是唯一的标签;重复标签的匹配将被拒绝(旧版npmjs可能保留相同标签的字段)。 - 对于临时性的已认证注册表命令,使用
scripts/npm-service.sh -- <npm args...>;对于本地包发布,使用publish-package.sh。 - npm 11 的提示符管道化不够稳定;避免使用
printf ... | npm login --auth-type=legacy。 - 除非必要,否则避免对 npm 登录使用
expect;日志可能泄露提示信息,且容易出错。 - 自动化场景下,更推荐使用辅助脚本的注册表 API 登录路径(
npm-profile的loginCouch)。 - 如果认证形态不明确或
npm whoami失败,停止并询问确切的字段标签或凭据修正。不要探测更多 1Password 条目或启动新的 tmux 会话。
包发布
在包根目录中,在同一个认证 tmux 会话内执行:
/Users/steipete/Projects/agent-scripts/skills/npm/scripts/publish-package.sh
该辅助脚本会验证身份、拒绝发布已存在的包版本、使用新的一次性密码发布、重试一次过期的一次性密码、验证注册表可见性,并清理认证文件。
包保留
在同一个 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占位包 - 在每个包发布失败后继续执行后续操作
- 在日志中遮盖令牌/一次性密码
- 清理临时 npmrc 和工作目录
注意事项:
- npm 可能会因包名与已发布的包名过于相似而拒绝。这应视为注册表策略结果,而非认证失败。
- npm 11 的 CLI 提示符管道化不够稳定。建议优先使用辅助脚本的注册表 API 登录路径,而非脚本化的
npm login。 - 对于作用域包,
npm view可能延迟或返回 404,即使包已存在。请使用npm access get status <pkg>检查;返回public或发布失败报错previously published versions表示该名称已被保留。