云文档创建 / 读取 / 分段更新。长文强制骨架 + @file。
新手失败几乎从不来自“命令记不住”,而来自 user/bot 混用、scope 过宽、以及未经审核的群聊外发。
安装 · doctor · 授权 · 至少 2 只读 + 1 低风险写入。
身份是谁 · 权限够不够 · 风险等级 · 失败如何补救。
默认私信审核人,禁止 Agent 擅自转发群聊。
访问本人日历、云空间、文档、任务等个人/协作资源。创建文档归属当前用户。
以应用名义操作。看不到用户个人云盘;消息以机器人身份发出。
云文档创建 / 读取 / 分段更新。长文强制骨架 + @file。
消息、群、搜索。默认只发审核人 open_id。
日程议程、忙闲、待办列表。日报草稿的只读入口。
云空间导入导出、权限、知识库节点。删除高风险。
多维表格与电子表格读写。clear 操作不可逆。
会议检索、妙记摘要与待办。外传前脱敏。
业务域以本机 lark-cli --help 为准。调用前必读对应 skill:lark-cli skills read lark-xxx。
agenda / fetch / search。新手第一天只做这些。
建文档、建任务、发私信审核。需确认对象 ID。
删除、覆盖、权限大改。先 --dry-run,人确认后 --yes。
confirmation_required 不是报错。禁止静默加 --yes 重试。
doctor → auth status --verify → whoami。耗时 ≤ 5 分钟,身份 openId 入日志。
docs +create --as user --doc-format markdown --content @./draft.md。相对路径,返回 URL。
im +messages-send --user-id <审核人>。禁止默认 --chat-id 群发。
待发送的飞书内容必须先发给指定审核人个人消息。AI / 脚本不得执行转发到群聊。审核通过后由本人决定是否转发。
把报错映射到动作:重登、换身份、补 scope、改相对路径、确认后 --yes。
先选 user/bot,再选 domain/scope,最后才写命令。
+命令 → 类型化资源 → api 逃生舱。高风险 dry-run。
个人审核通道为默认;每条关键操作留下 URL 或 message_id。