转移飞书文档/多维表格的所有权给指定用户。触发场景:(1) 使用 feishu_doc 创建文档后自动转移所有权;(2) 用户说"把权限给我"或要求转移文档所有权时;(3) 使用 feishu_bitable_create_app 创建多维表格后。支持 docx / bitable / sheet / doc / file / wiki / slides 等所有飞书文档类型。
Feishu Ownership Transfer是一项面向实际任务的技能,主要用于飞书文档/多维表格创建后,默认所有者是机器人应用,本技能将所有权转移给请求用户;在技能根目录找到 .env.template 文件;
💡 其他用户拿到技能后,只需修改 .env 文件即可,无需改动脚本代码。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。
飞书文档/多维表格创建后,默认所有者是机器人应用,本技能将所有权转移给请求用户。
.env.template 文件.env:cp .env.template .env
.env,填入你的飞书应用凭证:FEISHU_APP_ID=你的_app_id FEISHU_APP_SECRET=你的_app_secret
.env 文件)💡 其他用户拿到技能后,只需修改
.env文件即可,无需改动脚本代码。
| 参数 | 值 |
|---|---|
member_type |
openid |
need_notification |
false |
old_owner_perm |
full_access |
remove_old_owner |
false |
| 参数 | 来源 | 说明 |
|---|---|---|
doc_token |
feishu_doc create 或 feishu_bitable_create_app 的返回值 |
文档/表格的 token |
member_id |
请求者的 open_id(从 inbound context 获取) |
目标用户 ID |
type |
根据创建的文档类型确定 | docx / bitable / sheet 等,见下方对照表 |
tenant_access_token |
动态获取,有效期 2 小时 | 访问令牌 |
文档类型对照表(type 参数)
| type 值 | 说明 |
|---|---|
docx |
飞书文档(新版) |
doc |
飞书文档(旧版) |
sheet |
飞书电子表格 |
bitable |
飞书多维表格 |
file |
飞书云盘文件 |
wiki |
飞书知识库节点 |
slides |
飞书幻灯片 |
python scripts/get_token.py
输出即为 token 字符串,例如:t-g1045mjWWISWX34URFVSZTJNYO62IMZLWKR7NX
⚠️ 关键:在同一个命令块内获取 token 并立即使用,不要分两次执行,否则 token 在变量传递过程中可能被截断。
python scripts/transfer_ownership.py
示例:
python scripts/transfer_ownership.py Ih47dSeNPozWkfxkFaCcHb2enwh ou_71d7e2ee2288104c1c92bbba1f42b4c1 docx t-g1045mjWWISWX34URFVSZTJNYO62IMZLWKR7NX
成功响应:
{ "code": 0, "data": {}, "msg": "Success" }
| 错误码 | 说明 | 处理 |
|---|---|---|
99991663 |
token 无效 | 重新获取 token,并确保同一命令块内使用 |
99991664 |
token 过期 | 重新获取 token |
scripts/get_token.py — 获取 tenant_access_token,Mac/Windows 通用,依赖 requestsscripts/transfer_ownership.py — 转移所有权,接受 4 个命令行参数参见 references/api_reference.md,包含完整的接口说明、请求/响应示例和错误码处理。
相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.1万人学习
共49课时 | 82.6万人学习