SuperAPI AI 工具集

lark-workflow-doc-perm

办公与效率

查看项目

更新于 10-16 06:23

技能介绍

用途:批量管理飞书文档权限,按人员或角色授予可编辑、只读或完整权限,并向被授权用户发送通知。适用于“把文档分享给某人”“项目文档权限批量设置”“分享文档给团队”等场景。

主要能力:解析知识库(wiki)链接获取真实文档 token 与类型;通过通讯录搜索用户并获取 open_id;逐个调用云空间权限接口批量授权;通过机器人发送消息通知被授权用户。支持 docx、sheet、bitable、doc、mindnote、file 等文档类型。

使用方式:开始前须先用 Read 工具读取 ../lark-shared/SKILL.md(含认证与权限处理)。需 user 身份(操作自己文档权限)和 bot 身份(发通知),执行前授权:lark-cli auth login --domain drive,wiki,contact,im。流程为:解析文档 token(wiki 链接用 lark-cli wiki spaces get_node --params '{"token":"<wiki_token>"}' --as user 获取 obj_token 与 obj_type);用 lark-cli contact +search-user --query "<用户姓名>" --as user 查找用户;用 lark-cli drive permission.members create 逐个授权,perm 可选 full_access、edit、view;最后用 lark-cli im +messages-send 通知。

限制与注意:设置 full_access 前必须与用户确认;每次调用间隔至少 1 秒,通知超过 20 人需分批;若提示无权限,需确认当前用户是文档所有者或管理员。降级策略包括:wiki 解析失败时请用户直接提供 token;查不到用户时确认姓名或直接用 open_id;通知失败时列出已授权用户手动通知;遇频率限制降至每 2 秒一次。所需 scope 包括 wiki:node:read、contact:user.base:readonly、drive:drive:write、im:message。