Claude Code Hub v0.3.31

本版本带来用户权限控制增强、日志查询性能优化，以及多项 Bug 修复和稳定性改进。

亮点

• 用户访问控制增强: 新增客户端（CLI/IDE）和模型限制功能，管理员可精细控制用户访问权限
• 日志查询性能优化: 实现游标分页查询，大幅提升大数据量场景下的查询性能
• 用户管理体验升级: 配额使用详情、快速续期、新用户引导教程，提升管理效率

新增

• 用户客户端（CLI/IDE）限制功能 (#341) @miraserver
• 用户模型限制功能 (#347) @miraserver
• 使用日志游标分页查询 (#371)
• 用户面板功能增强：配额使用详情、快速续期对话框、新用户引导教程 (#362)
• API 文档增强：Vitest 测试框架集成 (#355)
• 限制规则覆写提示功能
• "Tool names must be unique" 错误规则 (#366)
• Redis TLS 证书跳过验证支持 (#360) @Silentely
• 日期选择器清除按钮 (#345)
• 响应头清理功能（Bun 兼容性）

优化

• 限额管理系统检查顺序优化 (#359)
• 使用日志筛选器懒加载
• 虚拟化日志表格列宽和布局调整
• Dockerfile 改用 Bun 和 Debian 基础镜像
• 排行榜排名徽章对齐统一 (#344)
• 限额规则表格添加工具提示

修复

• 修复 dailyQuota 处理问题 (#370)
• 修复限制规则表单提交事件传播问题
• 修复 TypeScript 类型错误 (#376)
• 修复 Codex 请求强制 stream=true 问题 (#369)
• 修复 Recharts Tooltip formatter 参数类型错误
• 修复用户管理表描述本地化问题
• 修复用户每日配额允许为 0（无限制）(#346)
• 修复 API Key 加载失败错误处理

其他

• 测试框架从 Jest 迁移到 Vitest (#355)
• 多语言翻译更新
• 代码质量改进

贡献者

感谢以下贡献者对本版本的贡献：

• @miraserver
• @Silentely
• @NightYuYyy

🐳 Docker 镜像

docker pull ghcr.io/ding113/claude-code-hub:v0.3.31
docker pull ghcr.io/ding113/claude-code-hub:latest

Full Changelog: v0.3.30...v0.3.31

Claude Code Hub v0.3.30

本次发布带来了 1M 上下文窗口支持、日志页面性能优化、移动端响应式导航等重要更新。

亮点

• 1M 上下文窗口支持: 供应商配置新增 1M 上下文窗口选项，支持分层定价和代理管道集成
• 日志页面性能优化: 使用批量查询、缓存和可见性轮询大幅提升日志页面加载速度
• 移动端体验改进: 新增响应式导航汉堡菜单，优化小屏幕设备的使用体验

新增

• 供应商支持 1M 上下文窗口配置，包含分层定价和代理管道集成 (#337)
• 移动端响应式导航汉堡菜单，改进小屏幕设备体验
• 供应商独立管理页面
• 系统设置导航悬浮下拉菜单
• Session 请求列表支持排序选项
• 错误时间线支持查看请求详情，便于调试
• Gemini 200K token 分层定价支持
• Long Context 定价计划错误规则
• 部署脚本增强：支持 CLI 参数和 Caddy HTTPS (#316)
• my-usage 页面新增每日用户配额统计、缓存列和自动刷新功能 (#316)

优化

• 日志页面性能大幅优化：使用批量查询、缓存和可见性轮询 (#337)
• 语言切换器简化为仅图标按钮

修复

• 修复 Gemini 缓存 token 重复计费问题 (#338)
• 支持 Gemini thoughtsTokenCount 计费
• 修复供应商分组过滤逻辑，隐藏无关分组的供应商
• 修复供应商页面和可用性页面的响应式布局问题
• 修复 PostgreSQL 返回字符串值时调用 toFixed 的 TypeError
• 允许普通用户访问 getUsers API (#300)
• 修复用户密钥详情中 React 渲染杂散 "0" 的问题
• 日志翻页离开第 1 页时自动暂停刷新
• 安全性改进：在客户端错误响应中隐藏供应商名称
• 新增 "model is required" 预设错误规则

其他

• 更新使用文档：Codex 推荐模型更新为 gpt-5.2 with xhigh reasoning
• 更新 LiteLLM 模型价格数据

贡献者

感谢以下贡献者对本版本的贡献：

• @sususu98
• @Hwwwww-dev

🐳 Docker 镜像

docker pull ghcr.io/ding113/claude-code-hub:v0.3.30
docker pull ghcr.io/ding113/claude-code-hub:latest

Full Changelog: v0.3.29...v0.3.30

Claude Code Hub v0.3.29

此版本包含非常重要的安全更新，我们建议所有用户尽快升级到此版本。

此版本包含的安全更新解决了如下漏洞：

• GHSA-2m3v-v2m8-q956 (DoS, High, CVSS 7.5)
• CVE-2025-67779 (DoS, High, CVSS 7.5)
• GHSA-925w-6v3x-g4j4 (Source Code Exposure, Medium, CVSS 5.3)

其他

• 更新 LiteLLM 模型价格数据

🐳 Docker 镜像

docker pull ghcr.io/ding113/claude-code-hub:v0.3.29
docker pull ghcr.io/ding113/claude-code-hub:latest

Full Changelog: v0.3.28...v0.3.29

Claude Code Hub v0.3.28

本版本增强了日志筛选和导出功能，优化了 Session 监控分页体验，并改进了供应商容错机制。

新增

• 日志页面新增快速日期筛选器（今日/昨日/近7天/近30天）和 CSV 导出功能 (#314)
• Session 监控页面新增分页功能，支持分别对活跃和非活跃 Session 进行分页浏览 (#314)

优化

• 每日排行榜改用滚动 24 小时窗口计算，替代原先基于日历日的统计方式 (#314)
• 上游 404 错误现在触发供应商故障切换而不计入熔断器，提升中转服务兼容性 (#314)

修复

• 修复 Anthropic SSE 流式响应中 output_tokens 提取问题，现在从 message_delta 事件正确获取 (#313)

🐳 Docker 镜像

docker pull ghcr.io/ding113/claude-code-hub:v0.3.28
docker pull ghcr.io/ding113/claude-code-hub:latest

Full Changelog: v0.3.27...v0.3.28

Claude Code Hub v0.3.27

本次发布主要新增供应商 IP 透传功能和会话绑定清理工具，同时修复了多个缓存和 UI 相关的问题。

亮点

• 供应商 IP 透传：新增 preserve_client_ip 选项，可将客户端真实 IP 传递给上游供应商，便于供应商端的访问控制和日志记录
• 会话绑定清理工具：提供交互式 CLI 工具，支持按优先级、ID、名称灵活筛选和清理会话绑定

新增

• 供应商新增 IP 透传功能（preserve_client_ip），可将客户端 IP 传递给上游供应商 (#294)
• 新增会话绑定清理工具 (scripts/clear-session-bindings.ts)，支持按优先级、ID、名称筛选清理 (#268)
• 仪表盘新增计费详情展示功能

优化

• 用户管理 API 增强：改进验证逻辑和响应结构，支持更多字段 (#303)
• 改进 Session 绑定清理工具的类型安全性 (#268)

修复

• 修复缓存创建 tokens（5 分钟/1 小时）和 TTL 未保存到数据库的问题，同时修复 React 渲染 bug (#310)
• 修复从 Claude message_start SSE 事件中提取缓存创建 tokens 的问题
• 添加 tool_use_id 错误规则并修复密钥供应商分组 bugs
• 修复 key provider group 相关问题 (#296)
• 修复 KeyListHeader 组件中 DialogContent 样式问题 (#295)
• 解决应用 CORS 头时的 TypeError immutable 错误 (#292)
• 修复点击同步规则时的错误 (#309)
• 修复 my-usage 页面成本值的空值处理问题
• 修复迁移索引缺少 IF NOT EXISTS 导致的幂等性问题

其他

• 更新 LiteLLM 价格数据
• 多语言翻译更新（日语、俄语、简体中文、繁体中文）

贡献者

感谢以下贡献者对本版本的贡献：

• @NightYuYyy
• @sususu98
• @Hwwwww-dev

🐳 Docker 镜像

docker pull ghcr.io/ding113/claude-code-hub:v0.3.27
docker pull ghcr.io/ding113/claude-code-hub:latest

Full Changelog: v0.3.26...v0.3.27

Claude Code Hub v0.3.26

本次更新带来个人使用页面、Session 请求追踪、批量 Session 管理和用户过期时间等多项新功能，同时修复了 CORS、时区和迁移等问题。

亮点

• 个人使用页面：用户可查看个人配额、使用日志和过期信息，无需管理员权限
• Session 请求追踪：支持在 Session 详情页查看单个请求的详细信息
• 用户过期时间管理：支持设置用户账户过期日期，便于临时授权管理

新增

• 新增个人使用页面 (my-usage)，用户可查看个人配额、使用日志和过期信息 (#282)
• Session 内请求追踪功能，支持在 Session 详情页查看单个请求详情 (#289)
• 批量终止活跃 Session 功能，管理员可在 Session 管理页批量终止 Session (#279)
• 用户过期时间管理功能，支持设置用户账户过期日期 (#273)
• Cache TTL 偏好设置，供应商和密钥管理支持配置缓存 TTL 偏好
• 供应商分组功能，密钥可关联指定的供应商分组
• 错误覆写支持多格式和异步规则检测 (#258)
• 新增模型相关错误模式（输入/上下文限制等），增强错误识别和报告能力

优化

• 替换原生日期选择器为 shadcn/ui DatePickerField，提升日期选择体验
• 个人使用页面筛选器与请求日志页面对齐，统一用户体验
• 图表工具提示可见性改进，数据展示更清晰
• 登录流程和权限管理增强，支持只读访问路径
• Gemini 透传超时机制优化 + undici 超时配置 (#258)

修复

• 修复 CORS 预检请求返回 401 的问题 (#287)
• 修复 Session 消息页面 URL locale 重复问题和响应体存储问题
• 修复迁移索引创建缺少 IF NOT EXISTS 导致的重复创建错误
• 修复用户 Schema 中 providerGroup 字段未设置 nullable 的问题
• 修复代理转发器和供应商链格式化的错误处理
• 修复日期筛选时区问题，使用毫秒时间戳确保准确性 (#274)

其他

• 更新 GitHub 工作流文件，改进 CI/CD 流程

贡献者

感谢以下贡献者对本版本的贡献：

• @Silentely
• @NightYuYyy
• @sususu98
• @ylxmf2005

🐳 Docker 镜像

docker pull ghcr.io/ding113/claude-code-hub:v0.3.26
docker pull ghcr.io/ding113/claude-code-hub:latest

Full Changelog: v0.3.25...v0.3.26

Claude Code Hub v0.3.25

本版本专注于提升代理转发器的日志安全性和错误诊断能力。

修复

• 增强代理转发器日志安全性，隐藏 URL 中的查询参数和 API 密钥 (#272)
• 增强代理转发器错误诊断，添加详细的错误原因、堆栈追踪和请求上下文信息 (#272)
• 优化请求头处理，将 "connection" 加入黑名单以改善 undici 兼容性 (#272)

Full Changelog: v0.3.24...v0.3.25

Claude Code Hub v0.3.24

本版本修复了熔断器 Redis 状态同步的问题，提升多实例部署下的状态一致性。

修复

• 增强熔断器 Redis 状态同步逻辑，非关闭状态下始终检查 Redis 以同步外部重置操作 (#267)

其他

• 更新项目依赖

🐳 Docker 镜像

docker pull ghcr.io/ding113/claude-code-hub:v0.3.24
docker pull ghcr.io/ding113/claude-code-hub:latest

Full Changelog: v0.3.23...v0.3.24

Claude Code Hub v0.3.23

本版本聚焦于熔断器稳定性和用户配额体验的改进，修复了多个熔断器状态显示问题，并新增了今日排行榜和可配置的重试次数功能。

亮点

• 今日排行榜: 仪表盘新增今日消费排行榜，便于快速了解当日使用情况
• 可配置重试次数: 新增 MAX_RETRY_ATTEMPTS_DEFAULT 环境变量，可自定义单供应商最大尝试次数

新增

• 仪表盘新增今日排行榜组件，便于快速查看当日消费情况
• 用户配额页面增强：添加总消费统计展示和组件重构优化
• 新增 MAX_RETRY_ATTEMPTS_DEFAULT 环境变量，支持配置单供应商最大尝试次数 (#237)

优化

• 优化用户配额显示组件布局，提升信息展示效率
• 移除废弃的密钥标签页，优化 UI 间距使界面更紧凑

修复

• 修复供应商设置页面熔断器状态显示不正确的问题
• 修复供应商管理页面熔断器状态不显示的问题
• 修复新供应商熔断器默认返回 CLOSED 状态的问题
• 修复密钥编辑时每日重置模式（dailyResetMode）未正确保存的问题
• 修复今日排行榜权限检查和供应商列表分页问题
• 修复日语和繁体中文的熔断器相关翻译错误
• 修复 Claude 工作流中非写入用户权限问题

其他

• 更新 LiteLLM 价格数据（litellm-prices.json）
• 移除排行榜 API 中无法访问的死代码

🐳 Docker 镜像

docker pull ghcr.io/ding113/claude-code-hub:v0.3.23
docker pull ghcr.io/ding113/claude-code-hub:latest

Full Changelog: v0.3.22...v0.3.23

新增

• 用户和 Key 新增总消费上限（limitTotalUsd）字段，支持设置历史累计消费限制 (#257)
• Codex 供应商支持通过 prompt_cache_key 实现 Session 绑定，提升缓存命中率 (#257)
• 全局 HTTP/2 开关配置，支持启用/禁用 HTTP/2 并自动降级处理 (#257)
• 添加 AGENTS.md 项目文档

优化

• 总消费限额检查优化：使用 Redis 缓存（5 分钟 TTL）减少数据库查询，并根据时间边界智能选择查询范围 (#257)
• 日志页面时间筛选组件重构：将 datetime 输入替换为紧凑型日期范围选择器，支持前后翻页和自定义范围 (#257)
• 供应商创建时默认启用，减少手动操作步骤 (#257)
• 合并 PR 工作流为三个统一 Action，简化 CI/CD 配置 (#257)
• 供应商组件新增剪贴板访问权限处理，提升复制功能兼容性 (#257)

修复

• 修复系统设置 i18n 翻译和保存时机问题 (#257)
• 修复分组筛选器中逗号分隔的标签解析错误 (#257)
• 修复排行榜周度数据的日期条件查询错误 (#257)

其他

• GitHub 工作流增强：优化分支同步机制
• 代码格式化更新

🐳 Docker 镜像

docker pull ghcr.io/ding113/claude-code-hub:v0.3.22
docker pull ghcr.io/ding113/claude-code-hub:latest

Full Changelog: v0.3.21...v0.3.22