WorkBuddy实现飞书文档互通，即AI自动读取、加工并回传文档：需开通三项飞书权限；通过链接或标题获取文档；本地大模型处理指令；支持覆盖、新建或追加保存；最后通过版本历史、操作日志和多端验证确认互通成功。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
WorkBuddy实现飞书文档互通，核心是让AI能读取飞书文档内容并生成、修改、保存新文档，全程无需手动打开飞书网页或客户端——你发一句指令，它就自动拉取原文、加工内容、回传到指定飞书文档里。
第一步：确认飞书权限已开通
在飞书开放平台进入你的WorkBuddy应用 →「权限管理」→ 检查是否已勾选以下三项：【im:document:readonly】（读取文档）、【im:document:write】（创建/编辑文档）、【im:document:share】（分享链接）。缺一不可，否则后续所有操作都会报“无权限访问文档”。
注意：如果企业管理员关闭了第三方应用访问文档的开关，即使这里勾选了也无效。必须由管理员在「飞书管理后台→安全与权限→API权限控制」中将WorkBuddy加入白名单。
第二步：让WorkBuddy读取指定飞书文档
在飞书聊天窗口中，直接把目标文档链接发给WorkBuddy机器人，例如：“https://www.feishu.cn/docx/xxx”。
它会自动解析URL中的doc_id，调用飞书OpenAPI拉取文档正文、标题、作者、最后编辑时间等元数据。这个过程依赖上一步开通的im:document:readonly权限，没有该权限时只会返回空内容或403错误。
如果你只发了文档名称没给链接，WorkBuddy会尝试按标题模糊搜索——但仅限你本人有编辑权限的文档，且不支持跨部门或公开文档检索。
第三步：用自然语言指令生成或改写文档
发送指令如：“把刚才的会议纪要重写成面向管理层的300字摘要，保留决策项和责任人”。
WorkBuddy会调用本地大模型处理文本，过程中不会上传原始内容到公网，所有推理均在你电脑本地完成。输出结果默认为纯文本，若需保留格式（如加粗、列表、引用块），必须在指令中明确写出“保留原有标题层级”“用项目符号列出行动项”等要求。
这一步不依赖飞书权限，纯本地运算。但若指令含“插入表格”“添加超链接”等操作，后续保存时才会触发im:document:write权限校验。
第四步：将结果存回飞书文档
方法一：覆盖原文档
发送“覆盖保存到原文档”。WorkBuddy调用飞书API的PUT /document/v1/documents/{document_id}/content接口，直接替换正文，保留原有评论、@人、版本历史。
方法二：新建文档并分享
发送“新建文档，标题为‘XX会议精简版’，存到‘行政部-归档’文件夹，分享给张三和李四”。它会先创建文档，再调用POST /contact/v3/users/batch_get查收件人user_id，最后用POST /document/v1/documents/{doc_id}/share设权限——整个流程要求im:document:write和im:document:share同时生效。
方法三：插入到现有文档末尾
发送“追加到原文档末尾，加分割线和时间戳”。此操作走的是追加模式，不会影响原文档已有段落格式，适合日志类连续记录场景。
第五步：验证文档是否真正互通成功
第一步：在飞书网页端打开刚操作的文档 → 点击右上角「⋯」→「查看版本历史」，确认最新版本由“WorkBuddy Bot”创建或修改。
第二步：回到WorkBuddy界面 → 左侧边栏点「最近操作」→ 找到对应任务 → 点击「详情」查看完整API调用日志，重点核对status_code: 200和response.body.document_id字段是否非空。
第三步：用另一台未登录WorkBuddy的设备，登录同一飞书账号，打开该文档——如果能看到最新内容，说明同步链路完全打通；如果仍显示旧内容，大概率是飞书服务端缓存未刷新，等待30秒后手动下拉刷新即可。
