Dingtalk Drive

当前最短路径

• 已知 dentryUuid：直接执行 inspect/download/list/move/rename，禁止先 search；仅确认是受支持的在线文档节点后才执行 copy。
• 任务若明确要求“在新知识库用本地文件建在线文档，再移到我的文档”，不属于 Drive 根目录整理：禁止预查 mySpace/rootFolderId，禁止 doc +create 后 drive +move；应由 Wiki 创建空间，Doc +import --workspace <新workspaceId>，再 Wiki +move-to-drive --workspace <新workspaceId>。
• 当前命令需要定位空间且缺少目标 ID 时：先明确企业空间 orgSpace 或“我的文件”mySpace，用 dws wiki space list --type <类型> --format json 发现空间；orgSpace 在 nextToken 非空时以 --cursor <nextToken> 续页，mySpace 固定单条且不分页。按后续命令取真实 spaceId 或 rootFolderId 后立即回到 Drive；已知这些 ID 时不做空间发现。
• 只有名称：+search → 唯一候选的 nodeId → 目标命令；不得自动选择第一项。
• 只有文件夹层级：从最近的已知 folder ID 开始 +list，不要从根目录无界递归。
• 上传普通文件：单条 +upload；知识库/文档空间目标显式加 --workspace，不要退回 upload-info + 手写 HTTP + commit。转换为在线文档走 Doc +import，插入正文附件走 Doc +media-insert。
• 导出后上传：doc +export 首次就指定最终本地文件名，直接复用回执 localPath，首次正式 drive +upload 带已获授权的 --yes；禁止上传后再 rename。
• copy/move/rename/create-folder 已内置写后读取时，不再由 Agent重复执行 +inspect。
• 已知 nodeId 的重命名直接 +rename，不先 Catalog、Help 或 search；ALIDOC 的逻辑标题由 shortcut 内部文档读回验证。
• 文件夹方向已明确时直接 status/pull/push/sync，不先 status；写操作先用完全相同参数 dry-run，再正式执行。
• 搜索结果 type=able 后按业务动词重路由：结构复制/删除/Base 内操作走 AITable。结构复制按当前 leaf 提供源 Base ID 和真实 --target-folder-id；缺少目标 ID 时停止，不猜根 ID或发明 --target-root。
• +inspect/+download/+list 只保证 dentryUuid；只有 URL 时先用 dws drive info --node <URL> --format json 解析并核对 result.fileId（即 dentryUuid）。
• drive info 返回 extension=dlink 时，将 result.fileId 保存为快捷方式入口 ID，先用 dws doc info --node <result.fileId> --format json 读取 linkSourceInfo。内容读取、编辑、导出和类型路由改用目标 linkSourceInfo.nodeId；目标仍为 dlink 时逐跳解析并记录已访问 ID，解析失败、字段缺失或 ID 重复即停。用户明确移动、重命名或删除快捷方式入口本身时仍使用最初的 result.fileId。

最短路径不省略类型检查、确认、传输验证或写后校验。

关键结果语义

• +list/+search/+recent 的完整查询统一使用 --page-all --max-pages <N> --max-items <N>，并检查集合、完整性和截断状态；只需首批结果时可不加 --page-all。缺少集合不能当空结果，多候选禁止默认第一项。
• +download 验证相对路径存在且 sizeBytes > 0；+upload 检查最终 nodeId 和完整名称。普通 Drive 目标必须校验读回大小；指定 --workspace 时必须验证 workspaceId，并兼容 doc/get_document_info 将完整名称拆为 name + extension 且不返回大小的真实契约；若返回大小仍必须与本地一致。只有源端与结果都提供可比哈希时才核对 checksum；缺失时保留现有证据，不虚构端到端校验和。
• copy/move/rename/create-folder 检查 ok/outcome 和读回；partial_success 不是完成。
• status 检查分类集合；pull/push/sync 检查 summary 和逐项结果，failed/unknown 必须保留。
• 分页未结束时返回 continuation；目录树或大列表必须有最大深度、页数和条目数。
• 同一查询续页时，若 nextCursor 重复且没有新增节点，停止继续翻页，保留已取得结果并报告分页未完成，不将重复结果计作新增。
• 未知写入效果先 inspect/list 回读，不盲目重放写操作。

参数与安全边界

• --node、--folder 使用 dentryUuid/fileId，不使用数字型 dentryId；回收站 restore 使用 recycleItemId。
• +list --limit 最大 50，+search --limit 最大 30；超过时分页，不以非法参数反复试错。
• 写操作只按精确 leaf Runtime 判定确认；已明确授权具体对象、动作与影响时，首次正式执行直接带 --yes，否则先确认。预览不带，参数变化重新确认；禁止用缺少 --yes 的失败探测。
• 普通文件覆盖前确认真实类型和原名称；adoc/axls/able 不按普通文件覆盖。
• 单文件 Shortcut 的本地输入输出使用 cwd 相对路径且禁止 ..；文件夹 status/pull/push/sync 按 leaf 契约使用绝对 --local-folder。
• 文件夹同步默认精确 MD5；仅在用户接受时间戳近似时用 --quick，且不会删除任一侧多余文件。
• 参数不确定时只查一次精确 leaf Schema；禁止产品级 Schema。

按需加载

Golden Route 参数足够时禁止读取 reference。其余最多读取一个精确 reference：

错误最短路径

1. 零/多候选、类型不明或分页不完整：停止写入，返回候选或 continuation；分页读取可在有效游标和预算内继续。
2. unknown flag：只查一次当前 leaf Help；unknown command：只查一次 Drive shortcut 清单。
3. 普通下载遇到在线文档类型：切 doc +export，不重复尝试 Drive download。
4. 传输中断：保留本地临时状态或 checkpoint；先判断能否续传。
5. 写入效果未知：按 nodeId 回读；无法证明时报告 unknown。
6. 已知是普通文件且需要独立副本时，直接按 Golden Route 的 download→upload 执行，不以 +copy 失败作为前置探测。若仍收到普通文件 copy 不支持的错误，不重试或宣称已完成；确认授权与目标后按副本规则继续。AITable 结构复制缺少或无法验证目标文件夹时停止，不猜 ID 或创建测试文件夹。

跨产品边界

• 普通文件/文件夹及在线文档节点的存储管理 → Drive；把文件作为附件放进某篇文档正文走 Doc +media-insert，其他正文/内容分别走 Doc、Sheet、AITable。
• able 外层移动/重命名走 Drive；结构复制、Base 删除（+base-delete）及 Base 内操作走 AITable。
• 明确知识库 workspace 层级 → Wiki；泛称“文档空间/我的文档”通常走 Drive，但“Wiki 库内节点移出到我的文档”固定由 Wiki +move-to-drive 完成，Drive 不预查 mySpace、不接管该移动。
• 钉盘存储空间发现例外地复用 managed dws wiki space list --type orgSpace|mySpace；只取真实 spaceId/rootFolderId 后回到 Drive。spaceId 用于空间参数，rootFolderId 才可作为空间根目录 folder；orgWikiSpace/myWikiSpace 返回 workspaceId，不能混入 Drive 参数。
• Word/Markdown/Text 转在线文档用 doc +import；Drive upload 只保留原文件。