应检查并调整WorkBuddy的QPS限流阈值、验证飞书侧API熔断策略、启用本地缓存代理层；具体包括取消限流或设为8QPS、停用飞书策略中心的熔断规则、开启全局响应缓存并配置open.feishu.cn域名TTL为180秒。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在WorkBuddy安装完成后发现组织架构树为空或仅显示部分节点，则可能是由于API接口调用受到频率限制，导致增量同步请求被飞书服务端拒绝或截断。以下是解决此问题的步骤：
一、检查并调整WorkBuddy内置QPS限流阈值
WorkBuddy客户端默认启用令牌桶限流机制，若配置的QPS阈值低于飞书组织架构API所需的最小并发能力（如department.list接口建议不低于5次/秒），将造成批量拉取失败或超时中断。
1、进入WorkBuddy主界面，点击左下角头像打开【系统设置】→【集成中心】→【连接器管理】。
2、在连接器列表中定位飞书组织架构相关HTTP连接器（名称通常含“feishu-department”或“contact-sync”）。
3、点击【编辑】，在高级配置区域取消勾选【启用QPS限流】，或将其值修改为8次/秒且桶容量设为24。
4、保存配置后，重启WorkBuddy客户端使新限流参数生效。
二、验证飞书开放平台侧是否触发租户级API配额熔断
飞书超级管理员可在策略中心对第三方应用强制启用API调用熔断，该策略独立于应用权限配置，会直接拦截contact:department.list等关键接口，返回HTTP 429或空响应体，且不记录于常规审计日志中。
1、联系企业飞书超级管理员，登录飞书管理后台。
2、导航至【安全与合规】→【策略中心】→【API访问控制】。
3、查找是否存在针对WorkBuddy应用ID（格式类似cli_XXXXXXXXXXXXXX）的规则，确认其状态为已禁用或未匹配到任何策略条目。
4、若存在启用中的熔断规则，点击操作栏【停用】并等待策略同步完成（约2–3分钟）。
三、启用本地缓存代理层规避重复组织架构请求
WorkBuddy在初始化阶段可能因重试逻辑多次发起相同部门遍历请求，而飞书服务端将语义等价的重复请求计入QPS统计。通过启用本地响应缓存，可归一化请求指纹并复用前序成功响应，显著降低出站调用量。
1、进入【设置】→【集成中心】→【API缓存策略】。
2、开启【启用全局响应缓存】开关。
3、在【缓存键生成规则】中勾选包含请求路径哈希与忽略查询参数中的timestamp字段。
4、点击【+新增规则】，输入域名open.feishu.cn，设定TTL为180秒，并启用【强一致性校验】（自动比对ETag头）。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
