本次更新
OctaFuse Gateway v2.10.0 重点增强路由参数控制、模型能力发现和额度审计：管理员可以分别控制请求体与转发请求头的覆盖优先级，客户端可从模型列表识别支持的请求入口，管理后台则补齐永久额度变更记录、组合筛选和新模型目录。
变更内容
Proxy
- 路由参数强制覆盖：路由自定义参数支持分别开启请求体和请求头的强制覆盖。默认仍由客户端显式值优先；开启后，路由配置可覆盖客户端同名值，可用于固定
max_tokens、渠道参数或指定的上游请求头。 - 模型请求入口发现：
GET /v1/models的model_info新增inbound，以protocol与operation列出当前可用的 Chat Completions、Responses、Anthropic Messages 或 Gemini generateContent 请求入口，方便客户端选择正确调用方式。 - Responses 流式兼容：当 OpenAI Responses 上游流式事件缺少顶层
sequence_number时，网关会按连接补充递增序号；上游已有序号保持不变，避免严格校验该字段的客户端中断。
Admin
- 额度审计增强：管理员直接修改永久额度时使用独立的
admin_patch_wallet原因码，并记录周期额度、永久额度及当前余额的调整前后快照，便于核对额度变化。 - 审计日志筛选：事件类型、来源、操作者等条件支持多选；默认事件范围会准确传递给查询接口，不再混入默认排除的用量扣费事件。
- 用户详情整合：永久额度的发放与修改记录统一展示在用户审计日志中，并复用一致的变更详情组件，减少额度记录分散在多个区域的情况。
- 模型目录更新：新增 Claude Fable 5.1、GPT-6 Astra 和 DeepSeek V4.1 Flash 预设；同时按最新目录价格调整 DeepSeek V4 Flash 的输入、输出与缓存读取价格，并保留工作日峰谷时段配置。
Core / 配置
- 自定义参数结构统一：路由
custom_params规范为{ headers, body, force_override }信封结构。历史扁平 JSON 仍可读取，管理后台再次保存时会自动规范为新结构。 - 覆盖边界保持安全：鉴权、
Content-Type和 hop-by-hop 等受保护请求头仍不能由路由或客户端覆盖；请求体与请求头的强制覆盖开关彼此独立。
文档
- 接口与配置说明：补充模型请求入口、路由默认参数合并、强制覆盖、Responses 流式序号兜底和额度审计原因码说明。
升级说明
- 数据库迁移：本版本没有新增数据库迁移，可直接在已完成 v2.9.0 迁移的数据库上升级 Proxy 与 Admin。
- 自定义参数兼容：历史扁平
custom_params可以继续运行；升级后建议在管理后台检查关键路由并保存为新结构。请求体仍默认由客户端同名字段优先。 - 请求头优先级：v2.10.0 默认允许客户端同名请求头优先于路由配置。若某个自定义上游请求头必须由运维固定，请为该路由设置
force_override.headers: true。 - 目录导入行为：模型目录导入不会覆盖数据库中已存在的同 ID 模型。已有
deepseek-v4-flash如需采用新目录价格，应由管理员核对后手动更新；新模型预设也需要按需导入。 - 建议核验：升级后验证关键路由的请求体与请求头优先级、
GET /v1/models的model_info.inbound、Responses 流式调用、永久额度审计记录和审计日志默认筛选。
容器镜像
ghcr.io/octafuse/octafuse-gateway-proxy:v2.10.0
ghcr.io/octafuse/octafuse-gateway-admin:v2.10.0
ghcr.io/octafuse/octafuse-gateway-migrate:v2.10.0