Chargement
Chargement
Skills
飞书云文档(Docx / Wiki 文档):读取和编辑飞书文档内容。当用户给出文档 URL 或 token,或需要查看、创建、编辑文档、插入或下载文档图片附件时使用。文档中嵌入的电子表格、多维表格、画板,先用本 skill 提取 token 再切到对应 skill。当用户给出 doubao.com 的 /docx/ 或 /wiki/ URL/token 时,也应直接使用本 skill;路由依据是 URL 路径模式和 token,而不是域名。不负责文档评论管理,也不负责表格或 Base 的数据操作。当用户明确要操作飞书思维笔记时,也使用本 skill。
À propos de cette ressource
--- name: lark-doc version: 2.0.0 description: "飞书云文档(Docx / Wiki 文档):读取和编辑飞书文档内容。当用户给出文档 URL 或 token,或需要查看、创建、编辑文档、插入或下载文档图片附件时使用。文档中嵌入的电子表格、多维表格、画板,先用本 skill 提取 token 再切到对应 skill。当用户给出 doubao.com 的 /docx/ 或 /wiki/ URL/token 时,也应直接使用本 skill;路由依据是 URL 路径模式和 token,而不是域名。不负责文档评论管理,也不负责表格或 Base 的数据操作。当用户明确要操作飞书思维笔记时,也使用本 skill。" metadata: requires: bins: ["lark-cli"] cliHelp: "lark-cli docs --help;lark-cli mindnotes --help" ---
身份:文档操作默认使用 `--as user`。首次使用前执行 `lark-cli auth login`。
```bash
lark-cli docs +fetch --doc "文档URL或token;若 URL 存在 #share-... 锚点,优先使用锚点方式读取,不要全文拉取" lark-cli docs +create --content '<title>标题</title><p>内容</p>' lark-cli docs +update --doc "文档URL或token" --command append --content '<p>内容</p>' ```
CRITICAL — 执行对应操作前,MUST 先用 Read 工具读取以下文件,缺一不可:
--scope / --detail 选择、局部读取策略、<fragment> / <excerpt> 输出结构)未读完以上文件就执行相应操作会导致参数选择错误或格式错误。
格式选择规则(全局): - 创建 / 导入场景(docs +create,或docs +update --command append/overwrite的整段写入):XML 和 Markdown 都可以。用户提供.md本地文件、或明确说"导入 Markdown"时,直接用 Markdown;否则默认 XML。 - 精准编辑场景(docs +update的str_replace/block_insert_after/block_replace/block_delete/block_move_after等局部精修指令):优先使用 XML(--doc-format xml,即默认值)。XML 能稳定表达 block 结构和样式,局部精修更可控;不要因为 Markdown 更简单就自行切换。
lark-cli drive files copy;不要用 docs +fetch + docs +create 重建正文,也不要走 drive +export / drive +import。docs +fetch 默认 simple;明确旧文本 → 新文本直接 str_replace;只有 block 链接、评论锚点、插入 / 替换 / 删除 / 移动才局部 fetch with-ids;保真改写已有内容才读 full文档基础 URL#block_id;没有 block_id 时局部 fetch with-idsoverwrite / block_replace / block_delete 后不要复用受影响的旧 ID,插入 / 复制后要重新 fetch 才能拿到新 block IDlark-cli docs +media-previewlark-cli docs +media-downloadrevision_id 或某一时刻 → 先读 `lark-doc-history.md`,按其中流程操作lark-cli docs +resource-download/+resource-update/+resource-delete --type coverresource-* 目前仅支持 Docx 封面资源;其他图片、附件或素材请走 +media-*lark-cli docs +media-download --type whiteboard(不要用 +media-preview)lark-sheets 做对象内部操作lark-drive 处理<sheet>、<bitable> 或 <cite file-type="sheets|bitable"> 标签时 → 必须主动提取 token 并切到对应技能下钻读取内部数据,不能只呈现标签本身| 标签 / 属性 | 提取字段 | 切到技能 | |-|-|-| | <sheet token="..." sheet-id="..."> | token -> spreadsheet_token, sheet-id | `lark-sheets` | | <bitable token="..." table-id="..."> | token -> app_token, table-id | `lark-base` | | <cite type="doc" file-type="sheets" token="..." sheet-id="..."> | 同 <sheet> | `lark-sheets` | | <cite type="doc" file-type="bitable" token="..." table-id="..."> | 同 <bitable> | `lark-base` | | <vc-transcribe-tab vc-node-id="..."> | vc-node-id -> note_id | `lark-note`:先 note +detail --note-id <vc-node-id> | | <synced_reference src-token="..." src-block-id="..."> | src-token -> doc_token, src-block-id -> block_id | 用 docs +fetch 读取 src-token 文档,定位 block |
Shortcut 是对常用操作的高级封装(lark-cli docs +<verb> [flags])。有 Shortcut 的操作优先使用。
| Shortcut | 说明 | |----------|------| | `+create` | Create a Lark document (XML / Markdown) | | `+fetch` | Fetch Lark document content (XML / Markdown / im-markdown; im-markdown only after fetch for lark-im) | | `+update` | Update a Lark document (str_replace / block_insert_after / block_replace / ...) | | `+history-list` / `+history-revert` / `+history-revert-status` | List document history, revert to a history_version_id, and query revert task status | | `+media-insert` | Insert a local image or file at the end of a Lark document (4-step orchestration + auto-rollback). Prefer --from-clipboard when the image is already on the system clipboard (screenshots, copy from Feishu/browser); use --file only for on-disk sources. | | `+media-download` | Download document media or whiteboard thumbnail (auto-detects extension) | | `+media-preview` | Preview document media file (auto-detects extension) | | `+resource-download` / `+resource-update` / `+resource-delete` | Download, update, or delete a Docx cover image resource with --type cover | | `+whiteboard-update` | Alias of whiteboard +update. Update an existing whiteboard with DSL, Mermaid or PlantUML. Prefer whiteboard +update; refer to lark-whiteboard skill for details. |
Connecte-toi pour laisser un commentaire.