OpenSkillIndex← back to search
claude-code

Lark-workflow-feishu-cli lark-workflow-doc-perm

文档权限管家：批量设置飞书文档权限，按角色或人员批量授权（可编辑/只读/完整权限），通知被授权用户。当用户需要'设置文档权限'、'批量授权'、'文档权限管理'、'分享文档给团队'、'文档权限配置'、'把文档分享给XX'时使用。

install
source · Clone the upstream repo
git clone https://github.com/liangdabiao/lark-workflow-feishu-cli
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/liangdabiao/lark-workflow-feishu-cli "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.claude/skills/lark-workflow-doc-perm" ~/.claude/skills/liangdabiao-lark-workflow-feishu-cli-lark-workflow-doc-perm && rm -rf "$T"
manifest: .claude/skills/lark-workflow-doc-perm/SKILL.md
source content

文档权限管家工作流

CRITICAL — 开始前 MUST 先用 Read 工具读取 

../lark-shared/SKILL.md
，其中包含认证、权限处理

适用场景

  • "把文档XXX分享给张三、李四，可编辑" / "设置文档权限"
  • "项目文档权限批量设置：工程组只读，产品组可编辑" / "批量授权"
  • "把这篇文档的编辑权限给整个团队" / "文档权限管理"
  • "分享文档给团队" / "文档权限配置"

前置条件

需要 user 身份（操作自己文档的权限）和 bot 身份（发消息通知）。执行前确保已授权：

lark-cli auth login --domain drive,wiki,contact,im

工作流

{文档 URL 或 file_token + 授权人列表 + 权限级别}
  │
  ├── [wiki 链接] wiki spaces get_node ──► 解析真实 token + obj_type
  │
  ├── drive permission.members create ──► 批量授权（逐个，间隔 1s）
  │
  └── im +messages-send ────────────────► 通知被授权用户

Step 1: 解析文档 token

wiki 链接处理

如果用户提供的是知识库链接（

https://xxx.feishu.cn/wiki/xxx
），先解析获取真实文档 token：

lark-cli wiki spaces get_node \
  --params '{"token":"<wiki_token>"}' \
  --as user

从返回结果中提取 

obj_token
（真实文档 token）和 
obj_type
（文档类型）。

直接 token

如果用户直接提供了文档 token（

doccnXXX
、
sheetXXX
、
bascnXXX
等），可直接使用。

确定文档类型

obj_type说明type 参数
docx
新版文档
docx
sheet
电子表格
sheet
bitable
多维表格
bitable
doc
旧版文档
doc
mindnote
思维导图
mindnote
file
文件
file

Step 2: 查找授权目标用户

lark-cli contact +search-user --query "<用户姓名>" --as user

记录每个用户的 

open_id
。支持批量查找多个用户。

Step 3: 设置权限

查看参数结构

lark-cli schema drive.permission.members.create

逐个授权

对每个用户调用一次（间隔 1 秒，避免频率限制）：

lark-cli drive permission.members create \
  --params '{"token":"<file_token>","type":"<doc_type>"}' \
  --data '{
    "member_type": "openid",
    "member_id": "ou_xxx",
    "perm": "edit"
  }' \
  --as user

权限级别：

perm 值说明适用场景
full_access
完整权限文档管理员、核心协作者
edit
可编辑需要修改文档的协作者
view
只读仅需查看的成员

按角色批量设置示例

# 工程组：只读
for user_id in "ou_aaa" "ou_bbb" "ou_ccc"; do
  lark-cli drive permission.members create \
    --params '{"token":"<file_token>","type":"docx"}' \
    --data "{\"member_type\":\"openid\",\"member_id\":\"$user_id\",\"perm\":\"view\"}" \
    --as user
  sleep 1
done

# 产品组：可编辑
for user_id in "ou_ddd" "ou_eee"; do
  lark-cli drive permission.members create \
    --params '{"token":"<file_token>","type":"docx"}' \
    --data "{\"member_type\":\"openid\",\"member_id\":\"$user_id\",\"perm\":\"edit\"}" \
    --as user
  sleep 1
done

重要：

  • 设置 
    full_access
    前必须与用户确认（安全规则）
  • 每次调用间隔至少 1 秒
  • 如果提示"无权限操作"，需要确认当前用户是文档所有者或管理员

Step 4: 通知被授权用户

lark-cli im +messages-send \
  --user-id "<user_open_id>" \
  --markdown "已为您开通文档「{文档标题}」的{权限级别}权限。

文档链接：{文档URL}

如有问题，请联系文档管理员。" \
  --as bot

注意：通知消息间隔 1 秒发送。如果授权人数超过 20 人，分批发送。

降级策略

场景降级方案
wiki 链接解析失败询问用户直接提供文档 token
用户查不到提示确认姓名，或直接使用 open_id
权限设置失败检查当前用户是否有文档管理权限
通知发送失败列出已授权用户，让用户手动通知
频率限制降低速度到每 2 秒一次

权限表

命令所需 scope
wiki spaces get_node
wiki:node:read
contact +search-user
contact:user.base:readonly
drive permission.members create
drive:drive:write
im +messages-send
im:message

参考