用途:通过 feishu-cli 管理飞书云文档权限,包括添加/更新/删除/查看协作者、公开权限管理、分享密码、批量添加、权限检查与转移所有权。
主要能力:基础操作有 perm add、perm update、perm list、perm delete;高级操作有 perm batch-add(从 JSON 文件批量添加)、perm transfer-owner、perm auth(检查 view/edit/share/comment/export 权限);公开设置有 perm public-get、perm public-update、perm password create/update/delete。权限级别为 view、edit、full_access;协作者类型支持 email、openid、userid、unionid、openchat、opendepartmentid、groupid、wikispaceid,IM 风格别名自动映射。
使用方式:需先安装 feishu-cli 并配置 App ID 与 App Secret(环境变量或 ~/.feishu-cli/config.yaml),无需 auth login。常用命令如 feishu-cli perm add <TOKEN> --doc-type docx --member-type email --member-id user@example.com --perm edit --notification。--doc-type 默认 docx,非 docx 文档必须显式指定,否则按 docx 处理导致 API 报错。
适用场景:给文档授权、查看协作者、管理外部访问与链接分享、设置分享密码、批量授权、转移所有权等。
限制:需在飞书开放平台申请对应 scope(如 docs:permission.member:create 等);分享密码为企业版功能;转移所有权仅文档所有者或管理员可操作;Token 前缀需与 doc-type 匹配。