WindsurfAPI 版本演进完全指南从 v2.0 的 OpenAI 兼容层到 v3.9 的 DEVIN_CONNECT 直连切换【免费下载链接】WindsurfAPITurn Windsurf / Devin Desktops 100 AI models (Claude, GPT, Gemini, DeepSeek, Kimi, GLM, SWE) into OpenAI-, Anthropic- Gemini-compatible APIs. Zero-dependency self-hosted reverse proxy for Claude Code, Cline Cursor. 把 Windsurf/Devin 云端 100 模型变成三套兼容 API。项目地址: https://gitcode.com/gh_mirrors/wi/WindsurfAPIWindsurfAPI 是一个零依赖、可自托管的 AI 反向代理项目它把 Windsurf / Devin 云端的 100 AI 模型Claude、GPT、Gemini、DeepSeek、Kimi、GLM、SWE 等变成 OpenAI、Anthropic 与 Gemini 三套标准兼容 API供 Claude Code、Cline、Cursor 等客户端直接使用。本文带你用一张时间线读懂它的版本演进从 v2.0 的 OpenAI 兼容层到 v3.9 完成 DEVIN_CONNECT 直连切换共 189 份发布说明背后的关键里程碑。 版本快照一张表看懂 WindsurfAPI 的迭代规模指标数据发布说明189 份v2.0.6 → v3.9.38git tag200 个当前版本v3.9.382026-09-23运行时依赖0从第一个版本保持至今项目维护着一份非常清晰的 CHANGELOG.md把版本划分为四个阶段见 CHANGELOG.md 的演进图v2.0.x118 个 tag → v3.0–v3.8 → v3.9.0–v3.9.16 → v3.9.17 OpenAI 兼容层成型 Anthropic/Gemini 前端 DEVIN_CONNECT 直连 工具方言·reasoning Dashboard 与账号池 native tool bridge Connect 目录·ACU opt-in版本号遵循语义化版本但有一个特别实践协议兼容性破坏才升 minor修缺陷、加默认关闭的开关都是 patch —— 所以 patch 号跳得很快一个 patch 里可能藏着很重的内容比如 v3.9.21 是 50 个文件、11 条客户端可见缺陷的修复。 第一阶段v2.0.x —— OpenAI 兼容层成型118 个 tagv2.0 系列是项目的基本盘把上游模型的调用能力包装成POST /v1/chat/completions这类 OpenAI 标准接口让任何 OpenAI SDK 改个base_url就能用。这个阶段迭代极快从 v2.0.6 一路到 v2.0.147核心是打磨协议翻译层、缓存键规范、流式错误协议和安全加固。以现存最早的发布说明 docs/releases/RELEASE_NOTES_2.0.6.md 为例这一版就是典型的加固版跨调用方隔离会话池指纹加入callerKey不同 API key 不会复用彼此的隐式会话状态多模态缓存防污染图片/PDF 的 MIME、内容哈希进入缓存键避免同文本不同图片命中旧回答三层流式错误协议Chat 发 OpenAI 结构化错误 SSE、Messages 转 Anthropicevent: error、Responses 转response.failed这一阶段还奠定了项目的安全底线SSRF 后 DNS 校验、日志脱敏、启动时缺鉴权的双语高危警告等后来一直延续。 第二阶段v3.0.0 —— 新章节开启四套兼容 API 就位v3.0.0 被作者称为自项目开始以来最大的一次架构更新见 docs/releases/RELEASE_NOTES_3.0.0.md它确立了今天的产品形态反向代理最新 Devin 云端模型 Native Tool Call原生工具调用视觉/图像理解、OpenAI / Anthropic / Gemini 三套兼容 API 同时可用全新 Dashboard、账号池管理、国际化i18n体系保持纯 Node.js、零 npm 运行时依赖—— 每一行代码可读、可审计、易部署有意思的是v3.0.0 发布说明末尾留了一句关于名字的幽默后端已经在和 Devin 说话前端还带着 Windsurf 的历史 —— 两个生态在此共存。这也是项目名 WindsurfAPI / DevinAPI 并存的由来。 第三阶段v3.1 – v3.8 —— 账号池、工具调用与统计面板这一阶段的主题是可靠性工程让多账号池在限流、熔断、故障转移下稳定工作。v3.1.0修复 DEVIN_CONNECT 路径上 Claude 系模型的原生工具调用被拒问题根因是客户端身份自述触发了上游内容策略于是有了独立的身份中和模块 src/handlers/identity-neutralize.js并引入小账号池 429 锁死缓解机制。v3.2.0统计面板大改版——DEVIN_CONNECT 部署下 Token 用量统计从全零变为真实数据排行榜补充成功率、积分与 p95 延迟维度。v3.8.0DEVIN_CONNECT 路径的系统性修复最有价值的是sticky 缓存亲和合并自 PR #230上游 prompt 缓存按账号隔离、写缓存约为读缓存 10 倍单价不固定账号就等于每轮换号都重写整段上下文。绑定逻辑见 src/account/sticky-session.js详细说明在 docs/releases/RELEASE_NOTES_3.8.0.md。 第四阶段v3.9 —— DEVIN_CONNECT 直连切换的收官v3.9.0 是直连切换路上的里程碑见 docs/releases/RELEASE_NOTES_3.9.0.mdResponses API 真正支持服务端会话previous_response_id此前在代码里零命中、从未被读取导致链式客户端每轮只有 1 条消息到达上游模型盲答却不报错。修复后按callerKey租户隔离、fail-closed 报 404存储实现见 src/response-store.js。账号池止血UPSTREAM_ERROR不再把错在请求的健康账号打出下线并持久化。首次付费 wire 校准跑通挂了几个月的付费 token 校准工具链终于用真实付费账号验证结论归档在 docs/DEVIN-CONNECT-CUTOVER.md。切换本身只有一个关键开关docs/DEVIN-CONNECT-CUTOVER.md 用一张表说清了两个容易混淆的 Devin 开关开关路由到需要二进制DEVIN_CONNECT1Devin 云端 GetChatMessage走纯 HTTP 账号池否✅ 推荐DEVIN_ONLY1本地devinCLI 子进程是无二进制会 503最小切换配置就一行.env里写DEVIN_CONNECT1账号池负责供给 token无需改其他配置。核心实现位于 src/devin-connect.js。随后的 v3.9.1 – v3.9.38 是密集打磨期围绕四条主线见 CHANGELOG.md工具方言与工具前置预算如 v3.9.17 修复 GLM-5.2 拿到会被它忽略的工具方言导致的客户端一直等reasoning 边界v3.9.18 处理上游光想不做的整轮 reasoning、v3.9.35 让 reasoning 回放不被空回合过滤器吞掉Connect 目录按账号同步v3.9.23 起面板列出的模型与实际可调模型合一glm-5.1/glm-5.2别名在 v3.9.30–31 收敛OTA 自更新与 ACU opt-inv3.9.22 的三件套tag 门禁 失败回滚 UIACU 解码^22始终默认关闭v3.9.38当前版本聚焦代理工作区保全与凭据 v1 标签长度固定完整说明在 docs/releases/RELEASE_NOTES_3.9.38.md。 如何追溯某次改动的来龙去脉项目有一套值得学习的历史账本体系新手排查升级问题时非常实用查单版本发布说明一版一份文件名规则固定直接拼路径即可例如 docs/releases/RELEASE_NOTES_3.9.0.md查动机发布说明讲改了什么docs/AUDIT-LEDGER.md 讲怎么发现的、判据是什么、哪些结论后来被推翻了查交接docs/ 下的 HANDOFF 系列记录了每轮交接时的未决项与取舍查索引CHANGELOG.md 只是索引只够你判断这版要不要看权威内容以 docs/releases/ 与固定 tag 为准✅ 小结普通用户该怎么选版本日常使用直接上最新版v3.9.38DEVIN_CONNECT1是当前生产默认后端升级前翻一眼目标版本在 docs/releases/ 的说明重点看运维注意与升级字样段落如 v3.9.30 提到名单里仍写glm-5.1的自动发现客户端会被影响想理解架构从 README.md 的原理图开始再顺着 src/backend-router.js、src/auth.js 看协议路由与鉴权从 118 个 v2.0 tag 的 OpenAI 兼容层到 v3.9 收官的 DEVIN_CONNECT 直连与 0 依赖的自托管形态WindsurfAPI 的版本史就是一部把 100 云端模型变成三套标准 API的协议工程进化史。【免费下载链接】WindsurfAPITurn Windsurf / Devin Desktops 100 AI models (Claude, GPT, Gemini, DeepSeek, Kimi, GLM, SWE) into OpenAI-, Anthropic- Gemini-compatible APIs. Zero-dependency self-hosted reverse proxy for Claude Code, Cline Cursor. 把 Windsurf/Devin 云端 100 模型变成三套兼容 API。项目地址: https://gitcode.com/gh_mirrors/wi/WindsurfAPI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考