lark-doc

价格

以上为公开标价。你的组织可能有协议价，以控制台显示的价格为准。

如何使用

1. 1

   为组织安装

   开通即安装：组织固定使用开通时的版本（当前为 1.0.0）。升级到新版本需要取消后重新开通。

2. 2

   创建凭证

   客户端使用组织凭证读取；绑定到数字人后，数字人使用绑定凭证按需加载。请求中携带：

   Authorization: Bearer $ZGI_MARKET_KEY

3. 3

   读取清单与安装包

   清单列出版本、文件和校验值；安装包是一个 zip 文件。

   curl "https://market-api.zgi.im/v1/market/skills/lark-doc/manifest" \
     -H "Authorization: Bearer $ZGI_MARKET_KEY"

   curl "https://market-api.zgi.im/v1/market/skills/lark-doc/package" \
     -H "Authorization: Bearer $ZGI_MARKET_KEY" \
     -o lark-doc.zip

   读取清单和下载安装包不计入用量。下载后请用响应头中的 SHA-256 校验文件。

技能说明

名称

lark-doc

说明

飞书云文档（Docx / Wiki）内容操作：读取、创建、编辑文档，插入或下载图片附件，以及操作思维笔记。用户提供文档 URL/token（包括 doubao.com 的 /docx/、/wiki/）时使用；按 URL 路径/token 而非域名路由。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive；随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。

# docs

## 场景与 Shortcut 路由

**CRITICAL：先判断场景，再读取该场景的参考文件；不要在任务开始时一次性读取全部参考文件。每个文件只在首次进入对应阶段时读取一次。**

**身份：文档操作推荐显式指定 `--as user`。**

**所有表示本地文件的 `@path` 均使用 `@./xxx` 形式的相对路径，并以运行 `lark-cli` 时的当前工作目录（CWD）为基准。**

### 文档内容

- **读取 / 摘要 — [`+fetch`](references/lark-doc-fetch.md)**：先读参考再获取文档。
- **从零创作 — [`创建工作流`](references/lark-doc-create-workflow.md)**：先完整执行创建工作流，**简单任务不是跳过的理由**；
- **导入 / 空文档 — [`+create`](references/lark-doc-create.md)**：仅创建空文档或原样导入用户提供的完整内容时，跳过创建工作流。
- **编辑 / block 直达链接 — [`+update`](references/lark-doc-update.md)**：语义改写、润色、重组、补写或排版均按 update 参考完成。

### 辅助能力

- **草稿初始化、解析与统计 — [`+script`](references/lark-doc-script.md)**：支持解析文档 URL / token 与本地 XML，统计字数并返回字符诊断；不支持 Markdown 输入。
- **历史版本 — [`+history-list` / `+history-revert` / `+history-revert-status`](references/lark-doc-history.md)**：查询、回滚文档历史版本或检查回滚任务状态。

### 资源、画板与思维笔记

- **插入本地素材 — [`+media-insert`](references/lark-doc-media-insert.md)**：在文末插入本地图片或文件。
- **预览素材 — [`+media-preview`](references/lark-doc-media-preview.md)**：预览文档或评论中的图片、附件或素材。
- **下载素材 — [`+media-download`](references/lark-doc-media-download.md)**：下载文档中的图片、附件、素材或画板缩略图。
- **Docx 封面 — [`+resource-download` / `+resource-update` / `+resource-delete`](references/lark-doc-resource-cover.md)**：下载、更新或删除 Docx 封面。
- **画板 — [`画板工作流`](references/lark-doc-whiteboard.md)**：创建或更新画板时先读取工作流；更新已有画板必须复用现有 token，禁止新建空白画板；使用 [`whiteboard +update`](../lark-whiteboard/references/lark-whiteboard-update.md) 写入。
- **思维笔记 — `mindnotes`**：已有思维笔记走 [`思维笔记链路`](references/lark-doc-mindnote.md)；新建思维笔记走 [`lark-doc-whiteboard`](references/lark-doc-whiteboard.md)。

### 认证与 Scope

执行 Shortcut 时，不预读 [`lark-shared`](../lark-shared/SKILL.md) 或预跑 `auth status --verify`；仅遇到未认证、token / 身份或 scope 错误时读取该 Skill，修复后重试。认证、身份或 scope 管理请求则直接使用该 Skill。

## 不在本 Skill 范围

- **Drive 文件级操作**：找文档、导入导出、云空间文件上传 / 下载 / 权限管理 → [`lark-drive`](../lark-drive/SKILL.md)。复制文档、创建副本或另存为副本时，按其指引使用 `lark-cli drive files copy`；不要用 `docs +fetch` + `docs +create` 重建正文。
- **独立评论操作**：添加、分页查看、回复评论或增删 reaction → [`lark-drive`](../lark-drive/SKILL.md)；只需紧凑评论上下文时，直接使用默认 JSON 响应的 `docs +fetch`。

• SKILL.md3.9 KiB
• references/genres/business-analysis.md3.1 KiB
• references/genres/data-report.md2.9 KiB
• references/genres/email.md4.0 KiB
• references/genres/execution-plan.md2.9 KiB
• references/genres/formal-doc.md4.4 KiB
• references/genres/meeting-minutes.md2.3 KiB
• references/genres/memo-brief.md2.0 KiB
• references/genres/official-redhead.md6.1 KiB
• references/genres/prd.md2.5 KiB
• references/genres/proposal.md2.1 KiB
• references/genres/research-report.md3.2 KiB
• references/genres/retrospective.md2.4 KiB
• references/genres/route-consumer.md3.8 KiB
• references/genres/route-creative.md3.6 KiB
• references/genres/route-knowledge.md4.7 KiB
• references/genres/route-marketing.md4.2 KiB
• references/genres/route-media.md3.7 KiB
• references/genres/route-opinion.md3.6 KiB
• references/genres/route-personal-brand.md3.4 KiB
• references/genres/route-platform.md639 B
• references/genres/route-report.md1.2 KiB
• references/genres/route-workplace.md2.8 KiB
• references/genres/sop-tutorial.md4.0 KiB
• references/genres/technical-doc.md3.5 KiB
• references/genres/wechat.md3.9 KiB
• references/genres/weekly-report.md2.0 KiB
• references/genres/white-paper.md3.1 KiB
• references/genres/xiaohongshu.md3.2 KiB
• references/lark-doc-create-workflow.md9.3 KiB
• references/lark-doc-create.md3.2 KiB
• references/lark-doc-fetch.md7.8 KiB
• references/lark-doc-history.md5.4 KiB
• references/lark-doc-md.md5.8 KiB
• references/lark-doc-media-download.md2.2 KiB
• references/lark-doc-media-insert.md6.8 KiB
• references/lark-doc-media-preview.md1.6 KiB
• references/lark-doc-mindnote.md5.4 KiB
• references/lark-doc-resource-cover.md4.1 KiB
• references/lark-doc-script.md5.3 KiB
• references/lark-doc-update.md7.3 KiB
• references/lark-doc-whiteboard.md8.7 KiB
• references/lark-doc-xml-extended-blocks.md4.3 KiB
• references/lark-doc-xml.md5.3 KiB

来源与审核

审核状态

尚未审核，内容来自上游来源

许可证

未说明

审核状态是平台对上架信息的记录，不构成对上游服务质量或可用性的担保。