open-gsd/gsd-pi

A 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

什么是 GSD Pi？

GSD Pi（Git‑aware Software Development Pi 的缩写）是一个本地优先的 AI 编程助手，它存在于你的终端（或可选的 Web UI）中。它帮助你推动软件创意完成整个开发周期：

规划 – 将项目分解为里程碑、切片和任务。
实现 – 使用大语言模型（LLM）生成代码，同时保持完整的项目上下文。
验证 – 运行自动化检查并收集验证证据。
追踪 – 将所有计划、笔记、摘要和验证结果存储在隐藏的 .gsd/ 文件夹中。
Git 工作树自动化 – 将生成的工作隔离在单独的 Git 工作树中，使主分支保持干净且随时可审查。

该工具专为希望拥有可以从命令行调用的 AI 驱动“代理”的开发者而设计，同时保持一切离线友好（所有状态都保存在你的机器上）并且通过社区扩展可扩展。

核心功能（根据 README）

功能	作用
引导式终端代理	运行 `gsd` 启动交互式会话，配置 LLM 提供商，并直接从 shell 启动编码或快速任务模式。
自主项目工作流	定义里程碑/切片/任务；auto 模式可以在没有进一步提示的情况下进行计划、编码、验证和推进工作。
工作树感知的 Git 自动化	使用 Git 工作树将生成的代码隔离，同时保持干净、可审查的主检出版本。
本地项目记忆	所有项目特定数据（需求、决策、计划、验证笔记）存储在 `.gsd/` 下，默认被 git 忽略。
多提供商模型路由	与你已有的任何模型配合使用 – API 密钥、OAuth，或基于 CLI 的提供商，如 Claude Code 或 Cursor Agent。
扩展面	项目可以通过捆绑或社区扩展添加自定义命令、工具或 UI 集成。
终端和 Web 界面	默认 TUI；使用 `gsd --web` 启动 Web UI 作为可视化控制平面。

快速入门流程（来自 README）

安装 – 推荐的一行命令：
```
npx @opengsd/gsd-pi@latest
```
（或全局安装 npm install -g @opengsd/gsd-pi）
运行代理：
```
gsd
```
按照引导式设置选择模型提供商（例如 Cursor Agent、Claude 等）。
开始会话 – 在交互式界面内，你可以发出斜杠命令，例如：
- /gsd config – 更改设置
- /gsd auto – 让代理运行完整的自主工作流
- /gsd quick "描述任务" – 一次性编码请求
- /gsd status – 查看当前进度
非交互式使用 – 对于脚本，你可以调用：
```
gsd quick --output-format json "描述任务"
```
这会返回结构化的 JSON 结果和有意义的退出代码。

谁可能使用 GSD Pi？

独立开发者，希望有一个 AI 伙伴来保持工作有条理，并自动化重复的编码/验证步骤。
小团队，更喜欢本地的、自托管的助手，而不是纯云服务。
开源维护者，希望将 AI 驱动的规划和代码生成嵌入到仓库工作流中。
工具构建者，可以通过提供的扩展面添加自定义命令或 UI 集成来扩展 GSD Pi。

安装和升级详情

引导式安装程序（npx @opengsd/gsd-pi@latest）会引导你完成配置并创建 gsd 二进制文件。
升级是单个命令：gsd upgrade（或通过 npx 重新安装）。
为从旧的未限定范围的 gsd-pi 包迁移的用户提供了迁移说明。
卸载会删除全局包和 ~/.gsd 状态目录。

开发与社区

仓库使用 pnpm monorepo 布局（src/、packages/、native/、web/）。
构建/测试命令：pnpm install --frozen-lockfile、pnpm run build、pnpm test。
贡献工作流包括快速本地验证脚本（pnpm run verify:*）。
社区支持可通过 Discord 服务器获得（链接见 README）。

许可证

MIT – 个人、学术或商业用途免费。

底线： GSD Pi 是一个真正的、积极维护的 AI 驱动的编码代理，它存在于你的机器上，与 Git 紧密集成，并提供终端和 Web 界面来支持端到端的项目开发。