v2.5.3

Release v2.5.3

v2.5.2

Release v2.5.2

v2.5.1

release: 发布 v2.5.1

包含更新:
1. 日志行身份冲突与刷新去重：引入独立持久化 log_entry_id 与不透明 row_key，详情查询支持 row_key 精准寻址并严格鉴权，修复重试错误行残留与行状态串行；搜索刷新可靠重置数据；
2. TPS 统计有效样本筛选与负速率剔除：新增独立累计字段（tps_sample_count 等），严格排除 0 输出长耗时、未交付、负速率（~）及耗时不足 100ms 的不可靠样本；无有效样本时返回 null，图表展示断点；
3. 每模型三阶段独立趋势与 Token 单位规范：模型趋势图按「模型 × 阶段 × 小时」独立展开三阶段曲线，稳定主题色；模型日志统一引入十进制 Token 单位（k/M/B），浮层保留精确整数；
4. 使用日志单行压缩模式与内存防泄漏：修复模型别名图标换行，新增右上角「最小化显示」窄行监控开关；解耦 1Hz 倒计时渲染，并在自动刷新周期性触发 QueryCache 惰性修剪与 Other 解析缓存清理，防止内存泄漏。

v2.5.0

release: 发布 v2.5.0

包含更新:
1. 使用日志新增来源与会话列，请求/响应记录重构为结构化抽屉展示；
2. 完成 17 项系统级缺陷修复（Q-01~Q-17）：看板落库失败保留缓存、
   ClickHouse 建表补齐缺失列、7 天 token 热力图桶数修正、日志列
   表剥离 record/full_log 大字段并新增 /api/log/detail 按需详情、
   计数子查询封顶防全表扫描、批量删除三库 LIMIT 兼容、每日统计方
   言跟随日志库、失败计数 CAS 乐观锁防并发丢数、热力图 tooltip
   portal 挂载与周一对齐、图表共享聚合与翻页统计去重等；
3. 修复首字时间零值导致的监控指标中毒与负数用时：新增
   FirstResponseDurationMs 安全收口，TPS 计算增加 frt 守卫；
4. 建立 XLF-CHANGELOG.md 定制版变更台账：防冲突矩阵、上游合并
   SOP 与 281 次提交全量溯源，并在 AGENTS.md 建立索引；
5. README 重写为简体中文定制版说明，移除上游推广内容并依法保留
   AGPLv3 第 7 条署名义务。

v2.4.1

release: 发布 v2.4.1

包含更新:
1. 修复 /v1/responses 入口 bamboo 分支先于模型映射执行的缺陷：渠道 model_mapping 此前从未作用于该入口，上游收到未映射原名后报 unknown provider for model；
2. 补齐对应端到端回归测试：mock Gemini 上游断言 URL 携带映射后的变体模型名；
3. 修复 v2.4.0 合并回归：i18n 语言包误删、渠道 Bamboo 设置区域丢失、使用日志流列冗余与 Tooltip 缺失、bamboo 中继桥模型映射优先级。

v2.4.0

release: 发布 v2.4.0

包含更新:
1. 修复主线最新变更合并引入的多语言翻译丢失，全量补齐 7 国语言包；
2. 渠道配置抽屉恢复 Bamboo Relay Adapter 设置区域，支持协议覆盖与兼容模式；
3. 使用日志移除冗余 Stream 列，保留统一 TPS 列并恢复时延 Tooltip 速率细分；
4. 修复 Bamboo 中继桥中的模型重定向覆盖优先级逻辑，确保映射模型稳定透传；
5. 重构流式耗时与 TTFT 体系，捕获 SDK 物理锚点消除计时失真；
6. 升级 bamboo-messages SDK 至 v1.0.14 并适配 Pi Agent 与通用会话识别。

v2.3.17

release: 发布 v2.3.17

包含更新:
1. 升级 bamboo-messages SDK 至 v1.0.14：
   - 修复 Gemini 协议上下文相同 role 合并与第三方 assistant 兼容映射；
   - 重构 Gemini 工具参数去重，消除 Repeated map key 报错；
   - 优化 Hop2 工具调用反查兜底，补齐 ToolName；
   - 补齐跨协议 Anthropic 上游 max_tokens 默认值配置联动；
   - 修复 OpenAI completions 纯工具调用 assistant 消息显式补齐 "content": null；
   - 拓展调试日志敏感凭据脱敏，SSE 缓冲区扩容至 16MB。
2. 修复 ResponsesHelper 缺失 ChannelMeta 初始化导致的空指针崩溃；
3. 补齐 Pi Agent 的 User-Agent 识别与 ClientProfilePi 映射；
4. 将 X-Client-Request-Id 纳入前后端权威 Session 提取规则并拓展通用会话头；
5. 同步主线最新特性（合入 origin/main 最新变更）：任务插件扩展、计费与模型同步优化、前端交互改进。

v2.3.16

fix(bamboo): 升级 messages SDK 至 v1.0.13 并优化 Gemini 工具调用与流式终止状态

原因:
1. Gemini 原生端点在工具调用中，缺省 id 的 functionResponse 误以名称匹配导致与显式 ID 无法配对并被清洗丢弃，引发客户端无限重复调用；
2. Gemini 流式 candidate.FinishReason 为 STOP 时导致工具调用 finish_reason 丢失；
3. client_stream 在发出 tool_use 且未收到显式 delta 时结束原因被误记为 end_turn。

内容:
1. 升级 bamboo-messages 至 v1.0.13（集成 v1.0.12 与 v1.0.13 修复）：实现 Gemini 工具历史轮次内关联契约、响应级独立调用 ID 空间分配与历史排除、流式按索引隔离参数与签名作用域、透传 isError 标志并阻止取消后输出挂起调用；
2. 优化 client_stream：流式中输出了 tool_use 且未收到 delta 时，兜底补发 stop_reason 为 tool_use。

影响: 彻底解决 Gemini 工具调用死循环；流式工具调用精准输出 stop_reason=tool_use；提升取消与错误处理的稳定性。

v2.3.15

fix(bamboo): 升级 messages SDK 至 v1.0.11

v2.3.14

fix(bamboo): 升级 messages SDK 至 v1.0.10

原因: Anthropic tool_result 缺失 name 时 Gemini functionResponse 报缺少函数名；Gemini safetySettings 与 cachedContent 误放入 generationConfig 导致 protobuf Unknown name 报错，且 UserID/Metadata 误注入不存在的 labels 字段
内容: 依赖升级至 bamboo-messages v1.0.10
影响: 修复跨协议工具响应名回填，消除 Gemini 原生 API 参数结构校验报错