Distilly飞书自动采集教程一键蒸馏同事的消息、文档与多维表格含私聊OAuth配置详解【免费下载链接】distillyDistilly — Distill how they think into reusable Skills for any Agent or Bot. Formerly Colleague Skill原同事 Skill.项目地址: https://gitcode.com/gh_mirrors/co/distillyDistilly 飞书自动采集是开源项目 Distilly原同事 Skill内置的数据采集能力只需输入同事姓名它就能通过飞书 API 自动拉取该同事的群聊消息、私聊消息、文档/Wiki 和多维表格并整理成统一格式直接送入 Distilly 蒸馏流程生成可复用的 Agent Skill 人物画像。本教程面向新手从零讲清配置、采集与私聊 OAuth 授权全流程无需手写任何代码。为什么选择 Distilly 的飞书自动采集很多团队的知识散落在飞书里群聊里的技术方案、私聊里的决策讨论、文档里的设计评审、多维表格里的项目排期。当关键同事离职或转岗这些经验往往随之流失。Distilly 的定位是「把一个人怎么思考蒸馏成 Agent 可复用的 Skill」。其中飞书Lark是唯一支持全自动 API 采集的办公平台——输入姓名即可无需浏览器登录或手动导出采集项是否自动说明群聊消息✅自动找到同事所在的共同群聊只提取该同事发出的消息私聊消息✅需 OAuth以用户身份拉取保留双方对话上下文文档 / Wiki✅按创建人搜索并拉取正文内容多维表格✅自动遍历表、字段与记录转为 Markdown 表格 消息只保留文字类内容自动过滤「[图片]」「[语音]」等占位消息长消息观点/决策类与日常短消息会分类归档方便后续蒸馏权重分配。一键安装与初始化最快配置方法第 1 步安装 Distilly将仓库克隆到 Agent 的 Skill 目录即可git clone https://gitcode.com/gh_mirrors/co/distilly ~/.agents/skills/distilly pip3 install -r requirements.txt核心依赖只有requests见 requirements.txt飞书自动采集零额外依赖。各宿主的详细安装路径见 INSTALL.md。第 2 步创建飞书企业自建应用在飞书开放平台创建一个企业自建应用并在权限管理中开通以下权限--setup命令运行时会完整打印这份清单类别权限用途消息im:message:readonly读取群聊消息消息im:chat:readonly读取群聊信息消息im:chat.members:readonly读取群成员消息用户权限im:message私聊采集以用户身份读消息消息用户权限im:chat私聊采集读取会话列表用户contact:user.base:readonly读取用户基本信息用户contact:department.base:readonly按姓名搜索同事必需文档docs:doc:readonly读取文档文档wiki:wiki:readonly读取知识库文档drive:drive:readonly搜索云盘文件多维表格bitable:app:readonly读取多维表格⚠️两个关键前提① 需将应用的 Bot 加入目标群聊Bot 才有权限读取群消息② 按姓名搜索同事必须开通部门遍历权限否则请用邮箱或手机号作为搜索词。第 3 步初始化配置python3 tools/feishu_auto_collector.py --setup按提示输入 App ID 和 App Secret配置会加密权限0600保存到~/.distilly/feishu_config.json。如果你已有旧版~/.colleague-skill/目录的 token采集器会自动回退读取无需重新配置。一条命令完成飞书数据采集配置完成后只需运行python3 tools/feishu_auto_collector.py --name 张三 --output-dir ./knowledge/zhangsan采集器会依次执行 7 步搜索用户 → 匹配共同群聊 → 拉取群消息 → 拉取私聊消息 → 搜索文档/Wiki → 拉取文档正文 → 汇总输出。可选参数--msg-limit 1000消息条数上限默认 1000--doc-limit 20文档篇数上限默认 20--open-id ou_xxx直接指定用户 open_id跳过搜索输出结果长什么样采集完成后./knowledge/zhangsan/目录下会生成三个文件knowledge/张三/ ├── messages.txt # 分类消息长消息观点/决策 日常消息 私聊对话上下文 ├── docs.txt # 文档与Wiki正文含标题、链接、创建人 └── collection_summary.json # 采集摘要用户ID、部门、文件清单、时间其中messages.txt会自动把私聊消息按时间正序重排并标注[张三]/[对方]发言人保留完整对话语境——这正是蒸馏「表达方式」的关键素材。私聊采集 OAuth 配置详解新手必看为什么私聊需要额外配置因为飞书的安全机制应用身份tenant_access_token无权访问私聊会话私聊消息必须通过user_access_token以你个人身份授权获取。整个过程分 3 步Step 1确认用户权限已开通回到飞书开放平台确认应用已开通「用户权限」im:message和im:chat注意是用户权限而非应用权限见上表。Step 2浏览器 OAuth 授权获取 code在浏览器打开飞书开放平台的 OAuth 授权地址格式为https://open.feishu.cn/open-apis/authen/v1/authorize参数包含你的 App ID 与授权范围im:message im:chat可从--setup的终端提示中直接复制。登录并授权后页面会跳转到你设置的回调地址地址栏中的code参数就是授权码复制它。Step 3用 code 换取 token 并写入配置python3 tools/feishu_auto_collector.py --exchange-code {CODE}成功后终端会显示✅ user_access_token 已保存token 自动写入配置文件。最后补上私聊会话 IDoc_开头可通过飞书发送消息 API 的返回值获取python3 tools/feishu_auto_collector.py --name 张三 --p2p-chat-id oc_xxx或者把p2p_chat_id提前写入配置文件之后每次采集自动带上私聊。完整实现可查看 tools/feishu_auto_collector.py。 如果只想采集私聊、跳过用户搜索还支持--open-id ou_xxx --p2p-chat-id oc_xxx --name 张三组合效率最高。多维表格是怎么被采集的对于同事维护的项目排期表、需求池等多维表格Bitable采集器会遍历该表格应用下的所有数据表读取每张表的字段定义与全部记录将每条记录转换为 Markdown 表格自动转义单元格内的|和换行符。这意味着「表格里的判断依据」也能进入蒸馏语料让生成的 Skill 不仅懂同事怎么说还懂他怎么排优先级。常见问题排查现象原因与解决「未能找到用户」未开通contact:department.base:readonly或改用--name usercompany.com邮箱搜索群消息为 0 条Bot 未被加入相关群聊把应用机器人拉进群即可有 token 却提示「跳过私聊采集」配置中缺少p2p_chat_id参考上文 OAuth 三步补齐内部文档拉不到换用浏览器方案 tools/feishu_browser.py复用登录态或 MCP 方案 tools/feishu_mcp_client.py选型指南见 INSTALL.md从采集到蒸馏最后一步材料采集完成后回到你的 AgentClaude Code、Hermes、OpenClaw、Codex 等均可见 SKILL.md说Use Distilly to create a Person Profile for张三.Distilly 会读取./knowledge/张三/下的消息与文档按 colleague 家族的六层人格结构硬规则 → 身份 → 表达 → 决策 → 人际 → 纠偏蒸馏出 Work Skill Persona并打包成可安装、可版本回滚、可持续追加材料的 Agent Skill。从此那位同事的思考方式就是你的 Agent 的常驻能力。 相关延伸阅读docs/lang/README_ZH.md中文版项目说明【免费下载链接】distillyDistilly — Distill how they think into reusable Skills for any Agent or Bot. Formerly Colleague Skill原同事 Skill.项目地址: https://gitcode.com/gh_mirrors/co/distilly创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考