markdown (v1)
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md，其中包含认证、权限处理
快速决策
- 用户要上传、创建一个原生
.md文件，使用lark-cli markdown +create - 用户要比较原生
.md文件的历史版本差异，或比较远端 Markdown 与本地草稿，使用lark-cli markdown +diff - 用户要读取 Drive 里某个
.md文件内容，使用lark-cli markdown +fetch - 用户要对 Markdown 文件做局部文本替换 / 正则替换，优先使用
lark-cli markdown +patch - 用户要覆盖更新 Drive 里某个
.md文件内容，使用lark-cli markdown +overwrite - 用户要先拿 Markdown 文件的历史版本号，再做比较/下载/回滚，先用
lark-drive的lark-cli drive +version-history - 用户要把本地 Markdown 导入成在线新版文档（docx），不要用本 skill，改用
lark-drive的lark-cli drive +import --type docx - 用户要对 Markdown 文件做rename / move / delete / 搜索 / 权限 / 评论等云空间操作，不要留在本 skill，切到
lark-drive
核心边界
- 本 skill 处理的是 Drive 中作为普通文件存储的 Markdown，不是 docx 文档
--name和本地--file文件名都必须显式带.md后缀；不满足时 shortcut 会直接报错--content支持：- 直接传字符串
@file从本地文件读取内容-从 stdin 读取内容markdown +patch的内部语义是：先完整下载 Markdown，再本地替换，再整文件覆盖上传markdown +patch不是服务端原子 patch；它是 CLI 侧编排出来的局部更新能力markdown +patch当前只支持单组--pattern/--contentmarkdown +patch替换后的最终内容不能为空；如果替换后整篇 Markdown 变成空字符串，CLI 会直接报错，不会上传空文件--file只接受本地.md文件路径
Shortcuts（推荐优先使用）
Shortcut 是对常用操作的高级封装（lark-cli markdown +<verb> [flags]）。有 Shortcut 的操作优先使用。
| Shortcut | 说明 |
|---|---|
+create |
Create a Markdown file in Drive |
+diff |
Compare two remote Markdown versions, or compare remote Markdown against a local file |
+fetch |
Fetch a Markdown file from Drive |
+patch |
Patch a Markdown file in Drive via fetch-local-replace-overwrite |
+overwrite |
Overwrite an existing Markdown file in Drive |
参考
- lark-shared — 认证和全局参数
- lark-drive — Drive 文件管理、导入 docx、move/delete/search 等
