Back to Details

feishu-perm

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Feishu Permission Manager

飞书权限管理器

Manage document/file permissions — add collaborators, set public link sharing, update access levels.
管理文档/文件权限 — 添加协作者、设置公开链接分享、更新访问权限等级。

Tool

工具

python3 .claude/skills/feishu-perm/scripts/perm_ctl.py <command> [args]
python3 .claude/skills/feishu-perm/scripts/perm_ctl.py <command> [args]

Commands

命令

bash
undefined
bash
undefined

List collaborators on a document

列出文档的协作者

perm_ctl.py list <token> --type <doc_type>
perm_ctl.py list <token> --type <doc_type>

Add a collaborator

添加协作者

perm_ctl.py add <token> --type <doc_type> --user <open_id_or_name> --perm <view|edit|full_access>
perm_ctl.py add <token> --type <doc_type> --user <open_id_or_name> --perm <view|edit|full_access>

Remove a collaborator

移除协作者

perm_ctl.py remove <token> --type <doc_type> --user <open_id> --member-type <openid|userid>
perm_ctl.py remove <token> --type <doc_type> --user <open_id> --member-type <openid|userid>

Get public sharing settings

获取公开分享设置

perm_ctl.py public-get <token> --type <doc_type>
perm_ctl.py public-get <token> --type <doc_type>

Set public sharing (link sharing)

设置公开分享（链接分享）

perm_ctl.py public-set <token> --type <doc_type> --link <tenant_readable|tenant_editable|anyone_readable|anyone_editable|off>
perm_ctl.py public-set <token> --type <doc_type> --link <tenant_readable|tenant_editable|anyone_readable|anyone_editable|off>

Transfer ownership

转移所有权

perm_ctl.py transfer <token> --type <doc_type> --user <open_id>
undefined
perm_ctl.py transfer <token> --type <doc_type> --user <open_id>
undefined

Permission Levels

权限等级

LevelDescription
view
Can view only
edit
Can view and edit
full_access
Can view, edit, manage permissions, and share
等级描述
view
仅可查看
edit
可查看和编辑
full_access
可查看、编辑、管理权限及分享

Doc Types

文档类型

Same as Drive: 
docx
, 
sheet
, 
bitable
, 
folder
, 
file
, 
slides
, 
mindnote
, 
wiki
.
与Drive一致：
docx
, 
sheet
, 
bitable
, 
folder
, 
file
, 
slides
, 
mindnote
, 
wiki
.

Link Sharing Options

链接分享选项

ValueDescription
tenant_readable
Anyone in organization can view
tenant_editable
Anyone in organization can edit
anyone_readable
Anyone with link can view
anyone_editable
Anyone with link can edit
off
Only collaborators can access
取值描述
tenant_readable
组织内任何人可查看
tenant_editable
组织内任何人可编辑
anyone_readable
拥有链接的任何人可查看
anyone_editable
拥有链接的任何人可编辑
off
仅协作者可访问

Behavior Notes

行为说明

  • --user
    accepts both raw open_id and contact names (resolved via shared ContactStore — contacts added in feishu-cal or feishu-task are available here too).
  • transfer
    changes ownership. The bot must have 
    full_access
    to transfer.
  • list
    shows all collaborators with their permission levels.
  • Bot needs 
    drive:permission
    , 
    drive:permission:readonly
    scopes.
  • --user
    参数支持原始open_id和联系人姓名（通过共享的ContactStore解析 — 在feishu-cal或feishu-task中添加的联系人也可在此使用）。
  • transfer
    命令用于转移所有权，机器人必须拥有
    full_access
    权限才能执行此操作。
  • list
    命令会显示所有协作者及其权限等级。
  • 机器人需要拥有
    drive:permission
    和
    drive:permission:readonly
    权限范围。