# Rokket-GSD：为GSD Pi打造的VS Code原生AI编程助手扩展

> Rokket-GSD是一个功能丰富的VS Code扩展，为GSD Pi AI编码代理提供原生UI界面，支持流式响应、40多种工具可视化、Telegram中继、并行工作流和59+条斜杠命令，让AI辅助编程完全融入编辑器体验。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-05-30T19:45:20.000Z
- 最近活动: 2026-05-30T19:55:55.432Z
- 热度: 159.8
- 关键词: VS Code扩展, AI编程助手, GSD, 大语言模型, 流式聊天, 工作流自动化, Telegram集成, 并行处理
- 页面链接: https://www.zingnex.cn/forum/thread/rokket-gsd-gsd-pivs-codeai
- Canonical: https://www.zingnex.cn/forum/thread/rokket-gsd-gsd-pivs-codeai
- Markdown 来源: ingested_event

---

## 原作者与来源

- 原作者/维护者：Kile-Thomson
- 来源平台：github
- 原始标题：Rokket-GSD: VS Code extension for GSD-2 / GSD-PI — AI coding agent with streaming chat, parallel workers, and workflow automation
- 原始链接：https://github.com/Kile-Thomson/Rokket-GSD
- 来源发布时间/更新时间：2026-05-30T19:45:20Z

## 原作者与来源\n\n- **原作者/维护者**: Kile Thomson\n- **来源平台**: GitHub\n- **原始标题**: Rokket-GSD: VS Code extension for GSD-2 / GSD-PI — AI coding agent with streaming chat, parallel workers, and workflow automation\n- **原始链接**: https://github.com/Kile-Thomson/Rokket-GSD\n- **发布时间**: 2026年5月30日\n\n## 项目背景\n\nGSD（Get Shit Done）是一个开源的AI编码代理项目，最初由Badlogic的Mario Zechner开发的Pi Mono演变而来，现由OpenGSD社区维护。GSD Pi（或GSD V2）作为命令行工具提供了强大的AI辅助编程能力，但CLI界面对于习惯图形化开发环境的用户来说存在一定的使用门槛。\n\nRokket-GSD应运而生，它将GSD Pi的CLI能力封装成一个完整的VS Code扩展，让用户无需离开编辑器即可享受AI辅助编程的全部功能。扩展通过JSON-RPC协议与GSD进程通信，在保持GSD强大功能的同时，提供了原生的VS Code用户体验。\n\n## 核心功能概览\n\nRokket-GSD将GSD Pi转变为一个原生的VS Code体验，主要特性包括：\n\n### 流式聊天界面\n- 逐token文本渲染，配合实时DOM更新\n- 完整Markdown支持，包括语法高亮的代码块、表格、引用、标题、行内代码和图片\n- 每段代码块和完整助手响应都有复制按钮\n- 支持图片粘贴和拖拽直接输入\n- 文件附件支持，带类型特定图标和可移除标签\n- 消息时间戳显示相对时间和绝对时间\n- 思考块默认折叠，带行数指示器，流式过程中可展开\n- 流式过程中可"引导"（steer）代理，无需等待完成\n\n### 工具执行可视化\n- 40多种工具调用带分类特定图标和颜色标识\n- 丰富的关键参数显示（lsp、browser_*、github_*、gsd_*、mcp_call、bash等）\n- 可折叠输出，智能截断处理大结果\n- 并行工具指示器（🚀徽章和脉冲动画）\n- 工具调用分组，连续只读工具折叠成可展开摘要行\n- 子代理结果渲染为完整Markdown，带用量药丸显示token和成本明细\n- 可点击文件路径直接在VS Code中打开\n- 运行工具时显示微光动画\n- 每个完成的工具调用显示持续时间\n\n### 会话历史与恢复\n- 可搜索的面板显示标题、日期和消息数\n- 单击恢复任何会话，完整上下文和对话状态自动注入\n- 从欢迎屏幕恢复（带"⏏ 恢复"芯片或/resume命令）\n- 支持有意义的会话重命名，方便后续查找\n- 删除会话清理旧对话\n- 每个会话拥有独立的GSD进程，完全隔离状态\n\n### 斜杠命令系统\n\n输入/打开包含59+条命令的命令面板：\n\n**GSD工作流命令（46条）**：\n/gsd - 上下文向导，选择下一步操作\n/gsd auto - 自动执行任务（每个任务刷新上下文）\n/gsd next - 执行下一个任务\n/gsd stop - 停止自动模式\n/gsd pause - 暂停自动模式（保留状态）\n/gsd quick - 使用GSD保证执行临时任务\n/gsd discuss - 不执行只讨论\n/gsd status - 项目仪表板（里程碑、切片、任务）\n/gsd visualize - 打开工作流可视化覆盖层\n/gsd help - 分类命令参考\n/gsd changelog - 显示分类发布说明\n/gsd capture - 自动模式期间捕获想法\n/gsd steer - 重定向自动模式优先级\n/gsd triage - 手动触发待处理捕获的触发器\n/gsd knowledge - 查看或添加到项目知识库\n/gsd queue - 队列和重新排序未来里程碑\n/gsd new-milestone - 从规范文档创建里程碑\n/gsd park - 搁置里程碑（跳过不删除）\n/gsd unpark - 重新激活已搁置的里程碑\n/gsd dispatch - 直接分派特定阶段\n/gsd history - 查看执行历史\n/gsd undo - 还原最后完成的单元\n/gsd skip - 阻止单元自动分派\n/gsd start - 启动工作流模板（bugfix、spike、feature等）\n/gsd templates - 列出可用工作流模板\n/gsd export - 导出里程碑报告为HTML\n/gsd cleanup - 删除已合并分支或快照\n/gsd config - 查看或修改GSD配置\n/gsd prefs - 查看或设置首选项\n/gsd mode - 切换工作流模式（solo/team）\n/gsd keys - 管理API密钥\n/gsd hooks - 显示配置的后置单元和前置分派钩子\n/gsd run-hook - 手动触发特定钩子\n/gsd extensions - 管理扩展（列出、启用、禁用、信息）\n/gsd doctor - 诊断和修复问题\n/gsd forensics - 自动模式失败的事后分析\n/gsd logs - 浏览活动、调试和指标日志\n/gsd inspect - 显示SQLite DB诊断\n/gsd skill-health - 技能生命周期仪表板\n/gsd rate - Token使用率和配置文件默认值\n/gsd init - 项目初始化向导\n/gsd setup - 全局设置状态和配置\n/gsd migrate - 将v1 .planning目录迁移到.gsd格式\n/gsd update - 将GSD更新到最新版本\n/gsd remote - 远程问题频道（Slack、Discord、Telegram）\n/gsd parallel - 并行自动模式编排\n\n**内置操作（13条）**：\n/compact - 压缩上下文减少token使用\n/export - 导出对话为HTML\n/model - 打开模型选择器\n/thinking - 循环思考级别\n/new - 开始新对话\n/history - 浏览和切换会话\n/copy - 复制最后助手消息\n/resume - 恢复最后会话\n/auto-compact - 切换自动压缩开关\n/auto-retry - 切换瞬态错误自动重试\n/telegram - 启动Telegram流（打开设置并连接）\n/telegram-stop - 停止Telegram流（终止中继并断开）\n/telegram voice - 设置OpenAI API密钥用于语音转录\n\n### 模型与思考控制\n- 按提供商分组的模型选择器，带上下文窗口大小和推理能力标签\n- 思考级别下拉菜单：off / minimal / low / medium / high / xhigh，带各级别描述\n- 模型感知思考：不支持的级别自动隐藏，扩展思考仅对支持的模型显示\n- 标题下方上下文使用条，带颜色编码阈值（绿色0-70%、琥珀色70-90%、红色90%+）\n- 实时会话统计显示token计数、会话成本和上下文压力\n- 动态模型路由指示器：gsd-pi切换模型时闪烁模型徽章并通过toast通知\n\n### 并行工作流仪表板\n- 并行自动模式期间显示工作线程卡片，展示每个工作线程的里程碑ID、状态徽章、当前单元和成本\n- Running、Paused、Stopped、Error状态带不同颜色徽章\n- 每个工作线程的预算使用条，绿色/橙色/红色阈值在80%和100%\n- 任何工作线程超过budget_ceiling的80%时触发预算警告toast\n- 检测旧心跳的工作线程并显示"(stale)"标签\n- 无并行数据时优雅降级到标准单工作线程显示\n\n### 自动模式进度\n- 粘性进度小部件显示在输入上方，展示当前任务、阶段、进度条、已用时间、成本和活动模型\n- 阶段渲染带不同标签和图标：Executing、Planning、Validating (⏳)、Completing、Blocked、Replanning\n- 自动模式暂停等待切片讨论时显示讨论暂停可见性（带🕐 "等待讨论"和/gsd discuss提示）\n- 进度小部件中的待处理捕获徽章(💭)，用于等待触发的/gsd capture想法\n- 标题中的工作流状态徽章显示活动里程碑、切片、任务和当前阶段\n- 自动模式指示器带🚀自动、⏸ 下一个、⏸ 暂停状态\n- 环境健康栏显示系统状态、预算、提供商问题和环境错误\n- 模型健康指示器：模型名称旁绿/琥珀/红点反映当前系统健康\n\n### Telegram中继\n- 将对话流式传输到Telegram群组\n- 通过/telegram或命令面板设置向导，引导完成Bot Token → 群组ID → 聊天标题流程\n- Telegram语音消息通过OpenAI Whisper转录后作为用户提示注入\n- Telegram发送的照片作为图片附件转发给代理\n- 基于主题的线程：每个会话创建Telegram话题进行有序对话\n- 流式粒度控制：在设置中配置为off、throttled或final-only\n- 安全凭证存储：Bot Token和OpenAI API密钥存储在VS Code的SecretStorage中，永不出现在源代码中\n\n### VS Code集成\n- 活动栏图标（火箭）带侧边栏面板\n- 灵活布局：作为侧边栏或编辑器标签页打开\n- 状态栏显示流式状态、活动模型和会话成本\n- 工作时火箭logo脉动琥珀色发光指示代理活动\n- 主题感知：适配任何VS Code配色主题（浅色、深色、高对比度）\n- 四种内置主题：Classic、Phosphor、Clarity、Forge\n- 从GitHub Releases自动更新，带一键安装通知\n- 从命令面板HTML导出（"Rokket GSD: Export Milestone Report"）\n- 版本升级时显示What's New覆盖层和变更日志查看器\n- 欢迎屏幕快速操作：一键芯片用于Auto、Status和Review\n- 向上滚动时滚动到底部FAB\n- 操作反馈toast通知\n\n### 键盘快捷键\n| 快捷键 | 操作 |\n|--------|------|\n| Enter | 发送消息（或代理工作时引导） |\n| Esc | 停止代理 |\n| Ctrl+Shift+G | 从VS Code任何地方聚焦GSD输入 |\n| Ctrl+Shift+N | 新对话（GSD聚焦时） |\n\n> 提示：在设置中启用gsd.useCtrlEnterToSend，如果你想用Enter换行，Ctrl+Enter发送。\n\n## 安全特性\n\nRokket-GSD在安全方面做了大量工作：\n\n- **CSP强制执行**：基于nonce的内容安全策略，style-src和script-src中无unsafe-inline\n- **DOMPurify净化**：所有渲染的Markdown都经过显式属性允许列表净化\n- **URL方案允许列表**：可点击链接限制为http、https和vscode\n- **路径遍历保护**：工作区边界验证和符号链接解析\n- **命令注入防护**：使用参数数组而非shell插值；破坏性bash模式检测带模态确认\n- **环境隔离**：生成GSD前剥离Electron/VS Code环境变量\n- **下载验证**：更新安装限制为GitHub URLs\n- **临时文件大小限制**：保存操作限制50MB\n- **DOM中无密钥**：API密钥和令牌永不在webview中渲染\n- **缓冲区溢出保护**：完整JSON-RPC缓冲区重置（非截断）以保持协议完整性\n\n## 技术架构\n\nRokket-GSD的架构分为三个主要部分：\n\n### Webview\n- 普通DOM（无框架），约13K行TypeScript + 16个CSS模块 + 3个主题文件，esbuild捆绑为单个IIFE\n- 基于顺序段的流式渲染器，使用requestAnimationFrame批处理实现平滑流式\n- CSS使用语义token层（--gsd-*）桥接VS Code主题系统——组件永不直接引用--vscode-*\n\n### Extension Host\n- 约10K行TypeScript，管理GSD子进程、消息路由、文件操作、健康监控、并行工作线程状态轮询和Telegram桥接协调\n- 所有热路径I/O都是异步的；并行轮询通过Promise.all运行\n\n### GSD Process\n- 完整的GSD Pi代理通过JSON-RPC在stdin/stdout上运行。每个会话获得自己的进程。\n\n### Telegram Bridge\n- 轮询器、协调器、IPC、话题管理器和消息格式化器。语音消息通过OpenAI Whisper转录；照片作为图片附件转发。\n\n扩展以.vsix形式发布，除VS Code和gsd CLI外无运行时依赖。\n\n## 安装与使用\n\n### 前提条件\n1. Node.js 18+ 和 npm\n2. Git\n3. VS Code 1.94+\n4. 全局安装gsd-pi：npm install -g @opengsd/gsd-pi\n5. 在GSD中配置的AI提供商（Anthropic、OpenAI、Google等，通过API密钥或OAuth）\n\n### 安装方法\n\n**VS Code Marketplace**：在扩展侧边栏搜索"Rokket GSD"\n\n**一键安装（macOS/Linux/Git Bash）**：\ncurl -sL https://raw.githubusercontent.com/Kile-Thomson/Rokket-GSD/main/install.sh | bash\n\n**一键安装（Windows PowerShell）**：\nirm https://raw.githubusercontent.com/Kile-Thomson/Rokket-GSD/main/install.ps1 | iex\n\n**手动安装**：\ngit clone https://github.com/Kile-Thomson/Rokket-GSD.git\ncd Rokket-GSD\nnpm install\nnpm run build\ncode --install-extension rokket-gsd-*.vsix --force\n\n### 快速开始\n\n1. 首次设置GSD（如果尚未完成）：\nnpm install -g @opengsd/gsd-pi\ngsd\n\n首次运行会引导完成提供商认证（Anthropic、OpenAI、Google等）。在扩展工作前至少需要一个配置的提供商。\n\n2. 打开Rokket GSD：\n- 点击活动栏中的火箭图标，或\n- 按Ctrl+Shift+P → "Rokket GSD: Open"\n\n扩展会自动生成gsd进程——如果一切设置正确，你会看到带快速操作芯片的欢迎屏幕。\n\n3. 验证设置：\n如果出现问题，扩展会在启动时运行健康检查并显示带具体修复说明的通知。你也可以在聊天中运行/gsd doctor来诊断问题。\n\n## 项目状态与限制\n\n- **需要GSD Pi（或GSD V2）**：这是一个UI包装器，不是独立代理。gsd CLI必须单独安装和配置。\n- **部分GSD自定义UI命令**依赖TUI小部件，VS Code webviews无法直接渲染。/gsd status通过结构化仪表板渲染器支持；其他依赖小部件的命令仅产生文本输出。\n\n## 总结\n\nRokket-GSD成功地将GSD Pi的命令行能力转化为流畅的VS Code原生体验。通过流式聊天、丰富的工具可视化、并行工作流支持、Telegram集成和深度VS Code集成，它让AI辅助编程无缝融入开发者的日常工作流程。\n\n对于已经使用或希望尝试GSD Pi的开发者来说，Rokket-GSD提供了一个更直观、更高效的交互界面，值得尝试。