本文整理 `micro-one-api` 从 v0.15.0 到 v0.16.0 共 5 个版本的发布内容。这段时间内项目完成了订阅账号 weight 反馈回路闭合、审计平台 actor/request-id 归因链路打通、订阅换组与并发变更的资金加固、relay 流式中断与渠道统计的一系列修复，以及 v0.11.0 路线图（P0–P3）的全部收尾。范围覆盖 `d9dd890..v0.16.0` 共 27 次提交、201 个文件、+6.5k/-1.5k 行。

整个周期没有 API 破坏性变更，也没有新增数据库迁移。v0.16.0 新增 1 个可选配置项（`RELAY_METRICS_ENDPOINT`），其余版本无配置变化。按版本逐一重建镜像并滚动重启即可完成升级。

## 版本总览

| 版本 | 日期 | 类型 | 关键词 |
|------|------|------|--------|
| [v0.15.0](#v0150) | 2026-08-04 | MINOR | 订阅账号 slot 反馈闭环、审计归因链路、前端依赖漏洞修复 |
| [v0.15.1](#v0151) | 2026-08-05 | PATCH | 订阅换组用量保留 + 行锁并发保护、渠道统计去噪 |
| [v0.15.2](#v0152) | 2026-08-05 | PATCH | 渠道统计去噪回归修复、上游流式中断补齐终止事件 |
| [v0.15.3](#v0153) | 2026-08-06 | PATCH | 统一 JSON 序列化层（pkg/jsonx）、收尾 gofmt 规范 |
| [v0.16.0](#v0160) | 2026-08-06 | MINOR | routing-ops 双源指标降级、P1 契约加固、cache-creation charge 切换、v0.16 路线图收尾 |

---

## v0.15.0

v0.15.0 是 **MINOR 功能版本**，完成两件运行时增强：闭合订阅账号 weight 反馈回路（channel selector 的 inflight 计数首次接入 relay 实际占用），以及打通审计平台的 actor / request-id 提取（relay-gateway 与 admin / identity 的敏感操作审计记录从此可归因），并修复前端 4 个 npm 依赖漏洞。

**无数据库迁移、无新增配置项**。新增 1 个 additive proto 字段与 1 个内部 gRPC 方法（`RecordSubscriptionAccountSlot`）。受影响服务为 `relay-gateway`、`channel-service`、`admin-api`、`identity-service`。

### 亮点

- **订阅账号负载反馈闭环（slot feedback / weight loop）**：channel 的账号选择器维护 per-process inflight 计数器来计算 `loadFactor`（用于 weight 降权），但 relay 的 `Acquire`/`Release` 接缝在生产中从未被喂入数据。本版新增 `RecordSubscriptionAccountSlot(account_id, acquired)` gRPC 方法，`relay-gateway` 在 slot 授予时上报 acquire、每次释放时上报 release，fire-and-forget 不阻塞 hot path；`loadFactor` 取 `max(local, crossReplica)`，Redis 与本地视图不再重复计数。
- **审计归因链路（actor + request-id）**：审计中间件此前给每条请求记录空 actor 和空 request_id，无法归因。本版引入可变 `actorHolder`，鉴权层盖戳已校验操作者，中间件在 `next.ServeHTTP` 返回后读取；admin 退款与 identity 登录（成功 / 限流 / 未知用户 / 禁用 / 密码错误）显式记录审计事件，携带真实操作者与 client IP。
- **slot feedback 健壮性**：首轮实现声称 fire-and-forget 但实际同步调用 gRPC；本版改为后台 goroutine 派发 + 200ms 专用超时 + `context.Background()`，并用单个 `sync.Once` 守卫 (acquire, release) 幂等对。

### 变更内容

**Added**

- `api/channel/v1`：新增 `RecordSubscriptionAccountSlot(account_id, acquired)` RPC。
- `app/channel/internal/biz`：`ChannelUsecase.RecordSubscriptionAccountSlot` 转发到选择器的 `Acquire`/`Release`。
- `platform/audit`：标准 actor 上下文键与导出的 `WithActor`/`ActorFrom`；`extractRequestID` 改读平台 request-ID 中间件上下文。
- `app/admin`：退款 handler 显式记录审计成功/失败事件；auditor 经 providerSet + `SetAdminAuditor` 接线。
- `app/identity`：auditor 经 `NewIdentityUsecase(repo, auditor)` 注入；`Login` 记录 `LogUserLogin`。

**Fixed**

- slot feedback 改为真正的后台 goroutine + `sync.Once` 幂等对。
- 前端 4 个 npm 依赖漏洞（hono、undici、fast-uri、brace-expansion）打补丁；移除已弃用的 tsconfig `baseUrl`。
- de-flake relay slot-feedback 测试断言以适配慢速 CI runner。

### 兼容性与回滚

- 新增 RPC 与字段为 additive（序号递增），gRPC/HTTP 向后兼容。
- 无数据库 schema 变更，无配置项删除。
- 回滚到 v0.14.0 镜像即可；slot feedback 降级为权重环路未闭合（选择可能堆叠在忙账号），不影响功能正确性。

---

## v0.15.1

v0.15.1 是 **PATCH 修复版本**，收尾订阅变更链路的最后两项代码审查缺陷：订阅换组（change subscription）的用量窗口只在**真正跨组**时才重置（同组改套餐保留已跑用量），并为 `ChangeSubscription` 增加行锁串行化（`SELECT ... FOR UPDATE`）防止并发变更互相覆盖。

**无数据库迁移、无 API 破坏性变更、无新增配置项**。受影响服务为 `relay-gateway`、`admin-api`、`billing-service`。

### 亮点

- **订阅换组用量窗口仅在跨组时重置**：`ChangeSubscription` 立即生效分支此前无条件清零日/周/月用量——即便用户只是同组内切换套餐，也会丢掉正在累积的用量数据，且允许通过"同价套餐来回切"免费刷新配额。本版改为仅当目标组与当前组不同时才清零；同组套餐变更保留运行中的用量。
- **订阅变更行锁并发保护**：新增可选 `TxRunner`（`SetTxRunner`）；接线后 `ChangeSubscription` 在 `RunInTx` 内执行完整的读-校验-改-写，使用 `GetByIDInTx`（`SELECT ... FOR UPDATE`）串行化，内存/测试模式回退到无锁路径。
- **订阅流量渠道用量统计去噪**：订阅来源（`SourceKind == "subscription"`）流量的 `ChannelID` 是合成值，channel-service 查不到对应渠道，每次 commit quota 都刷 `channel not found` 告警。本版新增 `recordChannelUsageFromDetail` helper，对 subscription 来源直接跳过。

### 变更内容

**Added**

- `SubscriptionUsecase` 新增可选 `TxRunner`（`SetTxRunner`）；`GetByIDInTx` / `UpdateSubscriptionFieldsInTx` 事务作用域方法。
- `admin-api` 接线 `NewTxRunner(repo)`，生产环境订阅变更串行。
- `relay-gateway`：`recordChannelUsageFromDetail` helper + `skipped_channel_stats` 指标。

**Fixed**

- 同组内切换套餐：日/周/月用量保持不变，不再被清零。
- 并发 `ChangeSubscription`：变更串行执行，不再互相覆盖写回。

**已知边界**

- 并发双重扣费未在本版处理（admin 钱包扣款是行锁事务前的独立 RPC，需要请求级幂等）。
- MySQL 对"相同值更新"返回 `RowsAffected==0`，可能被误报为 not-found。
- SQLite 出于设计跳过 `FOR UPDATE`。

### 兼容性与回滚

- 无破坏性 API 变更，无新增迁移，无新增配置项。重建受影响的三个服务镜像并滚动重启即可。

---

## v0.15.2

v0.15.2 是 **PATCH 修复版本**，全部位于 relay-gateway：修复 v0.15.1 渠道统计去噪因赋值顺序反转而完全失效的回归；修复订阅来源 Anthropic 协议上游（如 kimi）流式响应在中断/提前关闭时不发终止事件、导致 codex 客户端报 "stream disconnected before completion" 的三个缺陷；补齐 `response.completed` 之后的兜底 `response.failed` 守卫到 adaptor 路径。

**无数据库迁移、无 API 破坏性变更、无新增配置项**。受影响服务为 `relay-gateway`。

### 亮点

- **渠道统计去噪回归修复**：v0.15.1 的去噪修复上线后告警依然持续。根因是 `applyPlanInputs` 把 `upstreamCostKeyInputsFromPlan` 的两个返回值按错误顺序接收，导致 `SourceKind` 恒为空、`UpstreamModelID` 被写成字面量 `"subscription"`，订阅请求永远无法命中跳过分支。本版按正确顺序接收返回值，订阅流量恢复跳过 channel 维度统计，cost key 恢复正常。
- **上游流中断补齐终止 SSE 事件**：kimi 等上游在三种场景下导致 codex 客户端报流断开——(1) adaptor 路径的 `sseData` 只接受 `data: `（带空格），而 kimi 发送 `data:`（不带空格），数据行被静默丢弃；(2) `scanner.Err()` 分支发了 `response.failed` 但缺 `[DONE]` 哨兵；(3) 上游在 `message_start` 之前关闭时未发任何终止事件。本版同时修复两种 `data:` 前缀、补齐 `[DONE]` 哨兵、合成 `response.failed` 终止事件。
- **adaptor 路径 completed+failed 双终止守卫**：v0.15.1 之前为 fallback 路径加过的 `CompletedSent` 守卫没有同步到 adaptor 路径。上游正常到达终止状态之后再报错时，adaptor 路径会在已发出的 `response.completed` 之上再写一个 `response.failed`——矛盾双终止。本版镜像该守卫。

### 变更内容

**Fixed**

- `applyPlanInputs` 按正确顺序接收 `upstreamCostKeyInputsFromPlan` 返回值（source-kind/upstream-model）。
- `sseData` 同时接受 `data: `（带空格）与 `data:`（不带空格）。
- `scanner.Err()` 分支在终止事件后追加 `[DONE]` 哨兵。
- 提前关闭时合成 `response.failed` 终止事件（adaptor + fallback 双路径）。
- adaptor 路径仅当 `!state.CompletedSent` 才写 `writeResponsesStreamError`。
- 为两条路径补充无空格 SSE 格式、提前关闭、scanner 错误的回归测试。

### 兼容性与回滚

- 无破坏性 API 变更，无新增迁移，无新增配置项。仅重建 relay-gateway 镜像并重启即可。

---

## v0.15.3

v0.15.3 是 **PATCH 版本**，内容为内部重构与代码规范，**无任何对外行为变更**：将全仓库的 JSON 序列化统一收敛到 `pkg/jsonx` 单一封装层（底层 sonic `ConfigStd`，保持 `encoding/json` 语义），消除散落在各模块的 `encoding/json` / 直接 `sonic.*` 调用；并以一次纯机械的 `gofmt -w` 扫描收尾仓库内 50 个不规范 Go 文件的格式债务。

**无 API 破坏性变更、无数据库迁移、无新增配置项、无 proto 变更**。受影响服务为全部后端服务（代码触达面广但均为等价替换）。

### 亮点

- **统一 JSON 序列化层**：仓库此前的 JSON 序列化存在两条互不一致的路径——业务代码广泛使用 `encoding/json`（标准库语义），而性能敏感路径偶发直接调用 `sonic` 包级函数（`ConfigDefault`，不转义、不排序、不拷贝字符串）。两套语义在含 `<` 的字段、map 迭代顺序、解码后复用输入缓冲区等边缘场景会产出不一致结果。本版扩展 `pkg/jsonx` 作为 `encoding/json` 的 drop-in 替代，提供 `Marshal`/`Unmarshal`/`MarshalIndent`/`Valid`/`NewEncoder`/`NewDecoder`/`Get`，将 52 个非测试文件从 `encoding/json` 迁移、53 个文件中的 `sonic.*` 调用收敛到 `jsonx`。
- **JSON 策略文档化**：`AGENTS.md` 新增「JSON serialization」策略章节——业务代码必须用 `jsonx`；非测试代码禁止 `import encoding/json`（除 `pkg/jsonx` 与 `bodylimit.go`）；禁止直接调用 `sonic.*` 包级函数；记录 sonic 的 `compat.go` 版本边界。
- **gofmt 收尾**：一次纯机械 `gofmt -w`，清理 import 分组、结构体字面量对齐、闭包缩进、单行函数展开等约 50 个文件的格式债务。`gofmt -l` 全仓库 clean。

### 变更内容

**Changed**

- `pkg/jsonx`：扩展为 `encoding/json` drop-in 替代，底层 `sonic.ConfigStd`；新增 `Get()` 封装。
- 52 个非测试文件：`encoding/json` → `jsonx`。
- 53 个文件：`sonic.*` / `sonic.ConfigStd.*` → `jsonx.*`。
- `github.com/bytedance/sonic` 升级至 `v1.15.2`。
- `AGENTS.md`：新增 JSON serialization 策略章节。
- 新增 `pkg/jsonx/json_test.go`：一致性、错误行为、`Get`、基准测试。
- `gofmt -w` 扫描约 50 个文件（纯机械，无语义改动）。

**唯一保留**：`platform/middleware/bodylimit.go` 仍用 `encoding/json`——它依赖 `DisallowUnknownFields` 与 `*json.SyntaxError`/`*json.UnmarshalTypeError` 类型断言（sonic 未暴露）。

### 兼容性与回滚

- 纯重构版本，JSON 输出语义与 `encoding/json` 完全一致；此前直接使用 `sonic.ConfigDefault` 的热点路径现在固定为 `ConfigStd` 语义，边缘场景反而更安全。无需重新部署即可获得收益。

---

## v0.16.0

v0.16.0 是 **MINOR 功能版本**，标志着 v0.11.0 路线图收尾阶段（P0–P3）的全部完成。核心交付为一个面向用户的新功能——**routing-ops 双源指标降级**，以及一组契约加固与工程卫生工作。

**无 API 破坏性变更、无数据库迁移、无 proto 变更**。新增 1 个可选配置项（`RELAY_METRICS_ENDPOINT`），新增 1 个直接依赖（`prometheus/common`，从 indirect 提升）。受影响服务为 admin-api。

### 亮点

- **P2.3 — routing-ops 双源指标降级**：`admin-api` 的 `/api/admin/routing-ops` 此前仅依赖外部 Prometheus 获取 relay-gateway 路由指标，Prometheus 未配置或查询失败时返回 `partial=true`，错误率和回退率不可用。本版引入双数据源 + 优雅降级：Prometheus（首选，PromQL `increase()` 精确窗口增量）→ relay-gateway `/metrics` 直连（降级，累计计数器）→ `partial=true`（两者均不可用）。Prometheus 故障时 routing-ops 视图保持 `partial=false`。
- **P1 — 契约加固回归测试**：同优先级精确回退（2 条）、`user_subscriptions` 并发 active 唯一约束（5 条）、订阅粘性收益验证（生产数据落档：445 次 routing selections 全部 `sticky_hit=false`，结论维持现状——粘性子系统已接线但未激活）。
- **P0 — cache-creation observe → charge**：`BILLING_CACHE_CREATION_MODE=observe` 机制完成结算周期对账后，**生产已切换 `charge`（2026-08-06）**，cache-creation 价格正式计入用户余额。属运维操作而非代码变更，回滚路径保留。
- **P3 — 工程卫生**：6 个服务 conf 包测试、billing_model TODO 清理、v0.16 路线图文档整合、mock 竞态修复、gofmt 收尾。

### 变更内容

**Added**

- `platform/metrics/routing_rates_scrape.go`：`ScrapeRoutingRates` 通过 HTTP GET relay-gateway `/metrics` 解析 Prometheus exposition format。
- `app/admin/internal/server/routing_ops_rates.go`：`loadRoutingRates` 双源 fallback。
- `routingOpsRates` JSON 新增 `source` / `cumulative` 字段（additive）。
- `deployments/docker-compose/docker-compose.yml`：admin-api 段新增 `RELAY_METRICS_ENDPOINT=http://relay-gateway:8080` 默认值。
- P1 回归测试 7 条；6 个服务 conf 包 `registry_test.go`。

**Changed**

- `platform/metrics/routing_rates.go`：`RoutingRates` 新增 `Source` 字段。
- `go.mod`：`prometheus/common` 从 indirect 提升为 direct。
- `billing_model.go`：`channel_mapped ≡ upstream` 限制从 TODO 转为永久 NOTE。
- `docs/design/v0.16-roadmap.md`：P0–P3 收尾文档。

### 兼容性与回滚

- 无破坏性 API 变更，无 proto 变更，无新增迁移。
- 新增配置项 `RELAY_METRICS_ENDPOINT` 为可选（不设置时仅影响 routing-ops 降级能力）。docker-compose 已内置默认值。
- cache-creation charge 切换的回滚路径：切回 `observe` 即可，新增列不回滚。

### 升级步骤

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

# 仅 admin-api 有代码变更，交叉构建并部署该服务即可：
./scripts/deploy-update.sh admin-api

# 可选：确认 docker-compose 中 admin-api 段已有 RELAY_METRICS_ENDPOINT
# (v0.16.0 docker-compose.yml 已内置默认值 http://relay-gateway:8080)
```

---

## 整体升级路径（v0.14.0 → v0.16.0）

如果从 v0.14.0 或更早版本直接升级到 v0.16.0，没有破坏性的结构迁移或前端提供方式变化，主要关注点在运行时行为：

### 1. v0.15.0 slot feedback 接线（可观测）

v0.15.0 为 channel-service 新增了 `RecordSubscriptionAccountSlot` gRPC 方法，relay-gateway 在请求生命周期内上报 slot 占用。这是一个 additive 变更——relay 与 channel 必须同时升级才能闭合 weight 反馈回路；只升级一侧时退化为零反馈（与 v0.14.0 行为一致），不影响功能正确性。

### 2. v0.15.1 行锁（生产接线）

v0.15.1 的 `ChangeSubscription` 行锁保护依赖 `admin-api` 接线 `NewTxRunner(repo)`。如果只升级 billing-service 而不升级 admin-api，行锁不会生效（回退到无锁路径）。生产环境应同时升级这两个服务。

### 3. v0.16.0 cache-creation charge 切换（运维操作）

v0.16.0 将 `BILLING_CACHE_CREATION_MODE` 从 `observe` 切换为 `charge`（2026-08-06 已完成）。这是计费行为变更——cache-creation 价格正式计入用户余额。回滚路径：切回 `observe` 即可，新增列不回滚。如果你在独立环境中运行，需要自行评估 observe 阶段的对账数据后再决定是否切换。

### 快速升级命令

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

# 按受影响范围重建并部署；v0.15.3 为纯重构，可随常规发布节奏一并上线
./scripts/deploy-update.sh relay-gateway channel-service admin-api identity-service billing-service
```

Kubernetes 部署：交叉构建镜像并更新各 Deployment 的镜像引用后，执行 `kubectl apply -k deployments/k8s` 并等待 rollout 完成。完整步骤见 [docs/deployment.md](../deployment.md)。

## 验证

各版本发布前已执行的关键验证：

```bash
# v0.15.0
go build ./...           # 通过
go vet ./...             # 无告警
make test-unit           # 全部 PASS（relay slot-feedback 异步断言 + channel loadFactor）

# v0.15.1
go build ./...           # 通过
go vet ./...             # 无告警
make test-unit           # 全部 PASS（同组/跨组用量重置 + 行锁并发 + tx 错误透出）

# v0.15.2
go build ./...           # 通过
go vet ./...             # 无告警
make test-unit           # 全部 PASS（无空格 SSE、提前关闭、scanner 错误、completed 守卫）

# v0.15.3
gofmt -l                 # 全仓库 clean
go build ./...           # 通过
go test                  # 非网络包单元测试通过
# pkg/jsonx 一致性测试：HTML 转义、map key 排序、数值精度、自定义编解码器

# v0.16.0
make test-unit           # 受影响包全绿（platform/metrics、internal/biz、
                         # domain/subscription/{biz,data}、6 个服务 conf 包）
gofmt -l                 # 受影响目录 clean
# P2.3 双源降级 10 条回归测试通过；P1 契约加固 7 条确定性回归测试通过
```

## 结语

从 v0.15.0 到 v0.16.0，`micro-one-api` 在三天内完成了订阅账号 weight 反馈回路闭合、审计归因链路打通、订阅换组与并发的资金加固、relay 流式中断与渠道统计的一系列修复，以及 v0.11.0 路线图（P0–P3）的全部收尾。这段时间的迭代主线是运行时反馈闭环与可归因性，辅以一组流式转发的健壮性修复和 JSON 序列化层的收敛。

v0.15.0 闭合了 channel selector 的 weight 反馈回路并让敏感操作审计可归因；v0.15.1 和 v0.15.2 收敛了订阅变更的资金链路与 relay 流式中断的边界缺陷；v0.15.3 把全仓库的 JSON 序列化收敛到单一、可审计的一层；v0.16.0 则以 routing-ops 双源降级、契约加固回归测试和 cache-creation charge 切换为 v0.11.0 路线图画上句号。

如果你对多模型网关、AI API 管理平台或 Go Kratos 微服务实践感兴趣，欢迎关注、试用和参与改进。

本文整理 micro-one-api 从 v0.15.0 到 v0.16.0 共 5 个版本的发布内容。这段时间内项目完成了订阅账号 weight 反馈回路闭合、审计平台 actor/request-id 归因链路打通、订阅换组与并发变更的资金加固、relay 流式中断与渠道统计的一系列修复，以及 v0.11.0 路线图（P0–P3）的全部收尾。范围覆盖 d9dd890..v0.16.0 共 27 次提交、201 个文件、+6.5k/-1.5k 行。

Micro-One-API v0.15.0 ~ v0.16.0 发版公告：订阅权重反馈闭环、审计归因链路、流式中断修复与路线图收尾

本文整理 micro-one-api 从 v0.15.0 到 v0.16.0 共 5 个版本的发布内容。这段时间内项目完成了订阅账号 weight 反馈回路闭合、审计平台 actor/request-id 归因链路打通、订阅换组与并发变更的资金加固、relay 流式中断与渠道统计的一系列修复，以及 v0.11.0 路线图（P0–P3）的全部收尾。

后端

micro-one-api v0.15.0至v0.16.0发布，完成订阅账号weight反馈闭环、审计归因链路、订阅换组资金加固及relay流式修复，收尾v0.11.0路线图。无破坏性变更，新增可选配置RELAY_METRICS_ENDPOINT，重建镜像滚动重启即可升级。

代码解释

回归测试

单元测试

漏洞修复

API管理

中间件

数据库

路由

SQLite

Docker

MySQL

Redis

JSON

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

apigw

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

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

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

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

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

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

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

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

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

社区新版编辑器体验调研

Micro-One-API v0.15.0 ~ v0.16.0 发版公告：订阅权重反馈闭环、审计归因链路、流式中断修复与路线图收尾-腾讯云开发者社区-腾讯云

Micro-One-API v0.15.0 ~ v0.16.0 发版公告：订阅权重反馈闭环、审计归因链路、流式中断修复与路线图收尾

Micro-One-API v0.15.0 ~ v0.16.0 发版公告：订阅权重反馈闭环、审计归因链路、流式中断修复与路线图收尾

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐