
## 🎉 版本亮点

`micro-one-api` v0.10.0 是一次重大功能更新，主要引入两大核心功能：

### 🚀 独立模型管理系统

经过 4 个 Sprint 的迭代开发，我们完整实现了独立的模型管理系统：

- **按账户模型映射**：每个账户可独立配置可用模型列表
- **通配符模型匹配**：支持 `*` 通配符进行灵活的模型匹配
- **模型别名管理**：为复杂模型名称提供简洁易用的别名
- **使用统计分析**：详细的模型调用统计和用量分析
- **缓存性能优化**：`/v1/models` 端点响应缓存，提升性能
- **大小写不敏感**：模型 ID 匹配支持大小写不敏感

这个系统彻底解决了多渠道模型管理的复杂性，让管理员可以精细控制每个账户能使用哪些模型，如何进行模型选择，以及如何统计分析模型使用情况。

### 🇨🇳 国内订阅账户支持

新增对国内主流编程计划订阅账户的支持：

- **智谱 GLM**：完整支持 GLM 系列模型
- **MiniMax**：支持 MiniMax 各类模型  
- **Kimi**：支持 Moonshot Kimi 模型

核心功能包括：
- 动态模型发现：通过 `/v1/models` 端点动态获取各平台可用模型列表
- 配额状态查询：实时显示上游平台配额使用情况
- 路由恢复探测：自动探测和恢复最优路由
- 订阅账户管理：完整的订阅账户生命周期管理

### 🔒 安全漏洞修复

- 修复 OpenTelemetry 安全漏洞（GO-2026-5158）
- 修复 4 个 Web 前端依赖安全告警
- govulncheck 和 gosec 验证通过

## v0.10.0 详细特性

### 模型管理系统

经过 4 个 Sprint 的迭代开发，模型管理系统现已完整实现：

**Sprint 1 - 独立模型管理系统基础架构**
- 实现独立模型管理系统设计（方案B）
- 创建完整的后端 API 和数据模型
- 建立模型映射、账户配置的核心逻辑

**Sprint 2 - 模型管理前端界面**
- 实现完整的 Web 前端管理界面
- 模型列表、账户配置、映射关系可视化
- 代码审查反馈的修复和优化

**Sprint 3 - 模型管理集成**
- 模型管理系统与网关核心集成
- 路由逻辑、负载均衡、账单统计集成
- 端到端功能验证

**Sprint 4 - 高级功能完善**
- 模型使用统计分析
- 模型别名管理
- 大小写不敏感匹配优化
- 缓存性能优化

**核心功能特性：**
- **按账户模型映射**：每个账户可独立配置可用模型列表
- **通配符匹配**：支持 `*` 通配符进行模型匹配（可通过 `RestrictModels` 开关控制）
- **模型别名**：为复杂模型名称提供简洁别名
- **使用统计**：详细的模型调用统计和用量分析
- **缓存优化**：`/v1/models` 端点响应缓存，提升性能
- **大小写不敏感**：模型 ID 匹配支持大小写不敏感

### 国内订阅账户支持

**新增平台支持：**
- **智谱 GLM**：完整支持 GLM 系列模型
- **MiniMax**：支持 MiniMax 各类模型
- **Kimi**：支持 Moonshot Kimi 模型

**核心功能：**
- **动态模型发现**：通过 `/v1/models` 端点动态获取各平台可用模型列表
- **配额状态查询**：实时显示上游平台配额使用情况
- **路由恢复探测**：自动探测和恢复最优路由
- **订阅账户管理**：完整的订阅账户生命周期管理

**技术实现：**
- 专门的订阅账户路由策略
- 智能配额层级排序
- 流式用量解析优化（支持 Anthropic cache tokens）
- 错误恢复和重试机制

## 微服务架构

当前主要服务包括：

| 服务 | 说明 |
|------|------|
| `relay-gateway` | OpenAI 兼容 API 网关，负责鉴权、选路、金额预扣和上游转发 |
| `admin-api` | 管理后台 BFF，并托管或代理管理前端 |
| `identity-service` | 用户、角色、登录鉴权和 Token 校验 |
| `channel-service` | 渠道、模型、分组、优先级和可用渠道选择 |
| `billing-service` | 钱包余额、账务流水、兑换码、支付订单和扣费结算 |
| `config-service` | 动态配置管理 |
| `log-service` | 业务日志写入、查询和删除代理 |
| `monitor-worker` | 监控任务与告警触发 |
| `notify-worker` | 通知发送 |

这种拆分的好处是边界比较明确：网关只关心请求链路，用户服务处理身份，渠道服务处理路由，账务服务处理钱包余额，后台服务面向运营入口。后续如果要替换某个模块，也不会影响整个系统。

## 快速体验

项目支持 Docker Compose 启动，适合本地开发和功能验证：

```bash
cd deployments/docker-compose
cp .env.example .env
# 编辑 .env，至少替换数据库、Redis 和服务密钥
docker compose up -d
```

启动后可以访问：

- 管理后台：`http://localhost:3000`
- Relay API：`http://localhost:8080`
- 健康检查：`http://localhost:8080/healthz`

调用示例：

```bash
curl -X POST http://localhost:8080/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${API_TOKEN}" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "Hello"}
    ]
  }'
```

## 升级说明

⚠️ **v0.10.0 包含数据库迁移，必须执行 `make migrate`**
⚠️ **开发者需执行 `make init && make proto`**
⚠️ **建议清除浏览器缓存**

```bash
# 拉取版本
git fetch --tags
git checkout v0.10.0

# 开发者环境：重装工具链并重新生成 proto
make init
make proto

# 部署环境：执行数据库迁移
make migrate

# 重新构建镜像并启动
docker compose build
docker compose up -d
```

## 适合哪些人

这个项目比较适合：

- 想统一管理多个 AI 模型供应商的开发者或团队。
- 想研究 AI API 网关、钱包账务系统和渠道调度的工程实现者。
- 想把 one-api 类系统拆成微服务架构的人。
- 需要内部 Token、钱包余额、用量统计和管理后台的团队。
- 正在搭建 AI 中台、模型网关或内部开发者平台的团队。
- **v0.10.0 新增**：需要精细化管理多模型、多账户使用的团队。

如果你只需要一个极简个人代理，完整微服务架构可能会显得偏重；如果你关注长期运营、多人管理、账务和扩展性，它会更有参考价值。

## 项目边界和合规提醒

`micro-one-api` 只提供软件实现，不提供任何第三方模型服务、账号、订阅、API Key 或绕过访问限制的能力。

部署者需要自行确保：

- 上游 API Key、账号或订阅来源合法。
- 调用内容符合当地法律法规和上游服务条款。
- 不把项目用于违规转售、滥用、攻击、垃圾信息或绕过平台限制。
- 正确保护用户数据、请求内容、响应内容、日志、账务数据和支付凭证。
- 生产环境替换默认密钥，配置 HTTPS、限流、访问控制和日志审计。

项目的完整免责声明可以查看仓库中的 `DISCLAIMER.md`。

## 后续方向

v0.10.0 发布后，我们计划继续扩展：

- 模型管理高级功能（批量操作、导入导出）
- 更多国内平台订阅账户支持
- 模型使用成本分析和优化建议
- 进一步性能优化和缓存策略改进
- 增加更多原生 provider 适配器
- 完善渠道健康检查和自动熔断
- 强化用量统计、成本分析和对账能力
- 增加更细粒度的用户、团队、分组和模型权限
- 完善前端运营体验和可观测性面板
- 加强生产部署文档、安全基线和高可用方案

## 如何参与

如果你对项目感兴趣，欢迎通过以下方式参与：

- 🐛 [报告问题](https://github.com/mengbin92/micro-one-api/issues)
- 💡 [功能建议](https://github.com/mengbin92/micro-one-api/discussions)
- 🔄 [提交 PR](https://github.com/mengbin92/micro-one-api/pulls)
- 📖 [查看文档](https://github.com/mengbin92/micro-one-api/tree/main/docs)
- 🌟 [GitHub Star](https://github.com/mengbin92/micro-one-api)

micro-one-api v0.10.0 是一次重大功能更新，主要引入两大核心功能：

Micro-One-API v0.10.0 发布：模型管理系统 + 国内订阅账户支持

micro-one-api v0.10.0 是一次重大功能更新，主要引入两大核心功能：模型管理系统 + 国内订阅账户支持

后端

micro-one-api v0.10.0发布重大更新，新增独立模型管理系统和国内订阅账户支持。模型管理系统提供账户级模型配置、通配符匹配、别名管理等功能，支持智谱GLM、MiniMax、Kimi等国内主流AI平台。该版本优化了缓存性能，修复安全漏洞，适合需要统一管理多模型供应商的团队。

微服务架构

漏洞修复

日志审计

代码解释

负载均衡

数据库

Docker

路由

Redis

2026上云采购 | AI焕新·智启新局

apigw

cngw

timatrix

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Micro-One-API v0.10.0 发布：模型管理系统 + 国内订阅账户支持-腾讯云开发者社区-腾讯云

Micro-One-API v0.10.0 发布：模型管理系统 + 国内订阅账户支持

Micro-One-API v0.10.0 发布：模型管理系统 + 国内订阅账户支持

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐