Open CoDesign 内置 Atlas Cloud 提供商:OpenAI 兼容接入、密钥校验与模型发现机制解析

发布时间:2026/11/17 4:31:33

Open CoDesign 内置 Atlas Cloud 提供商:OpenAI 兼容接入、密钥校验与模型发现机制解析 人工智能AI 应用桌面应用【免费下载链接】open-codesignOpen-source Claude Design alternative. One-click import your Claude Code / Codex API key. Prompt → prototype / slides / PDF. Multi-model (Claude, GPT, Gemini, Kimi, GLM, Ollama). BYOK, local-first, MIT.项目地址https://gitcode.com/gh_mirrors/op/open-codesign点击查看免费下载本文围绕仓库变更记录 .changeset/atlascloud-provider.md 展开系统梳理 Open CoDesign 将 Atlas Cloud 纳入内置builtin提供商的全过程从配置数据结构、首次启动引导onboarding、API Key 前缀识别到/v1/models校验与模型发现再到openai-chat线协议wire下的请求封装。读完本文你将理解内置提供商在共享配置层shared、提供商运行时providers与桌面主进程desktop三层之间的协作方式并能据此接入任意 OpenAI 兼容网关。一、变更内容概览一次跨包的内置提供商落地该 changeset 声明了对open-codesign/shared、open-codesign/providers、open-codesign/core、open-codesign/desktop四个包的patch级修改核心目标是Add Atlas Cloud as a built-in OpenAI-compatible provider for onboarding, validation, model discovery, and provider selection.即把 Atlas Cloud 作为内置的 OpenAI 兼容提供商接入四条链路onboarding首次引导用户在向导中可直接选择 Atlas Cloud 并粘贴 API Keyvalidation密钥校验应用通过其/v1/models端点验证密钥有效性model discovery模型发现从该端点拉取模型列表填充模型选择器provider selection提供商选择出现在内置提供商清单与设置页中可作为活动提供商使用。从仓库源码看这一改动主要落实在共享配置层packages/shared/src/config.ts与提供商运行时packages/providers/src/validate.ts、packages/providers/src/index.ts并配套了对应的单元测试。二、内置提供商的数据结构BUILTIN_PROVIDERSOpen CoDesign 把所有内置提供商的静态元数据集中在共享包中由 Zod schema 强校验。Atlas Cloud 在 packages/shared/src/config.ts 中注册如下atlascloud: { id: atlascloud, name: Atlas Cloud, builtin: true, wire: openai-chat, baseUrl: https://api.atlascloud.ai/v1, envKey: ATLASCLOUD_API_KEY, defaultModel: qwen/qwen3.5-flash, capabilities: { supportsKeyless: false, supportsModelsEndpoint: true, supportsReasoning: false, requiresClaudeCodeIdentity: false, modelDiscoveryMode: models, }, },对照同一文件中的ProviderEntrySchemapackages/shared/src/config.ts各字段含义如下字段Atlas Cloud 取值说明idatlascloud提供商唯一标识同时出现在旧版枚举ProviderIdEnum中nameAtlas Cloud界面展示名builtintrue标记为内置提供商区别于用户自定义提供商wireopenai-chat线协议决定请求按 OpenAI Chat Completions 兼容格式封装baseUrlhttps://api.atlascloud.ai/v1默认 API 根地址envKeyATLASCLOUD_API_KEY可选的系统环境变量名用于从环境注入密钥defaultModelqwen/qwen3.5-flash默认模型 IDcapabilities.supportsKeylessfalse不支持无密钥访问区别于本地 Ollamacapabilities.supportsModelsEndpointtrue支持/v1/models模型列举端点capabilities.supportsReasoningfalse声明默认不启用推理模式capabilities.requiresClaudeCodeIdentityfalse无需注入 Claude Code 身份头capabilities.modelDiscoveryModemodels通过GET /v1/models动态发现模型默认能力推导逻辑即便不显式声明capabilitiesdefaultProviderCapabilitiespackages/shared/src/config.ts也会根据wire、requiresApiKey、modelsHint自动推导只要wire不是openai-codex-responses且未提供modelsHintsupportsModelsEndpoint即为truemodelDiscoveryMode相应地为models。Atlas Cloud 显式声明的内容与推导结果一致测试在 packages/shared/src/config.test.ts 中对SUPPORTED_ONBOARDING_PROVIDERS、BUILTIN_PROVIDERS.atlascloud与PROVIDER_SHORTLIST.atlascloud逐一断言。三、Onboarding 引导短名单、默认模型与密钥前缀识别3.1 引导短名单Atlas Cloud 被列入SUPPORTED_ONBOARDING_PROVIDERSpackages/shared/src/config.ts当前完整名单为[anthropic, openai, atlascloud, openrouter, ollama]与之配套的PROVIDER_SHORTLIST.atlascloudpackages/shared/src/config.ts为引导界面提供展示标签、官方密钥页面与推荐模型atlascloud: { provider: atlascloud, label: Atlas Cloud, keyHelpUrl: https://atlascloud.ai/, primary: [qwen/qwen3.5-flash, deepseek-ai/deepseek-v4-pro], defaultPrimary: qwen/qwen3.5-flash, },用户在首次启动引导中可看到 Atlas Cloud 及其两个推荐模型默认qwen/qwen3.5-flash。3.2 粘贴密钥自动识别提供商引导流程支持“粘贴密钥自动判断提供商”实现在detectProviderFromKeypackages/providers/src/index.tsif (key.trim().startsWith(sk-ant-)) return anthropic; if (key.trim().startsWith(sk-or-)) return openrouter; if (key.trim().startsWith(apikey-)) return atlascloud; if (key.trim().startsWith(sk-)) return openai; if (key.trim().startsWith(AIza)) return google; if (key.trim().startsWith(xai-)) return xai; if (key.trim().startsWith(gsk_)) return groq;Atlas Cloud 的密钥以apikey-前缀开头用户无需手动选择提供商即可被引导到正确的配置流程。3.3 密钥保存与校验的 IPC 输入校验桌面主进程的 onboarding 参数解析层apps/desktop/src/main/onboarding/provider-parsers.ts对save-key、validate-key等 IPC 载荷做严格白名单字段校验。parseSaveKeyPayload与parseValidateKey均会检查provider是否属于SUPPORTED_ONBOARDING_PROVIDERS未通过时抛出PROVIDER_NOT_SUPPORTED密钥非空校验则豁免requiresApiKey false的内置提供商如 Ollama而 Atlas Cloud 必须提供非空密钥。IPC 层转发测试见 apps/desktop/src/main/onboarding-ipc.test.ts。四、Validation 校验流程GET /v1/models与错误归类4.1 端点构造pingProviderpackages/providers/src/validate.ts是引导阶段的密钥校验入口。针对 Atlas Cloud端点规则为packages/providers/src/validate.tscase atlascloud: { const root baseUrl ? normalizeValidateBaseUrl(baseUrl) : https://api.atlascloud.ai; return { url: ${root}/v1/models, headers: (apiKey) ({ authorization: Bearer ${apiKey} }), }; }校验请求携带Authorization: Bearer apiKey头发送到https://api.atlascloud.ai/v1/models。normalizeValidateBaseUrl会先剥离/v1尾缀及推理端点后缀如/v1/chat/completions避免拼接出/v1/v1/models这类双重路径。测试在 packages/providers/src/validate.test.ts 中模拟了该请求断言 URL 与 Bearer 头并期望返回{ ok: true, modelCount: 1 }。4.2 响应归类与错误码校验结果通过ValidateResult类型返回packages/providers/src/validate.tstype ValidateResult | { ok: true; modelCount: number } | { ok: false; code: 401 | 402 | 429 | network | parse; message: string };错误归类逻辑statusToCode与statusMessagepackages/providers/src/validate.ts401 / 403→401密钥无效提示用户复查402→402账户无余额提示充值或更换提供商429→429被限流提示稍后重试网络异常 →network响应体不符合预期结构 →parse。成功时countModels会同时兼容{ data: [...] }与{ models: [...] }两种响应形态并逐项校验每个模型条目至少包含字符串类型的id或name从而保证模型列表可被上层消费。五、Model Discovery模型发现模式与配置持久化5.1 动态模型发现Atlas Cloud 的modelDiscoveryMode为models意味着应用会直接调用其/v1/models端点拉取最新模型清单而不是使用静态modelsHint。在 OpenAI 兼容体系中这通常对应GET {baseUrl}/models返回形如{ data: [{ id: qwen/qwen3.5-flash }] }的列表。校验成功返回的modelCount同时也可用于给用户展示“检测到 N 个可用模型”。5.2 v3 配置中的持久化形态配置以 v3 形态落盘ConfigV3Schemapackages/shared/src/config.ts。内置提供商在首次迁移migrateLegacyToV3时自动播种遍历SUPPORTED_ONBOARDING_PROVIDERS并cloneBuiltin每个条目因此旧版 v1/v2 配置升级后会自动获得 Atlas Cloud 条目packages/shared/src/config.ts。运行时会通过providers[atlascloud].baseUrl读取其地址secrets[atlascloud]以SecretRef密文 显示掩码形式保存密钥密钥明文不会落盘。六、Wire 层实现openai-chat下的兼容性处理6.1 请求路由completepackages/providers/src/index.ts是单次非流式补全的统一入口。它惰性加载mariozechner/pi-ai优先通过pi.getModel(provider, modelId)查注册表查不到时若提供了wire与自定义baseUrl则由synthesizeWireModel合成一个 PiModelpackages/providers/src/index.ts。Atlas Cloud 的wire: openai-chat会映射到api: openai-completions适配器并以https://api.atlascloud.ai/v1作为baseUrl。6.2 推理reasoning启发式判断synthesizeWireModel通过inferReasoningpackages/providers/src/index.ts决定是否声明推理能力。对openai-chat线协议官方 OpenAI 域名api.openai.com按模型 ID 前缀o1/o3/o4/gpt-[56]判断第三方 OpenAI 兼容网关按REASONING_MODEL_ID_PATTERN启发式匹配如claude-opus-4、deepseek-r、:thinking后缀等。由于 Atlas Cloud 内置条目的capabilities.supportsReasoning为false默认不会向该端点声明推理模式避免部分 OpenAI 兼容网关对developer角色或 reasoning 字段返回 HTTP 400该问题在源码注释中被记为 issue #183。openAIChatCompatForBaseUrlpackages/providers/src/index.ts还会针对 DeepInfra 等已知特殊网关下调supportsDeveloperRole等兼容标志。6.3 密钥与安全约束complete起始处会检查密钥非空密钥去除首尾空白后传入 pi-ai空密钥仅在allowKeyless true时才被放行packages/providers/src/index.ts而 Atlas Cloud 的supportsKeyless: false意味着必须配置真实密钥。用户自定义的httpHeaders会合并到请求头中满足网关级自定义鉴权需求。七、关键证据索引变更声明 .changeset/atlascloud-provider.md内置提供商注册与短名单 packages/shared/src/config.ts、packages/shared/src/config.ts配置测试断言 packages/shared/src/config.test.ts校验端点与错误归类 packages/providers/src/validate.ts校验测试URL 与 Bearer 头 packages/providers/src/validate.test.ts密钥前缀识别 packages/providers/src/index.tsIPC 载荷解析 apps/desktop/src/main/onboarding/provider-parsers.tsIPC 转发测试 apps/desktop/src/main/onboarding-ipc.test.ts结语Atlas Cloud 的落地是 Open CoDesign “统一提供商模型”的一个典型切片共享层用 Zod schema 定义内置条目与能力声明providers 层负责密钥识别、校验与 OpenAI 兼容请求封装desktop 层负责 IPC 输入校验与引导流程串联。理解了这一套“注册 → 引导 → 校验 → 发现 → 出站请求”的闭环你也就掌握了该仓库接入任意 OpenAI 兼容提供商包括自建网关的完整方法论。赞分享人工智能AI 应用桌面应用【免费下载链接】open-codesignOpen-source Claude Design alternative. One-click import your Claude Code / Codex API key. Prompt → prototype / slides / PDF. Multi-model (Claude, GPT, Gemini, Kimi, GLM, Ollama). BYOK, local-first, MIT.项目地址https://gitcode.com/gh_mirrors/op/open-codesign点击查看免费下载相关推荐AIRI 接入 Novita AI 聊天模型OpenAI 兼容提供者配置与校验机制详解AIRI 接入 Novita AI 聊天模型OpenAI 兼容提供者配置与校验机制详解 本文是一份面向 AIRI 用户的实操指南讲解如何将 Novita AAI 应用人工智能大模型数字人AI Agent语音前端后端桌面应用移动开发即时通讯3D渲染AIRI 接入 Atlas CloudOpenAI 兼容 Chat 提供方配置与源码级验证机制解析AIRI 接入 Atlas CloudOpenAI 兼容 Chat 提供方配置与源码级验证机制解析 本篇指南讲解如何在 AIRI 中接入 Atlas ClouAI 应用人工智能大模型数字人AI Agent语音前端后端桌面应用移动开发即时通讯3D渲染OpenClaw GMI Cloud 提供商插件接入指南OpenAI 兼容 API 一键托管多厂商模型OpenClaw GMI Cloud 提供商插件接入指南OpenAI 兼容 API 一键托管多厂商模型 GMI Cloud 是一个托管推理平台以 OpenAAI 应用AI Agent交互助手后端即时通讯网关上一篇Visual Syslog ServerWindows平台专业级日志监控解决方案下一篇如何用Zettelkasten开源工具构建高效知识管理系统3个简单步骤解放你的大脑创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/11/17 4:28:22

电工证没有复查怎么办?全国通用证件也能影响薪资前景

电工证没有复查怎么办?全国通用证件也能影响薪资前景 学历不高怕报不上名?很多人一想到特种作业证,尤其是电工证,就觉得门槛高、流程复杂,甚至担心一旦没有复查就会影响工作机会。其实,只要搞清楚电工证的复查流程,全国通用的证件照样能为你打开高薪的…

2026/11/17 4:28:22

初级电工证操作千万别踩坑,新手怎么一步到位?

初级电工证操作千万别踩坑,新手怎么一步到位? 你刚毕业或者打算转行,正愁找不到工作?别急, 急需特种作业证才能上岗找工作 ,初级电工证操作就是你最该优先办理的证件之一。但很多人在报考过程中踩坑,不是资料准备不全,就是流程搞错了,耽误了时间和…

2026/11/17 4:28:22

宜昌审电工证过期了怎么处理?值不值得考还得看这几点

宜昌审电工证过期了怎么处理?值不值得考还得看这几点 证书过期了不知道怎么复审延期?不少在宜昌从事电工工作的朋友都遇到过这种情况,特别是像低压电工、高压电工这类特种作业操作证,一旦到期没有及时复审,就相当于“断了饭碗”,不仅影响日常工作,还可…

2026/11/17 4:28:22

低压电工证月薪多少?真实经历告诉你别怕考不过白交培训费

低压电工证月薪多少?真实经历告诉你别怕考不过白交培训费 怕考不过白交培训费?我认识一个郑州应届工程类毕业生,花了几千块报了个低压电工证培训班,结果因为没好好复习,考试直接挂了,最后培训费打水漂,心态差点崩掉。今天就来聊聊低压电工证月薪多少、…

2026/11/17 4:23:21

权威的高级电工证证丢了怎么补办

河南电工证丢了怎么补办?2026年新规来了!周口从业者必看 你是不是也遇到过这种情况?手里拿着一份电工证,想着找份稳定的工作,结果一到单位就被要求查证,才发现证书找不到了。这事儿说大不大,说小不小, 急需特种作业证才能上岗找工作…

2026/11/16 7:29:52

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/16 5:30:20

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/17 0:02:41

电工证操作和资格证有效期多久?真实经历告诉你怎么复审延期

电工证操作和资格证有效期多久?真实经历告诉你怎么复审延期 证书过期了不知道怎么复审延期,这种情况在电工圈里太常见了。我有个同事,去年刚把低压电工证给弄丢了,直到单位查岗才发现证书已经过期,差点被停工处理。今天就用我真实经历给你讲讲电工证操作…

2026/11/17 0:02:41

机修需不需要电工证 在哪考最靠谱 这些细节必须知道

机修需不需要电工证 在哪考最靠谱 这些细节必须知道 之前考的证在外省能不能转过来?这个问题几乎每个特种作业从业者都问过。特别是像你这样,之前在外省考了证,现在想在本地扎根,或者想换证、换岗的机修人员,最关心的就是【机修需不需要电工证】和【在…

2026/11/17 0:02:41

工地太忙根本没时间复习考试?真实经历告诉你电工证年检步骤是什么

工地太忙根本没时间复习考试?真实经历告诉你电工证年检步骤是什么 工地太忙根本没时间复习考试,我理解你。作为一名刚从焦作工程类院校毕业的学生,我也经历过这种困扰。电工证年检步骤是什么,听起来简单,但实际操作中,很多人因为流程不清楚、资料准备不…

2026/11/17 0:49:41

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/16 3:17:47

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑