{
  "version": 1,
  "source": {
    "kind": "explicit",
    "name": "dws-agent-selection/drive",
    "repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
    "channel": "open-source",
    "reviewed": true
  },
  "tools": {
    "drive.add_permission": {
      "agent_summary": "为文档空间节点添加协作成员并授予指定角色",
      "use_when": [
        "给单篇文档/文件夹/文件做节点级授权（USER + 角色 MANAGER/EDITOR/DOWNLOADER/READER）时",
        "用户说把某篇文档分享给某人看/可编辑时（含「我的文档」下的节点）"
      ],
      "avoid_when": [
        "给整个知识库加成员改用 dws wiki member add（「我的文档」不支持容器成员）",
        "只查已有权限改用 dws drive permission list",
        "改角色/移除分别用 permission update / remove"
      ],
      "examples": [
        "dws drive permission add --node <ID> --users uid1,uid2 --role READER --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.add_permission",
        "cobra-help:dws drive permission add",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#drive.add_permission",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:dws schema doc.add_permission"
      ]
    },
    "drive.apply_permission": {
      "agent_summary": "向审批人发起文档权限申请（会真实通知审批人）",
      "use_when": [
        "用户确认要为无权限文档发起权限申请"
      ],
      "avoid_when": [
        "先用 apply-info 查可申请角色与审批人；未经用户确认不得自行提交"
      ],
      "examples": [
        "dws drive permission apply --node <DOC_ID> --role READER --users <审批人userId> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.apply_permission",
        "cobra-help:dws drive permission apply",
        "wukong-develop:wukong/products"
      ]
    },
    "drive.commit_upload": {
      "agent_summary": "提交文件上传",
      "use_when": [
        "手动三步上传的最后一步：已 PUT 到 OSS，用 upload-info 返回的 uploadId 提交入库时"
      ],
      "avoid_when": [
        "普通上传请用 dws drive upload",
        "尚未 PUT 成功或 uploadId 过期时不要 commit；需重新 upload-info"
      ],
      "examples": [
        "dws drive commit --file-name \"report.pdf\" --file-size 102400 --upload-id <UPLOAD_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.commit_upload",
        "cobra-help:dws drive commit",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#drive.commit_upload",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#drive.commit_upload",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:dws schema drive.commit_upload"
      ]
    },
    "drive.copy_document": {
      "agent_summary": "将文件或文档复制到目标文件夹或知识库（保留原位置；默认「我的文档」）",
      "use_when": [
        "用户要复制/拷贝一份文件或文档到新位置，且原位置仍需保留副本时（copy≠move）",
        "目标是指定文件夹：传 --folder <目标文件夹 dentryUuid/fileId>",
        "目标是知识库根目录：只传 --workspace <workspaceId 或知识库 URL>，不传 --folder",
        "用户未指定目标时：默认落到当前组织「我的文档」；若需钉盘「我的文件」根目录，先 wiki space list --type mySpace 取 rootFolderId 再 --folder",
        "跨钉盘 space 复制到子文件夹：先 list 取目标文件夹 fileId，再 --folder 传入"
      ],
      "avoid_when": [
        "用户意图是搬走/迁移且原位置不再保留时改用 dws drive move（move 需更高源权限）",
        "只要快捷方式入口、不要独立副本时改用 dws drive shortcut",
        "已在明确知识库上下文内复制节点且需带 --workspace/--node 的 wiki 入口时可用 dws wiki node copy；跨产品默认用本命令",
        "目标文件夹或知识库尚未确认时不要复制"
      ],
      "examples": [
        "dws drive copy --node <源dentryUuid> --folder <目标文件夹fileId> --format json",
        "dws drive copy --node <源dentryUuid> --workspace <TARGET_WS_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.copy_document",
        "cobra-help:dws drive copy",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#drive.copy_document",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:dws schema doc.copy_document"
      ]
    },
    "drive.create_folder": {
      "agent_summary": "创建文件夹",
      "use_when": [
        "用户要在钉盘/「我的文件」下新建普通文件夹时",
        "已知父目录 dentryUuid，要在其下建子目录时"
      ],
      "avoid_when": [
        "要在知识库内建文件夹改用 dws wiki node create --type folder --workspace <id>",
        "要创建在线文档(adoc)改用 dws doc create 或 wiki node create --type adoc"
      ],
      "examples": [
        "dws drive mkdir --name \"项目资料\" --format json",
        "dws drive mkdir --name \"子目录\" --folder <dentryUuid> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.create_folder",
        "cobra-help:dws drive mkdir",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#drive.create_folder",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#drive.create_folder",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:dws schema drive.create_folder"
      ]
    },
    "drive.create_shortcut": {
      "agent_summary": "为钉盘或文档空间中的现有节点创建快捷方式。",
      "use_when": [
        "用户要给已有节点建快捷方式/软链接到目标文件夹或知识库时"
      ],
      "avoid_when": [
        "要复制一份独立副本改用 dws drive copy（copy≠shortcut）",
        "要移动原文件改用 dws drive move"
      ],
      "examples": [
        "dws drive shortcut --node <SOURCE_NODE> --format json",
        "dws drive shortcut --node <SOURCE_NODE> --folder <TARGET_FOLDER> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "internal/cli/schema_command_registry.json#drive.create_shortcut",
        "cobra-help:dws drive shortcut --help",
        "skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:none (Cobra+Skill; composite/unpinned)"
      ]
    },
    "drive.delete_document": {
      "agent_summary": "将钉盘中的文件或文件夹移入回收站",
      "use_when": [
        "用户明确要求把钉盘/文档空间中的文件或文件夹移入回收站，且已确认目标节点时"
      ],
      "avoid_when": [
        "用户未确认删除目标或只是想移走位置时不要删；搬迁用 dws drive move",
        "要删整个知识库改用 dws wiki space delete",
        "要永久删评论改用 dws doc comment delete"
      ],
      "examples": [
        "dws drive delete --node <dentryUuid> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.delete_document",
        "cobra-help:dws drive delete",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#drive.delete_document",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:dws schema doc.delete_document"
      ]
    },
    "drive.download_file": {
      "agent_summary": "下载钉盘或文档空间文件到本地",
      "use_when": [
        "用户要把钉盘普通文件（PDF/图片/Office 等非在线文档）下载到本地路径时",
        "已确认 contentType 非 ALIDOC，需要落盘本地查看时"
      ],
      "avoid_when": [
        "在线文档(adoc)要导出为 Word/docx 改用 dws doc export，不要用 download 代替导出",
        "只要临时下载链接语义且走文档附件块时用 dws doc media download",
        "未指定 --output 不要调用（CLI 必填）"
      ],
      "examples": [
        "dws drive download --node <dentryUuid> --output ./report.pdf --format json",
        "dws drive download --node <dentryUuid> --output ~/downloads/ --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.download_file",
        "cobra-help:dws drive download",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#drive.download_file",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#drive.download_file",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:dws schema drive.download_file"
      ]
    },
    "drive.download_file_version": {
      "agent_summary": "下载钉盘普通文件的指定历史版本到本地（两步下载：取签名 URL 后 HTTP GET）",
      "use_when": [
        "用户要下载文件的历史版本/旧版本",
        "版本号已通过 drive list --versions 获取"
      ],
      "avoid_when": [
        "下载最新版本用 drive download",
        "在线文档（adoc）历史版本用 doc version 系列命令",
        "在线表格（axls）历史版本用 sheet version 系列命令"
      ],
      "examples": [
        "dws drive download-version --node <dentryUuid> --version 3 --output ./report_v3.pdf"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：对照悟空 develop drive download --version 分支实现移植为独立命令；单一 download_file_version 远端调用，参数契约与帮助文档一致。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.download_file_version",
        "cobra-help:dws drive download-version",
        "wukong-develop:wukong/products/drive.go"
      ]
    },
    "drive.get_cover": {
      "agent_summary": "获取节点封面图片地址（文档首图/图片缩略图/类型图标）",
      "use_when": [
        "用户说 封面/封面图/缩略图/预览图"
      ],
      "avoid_when": [
        "设置文档封面用 doc style cover set"
      ],
      "examples": [
        "dws drive cover --node <dentryUuid> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.get_cover",
        "cobra-help:dws drive cover",
        "wukong-develop:wukong/products"
      ]
    },
    "drive.get_file_info": {
      "agent_summary": "获取文件元数据信息",
      "use_when": [
        "用户要查看钉盘文件/文件夹元信息（名称、类型、大小、路径、时间）时",
        "准备读内容前需先判断 extension/是否在线文档，再路由到 doc read / sheet / download 时"
      ],
      "avoid_when": [
        "要读在线文档正文改用 dws doc read（先本命令或 doc info 确认类型）",
        "要下载普通文件改用 dws drive download",
        "只要目录列表改用 dws drive list"
      ],
      "examples": [
        "dws drive info --node <dentryUuid> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.get_file_info",
        "cobra-help:dws drive info",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#drive.get_file_info",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#drive.get_file_info",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:dws schema drive.get_file_info"
      ]
    },
    "drive.get_node_stats": {
      "agent_summary": "读取指定钉盘或文档空间节点的阅读、编辑、评论、点赞、预览与下载等统计。",
      "use_when": [
        "用户要查看节点阅读/编辑/评论/点赞/预览/下载等统计维度时"
      ],
      "avoid_when": [
        "要改文件内容或权限不要用本命令；本命令只读",
        "只要元信息（名称/类型）改用 dws drive info 或 dws doc info"
      ],
      "examples": [
        "dws drive stats --node <NODE_ID_OR_URL> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "internal/cli/schema_command_registry.json#drive.get_node_stats",
        "cobra-help:dws drive stats --help",
        "skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:none (Cobra+Skill; composite/unpinned)"
      ]
    },
    "drive.get_star_list": {
      "agent_summary": "获取当前用户的收藏列表，支持分页与按内容类型筛选",
      "use_when": [
        "用户说 我的收藏/收藏列表/收藏了哪些文档"
      ],
      "avoid_when": [
        "操作单个收藏用 mark_star/unmark_star"
      ],
      "examples": [
        "dws drive star list --format json",
        "dws drive star list --content-types doc,sheet --limit 10 --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.get_star_list",
        "cobra-help:dws drive star list",
        "wukong-develop:wukong/products"
      ]
    },
    "drive.get_upload_info": {
      "agent_summary": "获取文件上传信息",
      "use_when": [
        "仅当无法使用 drive upload 一条命令、需要自定义流式上传时，获取 OSS 预签名上传凭证"
      ],
      "avoid_when": [
        "普通上传请直接用 dws drive upload，不要手动走三步",
        "拿到凭证后须 HTTP PUT 再 dws drive commit；本命令本身不完成入库"
      ],
      "examples": [
        "dws drive upload-info --file-name \"report.pdf\" --file-size 102400 --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.get_upload_info",
        "cobra-help:dws drive upload-info",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#drive.get_upload_info",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#drive.get_upload_info",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:dws schema drive.get_upload_info"
      ]
    },
    "drive.list_files": {
      "agent_summary": "获取文件/文件夹列表",
      "use_when": [
        "用户要浏览「我的文件」/钉盘/网盘某目录下有哪些文件或文件夹时",
        "已知父文件夹 dentryUuid，要列出其子项以便继续 download/copy/move 时",
        "传 --workspace 时要列出文档空间/知识库根或子目录（与 wiki node list 场景重叠时，用户说钉盘/我的文件优先本命令）"
      ],
      "avoid_when": [
        "只记得关键词、不知道所在目录时改用 dws drive search",
        "明确要在某个知识库内按目录浏览且已有 workspaceId 时可用 dws wiki node list",
        "要找最近打开/编辑过的文档改用 dws drive recent"
      ],
      "examples": [
        "dws drive list --limit 20 --format json",
        "dws drive list --folder <dentryUuid> --limit 20 --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.list_files",
        "cobra-help:dws drive list",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#drive.list_files",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#drive.list_files",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:dws schema drive.list_files"
      ]
    },
    "drive.list_permission": {
      "agent_summary": "查询文档空间节点的协作者列表",
      "use_when": [
        "查看某文档/文件夹节点当前有哪些成员及角色时"
      ],
      "avoid_when": [
        "要新增/修改/移除权限分别用 permission add/update/remove",
        "查知识库容器成员改用 dws wiki member list"
      ],
      "examples": [
        "dws drive permission list --node <ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.list_permission",
        "cobra-help:dws drive permission list",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#drive.list_permission",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:dws schema doc.list_permission"
      ]
    },
    "drive.list_spaces": {
      "agent_summary": "兼容查询钉盘空间列表",
      "use_when": [
        "兼容入口：枚举钉盘企业空间或「我的文件」空间以拿 spaceId/rootFolderId 时"
      ],
      "avoid_when": [
        "推荐改用 dws wiki space list --type orgSpace 或 --type mySpace（本命令已 deprecated）",
        "要列知识库列表改用 dws wiki space list（默认 orgWikiSpace）"
      ],
      "examples": [
        "dws drive list-spaces --space-type orgSpace --limit 20 --format json",
        "dws drive list-spaces --space-type mySpace --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.list_spaces",
        "cobra-help:dws drive list-spaces",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#drive.list_spaces",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:dws schema drive.list_spaces"
      ]
    },
    "drive.mark_star": {
      "agent_summary": "收藏文档/文件到当前用户收藏列表",
      "use_when": [
        "用户说 收藏这个文档/加个收藏/标星"
      ],
      "avoid_when": [
        "取消收藏用 unmark_star；查看收藏列表用 get_star_list"
      ],
      "examples": [
        "dws drive star add --node <nodeId> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.mark_star",
        "cobra-help:dws drive star add",
        "wukong-develop:wukong/products"
      ]
    },
    "drive.move_document": {
      "agent_summary": "将文件或文档移动到目标文件夹或知识库（原位置不再保留）",
      "use_when": [
        "用户要移动/搬走文件或文档到新位置，且原位置不再保留时（move≠copy）",
        "目标文件夹用 --folder；目标知识库根用 --workspace；都不传则默认「我的文档」",
        "移动到其他钉盘 space 根目录时传目标 space 的 rootFolderId 到 --folder（通常不传 --workspace）"
      ],
      "avoid_when": [
        "需要保留原位置副本时改用 dws drive copy",
        "目标未确认或用户只是想复制时不要 move",
        "知识库内节点移动且走 wiki 入口时可用 dws wiki node move"
      ],
      "examples": [
        "dws drive move --node <源dentryUuid> --folder <目标文件夹fileId> --format json",
        "dws drive move --node <源dentryUuid> --workspace <TARGET_WS_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.move_document",
        "cobra-help:dws drive move",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#drive.move_document",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:dws schema doc.move_document"
      ]
    },
    "drive.permission_remove": {
      "agent_summary": "从文档空间节点移除协作成员的权限",
      "use_when": [
        "从节点移除指定用户的直接授权时"
      ],
      "avoid_when": [
        "要改角色用 permission update；要加权限用 add",
        "移除知识库容器成员用 dws wiki member remove"
      ],
      "examples": [
        "dws drive permission remove --node <ID> --users uid1 --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.permission_remove",
        "cobra-help:dws drive permission remove",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#drive.permission_remove",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:dws schema doc.remove_permission"
      ]
    },
    "drive.permission_update": {
      "agent_summary": "更新文档空间节点已有协作者的权限角色",
      "use_when": [
        "调整已有节点成员角色（如 READER→EDITOR）时"
      ],
      "avoid_when": [
        "成员尚无权限时改用 permission add",
        "要移除访问改用 permission remove"
      ],
      "examples": [
        "dws drive permission update --node <ID> --users uid1 --role EDITOR --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.permission_update",
        "cobra-help:dws drive permission update",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#drive.permission_update",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:dws schema doc.update_permission"
      ]
    },
    "drive.publish_get": {
      "agent_summary": "查询文件当前是否处于互联网公开发布状态",
      "use_when": [
        "查询文件是否已互联网公开发布及公开权限（READER/DOWNLOADER/EDITOR）时"
      ],
      "avoid_when": [
        "要开启公开改用 dws drive publish set（需确认）",
        "要关闭公开改用 dws drive publish unset（需确认）"
      ],
      "examples": [
        "dws drive publish get --node <fileId> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.publish_get",
        "cobra-help:dws drive publish get",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:none (Cobra+Skill; composite/unpinned)"
      ]
    },
    "drive.publish_set": {
      "agent_summary": "开启文件的互联网公开发布",
      "use_when": [
        "用户明确要求将文件设为互联网公开（任何人凭链接可访问，无需登录）时"
      ],
      "avoid_when": [
        "只查公开状态用 publish get；要关闭公开用 publish unset",
        "目标文件或公开权限范围未确认时不要开启",
        "只要企业内部同事权限用 permission add，不要用互联网公开"
      ],
      "examples": [
        "dws drive publish set --node <fileId> --format json",
        "dws drive publish set --node <fileId> --permission READER --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.publish_set",
        "cobra-help:dws drive publish set",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:none (Cobra+Skill; composite/unpinned)"
      ]
    },
    "drive.publish_unset": {
      "agent_summary": "关闭文件的互联网公开发布",
      "use_when": [
        "用户明确要求关闭文件的互联网公开发布，使外部链接失效时"
      ],
      "avoid_when": [
        "只查状态用 publish get；要开启用 publish set",
        "目标文件未确认时不要关闭"
      ],
      "examples": [
        "dws drive publish unset --node <fileId> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.publish_unset",
        "cobra-help:dws drive publish unset",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:none (Cobra+Skill; composite/unpinned)"
      ]
    },
    "drive.query_permission_apply_info": {
      "agent_summary": "查询节点可申请的权限角色列表与审批人列表",
      "use_when": [
        "无权限访问文档时，先查可申请角色与审批人"
      ],
      "avoid_when": [
        "实际发起申请用 apply_permission"
      ],
      "examples": [
        "dws drive permission apply-info --node <DOC_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.query_permission_apply_info",
        "cobra-help:dws drive permission apply-info",
        "wukong-develop:wukong/products"
      ]
    },
    "drive.recent": {
      "agent_summary": "获取当前用户最近访问或编辑过的文档列表",
      "use_when": [
        "用户要看最近访问或最近编辑的文档列表时（默认最近访问 operate-type=0）",
        "需要按我创建/他人创建或文档类型过滤最近项时"
      ],
      "avoid_when": [
        "按关键词全局搜文件改用 dws drive search",
        "浏览某目录内容改用 dws drive list"
      ],
      "examples": [
        "dws drive recent --format json",
        "dws drive recent --operate-type 1 --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.recent",
        "cobra-help:dws drive recent",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:dws schema doc.get_recent_list"
      ]
    },
    "drive.recycle_list": {
      "agent_summary": "查看回收站文件列表",
      "use_when": [
        "用户要查看钉盘回收站里有哪些已删文件时"
      ],
      "avoid_when": [
        "要从回收站还原改用 dws drive recycle restore",
        "要删除进回收站改用 dws drive delete"
      ],
      "examples": [
        "dws drive recycle list --format json",
        "dws drive recycle list --space-id 12345 --limit 10 --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.recycle_list",
        "cobra-help:dws drive recycle list",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:none (Cobra+Skill; composite/unpinned)"
      ]
    },
    "drive.recycle_restore": {
      "agent_summary": "还原回收站中的文件",
      "use_when": [
        "用户要从回收站还原指定回收项（已从 recycle list 拿到 id）时"
      ],
      "avoid_when": [
        "尚未确认还原哪一项时先 dws drive recycle list",
        "要删除文件改用 dws drive delete，不要用 restore"
      ],
      "examples": [
        "dws drive recycle restore --id <recycleItemId> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.recycle_restore",
        "cobra-help:dws drive recycle restore",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:none (Cobra+Skill; composite/unpinned)"
      ]
    },
    "drive.rename_document": {
      "agent_summary": "安全重命名文档空间中的文档、文件或文件夹，并按节点真实扩展名避免双后缀",
      "use_when": [
        "用户要重命名钉盘/文档空间中的文件、文档或文件夹时；实际执行会读取节点类型和当前扩展名，仅去掉完全匹配的一层后缀"
      ],
      "avoid_when": [
        "要改正文里的标题/章节 H1 改用 dws doc block update，不要用 rename",
        "只要复制或移动改用 copy/move",
        "dry-run 不读取节点元数据，输出名称尚未做基于当前扩展名的规范化"
      ],
      "examples": [
        "dws drive rename --node <ID> --name \"新名称\" --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.rename_document",
        "cobra-help:dws drive rename",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#drive.rename_document",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:dws schema doc.rename_document"
      ]
    },
    "drive.revert_file_version": {
      "agent_summary": "回滚普通文件到指定历史版本（生成新最新版本，历史不丢失）",
      "use_when": [
        "用户说 回滚版本/恢复到某个版本/版本回退，且目标是普通文件"
      ],
      "avoid_when": [
        "在线文档回滚用 doc version revert；在线表格用 sheet version revert"
      ],
      "examples": [
        "dws drive revert --node <dentryUuid> --version 3 --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.revert_file_version",
        "cobra-help:dws drive revert",
        "wukong-develop:wukong/products"
      ]
    },
    "drive.search_files": {
      "agent_summary": "全局搜索文件，默认同时搜索钉盘和文档空间，合并返回结果",
      "use_when": [
        "用户要在钉盘/我的文件里按关键词找文件、文件夹或团队空间，且不知道具体路径时",
        "需要按扩展名/文件类型/创建者/时间缩小范围的全局搜索（默认 target=all 聚合钉盘+文档空间）",
        "明确搜团队空间名以拿 spaceId/rootFolderId 时用 --target space"
      ],
      "avoid_when": [
        "已明确知识库 workspaceId、只在该库内搜时改用 dws wiki node search --workspace <id>",
        "已知目录、只需浏览子项时改用 dws drive list，不要用搜索代替目录遍历",
        "首页未命中时优先改关键词/过滤条件，而不是反复翻页"
      ],
      "examples": [
        "dws drive search --query \"季度汇报\" --format json",
        "dws drive search --query \"合同\" --target file --extensions pdf,docx --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.search_files",
        "cobra-help:dws drive search",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#drive.search_files",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:dws schema drive.search_files"
      ]
    },
    "drive.shortcut_copy": {
      "agent_summary": "复制文件/文档到指定位置",
      "use_when": [
        "当你想保留原件、把某个文件/文档拷贝一份到指定文件夹或知识库时使用；输入源节点 node 及目标 folder/workspace，会实际生成一个副本，原文件位置不变。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws drive +copy --node <nodeId> --folder <targetFolderId>"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#drive.shortcut_copy",
        "cobra-help:dws drive +copy",
        "ShortcutRegistry:drive +copy"
      ]
    },
    "drive.shortcut_find_file": {
      "agent_summary": "按名称关键词搜索钉盘文件并投影关键字段（只读）",
      "use_when": [
        "当你只记得钉盘文件的名字（或其中一部分），想快速按文件名关键词找到它、拿到它的 dentryId 以便后续下载/查看，却不想手动翻目录或写复杂过滤条件时使用；内部调用钉盘的 search_files 工具，把 --query 作为文件名关键词(keyword) 并限定搜索范围为钉盘文件(searchTarget=file)，再在本地把每条命中结果精简为「文件名、类型、dentryId、大小」四个字段后打印。这是纯只读操作，只做搜索与本地投影，不会创建、移动或删除任何文件；未命中时返回空列表。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws drive +find-file --query 季度汇报",
        "dws drive +find-file --query 合同"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#drive.shortcut_find_file",
        "cobra-help:dws drive +find-file",
        "ShortcutRegistry:drive +find-file"
      ]
    },
    "drive.shortcut_info": {
      "agent_summary": "获取钉盘文件/文件夹元数据",
      "use_when": [
        "当你已经知道某个节点的 dentryUuid、想查看它的详细信息（名称、大小、类型、创建/修改时间、所属空间等）而不是仅列表概览时使用；输入 node（节点 ID），返回该单个文件或文件夹的完整元数据。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws drive +info --node <dentryUuid>"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#drive.shortcut_info",
        "cobra-help:dws drive +info",
        "ShortcutRegistry:drive +info"
      ]
    },
    "drive.shortcut_move": {
      "agent_summary": "移动文件/文档到指定位置",
      "use_when": [
        "当你要把某个文件/文档从当前位置转移到另一个文件夹或知识库（整理归档、调整目录结构）时使用；输入源节点 node 及目标 folder/workspace，会实际改变文件所在位置，原位置不再保留该文件。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws drive +move --node <nodeId> --folder <targetFolderId>"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#drive.shortcut_move",
        "cobra-help:dws drive +move",
        "ShortcutRegistry:drive +move"
      ]
    },
    "drive.shortcut_recent": {
      "agent_summary": "获取最近访问/编辑的文档列表",
      "use_when": [
        "当你想快速找回「我最近看过/改过的那个文档」而不记得它放在哪时使用；可按操作类型（最近访问/最近编辑）和创建人（全部/我创建/他人创建）过滤，返回近期文档列表及其节点信息。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws drive +recent",
        "dws drive +recent --operate-type 1 --creator-type 1"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#drive.shortcut_recent",
        "cobra-help:dws drive +recent",
        "ShortcutRegistry:drive +recent"
      ]
    },
    "drive.shortcut_search": {
      "agent_summary": "搜索钉盘文件",
      "use_when": [
        "当你只记得文件名或内容关键词、不知道它在哪个目录时用它全局检索钉盘文件；输入 query，可按文件类型、扩展名、创建者、创建/修改时间范围过滤，返回匹配文件及其 ID，便于再做下载或整理。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws drive +search --query \"季度汇报\"",
        "dws drive +search --query \"合同\" --target file --extensions pdf,docx"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#drive.shortcut_search",
        "cobra-help:dws drive +search",
        "ShortcutRegistry:drive +search"
      ]
    },
    "drive.shortcut_search_docs": {
      "agent_summary": "搜索文档空间文档",
      "use_when": [
        "当你只记得文档标题或关键词、想在文档空间/知识库中检索在线文档（区别于 +search 检索钉盘文件）时使用；输入 query 关键词，返回匹配的文档及其节点信息。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws drive +search-docs --query \"季度汇报\""
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#drive.shortcut_search_docs",
        "cobra-help:dws drive +search-docs",
        "ShortcutRegistry:drive +search-docs"
      ]
    },
    "drive.transfer_owner": {
      "agent_summary": "转交文档或知识库所有者给指定用户（不可逆）",
      "use_when": [
        "用户明确要求转交文档/知识库所有权"
      ],
      "avoid_when": [
        "普通协作权限变更用 permission add/update/remove"
      ],
      "examples": [
        "dws drive permission transfer-owner --node <DOC_ID> --new-owner <userId> --reserve-role EDITOR --recursive=false --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.transfer_owner",
        "cobra-help:dws drive permission transfer-owner",
        "wukong-develop:wukong/products"
      ]
    },
    "drive.unmark_star": {
      "agent_summary": "将文档/文件从当前用户收藏列表移除",
      "use_when": [
        "用户说 取消收藏/去掉收藏/不收藏了"
      ],
      "avoid_when": [
        "添加收藏用 mark_star"
      ],
      "examples": [
        "dws drive star remove --node <nodeId> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工审阅：对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.unmark_star",
        "cobra-help:dws drive star remove",
        "wukong-develop:wukong/products"
      ]
    },
    "drive.upload": {
      "agent_summary": "上传本地文件到钉盘或文档空间，或按节点 ID 确认覆盖已有文件",
      "use_when": [
        "用户要把本地文件上传到钉盘/我的文件（首选一条命令自动完成凭证+PUT+提交）时",
        "用户明确要求只上传或暂存附件、暂时不要发送到任何聊天会话时",
        "用户只要保留原始文件供存储或下载时使用；上传到知识库/文档空间时可加 --workspace",
        "用户明确要求用本地文件替换已有钉盘/文档空间文件时传 --node；该模式会覆盖远端内容并要求确认"
      ],
      "avoid_when": [
        "用户要把文件发送到群聊或单聊时使用 chat message send --msg-type file --file-path；drive upload 不会发送聊天消息",
        "常规场景不要拆成 upload-info + 手动 PUT + commit；仅自定义流式上传才用三步",
        "要把文件作为文档正文附件插入改用 dws doc media insert",
        "Word/Excel/Markdown 要求上传后在线编辑、大家直接在线改或转钉钉文档时改用 dws doc import；普通 drive upload 返回 docx/xlsx 文件不能宣称可在线编辑",
        "用户明确说文档空间且走 doc 兼容入口时可用 dws doc upload，默认仍推荐本命令",
        "用户没有明确同意替换目标文件时不要使用 --node；新建上传应使用 --folder 或目标根目录"
      ],
      "examples": [
        "dws drive upload --file ./report.pdf --format json",
        "dws drive upload --file ./README.md --node <dentryUuid> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工对齐普通文件存储与在线文档导入边界：在线编辑需求硬路由 doc import，drive upload 不承诺转换结果；不改变命令身份、参数契约或接口绑定。",
      "source_refs": [
        "CommandRegistry:canonical_path=drive.upload",
        "cobra-help:dws drive upload",
        "Skill:skills/mono/references/products/drive.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#drive.upload",
        "structured-hint:internal/cli/schema_hints/products/drive.json",
        "live-mcp:none (Cobra+Skill; composite/unpinned)"
      ]
    }
  },
  "products": {
    "drive": {
      "agent_summary": "管理钉盘及文档空间中的文件、目录、上传下载、回收站与公开发布",
      "use_when": [
        "浏览、搜索、上传、下载或整理钉盘和文档空间文件时"
      ],
      "avoid_when": [
        "需要读取或编辑在线文档正文时使用 doc；需要管理知识库空间或成员时使用 wiki"
      ],
      "reviewed": true,
      "review_reason": "依据真实 CommandRegistry 命令分区与对应产品 Skill 审阅产品级选择边界。",
      "source_refs": [
        "CommandRegistry:product=drive",
        "Skill:skills/mono/references/products/drive.md"
      ]
    }
  }
}