## 摘要

本文整理 `micro-one-api` 紧接在 v0.10.0（模型管理系统 + 国内订阅账户）之后发布的两个补丁版本：**v0.10.1** 和 **v0.10.2**。两个版本都围绕 v0.10.0 引入的模型管理与国内订阅账户在实际生产中暴露的问题做收口，没有新功能堆叠，而是把"能命中、命中得准、上游不报错"这三件事做扎实。

| 版本 | 日期 | 类型 | 关键词 |
|------|------|------|--------|
| [v0.10.1](#v0101) | 2026-07-25 | PATCH | 国内订阅账户路由修复、上游模型 ID 保留、渠道模型自动发现、安全告警收敛 |
| [v0.10.2](#v0102) | 2026-07-26 | PATCH | 统一上游模型路由、上游模型 ID 精确化、GLM 工具 Schema 422 修复 |

v0.10.1 范围覆盖 3 次核心提交、51 个文件、+903/-181 行；v0.10.2 覆盖 4 次提交（含 1 个 admin feat 与 1 个 docs）、48 个文件、+1877/-280 行。

两个版本都**没有 API 破坏性变更**：v0.10.1 无数据库迁移、无端点增删；v0.10.2 含一个幂等可重入迁移（`066_add_upstream_model_ids.sql`，仅新增 `NOT NULL DEFAULT ''` 列并回填），proto 仅新增字段与一个内网 gRPC 方法。从 v0.10.0 平滑升级即可。

---

## v0.10.1

> 2026-07-25 · 上一版：[v0.10.0](./release-v0.10.0.md)（2026-07-25）

v0.10.1 聚焦修复 v0.10.0 发版后暴露的 3 个问题：国内订阅账户（智谱 GLM \/ MiniMax \/ Kimi）路由无法命中、上游模型 ID 在大小写不敏感匹配时丢失、以及 gosec / Dependabot 安全告警。无新增业务表迁移，无 API 破坏性变更，无端点增删。

### 亮点

- **国内订阅账户能用了**：GLM / MiniMax / Kimi 账户在 v0.10.0 里配置后实际请求会报 `no available channel`，本版修复平台前缀映射与粘性会话校验逻辑后，国内账户能被正确调度。
- **上游模型 ID 不再被改写**：路由命中后保留渠道配置的大小写拼写，避免被上游因大小写差异拒绝或路由到错误模型；同时新增 API-key 渠道模型列表自动发现，创建渠道时不用再手动查上游文档回填。
- **安全告警清零**：gosec G115 整数溢出、grpc / react-router / brace-expansion / postcss / @hono/node-server 的 CVE / GHSA 全部收敛。

### 变更内容

**Fixed**

- `subscriptionPlatformsForModel`：新增 `glm-` → `zhipu`、`minimax-`/`minimaxm-` → `minimax`、`kimi-`/`k3` → `kimi` 前缀映射；默认分支返回 `nil` 而非硬编码 `["codex","claude"]`，明确"模型前缀是路由提示而非硬边界"。
- `selectSubscriptionAccountForModel`：无前缀提示时直接走 abilities 表调度；有前缀但全部失败时回退到无 platform 的 abilities 调度，允许显式跨平台 ability 或 model mapping 覆盖约定。
- `stickySubscriptionAccountValid`：改为"显式 `Models` 列表是真相源，支持运维定义别名；仅当账户没有模型列表时才从 platform 推断"，移除强制 platform 校验。
- 错误映射新增 `subscription account not found` 也按 503 `no available channel` 返回，避免客户端误判为 500。
- `ResolveChannelModel`：替代原 `applyPerAccountModelMapping` 的单点调用，统一 `RelayPlan` / `SelectSubscriptionFailover` 等 5 处模型解析。规则：显式 per-channel mapping 权威；否则保留渠道配置的大小写拼写；通配符 abilities 仅用于路由，永远不会作为模型 ID 发出。
- `accountServesModel`：`==` 改为 `strings.EqualFold`，与大小写不敏感匹配语义一致。
- gosec G115：4 处 `int32(...)` 强转改为 `safecast.Int64ToInt32Saturating`。
- `google.golang.org/grpc` v1.81.1 → v1.82.1（GHSA-hrxh-6v49-42gf）。
- `react-router-dom@7.18.1` → `react-router@8.3.0`（v8 移除 `react-router-dom` 包，20 个文件 import 改为 `react-router`，GHSA-qwww-vcr4-c8h2）。
- web overrides：brace-expansion ^5.0.7→^5.0.8、postcss ^8.5.15→^8.5.18、@hono/node-server ^2.0.5。

**Added**

- `ChannelModelProbeService`：创建 API-key 渠道时若模型列表为空，异步通过上游 `/v1/models` 端点发现并回填模型列表。best-effort 设计——探测失败时保留新建渠道不动，运维仍可手动填写；带 `markPending` 去重，避免同一渠道并发探测。
- 前端 `ModelMultiSelect` 支持 `CreatableSelect` 的 `createOption` 回写与受控输入，配合自动发现的模型即时出现在下拉中。

### 兼容性与回滚

- HTTP 客户端协议完全向后兼容，所有 `/v1/*` 接口行为不变。
- gRPC proto 无变更，数据库无新增迁移。
- 升级后 GLM / MiniMax / Kimi 模型请求将正确路由；已配置显式 `Models` 列表的账户在粘性续约时不再被误判不可用。
- 前端 react-router v8 改变了 import 路径，自有二次开发需同步调整 `react-router-dom` → `react-router` 的 import。

---

## v0.10.2

> 2026-07-26 · 上一版：[v0.10.1](#v0101)（2026-07-25）

v0.10.2 聚焦解决 v0.10.0 / v0.10.1 引入模型管理与国内订阅账户后在实际生产中暴露的若干模型路由问题：API-key 渠道与订阅账号之间的优先级被硬编码、上游模型 ID 未能精确映射导致命中错误供应商、以及 GLM（智谱）等 Anthropic 兼容上游对 Responses API 自定义工具的 `input_schema` 严格校验导致 422。含数据库迁移（幂等可重入），无 API 破坏性变更（仅新增 proto 字段与一个内部 gRPC 方法），无端点增删。

### 亮点

- **API-key 渠道与订阅账号同层竞争**：此前订阅账号只能作为 API-key 渠道全部失败后的兜底，无法按配置的 `priority` 同层竞争。本版引入 `UpstreamRouteSelector`，跨 API-key 渠道与订阅账号统一应用优先级分层，再在获胜层内做平滑加权轮询。
- **上游模型 ID 精确化**：为 `model_channel_mapping` 与 `model_subscription_mapping` 新增 `upstream_model_id` 列（迁移 066，幂等回填），让同一公开模型在不同上游可用不同精确标识（如 NVIDIA 上游是 `z-ai/glm-5.2`）。
- **GLM 工具 Schema 422 修复**：Codex 的 `apply_patch`、`web_search` 等 Responses API 自定义工具不带 `parameters` schema，转换到 Anthropic 兼容请求时 `input_schema` 被透传为 `null`，被智谱 GLM 等上游校验拒绝。本版统一回退为 `{"type":"object","properties":{}}`。
- **管理后台渠道删除入口 + 跨平台部署文档沉淀**。

### 变更内容

**Added**

- `internal/biz/upstream_selector.go`：`UpstreamRouteSelector` 跨 API-key 渠道与订阅账号统一应用优先级分层（取最高 `priority` 的候选层），再在获胜层内做平滑加权轮询（Smooth Weighted Round-Robin，复用经典 nginx 算法）。带 4096 scope 上限的内存状态，避免长跑泄漏。
- `Channel` DO 新增 `Weight uint32` 与 `UpstreamModelID string`，`SubscriptionAccount` DO 新增 `UpstreamModelID string`，让权重与精确上游 ID 流经整个调度链。
- `upstream_model_id` 列（迁移 `066_add_upstream_model_ids.sql`）：为 `model_channel_mapping` 与 `model_subscription_mapping` 新增 `upstream_model_id varchar(255) NOT NULL DEFAULT ''`，幂等回填：从 `abilities` / `subscription_account_abilities` 中按大小写不敏感匹配把已配置的真实模型名写入新列。postgres / sqlite 对应迁移保持三套 schema 同步。
- proto：`ModelChannelMapping.upstream_model_id`、`ModelSubscriptionMapping.upstream_model_id`、`UpsertChannelModelMappingRequest.upstream_model_id`、`UpsertSubscriptionModelMappingRequest.upstream_model_id`、`ChannelInfo.upstream_model_id`、`SubscriptionAccountInfo.upstream_model_id` 均为新增字段，向后兼容。
- 文档 `docs/model-pricing-follow-up.md`：明确"用户价格用公开小写模型名、上游真实 ID 只用于路由映射"的约定与后续清理计划。
- 前端 `ModelDetailPanel`、`PricingPage`、`LogsPage` 配合展示上游模型 ID 与定价候选。
- `web/src/pages/admin/ChannelsPage.tsx` 渠道操作区新增 Delete 按钮（Trash2 图标 + 确认弹窗），复用既有 `DELETE /api/channel/{id}`。
- AGENTS.md 记录 arm64→x86_64 的 buildx 跨构建 + scp + docker load 标准流程、service→Dockerfile/path 映射表、buildx builder 一次性设置、前端 `web/dist` 挂载卷部署注意事项与验证/配置重启片段。

**Changed**

- `RelayUsecase.Plan` 重写为"粘性会话优先 → 否则并行尝试 API-key 渠道与订阅账号 → 用 `UpstreamRouteSelector` 在同优先级层裁决"。订阅账号不再硬编码为兜底，能与渠道按 `priority`/`weight` 公平竞争。

**Fixed**

- `internal/apicompat/responses_to_anthropic_request.go`：`web_search` / `google_search` / `web_search_20250305` 分支以及 default 分支（Codex `apply_patch` 等自定义工具）统一走 `normalizeAnthropicInputSchema`，无 schema 时回退为 `{"type":"object","properties":{}}`，杜绝 `input_schema: null`。
- `internal/server/http_adaptor.go`：订阅账号上游返回非 2xx 时，新增 `zap.Warn` 记录 `status_code` / `platform` / `channel_id` / `subscription_account_id` / `model` 与脱敏截断（2048）后的上游错误体，便于定位 422 类上游校验问题。

### 兼容性与回滚

- **API**：无破坏性变更；仅新增 proto 字段与一个内部 gRPC 方法 `GetSubscriptionAccountWithSecrets`，旧客户端无感知。
- **数据库**：有迁移（`066`），新增列均为 `NOT NULL DEFAULT ''`，幂等可重入。升级前建议备份 `model_channel_mapping` / `model_subscription_mapping`。
- **路由行为变化**：升级后，配置了更高 `priority` 的订阅账号将与 API-key 渠道同层竞争，不再被强制降级为兜底。若希望保持"渠道优先、订阅兜底"旧行为，把订阅账号 `priority` 调到低于目标渠道即可。
- **上游模型 ID 回填**：迁移会自动从 abilities 回填，但仅有大小写不敏感匹配命中的行会被填充；未命中的行保持空串，relay 会回退到渠道配置的模型名，行为与 v0.10.1 一致。
- **开发者**：proto 新增字段与内部 gRPC 方法需 `make proto` 重新生成；该 RPC 仅在服务内网使用，响应含解密密钥。

---

## 整体升级路径（v0.10.0 → v0.10.2）

从 v0.10.0 直接升级到 v0.10.2 时，只需注意一个迁移节点：

### 1. v0.10.2 数据库迁移（必读）

`066_add_upstream_model_ids.sql` 为两张 mapping 表新增 `upstream_model_id` 列，默认空串，并幂等回填已配置 abilities 中的真实模型名。必须执行 `make migrate`。升级前建议备份 `model_channel_mapping` / `model_subscription_mapping`。

### 2. 路由行为变化（必读）

升级后订阅账号参与同优先级层竞争。若你的环境希望保持"渠道优先、订阅兜底"旧行为，请把订阅账号 `priority` 调到低于目标渠道即可，无需改代码或配置开关。

### 快速升级命令

```bash
git fetch --tags
git checkout v0.10.2

# 开发者环境：重新生成 proto（pb.go 不入库）
make init
make proto

# 部署环境：应用迁移 + 重建镜像 + 滚动重启
make migrate
docker compose build
docker compose up -d
```

从 v0.10.1 升级到 v0.10.2 同样需要执行迁移；从 v0.10.0 升级则一次性跳到 v0.10.2 即可，中间不需要单独跑 v0.10.1。

前端构建 `cd web && npm run build`；如使用挂载卷部署，按 AGENTS.md 前端流程单独 scp `web/dist`，无需重启容器。

---

## 验证

两个版本发布前均已确认：

```bash
# v0.10.1
go build / go vet / go test          # 全部通过
internal/biz/relay_test.go           # 新增国内平台路由与粘性账户校验用例
internal/server/http_response_test.go# 新增 subscription account not found → 503 映射用例
app/channel/internal/service/channel_model_probe_test.go # 覆盖自动发现 best-effort 行为
web: npm build / test(90) / lint     # 全部通过

# v0.10.2
go build / go vet / go test          # 全部通过
internal/biz/upstream_selector_test.go        # 覆盖优先级分层与平滑加权轮询
internal/biz/relay_test.go                    # 更新覆盖新调度路径（渠道 vs 订阅账号同层裁决）
internal/apicompat/anthropic_responses_test.go# 断言所有工具 input_schema 为 object 且不含 null
internal/server/http_adaptor_test.go         # 覆盖上游拒绝告警路径
app/channel/internal/data/model_test.go 等    # 覆盖上游模型 ID 读写与探测
web: npm build / test / lint                 # 全部通过（含 LogsPage、PricingPage 新增用例）
```

## 完整变更日志

**v0.10.1**

- 1432797 fix(relay): route domestic subscription accounts
- fb14e81 fix(deps): resolve dependabot & code-scanning security alerts
- ea6b3cc fix: preserve upstream model IDs and discover channel models

**v0.10.2**

- b8cd79b feat(admin): add channel delete button to channels page
- 11a1cb9 docs(agents): document cross-platform deploy workflow (arm64 dev -> x86_64 server)
- d175497 fix: unify model routing across upstream providers
- 3a47d6c fix(relay): prevent GLM tool schema 422 errors

## 结语

v0.10.0 把模型管理系统和国内订阅账户支持一次性铺开，覆盖面很大，但也意味着上线后会被真实流量迅速暴露细节问题。v0.10.1 和 v0.10.2 这两个补丁版本不追新功能，而是把 v0.10.0 引入的能力在生产里跑通：国内账户能命中、命中得准（上游模型 ID 精确化）、上游不报错（GLM 工具 Schema 422）、并且 API-key 渠道与订阅账号能在同一优先级层公平竞争。

值得一提的是，v0.10.2 的统一上游路由选择器把"订阅账号只能兜底"这个隐式约束改成了显式的 `priority`/`weight` 竞争，这对运维侧是行为变化——升级时请留意订阅账号的优先级配置。

后续版本计划：模型管理高级功能（批量操作、导入导出）、更多国内平台订阅账户支持、模型使用成本分析和优化建议、进一步性能优化和缓存策略改进。

欢迎关注、试用和参与改进：[github.com/mengbin92/micro-one-api](https://github.com/mengbin92/micro-one-api)

本文整理 micro-one-api 紧接在 v0.10.0（模型管理系统 + 国内订阅账户）之后发布的两个补丁版本：v0.10.1 和 v0.10.2。两个版本都围绕 v0.10.0 引入的模型管理与国内订阅账户在实际生产中暴露的问题做收口，没有新功能堆叠，而是把"能命中、命中得准、上游不报错"这三件事做扎实。

Micro-One-API v0.10.1 & v0.10.2 发版公告：模型路由收口，订阅账户可用

后端

micro-one-api发布v0.10.1和v0.10.2补丁版本，修复国内订阅账户路由问题，优化模型ID精确映射，解决GLM工具Schema422错误。新增上游模型ID列，支持API-key渠道与订阅账号同层竞争，提升路由命中率。版本无API破坏性变更，建议从v0.10.0直接升级。

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

apigw

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

Micro-One-API v0.10.1 & v0.10.2 发版公告：模型路由收口，订阅账户可用-腾讯云开发者社区-腾讯云

Micro-One-API v0.10.1 & v0.10.2 发版公告：模型路由收口，订阅账户可用

Micro-One-API v0.10.1 & v0.10.2 发版公告：模型路由收口，订阅账户可用

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐