首页 / AI Trending / gsd-build/gsd-2

gsd-2 是什么？

GSD Pi v1.20.1 是带项目工作流、.gsd 记忆、验证证据和 worktree 感知 Git 自动化的终端编码 Agent；旧 GSD-2 页面应指向 open-gsd/gsd-pi 与 scoped npm 包。

⭐ 5,816 Stars 🍴 603 Forks TypeScript — 作者: gsd-build
来源：github.com/open-gsd/gsd-pi/tree/v1.20.1 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

v1.20.1 发布于 2026-09-18，主要修复租约、失败 UAT 证据、worktree orphan 恢复和多项运行稳定性问题。GSD Pi v1.20.1 是带项目工作流、.gsd 记忆、验证证据和 worktree 感知 Git 自动化的终端编码 Agent；旧 GSD-2 页面应指向 open-gsd/gsd-pi 与 scoped npm 包。

来源：github.com/open-gsd/gsd-pi

核心功能

项目级工作流

通过 milestone、slice、task 和 quick/auto 命令推进项目。

来源：github.com/open-gsd/gsd-pi/tree/v1.20.1
本地状态与证据

在 .gsd/ 保存需求、决策、计划、运行笔记、摘要和验证证据。

来源：github.com/open-gsd/gsd-pi/tree/v1.20.1
worktree 感知自动化

Git 自动化了解 worktree，并维护迁移快照和恢复状态。

来源：github.com/open-gsd/gsd-pi/tree/v1.20.1

技术架构

终端 Agent 连接用户选择的 provider，工作流层把项目状态持久化到 .gsd/，Git 层管理 worktree 与运行时备份；代码、提示是否出机取决于 provider。

来源：github.com/open-gsd/gsd-pi/tree/v1.20.1

项目知识图谱

知识图谱：项目核心节点（中心）+ 核心功能（内环六边形）+ 关键技术依赖（外环 chip） Node.js >=22.18.0Node.js >=22.1… Git 已认证的模型 provider已认证的模型 pr… 项目级工作流 本地状态与证据 worktree 感知自动化 gsd-2 项目本体 核心功能 关键依赖

技术栈

语言TypeScript/Node.js框架Pi terminal agent + GSD workflow/extensions
关键依赖
Node.js >=22.18.0Git已认证的模型 provider
基础设施 / 部署
.gsd/ 项目状态；.gsd-backups/ 迁移快照
来源：github.com/open-gsd/gsd-pi/blob/v1.20.1/package.json

快速上手

路径一用 npx @opengsd/gsd-pi@latest 引导安装；路径二固定全局安装 1.20.1，并以 gsd quick --output-format json 跑可回滚任务。旧 unscoped 包按官方序列迁移。
来源：github.com/open-gsd/gsd-pi/tree/v1.20.1

使用场景

适合需要把长期软件项目拆成阶段、保存决策并通过 worktree 推进的团队；一次性明确任务或不希望引入项目状态目录时，通用编码 Agent 更直接。

来源：github.com/open-gsd/gsd-pi；https://github.com/openai/codex

优势与局限

优势

  • 项目计划与验证证据持久化
  • 支持非交互 JSON quick
  • 提供旧包迁移和 worktree 恢复路径

局限

  • 会读写代码和项目状态
  • 数据边界取决于所选 provider
  • 自动完成仍需测试、diff 和人工合并审查
来源：github.com/open-gsd/gsd-pi/tree/v1.20.1

最新版本

v1.20.1 发布于 2026-09-18，主要修复租约、失败 UAT 证据、worktree orphan 恢复和多项运行稳定性问题。

来源：github.com/open-gsd/gsd-pi/releases/tag/v1.20.1

实测与证据

status: official_docs_checked_not_installed  |  checked_at: 2026-09-23  |  environment: 静态核对 v1.20.1 release、README、package、迁移与故障文档  |  limitations: 未安装包、认证 provider、创建 worktree 或运行任务  |  observed_output: 确认 Node >=22.18、两条安装路径、scoped 包、迁移序列、quick JSON、.gsd 与 gsd upgrade

来源：github.com/open-gsd/gsd-pi/releases/tag/v1.20.1

同类项目对比

Codex CLI 是通用编码 Agent；GSD Pi 更强调 milestone/slice/task、.gsd 项目记忆、验证证据和 worktree 自动化。短任务前者路径短，长期结构化项目后者状态更完整。

来源：github.com/openai/codex；https://github.com/open-gsd/gsd-pi

总结评价

采用前先清除旧 binary 冲突，在测试仓库固定版本运行 quick JSON，并用 diff、测试与 .gsd 证据验收。

来源：github.com/open-gsd/gsd-pi

常见问题

GSD-2 现在应该安装哪个包？

当前仓库是 open-gsd/gsd-pi，npm 包是 @opengsd/gsd-pi；旧的 unscoped gsd-pi 可能遮蔽新 binary。v1.20.1 要求 Node.js 22.18.0 或更高版本。

旧 gsd-pi 怎样迁移到 GSD Pi v1.20.1？

先备份项目的 .gsd，再卸载全局 gsd-pi 和 @opengsd/gsd-pi，清理官方列出的 update-check 与 managed-resources 状态，运行 npx @opengsd/gsd-pi@latest，最后检查 command -v gsd 和 gsd --version。

GSD Pi 会自动修改主分支吗？

它有 worktree 感知的 Git 自动化，但具体写入、提交和合并仍取决于当前工作流、宿主权限和仓库状态。先在测试仓库运行，并把合并、发布和外部操作保留给人工审查。

怎样验证 GSD Pi 自动任务真的完成？

用 gsd quick --output-format json 跑一个可回滚任务，检查 JSON 状态、代码差异、测试结果和 .gsd 中的计划与验证证据。模型声称完成不等于验收完成。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新，请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料：README、GitHub API、依赖文件