[Bug]

[ZhangChengJi]

版本 / Version

2.0.9

部署方式 / Deployment

自建服务器 / Self-hosted

问题描述 / What happened?

 API Error: 400 {"type":"error","error":{"type":"invalid_request_error","message":"Tool definitions are too large (79KB > 47KB). Reduce the number of tools or
shorten parameter schemas."}} Claude Code通过 windsurfAPI调用会报错这个

复现步骤 / Steps to reproduce

API Error: 400 {"type":"error","error":{"type":"invalid_request_error","message":"Tool definitions are too large (79KB > 47KB). Reduce the number of tools or
     shorten parameter schemas."}}  Claude Code通过 windsurfAPI调用会报错这个

<img width="1438" height="359" alt="Image" src="https://github.com/user-attachments/assets/e35e3d2b-ed3a-4514-9ba7-57a2d911a852" />

日志 / Logs

模型 / Model

No response

环境 / Environment

No response

[jiankong123]

Claude Desktop也是一样报错，是不支持吗API Error: 400 {"type":"error","error":{"type":"invalid_request_error","message":"Tool definitions are too large (87KB > 47KB). Reduce the number of tools or shorten parameter schemas."}}

[dwgx]

这个跟 #70 一样，根因在 v2.0.9 的 tool preamble 大小预算上。Claude Code 把 tools 全部塞进 system prompt 时，schema 一展开就 60–90KB，超过 Cascade 47KB 的硬限。

v2.0.10 起加了 compact preamble fallback —— 检测到原版 preamble 超预算就自动换成只列工具名 + 参数表的精简版（aict666 在 PR #54 / #51 那一系列里做的，现在主线和 GHCR 都是 v2.0.11）。

升级一下应该就好：

cd WindsurfAPI
git pull origin master
docker compose up -d --build

如果是 docker 部署直接 docker compose pull && docker compose up -d 也行，GHCR ghcr.io/dwgx/windsurf-api:latest 已经是 2.0.11。@jiankong123 同样升一下。

升完还报 47KB > 的话再开就行，那种是真的 tools[] 个数太多 compact 后还超，要再瘦一刀。

[dwgx]

v2.0.13 又出了，建议直接拉到这一版（不仅含 v2.0.10 的 compact tool preamble fallback，还修了 v2.0.12 引入的 cachePolicy 崩溃，所有 stream 客户端如 Cherry Studio 都受影响）：

docker compose pull && docker compose up -d

如果升完 47KB > 还在报，多半是 tools[] 个数太多 compact 后还超 hard cap，那就要瘦一刀工具数或把 schema 折叠 —— 留个详细日志再开新条更好定位。

[dwgx]

Tool definitions are too large (79KB > 47KB) 是 v2.0.9 的 hard cap 问题。

修复历程：

• v2.0.10 加了 compact fallback：超过 hard cap 自动剥掉 description/examples
• v2.0.26 进一步加了 schema-compact 和 skinny 两层 tier，先压字段再砍内容

测试覆盖 compact-before-hard-cap 和大 tools fixture（25+ 工具 70KB）。

请升级到 latest：

docker pull ghcr.io/dwgx/windsurfapi:latest

只有在 compact + schema-compact + skinny + names-only 全部降级后仍然超过 hard cap 的极端 case（一般要 50+ 工具）才需要新 issue。如果遇到，贴客户端 + 工具数即可。