需配置定时任务实现workbuddy对飞书组织架构的增量自动同步：一、启用飞书三项读取权限并绑定；二、在客户端用“自动化计划”设每日10:15增量同步；三、通过飞书webhook定时事件触发；四、命令行直连提交带时间戳的增量指令。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望WorkBuddy持续反映飞书组织架构的最新变动（如新增成员、部门调整、角色变更），但当前仅支持手动触发同步，则需配置定时任务实现增量更新。以下是完成该目标的具体操作路径：
一、启用飞书组织架构读取权限并完成基础绑定
该步骤确保WorkBuddy具备合法访问飞书通讯录数据的权限，是后续自动同步的前提条件。飞书开放平台要求应用必须显式申请并审核通过「用户信息读取」「部门信息读取」「角色权限读取」三项权限，缺一不可，否则增量比对将因字段缺失而失败。
1、登录飞书开放平台管理后台，进入已创建的WorkBuddy自建应用详情页。
2、在「权限管理」→「添加权限」中，搜索并勾选「user:read」「department:read」「role:read」三项权限。
3、点击「提交审核」，确认弹窗中勾选「我已阅读并同意《飞书开放平台开发者协议》」，提交后等待状态变为「已生效」（通常1分钟内）。
4、返回WorkBuddy客户端，在「Claw 设置」→「飞书」配置页，点击「刷新权限状态」按钮，确认右侧显示「组织架构权限：已就绪」。
二、配置增量同步定时任务（内置自动化计划）
该方法利用WorkBuddy原生「自动化计划」功能，无需外部依赖，直接在客户端内设定周期性调用飞书组织架构API并执行差异比对。系统默认仅拉取变更时间戳晚于上一次同步的记录，避免全量重载。
1、在WorkBuddy主界面对话框中输入：每天上午10:15自动同步飞书组织架构，仅更新新增/变更/离职人员信息。
2、系统弹出计划预览面板，确认「数据源」为「飞书组织架构」、「同步模式」为「增量」、「执行时间」为「每天 10:15」。
3、点击「确认创建计划」，任务立即注册进本地调度队列。
4、进入「设置」→「自动化计划」列表，找到刚创建的任务，点击右侧「详情」图标，验证「上次执行时间」为空、「下次执行时间」为当日10:15。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
三、通过Webhook+飞书定时事件触发（高级可控模式）
该方案将同步触发权交由飞书平台自身，利用飞书「定时事件」能力每小时推送一次心跳信号至WorkBuddy API端点，再由WorkBuddy判断是否真正需要拉取变更。适用于对同步时效性要求高（如HR系统对接）且需规避客户端休眠导致漏执行的场景。
1、在WorkBuddy开发者中心开启「组织架构Webhook接收」开关，复制生成的专用Endpoint URL（形如https://api.codebuddy.cn/v1/hooks/fsync/xxxxx）。
2、登录飞书管理后台 → 「安全与管理」→「应用管理」→ 找到WorkBuddy应用 →「事件订阅」→「添加事件」。
3、在事件类型中勾选「user_update」「department_update」「role_update」，并将Endpoint URL粘贴至「请求URL」栏。
4、在「定时事件」模块中新建一项，设定「触发频率」为「每小时」，「触发时间」为「:05分」，「HTTP方法」为POST，Body内容为{"trigger":"hourly_sync"}。
5、保存后返回WorkBuddy「自动化计划」页面，确认「Webhook触发任务」状态栏显示「监听中｜最后心跳：刚刚」。
四、手动注入增量同步指令（命令行直连模式）
该方式绕过图形界面，直接向WorkBuddy底层调度器提交JSON格式的增量同步指令，适用于已部署在服务器环境或需嵌入CI/CD流程的运维人员。指令中强制指定last_modified_after参数，确保只处理指定时间之后的数据。
1、关闭WorkBuddy桌面客户端，确保无进程残留。
2、打开终端（Windows PowerShell / macOS Terminal），执行以下命令生成带时间戳的指令：
3、运行命令：curl -X POST http://localhost:3000/api/v1/sync/org -H "Content-Type: application/json" -d '{"source":"feishu","mode":"incremental","last_modified_after":"2026-04-08T10:15:00Z"}'。
4、重新启动WorkBuddy客户端，在「Claw 设置」→「同步日志」中查看最近一条记录，确认「同步类型」列为「增量」、「处理条目」大于0、「耗时」小于8秒。
