diff --git a/skills/lark-apps/SKILL.md b/skills/lark-apps/SKILL.md index f836ac051..e2b08828f 100644 --- a/skills/lark-apps/SKILL.md +++ b/skills/lark-apps/SKILL.md @@ -1,6 +1,6 @@ --- name: lark-apps -description: "把本地 HTML 文件或目录部署到飞书妙搭（Miaoda），生成一个公网可访问的应用及其链接（URL）。当用户要创建 HTML 或要把 HTML、静态网站或 Web demo 发布成公网可访问的链接 / 可分享链接、设置应用共享范围，或提到妙搭 / Miaoda 时使用。凡产出可独立访问的 HTML 产物都属本 skill 的潜在归宿，是否真要部署由 skill 内部协议判断。不用于：上传普通文件到云空间（用 lark-drive）、编辑飞书云文档内容（用 lark-doc）、创建飞书原生幻灯片 / 演示文稿（用 lark-slides）。" +description: "把本地 HTML 文件或目录部署到飞书妙搭（Miaoda），生成一个公网可访问的应用及其链接（URL）。当用户要创建 HTML 或要把 HTML、静态网站或 Web demo 发布成公网可访问的链接 / 可分享链接、设置应用共享范围，或提到妙搭 / Miaoda 时使用。凡产出可独立访问的 HTML 产物都属本 skill 的潜在归宿，是否真要部署由 skill 内部协议判断。不用于：上传普通文件到云空间/云盘/云存储（用 lark-drive）、编辑飞书云文档内容（用 lark-doc）、创建飞书原生幻灯片 / 演示文稿（用 lark-slides）。" metadata: requires: bins: ["lark-cli"] diff --git a/skills/lark-drive/SKILL.md b/skills/lark-drive/SKILL.md index 45e446504..bad95340b 100644 --- a/skills/lark-drive/SKILL.md +++ b/skills/lark-drive/SKILL.md @@ -1,7 +1,7 @@ --- name: lark-drive version: 1.0.0 -description: "飞书云空间：管理云空间中的文件和文件夹。上传和下载文件、创建文件夹、复制/移动/删除文件、查看文件元数据、管理文档评论、管理文档权限、订阅用户评论变更事件、修改文件标题（docx、sheet、bitable、file、folder、wiki）；也负责把本地 Word/Markdown/Excel/CSV 以及 Base 快照（.base）导入为飞书在线云文档（docx、sheet、bitable）。当用户需要上传或下载文件、整理云空间目录、查看文件详情、管理评论、管理文档权限、修改文件标题、订阅用户评论变更事件，或要把本地文件导入成新版文档、电子表格、多维表格/Base 时使用。" +description: "飞书云空间（云盘/云存储）：管理云空间（云盘/云存储）中的文件和文件夹。上传和下载文件、创建文件夹、复制/移动/删除文件、查看文件元数据、管理文档评论、管理文档权限、订阅用户评论变更事件、修改文件标题（docx、sheet、bitable、file、folder、wiki）；也负责把本地 Word/Markdown/Excel/CSV 以及 Base 快照（.base）导入为飞书在线云文档（docx、sheet、bitable）。当用户需要上传或下载文件、整理云空间（云盘/云存储）目录、查看文件详情、管理评论、管理文档权限、修改文件标题、订阅用户评论变更事件，或要把本地文件导入成新版文档、电子表格、多维表格/Base 时使用。\"云空间\"、\"云盘\"和\"云存储\"是同一概念，用户说\"云盘\"、\"云存储\"、\"网盘\"、\"我的空间\"时均路由到本 skill。" metadata: requires: bins: ["lark-cli"] @@ -12,18 +12,20 @@ metadata: **CRITICAL — 开始前 MUST 先用 Read 工具读取 [`../lark-shared/SKILL.md`](../lark-shared/SKILL.md)，其中包含认证、权限处理** +> **术语说明：** 飞书云空间也常被称为"云盘"或"云存储"，三者指的是同一个产品，是飞书官方的云端文件存储与管理中心。 + > **导入分流规则：** 如果用户要把本地 Excel / CSV / `.base` 快照导入成 Base / 多维表格 / bitable，必须优先使用 `lark-cli drive +import --type bitable`。不要先切到 `lark-base`；`lark-base` 只负责导入完成后的表内操作。 ## 快速决策 -- 用户要**搜文档 / Wiki / 电子表格 / 多维表格 / 云空间对象**，优先使用 `lark-cli drive +search`。自然语言里"最近我编辑过的"、"我创建的"（→ `--mine`，实为 owner 语义）、"最近一周我打开过的 xxx"、"某人 owner 的 docx" 等直接映射到扁平 flag，避免手写嵌套 JSON。 +- 用户要**搜文档 / Wiki / 电子表格 / 多维表格 / 云空间（云盘/云存储）对象**，优先使用 `lark-cli drive +search`。自然语言里"最近我编辑过的"、"我创建的"（→ `--mine`，实为 owner 语义）、"最近一周我打开过的 xxx"、"某人 owner 的 docx" 等直接映射到扁平 flag，避免手写嵌套 JSON。 - 用户要把本地 `.xlsx` / `.csv` / `.base` 导入成 Base / 多维表格 / bitable，第一步必须使用 `lark-cli drive +import --type bitable`。 - 用户要把本地 `.md` / `.docx` / `.doc` / `.txt` / `.html` 导入成在线文档，使用 `lark-cli drive +import --type docx`。 - 用户要在 Drive 里上传、创建、读取、局部 patch 或覆盖更新**原生 `.md` 文件**（不是导入成 docx），切到 [`lark-markdown`](../lark-markdown/SKILL.md)。 - 用户要比较原生 `.md` 文件的**历史版本差异**，或比较远端 Markdown 与本地草稿，切到 [`lark-markdown`](../lark-markdown/SKILL.md) 的 `lark-cli markdown +diff`；需要版本号时先用 `drive +version-history`。 - 用户要查看、下载、回滚或删除文件的**历史版本**，使用 `drive +version-history`、`drive +version-get`、`drive +version-revert`、`drive +version-delete`；这组命令同时支持 `--as user` 和 `--as bot`，自动化场景优先 `--as bot`。 - 用户要把本地 `.xlsx` / `.xls` / `.csv` 导入成电子表格，使用 `lark-cli drive +import --type sheet`。 -- 用户要在云空间里新建文件夹，优先使用 `lark-cli drive +create-folder`。 +- 用户要在云空间（云盘/云存储）里新建文件夹，优先使用 `lark-cli drive +create-folder`。 - 用户要把本地文件上传到知识库 / 文档库里的某个 wiki 节点下时，仍然使用 `lark-cli drive +upload --wiki-token `；不要误切到 `wiki` 域命令。 - `lark-base` 只负责导入完成后的 Base 内部操作（表、字段、记录、视图），不要在“本地文件 -> Base”这一步提前切到 `lark-base`。 @@ -120,7 +122,7 @@ Wiki Space (知识空间) └── obj_type: file/slides/mindnote └── obj_token (真实文档 token) -Drive Folder (云空间文件夹) +Drive Folder (云空间/云盘/云存储文件夹) └── File (文件/文档) └── file_token (直接使用) ``` diff --git a/skills/lark-drive/references/lark-drive-add-comment.md b/skills/lark-drive/references/lark-drive-add-comment.md index 35c181537..fbf0a039b 100644 --- a/skills/lark-drive/references/lark-drive-add-comment.md +++ b/skills/lark-drive/references/lark-drive-add-comment.md @@ -178,5 +178,5 @@ lark-cli drive +add-comment \ ## 参考 -- [lark-drive](../SKILL.md) -- 云空间全部命令 +- [lark-drive](../SKILL.md) -- 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数 diff --git a/skills/lark-drive/references/lark-drive-create-folder.md b/skills/lark-drive/references/lark-drive-create-folder.md index cb67d34cf..3f598dcdd 100644 --- a/skills/lark-drive/references/lark-drive-create-folder.md +++ b/skills/lark-drive/references/lark-drive-create-folder.md @@ -1,8 +1,8 @@ -# drive +create-folder（创建云空间文件夹） +# drive +create-folder（创建云空间/云盘/云存储文件夹） > **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。 -在飞书云空间中创建一个新文件夹。该 shortcut 对原生 `drive files create_folder` 做了一层更适合日常使用的封装：`--folder-token` 可省略，此时会在调用者根目录创建；如果使用 `--as bot`，创建成功后 CLI 会尝试把新文件夹的可管理权限自动授予当前 CLI 用户。 +在飞书云空间（云盘/云存储）中创建一个新文件夹。该 shortcut 对原生 `drive files create_folder` 做了一层更适合日常使用的封装：`--folder-token` 可省略，此时会在调用者根目录创建；如果使用 `--as bot`，创建成功后 CLI 会尝试把新文件夹的可管理权限自动授予当前 CLI 用户。 ## 命令 @@ -60,7 +60,7 @@ lark-cli drive +create-folder \ ## 推荐场景 -- 用户说“在云空间新建一个文件夹 / 目录”时，优先使用 `drive +create-folder` +- 用户说“在云空间（云盘/云存储）新建一个文件夹 / 目录”时，优先使用 `drive +create-folder` - 用户给了父文件夹链接或 token，需要在其下继续分层建目录时，传 `--folder-token` - 如果后续还要上传文件、移动文件、建子目录，优先复用返回值里的 `folder_token` @@ -69,5 +69,5 @@ lark-cli drive +create-folder \ ## 参考 -- [lark-drive](../SKILL.md) -- 云空间全部命令 +- [lark-drive](../SKILL.md) -- 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数 diff --git a/skills/lark-drive/references/lark-drive-create-shortcut.md b/skills/lark-drive/references/lark-drive-create-shortcut.md index f2a892b64..71b380c17 100644 --- a/skills/lark-drive/references/lark-drive-create-shortcut.md +++ b/skills/lark-drive/references/lark-drive-create-shortcut.md @@ -48,7 +48,7 @@ lark-cli drive +create-shortcut \ - CLI 层会把 `--file-token` 和 `--type` 组装为底层 API 所需的 `refer_entity` - `--file-token` 必须是 Drive 文件 token，不要直接传 wiki 节点 token - 如果来源是 `/wiki/...` 链接，必须先按 [`lark-drive`](../SKILL.md) 中的 wiki 解析流程拿到真实 `obj_token`，再创建快捷方式 -- 目标位置必须是云空间文件夹；这个 shortcut 不是“复制文件内容”，而是“在另一个文件夹里挂一个引用入口” +- 目标位置必须是云空间（云盘/云存储）文件夹；这个 shortcut 不是“复制文件内容”，而是“在另一个文件夹里挂一个引用入口” ## 类型说明 @@ -99,5 +99,5 @@ lark-cli drive +create-shortcut \ ## 参考 -- [lark-drive](../SKILL.md) -- 云空间全部命令 +- [lark-drive](../SKILL.md) -- 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数 diff --git a/skills/lark-drive/references/lark-drive-delete.md b/skills/lark-drive/references/lark-drive-delete.md index 0048364cd..05105994f 100644 --- a/skills/lark-drive/references/lark-drive-delete.md +++ b/skills/lark-drive/references/lark-drive-delete.md @@ -3,7 +3,7 @@ > **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。 -删除云空间内的文件或文件夹。删除后资源会进入回收站。 +删除云空间（云盘/云存储）内的文件或文件夹。删除后资源会进入回收站。 > [!CAUTION] > 这是**高风险写操作**。CLI 层要求显式传 `--yes`；如果用户已经明确要求删除且目标明确，直接执行并带上 `--yes`。 @@ -63,7 +63,7 @@ lark-cli drive +task_result \ ## 限制 -- 该 shortcut 仅支持云空间文件或文件夹，不支持 wiki 文档 +- 该 shortcut 仅支持云空间（云盘/云存储）文件或文件夹，不支持 wiki 文档 - 该接口不支持并发调用 - 调用频率上限为 5 QPS 且 10000 次/天 @@ -75,5 +75,5 @@ lark-cli drive +task_result \ ## 参考 -- [lark-drive](../SKILL.md) -- 云空间全部命令 +- [lark-drive](../SKILL.md) -- 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数 diff --git a/skills/lark-drive/references/lark-drive-download.md b/skills/lark-drive/references/lark-drive-download.md index a7ce629ec..118c5ef8a 100644 --- a/skills/lark-drive/references/lark-drive-download.md +++ b/skills/lark-drive/references/lark-drive-download.md @@ -3,7 +3,7 @@ > **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。 -从飞书云空间下载文件到本地。 +从飞书云空间（云盘/云存储）下载文件到本地。 ## 命令 @@ -27,5 +27,5 @@ https://xxx.feishu.cn/drive/file/boxbc_xxx ## 参考 -- [lark-drive](../SKILL.md) -- 云空间全部命令 +- [lark-drive](../SKILL.md) -- 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数 diff --git a/skills/lark-drive/references/lark-drive-export-download.md b/skills/lark-drive/references/lark-drive-export-download.md index 42c4fdc80..9271511d2 100644 --- a/skills/lark-drive/references/lark-drive-export-download.md +++ b/skills/lark-drive/references/lark-drive-export-download.md @@ -46,5 +46,5 @@ lark-cli drive +export-download \ ## 参考 -- [lark-drive](../SKILL.md) -- 云空间全部命令 +- [lark-drive](../SKILL.md) -- 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数 diff --git a/skills/lark-drive/references/lark-drive-export.md b/skills/lark-drive/references/lark-drive-export.md index c2c324943..a147915ec 100644 --- a/skills/lark-drive/references/lark-drive-export.md +++ b/skills/lark-drive/references/lark-drive-export.md @@ -131,5 +131,5 @@ lark-cli drive +export-download \ ## 参考 -- [lark-drive](../SKILL.md) -- 云空间全部命令 +- [lark-drive](../SKILL.md) -- 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数 diff --git a/skills/lark-drive/references/lark-drive-import.md b/skills/lark-drive/references/lark-drive-import.md index 1e88f7041..99573eb44 100644 --- a/skills/lark-drive/references/lark-drive-import.md +++ b/skills/lark-drive/references/lark-drive-import.md @@ -56,7 +56,7 @@ lark-cli drive +import --file ./README.md --type docx --dry-run |------|------|------| | `--file` | 是 | 本地文件路径，根据文件后缀名自动推断 `file_extension`；文件需满足对应格式的导入大小限制，超过 20MB 且仍在允许范围内时会自动切换分片上传 | | `--type` | 是 | 导入目标云文档格式。可选值：`docx` (新版文档)、`sheet` (电子表格)、`bitable` (多维表格) | -| `--folder-token` | 否 | 目标文件夹 token，不传则请求中的 `point.mount_key` 为空字符串，Import API 会将其解释为导入到云空间根目录 | +| `--folder-token` | 否 | 目标文件夹 token，不传则请求中的 `point.mount_key` 为空字符串，Import API 会将其解释为导入到云空间（云盘/云存储）根目录 | | `--name` | 否 | 导入后的在线云文档名称，不传默认使用本地文件名去掉扩展名后的结果 | | `--target-token` | 否 | 已有的多维表格 token，将数据导入到该多维表格中（**仅支持 `--type bitable`**）；传入后数据会挂载到目标多维表格而非新建一个 | @@ -155,5 +155,5 @@ lark-cli drive +task_result --scenario import --ticket ## 参考 -- [lark-drive](../SKILL.md) -- 云空间全部命令 +- [lark-drive](../SKILL.md) -- 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数 diff --git a/skills/lark-drive/references/lark-drive-move.md b/skills/lark-drive/references/lark-drive-move.md index 1a11bc799..00ebfc695 100644 --- a/skills/lark-drive/references/lark-drive-move.md +++ b/skills/lark-drive/references/lark-drive-move.md @@ -3,7 +3,7 @@ > **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。 -将文件或文件夹移动到用户云空间的其他位置。 +将文件或文件夹移动到用户云空间（云盘/云存储）的其他位置。 ## 与 `wiki +move` 的区别 @@ -116,5 +116,5 @@ lark-cli drive +task_result \ ## 参考 -- [lark-drive](../SKILL.md) -- 云空间全部命令 +- [lark-drive](../SKILL.md) -- 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数 diff --git a/skills/lark-drive/references/lark-drive-pull.md b/skills/lark-drive/references/lark-drive-pull.md index 44ac67a15..5568c8cb9 100644 --- a/skills/lark-drive/references/lark-drive-pull.md +++ b/skills/lark-drive/references/lark-drive-pull.md @@ -3,7 +3,7 @@ > **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。 -把飞书云空间的某个文件夹**单向、文件级**镜像到本地目录（Drive → 本地）。命令递归列出 `--folder-token` 下所有 `type=file` 的文件，逐一下载到 `--local-dir` 对应的相对路径，子文件夹自动复刻为本地目录。 +把飞书云空间（云盘/云存储）的某个文件夹**单向、文件级**镜像到本地目录（Drive → 本地）。命令递归列出 `--folder-token` 下所有 `type=file` 的文件，逐一下载到 `--local-dir` 对应的相对路径，子文件夹自动复刻为本地目录。 > ⚠️ **不是 directory-level mirror**：`--delete-local` 只删除本地"多余"的常规文件，不删除空目录。如果云端把整个子文件夹删了，对应的本地子目录会留空（里面的文件被清掉，目录本身保留）；想精确同步目录结构请自己 `rmdir` 处理空壳。 @@ -131,7 +131,7 @@ lark-cli drive +pull --local-dir ./repo --folder-token fldcnxxxxxxxxx \ ## 参考 -- [lark-drive](../SKILL.md) —— 云空间全部命令 +- [lark-drive](../SKILL.md) —— 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) —— 认证和全局参数 - [lark-drive-status](lark-drive-status.md) —— 下载前先看差异 - [lark-drive-download](lark-drive-download.md) —— 单文件按需拉取 diff --git a/skills/lark-drive/references/lark-drive-push.md b/skills/lark-drive/references/lark-drive-push.md index 9c3b2c804..b2e405a81 100644 --- a/skills/lark-drive/references/lark-drive-push.md +++ b/skills/lark-drive/references/lark-drive-push.md @@ -3,7 +3,7 @@ > **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。 -把本地目录**单向、文件级**镜像到飞书云空间的某个文件夹（本地 → Drive）。命令递归列出 `--folder-token` 下的远端清单，遍历 `--local-dir` 的所有常规文件，按相对路径在 Drive 上新建、覆盖或跳过；可选地（`--delete-remote --yes`）删除云端"本地没有"的 `type=file`。 +把本地目录**单向、文件级**镜像到飞书云空间（云盘/云存储）的某个文件夹（本地 → Drive）。命令递归列出 `--folder-token` 下的远端清单，遍历 `--local-dir` 的所有常规文件，按相对路径在 Drive 上新建、覆盖或跳过；可选地（`--delete-remote --yes`）删除云端"本地没有"的 `type=file`。 > **"文件级镜像"≠"目录镜像"。** 命令只在文件维度收敛差异：本地多了文件就上传，本地少了文件且开了 `--delete-remote --yes` 就删远端文件。**远端只有的空目录、本地已删除的目录**都不会被收敛，云端目录树的多余结构不会被清理。如果需要"目录也要保持完全一致"，得自行先 `+status` 找差异、再手动处理多余目录。 @@ -155,7 +155,7 @@ lark-cli drive +push --local-dir ./repo --folder-token fldcnxxxxxxxxx \ ## 参考 -- [lark-drive](../SKILL.md) —— 云空间全部命令 +- [lark-drive](../SKILL.md) —— 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) —— 认证和全局参数 - [lark-drive-status](lark-drive-status.md) —— 上传前先看差异（避免全量回写） - [lark-drive-pull](lark-drive-pull.md) —— Drive → 本地的对称命令 diff --git a/skills/lark-drive/references/lark-drive-reactions.md b/skills/lark-drive/references/lark-drive-reactions.md index 1ddc68235..fd2d4cde6 100644 --- a/skills/lark-drive/references/lark-drive-reactions.md +++ b/skills/lark-drive/references/lark-drive-reactions.md @@ -109,5 +109,5 @@ Music, Typing, Pepper, CheckMark, CrossMark ## 参考 -- [lark-drive](../SKILL.md) -- 云空间全部命令 +- [lark-drive](../SKILL.md) -- 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数 diff --git a/skills/lark-drive/references/lark-drive-search.md b/skills/lark-drive/references/lark-drive-search.md index fa1dac07b..dca8cc0fa 100644 --- a/skills/lark-drive/references/lark-drive-search.md +++ b/skills/lark-drive/references/lark-drive-search.md @@ -1,9 +1,9 @@ -# drive +search（云空间搜索：扁平 flag，面向自然语言场景） +# drive +search（云空间/云盘/云存储搜索：扁平 flag，面向自然语言场景） > **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。 -基于 Search v2 接口 `POST /open-apis/search/v2/doc_wiki/search`，以**用户身份**统一搜索云空间对象。 +基于 Search v2 接口 `POST /open-apis/search/v2/doc_wiki/search`，以**用户身份**统一搜索云空间（云盘/云存储）对象。 核心特性： @@ -12,7 +12,7 @@ - 自动处理 `my_edit_time` / `my_comment_time` 的小时级聚合（服务端存储粒度）：亚小时输入会向整点 snap，并在 stderr 打出提示 - `--mine` 一键从当前登录用户的 open_id 填 `creator_ids`，不必再先去查 contact（注意 `creator_ids` 服务端按 **owner / 文档归属人** 语义匹配，不是“最初创建人”，详见下文「身份维度」） -> **资源发现入口统一**：`drive +search` 同样返回 `SHEET` / `Base` / `FOLDER` 等全部云空间对象，不只是文档 / Wiki。用户说"找一个表格"、"找报表"、"最近打开的表格"时，也从这里开始；定位后再切到对应业务 skill（如 `lark-sheets`）做对象内部操作。 +> **资源发现入口统一**：`drive +search` 同样返回 `SHEET` / `Base` / `FOLDER` 等全部云空间（云盘/云存储）对象，不只是文档 / Wiki。用户说"找一个表格"、"找报表"、"最近打开的表格"时，也从这里开始；定位后再切到对应业务 skill（如 `lark-sheets`）做对象内部操作。 ## 命令 @@ -216,7 +216,7 @@ stdout 的 JSON 输出不受影响。`open_time` / `create_time` 不做 snap。 | 操作 | 所需 scope | |---|---| -| 搜索云空间对象（文档 / Wiki / 表格等资源发现） | `search:docs:read` | +| 搜索云空间（云盘/云存储）对象（文档 / Wiki / 表格等资源发现） | `search:docs:read` | ## 常见错误 diff --git a/skills/lark-drive/references/lark-drive-status.md b/skills/lark-drive/references/lark-drive-status.md index ef54ac03b..69fdcd799 100644 --- a/skills/lark-drive/references/lark-drive-status.md +++ b/skills/lark-drive/references/lark-drive-status.md @@ -3,7 +3,7 @@ > **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。 -按 **精确 SHA-256**（默认）或 **快速 modified_time**（`--quick`）比较本地目录与飞书云空间文件夹，输出四类差异： +按 **精确 SHA-256**（默认）或 **快速 modified_time**（`--quick`）比较本地目录与飞书云空间（云盘/云存储）文件夹，输出四类差异： | 字段 | 含义 | |------|------| @@ -132,6 +132,6 @@ lark-cli drive +status \ ## 参考 -- [lark-drive](../SKILL.md) —— 云空间全部命令 +- [lark-drive](../SKILL.md) —— 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) —— 认证和全局参数 - [lark-drive-upload](lark-drive-upload.md) / [lark-drive-download](lark-drive-download.md) —— 把 +status 输出接到推/拉动作上 diff --git a/skills/lark-drive/references/lark-drive-task-result.md b/skills/lark-drive/references/lark-drive-task-result.md index 018e09386..a7f579ca9 100644 --- a/skills/lark-drive/references/lark-drive-task-result.md +++ b/skills/lark-drive/references/lark-drive-task-result.md @@ -298,5 +298,5 @@ lark-cli drive +export-download --file-token ## 参考 -- [lark-drive](../SKILL.md) -- 云空间全部命令 +- [lark-drive](../SKILL.md) -- 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数 diff --git a/skills/lark-drive/references/lark-drive-upload.md b/skills/lark-drive/references/lark-drive-upload.md index f504596d6..4d0eb59c2 100644 --- a/skills/lark-drive/references/lark-drive-upload.md +++ b/skills/lark-drive/references/lark-drive-upload.md @@ -3,7 +3,7 @@ > **前置条件：** 先阅读 [`../lark-shared/SKILL.md`](../../lark-shared/SKILL.md) 了解认证、全局参数和安全规则。 -上传本地文件到飞书云空间。目标位置可以是 Drive 文件夹，也可以是 wiki 节点。 +上传本地文件到飞书云空间（云盘/云存储）。目标位置可以是 Drive 文件夹，也可以是 wiki 节点。 ## 快速决策 - 用户要在 Drive 里上传、创建、读取、局部 patch 或覆盖更新**原生 `.md` 文件**（不是导入成 docx），切到 [`lark-markdown`](../../lark-markdown/SKILL.md)。 @@ -97,5 +97,5 @@ Shortcut 参数： ## 参考 -- [lark-drive](../SKILL.md) -- 云空间全部命令 +- [lark-drive](../SKILL.md) -- 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数 diff --git a/skills/lark-drive/references/lark-drive-version-delete.md b/skills/lark-drive/references/lark-drive-version-delete.md index 58bf6eced..e0db561a3 100644 --- a/skills/lark-drive/references/lark-drive-version-delete.md +++ b/skills/lark-drive/references/lark-drive-version-delete.md @@ -34,5 +34,5 @@ lark-cli drive +version-delete \ ## 参考 -- [lark-drive](../SKILL.md) -- 云空间全部命令 +- [lark-drive](../SKILL.md) -- 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数 diff --git a/skills/lark-drive/references/lark-drive-version-get.md b/skills/lark-drive/references/lark-drive-version-get.md index ec72e32fc..36e3d1e54 100644 --- a/skills/lark-drive/references/lark-drive-version-get.md +++ b/skills/lark-drive/references/lark-drive-version-get.md @@ -67,5 +67,5 @@ lark-cli drive +version-get \ ## 参考 -- [lark-drive](../SKILL.md) -- 云空间全部命令 +- [lark-drive](../SKILL.md) -- 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数 diff --git a/skills/lark-drive/references/lark-drive-version-history.md b/skills/lark-drive/references/lark-drive-version-history.md index e1a229776..4f2ba8281 100644 --- a/skills/lark-drive/references/lark-drive-version-history.md +++ b/skills/lark-drive/references/lark-drive-version-history.md @@ -69,5 +69,5 @@ lark-cli drive +version-history \ ## 参考 -- [lark-drive](../SKILL.md) -- 云空间全部命令 +- [lark-drive](../SKILL.md) -- 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数 diff --git a/skills/lark-drive/references/lark-drive-version-revert.md b/skills/lark-drive/references/lark-drive-version-revert.md index 31a9e3078..85e33bce3 100644 --- a/skills/lark-drive/references/lark-drive-version-revert.md +++ b/skills/lark-drive/references/lark-drive-version-revert.md @@ -31,5 +31,5 @@ lark-cli drive +version-revert \ ## 参考 -- [lark-drive](../SKILL.md) -- 云空间全部命令 +- [lark-drive](../SKILL.md) -- 云空间（云盘/云存储）全部命令 - [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数 diff --git a/skills/lark-markdown/SKILL.md b/skills/lark-markdown/SKILL.md index 1540ed810..881d1e4fe 100644 --- a/skills/lark-markdown/SKILL.md +++ b/skills/lark-markdown/SKILL.md @@ -21,7 +21,7 @@ metadata: - 用户要**覆盖更新 Drive 里某个 `.md` 文件内容**，使用 `lark-cli markdown +overwrite` - 用户要先拿 Markdown 文件的历史版本号，再做比较/下载/回滚，先用 [`lark-drive`](../lark-drive/SKILL.md) 的 `lark-cli drive +version-history` - 用户要把本地 Markdown **导入成在线新版文档（docx）**，不要用本 skill，改用 [`lark-drive`](../lark-drive/SKILL.md) 的 `lark-cli drive +import --type docx` -- 用户要对 Markdown 文件做**rename / move / delete / 搜索 / 权限 / 评论**等云空间操作，不要留在本 skill，切到 [`lark-drive`](../lark-drive/SKILL.md) +- 用户要对 Markdown 文件做**rename / move / delete / 搜索 / 权限 / 评论**等云空间（云盘/云存储）操作，不要留在本 skill，切到 [`lark-drive`](../lark-drive/SKILL.md) ## 核心边界 diff --git a/skills/lark-minutes/SKILL.md b/skills/lark-minutes/SKILL.md index 2b2d8ea78..749816e58 100644 --- a/skills/lark-minutes/SKILL.md +++ b/skills/lark-minutes/SKILL.md @@ -66,11 +66,11 @@ lark-cli vc +notes --minute-tokens 1. 当用户需要通过上传本地音视频文件来生成妙记时使用。 2. 当用户说"把音视频文件转成纪要""把录音转成逐字稿/文字稿/撰写文字""把 mp4/mp3 转成总结/待办/章节"时，也先走这个入口。 3. **处理流程**： - - **上传音视频获取 `file_token`**：使用 [`lark-cli drive +upload`](../lark-drive/references/lark-drive-upload.md) 上传本地文件到云空间并获取 `file_token`。 + - **上传音视频获取 `file_token`**：使用 [`lark-cli drive +upload`](../lark-drive/references/lark-drive-upload.md) 上传本地文件到云空间（云盘/云存储）并获取 `file_token`。 - **生成妙记**：获取到 `file_token` 后，调用 [`lark-cli minutes +upload`](references/lark-minutes-upload.md) 将文件转换为妙记并获取 `minute_url` 链接。 - **继续获取纪要 / 逐字稿（按需）**：如果用户目标不是只要妙记链接，而是要纪要、逐字稿、总结、待办或章节，则从 `minute_url` 中提取 `minute_token`，再调用 [`lark-cli vc +notes --minute-tokens`](../lark-vc/references/lark-vc-notes.md) 获取对应产物。 -> **注意**：必须先获取飞书云空间的 `file_token` 才能进行转换。 +> **注意**：必须先获取飞书云空间（云盘/云存储）的 `file_token` 才能进行转换。 > > **不要误走本地转写工具**：当用户目标是把本地音视频文件转成纪要、逐字稿、文字稿、撰写文字时，不要改用 `ffmpeg`、`whisper` 或其他本地 ASR/转码命令；标准路径就是 `drive +upload -> minutes +upload -> vc +notes --minute-tokens`。 diff --git a/skills/lark-minutes/references/lark-minutes-upload.md b/skills/lark-minutes/references/lark-minutes-upload.md index af3c6923c..75f5e2fe1 100644 --- a/skills/lark-minutes/references/lark-minutes-upload.md +++ b/skills/lark-minutes/references/lark-minutes-upload.md @@ -17,8 +17,8 @@ 当用户要求将音视频文件转换为妙记，或进一步要纪要/逐字稿/文字稿/撰写文字时，必须按照以下步骤执行： -1. **上传文件至云空间获取 file_token** - - 使用 `lark-cli drive +upload` 命令上传本地文件到云空间（Drive）： +1. **上传文件至云空间（云盘/云存储）获取 file_token** + - 使用 `lark-cli drive +upload` 命令上传本地文件到云空间/云盘/云存储（Drive）： ```bash lark-cli drive +upload --file ``` @@ -44,7 +44,7 @@ ## 命令示例 ```bash -# 通过已上传到云空间的 file_token 生成妙记 +# 通过已上传到云空间（云盘/云存储）的 file_token 生成妙记 lark-cli minutes +upload --file-token boxcnxxxxxxxxxxxxxxxx # 通过 minute_token 继续获取纪要 / 逐字稿 / 文字稿 / AI 产物 @@ -55,7 +55,7 @@ lark-cli vc +notes --minute-tokens obcnxxxxxxxxxxxxxxxx | 参数 | 必填 | 说明 | |------|------|------| -| `--file-token ` | 是 | 已经上传到飞书云空间的音视频文件的 file_token | +| `--file-token ` | 是 | 已经上传到飞书云空间（云盘/云存储）的音视频文件的 file_token | ## 支持的格式与限制 @@ -72,13 +72,13 @@ lark-cli vc +notes --minute-tokens obcnxxxxxxxxxxxxxxxx ### 1. 必须提供 file_token -本接口不直接处理本地文件的上传，必须先使用 `drive +upload` 将文件上传到云空间获取 `file_token`，然后再调用本接口。 +本接口不直接处理本地文件的上传，必须先使用 `drive +upload` 将文件上传到云空间（云盘/云存储）获取 `file_token`，然后再调用本接口。 ### 2. 先上传，再生成妙记 推荐流程如下： -1. 使用 `lark-cli drive +upload --file ` 上传本地音视频文件到云空间 +1. 使用 `lark-cli drive +upload --file ` 上传本地音视频文件到云空间（云盘/云存储） 2. 从返回结果中取出 `file_token` 3. 调用 `lark-cli minutes +upload --file-token ` 生成妙记 4. 如果目标是纪要、逐字稿、文字稿、撰写文字、总结、待办或章节，再从 `minute_url` 提取 `minute_token`，继续调用 `lark-cli vc +notes --minute-tokens ` @@ -100,5 +100,5 @@ lark-cli vc +notes --minute-tokens obcnxxxxxxxxxxxxxxxx ## 参考 - [lark-minutes](../SKILL.md) -- 妙记相关功能说明 -- [drive +upload](../../lark-drive/references/lark-drive-upload.md) -- 上传文件到云空间 +- [drive +upload](../../lark-drive/references/lark-drive-upload.md) -- 上传文件到云空间（云盘/云存储） - [lark-shared](../../lark-shared/SKILL.md) -- 认证和全局参数 diff --git a/skills/lark-shared/SKILL.md b/skills/lark-shared/SKILL.md index 27980b83a..42e0cb443 100644 --- a/skills/lark-shared/SKILL.md +++ b/skills/lark-shared/SKILL.md @@ -29,14 +29,14 @@ lark-cli config init --new | 身份 | 标识 | 获取方式 | 适用场景 | |------|------|---------|---------| -| user 用户身份 | `--as user` | `lark-cli auth login` 等 | 访问用户自己的资源（日历、云空间等） | +| user 用户身份 | `--as user` | `lark-cli auth login` 等 | 访问用户自己的资源（日历、云空间/云盘/云存储等） | | bot 应用身份 | `--as bot` | 自动，只需 appId + appSecret | 应用级操作,访问bot自己的资源 | ### 身份选择原则 输出的 `[identity: bot/user]` 代表当前身份。bot 与 user 表现差异很大，需确认身份符合目标需求： -- **Bot 看不到用户资源**：无法访问用户的日历、云空间文档、邮箱等个人资源。例如 `--as bot` 查日程返回 bot 自己的（空）日历 +- **Bot 看不到用户资源**：无法访问用户的日历、云空间（云盘/云存储）文档、邮箱等个人资源。例如 `--as bot` 查日程返回 bot 自己的（空）日历 - **Bot 无法代表用户操作**：发消息以应用名义发送，创建文档归属 bot - **Bot 权限**：只需在飞书开发者后台开通 scope，无需 `auth login` - **User 权限**：后台开通 scope + 用户通过 `auth login` 授权，两层都要满足 diff --git a/skills/lark-sheets/SKILL.md b/skills/lark-sheets/SKILL.md index c9098fdea..d620a9bbf 100644 --- a/skills/lark-sheets/SKILL.md +++ b/skills/lark-sheets/SKILL.md @@ -1,7 +1,7 @@ --- name: lark-sheets version: 1.2.0 -description: "飞书电子表格：创建和操作电子表格。支持创建表格、创建/复制/删除/更新工作表、读写单元格、追加行数据、查找内容、导出文件。当用户需要创建电子表格、管理工作表、批量读写数据、在已知表格中查找内容、导出或下载表格时使用。若用户是想按名称或关键词搜索云空间里的表格文件，请改用 lark-drive 的 drive +search 先定位资源。" +description: "飞书电子表格：创建和操作电子表格。支持创建表格、创建/复制/删除/更新工作表、读写单元格、追加行数据、查找内容、导出文件。当用户需要创建电子表格、管理工作表、批量读写数据、在已知表格中查找内容、导出或下载表格时使用。若用户是想按名称或关键词搜索云空间（云盘/云存储）里的表格文件，请改用 lark-drive 的 drive +search 先定位资源。" metadata: requires: bins: ["lark-cli"] @@ -95,7 +95,7 @@ Wiki Space (知识空间) └── obj_type: file/slides/mindnote └── obj_token (真实文档 token) -Drive Folder (云空间文件夹) +Drive Folder (云空间/云盘/云存储文件夹) └── File (文件/文档) └── file_token (直接使用) ``` diff --git a/skills/lark-sheets/references/lark-sheets-cell-data.md b/skills/lark-sheets/references/lark-sheets-cell-data.md index dca3d20c8..d8942f0f8 100644 --- a/skills/lark-sheets/references/lark-sheets-cell-data.md +++ b/skills/lark-sheets/references/lark-sheets-cell-data.md @@ -121,7 +121,7 @@ lark-cli sheets +append --spreadsheet-token "shtxxxxxxxx" \ 对应命令：`lark-cli sheets +find` -只在一个已知 spreadsheet 内查找单元格内容，不是云空间搜索。 +只在一个已知 spreadsheet 内查找单元格内容，不是云空间（云盘/云存储）搜索。 ```bash lark-cli sheets +find --url "https://example.larksuite.com/sheets/shtxxxxxxxx" \ diff --git a/skills/lark-wiki/SKILL.md b/skills/lark-wiki/SKILL.md index e98723dbf..b089b47c9 100644 --- a/skills/lark-wiki/SKILL.md +++ b/skills/lark-wiki/SKILL.md @@ -52,7 +52,7 @@ metadata: - `我的文档库` / `My Document Library` / `我的知识库` / `个人知识库` / `my_library` 都应视为 **Wiki personal library**，不是 Drive 根目录 - 处理这类目标时，先解析 `my_library` 对应的真实 `space_id`，再执行 `wiki +move`、`wiki +node-create` 或其他 Wiki 写操作 - 不要因为缺少显式 `space_id` 就退化成 `drive +move` -- 如果用户明确说的是 Drive 文件夹、云空间根目录、`我的空间`，才进入 Drive 域处理 +- 如果用户明确说的是 Drive 文件夹、云空间（云盘/云存储）根目录、`我的空间`，才进入 Drive 域处理 ## Shortcuts（推荐优先使用） diff --git a/skills/lark-wiki/references/lark-wiki-move.md b/skills/lark-wiki/references/lark-wiki-move.md index 11031ba4f..2e670b793 100644 --- a/skills/lark-wiki/references/lark-wiki-move.md +++ b/skills/lark-wiki/references/lark-wiki-move.md @@ -15,12 +15,12 @@ - `drive +move` 的目标是 **Drive 文件夹**，使用 `--folder-token` - 如果源对象已经是 Wiki 节点，必须使用 `wiki +move`，而不是 `drive +move` - 如果源对象还是 Drive 文档，但用户要“迁入知识库”“挂到某个 Wiki 页面下”，也应使用 `wiki +move` -- 如果用户只是想整理云空间文件夹，把文件/文件夹挪到另一个 Drive 文件夹，应使用 `drive +move` +- 如果用户只是想整理云空间（云盘/云存储）文件夹，把文件/文件夹挪到另一个 Drive 文件夹，应使用 `drive +move` ## 口语目标识别 - 当用户说“移动到某个知识库”“挂到某个页面下”“迁入 Wiki”时，按 **Wiki 目标** 处理，优先使用 `wiki +move` -- 当用户说“移动到某个文件夹”“移动到云空间根目录”时，按 **Drive 文件夹目标** 处理，优先使用 `drive +move` +- 当用户说“移动到某个文件夹”“移动到云空间（云盘/云存储）根目录”时，按 **Drive 文件夹目标** 处理，优先使用 `drive +move` - 当用户说“移动到我的文档库”“移动到我的知识库”“放到个人知识库”时，应先按 **Wiki 个人知识库目标** 理解，而不是直接退化成 `drive +move` - 遇到“我的文档库”这类表述时，可以把它理解成：先用 `my_library` 去查询用户个人知识库，再拿到真实 `space_id` - 推荐做法是先执行 `lark-cli wiki spaces get --params '{"space_id":"my_library"}'`，取回真实知识库 `space_id`，再把这个 `space_id` 用到 `wiki +move`