docs (v1) CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md ，其中包含认证、权限处理 核心概念 文档类型与 Token 飞书开放平台中，不同类型的文档有不同的 URL 格式和 Token 处理方式。在进行文档操作（如添加评论、下载文件等）时，必须先获取正确的 file_token 。 文档 URL 格式与 Token 处理 URL 格式 示例 Token 类型 处理方式 /docx/ https://example.larksuite.com/docx/doxcnxxxxxxxxx file_token URL 路径中的 token 直接作为 file_token 使用 /doc/ https://example.larksuite.com/doc/doccnxxxxxxxxx file_token URL 路径中的 token 直接作为 file_token 使用 /wiki/ https://example.larksuite.com/wiki/wikcnxxxxxxxxx wiki_token ⚠️ 不能直接使用 ，需要先查询获取真实的 obj_token /sheets/ https://example.larksuite.com/sheets/shtcnxxxxxxxxx file_token URL 路径中的 token 直接作为 file_token 使用 /drive/folder/ https://example.larksuite.com/drive/folder/fldcnxxxx folder_token URL 路径中的 token 作为文件夹 token 使用 Wiki 链接特殊处理（关键！） 知识库链接（ /wiki/TOKEN ）背后可能是云文档、电子表格、多维表格等不同类型的文档。 不能直接假设 URL 中的 token 就是 file_token ，必须先查询实际类型和真实 token。 处理流程 使用 wiki.spaces.get_node 查询节点信息 lark-cli wiki spaces get_node --params '{"token":"wiki_token"}' 从返回结果中提取关键信息 node.obj_type ：文档类型（docx/doc/sheet/bitable/slides/file/mindnote） node.obj_token ： 真实的文档 token （用于后续操作） node.title ：文档标题 根据 obj_type 使用对应的 API obj_type 说明 使用的 API docx 新版云文档 drive file.comments. 、 docx. doc 旧版云文档 drive file.comments. sheet 电子表格 sheets. bitable 多维表格 bitable. slides 幻灯片 drive. file 文件 drive. mindnote 思维导图 drive. 查询示例
查询 wiki 节点
lark-cli wiki spaces get_node
--params
'{"token":"wiki_token"}'
返回结果示例：
{
"node"
:
{
"obj_type"
:
"docx"
,
"obj_token"
:
"xxxx"
,
"title"
:
"标题"
,
"node_type"
:
"origin"
,
"space_id"
:
"12345678910"
}
}
资源关系
Wiki Space (知识空间)
└── Wiki Node (知识库节点)
├── obj_type: docx (新版文档)
│ └── obj_token (真实文档 token)
├── obj_type: doc (旧版文档)
│ └── obj_token (真实文档 token)
├── obj_type: sheet (电子表格)
│ └── obj_token (真实文档 token)
├── obj_type: bitable (多维表格)
│ └── obj_token (真实文档 token)
└── obj_type: file/slides/mindnote
└── obj_token (真实文档 token)
Drive Folder (云空间文件夹)
└── File (文件/文档)
└── file_token (直接使用)
绘图需求识别与挖掘
用户很少主动提"画板"——
默认
使用飞书画板承载图表，命中以下任一信号即触发：
用户提到图表类型：架构图、流程图、时序图、组织图、路线图、对比图、鱼骨图、飞轮图、思维导图等
用户表达可视化意图：画一下、梳理关系、画个流程、给我一个图、方便汇报等
文档主题涉及结构关系、流程走向、时间线、数据对比
以下场景不加图：用户明确拒绝、合同/法律条款/合规声明等严谨连续文本、原样转录任务。
[!CAUTION]
命中后，
MUST
先读取
references/lark-doc-whiteboard.md
并
严格按其流程执行
。
绝对禁止
用
whiteboard-cli
渲染 PNG 后通过
docs +media-insert
插入文档——图表必须通过
lark-cli whiteboard +update
写入画板 block，这是唯一合法路径。
快速决策
用户说“看一下文档里的图片/附件/素材”“预览素材”，优先用
lark-cli docs +media-preview
。
用户明确说“下载素材”，再用
lark-cli docs +media-download
。
如果目标明确是画板 / whiteboard / 画板缩略图，只能用
lark-cli docs +media-download --type whiteboard
，不要用
+media-preview
。
用户说“找一个表格”“按名称搜电子表格”“找报表”“最近打开的表格”，先用
lark-cli docs +search
做资源发现。
docs +search
不是只搜文档 / Wiki；结果里会直接返回
SHEET
等云空间对象。
拿到 spreadsheet URL / token 后，再切到
lark-sheets
做对象内部读取、筛选、写入等操作。
用户说“给文档加评论”“查看评论”“回复评论”“给评论加表情 / reaction”“删除评论表情 / reaction”，
不要留在
lark-doc
，直接切到
lark-drive
处理。
补充说明
docs +search
除了搜索文档 / Wiki，也承担“先定位云空间对象，再切回对应业务 skill 操作”的资源发现入口角色；当用户口头说“表格 / 报表”时，也优先从这里开始。
Shortcuts（推荐优先使用）
Shortcut 是对常用操作的高级封装（
lark-cli docs +