上游同步（第二轮：9a87758 → ea8b1e5，只吸收底层）
任务类实现我们本就领先（开学季 5/5 vs 上游 4/5），本轮专注底层。
出站头族对齐官方桌面端
- UA 三段式：
WorkBuddy/5.5.4 WorkBuddy/5.5.4 CLI/2.137.1（对齐官方 WorkBuddy Desktop RestOperations 形状；client_version/cli_version可配） - 用量归属头：
X-IDE-Name/Type/Version+X-Agent-Purpose: conversation——client_name配WorkBuddy后 chat 请求与官方客户端头组同形（官网「使用端」归因更准） - 设备风控头：
X-Device-Token三源注入（每号 auth 文件device_token键 > config > 文件兜底），无 token 时优雅降级不注入
净化增强（减少 400 拦截）
- tool_calls 盲区修复：工具调用轮的 content 为 null，此前整条跳过净化——历史里写进工具参数的被拦字符串会漏出导致 400
- 11128 反探测改写：请求体含裸数字 11128（上游内部错误码）会被整单拦截，现自动改写为 11-128
- 桌面版身份句/反馈句：补上逗号形态身份句与非 CLI 版反馈句的改写覆盖
并发与调度修复
- clientIP 竞态修复：客户端 IP 改按请求参数传递（原共享字段方案并发请求会交叉污染），配合新增
passthrough_ip开关（默认关，反代安全边界） - 粘性按模型判活：账号被 6004 单模型限额后，换模型请求自动解绑重分配（治「限额后换不动号」）
- /healthz 探活修正：全号被单模型限流但其他模型可用时，不再误报 503
- 签到幂等：识别「今天已签到」（code=10001/14001），日志不再把重复签到当失败
- report 增强：活跃上报支持独立 requestID（同会话多轮可区分）
未吸收（有意跳过）
上游脚本体系（task_runner/开学季脚本——我们已有更完整的纯 API 实现）、AI issue 治理 action、CI 定时打包、成本账本选号（收益待验证）。
配置新增（全部可选，留空即默认）
"upstream": {
"client_version": "", // 默认对齐官方 5.5.4
"cli_version": "", // 默认对齐官方内置 CLI 2.137.1
"client_name": "", // 配 "WorkBuddy" 启用 X-IDE-* 归属四头
"device_token": "", // 设备风控头全局兜底
"device_token_file": "", // 或从文件读取（桌面端落盘）
"passthrough_ip": false // 透传客户端 IP（反代场景按需开）
}