Spec Kit 在无网络Air-Gapped环境如何安装构建 wheel 包并离线初始化项目【免费下载链接】spec-kit Toolkit to help you get started with Spec-Driven Development项目地址: https://gitcode.com/GitHub_Trending/sp/spec-kit如果你的环境屏蔽了对 PyPI 和 GitHub 的访问典型的企业管理内网场景常规的uv tool install specify-cli或pip install specify-cli都无法完成。Spec Kit 官方为此提供了一条便携 wheel 包路径先在一台有网的机器上构建 wheel 并下载全部运行依赖把整个dist/目录拷贝到目标机器再离线安装、离线初始化项目。安装指南也确认从该仓库本地构建的 wheel 是离线 / air-gapped 环境下的有效安装方式。本文依据 Enterprise / Air-Gapped Installation 与 Installation Guide 走通这条完整流程。开始前的环境条件三个文档明确的适用条件任何一条不满足都需要先处理目标机器Python 3.11。构建机必须与目标机器相同的操作系统和 Python 版本。原因是pip download解析的是平台相关的 wheel例如 PyYAML 含原生扩展在别的系统或 Python 版本上下载的依赖可能与目标机器不匹配。若要同时支持多个平台需要在每个目标 OSLinux、macOS、Windows和每个 Python 版本上各重复一次构建步骤。Windows 目标机器离线脚手架要求 PowerShell 7pwshWindows PowerShell 5.xpowershell.exe不满足要求需要先安装 PowerShell 7。另外安装指南将 Git 列为可选依赖——仅当启用 git 扩展时才需要。离线流程本身不依赖 Git 扩展。第 1 步在有网机器上构建 wheel 并下载依赖在构建机上执行文档原命令# Clone the repository git clone https://github.com/github/spec-kit.git cd spec-kit # Build the wheel pip install build python -m build --wheel --outdir dist/ # Download the wheel and all its runtime dependencies pip download -d dist/ dist/specify_cli-*.whl逐条说明pip install build在有网机器上安装构建工具本身需要网络python -m build --wheel把仓库构建为 wheel 并输出到dist/最后一条pip download是关键——它以刚构建出的specify_cli-*.whl为输入把该 wheel 及所有运行时依赖都下载为本地 wheel 文件放进dist/这一步完成后dist/就是离线安装所需的全部内容。离线可用的原因构建配置见 pyproject.toml 中的force-include段会把模板templates/、三种自动化脚本scripts/bash、scripts/powershell、scripts/python、git/agent-context/assess/bug 扩展、speckitworkflow 和 lean/constitution-sync 预设打进 wheel 的core_pack中注释明确写着这是为了让specify init在无网络环境下工作。所以第 4 步的初始化不需要任何网络请求。关于版本air-gapped 文档没有指定要克隆哪个版本wheel 的版本取决于你克隆时的提交安装指南对源码安装的建议是固定到一个 release tag例如v0.12.11保留前导v如需版本可复现可先检出对应 tag 再构建。第 2 步传输dist/目录将完整的dist/目录包含specify-cliwheel 和全部依赖 wheel通过 USB、网络共享或组织内认可的方式拷贝到目标机器。文档对传输方式没有其他限制。第 3 步在目标机器上离线安装在dist/目录所在位置执行pip install --no-index --find-links./dist specify-cli--no-index安装过程不查询 PyPI因此不依赖外网--find-links./dist让 pip 从本地dist/中查找上一步拷贝过来的 wheel 及其依赖。第 4 步验证安装specify version按安装指南这是本地的版本/运行检查确认specify命令可用并报告版本。它不能证明该可执行文件来自 PyPI 还是本地构建的 wheel。第 5 步离线初始化项目specify init my-project --integration copilotair-gapped 文档明确说明该命令不需要网络访问——默认使用 wheel 内置的 bundled assets。my-project是文档示例中的项目名换成你自己的项目名即可按 快速上手指南的说明也可以用specify init .在当前目录初始化。关于--integration参数的文档依据交互式终端中init会提示你选择编码代理集成非交互式会话CI 或管道运行在未传--integration时默认 GitHub Copilotair-gapped 示例正是显式传了--integration copilot需要其他代理时安装指南给出的取值示例为claude、gemini、copilot、codebuddy、pi、omp。可选参数安装指南与快速上手指南--script sh|ps|py强制指定自动化脚本类型不传时 Windows 默认ps、其他系统默认sh交互模式下未传会提示选择--non-interactiveCI 或 AI agent 环境使用让未指定的选项采用文档默认值而不是卡在方向键选择器上。第 6 步验证初始化结果按安装指南初始化成功后应看到两类结果项目下出现与所选脚本类型对应的自动化脚本目录.specify/scripts/bash/Linux/macOS 默认含.sh脚本.specify/scripts/powershell/Windows 默认含.ps1脚本.specify/scripts/python/--script py时同时安装平台 shell 回退脚本编码代理中可用以下命令/speckit.specify、/speckit.plan、/speckit.tasks、/speckit.implement、/speckit.analyze、/speckit.clarify、/speckit.checklist、/speckit.constitution、/speckit.converge、/speckit.taskstoissues。已知问题与限制Linux 上 Git 认证有问题可选分支air-gapped 文档附带了一个安装 Git Credential Manager v2.6.1 的脚本。注意该脚本的副作用从 GitHub Releases 下载.deb文件、用sudo dpkg -i安装系统包、修改全局 git 配置credential.helper manager、最后删除下载的.deb。它需要 sudo 权限且脚本内下载地址指向 GitHub Releases因此只能在可以访问 GitHub 的机器上运行例如构建机不适用于完全断网的目标机#!/usr/bin/env bash set -e echo Downloading Git Credential Manager v2.6.1... wget https://github.com/git-ecosystem/git-credential-manager/releases/download/v2.6.1/gcm-linux_amd64.2.6.1.deb echo Installing Git Credential Manager... sudo dpkg -i gcm-linux_amd64.2.6.1.deb echo Configuring Git to use GCM... git config --global credential.helper manager echo Cleaning up... rm gcm-linux_amd64.2.6.1.deb边界说明离线安装和初始化完成后后续在编码代理中使用/speckit.*命令本身是本地行为但拉取上游新版本等操作仍需要网络air-gapped 文档未覆盖这部分场景。下一步安装与初始化就绪后即可按 Quick Start Guide 开始 Spec-Driven Development。较短路径为/speckit.specify→/speckit.plan→/speckit.tasks→/speckit.implement→/speckit.converge生产级特性可在其中加入/speckit.clarify、/speckit.checklist、/speckit.analyze作为质量门。【免费下载链接】spec-kit Toolkit to help you get started with Spec-Driven Development项目地址: https://gitcode.com/GitHub_Trending/sp/spec-kit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Spec Kit 在无网络（Air-Gapped）环境如何安装：构建 wheel 包并离线初始化项目
Spec Kit 在无网络Air-Gapped环境如何安装构建 wheel 包并离线初始化项目【免费下载链接】spec-kit Toolkit to help you get started with Spec-Driven Development项目地址: https://gitcode.com/GitHub_Trending/sp/spec-kit如果你的环境屏蔽了对 PyPI 和 GitHub 的访问典型的企业管理内网场景常规的uv tool install specify-cli或pip install specify-cli都无法完成。Spec Kit 官方为此提供了一条便携 wheel 包路径先在一台有网的机器上构建 wheel 并下载全部运行依赖把整个dist/目录拷贝到目标机器再离线安装、离线初始化项目。安装指南也确认从该仓库本地构建的 wheel 是离线 / air-gapped 环境下的有效安装方式。本文依据 Enterprise / Air-Gapped Installation 与 Installation Guide 走通这条完整流程。开始前的环境条件三个文档明确的适用条件任何一条不满足都需要先处理目标机器Python 3.11。构建机必须与目标机器相同的操作系统和 Python 版本。原因是pip download解析的是平台相关的 wheel例如 PyYAML 含原生扩展在别的系统或 Python 版本上下载的依赖可能与目标机器不匹配。若要同时支持多个平台需要在每个目标 OSLinux、macOS、Windows和每个 Python 版本上各重复一次构建步骤。Windows 目标机器离线脚手架要求 PowerShell 7pwshWindows PowerShell 5.xpowershell.exe不满足要求需要先安装 PowerShell 7。另外安装指南将 Git 列为可选依赖——仅当启用 git 扩展时才需要。离线流程本身不依赖 Git 扩展。第 1 步在有网机器上构建 wheel 并下载依赖在构建机上执行文档原命令# Clone the repository git clone https://github.com/github/spec-kit.git cd spec-kit # Build the wheel pip install build python -m build --wheel --outdir dist/ # Download the wheel and all its runtime dependencies pip download -d dist/ dist/specify_cli-*.whl逐条说明pip install build在有网机器上安装构建工具本身需要网络python -m build --wheel把仓库构建为 wheel 并输出到dist/最后一条pip download是关键——它以刚构建出的specify_cli-*.whl为输入把该 wheel 及所有运行时依赖都下载为本地 wheel 文件放进dist/这一步完成后dist/就是离线安装所需的全部内容。离线可用的原因构建配置见 pyproject.toml 中的force-include段会把模板templates/、三种自动化脚本scripts/bash、scripts/powershell、scripts/python、git/agent-context/assess/bug 扩展、speckitworkflow 和 lean/constitution-sync 预设打进 wheel 的core_pack中注释明确写着这是为了让specify init在无网络环境下工作。所以第 4 步的初始化不需要任何网络请求。关于版本air-gapped 文档没有指定要克隆哪个版本wheel 的版本取决于你克隆时的提交安装指南对源码安装的建议是固定到一个 release tag例如v0.12.11保留前导v如需版本可复现可先检出对应 tag 再构建。第 2 步传输dist/目录将完整的dist/目录包含specify-cliwheel 和全部依赖 wheel通过 USB、网络共享或组织内认可的方式拷贝到目标机器。文档对传输方式没有其他限制。第 3 步在目标机器上离线安装在dist/目录所在位置执行pip install --no-index --find-links./dist specify-cli--no-index安装过程不查询 PyPI因此不依赖外网--find-links./dist让 pip 从本地dist/中查找上一步拷贝过来的 wheel 及其依赖。第 4 步验证安装specify version按安装指南这是本地的版本/运行检查确认specify命令可用并报告版本。它不能证明该可执行文件来自 PyPI 还是本地构建的 wheel。第 5 步离线初始化项目specify init my-project --integration copilotair-gapped 文档明确说明该命令不需要网络访问——默认使用 wheel 内置的 bundled assets。my-project是文档示例中的项目名换成你自己的项目名即可按 快速上手指南的说明也可以用specify init .在当前目录初始化。关于--integration参数的文档依据交互式终端中init会提示你选择编码代理集成非交互式会话CI 或管道运行在未传--integration时默认 GitHub Copilotair-gapped 示例正是显式传了--integration copilot需要其他代理时安装指南给出的取值示例为claude、gemini、copilot、codebuddy、pi、omp。可选参数安装指南与快速上手指南--script sh|ps|py强制指定自动化脚本类型不传时 Windows 默认ps、其他系统默认sh交互模式下未传会提示选择--non-interactiveCI 或 AI agent 环境使用让未指定的选项采用文档默认值而不是卡在方向键选择器上。第 6 步验证初始化结果按安装指南初始化成功后应看到两类结果项目下出现与所选脚本类型对应的自动化脚本目录.specify/scripts/bash/Linux/macOS 默认含.sh脚本.specify/scripts/powershell/Windows 默认含.ps1脚本.specify/scripts/python/--script py时同时安装平台 shell 回退脚本编码代理中可用以下命令/speckit.specify、/speckit.plan、/speckit.tasks、/speckit.implement、/speckit.analyze、/speckit.clarify、/speckit.checklist、/speckit.constitution、/speckit.converge、/speckit.taskstoissues。已知问题与限制Linux 上 Git 认证有问题可选分支air-gapped 文档附带了一个安装 Git Credential Manager v2.6.1 的脚本。注意该脚本的副作用从 GitHub Releases 下载.deb文件、用sudo dpkg -i安装系统包、修改全局 git 配置credential.helper manager、最后删除下载的.deb。它需要 sudo 权限且脚本内下载地址指向 GitHub Releases因此只能在可以访问 GitHub 的机器上运行例如构建机不适用于完全断网的目标机#!/usr/bin/env bash set -e echo Downloading Git Credential Manager v2.6.1... wget https://github.com/git-ecosystem/git-credential-manager/releases/download/v2.6.1/gcm-linux_amd64.2.6.1.deb echo Installing Git Credential Manager... sudo dpkg -i gcm-linux_amd64.2.6.1.deb echo Configuring Git to use GCM... git config --global credential.helper manager echo Cleaning up... rm gcm-linux_amd64.2.6.1.deb边界说明离线安装和初始化完成后后续在编码代理中使用/speckit.*命令本身是本地行为但拉取上游新版本等操作仍需要网络air-gapped 文档未覆盖这部分场景。下一步安装与初始化就绪后即可按 Quick Start Guide 开始 Spec-Driven Development。较短路径为/speckit.specify→/speckit.plan→/speckit.tasks→/speckit.implement→/speckit.converge生产级特性可在其中加入/speckit.clarify、/speckit.checklist、/speckit.analyze作为质量门。【免费下载链接】spec-kit Toolkit to help you get started with Spec-Driven Development项目地址: https://gitcode.com/GitHub_Trending/sp/spec-kit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
