Repository navigation
Releases
v2.2.0
- 合并上游 v2.0.4 – v2.1.3(110 个文件,+15394 / -1612):
- v2.1.3:CodeArts 并发占满改为有界排队(busy_wait_seconds 默认 10,超时 429 带 reset_at)、工具 Schema 关键字类型纠偏(修上游 code 11129)、清理合并遗留的重复顶层定义、运营活动任务自动化(星巴克 3 次小程序 + 专家对话、记者节 expert / interview-material-organizer / playbook_prompt_send)、活动与成长任务解耦、skill_share 真实技能分享、template_5 真实场景。
- v2.1.2:请求列表失败详情与服务端筛选、CodeArts 请求积分按差值结算、WB_SANITIZE_LOOSE_BILLING 宽松计费头兜底、Key 级日 token 限量 daily_token_limit、Key 并发上限改有界排队(WB_CHAT_SLOT_WAIT 默认 30)、面板回显 concurrency_limit、WB_MSGSTAT_SHARDS 单发 /v1/messages 稳定亲和键、第 2 轮继承第 1 轮绑定。
- v2.1.1 / v2.1.0:设备 Token 与桌面 chat 兼容头、文本 / 媒体号池隔离(pool_separation_enabled)、历史思考镜像、空文本段补位、Responses 历史推理保真、订阅桥接、一键启动工作台等。
- 本分支增强全部保留:请求来源 IP 全链路(access / chat / usage 行)、面板「来源 IP」聚合视图与按地区搜索、来源 IP 归属地(wb_client_geo.py,ip-api.com 主 / pconline 兜底,40 次/分钟限速、7 天缓存、client_geo_enabled 开关)、账号池排队等待(account_queue_seconds)、池子超半数熔断自动探活(auto_probe_percent)、上游超时首字节 45 秒 / 流中空闲 90 秒、listen backlog 1024、OpenWrt PKG_VERSION 跟随源码。
- 版本号:2.2.0(本分支独立递增;上游 v2.1.x 与本分支 v2.1.1 无对应关系,历史同名 tag 不再改动)。
- 全量测试:314 个套件:234 个 Python + 80 个 JS,
311 passed, 3 failed, 0 skipped(3 项均为 v2.1.1 基线已有的历史失败:_test_breaker_fairness、_test_egress_backoff、_test_pool_backoff,与本次合并无关)。
下载说明
-
workbuddy2api-hub-v2.2.0.zip- 通用便携版(Python 源码 + 看板 + 启动脚本)
- Windows / macOS / Linux
- 需要 Python 3.9+
- 内置 Windows amd64、macOS 与 Linux amd64 / arm64 的 Go/uTLS bridge
- 未设置 TLS 模式时默认 auto;桥不可用时自动回退 Python,无需安装 Go
- 解压后使用对应平台的启动脚本
-
workbuddy2api_2.2.0-1_all.ipk- OpenWrt 的 opkg 系安装包
- 适用于对应受支持的旧版 OpenWrt 路线
-
workbuddy2api-2.2.0-r1.apk- OpenWrt 25.x+ 的 apk-tools 安装包
-
SHA256SUMS- Release 资产的 SHA-256 校验值
v2.1.1
- 来源 IP 自动显示地区:面板「请求记录」的来源 IP 列与「来源 IP」聚合视图现在给地址配上归属地(如「江苏 苏州」),内网地址显示「内网」、本机回环显示「本机」。查询走新增的
wb_client_geo.py(ip-api.com 为主、whois.pconline.com.cn 兜底),只在后台线程里跑并受 40 次 / 分钟限速,结果落usage/client-geo.json缓存 7 天(失败退避 10 分钟,上限 2000 条);面板只读缓存,查不到就空着,请求路径从不等待这次查询。新增设置开关client_geo_enabled(默认开;关闭只停新查询,已有缓存照旧显示)、/ip/geo?ips=补查接口,「请求记录」的搜索框也能按地区筛选。 - 全量测试:293 个套件:221 个 Python + 72 个 JS,
293 passed, 0 failed, 0 skipped。
下载说明
-
workbuddy2api-hub-v2.1.1.zip- 通用便携版(Python 源码 + 看板 + 启动脚本)
- Windows / macOS / Linux
- 需要 Python 3.9+
- 内置 Windows amd64、macOS 与 Linux amd64 / arm64 的 Go/uTLS bridge
- 解压后使用对应平台的启动脚本
-
workbuddy2api_2.1.1-1_all.ipk- OpenWrt 的 opkg 系安装包
- 适用于对应受支持的旧版 OpenWrt 路线
-
workbuddy2api-2.1.1-r1.apk- OpenWrt 25.x+ 的 apk-tools 安装包
-
SHA256SUMS- Release 资产的 SHA-256 校验值
v2.1.0
合并上游 ardeyouxipianyi/workbuddy2api-hub 的 v2.0.1 – v2.0.3(49 个提交),本分支此前的全部增强原样保留。
- 合并上游基线:可选 Go/uTLS 传输桥、设备 Token 与桌面 chat 兼容头、文本号池 / 媒体号池分区(#841)、历史思考镜像、空文本段先补位(#840)、Responses 历史推理保真(#831)、订阅桥接(#830)、一键启动工作台(#771)、国际版 DeepSeek 出站别名、CodeArts 出口徽章与模型准入、Clash fake-IP 放行等。
- 本分支增强(已在生产使用):请求来源 IP 全链路(access / chat / usage 行)与面板「来源 IP」聚合视图;账号池排队等待(
account_queue_seconds)与 listen backlog 1024;池子超半数账号被本地熔断关着时自动探活(auto_probe_percent);上游超时收紧到首字节 45 秒 / 流中空闲 90 秒;OpenWrtPKG_VERSION跟随源码。 - 版本号策略:本分支从 2.1.0 起独立递增,避免与上游 2.0.x 的 tag 撞名(历史上本分支已发布的 v2.0.1–v2.0.7 与上游同名 tag 指向不同提交)。
- 全量测试:291 个套件:220 个 Python + 71 个 JS,
291 passed, 0 failed, 0 skipped。
下载说明
-
workbuddy2api-hub-v2.1.0.zip- 通用便携版(Python 源码 + 看板 + 启动脚本)
- Windows / macOS / Linux
- 需要 Python 3.9+
- 内置 Windows amd64、macOS 与 Linux amd64 / arm64 的 Go/uTLS bridge
- 解压后使用对应平台的启动脚本
-
workbuddy2api_2.1.0-1_all.ipk- OpenWrt 的 opkg 系安装包
- 适用于对应受支持的旧版 OpenWrt 路线
-
workbuddy2api-2.1.0-r1.apk- OpenWrt 25.x+ 的 apk-tools 安装包
-
SHA256SUMS- Release 资产的 SHA-256 校验值
v2.0.7
下载说明
-
workbuddy2api-hub-v2.0.7.zip- 通用便携版(Python 源码 + 看板 + 启动脚本)
- Windows / macOS / Linux
- 需要 Python 3.9+
- 解压后使用对应平台的启动脚本
-
workbuddy2api_2.0.7-1_all.ipk- OpenWrt 的 opkg 系安装包
- 适用于对应受支持的旧版 OpenWrt 路线
-
workbuddy2api-2.0.7-r1.apk- OpenWrt 25.x+ 的 apk-tools 安装包
-
SHA256SUMS- Release 资产的 SHA-256 校验值
v2.0.6
变更
高并发把账号池烧干是「突然全部请求失败」的主因:十天里 no usable account ... every candidate is disabled, cooling 出现 248 次,占全部请求错误的 29%。上游按「账号 + 分钟」计 token,突发请求压满少数账号后触发 429、账号被停放,池子里一个可用号都不剩,于是每个请求都立刻拿到 503;客户端的重试又在账号刚恢复的瞬间把新名额抢空,越忙越死。
- 池子没号时排队等待:新增设置
account_queue_seconds(面板「设置 → 稳定性」,0–120 秒,默认 0 = 保持老行为)。挑不出账号时不再立刻失败,而是每 100 毫秒重挑一次、最多等 N 秒,等到名额才发出去。并发数不变,只是这一批慢几秒;「挨个账号都试过且全部失败」(上游真故障)仍然不排队、直接报错。 - listen backlog 128 → 1024:几百个客户端同时重连(客户端重启、上游掐连接后的批量重试)时 128 深的 accept 队列会溢出,内核丢 SYN、客户端按 1 秒粒度重传。队列条目只占内核内存、不占服务端线程,远低于
somaxconn的 4096。 - 测试:新增
tests/_test_account_queue.py(8 项),_test_http_limits的 backlog 断言同步。
完整测试
281 passed, 0 failed, 0 skipped(python tests/run_all.py --jobs 4)。
校验
sha256sum -c SHA256SUMSv2.0.5
上游超时收紧:首字节 120 → 45 秒,流中空闲 300 → 90 秒。
排查「带宽没吃满却长时间不响应」时发现:上游掐连接后单条请求能空转到 1401–1935 秒才报 stream aborted: [Errno 110] Connection timed out,这段时间里请求连同它的并发槽位一直被占着,重试也迟迟不开始。
- 首字节 45 秒:实测 43 万字节请求体的首字节只要 1–3 秒,45 秒足够覆盖 connect / TLS / 上传请求头。
- 流中空闲 90 秒:实测推理增量间隔约 40 毫秒,90 秒静默已是它的两千倍,只有流真的死掉才会触发。
- 两项都可在面板「设置 → 上游」改回原来的 120 / 300。
- OpenWrt 包版本号同步到 2.0.5(release 门禁要求 tag / 源码 / Makefile 三者一致)。
测试
tests/_test_upstream_timeouts.py 17 项通过,全量 280 passed / 0 failed / 0 skipped。
资产
workbuddy2api-hub-v2.0.5.zip:便携包(60 个受管文件 + CPython 3.12.15 运行时)SHA256SUMS:校验文件
下载说明
-
workbuddy2api-hub-v2.0.5.zip- 通用便携版(Python 源码 + 看板 + 启动脚本)
- Windows / macOS / Linux
- 需要 Python 3.9+
- 解压后使用对应平台的启动脚本
-
workbuddy2api_2.0.5-1_all.ipk- OpenWrt 的 opkg 系安装包
- 适用于对应受支持的旧版 OpenWrt 路线
-
workbuddy2api-2.0.5-r1.apk- OpenWrt 25.x+ 的 apk-tools 安装包
-
SHA256SUMS- Release 资产的 SHA-256 校验值
v2.0.4
社区维护版 2.0.4(基于 v2.0.3,280 个测试套件)。
变更
- 数据看板新增「来源 IP」聚合视图:「请求记录」只能看单条请求的来源地址,看不出一个客户端一共用了多少、用了哪几个号,也看不出某个号被哪些客户端用过。现在「数据看板」多了一张「来源 IP」表(请求数 / Token / 账号数 / 最近活动),下面折叠一张「账号 → 来源 IP」反查表。
- 新增接口
/usage/by-client-ip:整份usage.jsonl按client_ip增量折叠,一次给出两个方向(ips与accounts);载荷挂 15 秒 TTL + ETag,面板 5 秒一轮的轮询多数落在 304 上。 client_ip字段上线前的历史行归入「(未知)」并标注「IP 上线前」,不当作真实地址统计;错误行不计入(与「按账号」同口径)。- 新增
tests/_test_client_ip_analytics.py(16 项)与tests/_test_client_ip_panel.js(10 项);tests/_test_dashboard_refresh.js的计数改为只数 analytics 请求(这一轮现在还顺带取来源 IP 载荷)。
验证
- Python 侧:206 passed / 4 failed / 70 skipped。四个失败与本次改动无关:其中
_test_run_all_encoding因本机无node,另三个(breaker / egress / pool 退避)是时序敏感的偶发失败,同一份代码在 v2.0.3 上同样失败。 - JS 侧:70 个套件全过。
tests/_test_release_engineering.py7/7。- 隔离端口冒烟:
/health200 且crypto_ok: true、面板 200 且含「来源 IP」表、真实端到端deepseek-v4.1-flash返回「收到」、usage 行带client_ip、/usage/by-client-ip两个方向排序正确且条件请求返回 304。
升级
- 便携包:解压覆盖
wb-proxy/即可。 - 自动更新:更新器指向本仓库的 Release 后自动取包。
v2.0.3
社区维护版 2.0.3(基于 v2.0.2,278 个测试套件全绿)。
变更
- 面板「请求记录」新增「来源 IP」列:新行直接显示来源地址,历史行(没有
client_ip字段)显示 —,悬停可见完整值;搜索框同步支持按 IP 过滤;英文界面显示Source IP,正體中文由字级转换得到「來源 IP」。 - 新增
tests/_test_recent_client_ip.js(5 个断言)。
验证
python tests/run_all.py:278 passed / 0 failed / 0 skipped。- 隔离端口冒烟:面板 200、表格渲染出该列、真实端到端请求
deepseek-v4.1-flash正常返回。
升级
- 便携包:解压覆盖
wb-proxy/即可。 - 自动更新:更新器指向本仓库的 Release 后自动取包。
v2.0.2
社区维护版 2.0.2(基于 v2.0.1 + 本次改动,共 277 个测试套件全绿)。
变更
- 请求来源 IP 全链路可见:access 日志改为「来源 IP + 请求行」,
chat:/chat done:与媒体完成行带ip=,usage 行新增client_ip字段。- 反代后按
X-Real-IP→X-Forwarded-For首跳解析真实客户端;只有对端是回环地址或WB_TRUSTED_PROXIES显式列出的代理才采信这些头,公网客户端伪造头无效。 - 解析不出时退回 socket 对端地址,日志里不会出现空字段。
- usage 行只在调用方拿得到时写
client_ip,未传参的调用点与历史行形状完全不变,无需迁移数据。
- 反代后按
- 新增
tests/_test_client_ip_logging.py(10 个断言)。
验证
python tests/run_all.py:277 passed / 0 failed / 0 skipped。- 隔离端口实机冒烟:
/health200(crypto_ok: true)、面板 200、真实端到端请求deepseek-v4.1-flash返回「收到」;日志实测chat: ip=127.0.0.1 ...与chat done: ... ip=127.0.0.1 ...,usage 行实测含"client_ip": "127.0.0.1"。
升级
- 便携包:解压覆盖即可(
wb-proxy/内文件)。 - 自动更新:把
WB_UPDATE_REPO指到本仓库后,更新器会从这里的 Release 取包。
v2.0.1:社区接管首个版本(合并 PR #813-#819)
v2.0.1 — 社区接管首个版本
基线:ardeyouxipianyi/workbuddy2api-hub v2.0.0(上游 2026-11-06 宣布停止维护)
本版本 = v2.0.0 + 社区 PR #813–#819(均来自 @qq928820655,原作者已不再处理)。
合并的修复
- #813 fix(dispatch): 400 透传前归还账号并发名额,修 11-128 后账号被永久跳过(生产级)
- #814 fix(accounts): 网关重启后旧筛选不再把账号列表过滤成空
- #815 fix(dashboard): 加宽权重列,值不再被裁掉
- #816 fix(dashboard): 自绘下拉面板被祖先裁剪、移动端出口/权重格挤压
- #817 fix(log): responses 行同时打客户端与实际生效的推理强度
- #818 feat(log): 记录 chat 请求到达时刻,而不只是完成时刻
- #819 fix(dashboard): 手机端账号区三处布局修正
其它
- 版本号统一为 2.0.1(
server_version与 overview version) - README 更新徽章、测试套件计数(276 套件:208 Python + 68 JS)与接管说明
验证
- 新增测试全过:
_test_account_concurrency26、_test_responses_effort_log5、_test_chat_head_trace5 - 全量
tests/run_all.py:203 passed / 68 skipped;余下失败项已在未改动基线上复现,非本版本引入 - 发布门禁
_test_release_engineering:7/7 通过 - 冒烟:7865 端口启动,
/health200(crypto_ok)、面板 200、/v1/models正常
资产
workbuddy2api-hub-v2.0.1.zip(60 个受管文件 + python/ 运行时 3.12.15 + release-manifest.json)SHA256SUMS
自建更新源
服务器 systemd 更新器读 WB_UPDATE_REPO,改成本仓库即可从本 Release 自动更新:
# /etc/workbuddy2api-hub-updater.env
WB_UPDATE_REPO=M-strange/workbuddy2api-hub