GSD 2

Get Shit Done 的进化版 —— 现在是一个真正具备编码能力的 Agent。

最初的 GSD 作为 Claude Code 的提示词框架而走红。它确实有效，但实际上是在与工具本身对抗——通过斜杠命令注入提示词，寄希望于 LLM 能遵循指令，却无法真正掌控上下文窗口、会话或执行过程。

这一版本截然不同。GSD 现在是一个基于 Pi SDK 构建的独立 CLI，它赋予了 TypeScript 对 Agent 底层架构的直接访问权限。这意味着 GSD 可以真正做到 v1 版本只能“请求” LLM 去做的事情：在任务间清理上下文、在调度时精确注入文件、管理 git 分支、跟踪成本和 Token 使用量、检测死循环、从崩溃中恢复，并无需人工干预即可自动完成整个里程碑。

只需一条命令，即可离开。回来时，你将看到一个拥有干净 git 历史记录的已构建项目。

npm install -g gsd-pi@latest

GSD 现在会在支持的 macOS、Linux 和 Windows 安装上提供托管的 RTK 二进制文件，以压缩 bash、async_bash、bg_shell 和验证流程中的 shell 命令输出。GSD 会强制为所有托管调用设置 RTK_TELEMETRY_DISABLED=1。设置 GSD_RTK_DISABLED=1 可禁用此集成。

📋 注意：刚开始在 Mac 上使用 Node？ 如果你是通过 Homebrew 安装的 Node.js，你运行的可能是开发版本而非 LTS 版本。请阅读此指南 以锁定 Node 24 LTS，避免兼容性问题。

---

v2.52.0 新特性

VS Code 扩展与 Web UI

• VS Code 集成 — 包含状态栏、文件装饰、bash 终端、会话树、对话历史记录和代码透镜 (Code Lens)。(#2651)
• 深色模式对比度 — 提高了 Token 基准值并扁平化了不透明度层级系统，以获得更好的可读性。(#2734)
• 鉴权 Token 门控 — 在缺失 Token 时触发合成 401 响应、未授权启动状态以及恢复屏幕。(#2740)

能力元数据与模型路由

• 基于能力的模型选择 — 用能力元数据取代了模型 ID 模式匹配，使自定义提供程序的集成更加可靠。(#2548)

关键变更

• --bare 模式 — 已在无头 (headless)、pi-coding-agent 和资源加载器中实现，用于最小化输出操作。
• RPC 协议 v2 — 新的类型定义、带有版本检测的初始化握手，以及在 prompt/steer/follow_up 命令上生成 runId。
• PREFERENCES.md 重命名 — 为了保持一致性，preferences.md 已重命名为 PREFERENCES.md。(#2700, #2738)
• 全面的 SQLite 审计 — 修复了 gsd-db 中的索引、缓存、安全性及协调问题。
• 统一的错误分类器 — 将三个重叠的错误分类器合并为单一的分类-决策-执行管道。

关键修复

• 自动模式在提供程序报错时停止 — 自动循环现在在提供程序报错后会停止，而不是无限重试。(#2762, #2764)
• 事务安全性 — 状态机守卫已移动到 5 个工具处理程序的事务内部 (#2752)，并将 transaction() 设置为可重入。
• 工作树植入 (Worktree seeding) — 将 PREFERENCES.md 植入到自动模式的工作树中，并包含在工作树同步中。(#2693)
• 空闲看门狗 — 交互式工具免除滞后检测 (#2676)，且文件系统活动不再覆盖滞后工具的检测。(#2697)
• 里程碑守卫 — allSlicesDone 针对空切片数组增加了空真值保护 (#2679)，并在验证状态为 needs-remediation 时阻止 complete-milestone 调度。(#2682)
• Docker 重构 — 用成熟的容器模式替换了原本脆弱的配置。(#2716)
• Windows — 通过禁用 Win32 上的分离进程组来防止 EINVAL 错误。(#2744)
• 审计日志 — 将 setLogBasePath 接入引擎初始化中，以恢复审计日志记录。(#2745)

v2.51.0 — 技能、RTK 与验证

• /terminal 命令 — 直接 shell 执行。