组织架构树无法加载是因飞书应用缺少contact:contact.base:readonly权限、可见范围过窄、本地权限未同步、管理员策略限制或token失效；需依次检查权限配置、可见范围、刷新workbuddy权限、确认策略中心设置并查看日志定位具体错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在WorkBuddy飞书版中无法加载或显示组织架构树，则极可能是由于飞书应用未被授予读取通讯录基础信息的权限，或权限范围受限导致API调用被拒绝。以下是针对性排查与修复步骤：
一、确认飞书应用已启用并正确配置「联系人」类权限
组织架构树依赖飞书开放平台提供的租户级联系人接口（如contact:contact.base:readonly），若该权限未声明或未生效，WorkBuddy将无法拉取部门、成员等层级数据。
1、登录飞书开放平台，进入对应WorkBuddy企业自建应用的详情页。
2、点击左侧菜单栏「权限管理」，切换至「已开启权限」标签页。
3、在「租户权限（Tenant Scopes）」列表中，查找是否存在contact:contact.base:readonly条目；若缺失，需立即补入。
4、若该权限存在但状态为「待审批」或「已拒绝」，点击右侧操作栏「申请开通」，由企业管理员完成审批流程。
二、检查应用可见范围是否覆盖组织架构所需部门
即使权限已声明，飞书仍会依据「应用可见范围」对可访问的成员与部门做二次过滤。若范围设置过窄（如仅限某几个部门），则组织架构树将仅显示部分节点或完全为空。
1、返回应用「基本信息」页面，定位「应用可见范围」设置项。
2、确认当前选择为本企业全部成员；若为「指定部门」或「指定角色」，请扩展至包含所有需展示架构的部门。
3、点击「保存」按钮，注意页面右上角无红色提示且出现绿色成功提示后才算生效。
三、验证WorkBuddy端是否同步最新权限状态
WorkBuddy客户端缓存了飞书授权时的权限快照，若飞书侧权限已更新但本地未刷新，仍将沿用旧权限上下文发起请求，从而导致组织架构接口返回空数据或403错误。
1、打开WorkBuddy客户端，点击右上角个人头像，进入Claw Settings。
飞书任务管理工具，支持任务的创建、查询、更新、删除及清单的管理。适用场景：创建/管理任务与清单、查看任务列表或清单中的任务、用户提及任务、待办、to‑do、清单、task时、设置负责人和关注等。
2、在左侧导航栏选择「Integration Status」。
3、找到飞书集成项，点击Refresh Permissions按钮。
4、等待状态栏显示「Permissions synced successfully」，随后重启WorkBuddy主窗口。
四、排除飞书管理员策略级限制
部分企业启用了飞书「超级管理员策略中心」，可对第三方应用强制关闭特定API能力，此类限制优先级高于应用自身权限配置，且不会在开放平台界面中显式体现。
1、联系贵司飞书超级管理员，确认是否启用了「禁止第三方应用读取组织架构」策略。
2、请其登录飞书管理后台，在「策略中心」→「API与集成策略」中搜索关键词contact.base。
3、若对应策略状态为「已启用」且作用范围包含当前应用，需临时禁用或添加WorkBuddy应用ID至白名单。
五、手动触发组织架构同步并查看错误日志
WorkBuddy在首次加载组织架构时会记录详细网络请求与响应，通过本地日志可快速识别是权限不足、Token失效还是服务端拒接。
1、在WorkBuddy安装目录下定位logs/feishu-integration.log文件（通常位于C:\Users\[用户名]\AppData\Local\WorkBuddy\logs\）。
2、使用文本编辑器打开，搜索关键词get_department_tree或403 Forbidden。
3、若日志中出现"error_code": 99999, "description": "No permission to access contact"，即明确指向权限缺失问题。
4、若出现"error_code": 160001，则表明Verification Token不匹配，需回到飞书后台重新生成并同步至WorkBuddy配置页。
