feishu-cli-perm by riba2534/feishu-cli
npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-perm飞书云文档权限管理:添加/更新/删除/查看协作者、公开权限管理、分享密码、批量添加、权限检查、转移所有权。
~/.feishu-cli/config.yaml)。无需 auth login(User Token 不适用于权限管理 API)。| scope | 说明 |
|---|---|
docs:permission.member:create |
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
| 添加协作者 |
docs:permission.member:readonly | 查看协作者列表 |
docs:permission.member:delete | 删除协作者 |
docs:permission.setting:write | 更新公开权限、密码管理 |
drive:drive | 云空间文件操作(含转移所有权) |
# 给用户添加编辑权限(最常用操作)
feishu-cli perm add <TOKEN> --doc-type docx --member-type email --member-id user@example.com --perm edit --notification
# 查看文档协作者列表
feishu-cli perm list <TOKEN> --doc-type docx
# 删除指定协作者
feishu-cli perm delete <TOKEN> --doc-type docx --member-type email --member-id user@example.com
| 命令 | 说明 |
|---|---|
perm add | 添加协作者权限 |
perm update | 更新已有协作者的权限级别 |
perm list | 查看协作者列表 |
perm delete | 删除协作者 |
| 命令 | 说明 |
|---|---|
perm batch-add | 从 JSON 文件批量添加协作者 |
perm transfer-owner | 转移文档所有权 |
perm auth | 检查当前用户对文档的权限 |
| 命令 | 说明 |
|---|---|
perm public-get | 查看文档公开权限设置 |
perm public-update | 更新公开权限(外部访问、链接分享等) |
perm password create | 创建分享密码 |
perm password update | 刷新分享密码 |
perm password delete | 删除分享密码 |
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>
feishu-cli perm list <TOKEN> --doc-type <DOC_TYPE>
feishu-cli perm delete <TOKEN> \
--doc-type <DOC_TYPE> \
--member-type <MEMBER_TYPE> \
--member-id <MEMBER_ID>
feishu-cli perm batch-add <TOKEN> \
--members-file <members.json> \
[--notification]
members.json 格式:
[
{"member_type": "email", "member_id": "user1@example.com", "perm": "edit"},
{"member_type": "email", "member_id": "user2@example.com", "perm": "view"}
]
feishu-cli perm transfer-owner <TOKEN> \
--member-type <MEMBER_TYPE> \
--member-id <MEMBER_ID> \
[--notification] \
[--remove-old-owner] \
[--stay-put] \
[--old-owner-perm <view|edit|full_access>]
| 参数 | 默认值 | 说明 |
|---|---|---|
--notification | true | 通知新所有者 |
--remove-old-owner | false | 移除原所有者权限 |
--stay-put | false | 文档保留在原位置 |
--old-owner-perm | full_access | 原所有者保留权限(仅 remove-old-owner=false 时生效) |
feishu-cli perm auth <TOKEN> --action <ACTION> [--doc-type <DOC_TYPE>]
可用的 action 值:view、edit、share、comment、export
feishu-cli perm public-get <TOKEN>
feishu-cli perm public-update <TOKEN> \
[--external-access] \
[--link-share-entity <anyone_readable|anyone_editable|...>]
feishu-cli perm password create <TOKEN> [--doc-type <DOC_TYPE>]
feishu-cli perm password update <TOKEN> [--doc-type <DOC_TYPE>]
feishu-cli perm password delete <TOKEN> [--doc-type <DOC_TYPE>]
| 值 | 说明 | 使用场景 |
|---|---|---|
view | 查看权限 | 只读分享给外部人员或大范围分享,保护文档不被误改 |
edit | 编辑权限 | 团队协作编辑,日常最常用的权限级别 |
full_access | 完全访问权限 | 管理员权限,包含管理协作者、文档设置、导出、查看历史版本等全部能力 |
| 值 | 别名(IM 风格) | 说明 | 使用场景 | 示例 |
|---|---|---|---|---|
email | — | 邮箱 | 最常用 ,精确到个人 | user@example.com |
openid | open_id | Open ID | 通过开放平台获取的用户 ID | ou_xxx |
userid | user_id | User ID | 企业内部用户 ID | 123456 |
unionid | union_id | Union ID | 跨应用统一 ID | on_xxx |
openchat | chat_id | 群聊 ID | 按群聊授权 ,群内所有成员获得权限 | oc_xxx |
opendepartmentid | — | 部门 ID | 按部门授权 ,部门内所有成员获得权限 | od_xxx |
groupid | — | 群组 ID | 用户组 | gc_xxx |
wikispaceid | — | 知识空间 ID | 知识库空间 | ws_xxx |
IM API 风格别名(
open_id、user_id、union_id、chat_id)会自动映射为标准值,两种写法等效。
| 值 | 说明 |
|---|---|
docx | 新版文档(默认) |
doc | 旧版文档 |
sheet | 电子表格 |
bitable | 多维表格 |
wiki | 知识库 |
file | 文件 |
folder | 文件夹 |
mindnote | 思维笔记 |
minutes | 妙记 |
slides | 幻灯片 |
| 前缀 | doc-type |
|---|---|
| docx_ | docx |
| doccn | doc |
| sht_ | sheet |
| bascn | bitable |
| wikicn | wiki |
| fldcn | folder |
feishu-cli perm add docx_xxxxxx \
--doc-type docx \
--member-type email \
--member-id user@example.com \
--perm edit \
--notification
feishu-cli perm update docx_xxxxxx \
--doc-type docx \
--member-type email \
--member-id user@example.com \
--perm full_access
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 transfer-owner docx_xxxxxx \
--member-type email \
--member-id user@example.com \
--old-owner-perm view
feishu-cli perm public-update docx_xxxxxx \
--external-access \
--link-share-entity anyone_readable
# 1. 授予完全访问权限
feishu-cli perm add <TOKEN> \
--doc-type docx \
--member-type email \
--member-id user@example.com \
--perm full_access \
--notification
# 2. 转移文档所有权
feishu-cli perm transfer-owner <TOKEN> \
--doc-type docx \
--member-type email \
--member-id user@example.com \
--notification
| 错误 | 原因 | 解决方法 |
|---|---|---|
Permission denied / 权限不足 | App 未开通相关权限 scope | 在飞书开放平台 -> 权限管理中申请 docs:permission.member:create 等权限 |
doc-type mismatch / Token 无效 | doc-type 与实际文档类型不匹配 | 检查 Token 前缀:docx_ -> docx、sht_ -> sheet、bascn -> bitable |
member not found | member-id 不存在或 member-type 不正确 | 确认邮箱/ID 正确,注意 email 类型需要用户的飞书注册邮箱 |
password create: Permission denied | 分享密码为企业版功能 | 确认企业是否开通此功能,或联系管理员开启 |
transfer-owner: no permission | 只有文档所有者或管理员可转移 | 先用 perm list 确认当前 App 身份,确保是文档创建者 |
perm add 命令的详细参数枚举和输入检查清单见 references/add_permission.md。
Weekly Installs
158
Repository
GitHub Stars
497
First Seen
Feb 11, 2026
Security Audits
Installed on
claude-code133
codex65
kimi-cli61
gemini-cli61
amp61
github-copilot61
Skills CLI 使用指南:AI Agent 技能包管理器安装与管理教程
33,600 周安装