用途
feishu-perm 用于管理飞书（Feishu）文档和文件的权限。当用户提到共享、权限或协作者时，可激活该工具。它通过单一工具 feishu_perm 完成权限相关操作。
主要能力
该工具支持三类操作：
列出协作者
调用示例：
{ "action": "list", "token": "ABC123", "type": "docx" }
返回结果包含成员信息：member_type、member_id、perm、name。
添加协作者
调用示例：
{ "action": "add", "token": "ABC123", "type": "docx", "member_type": "email", "member_id": "user@example.com", "perm": "edit" }
移除协作者
调用示例：
{ "action": "remove", "token": "ABC123", "type": "docx", "member_type": "email", "member_id": "user@example.com" }
支持的令牌类型
| 类型 | 说明 |
|---|---|
| doc | 旧格式文档 |
| docx | 新格式文档 |
| sheet | 电子表格 |
| bitable | 多维表格 |
| folder | 文件夹 |
| file | 上传的文件 |
| wiki | 知识库节点 |
| mindnote | 思维笔记 |
支持的成员类型
| 类型 | 说明 |
|---|---|
| 邮箱地址 | |
| openid | 用户 open_id |
| userid | 用户 user_id |
| unionid | 用户 union_id |
| openchat | 群聊 open_id |
| opendepartmentid | 部门 open_id |
权限级别
| 权限 | 说明 |
|---|---|
| view | 仅查看 |
| edit | 可编辑 |
| full_access | 完全访问（可管理权限） |
使用方式
示例：通过邮箱共享文档
{ "action": "add", "token": "doxcnXXX", "type": "docx", "member_type": "email", "member_id": "alice@company.com", "perm": "edit" }
示例：将文件夹共享给群组
{ "action": "add", "token": "fldcnXXX", "type": "folder", "member_type": "openchat", "member_id": "oc_xxx", "perm": "view" }
配置
channels: feishu: tools: perm: true # default: false (disabled)
注意：该工具默认禁用，因为权限管理是敏感操作。如有需要请显式启用。
所需权限
drive:permission
适用场景
适用于需要在飞书环境中管理文档、文件夹、表格、多维表格、知识库节点等对象共享权限的场景，例如将文档共享给指定邮箱用户、将文件夹共享给群聊、查看现有协作者列表或移除协作者。
限制
该工具默认处于禁用状态，需要显式启用；使用前需要具备 drive:permission 权限。关于收费、价格、平台支持范围等信息，资料中暂未提供。