Repository navigation
ClawProxyHub v1.5.2
ClawProxyHub v1.5.2
协议兼容、调度与稳定性修复版。新增可配置的任务时区,统一管理后台布局与分页,并修复流式转发、凭据授权、插件安装及备份恢复问题。
主要更新
任务时区与保存体验
- 系统设置新增调度时区,默认
Asia/Shanghai(北京时间),支持自定义 IANA 时区。 - 每日任务和 Cron 按设置的时区执行,修复服务器使用 UTC 时出现的 8 小时偏差。数据库继续使用 UTC,页面仍按浏览器本地时间显示。
- 时区与每日随机偏移通过同一个底部保存按钮生效,手机端也可保存;提示信息同步精简。
- 切换时区后重新计算日历任务的下次执行时间,固定间隔和一次性任务保留原时间点。
- 限制任务执行并发,修复前面的到期规则没有可用账号时,后续任务长期无法执行的问题。
布局、分页与表单
- 页面统一为固定页头、内部滚动的内容区、固定底部分页区,筛选与功能按钮在滚动时保持可用。
- 补齐账号、实例、分组、代理、路由、密钥、OAuth 凭证和已安装插件列表分页。
- 修复筛选、切换页大小、删除末页记录后的页码与滚动行为,完善任务和日志页分页。
- 修复登录表单项间距与设置抽屉组件引用。
网关、SDK 与 LuaHost
- 修复流式响应缺少结束事件时被误判成功,以及上游错误分类不准确的问题。
- 完善交错工具调用、工具参数增量、停止序列和推理签名处理。
- 请求取消贯通网关、插件 RPC、SDK HTTP 与 LuaHost,及时结束取消后的上游处理。
- 网关继续兼容旧插件的无 ID 工具调用增量,无需同时升级全部插件即可升级核心。
- 收紧 Lua 文件加载与响应读取边界,关闭 Lua 总开关时停止已运行的 Lua 插件。
三协议兼容与输出保留
- Chat、Responses、Anthropic 入口加强内容、工具选择及调用历史校验,明确拒绝不支持的附件、托管工具和多候选请求。
- 保留工具 strict 的显式 true/false、并行工具控制和新版 token 上限,补齐 Chat ↔ Responses 结构化输出及图片 detail 转换。
- SSE 统一按事件分帧,支持多行 data、CRLF/BOM、正常 EOF 和大小限制;断流不补残帧,避免丢失最终 usage。
- Responses 从最终快照补齐正文、推理与工具参数;正文与摘要分别合并,防止重复或冲突。工具调用支持名称晚到,拒绝身份冲突、重复 ID 和结束时缺少名称。
- 统一推理强度与 thinking budget 映射;thinking.disabled 优先于同源 output_config.effort。
- 同协议保留 metadata、service_tier、缓存策略等关键白名单参数。引用和注解保留所属内容块,拒绝正文在 Chat/Responses 出口恢复专用结构,覆盖流式、非流式与历史回放。
- protobuf 仅新增可选字段,保持 protocol v2 和既有字段编号;LuaHost 同步传递新增结构。跨协议暂不转换不同格式的注解。
凭据、授权与恢复
- 加密密钥成功持久化后才投入使用,显式处理加解密失败;代理密码改为加密存储。
- 串行处理同一账号的凭据刷新与任务更新,避免覆盖较新的凭据。
- 修复 API 密钥初始化重复创建,授权关系事务保存;受限但未绑定路由的密钥不再获得全部路由权限。
- 增加登录限流,修改密码后撤销旧会话。
- 插件安装增加包内容校验和失败回滚,同时允许 ZIP 内正常的目录条目。
- 备份恢复增加数据库、密钥与包内容校验,并处理恢复过程被中断的情况。
- SDK 调试日志移除请求/响应正文等敏感内容;运行日志与任务执行记录按保留期分批清理。
发布构建
- 前端只构建一次,所有平台复用同一份产物。
- 核心改用各目标平台原生构建并启用 CGO,保证 SQLite 可用;LuaHost 保持 CGO 关闭。
- 继续提供完整版、轻量版和独立 LuaHost,发布 CI 不新增重复测试。
升级说明
- 数据库迁移:启动时自动执行
000015_security_state和000016_schedule_timezone,补齐授权状态、会话版本、代理密码密文及调度时区。 - 备份与回退:升级前备份数据库和配套加密密钥。首次启动会将现有代理密码转为密文;需要回退时使用升级前备份,不直接让旧版本读取升级后的数据库。
- 任务时区:默认按北京时间调度。原先使用其他时区的部署,请在“系统设置 → 任务”中调整后保存;每日随机偏移仍按原配置生效。
- 历史日志:本版没有历史日志脱敏或清空迁移。正常保留期清理仍会执行:调用日志沿用原设置,运行日志与已完成任务记录默认保留 30 天。
- 旧插件兼容:核心保留兼容处理。SDK 内的修复需要插件更新 SDK 并重新构建后生效;插件维护者可在核心 tag 发布后,将依赖更新至
v1.5.2,再递增已发布插件的补丁版本。 - Compose 部署:使用本版
docker-compose.yml时,需在环境变量或.env中显式设置CPH_ADMIN_PASSWORD。已有管理员仍以数据库中的密码为准。