feishu-cli-docs

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

飞书文档

Feishu Docs

只读取当前任务需要的工作流；跨步骤任务可以按顺序读取多个。加载后，将工作流中的

references/

、

scripts/

、

templates/

、

examples/

相对路径按该

workflow.md

所在目录解析；执行脚本时使用解析后的实际路径，不要依赖当前 shell 目录。

Only read the workflows required for the current task; multi-step tasks can read multiple workflows in sequence. After loading, resolve the relative paths of

references/

scripts/

templates/

examples/

in the workflow according to the directory where the

workflow.md

is located; use the resolved actual path when executing scripts, do not rely on the current shell directory.

路由

Routing

意图	读取文件
阅读、分析、获取块结构，不主动落盘	`references/workflows/read/workflow.md`
创建、追加、覆盖、替换或编辑 docx	`references/workflows/write/workflow.md`
把 Markdown 导入为飞书 docx	`references/workflows/import/workflow.md`
导出 docx/wiki/sheet 到本地文件	`references/workflows/export/workflow.md`
上传、下载、覆盖或比较云盘原生 `.md`	`references/workflows/markdown/workflow.md`

Intent	File to Read
Read, analyze, get block structure, no active persistence	`references/workflows/read/workflow.md`
Create, append, overwrite, replace or edit docx	`references/workflows/write/workflow.md`
Import Markdown as Feishu docx	`references/workflows/import/workflow.md`
Export docx/wiki/sheet to local files	`references/workflows/export/workflow.md`
Upload, download, overwrite or compare native `.md` in cloud storage	`references/workflows/markdown/workflow.md`

关键边界

Key Boundaries

“查看并总结”走 read；明确要求保存到路径才走 export。
Markdown 转为可阅读 docx 走 import；把
```
.md
```
源文件原样存入云盘走 markdown。
DOCX/XLSX 等二进制文件导入走
```
feishu-cli-storage
```
的 drive 工作流。

doc htmlbox

属于

feishu-cli-visual

；权限和转移所有权属于

feishu-cli-storage

。

"View and summarize" uses the read workflow; only use the export workflow when explicitly required to save to a path.
Converting Markdown to readable docx uses the import workflow; storing the original
```
.md
```
source file in cloud storage uses the markdown workflow.
Importing binary files such as DOCX/XLSX uses the drive workflow of
```
feishu-cli-storage
```
.
```
doc htmlbox
```
belongs to
```
feishu-cli-visual
```
; permission and ownership transfer belong to
```
feishu-cli-storage
```
.

执行规则

Execution Rules

解析 URL 后区分普通文档 token 与 wiki node token。
写入前确认目标、更新模式和影响范围；优先 dry-run 或测试文档。

导入前读取

references/workflows/import/references/doc-guide.md

。

创建文档后按项目 owner_email 规则授权；不要把真实邮箱写进示例。

Distinguish between ordinary document tokens and wiki node tokens after parsing the URL.
Confirm the target, update mode and scope of impact before writing; prioritize dry-run or test documents.

Read

references/workflows/import/references/doc-guide.md

before importing.

Authorize according to the project owner_email rule after creating a document; do not write real email addresses into examples.