# Lark Whiteboard

> 飞书画板：查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用多种格式更新画板内容。 当用户需要查看画板内容、导出画板图片、编辑画板时使用此 skill。不负责：飞书云文档内容编辑（lark-doc）、文档内嵌电子表格/Base（lark-sheets / lark-base）。

Source: https://skillsagentes.com/skills/larksuite/cli/lark-whiteboard
Repository: https://github.com/larksuite/cli
Author: larksuite
License: MIT
Updated: hace 8 días
Context cost: 93 tok installed, 779 tok once triggered, 57.4k tok with every bundled file
Bundle: 31 files, 224 KB
Permissions requested: none declared

## Install

```bash
npx -y skills add larksuite/cli --skill lark-whiteboard --agent claude-code
```

## What it does

- Consulta y exporta pizarras (whiteboard) de Feishu/Lark como imagen preview, SVG vectorial o código fuente Mermaid/PlantUML
- Actualiza el contenido de una pizarra usando formatos Mermaid, PlantUML, SVG u OpenAPI nativo
- Crea diagramas complejos desde cero (arquitectura, flujos, organigramas) mediante un workflow de creación
- Edita o añade contenido a pizarras existentes con confirmación previa si implica reconstrucción total

## Use it when

- El usuario quiere ver el contenido de una pizarra o exportarla como imagen
- El usuario quiere extraer el código Mermaid/PlantUML de una pizarra existente
- El usuario proporciona código Mermaid/PlantUML/SVG y quiere escribirlo en una pizarra
- El usuario quiere crear o modificar un diagrama complejo en una pizarra

## Don't bother when

- Edición de contenido de documentos de Feishu (usar lark-doc)
- Operaciones sobre hojas de cálculo o Base incrustadas en documentos (usar lark-sheets / lark-base)

## What triggers it

- "Exporta esta pizarra de Feishu como imagen"
- "Sácame el código Mermaid de este diagrama en el whiteboard"
- "Crea un diagrama de arquitectura nuevo en esta pizarra"
- "Actualiza la pizarra con este PlantUML"

## Before you install

- Requiere el binario lark-cli y npx @larksuite/whiteboard-cli, además de leer primero ../lark-shared/SKILL.md para autenticación y permisos.

## Files

- SKILL.md — 3 KB
- elements/connectors.md — 5 KB
- elements/content.md — 1 KB
- elements/image.md — 4 KB
- elements/layout.md — 19 KB
- elements/schema.md — 15 KB
- elements/style.md — 11 KB
- elements/typography.md — 2 KB
- references/lark-whiteboard-export.md — 3 KB
- references/lark-whiteboard-update.md — 5 KB
- references/lark-whiteboard-workflow.md — 6 KB
- routes/dsl.md — 7 KB
- routes/mermaid.md — 1 KB
- routes/svg-edit.md — 4 KB
- routes/svg.md — 4 KB
- scenes/architecture.md — 22 KB
- scenes/bar-chart.md — 8 KB
- scenes/comparison.md — 7 KB
- scenes/fishbone.md — 10 KB
- scenes/flowchart.md — 11 KB
- scenes/flywheel.md — 9 KB
- scenes/funnel.md — 4 KB
- scenes/line-chart.md — 9 KB
- scenes/mention.md — 3 KB
- scenes/mermaid.md — 3 KB
- scenes/milestone.md — 4 KB
- scenes/organization.md — 8 KB
- scenes/photo-showcase.md — 6 KB
- scenes/pyramid.md — 4 KB
- scenes/swimlane.md — 20 KB
- scenes/treemap.md — 6 KB

## SKILL.md

Reproduced verbatim from larksuite/cli under MIT. This section is the upstream document and is in English.

> [!IMPORTANT]
> - 运行 `lark-cli --version`，确认可用，无需询问用户。
> - 运行 `npx -y @larksuite/whiteboard-cli@^0.2.13 -v`，确认可用，无需询问用户。

**CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理**

---

## 快速决策

**身份**：画板操作默认使用 `--as user`。仅当需要以应用身份上传时使用 `--as bot`。

> 先判断「只读还是写入」，再在对应表内按上到下匹配，**命中即停**。

### A. 只读 · 查看 / 导出（不改画板）

| 用户需求 | 行动 |
|---|---|
| 查看画板内容 / 导出图片 | [`+export --output-type preview`](references/lark-whiteboard-export.md)                       |
| 导出 SVG 矢量图 | [`+export --output-type svg`](references/lark-whiteboard-export.md)                       |
| 提取画板的 Mermaid/PlantUML 源码 | [`+export --output-type source`](references/lark-whiteboard-export.md) |

### B. 写入 · 创作 / 编辑（会改画板，命中即停）

| 场景 | 行动 | 写入方式 | 对原内容 |
|---|---|---|---|
| 用户**已提供** Mermaid/PlantUML/SVG 代码，或明确指定用该格式 | 使用该代码 → [`+update`](references/lark-whiteboard-update.md)，`--input_format` 取单值 `mermaid` / `plantuml` / `svg`；写入非空已有画板并需要 overwrite 时，先确认会整板重建；若 SVG 用于修改已有画板，先走 [`routes/svg-edit.md`](routes/svg-edit.md) 有损确认 | overwrite / append | 按用户要求 |
| 从零新建复杂图表（架构/流程/组织等） | → **[§ 创作 Workflow](references/lark-whiteboard-workflow.md#创作-workflow)** | 首次写入 | — |
| 修改 / 增补已有画板 | → **[§ 编辑 Workflow](references/lark-whiteboard-workflow.md#编辑-workflow)** | 见该表 | 见该表 |

## Shortcuts

| Shortcut                                          | 说明 |
|---------------------------------------------------|---|
| [`+export`](references/lark-whiteboard-export.md) | 导出画板为预览图片、SVG 矢量图、代码或原始节点结构。 |
| [`+update`](references/lark-whiteboard-update.md) | 更新画板，支持 PlantUML、Mermaid、SVG 或 OpenAPI 原生格式 |

---

## 不在本 skill 范围
- 文档内容编辑 → lark-doc [lark-doc](../lark-doc/SKILL.md)
- 在文档中创建画板 → [lark-doc-whiteboard.md](../lark-doc/references/lark-doc-whiteboard.md)
- 表格 / Base 操作 → [lark-sheets](../lark-sheets/SKILL.md) / [lark-base](../lark-base/SKILL.md)

---

Skills Agentes — https://skillsagentes.com/skills/larksuite/cli/lark-whiteboard