| name | dingtalk-drive |
| description | 钉钉文件管理（存储层）。Use when 用户说 钉盘/上传文件/下载文件/文件夹/查文件/找文件/全局搜索文件/复制/移动/重命名/删除/回收站/还原删除文件/权限管理/普通文件下载。任何文件类型都适用；文档内容编辑走 dingtalk-doc，知识库空间和空间内节点管理走 dingtalk-wiki。命令前缀：dws drive。 |
| metadata | {"cli_version":">=0.2.14","category":"product","requires":{"bins":["dws"]}} |
钉盘 Skill
前置条件 — 执行操作前必读
**CRITICAL — 执行任何 dws 操作前，MUST 先用 Read 工具完整读取 dws-shared。**该轻量文件包含全局执行契约、安全底线及 shared references 的按需加载导航；不要预加载其全部 references。
命令参考：drive.md。
Shortcuts（无专用脚本/recipe 时优先）
以下 shortcut 同时进入公开 catalog 与 Runtime Schema。先按本 skill 的意图表、脚本和 recipe 路由：存在精确覆盖该场景的专用脚本/recipe 时按其执行；否则用户意图命中时，shortcut 优先于手写原子命令。用 leaf Schema（例如 dws schema --cli-path "drive +<shortcut>" --format json）读取 Agent 选择、参数、约束、风险和确认语义；用 dws shortcut list --service drive --format json 批量发现；最后以 dws drive <shortcut> --help 核对当前 Cobra flags。
| Shortcut | 风险 | 适用场景 |
|---|
dws drive +copy | write | 复制文件/文档到指定位置 |
dws drive +find-file | read | 按名称关键词搜索钉盘文件并投影关键字段（只读） |
dws drive +info | read | 获取钉盘文件/文件夹元数据 |
dws drive +move | write | 移动文件/文档到指定位置 |
dws drive +recent | read | 获取最近访问/编辑的文档列表 |
dws drive +search | read | 搜索钉盘文件 |
dws drive +search-docs | read | 搜索文档空间文档 |
意图表
| 用户说 | 命令 |
|---|
| "看钉盘文件 / 文件夹列表" | dws drive list [--folder <dentryUuid>] |
| "钉盘目录树" | python scripts/drive_tree_list.py --depth 2 |
| "查文件元数据" | dws drive info --node <dentryUuid> |
| "搜文件 / 找文件" | dws drive search --query "<关键词>" |
| "下载文件" | dws drive download --node <dentryUuid> --output <path> |
| "上传文件" | dws drive upload --file <path> [--folder <id>] |
| "建钉盘文件夹" | dws drive mkdir --name "<名称>" [--folder <id>] |
| "复制/移动/重命名/删除/权限管理" | dws drive copy/move/rename/delete/permission ... |
| "回收站 / 还原删除的文件" | dws drive recycle list / dws drive recycle restore --id <recycleItemId> |
标准 SOP（必遵流程）
命中以下意图必须按对应 SOP 顺序执行；禁止跳步、替换命令、编造 dentryUuid/nodeId。每条命令必须带 --format json。破坏性操作（删除/移动/覆盖/公开）必须先与用户确认。
SOP-1 找文件（find-file）
触发：找文件/搜文件/我的文件/最近文件/某文档在哪。
- 选源（必须）：最近访问 →
dws drive recent --limit <n> --format json（翻页用上次返回的 nextCursor 传 --cursor）；按内容/名称全局搜 → dws drive search --query "<关键词>" --format json；浏览某目录 → dws drive list --folder <dentryUuid> --format json。
- 解析（必须）：取真实
dentryUuid（= id/nodeId）；多候选让用户确认，禁止默认取第一个。
- 下钻（必须）：根目录没命中时，进入最相关文件夹继续
drive list --folder，必要时 python scripts/drive_tree_list.py --depth 2 递归，禁止只看根目录就放弃。
- 回读元数据（必须）：命中后
dws drive info --node <dentryUuid> --format json，按 extension 确认类型。
禁止：编造 dentryUuid、只看根目录放弃、用 drive list 替代 drive search 做全局查找。
SOP-2 上传 / 下载（upload-download）
触发：上传文件/下载文件/传到钉盘/用本地文件覆盖已有文件。
- 上传（必须）：
dws drive upload --file <本地路径> [--folder <dentryUuid>] --format json；返回取 dentryUuid，用 drive info --node 回读确认。
- 覆盖（必须）：先
dws drive info --node <dentryUuid> --format json，记录真实 extension 和原 name。extension=md 切 dingtalk-markdown，先 markdown overwrite --dry-run 再确认执行；其他普通文件在用户确认后执行 dws drive upload --node <dentryUuid> --file <本地路径> --file-name "<原name>" --format json，随后再次 drive info 回读。adoc / axls / able 切对应内容 skill/reference，不按普通文件覆盖。
- 下载（必须）：先
dws drive info --node <dentryUuid> --format json 判断类型——extension=adoc 切 dingtalk-doc 用 doc export；普通文件执行 dws drive download --node <dentryUuid> --output <本地路径> --format json。
禁止：对在线文档用 drive download（会失败）、普通文件覆盖时省略 --file-name 导致隐式重命名、上传或覆盖后不回读。
SOP-3 文件夹 / 复制 / 移动 / 重命名（folder-ops）
触发：建文件夹/复制/移动/重命名。
- 执行（必须）：建钉盘文件夹
dws drive mkdir --name "<名称>" [--folder <id>]；复制 drive copy --node <dentryUuid> --folder <目标>；移动 drive move --node <dentryUuid> --folder <目标>；重命名 drive rename --node <dentryUuid> --name "<新名>"。全部加 --format json。
- 验证（必须）：操作后
drive info --node <新dentryUuid> 或 drive list --folder <目标> 回读。
禁止：未确认就移动/覆盖他人文件、跳过回读。
SOP-4 回收站（recycle）
触发：删文件/回收站/还原。
- 删除（必须）：
dws drive delete --node <dentryUuid> --format json（必须先与用户确认）。
- 还原（必须）：
dws drive recycle list --format json 取 recycleItemId → dws drive recycle restore --id <recycleItemId> --format json。
禁止：未确认就删除、把 dentryUuid 当 recycleItemId 传给 restore。
SOP-5 互联网公开（publish）
触发：互联网公开/取消公开/查公开状态。
- 执行（必须）：查状态
dws drive publish get --node <dentryUuid> --format json；开启公开 dws drive publish set --node <dentryUuid> --yes（[危险] 必须用户确认）；关闭公开 dws drive publish unset --node <dentryUuid> --yes。
- 边界（必须）：对外公开前必须与用户确认边界与后果。
禁止：未确认就 publish set、跳过 --yes。
高频硬约束
- 查找文件不要只看根目录后放弃；根目录没命中时，进入最相关的目标文件夹继续
drive list --folder <dentryUuid>，必要时用目录树脚本递归到合理深度。
drive list 默认 --limit 20，自动化场景里保守使用 --limit 50 以内并处理 nextToken 翻页；不要因为参数边界报错反复重试。- 全局找文件优先
drive search --query；指定目录浏览用 drive list，命中后必须 drive info --node <dentryUuid> --format json 回读元数据。
- 删除、覆盖、移动等破坏性操作必须确认；上传、创建文件夹、下载后要读回或列目录验证。
- 所有
dws drive 命令加 --format json。
跨产品协作
- 文件内容编辑（钉钉文档）→ 切到
dingtalk-doc
- 知识库空间 → 切到
dingtalk-wiki
局部意图与短流程
