飞书权限管理技能

为飞书云文档添加或更新协作者权限。

适用场景

• 给飞书文档添加协作者权限
• 批量授权脚本化
• 明确协作者类型、权限级别、是否通知

命令格式

添加权限

feishu-cli perm add <TOKEN> \
  --doc-type <DOC_TYPE> \
  --member-type <MEMBER_TYPE> \
  --member-id <MEMBER_ID> \
  --perm <PERM> \
  [--notification]

更新权限

feishu-cli perm update <TOKEN> \
  --doc-type <DOC_TYPE> \
  --member-type <MEMBER_TYPE> \
  --member-id <MEMBER_ID> \
  --perm <PERM>

参数说明

doc-type（云文档类型）

member-type（协作者 ID 类型）

perm（权限角色）

可选参数

• --notification：添加权限后通知对方

示例

按邮箱添加用户为编辑者

feishu-cli perm add docx_xxxxxx \
  --doc-type docx \
  --member-type email \
  --member-id user@example.com \
  --perm edit \
  --notification

按 Open ID 添加用户查看权限

feishu-cli perm add docx_xxxxxx \
  --doc-type docx \
  --member-type openid \
  --member-id ou_xxxxxx \
  --perm view

给群聊添加编辑权限

feishu-cli perm add sht_xxxxxx \
  --doc-type sheet \
  --member-type openchat \
  --member-id oc_xxxxxx \
  --perm edit

按部门添加查看权限

feishu-cli perm add sht_xxxxxx \
  --doc-type sheet \
  --member-type opendepartmentid \
  --member-id od_xxxxxx \
  --perm view

更新已有权限

feishu-cli perm update docx_xxxxxx \
  --doc-type docx \
  --member-type email \
  --member-id user@example.com \
  --perm full_access

执行流程

1. 收集文档信息

   • 获取文档 Token（从 URL 或用户提供）
   • 确定 doc-type（根据 Token 前缀判断）

2. 收集协作者信息

   • 确定 member-type（邮箱最常用）
   • 获取 member-id

3. 选择权限级别

   • view：仅查看
   • edit：可编辑
   • full_access：完全访问

4. 执行命令

   • 可选添加 --notification 通知对方

Token 前缀对应关系

常见默认操作

创建文档后自动授权：

# 创建文档后，给指定用户添加完全访问权限
feishu-cli perm add <doc_token> \
  --doc-type docx \
  --member-type email \
  --member-id user@example.com \
  --perm full_access \
  --notification