Feishu Cli Docs

飞书文档

只读取当前任务需要的工作流；跨步骤任务可以按顺序读取多个。 加载后，将工作流中的 references/、scripts/、templates/、examples/ 相对路径按该 workflow.md 所在目录解析；执行脚本时使用解析后的实际路径，不要依赖当前 shell 目录。

路由

关键边界

• “查看并总结”走 read；明确要求保存到路径才走 export。
• 从零写一篇文档走 author；只建空文档、原样写入用户给定的完整内容或改已有文档走 write。
• Markdown 转为可阅读 docx 走 import；把 .md 源文件原样存入云盘走 markdown。
• mindnote nodes create 只在已有思维笔记里新增/更新节点，不新建思维笔记；新建思维导图走 feishu-cli-visual 的画板。
• DOCX/XLSX 等二进制文件导入走 feishu-cli-storage 的 drive 工作流。
• doc htmlbox 属于 feishu-cli-visual；权限和转移所有权属于 feishu-cli-storage。

执行规则

1. /wiki/ 链接或类型不明的 token 先 drive inspect --url 解析；Bitable 链接用 bitable resolve。wiki 链接解析后区分 node_token 与底层文档 obj_token；底层是 sheet/bitable/slides 时按类型交给对应技能。
2. 修改已有文档一律用 doc content-update，不要用 doc import --document-id（只会追加到文末）；改几个字用文本级替换， 改章节或块先 doc read --with-ids 拿 block id。写入前确认目标、更新模式和影响范围；content-update 没有 dry-run， 不确定时先在测试文档上验证。
3. 写命令默认 Bot 身份：Bot 新建的文档会自动给当前登录用户授予 full_access（输出 permission_grant）；编辑用户自己的 文档而 Bot 无权限时，显式 --user-access-token "$(feishu-cli auth token --as user)"。读命令 User 优先、Bot 兜底。
4. 按退出码处理结果：2 = 参数或定位有歧义（选择器多处命中、方言占位无法写回、本地文件不存在），修正参数后重试； 1 且有失败明细（doc import 的 failures、content-update 的 partial_success、本地资源 failed）时按明细补齐， 不要整篇重导；10 = 危险操作缺 --yes（doc delete、doc history revert）。
5. 导入前读取 references/workflows/import/references/doc-guide.md。
6. 用户明确指定接收人时按其要求授权；其余按 write 工作流读取生效的 owner_email / transfer_ownership，仅在已配置 owner 时处理。未要求通知时在当前会话返回文档链接。

删除、覆盖类命令返回退出码 10 时，向用户确认目标与影响后追加全局 --yes 重跑，不要自行添加。身份或 scope 报错（如 99991663/99991668/99991672/99991679）读取 ../feishu-cli-platform/references/workflows/auth/references/identity.md；判断成败、编写脚本或处理确认门禁读取 ../feishu-cli-platform/references/workflows/auth/references/agent-contract.md。