应精简cookie、重构metadata为base64+gzip编码、启用nginx代理剥离header、切换为bearer token认证。具体包括清除分析类cookie，将x-workbuddy-metadata替换为x-wb-meta-enc并压缩编码，nginx配置map规则截断header，改用短期bearer token替代冗余认证头。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当在WorkBuddy中配置自定义大模型（如混元、GLM-5.0、Kimi等）时，若通过HTTP方式调用本地或私有API服务，出现“Request header is too large”错误，通常源于携带的Cookie、Authorization、X-Metadata等自定义请求头字段体积超标。以下是解决此问题的具体操作路径：
一、精简并清理无效Cookie
WorkBuddy在调用外部模型API时，可能继承浏览器会话或系统级Cookie，尤其在调试阶段反复切换账号或绑定多个平台（企业微信/飞书/钉钉）后，Cookie累积易超限。需主动清除冗余项，仅保留必需身份凭证。
1、打开WorkBuddy客户端，进入「设置」→「高级」→「网络调试」页签。
2、点击「查看当前请求Cookie」按钮，弹出原始键值对列表。
3、识别并勾选非必要项，例如：_ga、_gid、utm_source、session_temp_id等分析类或临时会话字段。
4、点击「清除所选Cookie」，确认操作后重启WorkBuddy主进程。
二、重构Metadata传递方式
WorkBuddy支持在请求头中注入自定义Metadata（如模型版本标识、用户上下文ID、任务类型标签），但若以明文JSON字符串形式写入单一Header字段（如X-WorkBuddy-Metadata），极易突破8KB默认限制。应改用分段压缩+Base64编码策略，降低原始字节长度。
1、将原始Metadata对象结构化为固定字段集，剔除嵌套过深或动态生成的冗余键。
2、使用UTF-8编码后进行Gzip压缩，再做Base64编码，确保最终字符串长度控制在≤1024字符以内。
3、在WorkBuddy模型配置页的「自定义Header」区域，将原X-WorkBuddy-Metadata字段替换为：X-WB-Meta-Enc，值填入上述编码结果。
4、后端API需同步增加解码逻辑：接收X-WB-Meta-Enc → Base64解码 → Gzip解压 → JSON解析。
三、启用Header代理剥离机制
对于已部署Nginx或反向代理的私有模型服务，可在网关层拦截并清洗请求头，避免超长Header透传至上游应用服务器。该方式无需修改WorkBuddy配置，适用于无法直接控制客户端行为的管控环境。
1、编辑Nginx配置文件，在对应server块内添加map指令定义过滤规则：
2、在location /v1/chat/completions块中，加入proxy_set_header指令，显式覆盖原始X-WorkBuddy-Metadata为截断后版本。
3、执行nginx -t验证语法，确认无误后运行nginx -s reload热重载配置。
4、验证方式：在WorkBuddy中发起一次测试请求，抓包检查上游服务实际收到的Header总长度是否＜6144字节。
四、切换为Bearer Token轻量认证
若当前使用Cookie或复杂JWT携带完整用户上下文导致Header膨胀，可改用短期有效的Bearer Token机制。Token本身仅含用户ID与签名，体积稳定可控，且符合RFC 6750标准，兼容所有主流模型服务框架。
1、登录WorkBuddy管理后台，进入「安全中心」→「API令牌」，点击「生成新令牌」。
2、选择有效期为24小时，勾选「仅用于模型调用」权限范围，生成后立即复制Token值。
3、在模型配置页的「认证方式」下拉菜单中，选择「Bearer Token」，粘贴刚复制的值。
4、删除原配置中所有以Cookie=、X-User-Context=开头的Header行，保存配置并重启连接。
