SuperAPI AI 工具集

npm-git-install

部署与运维

查看项目

更新于 10-15 19:53

技能介绍

用途:当核心问题是“该信任哪种安装包、哪种交付路径适合该依赖、下一步做什么”时使用。适合从 GitHub 等 Git 主机安装未发布、fork、分支/标签/提交固定或私有包,以及判断 monorepo 中该用 Git 安装、workspace 链接、tarball 还是先发布。

主要能力:将请求归一化为六类交付包(临时桥、共享桥、私有认证、制品回退、workspace 内循环、持久分发);为每个包选一个主交付模式与一个可选回退;用 Tier 0 本地到 Tier 3 生产的分级模型判断持久性,多级取最高;按发布优先、workspace/file、SHA 固定共享桥、tarball、直接 Git 桥的顺序选最安全模式。命令按包管理器给出,如 npm install github:owner/repo#<commit>、pnpm add github:owner/repo#<commit>、yarn add owner/repo#<commit>、bun add github:owner/repo#<commit>;Git URL 可为 git+https://github.com/owner/repo.git#<commit> 或 git+ssh://git@github.com/owner/repo.git#<commit>;tarball 用 npm install https://.../package.tgz;本地路径用 "dep": "file:../relative-path"。

使用方式:先读 references/intake-packets-and-route-outs.md 处理陌生交付包;比较 Git、tarball、workspace、publish-first 时读 references/delivery-decision-matrix.md;读 references/package-manager-behavior.md 了解管理器差异;涉及 CI 或私有认证读 references/private-auth-and-ci.md。每个回答需覆盖所选 ref/制品/版本策略、是否拉取原始源码及生命周期/构建行为、本地与 CI 认证、确定性安装期望(如 npm ci、冻结锁文件、固定 ref)、依赖转正后的替换路径,并输出一份简洁安装简报。

限制:不适用本地 Git 分支/历史问题、GitHub 仓库管理、monorepo 自动化、系统环境搭建,以及仅需普通版本升级的场景。共享场景默认优先 SHA 固定而非浮动分支;私有 Git 好不过最差环境的认证配置;原始 Git 安装可能像源码打包而非注册表下载;若依赖已成常规共享基础设施,通常应直接建议先发布或正确打包。相关文档 URL 见资料中 npm package spec、npm pack、pnpm add/workspaces、Yarn Git 与 workspaces、Bun add、GitHub Packages 等链接。