人工智能AI Agent代码智能体Agent 编排CLIAI 应用【免费下载链接】gsd-2A powerful meta-prompting, context engineering and spec-driven development system that enables agents to work for long periods of time autonomously without losing track of the big picture项目地址https://gitcode.com/gh_mirrors/gs/gsd-2点击查看免费下载GSD 是一个以规划、执行、验证和交付为核心职责的 AI 编程代理本指南带你完成它在 macOS、Windows、Linux 及 Docker 沙箱中的安装与配置并启动你的第一个会话。读完本文你将掌握 Node.js 与 Git 的前置环境搭建、LLM Provider 的接入方式、步骤模式与自动模式两种工作方式以及会话恢复、更新升级和常见故障的排查方法。前置条件在安装 GSD 之前请先确认你的机器满足以下最低要求。GSD 本身是 Node.js 应用package.json 中的engines字段明确要求Node.js 22.0.0因此版本检查是启动是否正常的关键一步。要求最低版本推荐版本Node.js22.0.024 LTSGit2.20最新版LLM API key任意受支持提供商AnthropicClaude如果你还没有安装 Node.js 或 Git请按下面对应操作系统的步骤进行。说明从源码看GSD 还依赖若干平台原生二进制见 package.json 中的 optionalDependencies如gsd-build/engine-darwin-arm64、gsd-build/engine-linux-x64-gnu、gsd-build/engine-win32-x64-msvc等安装时会按平台自动选择无需手工处理。按操作系统安装macOS下载链接Node.js | Git | Homebrew第 1 步安装 Homebrew如果已安装可跳过/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)第 2 步安装 Node.js 和 Gitbrew install node git第 3 步验证依赖已安装node --version # 应输出 v22.x 或更高 git --version # 应输出 2.20第 4 步安装 GSDnpm install -g gsd-pi第 5 步设置你的 LLM provider# 选项 A设置环境变量推荐 Anthropic export ANTHROPIC_API_KEYsk-ant-... # 选项 B使用内置配置向导 gsd config如果想永久保存这个 key把 export 语句写入~/.zshrcecho export ANTHROPIC_API_KEYsk-ant-... ~/.zshrc source ~/.zshrc所有 20 provider 的完整配置方式请见 提供商设置指南。第 6 步启动 GSDcd ~/my-project # 进入任意项目目录 gsd # 启动一个会话第 7 步确认一切正常gsd --version # 输出已安装版本进入会话后输入/model以确认你的 LLM 已成功连接。Apple Silicon PATH 修复如果安装后找不到gsd可能是 npm 的全局 bin 目录没有加入 PATHecho export PATH$(npm prefix -g)/bin:$PATH ~/.zshrc source ~/.zshrcoh-my-zsh 冲突oh-my-zsh 的 git 插件定义了alias gsdgit svn dcommit。可在~/.zshrc中加入unalias gsd 2/dev/null或者改用gsd-cliGSD 在 package.json 的 bin 字段中同时注册了gsd与gsd-cli两个命令后者可绕开 shell alias 冲突。Windows下载链接Node.js | Git for Windows | Windows Terminal选项 A使用 winget推荐 Windows 10/11第 1 步安装 Node.js 和 Gitwinget install OpenJS.NodeJS.LTS winget install Git.Git第 2 步重启终端关闭并重新打开 PowerShell 或 Windows Terminal。第 3 步验证依赖已安装node --version # 应输出 v22.x 或更高 git --version # 应输出 2.20第 4 步安装 GSDnpm install -g gsd-pi第 5 步设置你的 LLM provider# 选项 A设置环境变量仅当前会话 $env:ANTHROPIC_API_KEY sk-ant-... # 选项 B使用内置配置向导 gsd config如果要永久保存该 key可在系统设置的环境变量中添加或者执行[System.Environment]::SetEnvironmentVariable(ANTHROPIC_API_KEY, sk-ant-..., User)第 6 步启动 GSDcd C:\Users\you\my-project # 进入任意项目目录 gsd # 启动一个会话第 7 步确认一切正常gsd --version # 输出已安装版本进入会话后输入/model以确认你的 LLM 已成功连接。选项 B手动安装下载并安装 Node.js LTS安装时勾选Add to PATH下载并安装 Git for Windows使用默认选项打开一个新的终端然后继续执行上面的第 3-7 步Windows 提示建议使用Windows Terminal或PowerShell体验最佳。Command Prompt 也能用但颜色支持较弱。如果gsd无法识别先重启终端。Windows 需要新开终端才能读取更新后的 PATH。WSL2也可用安装 WSL 后在发行版内部按 Linux 说明继续。Linux下载链接Node.js | Git | nvm先确认你的发行版然后按对应步骤安装。Ubuntu / Debian第 1 步安装 Node.js 和 Gitcurl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash - sudo apt-get install -y nodejs gitFedora / RHEL / CentOS第 1 步安装 Node.js 和 Gitcurl -fsSL https://rpm.nodesource.com/setup_24.x | sudo bash - sudo dnf install -y nodejs gitArch Linux第 1 步安装 Node.js 和 Gitsudo pacman -S nodejs npm git使用 nvm任意发行版第 1 步先安装 nvm再安装 Node.jscurl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash source ~/.bashrc # 或 ~/.zshrc nvm install 24 nvm use 24所有发行版第 2-7 步第 2 步验证依赖已安装node --version # 应输出 v22.x 或更高 git --version # 应输出 2.20第 3 步安装 GSDnpm install -g gsd-pi第 4 步设置你的 LLM provider# 选项 A设置环境变量推荐 Anthropic export ANTHROPIC_API_KEYsk-ant-... # 选项 B使用内置配置向导 gsd config如果想永久保存这个 key把 export 语句写到~/.bashrc或~/.zshrc中echo export ANTHROPIC_API_KEYsk-ant-... ~/.bashrc source ~/.bashrc所有 20 provider 的完整配置方式请见 提供商设置指南。第 5 步启动 GSDcd ~/my-project # 进入任意项目目录 gsd # 启动一个会话第 6 步确认一切正常gsd --version # 输出已安装版本进入会话后输入/model以确认你的 LLM 已成功连接。npm install -g遇到权限错误不要用sudo npm。应改为修复 npm 的全局目录mkdir -p ~/.npm-global npm config set prefix ~/.npm-global echo export PATH$HOME/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc npm install -g gsd-piDocker任意操作系统下载链接Docker Desktop如果你不想在宿主机安装 Node.js可以在隔离沙箱中运行 GSD。仓库提供了完整的 Docker 沙箱模板与 compose 文件详见 docker 目录下的 Docker Sandbox 文档。第 1 步安装 Docker Desktop要求 4.58。第 2 步克隆 GSD 仓库git clone https://github.com/gsd-build/gsd-2.git cd gsd-2/docker第 3 步创建并进入沙箱docker sandbox create --template . --name gsd-sandbox docker sandbox exec -it gsd-sandbox bash第 4 步设置 API key 并运行 GSDexport ANTHROPIC_API_KEYsk-ant-... gsd auto implement the feature described in issue #42沙箱模式下 GSD 无法接触宿主机文件系统、SSH key 或其他项目适合把自动模式扔进去跑的场景。完整的配置、资源限制和 compose 文件请见 Docker Sandbox 文档。在没有 Docker Sandbox 支持的环境中也可以改用 docker-compose.yaml 做容器级隔离。安装之后选择模型完成 provider 设置后GSD 会自动选择一个默认模型。你可以在会话中随时切换/model也可以在偏好设置中按阶段配置模型详见 配置文档。关于各 Provider 的认证方式与环境变量对照可参考 提供商设置指南 中的快速参考表Anthropic 用ANTHROPIC_API_KEY、OpenAI 用OPENAI_API_KEY、Gemini 用GEMINI_API_KEY、OpenRouter 用OPENROUTER_API_KEY本地 providersOllama、LM Studio、vLLM、SGLang则需要在~/.gsd/agent/models.json中声明 endpoint 与 models。实现细节gsd config对应源码 src/cli.ts 中的 setup wizard 分支它会通过 onboarding 流程把凭据写入~/.gsd/agent/auth.json并持久化因此你可以在任意新终端直接启动gsd而不必重复 export 环境变量。两种工作方式步骤模式 —/gsd在会话内输入/gsd。GSD 会一次执行一个工作单元并在每一步之间暂停通过向导展示刚完成了什么、下一步是什么。没有.gsd/目录启动讨论流程先收集你的项目愿景已有 milestone但没有 roadmap讨论或研究该 milestoneroadmap 已存在仍有待完成的 slices规划下一个 slice 或执行一个 task进行到一半的 task从上次停下的地方继续步骤模式会让你始终留在回路中在每一步之间查看和确认输出。自动模式 —/gsd auto输入/gsd auto后就可以离开。GSD 会自主完成 research、planning、execution、verification、commit并持续推进每个 slice直到 milestone 完成。/gsd auto自动模式本质是一个由磁盘文件驱动的状态机它读取.gsd/STATE.md确定下一个工作单元创建全新会话执行完成后再次读取磁盘状态并派发下一个单元。完整的执行循环、崩溃恢复、超时监管与成本跟踪等细节请见 自动模式文档。推荐工作流两个终端一个终端跑自动模式另一个终端负责引导和干预。终端 1让它构建gsd /gsd auto终端 2在它工作时进行引导gsd /gsd discuss # 讨论架构决策 /gsd status # 查看进度 /gsd queue # 排队下一个 milestone两个终端都会读写同一套.gsd/文件。你在终端 2 里做出的决策会在下一个阶段边界被自动拾取。从源码看GSD 的会话按当前工作目录隔离存储见 src/cli.ts 中的 per-directory session 逻辑因此两个终端在同一个项目目录下运行gsd时会共享同一份项目状态。GSD 如何组织工作GSD 用三层结构组织一次交付核心思想是把大目标拆成可独立验证的小单元Milestone → 一个可交付版本4-10 个 slice Slice → 一个可演示的垂直能力1-7 个 task Task → 一个适合单个上下文窗口的工作单元铁律是一个 task 必须能装进一个上下文窗口。装不下就说明它应该拆成两个 task。所有状态都保存在.gsd/中GSD 通过 SQLite 数据库保存权威运行时状态并将 Markdown 投影渲染到.gsd/供审阅、提示词与 git 历史使用.gsd/ PROJECT.md — 项目当前是什么 REQUIREMENTS.md — 需求契约 DECISIONS.md — 追加式架构决策记录 KNOWLEDGE.md — 手写 Rules加上 memory 支撑的 Patterns/Lessons STATE.md — 一眼可见的状态摘要 milestones/ M001/ M001-ROADMAP.md — 带依赖关系的 slice 计划 slices/ S01/ S01-PLAN.md — task 拆解 S01-SUMMARY.md — 实际发生了什么这一分层结构与自动模式的 Plan → Execute → Complete → Reassess Roadmap → Validate Milestone 执行循环一一对应详见 自动模式文档。VS Code 扩展GSD 也提供 VS Code 扩展。你可以从扩展市场安装publisher: FluxLabs或者在 VS Code 扩展面板中直接搜索 GSDgsd聊天参与者在 VS Code Chat 中直接与 agent 对话侧边栏仪表板显示连接状态、模型信息、Token 使用量完整命令面板启动 / 停止 agent、切换模型、导出会话CLIgsd-pi需要先安装好扩展会通过 RPC 与其连接。仓库中的 vscode-extension 目录包含完整的扩展源码实现。Web 界面GSD 也提供一个基于浏览器的可视化项目管理界面gsd --web--web对应源码 src/cli.ts 中的 web 模式分支它启动一个浏览器专用的 Web 模式不依赖终端 TUI。详见 Web 界面文档。恢复会话gsd --continue # 或 gsd -c会恢复当前目录最近一次会话。源码中的实现路径是 src/cli.ts 的SessionManager.continueRecent它会按当前工作目录定位最近的会话并恢复。浏览所有保存过的会话gsd sessions该命令会列出当前目录下所有历史会话并支持选择恢复见 src/cli.ts 中的 sessions 列表逻辑。如果某个目录还没有会话会给出 No sessions found for this directory. 的提示。更新 GSDGSD 每 24 小时检查一次更新并在启动时提示。你也可以手动更新npm update -g gsd-pi或者在会话中执行/gsd updategsd update在源码中会绕过 TTY 门禁直接执行更新流程见 src/cli.ts 中的 update 分支确保用户在任何状态下都能升级。另外当检测到资源版本与当前二进制版本不一致时CLI 会提示运行npm install -g gsd-pilatest或gsd update后再继续见 src/cli.ts 的版本检查。快速排障问题解决方式command not found: gsd把 npm 全局 bin 目录加入 PATH见上面的系统说明gsd实际执行了git svn dcommitoh-my-zsh 冲突执行unalias gsd或改用gsd-clinpm install -g gsd-pi权限错误修复 npm prefix见 Linux 说明或改用 nvm无法连接到 LLM用gsd config检查 API key并确认网络可用gsd启动时卡住检查 Node.js 版本node --version需要 22需要注意的排障要点环境变量未生效key 虽然设在 shell 中但 GSD 看不到。确认你是在同一个终端里 export 后运行gsd或者直接用gsd config把 key 保存进~/.gsd/agent/auth.json实现跨会话持久化。模型没出现在/model列表对于 OpenRouter 这类按 key 聚合的 provider未设置对应环境变量时 GSD 会隐藏其 models设置 key 并重启gsd即可。本地模型报developerrole 错误大多数本地推理 server 不支持 OpenAI 的developermessage role需要在 provider 配置中设置compat.supportsDeveloperRole: falseGSD 会自动改用systemmessage。更多问题见 故障排查文档。下一步自动模式深入理解自主执行配置模型选择、超时和预算命令参考所有命令和快捷键提供商设置每个 provider 的详细配置团队协作多开发者工作流赞分享人工智能AI Agent代码智能体Agent 编排CLIAI 应用【免费下载链接】gsd-2A powerful meta-prompting, context engineering and spec-driven development system that enables agents to work for long periods of time autonomously without losing track of the big picture项目地址https://gitcode.com/gh_mirrors/gs/gsd-2点击查看免费下载相关推荐GSD 快速上手指南macOS / Windows / Linux 安装、首会话与双终端工作流GSD 快速上手指南macOS / Windows / Linux 安装、首会话与双终端工作流 GSD gsd pi 是一个把规划、执行、验证与交付交给人工智能AI Agent代码智能体Agent 编排CLIAI 应用Dasel终极跨平台使用指南Windows、macOS与Linux的快速安装与配置Dasel终极跨平台使用指南Windows、macOS与Linux的快速安装与配置 在当今数据驱动的开发环境中 Dasel 作为一款强大的跨平台命令行工具开发工具CLINrfr多平台部署实战指南Windows、macOS、Linux快速安装手册Nrfr多平台部署实战指南Windows、macOS、Linux快速安装手册 项目概述与核心价值 Nrfr是一款免Root的SIM卡国家码修改工具专为解决国原生移动桌面应用上一篇awesome-free-saas 2026展望哪些分类的免费SaaS会越来越多下一篇微信聊天记录永久保存的完整指南三步实现数据自主掌控创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
` 构建流式文件服务器)
