【CodeGo】我们把CodeGo-Api开源啦！

首先感谢 New API 项目及其开源社区，为我提供了非常重要的基础和启发。

之前在这个帖子里提到过开源计划：

各位佬友好，CodeGo 正式来 L 站和大家见面了。
经过一段时间的测试和优化，我们决定正式入驻 L 站。新站肯定还有不足，希望大家体验后多提意见，一起交流。
这次准备了两项开站福利：

套餐首次购买 8 折，符合条件时结算页面自动显示折后价。
评论留下用户名或ID，免费送 1 个盲盒。

站点地址：https://shu26.cfd

已接入 LinuxDo 授权登录。

有问题…

现在 codego-api 已完成架构重构和公开版本整理，正式开源：

- GitHub：GitHub - sh2001sh/CodeGo-Api · GitHub

- 官网：https://shu26.cfd/

- Docker Hub：s2644752646/codego-api - Docker Image

codego-api 在new-api的基础上对整体运行架构和代码边界进行了一轮重新整理。

整体架构```

+----------------------+

| control-api |

| 控制面：用户、认证、配置、审计 |

+-----------+----------+

|

+----------------v----------------+

| Shared Infrastructure |

| PostgreSQL / Redis / Temporal |

+------+------+-------------+-----+

| | |

| | |

+---------v--+ | +--------v---------+

| gateway-api| | | workflow-worker |

| 数据面 | | | Temporal 异步任务 |

+------+-----+ | +------------------+

| |

+-------v-------+ |

| Router / | |

| Provider | |

| Adapter | |

+-------+-------+ |

| |

+-------v-------+ |

| Provider APIs | |

| OpenAI... | |

+-------+-------+ |

| |

usage / settlement

|

+--------v---------+

| ledger-worker |

| 额度账本与结算一致性 |

+-------------------+

1. 控制面与数据面分离

- `control-api`：用户、认证、渠道、模型、权限、配置和审计

- `gateway-api`：API 接入、鉴权、路由、Provider 适配和流式响应

管理请求和实际 API 请求不再完全耦合，控制台与 Gateway 可以独立扩展和部署。

2. Provider 适配与路由策略分离

Gateway 内部将以下职责拆开：```

请求接入

   ↓

路由选择 / 渠道选择

   ↓

Provider Adapter

   ↓

协议转换 / 流式响应

   ↓

Provider API
```新增 Provider 时主要扩展对应的 Adapter，不需要修改整个请求链路；路由池、Fallback、限流和渠道健康状态也可以独立演进。

3. 额度处理改为 Ledger + Worker

额度处理不再简单地在请求结束时直接修改余额，而是采用：```

请求预扣

   ↓

Provider 执行

   ↓

记录用量证据

   ↓

生成结算事件

   ↓

ledger-worker 处理账本
```通过账本、幂等结算和用量证据，降低并发请求下重复扣费、漏扣和状态不一致的风险。

4. 长任务独立到 Workflow Worker

长耗时任务、轮询任务和后台流程由 Temporal 管理，并交给独立的 `workflow-worker` 执行。

这样 API 进程不需要长时间等待后台任务，任务重试、超时、恢复和状态收敛更加清晰。

5. 审计和使用日志独立化

使用日志、用量统计、性能指标和审计读模型由独立的 `audit` 模块负责。

请求执行、账务结算和日志查询之间降低耦合，后续可以分别优化写入、投影和查询性能。

6. 后端按领域重新拆分```

identity    用户、Token、认证和会话

adminops    控制面管理操作

gateway     API 接入、路由和 Provider 执行

audit       使用日志、统计和审计

billing     额度账本和结算

commerce    订阅、充值和兑换码

workflow    Temporal 工作流和任务

platform    数据库、缓存、安全和基础设施

- 控制台和 API 请求可以独立扩展

- Provider 扩展成本更低

- 路由策略和协议适配互不干扰

- API 请求、账务和异步任务之间故障隔离更清晰

- 长任务不会阻塞 API 请求进程

- 额度结算更容易保证一致性

- 日志和审计查询可以独立优化

- 更适合 Docker 和多 Worker 部署

- 代码边界更清晰，后续维护和测试更方便

我们这次重构肯定离不开new-api这些前辈大佬的基础，项目目前还在持续更新中，如果有什么需要和问题也欢迎大家的反馈。