stagewise 开源 Agentic IDE 上手指南:内置编程 Agent 与多模型 BYOK 接入实践
发布时间:2026/10/9 2:30:28 锦皓数字建站

人工智能AI Agent代码智能体开发工具【免费下载链接】stagewiseThe Open Source Agentic IDE. Create and orchestrate coding agents, show app previews and run git workflows. Use your favorite models across all providers.项目地址https://gitcode.com/gh_mirrors/st/stagewise点击查看免费下载导读本文基于 stagewise 仓库官方法语版 READMElocales/README.fr.md内容与 英文版 README 一致整理系统讲解这款开源 Agentic IDE 的核心定位、六大核心能力、快速开始流程以及最关键的自带密钥Bring Your Own KeyBYOK模型接入体系如何用一张 API 密钥导入现有编程订阅、如何注册自定义提供商甚至本地推理以及 stagewise 官方账户三档订阅与内置模型清单。读完本文你将掌握 stagewise 的模型接入路径选择、密钥安全机制与底层实现原理能够立即上手配置自己的编程 Agent 环境。stagewise 的定位是为开源模型打造的 Agentic IDELIDE agentique pour les modèles open source它把浏览、编码与 Agent 编排放进同一个工具并允许你自由选择几乎任何主流模型提供商。仓库本体是完整的开源实现涵盖浏览器应用apps/browser、Agent 核心packages/agent-core、网页与应用商店apps/website等模块本文所讲的功能均可在其中找到对应源码佐证。图stagewise 的完整界面演示深色主题来源见 apps/website/src/app/(home)/_components/feature-images该图同时被英文与法语 README 用作项目演示图。项目定位为什么叫 Agentic IDE法语版 README 对项目的定义非常明确stagewise 是面向开发者的开源 Agentic IDE内置了编程 Agentun IDE agentique open source pour les développeurs, avec un agent de programmation intégré。与普通编辑器的区别在于它把浏览、构建、调试、改代码的完整闭环放进同一工具避免上下文切换。官方文档归纳出六项核心能力同一工具内浏览与构建Browse and build——无需切换工具或上下文与编程 Agent 协作该 Agent可完整访问当前标签页的控制台console与调试器debugger——这是 stagewise 区别于纯聊天补代码类工具的关键设计Agent 能直接观察网页运行时状态临时测试性修改modifications de test temporaires或连接一个代码库codebase进行永久性编辑——两种工作模式并存逆向工程任意网站的组件、样式系统与配色Rétro-ingénierie——可用 Agent 快速拆解前端实现IDE 集成在你偏好的编辑器中查看并应用代码变更自带 API 密钥BYOK对所有 AI 提供商完整支持——这是后文重点。其中完整访问控制台与调试器这一能力在仓库中对应浏览器应用对渲染进程的深度集成apps/browser的 preload 与共享工具模块如 native-input-events.ts、chromium-errors为 Agent 提供了贴近浏览器底层的运行时能力。你可以把 stagewise 理解为以浏览器为前端工作台、以 Agent 为核心引擎的 IDE。快速开始下载与首次配置官方快速开始路径只有两步从stagewise.io下载 stagewise 应用官网首页apps/website即负责下载页与功能展示跟随应用内的**简短引导onboarding**完成账户配置。仓库内提供了对应的README.zh-CN.md、README.de.md等多语言版本见 locales 目录首次使用前也可参考与你语言最接近的版本。需要说明的是文章只介绍查看、安装与配置方式仓库为只读镜像无需也不应修改仓库文件即可完成上手。使用你的编程订阅BYOK 一键导入法语版 README 的第三节标题为Utilisez votre abonnement de programmation使用你的编程订阅其核心思路是Bring Your Own Key——为所有主流模型提供商自带密钥更进一步你还可以注册完全自定义的提供商包括本地推理如 Ollama并自定义模型。这意味着 stagewise 不是锁定某个云厂商而是把模型接入做成开放的配置体系。Easy Import一条密钥解锁一家提供商全部模型Easy Import导入简单指的是连接下表任一订阅只需一张 API 密钥即可在 stagewise 内解锁该提供商提供的全部模型。法语版 README 给出四家官方合作订阅订阅提供商主打模型密钥获取位置仪表盘KimiMoonshot AIKimi K3、Kimi K2.7 Code、Kimi K2.6、Kimi K2.5Moonshot AI 控制台 API KeysQwen Coding Plan阿里云百炼DashScopeQwen 3-Coder 30B-A3B、Qwen 3-32BDashScope 控制台 API KeyMiniMaxMiniMaxMiniMax M3、MiniMax M2.7MiniMax 平台接口密钥Xiaomi MiMoXiaomi MiMoMiMo-V2.5-Pro、MiMo-V2.5Xiaomi MiMo 控制台订阅管理源码级佐证Coding Plan 注册表与密钥校验规则这四家订阅并非口头承诺而是真实编码进了应用前端共享模块。在 apps/browser/src/shared/coding-plans.ts 中CODING_PLANS注册表自 L53 起为每个计划定义了provider、displayName、apiKeyUrl、helpText、apiKeyPattern剪贴板自动识别用的正则、baseUrl/validationBaseUrl专用运行时与校验端点等字段。仓库当前实际注册了6 个计划 ID见 coding-plan-ids.tsglm-coding-plan、kimi-plan、qwen-plan、qwen-token-plan、minimax-plan、mimo-plan除 README 表格中的四家外还包含 GLM Coding PlanZ.ai与 Qwen Token Plan读者可在源码中自行查看。各计划的密钥格式在源码中都有明确约束可用于自查密钥是否合法KimiMoonshotapiKeyPattern: ^sk-[A-Za-z0-9]{48}$即sk-开头 48 位字母数字coding-plans.ts L79Qwen Coding Plan^sk-(?:sp-)?[A-Za-z0-9_-]$计划密钥通常以sk-sp-开头其运行时端点被路由到国际 Coding Plan 端点coding-intl.dashscope.aliyuncs.com/v1coding-plans.ts L82-L113MiniMax Token Plan^sk-cp-前缀密钥通过/v1/token_plan/remains端点校验coding-plans.ts L151-L165Xiaomi MiMo^tp-[A-Za-z0-9]$tp-前缀密钥路由到token-plan-cn.xiaomimimo.com/v1且注释说明新加坡sgp与欧洲ams集群同样可用coding-plans.ts L166-L181。在 UI 中输入密钥后应用会调用validateCodingPlanBaseUrl()coding-plans.ts L189-L225对端点做规范化校验要求绝对 URL、必须为 HTTPS、不得携带用户名密码、不得带查询串或片段最后统一去掉尾部斜杠——这套校验同样适用于用户自定义端点。连接成功后密钥会被加密存储到providerConfigs[provider].encryptedApiKey模式置为official并记录connectedCodingPlanId用于后续请求路由见 coding-plans.ts L7-L15 的注释说明。图官网使用现有订阅use-existing-subscription功能配图深色主题与 README 的 Easy Import 章节主题直接对应。自定义提供商与本地推理除内置计划外stagewise 支持注册完全自定义的提供商包括本地推理服务。源码层面有两处支撑CODING_PLANS类型中的configurableEndpoint字段允许部分计划如 Qwen Token Plan在通用计划 UI 中开放用户可编辑端点输入框coding-plans.ts L36-L40在 flagship-models.ts 的isFlagshipFilteringEnabled()L127 起中ollama被明确排除在旗舰模型自动筛选之外——注释写道本地 Ollama 拉取的所有模型地位平等不做精选all user-pulled models are equal, no curationcustom-*、azure、bedrock、vertex等用户自配类型同样不做筛选。这说明本地/自定义接入与官方订阅走的是两套逻辑官方订阅走内置路由与精选模型自定义与本地模型则完全由用户掌控。凭据安全机制密钥如何在运行时被保护BYOK 模式要解决的核心问题是密钥安全。仓库在 apps/browser/src/shared/credential-types/types.ts 中给出了一套完整的凭据类型机制秘密字段通过credentialField()L23-L24定义底层是一个带__credential__运行时标记的 Zod string被标记的字段在凭据存储中加密存放返回给沙箱sandbox VM时会被替换为不透明占位符例如{{CRED:figma-pat:token:a8f3c1}}见ResolvedCredential注释 L121-L131只有向allowedOrigins如 stagewise 的https://*.stagewise.io见 stagewise-auth.ts L16发起的请求才会由代理后的fetch自动用真实值替换占位符发往其他来源且带凭据占位符的请求会在代理层被拒绝CredentialTypeDefinition.onGet钩子L71-L80在把凭据交还沙箱前可在主进程执行校验、刷新令牌或数据变换。也就是说Agent 运行环境永远拿不到明文密钥只有受信任出站请求才被代理注入真实值——这是 BYOK 体系能安全落地的关键。stagewise 官方账户三档订阅与模型库如果你不想逐个接提供商可以创建 stagewise 账户立即获得大量模型库的访问权accès immédiat à une vaste bibliothèque de modèles。法语版 README 给出三档定价计划价格限额Free免费$0 / 月仅限访问 3 个标准模型Default、Quick、SmartPro专业$20 / 月访问全部模型包括 Frontier 与 Open-Weights开源权重Ultra旗舰$200 / 月访问全部模型限额为 Pro 的 15 倍登录 stagewise 账户后应用会自动注入访问令牌源码中定义了名为Stagewise Access Token的凭据类型注明登录 stagewise 时自动提供用于访问 stagewise API见 stagewise-auth.ts。内置模型清单账户订阅所包含的模型分为两大类完整列表如下以法语版 README 为准开源权重模型Modèles à poids ouvertsMoonshot AIKimi K3、Kimi K2.7 Code、Kimi K2.6、Kimi K2.5阿里巴巴Qwen 3-32B、Qwen 3-Coder 30B-A3BDeepSeekDeepSeek V4 Pro、DeepSeek V4 FlashZ.aiGLM 5.2、GLM 5.1、GLM 5V-TurboMiniMaxMiniMax M3、MiniMax M2.7、MiniMax M2Xiaomi MiMoMiMo-V2.5-Pro、MiMo-V2.5专有模型Modèles propriétairesAnthropicFable 5、Opus 4.8、Opus 4.7、Opus 4.6、Sonnet 5、Sonnet 4.6、Haiku 4.5OpenAIGPT-5.6 Sol、GPT-5.6 Terra、GPT-5.6 Luna、GPT-5.5、GPT-5.4、GPT-5.3 Codex、GPT-5.3 Instant、GPT-5.4 mini、GPT-5.4 nanoGoogleGemini 3.5 Flash、Gemini 3.1 Pro预览版、Gemini 3 Flash、Gemini 3.1 Flash Lite注意模型清单会随版本演进。在仓库 apps/browser/src/shared/available-models.ts 中维护着模型目录及输入约束如图片最大像素、PDF 大小上限、Anthropic 每图 1.2MP 限制、GPT-5.4 及之后按 2500 patches 计等而 flagship-models.ts 负责在提供商返回大量模型如 OpenRouter 返回数百个时只把旗舰模型默认启用、其余自动置灰但可在设置页手动开启L1-L22 注释——因此实际可选模型以应用内发现结果为准。选择接入方式订阅导入 vs 官方账户 vs 直接 API综合官方文档与源码可以梳理出三条并行的模型接入路径供读者按需选择接入路径适用场景密钥来源底层实现Easy Import 订阅导入已购买 Kimi / Qwen Coding Plan / MiniMax / MiMo 等订阅提供商控制台的一张 API 密钥走CODING_PLANS内置路由含专用 baseUrl 与校验端点官方 stagewise 账户想要即开即用、一个账户覆盖全模型库登录后自动注入的 Stagewise Access Token凭据类型 stagewise-auth.ts出站请求限定*.stagewise.io自定义提供商 / 本地推理自建网关、内网模型、Ollama 等本地推理用户自配密钥与端点configurableEndpoint开放端点编辑Ollama 等类型不做旗舰模型自动筛选许可与社区stagewise 由stagewise GmbH开发以AGPLv3开源协议发布。这意味着你可以自由使用、研究、修改与再分发但若以网络服务形式对外提供修改后的版本需遵守 AGPL 的开源传染条款。对于超出 AGPLv3 授权范围的使用场景官方文档建议直接联系销售团队洽谈商业授权。若在使用中发现 Bug 或有新功能想法可通过仓库 Issues 提交官方文档提供了 issue 入口开发者支持与社区交流主要通过 Discord 与官方 X原 Twitter账号进行具体链接见 locales/README.fr.md 文末。小结从一份不到百行的法语 README可以完整还原 stagewise 的核心价值主张一个把浏览、调试与 Agent 编程闭环在一起的开源 IDE配上极其开放的模型接入体系。三条接入路径一键导入订阅、官方账户、自定义/本地推理覆盖了从已有云订阅到纯本地模型的全部需求而密钥加密存储、占位符替换与出站代理注入的凭据机制则为 BYOK 模式提供了可验证的安全底座。如果你想进一步深入源码建议从 apps/browser/src/shared/coding-plans.ts 与 apps/browser/src/shared/credential-types/types.ts 读起它们是理解整个模型接入体系的最佳入口。赞分享人工智能AI Agent代码智能体开发工具【免费下载链接】stagewiseThe Open Source Agentic IDE. Create and orchestrate coding agents, show app previews and run git workflows. Use your favorite models across all providers.项目地址https://gitcode.com/gh_mirrors/st/stagewise点击查看免费下载相关推荐stagewise 德语版 README 全解析开源 Agentic IDE 的安装、BYOK 订阅接入与模型矩阵stagewise 德语版 README 全解析开源 Agentic IDE 的安装、BYOK 订阅接入与模型矩阵 本篇技术指南以仓库根目录下的德语项目说明文人工智能AI Agent代码智能体开发工具stagewise 模型接入实战指南BYOK 自带密钥、订阅计划一键导入与自定义 Providerstagewise 模型接入实战指南BYOK 自带密钥、订阅计划一键导入与自定义 Provider stagewise 是一款开源 Agentic IDE智人工智能AI Agent代码智能体开发工具Stagewise AGENTS.md 深度解读开源 Agentic IDE 的 AI 协作开发规范与 Monorepo 工程实践Stagewise AGENTS.md 深度解读开源 Agentic IDE 的 AI 协作开发规范与 Monorepo 工程实践 Stagewise 是一个人工智能AI Agent代码智能体开发工具上一篇GPU显存测试怎么做用memtest_vulkan五分钟查出显卡花屏的元凶下一篇Gopeed下载工具首次唤醒失灵一份从零到一的自查手册与终极解决方案创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
锦
锦皓数字建站
深耕本土企业品牌数字化升级,专注原创端正雅致商务官网,从视觉设计到稳定运维全程保驾护航。