Repository navigation
Releases
Releases · dreamforSh/linksyncx
LinkSyncX 0.2.11.18
自定义版本:0.2.11.18
Docker 镜像:
docker pull ghcr.io/dreamforsh/linksyncx:0.2.11.18LinkSyncX 0.2.11.17
自定义版本:0.2.11.17
Docker 镜像:
docker pull ghcr.io/dreamforsh/linksyncx:0.2.11.17本版更新
API Key(中转)账号支持 OpenAI SDK 按 id 查询 Response
responses.retrieve()、responses.delete()、responses.inputItems.list():API Key 账号创建的 response 现在可以查到。之前这三个接口一律返回 404,因为网关只保存订阅账号的记录。- 网关本地查不到时,会用创建该 response 的 API Key 账号去上游查询,走该账号的 base_url、密钥、自定义请求头和代理;代理不可用时直接报错,不会绕过代理。客户端的查询参数(limit、order、after 等)原样带上,
stream=true的查询按 SSE 转发。 - 查询前会确认 response 属于当前用户;别人的 response 返回 404。上游返回 401/403/5xx 时,调用方统一收到 502,不会暴露上游 Key 自身的错误。删除成功后,网关里这条 response 和账号的绑定一并清除。
- 已用官方 Node SDK 端到端验证:API Key 账号的生图与编辑(GPT Image 2.6 的
complexity、size、quality等原样透传)、Responses 的创建、retrieve、input_items、previous_response_id续链、删除、流式。
升级说明
- 无数据库迁移,无配置变更。
- 只有在网关还记得 response 属于哪个账号时才能查询,期限是
gateway.openai_ws.sticky_response_id_ttl_seconds(默认 1 小时);超过后返回 404。续链的账号亲和也受同一期限影响。 - 暂不支持
responses/{id}/cancel和background后台模式。
LinkSyncX 0.2.11.16
自定义版本:0.2.11.16
Docker 镜像:
docker pull ghcr.io/dreamforsh/linksyncx:0.2.11.16本版更新
GPT Image 2.6
- 支持
gpt-image-2.6-flare/gpt-image-2.6-sunburst:订阅(OAuth)账号改走 Codex 直连 Images 接口,生成和编辑都支持。模型已加入默认模型列表和前端白名单。 - 修复订阅账号调用 2.6 时一律报 400
Complexity 'medium' is not supported for this image model。原因是 2.6 被转成 Responses 图片工具,并带上了写死的reasoning.effort: "medium",而 2.6 上线后上游会把它当成图片的 complexity。 /v1/images/generations和/v1/images/edits支持顶层complexity字段,JSON 和 multipart 都支持,原样透传给上游;客户端没传就不发。- 其他仍走 Responses 图片工具的模型,不再继承写死的
reasoning.effort,只在客户端传了complexity时才设置。 - 2.6 计费与 2.5 同价:文本输入 $5,缓存 $1.25;图片输入 $8,缓存 $2;图片输出 $30(每百万 token)。价格表和兜底价都已加入。
升级说明
- 无数据库迁移,无配置变更。
- 订阅(OAuth)账号的图片接口不保证按
size出图:实测直连和 Responses 两条路径都按约 157 万像素、由模型自己决定画幅。网关原样转发size,响应里的size是实际尺寸。需要精确尺寸的客户端请自行缩放或裁剪。API Key 账号不受影响。
LinkSyncX 0.2.11.15
自定义版本:0.2.11.15
Docker 镜像:
docker pull ghcr.io/dreamforsh/linksyncx:0.2.11.15本版更新
订阅 Codex 账号支持 OpenAI 官方 SDK
- 有状态 Responses 模拟:支持
previous_response_id续链,新增GET/DELETE /v1/responses/{id}与GET /v1/responses/{id}/input_items。记录存 Redis,无 Redis 时退回进程内缓存;记录归属用户,跨用户访问返回 404。 - 网关代为展开的续链,在响应对象和流式生命周期事件里回显客户端的
previous_response_id,与官方 API 一致。 - 非 Codex CLI 客户端自动派生
prompt_cache_key,上游拿到稳定会话标识,提高缓存命中。客户端自带的 key 优先。 - 修复非流式 Responses 返回上游
text/event-stream的 Content-Type,导致 Node SDK 拿到字符串而不是对象;Chat 兜底聚合路径同样加固。 - Chat Completions 的
image_url.detail(low / high / auto)转换为 Responses 时保留为input_image.detail。 reasoning.effort/reasoning_effort的xhigh、max原样透传,由上游按模型判定。- 已用官方 Node SDK 7.19 端到端验证:文本与图片输入、xhigh / max、Responses 与 Chat 的原始流和 SDK 流式助手、工具调用、
include_usage、retrieve、input_items、续链。
Codex 首 token 延迟
- 请求发往上游前的处理(工具 schema 清洗、压缩触发判断、图片意图识别等)合并为单遍:2 MB 历史 107 → 52 ms,600 KB 36 → 16 ms。
- 请求时区改写由平方复杂度改为单遍:2 MB 历史 3.5 s → 4.3 ms,600 KB 294 → 1.2 ms。跟随代理时区模式下几乎每个 Codex 请求都会经过这一步。
- 以上优化的出站请求与旧实现逐字节一致,由差分测试保证。
升级说明
- 无数据库迁移。
- 新增配置项,均有默认值,无需改动:
gateway.openai_responses_state_enabled(默认true)、gateway.openai_responses_state_ttl_seconds(默认86400)、gateway.openai_responses_state_max_record_bytes(默认 16 MB)。 - 状态记录写入 Redis,key 前缀
openai_responses_state:,默认保留 24 小时。不需要 SDK 有状态功能时可将openai_responses_state_enabled设为false。
LinkSyncX 0.2.11.14
自定义版本:0.2.11.14
Docker 镜像:
docker pull ghcr.io/dreamforsh/linksyncx:0.2.11.14LinkSyncX 0.2.11.13
自定义版本:0.2.11.13
Docker 镜像:
docker pull ghcr.io/dreamforsh/linksyncx:0.2.11.13LinkSyncX 0.2.11.12
自定义版本:0.2.11.12
Docker 镜像:
docker pull ghcr.io/dreamforsh/linksyncx:0.2.11.12LinkSyncX 0.2.11.11
自定义版本:0.2.11.11
Docker 镜像:
docker pull ghcr.io/dreamforsh/linksyncx:0.2.11.11LinkSyncX 0.2.11.10
自定义版本:0.2.11.10
Docker 镜像:
docker pull ghcr.io/dreamforsh/linksyncx:0.2.11.10本版更新
安全:头像上传的解压型拒绝服务
- 头像上传此前只校验 base64 文本与解码后的大小(100KB),随后直接
image.Decode。体积很小的构造图片可以在解码阶段申请巨量内存或消耗大量 CPU:超大像素画布、WebP 中与画布尺寸不一致的 VP8/VP8L 位流、堆叠几十个扫描的渐进式 JPEG。- 现在解码前先做校验:base64 文本长度与解码后字节数都不超过 100KB;单边不超过 4096 像素、总像素不超过 4,194,304;JPEG 扫描数不超过 32。
- WebP 走
riff逐块读取,块长度不得超过文件本身,VP8 用vp8.NewDecoder().DecodeFrameHeader()、VP8L 用vp8l.DecodeConfig()取真实位流尺寸,并且必须与 VP8X 画布尺寸一致——image.DecodeConfig单看时会给出画布尺寸,而Decode分配的是位流尺寸,两者可以被拉开。
- 服务端压缩的工作量也设了上限:先把最长边缩到 512,再按 9 档缩放 × 8 档质量迭代。WebP 不再走服务端重压(VP8L 的 Huffman 表不受像素数约束),超过 20KB 的 WebP 直接返回
AVATAR_WEBP_TOO_LARGE,提示改用 PNG/JPEG/GIF。 - 前端上传前同样把关:GIF 超过 20KB 或任何图片超过尺寸上限时直接拦下(新文案
profile.avatar.dimensionsTooLarge),其余图片先按最长边 512 归一化再压缩;浏览器不支持 WebP 编码时回退 PNG,文件名扩展名与 MIME 跟随实际产物。 - OAuth 回填头像被拒绝不再打断整个登录流程:新增的
AVATAR_DIMENSIONS_TOO_LARGE、AVATAR_WEBP_TOO_LARGE、AVATAR_TOO_COMPLEX与原有头像错误一样按“跳过头像”处理。 - 影响:超过 20KB 的 WebP 头像不能再上传(前端会先压成 20KB 以内的 WebP,正常路径不受影响);超大尺寸图片会被拒绝,而不是先解码再压缩。
安全:依赖与工具链整改(Dependabot 100 项)
- Go:
go 1.27.3;golang.org/x/{crypto,image,mod,net,sync,term,text,sys,tools}、klauspost/compress 1.18.7、gopsutil v4.26.3等升到当前修复版;testcontainers-go 0.40 → 0.42连带引入moby/moby/api、moby/moby/client新模块(Container.MappedPort现在返回network.Port,取值用Num())。 - 前端:移除
xlsx(CVE-2023-30533 原型污染、CVE-2024-22363 ReDoS),管理端“使用记录”导出改用write-excel-file,输出仍为.xlsx,列与顺序不变;vue 3.5.44、vue-i18n 11、axios 1.21、dompurify 3.4.17;移除未使用的@lobehub/icons。 - 前端工具链:ESLint 8 → 10,改为 flat config(
eslint.config.js取代.eslintrc.cjs与.eslintignore);Vite 5 → 6、Vitest 2 → 4、@vue/test-utils 2.5、@vitest/coverage-v8 4;package.json锁定packageManager: pnpm@9.15.9、engines.node: ^22.13.0 || >=24。 - CI 与镜像:CI 的 Node 20 → 24,与镜像构建阶段原本就在用的
node:24-alpine对齐;Go 升到 1.27.3(golang:1.27.3-alpine),golangci-lintv2.13 → v2.15。 - 安全扫描:
pnpm audit从“只看生产依赖、只在高危失败、永远|| true放行”改为全依赖范围、任何等级都纳入,再由.github/audit-exceptions.yml白名单过滤;旧白名单(xlsx、lodash、lodash-es、axios、nanoid)已全部清空。 - HTTP/2 兼容保留:
http2.ConfigureTransports/http2.ConfigureServer仍按原方式使用(附带nolint说明与 keepalive 回归测试),上游连接行为与 h2c 行为未变。
CodeBuddy:上游流卡住时失败切换或结束
- CodeBuddy 上游只会流式返回,而原始 Chat 中继、Messages / Responses 桥接(
scanCCStream)与非流式聚合都用同步bufio.Scanner读它,gateway.stream_data_interval_timeout对它们从未生效。上游吐完 200 后沉默时,客户端和账号会被一起挂住,直到客户端自己放弃。 sendCodeBuddyUpstreamRequest现在给每个成功响应体套一层空闲上限,只统计阻塞在Read里的时间:客户端取字节慢不会被误判成上游沉默。超时后关闭 body(传输层取消请求),Scanner 解锁,读取以类型化的空闲错误结束;该错误刻意不包装context.Canceled,以免被当成客户端中断。计时器自续期、不起额外 goroutine,Close停止。- 卡住之后的处理:
- 客户端还没收到任何内容(Chat、Messages、Responses 或仍在聚合的非流式请求):账号冷却 2 分钟,网关流超时策略识别为超时,返回 502
UpstreamFailoverError、codestream_timeout,由 handler 换账号重试。 - 已经开始输出:同样冷却 2 分钟,流以类型化错误
stream_timeout结束,用量标记为不完整。Chat 收到 handler 的错误帧,Messages 以 Anthropic error 事件结束、Responses 以response.failed结束,都标记为已提交并计入 SLA 失败。 - 原始 Chat 中继读到 EOF:如果
[DONE]、usage 或finish_reason已经到达,此次关闭视为正常结束,不冷却。
- 客户端还没收到任何内容(Chat、Messages、Responses 或仍在聚合的非流式请求):账号冷却 2 分钟,网关流超时策略识别为超时,返回 502
- 超时取值:
gateway.stream_data_interval_timeout有值时按该值(默认 180 秒);设为 0 时 CodeBuddy 与 Grok 一样仍有上限,但取 300 秒而非 180 秒——上游不发心跳,只在排队与 prefill 阶段沉默,300 秒是设置项允许的最大值,也是codebuddy2api对同一上游采用的按次读超时。其他平台不受影响。
CodeBuddy:减少首 token 之前的网关耗时
- 长对话里请求在真正发往上游前会花掉几十毫秒:请求体被解码成 map 再编码回去(四轮全量遍历)、系统提示每轮过六条大小写不敏感正则、若干查找要把整段重放历史再扫一遍。本版把这些路径改掉,出站请求体与请求头逐字节不变。
- 具体改动与实测(同机、stub 上游、5 次交错取中位数):
PrepareChat在json.Valid后一趟切分,直接写出排序压缩后的请求体;需要转义的键与含 U+2028/U+2029 的值回退到encoding/json。PrepareChatBody:64 KB 2.44 → 0.24 ms,512 KB 6.69 → 1.37 ms,2 MB 21.5 → 4.95 ms。- 脱敏对文本里不存在的字面量直接跳过对应正则(除非含零宽空格),并按系统提示做有界 LRU 记忆(256 条、32 MB)。重复的 12 KB 系统提示从每轮约 2 ms 变成一次查表。
- 上游模型名改为由
PrepareChat直接给出。此前要等上游响应之后、转发第一字节之前再 gjson 搜一遍改写后的请求体(2 MB 档约 0.5 ms)。 X-Conversation-ID的遍历改为遇到第一条 user 消息即停,不再先解析整段历史(2 MB 档约 2.5 ms)。- Chat 转发到 CodeBuddy 时不再为设置
stream_options重写整个请求体(PrepareChat本来就会覆盖);stream_options为数组时仍以同样的 sjson 错误失败。 - Responses→Chat 桥接复用调用方已算出的
EffectiveResponsesTools,不再二次解码输入历史;其余 Responses→Chat 回退路径一并受益。 streamRawChatCompletions在输出开始后停止喂静默拒答检测器(此后无人读取)。每个转发事件 4.70 → 2.68 µs、9 → 6 次分配。
- 上游调用前的网关耗时:
- chat:64 KB 2.79 → 0.55 ms,512 KB 8.82 → 2.81 ms,2 MB 28.3 → 10.1 ms
- messages:64 KB 3.62 → 1.57 ms,512 KB 15.3 → 9.51 ms,2 MB 51.7 → 34.6 ms
- responses:64 KB 6.61 → 3.29 ms,512 KB 37.9 → 24.0 ms,2 MB 138.7 → 93.7 ms
其他
- 修复上版依赖升级遗漏的一处集成测试编译错误:
testcontainers-go 0.42的MappedPort返回network.Port,认证限流集成测试仍在调用Int(),导致internal/server/routes测试包编译失败、CI 的集成测试 job 在构建阶段就退出。现改用Num(),与本仓库另外两处调用一致。
升级说明
- 本版没有新增数据库迁移,无需额外操作。
- 头像限制变化:超过 20KB 的 WebP 头像会被拒绝(
AVATAR_WEBP_TOO_LARGE),超过 4096 像素单边或 4,194,304 总像素的图片会被拒绝(AVATAR_DIMENSIONS_TOO_LARGE),扫描数超过 32 的 JPEG 会被拒绝(AVATAR_TOO_COMPLEX)。正常从网页上传不受影响,前端会先归一化并压到 20KB 以内;直接调接口写入 base64 的脚本需要自行压缩。 - 使用记录导出的
.xlsx由write-excel-file生成:表头仍是第一行、列与顺序不变,token 数、耗时等数值列仍是数字单元格,金额列仍是 6 位小数的字符串。 - CodeBuddy 的流式请求现在受
gateway.stream_data_interval_timeout约束;本项设为 0 时 CodeBuddy 仍取 300 秒上限(Grok 为 180 秒)。若某些超长 prefill 场景被误判为卡住,可把该设置调大(上限 300 秒)。 - 自行构建:Go 1.27.3;前端需要 Node
^22.13.0或>=24与 pnpm 9.15.9,ESLint 走 flat config(pnpm lint无需额外参数)。 - Docker 镜像的 Go 构建阶段升到
golang:1.27.3-alpine,Node 构建阶段仍是node:24-alpine。
LinkSyncX 0.2.11.9
自定义版本:0.2.11.9
Docker 镜像:
docker pull ghcr.io/dreamforsh/linksyncx:0.2.11.9本版更新
Grok:Fast 定价与阶梯计费
- Grok 4.7 Fast:Grok Build 开启 Fast 后请求
grok-4.7-fast(旧名grok-4.7-build-fast)。此前它不在 Grok 账号的默认模型白名单里,会报无可用账号;即使放行,也按 grok-4.6 的标准价计费。- 现在经
cli-chat-proxy的 OAuth 账号会路由该模型,并列入默认模型列表。xAI 文档写明公开 API 和 Grok Build 免费档都不提供 Fast,所以走公开 API(api.x.ai及区域端点,API Key 账号默认如此)的账号和已知为免费档的 OAuth 账号即使白名单里有它也不承接,分组/v1/models和管理端的账号可用模型列表也不列出它。这类请求发到上游只会被拒绝,报错里的订阅字样还可能让整个账号冷却 30 分钟。 - Chat Completions 请求与 grok-4.7 一样走 Responses 桥接:带缓存键,图片输入不会丢失。
- 后台表单新建 Grok 账号时默认写入的模型白名单包含
grok-4.7-fast,预设映射新增“Grok 4.7 Fast”。已有账号的白名单见升级说明。 - 按官方 Fast 价卡计费:20 万 token 以下每百万 token $4 / 缓存 $1 / 输出 $12;达到 20 万后整单 $6 / $1.5 / $18(长上下文是标准价的 1.5 倍,不是 2 倍)。
- 现在经
- 已下线的 fast 型号:xAI 于 2026-05-15 下线的
grok-4-1-fast-*、grok-4-fast-*、grok-4-0709、grok-3仍可调用,会被重定向到grok-4.3并按其价格计费;grok-code-fast-1重定向到grok-build-0.1。网关此前把前几个按 grok-4.6 计费,grok-code-fast-1则查不到价格、记为 0;现在都按重定向目标计费。 - Priority Processing:请求带
service_tier: priority时,只有 xAI 响应确认priority才按 2 倍(或渠道配置的 Fast 倍率)计费。客户端传的fast会转成 xAI 接受的priority;flex等 xAI 没有的档位不再转发,也不再按半价计费。Grok Responses 主路径此前不记录服务档位,现在会记录。 - 别名与前缀:
grok-4.3-latest、grok-4.20-multi-agent(-latest)以及带xai/、x-ai/前缀的写法按对应模型计费;grok/grok-latest按运行时默认文本模型(设置项grok_default_text_model)计费。 - 价格目录:内置目录补齐 grok-4.7-fast、4.6、4.5、4.3、4.20 系列与 build-0.1 的条目及 20 万 token 阶梯价,渠道定价的“同步模型”可列出全部现行 Grok 模型。
Grok:流式传输与首 token 延迟
- 每轮请求发往上游前要改写请求体,这段耗时直接计入首 token 延迟。客户端工具适配、compaction 转换、显式 null 清理三步现在只在确有改动时才完整解析请求体:2 MB 对话历史从约 76 ms 降到约 44 ms,内存分配减半。
- Claude Code(
/v1/messages)与 Chat Completions 两条桥接:- 首 token 时间改为遵循后台“首 token 统计口径”设置,不再把
response.created等开场事件当作首 token(OpenAI 账号走这两条桥接时同样生效)。 - Grok 上游流卡住时与原生 Responses 接口一致:短暂冷却该账号;还没向客户端输出内容时切换账号重试;全局流空闲超时设为 0 时,Grok 仍使用默认 180 秒。
- 首 token 时间改为遵循后台“首 token 统计口径”设置,不再把
Grok:缓存命中率
- Grok Build 的旁路调用(turn-summary、title-refresh)在
x-grok-conv-id里带每次新生成的标签,而prompt_cache_key才是父会话。缓存键已按后者计算,但账号粘性仍按前者,旁路调用可能被派到没有该会话缓存的账号上全价重算。现在粘性同样优先prompt_cache_key。
Grok CLI 版本
- 内置 Grok CLI 版本从
1.0.62升到当前稳定版1.0.70,“Grok CLI version check”定时检查恢复通过。升级前对 1.0.70 原生客户端(交互式与 headless)抓包核对:请求头和请求体与 1.0.62 相同,只有Accept-Encoding多了zstd,网关仍交给传输层处理。 - 检测逻辑移入可本地运行的
.github/scripts/grok-cli-version-check.sh:按版本号大小比较,落后于 https://x.ai/cli/stable 才失败,超前只告警;同时校验固定版本格式、不低于最低可用版本CLIStableVersion、README 中声明的版本与代码一致,并在运行摘要里输出对照表。 - 修改相关文件的推送和 PR 也会触发检查;主 CI 增加一步离线一致性检查。
账号管理:卡片视图
- 账号列表工具栏新增“表格 / 卡片”切换,选择会被记住,默认仍为表格。
- 卡片带平台色条,展示状态、容量、用量窗口、今日统计、分组、代理、优先级等信息,显示项沿用“列显示”设置;支持多选、批量操作和排序(与表格共享排序状态),适配暗色模式和手机宽度。
渠道监控与使用记录
- 渠道监控 V2 的平台列表加入 CodeBuddy:迁移
261_channel_monitor_v2_codebuddy_platform.sql自动追加并启用(已配置过的保持不变),并补充名称、配色与图标。 - 使用记录新增输出速度(token/s):流式请求按首字之后的生成时间计算;非流式或输出几乎同时到达时按总耗时计算。
升级说明
- 本版包含数据库迁移
261_channel_monitor_v2_codebuddy_platform.sql,启动时自动执行。 - 计费口径变化:Grok 4.7 Fast、已下线的 fast 型号、
grok/grok-latest别名,以及 Grok 的 Priority / Flex 请求按上述规则计价。分组或渠道里为这些模型配置的自定义价格仍然优先。 - 首 token 统计口径:Messages / Chat Completions 桥接的首 token 时间会比此前大,这是口径修正(此前记的是开场事件的到达时间),不是性能退化。
- Grok CLI:内置版本已是
1.0.70。此前为它临时设置的XAI_GROK_CLI_VERSION可以删除。今后日志出现grok_cli_version_outdated时,把该变量设为 https://x.ai/cli/stable 的版本并重启即可恢复。 - 已有的 Grok OAuth 账号如果配置了模型白名单(后台表单新建的账号默认如此),白名单里没有
grok-4.7-fast。要让它承接 Fast,请在编辑账号时勾选该模型,或清空白名单改用默认映射。 grok-4.7-fast只交给走 Grok Build CLI 网关、且不是已知免费档的 OAuth 账号,以及自定义中转。分组里没有这类账号时,该模型的请求直接返回 404model_not_found,不再转发到上游。