v0.3.0 — Maintenance Mode（可审查的软件工程作品）

qoder-proxy-api 完成 Phase 0-4，进入冻结维护。本项目从此不再作为开发项目管理，而是作为可验证、可复现、可审查的软件工程作品长期维护。

30 秒审查路径

pnpm install && pnpm demo   # 无凭证看到三协议流式 wire
pnpm test                    # 89 用例全绿

README 依次回答：它解决什么 → 架构为什么这样设计（含 Design Decisions 三问）→ 怎么运行 → 怎么验证 → 边界在哪。

证据体系

• 89 个离线测试：provider 合同套件、三协议 golden、差分校验、故障注入、对抗审查闭环
• 验证矩阵四维分组（Protocol / Streaming / Provider / Failure），每格标注 verified / fixture verified（抓包·参考差分·合成）/ experimental / unverified，逐格可追到测试记录
• 已知缺口诚实清单：gateway 全链路 experimental、目录静默兜底、malformed SSE wart

Maintenance Mode

只接受缺陷修复、文档校准与真实凭证的 live smoke 结果更新；不新增 Provider、不做功能扩张。规则见 docs/07。

Full Changelog: https://github.com/ggbdpq/qoder-proxy-api/blob/develop/CHANGELOG.md

v0.2.4 — 对抗式审查闭环

Adversarial Review Loop 闭环：把审查发现的边界场景逐条转化为可复现证据。

• 认证回退失败统一 PROVIDER_AUTH_ERROR 通道（修前抛裸 TypeError）
• 流响应 200 空 body 行为显式化：undici 空流场景干净结束（测试锁定），null 场景显式 PROVIDER_PROTOCOL_ERROR
• 删除消息映射死代码（name 透传）；测试数 89；docs/06 补对抗审查行

Full Changelog: https://github.com/ggbdpq/qoder-proxy-api/blob/develop/CHANGELOG.md

v0.2.3 — Phase 0-2 完整发布（TypeScript 三协议网关）

本地多 Provider 协议网关：下游暴露 OpenAI Chat / Responses 与 Anthropic Messages 兼容 API（支持流式），上游适配三条互相隔离的 Qoder 链路（Gateway 私有协议 / qodercli 子进程 / Cloud Agents 官方 API）。

亮点

• 零构建 TypeScript：Node 24 原生 type stripping 直接运行，tsc strict 0 错误，运行时依赖为零
• 86 个离线测试：provider 合同套件、三协议 golden、差分校验、abort/timeout/错误映射，CI 六步质量门
• 无凭证离线 demo：pnpm install && pnpm demo，30 秒看到三协议流式 wire
• 验证矩阵：每个能力标注 verified / fixture verified（抓包·参考差分·合成）/ experimental / unverified，逐格可追到测试记录（docs/06）

Phase 对应

版本	Phase	内容
v0.2.0	Phase 0	TypeScript 迁移、测试公开、CI 质量门
v0.2.1	Phase 1	无凭证离线 demo，路由与流错误修复
v0.2.2	Phase 2	架构文档 8 篇、验证矩阵、提交与分支约定
v0.2.3	Phase 3	CHANGELOG、README 首屏收口、Topics

边界（诚实声明）

Gateway / CLI 链路涉及客户端私有协议，行为随官方客户端升级可能漂移；Gateway 全链路为实验性（协议形状级验证），tools / thinking 未真机验证。与 Qoder 官方无任何关联，不实现账号池、额度共享或限流绕过。完整分级见 docs/06-测试与验证矩阵。

Full Changelog: https://github.com/ggbdpq/qoder-proxy-api/blob/develop/CHANGELOG.md

v0.2.0 三链路协议网关

口径校准（2026-10-01）：本版本当时的“已真实账号端到端验证”表述，已被后续更严格的验证策略修正——Gateway 现标为 experimental（有实现与离线测试，端到端未完成验证）。能力口径以 v0.3.0 的 verification matrix 为准。

三链路协议网关

针对「反代的 Cloud Agents 接口和客户端不一样」的问题：本版本默认直接适配 Qoder 客户端 Gateway 私有协议，并保留原两条链路。

Phase 0 · TypeScript 与质量门

• 58 个 .js/.mjs 统一迁移为 .ts：Node 24 原生 type stripping，零构建，运行时依赖保持为零；tsc strict 0 错误
• 公开全部离线测试与 fixtures（86 用例）：provider 合同套件、三协议 golden、差分校验、abort/timeout/错误映射
• CI 六步质量门：install → typecheck → lint → format:check → architecture check → test（Node 24 固定）
• 上游超时跨链路对齐：gateway 认证交换补 requestTimeoutMs 约束，cloud 超时统一 PROVIDER_TIMEOUT

---

注：本页正文于 2026-10-01 口径校准时依 CHANGELOG v0.2.0 重建，事实口径与 CHANGELOG 一致。