【免费下载链接】rocketride-serverHigh-performance AI pipeline engine with a C core and 50 Python-extensible nodes. Build, debug, and scale LLM workflows with 13 model providers, 8 vector databases, and agent orchestration, all from your IDE. Includes VS Code extension, TypeScript/Python SDKs, and Docker deployment.项目地址https://gitcode.com/gh_mirrors/ro/rocketride-server点击查看免费下载RocketRide 是一个开发者原生的开源 AI 管线平台其 VS Code 扩展把可视化拖拽画布、C 高性能引擎与发布部署能力直接嵌入编辑器。本文以官方扩展文档为主体结合仓库源码与配套文档系统讲解安装、连接配置、管线创建/运行/调试、执行默认值、.env自动同步、编码 Agent 集成以及 Google/Microsoft 节点 OAuth 等完整使用链路帮助读者直接在 IDE 内完成从搭建管线到发布上云的整个工作流。快速开始Quick Start安装并启动 RocketRide 扩展只需四步从 VS Code Marketplace 安装RocketRide扩展点击 Activity Bar活动栏中的RocketRide图标打开侧边栏新建一个.pipe文件——它会自动在可视化画布构建器中打开通过连接节点的输入/输出 lane数据流通道来接线节点然后点击Play运行。扩展将.pipe和.pipe.json注册为自定义编辑器rocketride.PageProjectPipeline Grid Editor并将*.rrapp注册为 App Builder 编辑器见 apps/vscode/package.json 的contributes.customEditors因此打开这两种文件即自动进入对应编辑界面无需手动切换。兼容所有基于 VS Code 的编辑器同一套构建产物同时支持 VS Code 及其衍生分支如Cursor、Windsurf、VSCodium可视化画布、运行时管理和管线工具在各类编辑器中的行为完全一致。扩展还会自动检测你的编码 AgentGitHub Copilot、Claude Code、Cursor 或 Windsurf并把RocketRide agent rules写入工作区让编辑器里的 AI 理解如何构建 RocketRide 管线。RocketRide 是什么RocketRide 是一个开源、开发者原生的 AI 管线平台你可以在 IDE 内用可视化拖拽画布或代码优先的方式TypeScript / Python SDK构建、调试并部署生产级 AI 工作流。你构建的是.pipe文件然后把它运行在可用的最快 AI 运行时上。100 开箱即用的节点——涵盖 15 LLM 提供商、9 种向量数据库、OCR、NER、PII 匿名化等仓库中的节点实现见 nodes/src/nodes如llm_openai、store_chroma、ocr等目录高性能 C 引擎——生产级的速度与可靠性核心实现位于 packages/server/engine-core 与 packages/server/engine-lib随处部署——本地、私有化部署或通过 Docker 自托管参考 docker/docker-compose.ymlMIT 许可——完全开源、符合 OSI 规范。核心功能概览可视化画布构建器在 VS Code 内直接拖拽、连接、编排 AI 工作流创建.pipe文件即可开始。调试与实时追踪实时监控运行中的管线查看执行轨迹execution traces、token 用量与内存统计能看清 Agent 每一步在做什么。App Builder从模板脚手架scaffold、实时预览、发布并部署 Shell Apps全程不离开 VS Code。连接管理器一键连接本地引擎无需额外设置或连接自建 on-premises 服务器。TypeScript / Python / MCP SDK把管线嵌入你自己的应用或将其暴露为 AI 助手的工具SDK 见 packages/client-typescript、packages/client-python 与 packages/client-mcp。安装与首次运行设置安装方式打开 VS Code进入扩展视图CtrlShiftX/CmdShiftX搜索RocketRide并点击Install。安装细节可参考 安装文档。首次启动时扩展会显示Welcome页面引导完成设置选择连接模式Cloud云、On-premises私有化或 Local本地输入服务器 URLon-premises 或本地模式使用默认http://localhost:5565输入 API Key即你的 RocketRide 认证令牌存放在 VS Code 的 secret storage 中不会写入settings.json点击 Connect扩展会测试连接并在状态栏显示连接状态。完成初始设置后扩展会在每次启动时自动连接。若想跳过欢迎页可将rocketride.welcomeDismissed设为true。扩展设置全解打开 VS Code 设置Ctrl,/Cmd,并搜索rocketride即可配置全部选项。以下表格完整收录了扩展声明在 apps/vscode/package.json 的contributes.configuration.properties中的全部设置项。连接Connection设置类型默认值说明rocketride.development.connectionModestringlocal开发连接模式local本机、docker、service本机 RocketRide 服务、onprem直连填写 host 地址与 API key、cloudRocketRide Cloud账号登录rocketride.development.hostUrlstringon-prem 或直连的主机 URLhost 与端口会从该 URL 解析rocketride.development.useCustomServerbooleanfalseCloud 模式下改为连接cloudUrl指定的服务器而非 RocketRide Cloudrocketride.development.cloudUrlstringhttps://api.rocketride.aiCloud 模式下启用自定义服务器时连接的目标如https://cloud.rocketride.ai、http://localhost:5565。自定义服务器必须使用 https仅 localhost 开发目标允许 httprocketride.deployment.connectionModestring \| nullnull部署连接模式null 与开发连接共用rocketride.deployment.hostUrlstring部署连接的主机 URLrocketride.deployment.useCustomServerbooleanfalseCloud 模式下部署到cloudUrl指定的服务器rocketride.deployment.cloudUrlstringhttps://api.rocketride.aiCloud 部署模式的自定义服务器地址凭证不是设置项API Key 通过设置页命令rocketride.page.settings.setupCredentials输入更新/清除分别用rocketride.page.settings.updateApiKey/rocketride.page.settings.clearApiKey保存在 VS Code SecretStorage 中而非settings.json。管线Pipeline设置类型默认值说明rocketride.defaultPipelinePathstring${workspaceFolder}/pipelines新建管线文件的默认目录相对工作区根目录如pipelines、src/pipelines、workflowsrocketride.pipelineRestartBehaviorstringprompt管线运行中.pipe文件被修改时的行为auto自动重启、manual不自动重启、prompt询问是否重启rocketride.pipelineTTLinteger900运行中管线的空闲超时秒可选 90015 分钟/ 180030 分钟/ 36001 小时/ 144004 小时/ 288008 小时/ 0一直运行直到手动停止rocketride.pipelineTraceLevelstringfull管线执行追踪详细度full、summary、metadata、nonerocketride.taskArgumentsstring传给每个管线任务进程的附加命令行参数rocketride.pipelineDebugOutputbooleanfalse启用管线任务的完整调试输出追加--tracedebugOut本地引擎Local Engine设置类型默认值说明rocketride.development.local.engineVersionstringlatest要下载的引擎版本latest最新稳定版、prerelease最新预发布版或具体 tag 如server-v3.1.1rocketride.deployment.local.engineVersionstringlatest本地部署目标的引擎版本集成Integrations设置类型默认值说明rocketride.integrations.autoAgentIntegrationbooleantrue启动时自动检测并为编码 AgentCopilot、Claude Code、Cursor、Windsurf安装 RocketRide 文档rocketride.integrations.copilotbooleanfalse启用 GitHub Copilot 集成rocketride.integrations.claudeCodebooleanfalse启用 Claude Code 集成rocketride.integrations.cursorbooleanfalse启用 Cursor 集成rocketride.integrations.windsurfbooleanfalse启用 Windsurf 集成rocketride.integrations.claudeMdbooleanfalse将 RocketRide 使用说明安装到仓库根目录的CLAUDE.mdrocketride.integrations.agentsMdbooleanfalse将 RocketRide 使用说明安装到仓库根目录的AGENTS.mdApp Builder设置类型默认值说明rocketride.appdev.shellUrlstring覆盖预览 shell 的 base URL空值 使用 Development Mode 引擎其 origin 必须与所连服务器一致否则预览看不到开发 overlayrocketride.appdev.autoWatchbooleantrue打开 App Builder 界面时自动启动 app 的 watch/rebuild 会话连接模式详解扩展支持五种连接模式分别对应不同的运行环境local下载并在本机运行一个 RocketRide 引擎开箱即用、无需额外设置docker连接本机的 Docker 实例引擎侧实现见 apps/vscode/src/engine/docker依赖dockerodeservice连接本机的 RocketRide 服务各平台服务管理见 apps/vscode/src/engine/serviceonprem直连自建服务器填写 host 地址与 API keycloud登录 RocketRide CloudOIDC 登录流程详见下文。Cloud 模式自定义服务器Cloud 模式默认连接生产环境的 RocketRide Cloud。在Settings → Development或→ Deployment→ 连接模式Cloud下可勾选自定义服务器用于 staging 或自托管云环境使用自定义服务器按组配置rocketride.group.useCustomServer与rocketride.group.cloudUrl其中group为development或deployment勾选后出现 URL 输入框登录与全部流量均指向该服务器未勾选或 URL 为空时使用复选框下方展示的默认云服务器——默认值来自扩展的设置声明不会被打包进 webview bundle。保存并重连面板会对表单当前指向的服务器做兼容性探测Sign In特意使用表单内的值——OAuth code 与你看到的那台服务器交换即使尚未保存。其余操作部署、运行、checkout都跟随活动连接因此切换服务器后应保存设置 → 登出 → 重新登录以在新服务器上建立会话。会话/服务器不匹配扩展会记录每次登录对应的服务器。若表单后未指向同一服务器Cloud 面板会明确提示并在你在所选服务器登录之前拒绝展示订阅/结算界面——计费永远发生在面板所描述的服务器上而不是之前的服务器。无效或不可达 URL兼容性探测失败时面板报告所配置服务器不支持 RocketRide Cloud只有通过探测的服务器才允许登录。空的自定义 URL 会回退到默认服务器。命令参考扩展通过 apps/vscode/package.json 的contributes.commands注册了以下命令命令说明RocketRide: Settings打开扩展设置RocketRide: Server Monitor查看服务器与管线状态RocketRide Pipeline: Create New Pipeline新建.pipe文件RocketRide Pipeline: Run运行选中的管线RocketRide Pipeline: Stop Pipeline停止正在运行的管线RocketRide: Open as Text以原始 JSON 文本打开.pipe文件RocketRide: Welcome打开欢迎页此外连接、断开、重连是侧边栏连接面板中的按钮rocketride.sidebar.connection.connect/disconnect/reconnect不是命令面板命令。扩展还为.pipe编辑器绑定了CtrlS/CmdS保存管线并在侧边栏管线列表项上提供内联的Runstopped 状态与Stop Pipelinerunning 状态按钮见menus.view/item/context的when条件。创建、运行与调试管线创建管线使用File New File RocketRide Pipeline或点击 RocketRide 侧边栏的新建.pipe文件.pipe文件会自动在可视化编辑器中打开从组件面板component palette把组件拖到画布上在属性面板中配置每个组件的属性API keys、模型、连接串等通过绘制组件输出与输入 lane 之间的连线来定义数据流保存文件改动会自动保存。可视化编辑器由四部分组成组件面板浏览与搜索节点sources、LLMs、stores 等、画布拖拽排布工作区、属性面板配置选中组件、Lane 连线定义数据流。运行管线点击侧边栏管线项上的内联Run按钮或画布中 source 节点上的Play即可运行。Status页面会打开并实时监控执行过程可观察数据在组件间的流动、查看完成度指标并检查错误。调试管线在Run and Debug视图中启动RocketRide: Launch Pipeline调试配置rocketride类型的 launch 配置调试器打开并支持断点在组件上设置断点以暂停执行逐步执行管线并在每个断点检查变量值。附加到运行中的管线如果管线已在服务器上运行在Run and Debug视图中启动RocketRide: Attach to Pipeline调试配置Status页面会打开并实时流式展示运行中管线的数据。从源码看这两类调试配置由 apps/vscode/src/debugger/adapter.ts 注册RocketRide: Launch Pipeline与RocketRide: Attach to Pipeline调试适配器与断点会话分别实现在 apps/vscode/src/debugger/adapter.ts 和 apps/vscode/src/debugger/session.ts。管线执行默认值Trace 详细度、空闲超时TTL、任务参数与调试输出这些执行选项在Settings → Pipeline中统一配置它们是工作区设置而非单条管线的选项Pipeline Trace Levelrocketride.pipelineTraceLevel默认full控制引擎产出多少执行轨迹数据——full、summary、metadata或none。级别越高Flow与Trace标签页的内容越丰富但full会内联完整的 payload包括图片处理大图时会明显拖慢运行速度。Pipeline TTLrocketride.pipelineTTL默认900 15 分钟引擎在无活动多久后停止一条运行中的管线。可选值从 15 分钟到 8 小时外加“一直运行直到你停止它”0 无超时。Task Argumentsrocketride.taskArguments默认空传给每个管线任务进程的附加命令行参数。引擎按 shell 解析规则拆分字符串因此带引号的路径会被保留。Pipeline Debug Outputrocketride.pipelineDebugOutput默认false为任务参数追加--tracedebugOut除非其中已包含--trace标志以获得更详细的任务 trace 日志。从源码结构看扩展主进程从工作区设置读取这些值并在每次run/restart时传给引擎status:pipelineAction消息只携带 action 与 source引擎进程本身启动时不带额外标志——这些设置作用于每个任务task而不是服务器server。完整的执行状态类型定义见 apps/vscode/src/shared/types/taskStatus.ts。.env自动同步引擎连接成功后扩展只针对development连接组、在自托管模式local、Docker、service、直连/on-prem 连接下同步工作区.env写入解析后的ROCKETRIDE_URI适用时包含动态本地端口与ROCKETRIDE_APIKEY保留已有注释与变量内容已是最新时不会重写文件RocketRidePython SDK会自动从其进程工作目录读取工作区.envTypeScript SDK 与 CLI 只读进程环境变量因此需要先导出例如set -a; source .envCloud 连接不会被同步其 OAuth token 不是 SDK API key部署连接、未打开文件夹的工作区、不可读的.env也会被跳过同步失败绝不影响连接本身请将.env加入.gitignore——扩展本身也会把.rocketride/与.env写入.gitignore见 apps/vscode/src/agents/agent-manager.ts 中对appendGitignoreEntries的调用以免git add .时把真实的 API key 提交上去。注意扩展从不自动删除这些键——断开连接、引擎退出或切换到 Cloud 后最后一次同步的值仍会保留如需移除请手动删除。每次 development 组的自托管连接都会重新同步因此手工编辑过的ROCKETRIDE_APIKEY会在下一次成功连接时被覆盖。监控执行Status页面提供组件状态每个组件的 pending、running、completed、failed 指示数据流数据在管线中流动的可视化呈现指标完成率与耗时图表错误失败组件的详细错误信息与日志。AI 辅助开发与编码 Agent 集成启用后Copilot 与 Cursor 集成可提供基于用例的管线结构建议、组件配置推荐、错误诊断与修复建议、管线优化提示。在设置中启用rocketride.integrations.copilot与rocketride.integrations.cursor即可。更广义的 Agent 集成由 apps/vscode/src/agents/agent-manager.ts 编排它从已连接的服务器下载 agent 文档包GET /client/docs到.rocketride/docs/stubs 在stubs/下按 hash 标记内容未变化时为空操作检测工作区中存在的编码 Agent再委托给各自的安装器copilot-installer.ts、claude-code-installer.ts、cursor-installer.ts、windsurf-installer.ts、claude-md-installer.ts、agents-md-installer.ts。由于 stubs 来自下载的 bundle它们始终与所连服务器匹配。命令面板中也有RocketRide: Install Agent Documentation与RocketRide: Remove Agent Documentation用于手动安装/移除。云端登录Zitadel OIDC从扩展登录 RocketRide Cloud 走的是带 PKCE 的 OIDC 授权码流程由 Zitadel 完成认证扩展打开系统浏览器并通过深链接deep link把结果送回编辑器。完整协议见 Cloud 登录文档。扩展以哪个应用身份登录Zitadel 通过 client id 识别调用方。扩展拥有自己的注册native 类型redirect 为vscode://rocketride.rocketride/auth/callback与网站web 类型分开二者不能共用——若授权请求把二者混用会在浏览器打开前被拒绝invalid_request/redirect_uri is missing in the client configuration。URI scheme 是你所用编辑器的vscode-insiders、cursor、windsurf、trae各有各的 scheme扩展对它们都已注册。client id 来源RR_ZITADEL_VSCODE_CLIENT_ID在构建时由 apps/vscode/esbuild.js 内联进扩展缺省会导致构建直接失败这个内置值无需任何配置。覆盖租户ioControl(signin, …)接受zitadelUrl与clientId二者必须成对提供都提供则向另一租户登录都不提供则用内置值。只提供zitadelUrl会被拒绝只提供clientId会被静默忽略——client id 是租户内部的注册没有租户可对应时丢弃它才能让扩展访问自己的 native 注册。登录失败排查点击登录无反应说明授权请求在浏览器打开前即被拒绝检查 URL 中 client id 与 redirect 是否匹配浏览器打开但返回错误页阅读error_descriptionredirect_uri is missing in the client configuration意味着所到达的注册未登记你的编辑器 scheme。Google 与 Microsoft 节点 OAuth访问 Google如 Gmail 工具与 Microsoft 365Excel、Word、OneDrive、Outlook Mail、Outlook Calendar服务的节点在节点配置面板提供 “Login with Google / Microsoft” 按钮。由于 Google/Microsoft 的授权页无法在 VS Code webview 中渲染扩展打开系统浏览器通过深链接回收 token。细节见 Google 登录文档 与 Microsoft 登录文档。流程与主机/webview 契约webview 请求 host 打开托管 OAuth broker URLGooglehttps://oauth2.rocketride.ai/google?...Microsofthttps://oauth2.rocketride.ai/microsoft?...携带节点服务配置、baseURL回跳地址、以及按节点所选访问层级access tier生成的显式scope参数——scope 按节点的 provider 取键见LoginWithGoogleButton.tsx/LoginWithMicrosoftButton.tsx中的SERVICE_TIER_SCOPES对应google_access.py/microsoft_access.py中各服务的AccessSpec未知 provider 或 tier 时不发送scope。用户在 Google / Microsoft Entra 的授权页完成同意broker 用自己的已验证应用交换 codeclient secret 永远不会到达扩展或管线配置。broker 重定向到 bounce 页https://api.rocketride.ai/auth/vscode/google或/auth/vscode/microsoft把结果转发给编辑器深链接vscode://rocketride.rocketride/auth/google或/auth/microsoft。扩展把 token 路由给发起登录的文档当前存活的编辑器在投递时解析若浏览器往返期间原 webview 已被回收token 会被暂存并在下次编辑器加载后重投5 分钟内未投递则过期。webview 应用 token 后host 会保存文档token 无需手动保存即可进入.pipe文件。主机与 webview 之间交换三类消息project:loadhost→webview携带oauthReturnUrl每次加载时发送同时清空 webview 暂存的 pending token但 host 会紧接着重投未投递的 broker tokenproject:openExternalwebview→host请求打开 broker URLhost 在打开前按 URL 的node_id注册一次性 token waiter浏览器打开失败则注销并报错project:oauthTokenshost→webview原始 broker 结果state是回显node_id的 JSON配置面板只把 token 应用到匹配节点后清除。深链接的 query 参数为tokens、state失败时为oauth_error/error/error_description统一处理见 apps/vscode/src/auth/CloudAuthProvider.ts 的handleProviderOAuth。保存的配置形态与 scope 层级Token 落在节点配置根部authType: user与userToken: JSON token string。节点配置是扁平的——引擎读取顶层cfg.get(authType)/cfg.get(userToken)表单 schema 按最后一段组件命名点分字段 id如google.userToken。parameters.*位置是遗留路径此流程从不写入。授予的 scope 在同意时即固定提高节点的访问层级如modify→send需要断开并重新连接账号以重新授权降低层级则不需要——引擎的 scope 检查把https://mail.google.com/视为覆盖所有 Gmail scope、gmail.modify视为覆盖gmail.readonlymissing_scopes于core/google_access.pyMicrosoft 侧则把某家族的.ReadWrite或.ReadWrite.All视为覆盖同名.Read任何.Allscope 覆盖其去.All版本core/microsoft_access.py。不带scope字段的旧 token 会被接受fail-open。Microsoft 应用认证client credentialsWord、OneDrive、Outlook Mail、Outlook Calendar 节点还接受microsoft.authType: service——用 Entra 应用注册自身的 client credentials 认证不依赖 OAuth broker今天即可使用。Excel 仅支持用户 OAuthMicrosoft Graph 的 workbookExcelAPI 不支持 application permissionsapp-only token 无论注册授予什么都会被拒绝。Entra 应用注册要点注册单租户应用 → 添加Microsoft Graph → Application permissions非 delegated匹配节点使用的每个服务及其配置的访问层级service.access——Wordreadonly/write分别对应Files.Read.All/Files.ReadWrite.AllOneDrive 同理onedrive_restore在 app-only 下被拒绝因其仅限 OneDrive PersonalOutlook Mailreadonly/send/modify对应Mail.Read/Mail.ReadMail.Send/Mail.ReadWriteMail.SendMail.Send是独立动作权限Mail.ReadWrite不含它Outlook Calendarreadonly/write对应Calendars.Read/Calendars.ReadWrite。然后为租户授予管理员同意application permissions 是租户级权限应用无法自行同意创建 client secret最后在节点配置填入microsoft.authType: service、microsoft.tenantId、microsoft.clientId、microsoft.clientSecret与microsoft.userPrincipalName——应用权限本身不限定邮箱/驱动器每个 Graph 调用都针对/users/{userPrincipalName}由userPrincipalName决定 app-only 凭证作用于谁的数据。若需进一步收敛租户内的访问面Exchange 的New-ApplicationAccessPolicy、SharePoint 的Sites.Selected模式需在 Microsoft 365 / Entra 侧直接配置。部署到云打开侧边栏文件视图的DEPLOY页面配置部署设置后点击Deploy即可把管线推送到 RocketRide.ai 云。部署界面由 Project webview 内的共享 UI 组件渲染扩展主进程负责全部 SDK 到视图模型的映射完整的消息协议deploy:fetch/deploy:data/deploy:publish/deploy:deploy/deployment:load/deployment:preview/deployment:validate等记录在 部署 Webview 协议文档契约类型位于 apps/vscode/src/providers/types/deployTypes.ts。关键设计所有请求带requestId关联FETCH 消息例外其响应是带teamId的推送界面不轮询、由apaevt_deploy失效事件与apaevt_task实时折叠驱动刷新个人部署的 wire id 为me、记录 id 为user~{uid}的映射由 host 完成。App BuilderApp Builder 是扩展内用于构建运行于 RocketRide shell 中的应用App的工作台。打开方式命令面板执行RocketRide: New App或侧边栏应用列表的New App把应用 scaffold 到apps/并打开构建器把侧边栏切换到应用模式MY APPS会列出打开工作区中的.rrapp绑定应用直接打开name.rrapp文件也会进入对应构建器。按 F5Debug App可在外部浏览器中打开预览应用并附加调试器。相关设置rocketride.appdev.autoWatch默认true打开构建器时自动启动 watch 会话与rocketride.appdev.shellUrl覆盖预览 shell 的 base URL详见 App Builder 文档。许可证与文档资源许可证MIT见仓库根目录 LICENSE。扩展源码apps/vscode入口 apps/vscode/src/extension.ts构建配置 apps/vscode/esbuild.js。配套文档安装文档、使用指南、Cloud 登录、Google 登录、Microsoft 登录、部署 Webview 协议、App Builder。赞分享【免费下载链接】rocketride-serverHigh-performance AI pipeline engine with a C core and 50 Python-extensible nodes. Build, debug, and scale LLM workflows with 13 model providers, 8 vector databases, and agent orchestration, all from your IDE. Includes VS Code extension, TypeScript/Python SDKs, and Docker deployment.项目地址https://gitcode.com/gh_mirrors/ro/rocketride-server点击查看免费下载相关推荐Kilo JetBrains 插件开发实战指南Split-Mode 架构、CLI 进程集成与 Swing UI 工程规范Kilo JetBrains 插件开发实战指南Split Mode 架构、CLI 进程集成与 Swing UI 工程规范 本文基于 packages/kilo在VS Code中调试Jest测试的完整指南在VS Code中调试Jest测试的完整指南 前言 作为前端开发者单元测试是保证代码质量的重要环节。Jest作为目前最流行的JavaScript测试框架之一示例工程Vetur调试指南在VS Code中完美调试Vue.js应用Vetur调试指南在VS Code中完美调试Vue.js应用 想要在VS Code中高效调试Vue.js应用吗Vetur作为Vue.js官方推荐的VS Co开发工具IDE前端上一篇Apache DolphinScheduler E2E 测试参与指南从认领 Issue、编写用例到提交 Pull Request下一篇黑豹X2设备Armbian系统换源与更新问题解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
