{ "product": "drive", "tools": { "drive.add_permission": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.add_permission", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive permission add", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "internal/cli/schema_mcp_metadata.json#tools.drive.add_permission", "live-mcp:dws schema doc.add_permission", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json", "structured-hint:internal/cli/schema_hints/selection-review.json#drive.add_permission" ], "agent_summary": "为文档空间节点添加协作成员并授予指定角色", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "给整个知识库加成员改用 dws wiki member add(「我的文档」不支持容器成员)", "只查已有权限改用 dws drive permission list", "改角色/移除分别用 permission update / remove" ], "canonical_path": "drive.add_permission", "cli_name": "add", "cli_path": "drive permission add", "confirmation": "not_required", "description": "为文档空间节点添加协作成员并授予指定角色。\n\n支持的角色 (--role): MANAGER / EDITOR / DOWNLOADER / READER", "display": "钉盘文件管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws drive permission add --node \u003cID\u003e --users uid1,uid2 --role READER --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "为文档空间节点添加协作成员并授予指定角色" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "为文档空间节点添加协作成员并授予指定角色" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.add_permission.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "给整个知识库加成员改用 dws wiki member add(「我的文档」不支持容器成员)", "只查已有权限改用 dws drive permission list", "改角色/移除分别用 permission update / remove" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "给整个知识库加成员改用 dws wiki member add(「我的文档」不支持容器成员)", "只查已有权限改用 dws drive permission list", "改角色/移除分别用 permission update / remove" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive permission add", "value": "drive.add_permission" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive permission add", "value": "drive.add_permission" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "为文档空间节点添加协作成员并授予指定角色。\n\n支持的角色 (--role): MANAGER / EDITOR / DOWNLOADER / READER" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "为知识库下的节点(文档、文件夹、文件)添加指定角色的企业用户成员(仅支持 USER 类型)。\r\n\r\n通过传入 userIds 列表批量授予企业用户对节点的访问权限,添加成功后即可按指定角色访问该节点及其子节点(若子节点继承权限)。\r\n\r\n注意事项:\r\n- OWNER 角色不可通过此接口添加。\r\n- **权限要求(业务规则)**:操作者必须在该节点上具备「可编辑(EDITOR)」及以上角色(OWNER / MANAGER / EDITOR)。\r\n- 单次请求 `userIds` 列表最多传 30 个,超出需分批调用。\r\n- 入参直接采用扁平的 `userIds: List\u003cString\u003e`,每个元素为钉钉 staffId(外部 userId 格式,由钉钉开放平台体系下颁发)。如果你只有 unionId,请先调用钉钉开放平台「根据 unionId 获取 userId」接口换取。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "为文档空间节点添加协作成员并授予指定角色。\n\n支持的角色 (--role): MANAGER / EDITOR / DOWNLOADER / READER" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive permission add --node \u003cID\u003e --users uid1,uid2 --role READER --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive permission add --node \u003cID\u003e --users uid1,uid2 --role READER --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.add_permission.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": { "product_id": "doc", "rpc_name": "add_permission" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.add_permission.interface_ref", "value": "doc.add_permission" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": { "product_id": "doc", "rpc_name": "add_permission" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "添加协作者" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "添加节点成员" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "添加协作者" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "给单篇文档/文件夹/文件做节点级授权(USER + 角色 MANAGER/EDITOR/DOWNLOADER/READER)时", "用户说把某篇文档分享给某人看/可编辑时(含「我的文档」下的节点)" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "给单篇文档/文件夹/文件做节点级授权(USER + 角色 MANAGER/EDITOR/DOWNLOADER/READER)时", "用户说把某篇文档分享给某人看/可编辑时(含「我的文档」下的节点)" ] } }, "group": "permission", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "add_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_permission", "parameter_count": 4, "parameters": { "node": { "description": "目标节点 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标节点 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标节点的 nodeId(文档、文件夹或文件),可通过 list_nodes 工具获取。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标节点 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标节点的 nodeId(文档、文件夹或文件),可通过 list_nodes 工具获取。", "property": "nodeId", "required": true, "type": "string" }, "role": { "description": "角色: MANAGER / EDITOR / DOWNLOADER / READER (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "角色: MANAGER / EDITOR / DOWNLOADER / READER (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "授予成员的角色,取值:MANAGER、EDITOR、DOWNLOADER、READER。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "角色: MANAGER / EDITOR / DOWNLOADER / READER (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "roleId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "role" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "roleId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "授予成员的角色,取值:MANAGER、EDITOR、DOWNLOADER、READER。", "property": "roleId", "required": true, "type": "string" }, "users": { "description": "用户 userId 列表,逗号分隔 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户 userId 列表,逗号分隔 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "被授权的用户 userId 列表(钉钉 staffId / 外部 userId 格式,由钉钉开放平台体系下颁发;通常为数字字符串),至少包含一个 userId,单次最多 30 个。如果你只有 unionId,请先调用钉钉开放平台「根据 unionId 获取 userId」接口换取 userId。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户 userId 列表,逗号分隔 (必填)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "userIds" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "users" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "userIds" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "被授权的用户 userId 列表(钉钉 staffId / 外部 userId 格式,由钉钉开放平台体系下颁发;通常为数字字符串),至少包含一个 userId,单次最多 30 个。如果你只有 unionId,请先调用钉钉开放平台「根据 unionId 获取 userId」接口换取 userId。", "interface_type": "array", "property": "userIds", "required": true, "type": "string" }, "workspace": { "description": "知识库 ID (选填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "知识库 ID (选填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标知识库的标识,选填。仅用于辅助构造返回的 docUrl,业务实际依赖 nodeId 定位节点;支持两种格式:1) 知识库 ID(纯字符串);2) 知识库 URL,如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview,系统自动提取其中的 workspaceId。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "知识库 ID (选填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "workspaceId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "workspaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标知识库的标识,选填。仅用于辅助构造返回的 docUrl,业务实际依赖 nodeId 定位节点;支持两种格式:1) 知识库 ID(纯字符串);2) 知识库 URL,如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview,系统自动提取其中的 workspaceId。", "property": "workspaceId", "required": false, "type": "string" } }, "path": "drive.add_permission", "primary_cli_path": "drive permission add", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "添加协作者", "use_when": [ "给单篇文档/文件夹/文件做节点级授权(USER + 角色 MANAGER/EDITOR/DOWNLOADER/READER)时", "用户说把某篇文档分享给某人看/可编辑时(含「我的文档」下的节点)" ] }, "drive.apply_permission": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.apply_permission", "cobra-help:dws drive permission apply", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "wukong-develop:wukong/products" ], "agent_summary": "向审批人发起文档权限申请(会真实通知审批人)", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "先用 apply-info 查可申请角色与审批人;未经用户确认不得自行提交" ], "canonical_path": "drive.apply_permission", "cli_name": "apply", "cli_path": "drive permission apply", "confirmation": "user_required", "description": "向指定节点的审批人发起权限申请。建议先用 apply-info 获取可申请角色与审批人。\n\n注意: 本命令会真实通知审批人,Agent 必须先获得用户明确同意后再执行。", "display": "钉盘文件管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws drive permission apply --node \u003cDOC_ID\u003e --role READER --users \u003c审批人userId\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "向审批人发起文档权限申请(会真实通知审批人)" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "向审批人发起文档权限申请(会真实通知审批人)" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "先用 apply-info 查可申请角色与审批人;未经用户确认不得自行提交" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "先用 apply-info 查可申请角色与审批人;未经用户确认不得自行提交" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive permission apply", "value": "drive.apply_permission" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive permission apply", "value": "drive.apply_permission" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "user_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "user_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "向指定节点的审批人发起权限申请。建议先用 apply-info 获取可申请角色与审批人。\n\n注意: 本命令会真实通知审批人,Agent 必须先获得用户明确同意后再执行。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "向指定节点的审批人发起权限申请。建议先用 apply-info 获取可申请角色与审批人。\n\n注意: 本命令会真实通知审批人,Agent 必须先获得用户明确同意后再执行。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive permission apply --node \u003cDOC_ID\u003e --role READER --users \u003c审批人userId\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive permission apply --node \u003cDOC_ID\u003e --role READER --users \u003c审批人userId\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "non_idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "non_idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "发起权限申请" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "发起权限申请" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户确认要为无权限文档发起权限申请" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户确认要为无权限文档发起权限申请" ] } }, "group": "permission", "has_parameters": true, "idempotency": "non_idempotent", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "apply_permission", "parameter_count": 5, "parameters": { "node": { "description": "目标节点 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标节点 ID 或 URL (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标节点 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.apply_permission has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.apply_permission has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" }, "notify-mode": { "description": "通知方式: DEFAULT / MSG_ACCOUNT / SINGLE_CHAT", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "通知方式: DEFAULT / MSG_ACCOUNT / SINGLE_CHAT" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "通知方式: DEFAULT / MSG_ACCOUNT / SINGLE_CHAT" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.apply_permission has no singular pinned interface_ref; --notify-mode is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "notifyMode" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.apply_permission has no singular pinned interface_ref; --notify-mode is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "reason": { "description": "申请理由,最长 200 字符", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "申请理由,最长 200 字符" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "申请理由,最长 200 字符" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.apply_permission has no singular pinned interface_ref; --reason is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "reason" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.apply_permission has no singular pinned interface_ref; --reason is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "role": { "description": "申请的角色: EDITOR / DOWNLOADER / READER (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "申请的角色: EDITOR / DOWNLOADER / READER (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "申请的角色: EDITOR / DOWNLOADER / READER (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.apply_permission has no singular pinned interface_ref; --role is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "role" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.apply_permission has no singular pinned interface_ref; --role is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" }, "users": { "description": "审批人 userId 列表,逗号分隔 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "审批人 userId 列表,逗号分隔 (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "审批人 userId 列表,逗号分隔 (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.apply_permission has no singular pinned interface_ref; --users is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "users" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.apply_permission has no singular pinned interface_ref; --users is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" } }, "path": "drive.apply_permission", "primary_cli_path": "drive permission apply", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "发起权限申请", "use_when": [ "用户确认要为无权限文档发起权限申请" ] }, "drive.commit_upload": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.commit_upload", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive commit", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.commit_upload", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "internal/cli/schema_mcp_metadata.json#tools.drive.commit_upload", "live-mcp:dws schema drive.commit_upload", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/imported/wukong.json#drive.commit_upload", "structured-hint:internal/cli/schema_hints/products/drive.json", "structured-hint:internal/cli/schema_hints/selection-review.json#drive.commit_upload" ], "agent_summary": "提交文件上传", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "普通上传请用 dws drive upload", "尚未 PUT 成功或 uploadId 过期时不要 commit;需重新 upload-info" ], "canonical_path": "drive.commit_upload", "cli_name": "commit", "cli_path": "drive commit", "confirmation": "not_required", "description": "提交文件上传", "display": "钉盘文件管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws drive commit --file-name \"report.pdf\" --file-size 102400 --upload-id \u003cUPLOAD_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "提交文件上传" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "提交文件上传" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.commit_upload.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "普通上传请用 dws drive upload", "尚未 PUT 成功或 uploadId 过期时不要 commit;需重新 upload-info" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "普通上传请用 dws drive upload", "尚未 PUT 成功或 uploadId 过期时不要 commit;需重新 upload-info" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive commit", "value": "drive.commit_upload" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive commit", "value": "drive.commit_upload" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "提交文件上传" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "文件上传流程:\r\nStep 1:调用 get_upload_info 获取预签名的 OSS 上传 URL\r\nStep 2:使用 Step 1 返回的 URL 将文件 PUT 到 OSS\r\nStep 3:调用本接口提交文件,传入Step 1返回的 uploadId 与对应的 fileName、fileSize 完成文件上传" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "提交文件上传" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive commit --file-name \"report.pdf\" --file-size 102400 --upload-id \u003cUPLOAD_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive commit --file-name \"report.pdf\" --file-size 102400 --upload-id \u003cUPLOAD_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.commit_upload.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "drive", "rpc_name": "commit_upload" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.commit_upload.interface_ref", "value": "drive.commit_upload" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "drive", "rpc_name": "commit_upload" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "提交文件上传" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "commit_upload" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "提交文件上传" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "手动三步上传的最后一步:已 PUT 到 OSS,用 upload-info 返回的 uploadId 提交入库时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "手动三步上传的最后一步:已 PUT 到 OSS,用 upload-info 返回的 uploadId 提交入库时" ] } }, "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "commit_upload" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "commit_upload", "parameter_count": 5, "parameters": { "file-name": { "description": "文件名(含扩展名),须与 get_upload_info 时一致 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件名(含扩展名),须与 get_upload_info 时一致 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "文件名(含扩展名),须与 get_upload_info 时传入的 fileName 一致" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件名(含扩展名),须与 get_upload_info 时一致 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "fileName" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "fileName" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "文件名(含扩展名),须与 get_upload_info 时传入的 fileName 一致", "property": "fileName", "required": true, "type": "string" }, "file-size": { "cli_required": true, "description": "文件大小(字节),须与 get_upload_info 时一致 (必填)", "field_provenance": { "cli_required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_hard_required", "value": true } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_hard_required", "value": true }, "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件大小(字节),须与 get_upload_info 时一致 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "文件大小(字节),须与 get_upload_info 时传入的 fileSize 一致,用于完整性校验" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件大小(字节),须与 get_upload_info 时一致 (必填)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "fileSize" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "fileSize" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_hard_required", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_hard_required", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "文件大小(字节),须与 get_upload_info 时传入的 fileSize 一致,用于完整性校验", "interface_type": "number", "property": "fileSize", "required": true, "type": "integer" }, "folder": { "description": "父节点 ID (dentryUuid),不传则提交到根目录 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "父节点 ID (dentryUuid),不传则提交到根目录 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "父节点 ID(dentryUuid 格式)。不传则提交到空间根目录。须与 get_upload_info 时传入的 parentId 一致" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "父节点 ID (dentryUuid),不传则提交到根目录 (可选)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "parentId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "folder" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "parentId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "父节点 ID(dentryUuid 格式)。不传则提交到空间根目录。须与 get_upload_info 时传入的 parentId 一致", "property": "parentId", "required": false, "type": "string" }, "space-id": { "description": "空间 ID,不传则使用「我的文件」 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "空间 ID,不传则使用「我的文件」 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标空间 ID。不传时后端自动使用当前用户「我的文件」对应的 spaceId" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "空间 ID,不传则使用「我的文件」 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "spaceId" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "spaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标空间 ID。不传时后端自动使用当前用户「我的文件」对应的 spaceId", "property": "spaceId", "required": false, "type": "string" }, "upload-id": { "description": "上传 ID,来自 get_upload_info 返回的 uploadId (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "上传 ID,来自 get_upload_info 返回的 uploadId (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "上传 ID,来自 get_upload_info 返回的 uploadId" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "上传 ID,来自 get_upload_info 返回的 uploadId (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "uploadId" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "uploadId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "上传 ID,来自 get_upload_info 返回的 uploadId", "property": "uploadId", "required": true, "type": "string" } }, "path": "drive.commit_upload", "primary_cli_path": "drive commit", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "提交文件上传", "use_when": [ "手动三步上传的最后一步:已 PUT 到 OSS,用 upload-info 返回的 uploadId 提交入库时" ] }, "drive.copy_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.copy_document", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive copy", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "internal/cli/schema_mcp_metadata.json#tools.drive.copy_document", "live-mcp:dws schema doc.copy_document", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json", "structured-hint:internal/cli/schema_hints/selection-review.json#drive.copy_document" ], "agent_summary": "将文件或文档复制到目标文件夹或知识库(保留原位置;默认「我的文档」)", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "用户意图是搬走/迁移且原位置不再保留时改用 dws drive move(move 需更高源权限)", "只要快捷方式入口、不要独立副本时改用 dws drive shortcut", "已在明确知识库上下文内复制节点且需带 --workspace/--node 的 wiki 入口时可用 dws wiki node copy;跨产品默认用本命令", "目标文件夹或知识库尚未确认时不要复制" ], "canonical_path": "drive.copy_document", "cli_name": "copy", "cli_path": "drive copy", "confirmation": "not_required", "description": "将文档空间中的文档或文件复制到指定文件夹或知识库。\n--folder 指定目标文件夹 nodeId,--workspace 指定目标知识库 ID。\n不传 --folder 时复制到 --workspace 根目录;都不传则默认到\"我的文档\"。\n\n权限要求: 对源文档有\"阅读\"权限,且对目标文件夹有\"编辑\"权限。", "display": "钉盘文件管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws drive copy --node \u003c源dentryUuid\u003e --folder \u003c目标文件夹fileId\u003e --format json", "dws drive copy --node \u003c源dentryUuid\u003e --workspace \u003cTARGET_WS_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "将文件或文档复制到目标文件夹或知识库(保留原位置;默认「我的文档」)" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "将文件或文档复制到目标文件夹或知识库(保留原位置;默认「我的文档」)" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.copy_document.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户意图是搬走/迁移且原位置不再保留时改用 dws drive move(move 需更高源权限)", "只要快捷方式入口、不要独立副本时改用 dws drive shortcut", "已在明确知识库上下文内复制节点且需带 --workspace/--node 的 wiki 入口时可用 dws wiki node copy;跨产品默认用本命令", "目标文件夹或知识库尚未确认时不要复制" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户意图是搬走/迁移且原位置不再保留时改用 dws drive move(move 需更高源权限)", "只要快捷方式入口、不要独立副本时改用 dws drive shortcut", "已在明确知识库上下文内复制节点且需带 --workspace/--node 的 wiki 入口时可用 dws wiki node copy;跨产品默认用本命令", "目标文件夹或知识库尚未确认时不要复制" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive copy", "value": "drive.copy_document" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive copy", "value": "drive.copy_document" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "将文档空间中的文档或文件复制到指定文件夹或知识库。\n--folder 指定目标文件夹 nodeId,--workspace 指定目标知识库 ID。\n不传 --folder 时复制到 --workspace 根目录;都不传则默认到\"我的文档\"。\n\n权限要求: 对源文档有\"阅读\"权限,且对目标文件夹有\"编辑\"权限。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "将指定节点复制到目标文件夹。\r\n\r\n支持的节点类型:知识库节点(文档、文件夹)、钉盘文件/文件夹。\r\nnodeId 支持文档 URL 或 dentryUuid(32 位字母数字字符串)。\r\ntargetFolderId 为目标文件夹的 dentryUuid;workspaceId 为目标知识库标识,不传 targetFolderId 时复制到该知识库根目录,如果不传 targetFolderId 和 workspaceId,默认到当前用户所在组织的「我的文档」下\r\n\r\n权限要求:\r\n- 对源节点有可查看下载权限\r\n- 对目标文件夹有写入权限\r\n\r\n注意:复制操作底层可能异步执行,异步时操作已提交但新节点 ID 无法立即返回,请稍后查看目标文件夹确认结果。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "将文档空间中的文档或文件复制到指定文件夹或知识库。\n--folder 指定目标文件夹 nodeId,--workspace 指定目标知识库 ID。\n不传 --folder 时复制到 --workspace 根目录;都不传则默认到\"我的文档\"。\n\n权限要求: 对源文档有\"阅读\"权限,且对目标文件夹有\"编辑\"权限。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive copy --node \u003c源dentryUuid\u003e --folder \u003c目标文件夹fileId\u003e --format json", "dws drive copy --node \u003c源dentryUuid\u003e --workspace \u003cTARGET_WS_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive copy --node \u003c源dentryUuid\u003e --folder \u003c目标文件夹fileId\u003e --format json", "dws drive copy --node \u003c源dentryUuid\u003e --workspace \u003cTARGET_WS_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.copy_document.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": { "product_id": "doc", "rpc_name": "copy_document" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.copy_document.interface_ref", "value": "doc.copy_document" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": { "product_id": "doc", "rpc_name": "copy_document" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "复制文件/文档到指定位置" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "将指定节点复制到目标文件夹" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "复制文件/文档到指定位置" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要复制/拷贝一份文件或文档到新位置,且原位置仍需保留副本时(copy≠move)", "目标是指定文件夹:传 --folder \u003c目标文件夹 dentryUuid/fileId\u003e", "目标是知识库根目录:只传 --workspace \u003cworkspaceId 或知识库 URL\u003e,不传 --folder", "用户未指定目标时:默认落到当前组织「我的文档」;若需钉盘「我的文件」根目录,先 wiki space list --type mySpace 取 rootFolderId 再 --folder", "跨钉盘 space 复制到子文件夹:先 list 取目标文件夹 fileId,再 --folder 传入" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要复制/拷贝一份文件或文档到新位置,且原位置仍需保留副本时(copy≠move)", "目标是指定文件夹:传 --folder \u003c目标文件夹 dentryUuid/fileId\u003e", "目标是知识库根目录:只传 --workspace \u003cworkspaceId 或知识库 URL\u003e,不传 --folder", "用户未指定目标时:默认落到当前组织「我的文档」;若需钉盘「我的文件」根目录,先 wiki space list --type mySpace 取 rootFolderId 再 --folder", "跨钉盘 space 复制到子文件夹:先 list 取目标文件夹 fileId,再 --folder 传入" ] } }, "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "copy_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "copy_document", "parameter_count": 3, "parameters": { "folder": { "description": "目标文件夹 nodeId", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文件夹 nodeId" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文件夹的 dentryUuid(32 位字母数字字符串),复制后的节点将放置在此文件夹下。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文件夹 nodeId" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "targetFolderId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "folder" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "targetFolderId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文件夹的 dentryUuid(32 位字母数字字符串),复制后的节点将放置在此文件夹下。", "property": "targetFolderId", "required": false, "type": "string" }, "node": { "description": "文档/文件 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档/文件 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要复制的节点标识,支持以下格式:\\n1. 文档/文件夹 URL,如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}\\n2. dentryUuid(32 位字母数字字符串)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档/文件 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要复制的节点标识,支持以下格式:\\n1. 文档/文件夹 URL,如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}\\n2. dentryUuid(32 位字母数字字符串)", "property": "nodeId", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标知识库 ID" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标知识库的标识,支持两种格式:1) 知识库 ID(纯字符串);2) 知识库 URL,如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview,系统自动提取其中的 workspaceId。当 targetFolderId 不传时,复制到该知识库的根目录下。与 targetFolderId 至少传一个。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标知识库 ID" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "workspaceId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "workspaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标知识库的标识,支持两种格式:1) 知识库 ID(纯字符串);2) 知识库 URL,如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview,系统自动提取其中的 workspaceId。当 targetFolderId 不传时,复制到该知识库的根目录下。与 targetFolderId 至少传一个。", "property": "workspaceId", "required": false, "type": "string" } }, "path": "drive.copy_document", "primary_cli_path": "drive copy", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "复制文件/文档到指定位置", "use_when": [ "用户要复制/拷贝一份文件或文档到新位置,且原位置仍需保留副本时(copy≠move)", "目标是指定文件夹:传 --folder \u003c目标文件夹 dentryUuid/fileId\u003e", "目标是知识库根目录:只传 --workspace \u003cworkspaceId 或知识库 URL\u003e,不传 --folder", "用户未指定目标时:默认落到当前组织「我的文档」;若需钉盘「我的文件」根目录,先 wiki space list --type mySpace 取 rootFolderId 再 --folder", "跨钉盘 space 复制到子文件夹:先 list 取目标文件夹 fileId,再 --folder 传入" ] }, "drive.create_folder": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.create_folder", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive mkdir", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.create_folder", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "internal/cli/schema_mcp_metadata.json#tools.drive.create_folder", "live-mcp:dws schema drive.create_folder", "skills/mono/references/products/doc.md", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/imported/wukong.json#drive.create_folder", "structured-hint:internal/cli/schema_hints/products/drive.json", "structured-hint:internal/cli/schema_hints/selection-review.json#drive.create_folder" ], "agent_summary": "创建文件夹", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "要在知识库内建文件夹改用 dws wiki node create --type folder --workspace \u003cid\u003e", "要创建在线文档(adoc)改用 dws doc create 或 wiki node create --type adoc" ], "canonical_path": "drive.create_folder", "cli_name": "mkdir", "cli_path": "drive mkdir", "confirmation": "not_required", "description": "创建文件夹", "display": "钉盘文件管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws drive mkdir --name \"项目资料\" --format json", "dws drive mkdir --name \"子目录\" --folder \u003cdentryUuid\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "创建文件夹" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "创建文件夹" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.create_folder.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要在知识库内建文件夹改用 dws wiki node create --type folder --workspace \u003cid\u003e", "要创建在线文档(adoc)改用 dws doc create 或 wiki node create --type adoc" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要在知识库内建文件夹改用 dws wiki node create --type folder --workspace \u003cid\u003e", "要创建在线文档(adoc)改用 dws doc create 或 wiki node create --type adoc" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive mkdir", "value": "drive.create_folder" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive mkdir", "value": "drive.create_folder" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "创建文件夹" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "在钉盘中创建一个新文件夹\r\n最简用法:只传 name,文件夹会创建在当前用户「我的文件」的根目录下。\r\n如果想创建在某个子文件夹里,传 parentId(从 list_files 或 create_folder 的返回值中获取)。\r\n创建成功后返回 fileId,可直接用于后续操作(如在该文件夹下继续创建子文件夹或上传文件)。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "创建文件夹" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive mkdir --name \"项目资料\" --format json", "dws drive mkdir --name \"子目录\" --folder \u003cdentryUuid\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive mkdir --name \"项目资料\" --format json", "dws drive mkdir --name \"子目录\" --folder \u003cdentryUuid\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.create_folder.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "drive", "rpc_name": "create_folder" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.create_folder.interface_ref", "value": "drive.create_folder" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "drive", "rpc_name": "create_folder" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "创建文件夹" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建文件夹" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "创建文件夹" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要在钉盘/「我的文件」下新建普通文件夹时", "已知父目录 dentryUuid,要在其下建子目录时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要在钉盘/「我的文件」下新建普通文件夹时", "已知父目录 dentryUuid,要在其下建子目录时" ] } }, "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "create_folder" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_folder", "parameter_count": 3, "parameters": { "folder": { "description": "父节点 ID (dentryUuid),不传则在空间根目录下创建 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "父节点 ID (dentryUuid),不传则在空间根目录下创建 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "父节点 ID(dentryUuid 格式)。不传则在空间根目录下创建" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "父节点 ID (dentryUuid),不传则在空间根目录下创建 (可选)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "parentId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "folder" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "parentId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "父节点 ID(dentryUuid 格式)。不传则在空间根目录下创建", "property": "parentId", "required": false, "type": "string" }, "name": { "description": "文件夹名称,最长 50 字符 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件夹名称,最长 50 字符 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "文件夹名称,最长 50 个字符" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件夹名称,最长 50 字符 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "name" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "name" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "文件夹名称,最长 50 个字符", "property": "name", "required": true, "type": "string" }, "space-id": { "description": "目标空间 ID,不传则使用「我的文件」 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标空间 ID,不传则使用「我的文件」 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "空间 ID。绝大多数情况下不需要传,后端自动使用当前用户默认空间 spaceId" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标空间 ID,不传则使用「我的文件」 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "spaceId" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "spaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "空间 ID。绝大多数情况下不需要传,后端自动使用当前用户默认空间 spaceId", "property": "spaceId", "required": false, "type": "string" } }, "path": "drive.create_folder", "primary_cli_path": "drive mkdir", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "创建文件夹", "use_when": [ "用户要在钉盘/「我的文件」下新建普通文件夹时", "已知父目录 dentryUuid,要在其下建子目录时" ] }, "drive.create_shortcut": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws drive shortcut --help", "internal/cli/schema_command_registry.json#drive.create_shortcut", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "live-mcp:none (Cobra+Skill; composite/unpinned)", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json" ], "agent_summary": "为钉盘或文档空间中的现有节点创建快捷方式。", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "要复制一份独立副本改用 dws drive copy(copy≠shortcut)", "要移动原文件改用 dws drive move" ], "canonical_path": "drive.create_shortcut", "cli_name": "shortcut", "cli_path": "drive shortcut", "confirmation": "not_required", "description": "为指定源节点创建快捷方式,并放置到目标文件夹或知识库。\n\n通过 --node 指定源节点。--folder 和 --workspace 均为可选;都不传时由服务端选择默认位置。\n若同时指定,--folder 是目标文件夹,--workspace 用于指定其所属知识库。", "display": "钉盘文件管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws drive shortcut --node \u003cSOURCE_NODE\u003e --format json", "dws drive shortcut --node \u003cSOURCE_NODE\u003e --folder \u003cTARGET_FOLDER\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "为钉盘或文档空间中的现有节点创建快捷方式。" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "为钉盘或文档空间中的现有节点创建快捷方式。" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要复制一份独立副本改用 dws drive copy(copy≠shortcut)", "要移动原文件改用 dws drive move" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要复制一份独立副本改用 dws drive copy(copy≠shortcut)", "要移动原文件改用 dws drive move" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive shortcut", "value": "drive.create_shortcut" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive shortcut", "value": "drive.create_shortcut" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "为指定源节点创建快捷方式,并放置到目标文件夹或知识库。\n\n通过 --node 指定源节点。--folder 和 --workspace 均为可选;都不传时由服务端选择默认位置。\n若同时指定,--folder 是目标文件夹,--workspace 用于指定其所属知识库。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "为指定源节点创建快捷方式,并放置到目标文件夹或知识库。\n\n通过 --node 指定源节点。--folder 和 --workspace 均为可选;都不传时由服务端选择默认位置。\n若同时指定,--folder 是目标文件夹,--workspace 用于指定其所属知识库。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive shortcut --node \u003cSOURCE_NODE\u003e --format json", "dws drive shortcut --node \u003cSOURCE_NODE\u003e --folder \u003cTARGET_FOLDER\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive shortcut --node \u003cSOURCE_NODE\u003e --format json", "dws drive shortcut --node \u003cSOURCE_NODE\u003e --folder \u003cTARGET_FOLDER\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "non_idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "non_idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "为节点创建快捷方式" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "为节点创建快捷方式" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要给已有节点建快捷方式/软链接到目标文件夹或知识库时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要给已有节点建快捷方式/软链接到目标文件夹或知识库时" ] } }, "has_parameters": true, "idempotency": "non_idempotent", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "create_shortcut", "parameter_count": 3, "parameters": { "folder": { "description": "目标文件夹 nodeId (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文件夹 nodeId (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文件夹 nodeId (可选)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "targetFolderId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "folder" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "targetFolderId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "targetFolderId", "required": false, "type": "string" }, "node": { "description": "源节点 ID 或文档 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "源节点 ID 或文档 URL (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "源节点 ID 或文档 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "nodeId", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标知识库 ID (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标知识库 ID (可选)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "workspaceId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "workspaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "workspaceId", "required": false, "type": "string" } }, "path": "drive.create_shortcut", "primary_cli_path": "drive shortcut", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "为节点创建快捷方式", "use_when": [ "用户要给已有节点建快捷方式/软链接到目标文件夹或知识库时" ] }, "drive.delete_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.delete_document", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive delete", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "internal/cli/schema_mcp_metadata.json#tools.drive.delete_document", "live-mcp:dws schema doc.delete_document", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json", "structured-hint:internal/cli/schema_hints/selection-review.json#drive.delete_document" ], "agent_summary": "将钉盘中的文件或文件夹移入回收站", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "用户未确认删除目标或只是想移走位置时不要删;搬迁用 dws drive move", "要删整个知识库改用 dws wiki space delete", "要永久删评论改用 dws doc comment delete" ], "canonical_path": "drive.delete_document", "cli_name": "delete", "cli_path": "drive delete", "confirmation": "user_required", "description": "将钉盘中的文件或文件夹移入回收站。\n\n注意: 这是一个危险操作,文件将被移入回收站。执行前需要确认,或传入 --yes 跳过确认。\n--node 对应 drive list 返回的 fileId 字段(即 dentryUuid)。\n\n权限要求: 对文档有\"管理\"权限。", "display": "钉盘文件管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws drive delete --node \u003cdentryUuid\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "将钉盘中的文件或文件夹移入回收站" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "将钉盘中的文件或文件夹移入回收站" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.delete_document.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户未确认删除目标或只是想移走位置时不要删;搬迁用 dws drive move", "要删整个知识库改用 dws wiki space delete", "要永久删评论改用 dws doc comment delete" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户未确认删除目标或只是想移走位置时不要删;搬迁用 dws drive move", "要删整个知识库改用 dws wiki space delete", "要永久删评论改用 dws doc comment delete" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive delete", "value": "drive.delete_document" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive delete", "value": "drive.delete_document" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "user_required" }, { "precedence": "inference_or_default", "selected": false, "source": "risk-default", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "user_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "将钉盘中的文件或文件夹移入回收站。\n\n注意: 这是一个危险操作,文件将被移入回收站。执行前需要确认,或传入 --yes 跳过确认。\n--node 对应 drive list 返回的 fileId 字段(即 dentryUuid)。\n\n权限要求: 对文档有\"管理\"权限。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "将指定节点移入回收站,30 天内可从回收站恢复,超过 30 天将被永久删除。\r\n\r\n支持范围:\r\n- 知识库(workspace)下的文档节点、文件夹节点\r\n- 钉盘「我的文件」或「团队空间(space)」下的文件、文件夹节点(但钉盘操作仍建议走钉盘MCP服务)\r\n\r\n不支持的操作:\r\n- 不支持直接删除知识库本身(workspace)\r\n- 不支持直接删除团队空间(space)\r\n\r\n权限要求:\r\n- 对目标节点有管理权限(owner 或被授予管理权限的成员)\r\n\r\n注意事项:\r\n- 删除操作不可立即撤销,请在调用前向用户确认\r\n- 删除文件夹时,文件夹内的所有子节点也会一并移入回收站" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "将钉盘中的文件或文件夹移入回收站。\n\n注意: 这是一个危险操作,文件将被移入回收站。执行前需要确认,或传入 --yes 跳过确认。\n--node 对应 drive list 返回的 fileId 字段(即 dentryUuid)。\n\n权限要求: 对文档有\"管理\"权限。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "destructive" }, { "precedence": "inference_or_default", "selected": false, "source": "command-verb", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "destructive" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive delete --node \u003cdentryUuid\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive delete --node \u003cdentryUuid\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.delete_document.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": { "product_id": "doc", "rpc_name": "delete_document" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.delete_document.interface_ref", "value": "doc.delete_document" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": { "product_id": "doc", "rpc_name": "delete_document" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "high" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "high" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "删除文件/文件夹到回收站" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "删除节点" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "删除文件/文件夹到回收站" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户明确要求把钉盘/文档空间中的文件或文件夹移入回收站,且已确认目标节点时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户明确要求把钉盘/文档空间中的文件或文件夹移入回收站,且已确认目标节点时" ] } }, "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "delete_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_document", "parameter_count": 1, "parameters": { "node": { "description": "文件/文件夹 ID (dentryUuid),即 drive list 返回的 fileId (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件/文件夹 ID (dentryUuid),即 drive list 返回的 fileId (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要删除的节点标识,支持以下格式:1) 文档/文件夹 URL,如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid};2) dentryUuid(32 位字母数字字符串)。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件/文件夹 ID (dentryUuid),即 drive list 返回的 fileId (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要删除的节点标识,支持以下格式:1) 文档/文件夹 URL,如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid};2) dentryUuid(32 位字母数字字符串)。", "property": "nodeId", "required": true, "type": "string" } }, "path": "drive.delete_document", "primary_cli_path": "drive delete", "product_id": "drive", "reviewed": true, "risk": "high", "source": "reviewed_command_registry", "title": "删除文件/文件夹到回收站", "use_when": [ "用户明确要求把钉盘/文档空间中的文件或文件夹移入回收站,且已确认目标节点时" ] }, "drive.download_file": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.download_file", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive download", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.download_file", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "internal/cli/schema_mcp_metadata.json#tools.drive.download_file", "live-mcp:dws schema drive.download_file", "skills/mono/references/intent-guide.md", "skills/mono/references/products/doc.md", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/imported/wukong.json#drive.download_file", "structured-hint:internal/cli/schema_hints/products/drive.json", "structured-hint:internal/cli/schema_hints/selection-review.json#drive.download_file" ], "agent_summary": "下载钉盘或文档空间文件到本地", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "在线文档(adoc)要导出为 Word/docx 改用 dws doc export,不要用 download 代替导出", "只要临时下载链接语义且走文档附件块时用 dws doc media download", "未指定 --output 不要调用(CLI 必填)" ], "canonical_path": "drive.download_file", "cli_name": "download", "cli_path": "drive download", "confirmation": "not_required", "description": "下载钉盘中的文件到本地(两步下载流程)。\n\n流程:\n 1. 获取下载 URL 和签名请求头 (download_file)\n 2. HTTP GET 下载文件二进制内容到本地\n\n--output 指定本地保存路径,可以是文件路径或目录。\n如果指定目录,文件名从下载 URL 中自动推断。", "display": "钉盘文件管理", "dry_run": { "preview_kind": "plan" }, "effect": "read", "effect_source": "command-verb", "examples": [ "dws drive download --node \u003cdentryUuid\u003e --output ./report.pdf --format json", "dws drive download --node \u003cdentryUuid\u003e --output ~/downloads/ --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "下载钉盘或文档空间文件到本地" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "下载钉盘或文档空间文件到本地" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.download_file.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "在线文档(adoc)要导出为 Word/docx 改用 dws doc export,不要用 download 代替导出", "只要临时下载链接语义且走文档附件块时用 dws doc media download", "未指定 --output 不要调用(CLI 必填)" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "在线文档(adoc)要导出为 Word/docx 改用 dws doc export,不要用 download 代替导出", "只要临时下载链接语义且走文档附件块时用 dws doc media download", "未指定 --output 不要调用(CLI 必填)" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive download", "value": "drive.download_file" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive download", "value": "drive.download_file" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "下载钉盘中的文件到本地(两步下载流程)。\n\n流程:\n 1. 获取下载 URL 和签名请求头 (download_file)\n 2. HTTP GET 下载文件二进制内容到本地\n\n--output 指定本地保存路径,可以是文件路径或目录。\n如果指定目录,文件名从下载 URL 中自动推断。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "获取钉盘普通文件的下载链接。调用钉盘文件下载接口,返回 OSS 预签名下载链接,链接有效期 15 分钟" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "下载钉盘中的文件到本地(两步下载流程)。\n\n流程:\n 1. 获取下载 URL 和签名请求头 (download_file)\n 2. HTTP GET 下载文件二进制内容到本地\n\n--output 指定本地保存路径,可以是文件路径或目录。\n如果指定目录,文件名从下载 URL 中自动推断。" }, "dry_run": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "reviewed positive dry-run capability", "selected": true, "source": "reviewed_dry_run_registry", "source_ref": "internal/cli/schema_dry_run_capabilities.go", "value": { "preview_kind": "plan" } } ], "precedence": "reviewed_explicit", "resolution": "exact_canonical_lookup", "review_reason": "reviewed positive dry-run capability", "source": "reviewed_dry_run_registry", "source_ref": "internal/cli/schema_dry_run_capabilities.go", "value": { "preview_kind": "plan" } }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive download --node \u003cdentryUuid\u003e --output ./report.pdf --format json", "dws drive download --node \u003cdentryUuid\u003e --output ~/downloads/ --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive download --node \u003cdentryUuid\u003e --output ./report.pdf --format json", "dws drive download --node \u003cdentryUuid\u003e --output ~/downloads/ --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.download_file.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "drive", "rpc_name": "download_file" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.download_file.interface_ref", "value": "drive.download_file" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "drive", "rpc_name": "download_file" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "下载钉盘文件到本地" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "下载文件" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "下载钉盘文件到本地" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要把钉盘普通文件(PDF/图片/Office 等非在线文档)下载到本地路径时", "已确认 contentType 非 ALIDOC,需要落盘本地查看时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要把钉盘普通文件(PDF/图片/Office 等非在线文档)下载到本地路径时", "已确认 contentType 非 ALIDOC,需要落盘本地查看时" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "download_file" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "download_file", "parameter_count": 3, "parameters": { "node": { "description": "文件 ID (dentryUuid) (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件 ID (dentryUuid) (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "文件 ID(dentryUuid 格式)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件 ID (dentryUuid) (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "fileId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "fileId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "文件 ID(dentryUuid 格式)", "property": "fileId", "required": true, "type": "string" }, "output": { "description": "本地保存路径 (文件路径或目录,必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "本地保存路径 (文件路径或目录,必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "本地保存路径 (文件路径或目录,必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "local output path", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "output" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "local output path", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" }, "space-id": { "description": "文件所属空间 ID (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件所属空间 ID (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "文件所属空间 ID" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件所属空间 ID (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "spaceId" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "spaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "文件所属空间 ID", "property": "spaceId", "required": false, "type": "string" } }, "path": "drive.download_file", "primary_cli_path": "drive download", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "下载钉盘文件到本地", "use_when": [ "用户要把钉盘普通文件(PDF/图片/Office 等非在线文档)下载到本地路径时", "已确认 contentType 非 ALIDOC,需要落盘本地查看时" ] }, "drive.download_file_version": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.download_file_version", "cobra-help:dws drive download-version", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "wukong-develop:wukong/products/drive.go" ], "agent_summary": "下载钉盘普通文件的指定历史版本到本地(两步下载:取签名 URL 后 HTTP GET)", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "下载最新版本用 drive download", "在线文档(adoc)历史版本用 doc version 系列命令", "在线表格(axls)历史版本用 sheet version 系列命令" ], "canonical_path": "drive.download_file_version", "cli_name": "download-version", "cli_path": "drive download-version", "confirmation": "not_required", "description": "下载钉盘文件的指定历史版本到本地(两步下载流程)。\n\n仅适用于普通文件(如 pdf、docx、xlsx、png 等):\n 钉钉在线文档(adoc)请使用 dws doc version 系列命令\n 钉钉在线表格(axls)请使用 dws sheet version 系列命令\n\n流程:\n 1. 获取历史版本下载 URL 和签名请求头 (download_file_version)\n 2. HTTP GET 下载文件二进制内容到本地\n\n版本号从 dws drive list --node \u003cdentryUuid\u003e --versions 获取。", "display": "钉盘文件管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws drive download-version --node \u003cdentryUuid\u003e --version 3 --output ./report_v3.pdf" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop drive download --version 分支实现移植为独立命令;单一 download_file_version 远端调用,参数契约与帮助文档一致。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "下载钉盘普通文件的指定历史版本到本地(两步下载:取签名 URL 后 HTTP GET)" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop drive download --version 分支实现移植为独立命令;单一 download_file_version 远端调用,参数契约与帮助文档一致。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "下载钉盘普通文件的指定历史版本到本地(两步下载:取签名 URL 后 HTTP GET)" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop drive download --version 分支实现移植为独立命令;单一 download_file_version 远端调用,参数契约与帮助文档一致。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "下载最新版本用 drive download", "在线文档(adoc)历史版本用 doc version 系列命令", "在线表格(axls)历史版本用 sheet version 系列命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop drive download --version 分支实现移植为独立命令;单一 download_file_version 远端调用,参数契约与帮助文档一致。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "下载最新版本用 drive download", "在线文档(adoc)历史版本用 doc version 系列命令", "在线表格(axls)历史版本用 sheet version 系列命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive download-version", "value": "drive.download_file_version" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive download-version", "value": "drive.download_file_version" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "下载钉盘文件的指定历史版本到本地(两步下载流程)。\n\n仅适用于普通文件(如 pdf、docx、xlsx、png 等):\n 钉钉在线文档(adoc)请使用 dws doc version 系列命令\n 钉钉在线表格(axls)请使用 dws sheet version 系列命令\n\n流程:\n 1. 获取历史版本下载 URL 和签名请求头 (download_file_version)\n 2. HTTP GET 下载文件二进制内容到本地\n\n版本号从 dws drive list --node \u003cdentryUuid\u003e --versions 获取。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "下载钉盘文件的指定历史版本到本地(两步下载流程)。\n\n仅适用于普通文件(如 pdf、docx、xlsx、png 等):\n 钉钉在线文档(adoc)请使用 dws doc version 系列命令\n 钉钉在线表格(axls)请使用 dws sheet version 系列命令\n\n流程:\n 1. 获取历史版本下载 URL 和签名请求头 (download_file_version)\n 2. HTTP GET 下载文件二进制内容到本地\n\n版本号从 dws drive list --node \u003cdentryUuid\u003e --versions 获取。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop drive download --version 分支实现移植为独立命令;单一 download_file_version 远端调用,参数契约与帮助文档一致。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive download-version --node \u003cdentryUuid\u003e --version 3 --output ./report_v3.pdf" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop drive download --version 分支实现移植为独立命令;单一 download_file_version 远端调用,参数契约与帮助文档一致。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive download-version --node \u003cdentryUuid\u003e --version 3 --output ./report_v3.pdf" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop drive download --version 分支实现移植为独立命令;单一 download_file_version 远端调用,参数契约与帮助文档一致。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "下载文件历史版本到本地" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "下载文件历史版本到本地" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop drive download --version 分支实现移植为独立命令;单一 download_file_version 远端调用,参数契约与帮助文档一致。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要下载文件的历史版本/旧版本", "版本号已通过 drive list --versions 获取" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop drive download --version 分支实现移植为独立命令;单一 download_file_version 远端调用,参数契约与帮助文档一致。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要下载文件的历史版本/旧版本", "版本号已通过 drive list --versions 获取" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "download_file_version", "parameter_count": 3, "parameters": { "node": { "description": "文件 ID (dentryUuid) 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件 ID (dentryUuid) 或 URL (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件 ID (dentryUuid) 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.download_file_version has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.download_file_version has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" }, "output": { "description": "本地保存路径 (文件路径或目录,必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "本地保存路径 (文件路径或目录,必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "本地保存路径 (文件路径或目录,必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.download_file_version has no singular pinned interface_ref; --output is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "output" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.download_file_version has no singular pinned interface_ref; --output is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" }, "version": { "description": "历史版本号 (必填,正整数,从 drive list --versions 获取)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "历史版本号 (必填,正整数,从 drive list --versions 获取)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "历史版本号 (必填,正整数,从 drive list --versions 获取)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.download_file_version has no singular pinned interface_ref; --version is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "version" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.download_file_version has no singular pinned interface_ref; --version is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "required": true, "type": "integer" } }, "path": "drive.download_file_version", "primary_cli_path": "drive download-version", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "下载文件历史版本到本地", "use_when": [ "用户要下载文件的历史版本/旧版本", "版本号已通过 drive list --versions 获取" ] }, "drive.get_cover": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.get_cover", "cobra-help:dws drive cover", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "wukong-develop:wukong/products" ], "agent_summary": "获取节点封面图片地址(文档首图/图片缩略图/类型图标)", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "设置文档封面用 doc style cover set" ], "canonical_path": "drive.get_cover", "cli_name": "cover", "cli_path": "drive cover", "confirmation": "not_required", "description": "获取节点封面地址", "display": "钉盘文件管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws drive cover --node \u003cdentryUuid\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "获取节点封面图片地址(文档首图/图片缩略图/类型图标)" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "获取节点封面图片地址(文档首图/图片缩略图/类型图标)" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "设置文档封面用 doc style cover set" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "设置文档封面用 doc style cover set" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive cover", "value": "drive.get_cover" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive cover", "value": "drive.get_cover" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取节点封面地址" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取节点封面地址" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive cover --node \u003cdentryUuid\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive cover --node \u003cdentryUuid\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取节点封面地址" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取节点封面地址" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户说 封面/封面图/缩略图/预览图" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户说 封面/封面图/缩略图/预览图" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "get_cover", "parameter_count": 1, "parameters": { "node": { "description": "节点 ID (dentryUuid) 或文档 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "节点 ID (dentryUuid) 或文档 URL (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "节点 ID (dentryUuid) 或文档 URL (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.get_cover has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.get_cover has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" } }, "path": "drive.get_cover", "primary_cli_path": "drive cover", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "获取节点封面地址", "use_when": [ "用户说 封面/封面图/缩略图/预览图" ] }, "drive.get_file_info": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.get_file_info", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive info", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.get_file_info", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "internal/cli/schema_mcp_metadata.json#tools.drive.get_file_info", "live-mcp:dws schema drive.get_file_info", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/imported/wukong.json#drive.get_file_info", "structured-hint:internal/cli/schema_hints/products/drive.json", "structured-hint:internal/cli/schema_hints/selection-review.json#drive.get_file_info" ], "agent_summary": "获取文件元数据信息", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "要读在线文档正文改用 dws doc read(先本命令或 doc info 确认类型)", "要下载普通文件改用 dws drive download", "只要目录列表改用 dws drive list" ], "canonical_path": "drive.get_file_info", "cli_name": "info", "cli_path": "drive info", "confirmation": "not_required", "description": "获取钉盘文件/文件夹的元数据信息。\n\n如果目标文件属于钉钉文档(在线文档/表格/脑图等),会自动跟进调用\n钉钉文档接口获取更准确的文档信息(如真实文档名称),并合并输出。", "display": "钉盘文件管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws drive info --node \u003cdentryUuid\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "获取文件元数据信息" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "获取文件元数据信息" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.get_file_info.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要读在线文档正文改用 dws doc read(先本命令或 doc info 确认类型)", "要下载普通文件改用 dws drive download", "只要目录列表改用 dws drive list" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要读在线文档正文改用 dws doc read(先本命令或 doc info 确认类型)", "要下载普通文件改用 dws drive download", "只要目录列表改用 dws drive list" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive info", "value": "drive.get_file_info" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive info", "value": "drive.get_file_info" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取钉盘文件/文件夹的元数据信息。\n\n如果目标文件属于钉钉文档(在线文档/表格/脑图等),会自动跟进调用\n钉钉文档接口获取更准确的文档信息(如真实文档名称),并合并输出。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "获取钉盘中指定节点(文件或文件夹)的元数据信息,包括文件名、类型、状态、路径、创建时间、文件大小等" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取钉盘文件/文件夹的元数据信息。\n\n如果目标文件属于钉钉文档(在线文档/表格/脑图等),会自动跟进调用\n钉钉文档接口获取更准确的文档信息(如真实文档名称),并合并输出。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive info --node \u003cdentryUuid\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive info --node \u003cdentryUuid\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.get_file_info.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "drive", "rpc_name": "get_file_info" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.get_file_info.interface_ref", "value": "drive.get_file_info" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "drive", "rpc_name": "get_file_info" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取文件元数据信息" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "获取文件元数据信息" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取文件元数据信息" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要查看钉盘文件/文件夹元信息(名称、类型、大小、路径、时间)时", "准备读内容前需先判断 extension/是否在线文档,再路由到 doc read / sheet / download 时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要查看钉盘文件/文件夹元信息(名称、类型、大小、路径、时间)时", "准备读内容前需先判断 extension/是否在线文档,再路由到 doc read / sheet / download 时" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "get_file_info" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_file_info", "parameter_count": 2, "parameters": { "node": { "description": "节点 ID (dentryUuid) (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "节点 ID (dentryUuid) (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "节点 ID(dentryUuid 格式),统一标识文件和文件夹" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "节点 ID (dentryUuid) (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "fileId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "fileId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "节点 ID(dentryUuid 格式),统一标识文件和文件夹", "property": "fileId", "required": true, "type": "string" }, "space-id": { "description": "节点所属空间 ID (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "节点所属空间 ID (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "节点所属空间 ID。可不传,后端自动从 fileId(dentryUuid 格式)中解析出 spaceId" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "节点所属空间 ID (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "spaceId" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "spaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "节点所属空间 ID。可不传,后端自动从 fileId(dentryUuid 格式)中解析出 spaceId", "property": "spaceId", "required": false, "type": "string" } }, "path": "drive.get_file_info", "primary_cli_path": "drive info", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "获取文件元数据信息", "use_when": [ "用户要查看钉盘文件/文件夹元信息(名称、类型、大小、路径、时间)时", "准备读内容前需先判断 extension/是否在线文档,再路由到 doc read / sheet / download 时" ] }, "drive.get_node_stats": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws drive stats --help", "internal/cli/schema_command_registry.json#drive.get_node_stats", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "live-mcp:none (Cobra+Skill; composite/unpinned)", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json" ], "agent_summary": "读取指定钉盘或文档空间节点的阅读、编辑、评论、点赞、预览与下载等统计。", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "要改文件内容或权限不要用本命令;本命令只读", "只要元信息(名称/类型)改用 dws drive info 或 dws doc info" ], "canonical_path": "drive.get_node_stats", "cli_name": "stats", "cli_path": "drive stats", "confirmation": "not_required", "description": "获取指定节点的统计数据,包括阅读人数、阅读次数、编辑次数、评论数、点赞数、预览次数和下载次数等。\n\n不同文件类型返回的统计维度可能不同。--node 支持节点 ID 或文档 URL。", "display": "钉盘文件管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws drive stats --node \u003cNODE_ID_OR_URL\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "读取指定钉盘或文档空间节点的阅读、编辑、评论、点赞、预览与下载等统计。" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "读取指定钉盘或文档空间节点的阅读、编辑、评论、点赞、预览与下载等统计。" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要改文件内容或权限不要用本命令;本命令只读", "只要元信息(名称/类型)改用 dws drive info 或 dws doc info" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要改文件内容或权限不要用本命令;本命令只读", "只要元信息(名称/类型)改用 dws drive info 或 dws doc info" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive stats", "value": "drive.get_node_stats" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive stats", "value": "drive.get_node_stats" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取指定节点的统计数据,包括阅读人数、阅读次数、编辑次数、评论数、点赞数、预览次数和下载次数等。\n\n不同文件类型返回的统计维度可能不同。--node 支持节点 ID 或文档 URL。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取指定节点的统计数据,包括阅读人数、阅读次数、编辑次数、评论数、点赞数、预览次数和下载次数等。\n\n不同文件类型返回的统计维度可能不同。--node 支持节点 ID 或文档 URL。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive stats --node \u003cNODE_ID_OR_URL\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive stats --node \u003cNODE_ID_OR_URL\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取节点统计信息" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取节点统计信息" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要查看节点阅读/编辑/评论/点赞/预览/下载等统计维度时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要查看节点阅读/编辑/评论/点赞/预览/下载等统计维度时" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "get_node_stats", "parameter_count": 1, "parameters": { "node": { "description": "节点 ID 或文档 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "节点 ID 或文档 URL (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "节点 ID 或文档 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "nodeId", "required": true, "type": "string" } }, "path": "drive.get_node_stats", "primary_cli_path": "drive stats", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "获取节点统计信息", "use_when": [ "用户要查看节点阅读/编辑/评论/点赞/预览/下载等统计维度时" ] }, "drive.get_star_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.get_star_list", "cobra-help:dws drive star list", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "wukong-develop:wukong/products" ], "agent_summary": "获取当前用户的收藏列表,支持分页与按内容类型筛选", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "操作单个收藏用 mark_star/unmark_star" ], "canonical_path": "drive.get_star_list", "cli_name": "list", "cli_path": "drive star list", "confirmation": "not_required", "description": "获取收藏列表", "display": "钉盘文件管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws drive star list --format json", "dws drive star list --content-types doc,sheet --limit 10 --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "获取当前用户的收藏列表,支持分页与按内容类型筛选" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "获取当前用户的收藏列表,支持分页与按内容类型筛选" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "操作单个收藏用 mark_star/unmark_star" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "操作单个收藏用 mark_star/unmark_star" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive star list", "value": "drive.get_star_list" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive star list", "value": "drive.get_star_list" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取收藏列表" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取收藏列表" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive star list --format json", "dws drive star list --content-types doc,sheet --limit 10 --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive star list --format json", "dws drive star list --content-types doc,sheet --limit 10 --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取收藏列表" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取收藏列表" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户说 我的收藏/收藏列表/收藏了哪些文档" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户说 我的收藏/收藏列表/收藏了哪些文档" ] } }, "group": "star", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "get_star_list", "parameter_count": 6, "parameters": { "content-types": { "description": "内容类型: doc,sheet,ppt,whiteboard,mind,notable,pdf,other,folder", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "内容类型: doc,sheet,ppt,whiteboard,mind,notable,pdf,other,folder" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "内容类型: doc,sheet,ppt,whiteboard,mind,notable,pdf,other,folder" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.get_star_list has no singular pinned interface_ref; --content-types is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "contentTypes" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.get_star_list has no singular pinned interface_ref; --content-types is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "required": false, "type": "array" }, "cursor": { "description": "分页游标", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.get_star_list has no singular pinned interface_ref; --cursor is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.get_star_list has no singular pinned interface_ref; --cursor is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "limit": { "description": "每页条数 (默认 20,最大 20)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页条数 (默认 20,最大 20)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页条数 (默认 20,最大 20)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.get_star_list has no singular pinned interface_ref; --limit is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.get_star_list has no singular pinned interface_ref; --limit is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "required": false, "type": "integer" }, "order-by": { "description": "排序字段: createTime", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "排序字段: createTime" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "排序字段: createTime" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.get_star_list has no singular pinned interface_ref; --order-by is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "orderBy" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.get_star_list has no singular pinned interface_ref; --order-by is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "resource-types": { "description": "资源大类: DENTRY, TEAM, WORKSPACE", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "资源大类: DENTRY, TEAM, WORKSPACE" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "资源大类: DENTRY, TEAM, WORKSPACE" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.get_star_list has no singular pinned interface_ref; --resource-types is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "resourceTypes" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.get_star_list has no singular pinned interface_ref; --resource-types is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "required": false, "type": "array" }, "sort": { "description": "排序方向: asc|desc", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "排序方向: asc|desc" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "排序方向: asc|desc" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.get_star_list has no singular pinned interface_ref; --sort is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "sort" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.get_star_list has no singular pinned interface_ref; --sort is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" } }, "path": "drive.get_star_list", "primary_cli_path": "drive star list", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "获取收藏列表", "use_when": [ "用户说 我的收藏/收藏列表/收藏了哪些文档" ] }, "drive.get_upload_info": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.get_upload_info", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive upload-info", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.get_upload_info", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "internal/cli/schema_mcp_metadata.json#tools.drive.get_upload_info", "live-mcp:dws schema drive.get_upload_info", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/imported/wukong.json#drive.get_upload_info", "structured-hint:internal/cli/schema_hints/products/drive.json", "structured-hint:internal/cli/schema_hints/selection-review.json#drive.get_upload_info" ], "agent_summary": "获取文件上传信息", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "普通上传请直接用 dws drive upload,不要手动走三步", "拿到凭证后须 HTTP PUT 再 dws drive commit;本命令本身不完成入库" ], "canonical_path": "drive.get_upload_info", "cli_name": "upload-info", "cli_path": "drive upload-info", "confirmation": "not_required", "description": "获取文件上传信息", "display": "钉盘文件管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws drive upload-info --file-name \"report.pdf\" --file-size 102400 --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "获取文件上传信息" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "获取文件上传信息" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.get_upload_info.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "普通上传请直接用 dws drive upload,不要手动走三步", "拿到凭证后须 HTTP PUT 再 dws drive commit;本命令本身不完成入库" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "普通上传请直接用 dws drive upload,不要手动走三步", "拿到凭证后须 HTTP PUT 再 dws drive commit;本命令本身不完成入库" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive upload-info", "value": "drive.get_upload_info" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive upload-info", "value": "drive.get_upload_info" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取文件上传信息" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "文件上传流程:\r\nStep 1:调用本接口获取预签名的 OSS 上传 URL\r\nStep 2:使用 Step 1 返回的 URL 将文件 PUT 到 OSS\r\nStep 3:调用commit_upload 提交文件,传入本接口返回的 uploadId 与对应的 fileName、fileSize 完成文件上传" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取文件上传信息" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive upload-info --file-name \"report.pdf\" --file-size 102400 --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive upload-info --file-name \"report.pdf\" --file-size 102400 --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.get_upload_info.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "drive", "rpc_name": "get_upload_info" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.get_upload_info.interface_ref", "value": "drive.get_upload_info" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "drive", "rpc_name": "get_upload_info" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取文件上传信息" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "get_upload_info" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取文件上传信息" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "仅当无法使用 drive upload 一条命令、需要自定义流式上传时,获取 OSS 预签名上传凭证" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "仅当无法使用 drive upload 一条命令、需要自定义流式上传时,获取 OSS 预签名上传凭证" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "get_upload_info" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_upload_info", "parameter_count": 5, "parameters": { "file-name": { "description": "文件名,须包含扩展名,如 报告.pdf (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件名,须包含扩展名,如 报告.pdf (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "文件名,须包含扩展名,如 报告.pdf。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件名,须包含扩展名,如 报告.pdf (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "fileName" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "fileName" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "文件名,须包含扩展名,如 报告.pdf。", "property": "fileName", "required": true, "type": "string" }, "file-size": { "cli_required": true, "description": "文件大小(字节)(必填)", "field_provenance": { "cli_required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_hard_required", "value": true } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_hard_required", "value": true }, "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件大小(字节)(必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "文件大小(字节),用于服务端生成上传凭证和后续完整性校验。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件大小(字节)(必填)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "fileSize" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "fileSize" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_hard_required", "value": true }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_hard_required", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "文件大小(字节),用于服务端生成上传凭证和后续完整性校验。", "interface_type": "number", "property": "fileSize", "required": true, "type": "integer" }, "folder": { "description": "父节点 ID (dentryUuid),不传则上传到空间根目录 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "父节点 ID (dentryUuid),不传则上传到空间根目录 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "父节点 ID(dentryUuid 格式)。不传则上传到空间根目录。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "父节点 ID (dentryUuid),不传则上传到空间根目录 (可选)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "parentId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "folder" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "parentId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "父节点 ID(dentryUuid 格式)。不传则上传到空间根目录。", "property": "parentId", "required": false, "type": "string" }, "mime-type": { "description": "文件 MIME 类型,如 application/pdf,不传则自动推断 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件 MIME 类型,如 application/pdf,不传则自动推断 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "文件 MIME 类型,如 application/pdf。不传时由服务端根据文件扩展名自动推断。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件 MIME 类型,如 application/pdf,不传则自动推断 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "mimeType" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "mimeType" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "文件 MIME 类型,如 application/pdf。不传时由服务端根据文件扩展名自动推断。", "property": "mimeType", "required": false, "type": "string" }, "space-id": { "description": "目标空间 ID,不传则使用「我的文件」 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标空间 ID,不传则使用「我的文件」 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标空间 ID。不传时后端自动使用当前用户「我的文件」对应的 spaceId。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标空间 ID,不传则使用「我的文件」 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "spaceId" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "spaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标空间 ID。不传时后端自动使用当前用户「我的文件」对应的 spaceId。", "property": "spaceId", "required": false, "type": "string" } }, "path": "drive.get_upload_info", "primary_cli_path": "drive upload-info", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "获取文件上传信息", "use_when": [ "仅当无法使用 drive upload 一条命令、需要自定义流式上传时,获取 OSS 预签名上传凭证" ] }, "drive.list_files": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.list_files", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive list", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.list_files", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "internal/cli/schema_mcp_metadata.json#tools.drive.list_files", "live-mcp:dws schema drive.list_files", "skills/mono/references/intent-guide.md", "skills/mono/references/products/doc.md", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/imported/wukong.json#drive.list_files", "structured-hint:internal/cli/schema_hints/products/drive.json", "structured-hint:internal/cli/schema_hints/selection-review.json#drive.list_files" ], "agent_summary": "获取文件/文件夹列表", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "只记得关键词、不知道所在目录时改用 dws drive search", "明确要在某个知识库内按目录浏览且已有 workspaceId 时可用 dws wiki node list", "要找最近打开/编辑过的文档改用 dws drive recent" ], "canonical_path": "drive.list_files", "cli_name": "list", "cli_path": "drive list", "confirmation": "not_required", "description": "列出文件和文件夹。根据参数自动路由到钉盘或文档空间。\n\n路由规则:\n 默认(无 --workspace) → 列出钉盘「我的文件」\n --space-id \u003c纯数字\u003e → 列出钉盘指定空间\n --workspace \u003c加密string/URL\u003e → 列出文档空间/知识库文件(等同于原 list-docs)\n --folder \u003cnodeId\u003e → 列出指定文件夹下的子节点", "display": "钉盘文件管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws drive list --limit 20 --format json", "dws drive list --folder \u003cdentryUuid\u003e --limit 20 --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "获取文件/文件夹列表" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "获取文件/文件夹列表" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_files.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "只记得关键词、不知道所在目录时改用 dws drive search", "明确要在某个知识库内按目录浏览且已有 workspaceId 时可用 dws wiki node list", "要找最近打开/编辑过的文档改用 dws drive recent" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "只记得关键词、不知道所在目录时改用 dws drive search", "明确要在某个知识库内按目录浏览且已有 workspaceId 时可用 dws wiki node list", "要找最近打开/编辑过的文档改用 dws drive recent" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive list", "value": "drive.list_files" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive list", "value": "drive.list_files" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列出文件和文件夹。根据参数自动路由到钉盘或文档空间。\n\n路由规则:\n 默认(无 --workspace) → 列出钉盘「我的文件」\n --space-id \u003c纯数字\u003e → 列出钉盘指定空间\n --workspace \u003c加密string/URL\u003e → 列出文档空间/知识库文件(等同于原 list-docs)\n --folder \u003cnodeId\u003e → 列出指定文件夹下的子节点" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "列出钉盘指定文件夹下的文件和文件夹,支持分页和排序\r\n最简用法:不传任何参数,列出默认空间根目录下的内容。\r\n如果想列出某个子文件夹的内容,传 parentId(从 create_folder 或 list_files 返回值中获取)。\r\n使用 nextToken 游标翻页:首次不传,后续翻页传上一次返回的 nextToken;nextToken 为 null 表示没有更多数据。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列出文件和文件夹。根据参数自动路由到钉盘或文档空间。\n\n路由规则:\n 默认(无 --workspace) → 列出钉盘「我的文件」\n --space-id \u003c纯数字\u003e → 列出钉盘指定空间\n --workspace \u003c加密string/URL\u003e → 列出文档空间/知识库文件(等同于原 list-docs)\n --folder \u003cnodeId\u003e → 列出指定文件夹下的子节点" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive list --limit 20 --format json", "dws drive list --folder \u003cdentryUuid\u003e --limit 20 --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive list --limit 20 --format json", "dws drive list --folder \u003cdentryUuid\u003e --limit 20 --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_files.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "The CLI command routes by --workspace between drive/list_files and doc/list_nodes, so the reviewed executable wrapper has no single direct MCP interface." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "The CLI command routes by --workspace between drive/list_files and doc/list_nodes, so the reviewed executable wrapper has no single direct MCP interface." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "overridden_candidates": [ { "precedence": "imported", "selected": false, "source": "internal/cli/schema_hints/imported/wukong.json", "value": "drive.list_files" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_files.interface_ref", "value": "drive.list_files" } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取文件/文件夹列表(统一入口)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "获取文件/文件夹列表" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取文件/文件夹列表(统一入口)" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要浏览「我的文件」/钉盘/网盘某目录下有哪些文件或文件夹时", "已知父文件夹 dentryUuid,要列出其子项以便继续 download/copy/move 时", "传 --workspace 时要列出文档空间/知识库根或子目录(与 wiki node list 场景重叠时,用户说钉盘/我的文件优先本命令)" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要浏览「我的文件」/钉盘/网盘某目录下有哪些文件或文件夹时", "已知父文件夹 dentryUuid,要列出其子项以便继续 download/copy/move 时", "传 --workspace 时要列出文档空间/知识库根或子目录(与 wiki node list 场景重叠时,用户说钉盘/我的文件优先本命令)" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "The CLI command routes by --workspace between drive/list_files and doc/list_nodes, so the reviewed executable wrapper has no single direct MCP interface.", "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_files", "parameter_count": 13, "parameters": { "cursor": { "description": "分页游标,首次不传 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标,首次不传 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标,首次不传 (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "composite route maps to nextToken for drive.list_files or pageToken for doc.list_nodes", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "composite route maps to nextToken for drive.list_files or pageToken for doc.list_nodes", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "depth": { "default": "1", "description": "递归列出子目录层级,默认 1(仅当前层),最大 5;与 --cursor/--limit 互斥;与 --workspace 组合时走知识库递归 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "递归列出子目录层级,默认 1(仅当前层),最大 5;与 --cursor/--limit 互斥;与 --workspace 组合时走知识库递归 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "递归列出子目录层级,默认 1(仅当前层),最大 5;与 --cursor/--limit 互斥;与 --workspace 组合时走知识库递归 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "depth" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "depth" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "property": "depth", "required": false, "type": "integer" }, "folder": { "description": "父节点 ID (dentryUuid),不传则列出空间根目录 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "父节点 ID (dentryUuid),不传则列出空间根目录 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "父节点 ID (dentryUuid),不传则列出空间根目录 (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "composite route maps to parentId for drive.list_files or folderId for doc.list_nodes", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "folder" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "composite route maps to parentId for drive.list_files or folderId for doc.list_nodes", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "limit": { "default": "20", "description": "每页返回数量,默认 20,最大 50", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页返回数量,默认 20,最大 50" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页返回数量,默认 20,最大 50" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "composite route maps to maxResults for drive.list_files or pageSize for doc.list_nodes", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "composite route maps to maxResults for drive.list_files or pageSize for doc.list_nodes", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "required": false, "type": "integer" }, "node": { "description": "文件 ID (dentryUuid) 或 URL (--versions 模式下必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件 ID (dentryUuid) 或 URL (--versions 模式下必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件 ID (dentryUuid) 或 URL (--versions 模式下必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "node" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "node" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "node", "required": false, "type": "string" }, "order": { "description": "排序方向: asc|desc,默认 desc (可选,仅钉盘)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "排序方向: asc|desc,默认 desc (可选,仅钉盘)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "排序方向: asc|desc,默认 desc (可选,仅钉盘)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "drive-branch-only option on a composite drive/doc command; no singular interface property is advertised", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "order" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "drive-branch-only option on a composite drive/doc command; no singular interface property is advertised", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "order-by": { "description": "排序字段: createTime|modifyTime|name (可选,仅钉盘)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "排序字段: createTime|modifyTime|name (可选,仅钉盘)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "排序字段: createTime|modifyTime|name (可选,仅钉盘)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "drive-branch-only option on a composite drive/doc command; no singular interface property is advertised", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "orderBy" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "drive-branch-only option on a composite drive/doc command; no singular interface property is advertised", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "pattern": { "description": "按名称通配过滤结果,如 \"*日报*\" (客户端过滤) (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按名称通配过滤结果,如 \"*日报*\" (客户端过滤) (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按名称通配过滤结果,如 \"*日报*\" (客户端过滤) (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "pattern" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "pattern" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "pattern", "required": false, "type": "string" }, "quiet": { "description": "关闭递归进度输出(stderr),不影响 stdout JSON (仅 --depth\u003e1 时有效) (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "关闭递归进度输出(stderr),不影响 stdout JSON (仅 --depth\u003e1 时有效) (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "关闭递归进度输出(stderr),不影响 stdout JSON (仅 --depth\u003e1 时有效) (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "quiet" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "quiet" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "boolean" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "boolean" } }, "property": "quiet", "required": false, "type": "boolean" }, "space-id": { "description": "钉盘空间 ID (纯数字),不传则使用「我的文件」(可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "钉盘空间 ID (纯数字),不传则使用「我的文件」(可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "钉盘空间 ID (纯数字),不传则使用「我的文件」(可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "drive-branch-only route input on a composite drive/doc command; no singular interface property is advertised", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "spaceId" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "drive-branch-only route input on a composite drive/doc command; no singular interface property is advertised", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "thumbnail": { "description": "是否返回缩略图信息 (可选,仅钉盘)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "是否返回缩略图信息 (可选,仅钉盘)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "是否返回缩略图信息 (可选,仅钉盘)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "drive-branch-only option on a composite drive/doc command; no singular interface property is advertised", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "thumbnail" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "drive-branch-only option on a composite drive/doc command; no singular interface property is advertised", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "boolean" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "boolean" } }, "required": false, "type": "boolean" }, "versions": { "description": "列出文件历史版本而非文件列表 (需配合 --node)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "列出文件历史版本而非文件列表 (需配合 --node)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "列出文件历史版本而非文件列表 (需配合 --node)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "versions" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "versions" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "boolean" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "boolean" } }, "property": "versions", "required": false, "type": "boolean" }, "workspace": { "description": "文档空间/知识库 ID (加密 string 或 URL),传入则路由到文档空间 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档空间/知识库 ID (加密 string 或 URL),传入则路由到文档空间 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档空间/知识库 ID (加密 string 或 URL),传入则路由到文档空间 (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "selects the doc.list_nodes branch of the composite drive/doc command", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "selects the doc.list_nodes branch of the composite drive/doc command", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" } }, "path": "drive.list_files", "primary_cli_path": "drive list", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "获取文件/文件夹列表(统一入口)", "use_when": [ "用户要浏览「我的文件」/钉盘/网盘某目录下有哪些文件或文件夹时", "已知父文件夹 dentryUuid,要列出其子项以便继续 download/copy/move 时", "传 --workspace 时要列出文档空间/知识库根或子目录(与 wiki node list 场景重叠时,用户说钉盘/我的文件优先本命令)" ] }, "drive.list_permission": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.list_permission", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive permission list", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "internal/cli/schema_mcp_metadata.json#tools.drive.list_permission", "live-mcp:dws schema doc.list_permission", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json", "structured-hint:internal/cli/schema_hints/selection-review.json#drive.list_permission" ], "agent_summary": "查询文档空间节点的协作者列表", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "要新增/修改/移除权限分别用 permission add/update/remove", "查知识库容器成员改用 dws wiki member list" ], "canonical_path": "drive.list_permission", "cli_name": "list", "cli_path": "drive permission list", "confirmation": "not_required", "description": "查询文档空间节点的协作者列表。", "display": "钉盘文件管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws drive permission list --node \u003cID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "查询文档空间节点的协作者列表" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "查询文档空间节点的协作者列表" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_permission.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要新增/修改/移除权限分别用 permission add/update/remove", "查知识库容器成员改用 dws wiki member list" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要新增/修改/移除权限分别用 permission add/update/remove", "查知识库容器成员改用 dws wiki member list" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive permission list", "value": "drive.list_permission" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive permission list", "value": "drive.list_permission" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查询文档空间节点的协作者列表。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "查询知识库节点当前的成员权限列表。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查询文档空间节点的协作者列表。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive permission list --node \u003cID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive permission list --node \u003cID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_permission.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": { "product_id": "doc", "rpc_name": "list_permission" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_permission.interface_ref", "value": "doc.list_permission" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": { "product_id": "doc", "rpc_name": "list_permission" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查询协作者列表" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "查询节点成员列表" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查询协作者列表" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "查看某文档/文件夹节点当前有哪些成员及角色时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "查看某文档/文件夹节点当前有哪些成员及角色时" ] } }, "group": "permission", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "list_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_permission", "parameter_count": 4, "parameters": { "filter-role": { "description": "按角色过滤: OWNER / MANAGER / EDITOR / DOWNLOADER / READER", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按角色过滤: OWNER / MANAGER / EDITOR / DOWNLOADER / READER" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "按角色过滤成员列表,选填。取值:OWNER、MANAGER、EDITOR、DOWNLOADER、READER。不传时返回所有角色的成员。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按角色过滤: OWNER / MANAGER / EDITOR / DOWNLOADER / READER" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "filterRoleIds" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "filterRole" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "filterRoleIds" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "按角色过滤成员列表,选填。取值:OWNER、MANAGER、EDITOR、DOWNLOADER、READER。不传时返回所有角色的成员。", "interface_type": "array", "property": "filterRoleIds", "required": false, "type": "string" }, "limit": { "default": "30", "description": "返回成员数上限,默认 30,最大 200", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "返回成员数上限,默认 30,最大 200" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "期望返回的最大成员条数,默认 30,最大 200。底层一次性返回全量成员后在内存中按本字段截断;本接口不支持游标翻页,不存在 nextToken。若发生截断(出参 truncated=true),可通过出参 totalCount 感知全量成员数,并通过 filterRoleIds 收窄查询范围。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "返回成员数上限,默认 30,最大 200" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "maxResults" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "maxResults" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "期望返回的最大成员条数,默认 30,最大 200。底层一次性返回全量成员后在内存中按本字段截断;本接口不支持游标翻页,不存在 nextToken。若发生截断(出参 truncated=true),可通过出参 totalCount 感知全量成员数,并通过 filterRoleIds 收窄查询范围。", "interface_type": "number", "property": "maxResults", "required": false, "type": "integer" }, "node": { "description": "目标节点 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标节点 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标节点的 nodeId。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标节点 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标节点的 nodeId。", "property": "nodeId", "required": true, "type": "string" }, "workspace": { "description": "知识库 ID (选填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "知识库 ID (选填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标知识库的标识,选填。仅用于辅助构造返回的 docUrl,业务实际依赖 nodeId 定位节点;支持两种格式:1) 知识库 ID(纯字符串);2) 知识库 URL,如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview,系统自动提取其中的 workspaceId。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "知识库 ID (选填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "workspaceId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "workspaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标知识库的标识,选填。仅用于辅助构造返回的 docUrl,业务实际依赖 nodeId 定位节点;支持两种格式:1) 知识库 ID(纯字符串);2) 知识库 URL,如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview,系统自动提取其中的 workspaceId。", "property": "workspaceId", "required": false, "type": "string" } }, "path": "drive.list_permission", "primary_cli_path": "drive permission list", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "查询协作者列表", "use_when": [ "查看某文档/文件夹节点当前有哪些成员及角色时" ] }, "drive.list_spaces": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.list_spaces", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive list-spaces", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "internal/cli/schema_mcp_metadata.json#tools.drive.list_spaces", "live-mcp:dws schema drive.list_spaces", "skills/mono/references/intent-guide.md", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json", "structured-hint:internal/cli/schema_hints/selection-review.json#drive.list_spaces" ], "agent_summary": "兼容查询钉盘空间列表", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "推荐改用 dws wiki space list --type orgSpace 或 --type mySpace(本命令已 deprecated)", "要列知识库列表改用 dws wiki space list(默认 orgWikiSpace)" ], "canonical_path": "drive.list_spaces", "cli_name": "list-spaces", "cli_path": "drive list-spaces", "confirmation": "not_required", "description": "⚠️ 此命令已迁移到 wiki space list,请使用:\n dws wiki space list --type orgSpace # 企业空间\n dws wiki space list --type mySpace # 我的文件\n\n列出当前用户可访问的钉盘空间,返回 spaceId、spaceName、rootFolderId 等信息。", "display": "钉盘文件管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws drive list-spaces --space-type orgSpace --limit 20 --format json", "dws drive list-spaces --space-type mySpace --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "兼容查询钉盘空间列表" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "兼容查询钉盘空间列表" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_spaces.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "推荐改用 dws wiki space list --type orgSpace 或 --type mySpace(本命令已 deprecated)", "要列知识库列表改用 dws wiki space list(默认 orgWikiSpace)" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "推荐改用 dws wiki space list --type orgSpace 或 --type mySpace(本命令已 deprecated)", "要列知识库列表改用 dws wiki space list(默认 orgWikiSpace)" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive list-spaces", "value": "drive.list_spaces" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive list-spaces", "value": "drive.list_spaces" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "⚠️ 此命令已迁移到 wiki space list,请使用:\n dws wiki space list --type orgSpace # 企业空间\n dws wiki space list --type mySpace # 我的文件\n\n列出当前用户可访问的钉盘空间,返回 spaceId、spaceName、rootFolderId 等信息。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "获取当前用户可访问的空间列表。\r\n最简用法:不传任何参数,返回所有企业空间。\r\n空间类型筛选:通过 spaceType 参数可以筛选返回的空间类型:\r\norgSpace(或 不传):返回企业空间列表\r\nmySpace:返回用户的\"我的文件\"个人空间\r\n支持游标分页,使用 nextToken 进行翻页(仅企业空间支持分页)。\r\n返回结果说明:\r\n当 spaceType 为 orgSpace ,返回企业团队空间列表\r\n当 spaceType 为 mySpace 时,返回单个\"我的文件\"空间\r\n如果 nextToken 不为空,表示还有更多空间可以查询(仅企业空间)" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "⚠️ 此命令已迁移到 wiki space list,请使用:\n dws wiki space list --type orgSpace # 企业空间\n dws wiki space list --type mySpace # 我的文件\n\n列出当前用户可访问的钉盘空间,返回 spaceId、spaceName、rootFolderId 等信息。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive list-spaces --space-type orgSpace --limit 20 --format json", "dws drive list-spaces --space-type mySpace --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive list-spaces --space-type orgSpace --limit 20 --format json", "dws drive list-spaces --space-type mySpace --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_spaces.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_spaces.interface_ref", "value": { "product_id": "drive", "rpc_name": "list_spaces" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_spaces.interface_ref", "value": { "product_id": "drive", "rpc_name": "list_spaces" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取钉盘空间列表 (deprecated → dws wiki space list --type orgSpace/mySpace)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "list_spaces" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取钉盘空间列表 (deprecated → dws wiki space list --type orgSpace/mySpace)" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "兼容入口:枚举钉盘企业空间或「我的文件」空间以拿 spaceId/rootFolderId 时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "兼容入口:枚举钉盘企业空间或「我的文件」空间以拿 spaceId/rootFolderId 时" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "list_spaces" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_spaces", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标,仅企业空间支持分页 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标,仅企业空间支持分页 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "分页游标。首次请求不传,后续请求传上一次返回的 nextToken。当 nextToken 为 null 时,表示已获取所有空间。仅 spaceType 为 orgSpace 时有效" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标,仅企业空间支持分页 (可选)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nextToken" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nextToken" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "分页游标。首次请求不传,后续请求传上一次返回的 nextToken。当 nextToken 为 null 时,表示已获取所有空间。仅 spaceType 为 orgSpace 时有效", "property": "nextToken", "required": false, "type": "string" }, "limit": { "default": "20", "description": "每页返回数量 (默认 20,最大 50),仅 spaceType 为 orgSpace 时有效", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页返回数量 (默认 20,最大 50),仅 spaceType 为 orgSpace 时有效" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "每页返回数量,默认 20,最大 50。建议根据实际需求调整,较大的值可以减少请求次数,但会增加单次响应的数据量。仅 spaceType 为 orgSpace 时有效" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页返回数量 (默认 20,最大 50),仅 spaceType 为 orgSpace 时有效" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "maxResults" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "maxResults" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "每页返回数量,默认 20,最大 50。建议根据实际需求调整,较大的值可以减少请求次数,但会增加单次响应的数据量。仅 spaceType 为 orgSpace 时有效", "property": "maxResults", "required": false, "type": "integer" }, "space-type": { "description": "空间类型: orgSpace=企业空间(默认), mySpace=我的文件 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "空间类型: orgSpace=企业空间(默认), mySpace=我的文件 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "空间类型。可选值:orgSpace(企业空间)、mySpace(我的文件)。不传时默认为 orgSpace" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "空间类型: orgSpace=企业空间(默认), mySpace=我的文件 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "spaceType" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "spaceType" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "空间类型。可选值:orgSpace(企业空间)、mySpace(我的文件)。不传时默认为 orgSpace", "property": "spaceType", "required": false, "type": "string" } }, "path": "drive.list_spaces", "primary_cli_path": "drive list-spaces", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "获取钉盘空间列表 (deprecated → dws wiki space list --type orgSpace/mySpace)", "use_when": [ "兼容入口:枚举钉盘企业空间或「我的文件」空间以拿 spaceId/rootFolderId 时" ] }, "drive.mark_star": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.mark_star", "cobra-help:dws drive star add", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "wukong-develop:wukong/products" ], "agent_summary": "收藏文档/文件到当前用户收藏列表", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "取消收藏用 unmark_star;查看收藏列表用 get_star_list" ], "canonical_path": "drive.mark_star", "cli_name": "add", "cli_path": "drive star add", "confirmation": "not_required", "description": "收藏文档", "display": "钉盘文件管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws drive star add --node \u003cnodeId\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "收藏文档/文件到当前用户收藏列表" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "收藏文档/文件到当前用户收藏列表" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "取消收藏用 unmark_star;查看收藏列表用 get_star_list" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "取消收藏用 unmark_star;查看收藏列表用 get_star_list" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive star add", "value": "drive.mark_star" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive star add", "value": "drive.mark_star" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "收藏文档" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "收藏文档" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive star add --node \u003cnodeId\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive star add --node \u003cnodeId\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "收藏文档" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "收藏文档" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户说 收藏这个文档/加个收藏/标星" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户说 收藏这个文档/加个收藏/标星" ] } }, "group": "star", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "mark_star", "parameter_count": 1, "parameters": { "node": { "description": "文档 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.mark_star has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.mark_star has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" } }, "path": "drive.mark_star", "primary_cli_path": "drive star add", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "收藏文档", "use_when": [ "用户说 收藏这个文档/加个收藏/标星" ] }, "drive.move_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.move_document", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive move", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "internal/cli/schema_mcp_metadata.json#tools.drive.move_document", "live-mcp:dws schema doc.move_document", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json", "structured-hint:internal/cli/schema_hints/selection-review.json#drive.move_document" ], "agent_summary": "将文件或文档移动到目标文件夹或知识库(原位置不再保留)", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "需要保留原位置副本时改用 dws drive copy", "目标未确认或用户只是想复制时不要 move", "知识库内节点移动且走 wiki 入口时可用 dws wiki node move" ], "canonical_path": "drive.move_document", "cli_name": "move", "cli_path": "drive move", "confirmation": "not_required", "description": "将文档空间中的文档或文件移动到指定文件夹或知识库。移动后原位置不再存在。\n--folder 指定目标文件夹 nodeId,--workspace 指定目标知识库 ID。\n\n权限要求: 对源文档有\"管理\"权限,且对目标文件夹有\"编辑\"权限。", "display": "钉盘文件管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws drive move --node \u003c源dentryUuid\u003e --folder \u003c目标文件夹fileId\u003e --format json", "dws drive move --node \u003c源dentryUuid\u003e --workspace \u003cTARGET_WS_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "将文件或文档移动到目标文件夹或知识库(原位置不再保留)" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "将文件或文档移动到目标文件夹或知识库(原位置不再保留)" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.move_document.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "需要保留原位置副本时改用 dws drive copy", "目标未确认或用户只是想复制时不要 move", "知识库内节点移动且走 wiki 入口时可用 dws wiki node move" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "需要保留原位置副本时改用 dws drive copy", "目标未确认或用户只是想复制时不要 move", "知识库内节点移动且走 wiki 入口时可用 dws wiki node move" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive move", "value": "drive.move_document" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive move", "value": "drive.move_document" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "将文档空间中的文档或文件移动到指定文件夹或知识库。移动后原位置不再存在。\n--folder 指定目标文件夹 nodeId,--workspace 指定目标知识库 ID。\n\n权限要求: 对源文档有\"管理\"权限,且对目标文件夹有\"编辑\"权限。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "将指定节点移动到目标文件夹。\r\n\r\n支持的节点类型:知识库节点(文档、文件夹)、钉盘文件/文件夹。\r\nnodeId 支持文档 URL 或 dentryUuid(32 位字母数字字符串)。\r\ntargetFolderId 为目标文件夹的 dentryUuid;workspaceId 为目标知识库标识,不传 targetFolderId 时移动到该知识库根目录,如果不传 targetFolderId 和 workspaceId,默认到当前用户所在组织的「我的文档」下\r\n\r\n权限要求:\r\n- 对源节点有编辑权限\r\n- 对目标文件夹有写入权限\r\n\r\n注意:移动操作底层可能异步执行,异步时操作已提交但无法立即确认完成,请稍后查看目标文件夹确认结果。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "将文档空间中的文档或文件移动到指定文件夹或知识库。移动后原位置不再存在。\n--folder 指定目标文件夹 nodeId,--workspace 指定目标知识库 ID。\n\n权限要求: 对源文档有\"管理\"权限,且对目标文件夹有\"编辑\"权限。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive move --node \u003c源dentryUuid\u003e --folder \u003c目标文件夹fileId\u003e --format json", "dws drive move --node \u003c源dentryUuid\u003e --workspace \u003cTARGET_WS_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive move --node \u003c源dentryUuid\u003e --folder \u003c目标文件夹fileId\u003e --format json", "dws drive move --node \u003c源dentryUuid\u003e --workspace \u003cTARGET_WS_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.move_document.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": { "product_id": "doc", "rpc_name": "move_document" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.move_document.interface_ref", "value": "doc.move_document" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": { "product_id": "doc", "rpc_name": "move_document" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "移动文件/文档到指定位置" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "移动节点" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "移动文件/文档到指定位置" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要移动/搬走文件或文档到新位置,且原位置不再保留时(move≠copy)", "目标文件夹用 --folder;目标知识库根用 --workspace;都不传则默认「我的文档」", "移动到其他钉盘 space 根目录时传目标 space 的 rootFolderId 到 --folder(通常不传 --workspace)" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要移动/搬走文件或文档到新位置,且原位置不再保留时(move≠copy)", "目标文件夹用 --folder;目标知识库根用 --workspace;都不传则默认「我的文档」", "移动到其他钉盘 space 根目录时传目标 space 的 rootFolderId 到 --folder(通常不传 --workspace)" ] } }, "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "move_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "move_document", "parameter_count": 3, "parameters": { "folder": { "description": "目标文件夹 nodeId", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文件夹 nodeId" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文件夹的 dentryUuid(32 位字母数字字符串),节点将被移动到此文件夹下。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文件夹 nodeId" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "targetFolderId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "folder" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "targetFolderId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文件夹的 dentryUuid(32 位字母数字字符串),节点将被移动到此文件夹下。", "property": "targetFolderId", "required": false, "type": "string" }, "node": { "description": "文档/文件 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档/文件 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要移动的节点标识,支持以下格式:\\n1. 文档/文件夹 URL,如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}\\n2. dentryUuid(32 位字母数字字符串)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档/文件 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要移动的节点标识,支持以下格式:\\n1. 文档/文件夹 URL,如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}\\n2. dentryUuid(32 位字母数字字符串)", "property": "nodeId", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标知识库 ID" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标知识库的标识,支持两种格式:1) 知识库 ID(纯字符串);2) 知识库 URL,如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview,系统自动提取其中的 workspaceId。当 targetFolderId 不传时,移动到该知识库的根目录下。如果同时传了 targetFolderId,则以 targetFolderId 为准。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标知识库 ID" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "workspaceId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "workspaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标知识库的标识,支持两种格式:1) 知识库 ID(纯字符串);2) 知识库 URL,如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview,系统自动提取其中的 workspaceId。当 targetFolderId 不传时,移动到该知识库的根目录下。如果同时传了 targetFolderId,则以 targetFolderId 为准。", "property": "workspaceId", "required": false, "type": "string" } }, "path": "drive.move_document", "primary_cli_path": "drive move", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "移动文件/文档到指定位置", "use_when": [ "用户要移动/搬走文件或文档到新位置,且原位置不再保留时(move≠copy)", "目标文件夹用 --folder;目标知识库根用 --workspace;都不传则默认「我的文档」", "移动到其他钉盘 space 根目录时传目标 space 的 rootFolderId 到 --folder(通常不传 --workspace)" ] }, "drive.permission_remove": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.permission_remove", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive permission remove", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "internal/cli/schema_mcp_metadata.json#tools.drive.permission_remove", "live-mcp:dws schema doc.remove_permission", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json", "structured-hint:internal/cli/schema_hints/selection-review.json#drive.permission_remove" ], "agent_summary": "从文档空间节点移除协作成员的权限", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "要改角色用 permission update;要加权限用 add", "移除知识库容器成员用 dws wiki member remove" ], "canonical_path": "drive.permission_remove", "cli_name": "remove", "cli_path": "drive permission remove", "confirmation": "not_required", "description": "从文档空间节点移除协作成员的权限。", "display": "钉盘文件管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws drive permission remove --node \u003cID\u003e --users uid1 --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "从文档空间节点移除协作成员的权限" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "从文档空间节点移除协作成员的权限" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.permission_remove.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要改角色用 permission update;要加权限用 add", "移除知识库容器成员用 dws wiki member remove" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要改角色用 permission update;要加权限用 add", "移除知识库容器成员用 dws wiki member remove" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive permission remove", "value": "drive.permission_remove" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive permission remove", "value": "drive.permission_remove" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, { "precedence": "inference_or_default", "selected": false, "source": "risk-default", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "从文档空间节点移除协作成员的权限。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "从知识库节点移除指定企业用户的权限(仅支持 USER 类型)。\r\n\r\n通过传入 userIds 列表批量移除成员在节点上的权限,移除后相关用户将无法通过该节点的直接授权访问内容(若有父节点继承权限则仍可通过继承权限访问)。\r\n\r\n注意事项:\r\n- OWNER 角色不可通过此接口移除。\r\n- **权限要求(业务规则)**:操作者必须在该节点上具备「可编辑(EDITOR)」及以上角色(OWNER / MANAGER / EDITOR)。DOWNLOADER / READER / 非成员调用会返回 `forbidden.accessDenied`,错误信息会明确提示所需的最低角色。\r\n- 单次请求 `userIds` 列表最多传 30 个,超出需分批调用。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "从文档空间节点移除协作成员的权限。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, { "precedence": "inference_or_default", "selected": false, "source": "command-verb", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive permission remove --node \u003cID\u003e --users uid1 --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive permission remove --node \u003cID\u003e --users uid1 --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.permission_remove.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": { "product_id": "doc", "rpc_name": "remove_permission" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.permission_remove.interface_ref", "value": "doc.remove_permission" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": { "product_id": "doc", "rpc_name": "remove_permission" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "移除协作者权限" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "移除节点成员权限" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "移除协作者权限" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "从节点移除指定用户的直接授权时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "从节点移除指定用户的直接授权时" ] } }, "group": "permission", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "remove_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "permission_remove", "parameter_count": 3, "parameters": { "node": { "description": "目标节点 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标节点 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标节点的 nodeId(文档、文件夹或文件),可通过 list_nodes 工具获取。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标节点 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标节点的 nodeId(文档、文件夹或文件),可通过 list_nodes 工具获取。", "property": "nodeId", "required": true, "type": "string" }, "users": { "description": "用户 userId 列表,逗号分隔 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户 userId 列表,逗号分隔 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要移除权限的用户 userId 列表(钉钉 staffId / 外部 userId 格式),至少包含一个 userId,单次最多 30 个。当前 Agent 写操作仅支持移除企业用户权限,故入参直接以扁平的 userId 列表呈现。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户 userId 列表,逗号分隔 (必填)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "userIds" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "users" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "userIds" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要移除权限的用户 userId 列表(钉钉 staffId / 外部 userId 格式),至少包含一个 userId,单次最多 30 个。当前 Agent 写操作仅支持移除企业用户权限,故入参直接以扁平的 userId 列表呈现。", "interface_type": "array", "property": "userIds", "required": true, "type": "string" }, "workspace": { "description": "知识库 ID (选填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "知识库 ID (选填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标知识库的标识,选填。仅用于辅助构造返回的 docUrl,业务实际依赖 nodeId 定位节点;支持两种格式:1) 知识库 ID(纯字符串);2) 知识库 URL,如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview,系统自动提取其中的 workspaceId。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "知识库 ID (选填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "workspaceId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "workspaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标知识库的标识,选填。仅用于辅助构造返回的 docUrl,业务实际依赖 nodeId 定位节点;支持两种格式:1) 知识库 ID(纯字符串);2) 知识库 URL,如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview,系统自动提取其中的 workspaceId。", "property": "workspaceId", "required": false, "type": "string" } }, "path": "drive.permission_remove", "primary_cli_path": "drive permission remove", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "移除协作者权限", "use_when": [ "从节点移除指定用户的直接授权时" ] }, "drive.permission_update": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.permission_update", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive permission update", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "internal/cli/schema_mcp_metadata.json#tools.drive.permission_update", "live-mcp:dws schema doc.update_permission", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json", "structured-hint:internal/cli/schema_hints/selection-review.json#drive.permission_update" ], "agent_summary": "更新文档空间节点已有协作者的权限角色", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "成员尚无权限时改用 permission add", "要移除访问改用 permission remove" ], "canonical_path": "drive.permission_update", "cli_name": "update", "cli_path": "drive permission update", "confirmation": "not_required", "description": "更新文档空间节点已有协作者的权限角色。\n\n支持的角色 (--role): MANAGER / EDITOR / DOWNLOADER / READER", "display": "钉盘文件管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws drive permission update --node \u003cID\u003e --users uid1 --role EDITOR --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "更新文档空间节点已有协作者的权限角色" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "更新文档空间节点已有协作者的权限角色" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.permission_update.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "成员尚无权限时改用 permission add", "要移除访问改用 permission remove" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "成员尚无权限时改用 permission add", "要移除访问改用 permission remove" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive permission update", "value": "drive.permission_update" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive permission update", "value": "drive.permission_update" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新文档空间节点已有协作者的权限角色。\n\n支持的角色 (--role): MANAGER / EDITOR / DOWNLOADER / READER" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "修改企业用户在知识库节点上的角色(仅支持 USER 类型)。\r\n\r\n通过传入 userIds 列表批量调整成员角色,同一成员在同一节点只能拥有一个角色,变更后旧角色自动替换。\r\n\r\n注意事项:\r\n- OWNER 角色不可通过此接口变更。\r\n- 若成员的角色来自父节点的权限继承(PASS_ON 模式),且继承的角色高于目标角色,接口会拒绝操作。\r\n- **权限要求(业务规则)**:操作者必须在该节点上具备「可编辑(EDITOR)」及以上角色(OWNER / MANAGER / EDITOR)。\r\n- 单次请求 `userIds` 列表最多传 30 个,超出需分批调用。\r\n- 入参直接采用扁平的 `userIds: List\u003cString\u003e`,每个元素为钉钉 staffId(外部 userId 格式,由钉钉开放平台体系下颁发)。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新文档空间节点已有协作者的权限角色。\n\n支持的角色 (--role): MANAGER / EDITOR / DOWNLOADER / READER" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive permission update --node \u003cID\u003e --users uid1 --role EDITOR --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive permission update --node \u003cID\u003e --users uid1 --role EDITOR --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.permission_update.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": { "product_id": "doc", "rpc_name": "update_permission" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.permission_update.interface_ref", "value": "doc.update_permission" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": { "product_id": "doc", "rpc_name": "update_permission" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新协作者权限" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "变更节点成员角色" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新协作者权限" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "调整已有节点成员角色(如 READER→EDITOR)时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "调整已有节点成员角色(如 READER→EDITOR)时" ] } }, "group": "permission", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "update_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "permission_update", "parameter_count": 4, "parameters": { "node": { "description": "目标节点 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标节点 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标节点的 nodeId。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标节点 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标节点的 nodeId。", "property": "nodeId", "required": true, "type": "string" }, "role": { "description": "新角色: MANAGER / EDITOR / DOWNLOADER / READER (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "新角色: MANAGER / EDITOR / DOWNLOADER / READER (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "变更后的角色,取值:MANAGER、EDITOR、DOWNLOADER、READER。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "新角色: MANAGER / EDITOR / DOWNLOADER / READER (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "roleId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "role" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "roleId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "变更后的角色,取值:MANAGER、EDITOR、DOWNLOADER、READER。", "property": "roleId", "required": true, "type": "string" }, "users": { "description": "用户 userId 列表,逗号分隔 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "用户 userId 列表,逗号分隔 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要变更角色的用户 userId 列表(钉钉 staffId / 外部 userId 格式,由钉钉开放平台体系下颁发;通常为数字字符串),至少包含一个 userId,单次最多 30 个。如果你只有 unionId,请先调用钉钉开放平台「根据 unionId 获取 userId」接口换取 userId。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "用户 userId 列表,逗号分隔 (必填)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "userIds" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "users" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "userIds" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要变更角色的用户 userId 列表(钉钉 staffId / 外部 userId 格式,由钉钉开放平台体系下颁发;通常为数字字符串),至少包含一个 userId,单次最多 30 个。如果你只有 unionId,请先调用钉钉开放平台「根据 unionId 获取 userId」接口换取 userId。", "interface_type": "array", "property": "userIds", "required": true, "type": "string" }, "workspace": { "description": "知识库 ID (选填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "知识库 ID (选填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标知识库的标识,选填。仅用于辅助构造返回的 docUrl,业务实际依赖 nodeId 定位节点;支持两种格式:1) 知识库 ID(纯字符串);2) 知识库 URL,如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview,系统自动提取其中的 workspaceId。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "知识库 ID (选填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "workspaceId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "workspaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标知识库的标识,选填。仅用于辅助构造返回的 docUrl,业务实际依赖 nodeId 定位节点;支持两种格式:1) 知识库 ID(纯字符串);2) 知识库 URL,如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview,系统自动提取其中的 workspaceId。", "property": "workspaceId", "required": false, "type": "string" } }, "path": "drive.permission_update", "primary_cli_path": "drive permission update", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "更新协作者权限", "use_when": [ "调整已有节点成员角色(如 READER→EDITOR)时" ] }, "drive.publish_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.publish_get", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive publish get", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "live-mcp:none (Cobra+Skill; composite/unpinned)", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json" ], "agent_summary": "查询文件当前是否处于互联网公开发布状态", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "要开启公开改用 dws drive publish set(需确认)", "要关闭公开改用 dws drive publish unset(需确认)" ], "canonical_path": "drive.publish_get", "cli_name": "get", "cli_path": "drive publish get", "confirmation": "not_required", "description": "查询文件当前是否处于互联网公开发布状态,以及公开发布的权限设置。", "display": "钉盘文件管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws drive publish get --node \u003cfileId\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "查询文件当前是否处于互联网公开发布状态" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "查询文件当前是否处于互联网公开发布状态" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要开启公开改用 dws drive publish set(需确认)", "要关闭公开改用 dws drive publish unset(需确认)" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要开启公开改用 dws drive publish set(需确认)", "要关闭公开改用 dws drive publish unset(需确认)" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive publish get", "value": "drive.publish_get" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive publish get", "value": "drive.publish_get" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, { "precedence": "inference_or_default", "selected": false, "source": "risk-default", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查询文件当前是否处于互联网公开发布状态,以及公开发布的权限设置。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查询文件当前是否处于互联网公开发布状态,以及公开发布的权限设置。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, { "precedence": "inference_or_default", "selected": false, "source": "command-verb", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive publish get --node \u003cfileId\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive publish get --node \u003cfileId\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "unknown" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "unknown" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查询文件公开发布状态" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查询文件公开发布状态" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "查询文件是否已互联网公开发布及公开权限(READER/DOWNLOADER/EDITOR)时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "查询文件是否已互联网公开发布及公开权限(READER/DOWNLOADER/EDITOR)时" ] } }, "group": "publish", "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "publish_get", "parameter_count": 1, "parameters": { "node": { "description": "目标文件 ID (dentryUuid) 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文件 ID (dentryUuid) 或 URL (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文件 ID (dentryUuid) 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.publish_get has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.publish_get has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" } }, "path": "drive.publish_get", "primary_cli_path": "drive publish get", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "查询文件公开发布状态", "use_when": [ "查询文件是否已互联网公开发布及公开权限(READER/DOWNLOADER/EDITOR)时" ] }, "drive.publish_set": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.publish_set", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive publish set", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "live-mcp:none (Cobra+Skill; composite/unpinned)", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json" ], "agent_summary": "开启文件的互联网公开发布", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "只查公开状态用 publish get;要关闭公开用 publish unset", "目标文件或公开权限范围未确认时不要开启", "只要企业内部同事权限用 permission add,不要用互联网公开" ], "canonical_path": "drive.publish_set", "cli_name": "set", "cli_path": "drive publish set", "confirmation": "user_required", "description": "[危险] 将文件设置为互联网公开发布。公开后任何人通过链接即可访问,无需登录钉钉。\n操作者需要是该文件的管理员或拥有者。执行前需要确认,或传入 --yes 跳过确认。\n\n公开权限 (--permission): READER(仅可查看) / DOWNLOADER(可查看和下载,默认) / EDITOR(可编辑)", "display": "钉盘文件管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws drive publish set --node \u003cfileId\u003e --format json", "dws drive publish set --node \u003cfileId\u003e --permission READER --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "开启文件的互联网公开发布" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "开启文件的互联网公开发布" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "只查公开状态用 publish get;要关闭公开用 publish unset", "目标文件或公开权限范围未确认时不要开启", "只要企业内部同事权限用 permission add,不要用互联网公开" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "只查公开状态用 publish get;要关闭公开用 publish unset", "目标文件或公开权限范围未确认时不要开启", "只要企业内部同事权限用 permission add,不要用互联网公开" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive publish set", "value": "drive.publish_set" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive publish set", "value": "drive.publish_set" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "user_required" }, { "precedence": "inference_or_default", "selected": false, "source": "risk-default", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "user_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "[危险] 将文件设置为互联网公开发布。公开后任何人通过链接即可访问,无需登录钉钉。\n操作者需要是该文件的管理员或拥有者。执行前需要确认,或传入 --yes 跳过确认。\n\n公开权限 (--permission): READER(仅可查看) / DOWNLOADER(可查看和下载,默认) / EDITOR(可编辑)" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "[危险] 将文件设置为互联网公开发布。公开后任何人通过链接即可访问,无需登录钉钉。\n操作者需要是该文件的管理员或拥有者。执行前需要确认,或传入 --yes 跳过确认。\n\n公开权限 (--permission): READER(仅可查看) / DOWNLOADER(可查看和下载,默认) / EDITOR(可编辑)" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, { "precedence": "inference_or_default", "selected": false, "source": "command-verb", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive publish set --node \u003cfileId\u003e --format json", "dws drive publish set --node \u003cfileId\u003e --permission READER --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive publish set --node \u003cfileId\u003e --format json", "dws drive publish set --node \u003cfileId\u003e --permission READER --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "unknown" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "unknown" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "[危险] 设置文件为互联网公开" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "[危险] 设置文件为互联网公开" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户明确要求将文件设为互联网公开(任何人凭链接可访问,无需登录)时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户明确要求将文件设为互联网公开(任何人凭链接可访问,无需登录)时" ] } }, "group": "publish", "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "publish_set", "parameter_count": 2, "parameters": { "node": { "description": "目标文件 ID (dentryUuid) 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文件 ID (dentryUuid) 或 URL (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文件 ID (dentryUuid) 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.publish_set has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.publish_set has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" }, "permission": { "description": "公开后的权限: READER / DOWNLOADER(默认) / EDITOR", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "公开后的权限: READER / DOWNLOADER(默认) / EDITOR" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "公开后的权限: READER / DOWNLOADER(默认) / EDITOR" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.publish_set has no singular pinned interface_ref; --permission is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "permission" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.publish_set has no singular pinned interface_ref; --permission is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" } }, "path": "drive.publish_set", "primary_cli_path": "drive publish set", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "[危险] 设置文件为互联网公开", "use_when": [ "用户明确要求将文件设为互联网公开(任何人凭链接可访问,无需登录)时" ] }, "drive.publish_unset": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.publish_unset", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive publish unset", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "live-mcp:none (Cobra+Skill; composite/unpinned)", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json" ], "agent_summary": "关闭文件的互联网公开发布", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "只查状态用 publish get;要开启用 publish set", "目标文件未确认时不要关闭" ], "canonical_path": "drive.publish_unset", "cli_name": "unset", "cli_path": "drive publish unset", "confirmation": "user_required", "description": "[危险] 关闭文件的互联网公开发布。关闭后外部用户将无法再通过链接访问。执行前需要确认,或传入 --yes 跳过确认。", "display": "钉盘文件管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws drive publish unset --node \u003cfileId\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "关闭文件的互联网公开发布" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "关闭文件的互联网公开发布" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "只查状态用 publish get;要开启用 publish set", "目标文件未确认时不要关闭" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "只查状态用 publish get;要开启用 publish set", "目标文件未确认时不要关闭" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive publish unset", "value": "drive.publish_unset" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive publish unset", "value": "drive.publish_unset" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "user_required" }, { "precedence": "inference_or_default", "selected": false, "source": "risk-default", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "user_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "[危险] 关闭文件的互联网公开发布。关闭后外部用户将无法再通过链接访问。执行前需要确认,或传入 --yes 跳过确认。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "[危险] 关闭文件的互联网公开发布。关闭后外部用户将无法再通过链接访问。执行前需要确认,或传入 --yes 跳过确认。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, { "precedence": "inference_or_default", "selected": false, "source": "command-verb", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive publish unset --node \u003cfileId\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive publish unset --node \u003cfileId\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "unknown" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "unknown" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "[危险] 关闭文件互联网公开" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "[危险] 关闭文件互联网公开" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户明确要求关闭文件的互联网公开发布,使外部链接失效时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户明确要求关闭文件的互联网公开发布,使外部链接失效时" ] } }, "group": "publish", "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "publish_unset", "parameter_count": 1, "parameters": { "node": { "description": "目标文件 ID (dentryUuid) 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文件 ID (dentryUuid) 或 URL (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文件 ID (dentryUuid) 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.publish_unset has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.publish_unset has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" } }, "path": "drive.publish_unset", "primary_cli_path": "drive publish unset", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "[危险] 关闭文件互联网公开", "use_when": [ "用户明确要求关闭文件的互联网公开发布,使外部链接失效时" ] }, "drive.query_permission_apply_info": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.query_permission_apply_info", "cobra-help:dws drive permission apply-info", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "wukong-develop:wukong/products" ], "agent_summary": "查询节点可申请的权限角色列表与审批人列表", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "实际发起申请用 apply_permission" ], "canonical_path": "drive.query_permission_apply_info", "cli_name": "apply-info", "cli_path": "drive permission apply-info", "confirmation": "not_required", "description": "查询节点可申请的角色与审批人", "display": "钉盘文件管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws drive permission apply-info --node \u003cDOC_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "查询节点可申请的权限角色列表与审批人列表" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "查询节点可申请的权限角色列表与审批人列表" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "实际发起申请用 apply_permission" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "实际发起申请用 apply_permission" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive permission apply-info", "value": "drive.query_permission_apply_info" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive permission apply-info", "value": "drive.query_permission_apply_info" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查询节点可申请的角色与审批人" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查询节点可申请的角色与审批人" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive permission apply-info --node \u003cDOC_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive permission apply-info --node \u003cDOC_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查询节点可申请的角色与审批人" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查询节点可申请的角色与审批人" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "无权限访问文档时,先查可申请角色与审批人" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "无权限访问文档时,先查可申请角色与审批人" ] } }, "group": "permission", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "query_permission_apply_info", "parameter_count": 1, "parameters": { "node": { "description": "目标节点 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标节点 ID 或 URL (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标节点 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.query_permission_apply_info has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.query_permission_apply_info has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" } }, "path": "drive.query_permission_apply_info", "primary_cli_path": "drive permission apply-info", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "查询节点可申请的角色与审批人", "use_when": [ "无权限访问文档时,先查可申请角色与审批人" ] }, "drive.recent": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.recent", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive recent", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "live-mcp:dws schema doc.get_recent_list", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json" ], "agent_summary": "获取当前用户最近访问或编辑过的文档列表", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "按关键词全局搜文件改用 dws drive search", "浏览某目录内容改用 dws drive list" ], "canonical_path": "drive.recent", "cli_name": "recent", "cli_path": "drive recent", "confirmation": "not_required", "description": "获取当前用户最近访问或编辑过的文档列表。\n\n支持按文档类型、操作类型、创建人、所属组织过滤。所有过滤条件均为可选,不传则不过滤。\n\n操作类型 (--operate-type):\n 0 最近访问(含打开+编辑)(默认)\n 1 最近编辑\n 不传默认仅返回最近访问(0)\n\n创建人类型 (--creator-type):\n 0 全部 (默认)\n 1 我创建的\n 2 他人创建的", "display": "钉盘文件管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws drive recent --format json", "dws drive recent --operate-type 1 --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "获取当前用户最近访问或编辑过的文档列表" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "获取当前用户最近访问或编辑过的文档列表" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "按关键词全局搜文件改用 dws drive search", "浏览某目录内容改用 dws drive list" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "按关键词全局搜文件改用 dws drive search", "浏览某目录内容改用 dws drive list" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive recent", "value": "drive.recent" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive recent", "value": "drive.recent" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取当前用户最近访问或编辑过的文档列表。\n\n支持按文档类型、操作类型、创建人、所属组织过滤。所有过滤条件均为可选,不传则不过滤。\n\n操作类型 (--operate-type):\n 0 最近访问(含打开+编辑)(默认)\n 1 最近编辑\n 不传默认仅返回最近访问(0)\n\n创建人类型 (--creator-type):\n 0 全部 (默认)\n 1 我创建的\n 2 他人创建的" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取当前用户最近访问或编辑过的文档列表。\n\n支持按文档类型、操作类型、创建人、所属组织过滤。所有过滤条件均为可选,不传则不过滤。\n\n操作类型 (--operate-type):\n 0 最近访问(含打开+编辑)(默认)\n 1 最近编辑\n 不传默认仅返回最近访问(0)\n\n创建人类型 (--creator-type):\n 0 全部 (默认)\n 1 我创建的\n 2 他人创建的" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive recent --format json", "dws drive recent --operate-type 1 --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive recent --format json", "dws drive recent --operate-type 1 --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取最近访问/编辑的文档列表" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取最近访问/编辑的文档列表" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要看最近访问或最近编辑的文档列表时(默认最近访问 operate-type=0)", "需要按我创建/他人创建或文档类型过滤最近项时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要看最近访问或最近编辑的文档列表时(默认最近访问 operate-type=0)", "需要按我创建/他人创建或文档类型过滤最近项时" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "recent", "parameter_count": 6, "parameters": { "creator-type": { "description": "按创建人过滤: 0=全部, 1=我创建, 2=他人创建", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按创建人过滤: 0=全部, 1=我创建, 2=他人创建" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按创建人过滤: 0=全部, 1=我创建, 2=他人创建" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.recent has no singular pinned interface_ref; --creator-type is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "creatorType" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.recent has no singular pinned interface_ref; --creator-type is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "required": false, "type": "integer" }, "cursor": { "description": "分页游标 (从上次结果的 nextCursor 获取)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标 (从上次结果的 nextCursor 获取)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标 (从上次结果的 nextCursor 获取)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.recent has no singular pinned interface_ref; --cursor is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.recent has no singular pinned interface_ref; --cursor is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "file-types": { "description": "按文档类型过滤,逗号分隔 (参考 RecentAccessType 枚举)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按文档类型过滤,逗号分隔 (参考 RecentAccessType 枚举)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按文档类型过滤,逗号分隔 (参考 RecentAccessType 枚举)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.recent has no singular pinned interface_ref; --file-types is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "fileTypes" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.recent has no singular pinned interface_ref; --file-types is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "required": false, "type": "array" }, "limit": { "description": "每页数量 (默认 20,最大 20)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页数量 (默认 20,最大 20)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页数量 (默认 20,最大 20)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.recent has no singular pinned interface_ref; --limit is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.recent has no singular pinned interface_ref; --limit is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "required": false, "type": "integer" }, "operate-type": { "description": "按操作类型过滤: 0=最近访问(默认), 1=最近编辑; 不传默认仅最近访问", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按操作类型过滤: 0=最近访问(默认), 1=最近编辑; 不传默认仅最近访问" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按操作类型过滤: 0=最近访问(默认), 1=最近编辑; 不传默认仅最近访问" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.recent has no singular pinned interface_ref; --operate-type is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "operateType" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.recent has no singular pinned interface_ref; --operate-type is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "required": false, "type": "array" }, "org-ids": { "description": "按资源所属组织 ID 过滤,逗号分隔", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按资源所属组织 ID 过滤,逗号分隔" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按资源所属组织 ID 过滤,逗号分隔" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.recent has no singular pinned interface_ref; --org-ids is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "orgIds" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.recent has no singular pinned interface_ref; --org-ids is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "required": false, "type": "array" } }, "path": "drive.recent", "primary_cli_path": "drive recent", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "获取最近访问/编辑的文档列表", "use_when": [ "用户要看最近访问或最近编辑的文档列表时(默认最近访问 operate-type=0)", "需要按我创建/他人创建或文档类型过滤最近项时" ] }, "drive.recycle_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.recycle_list", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive recycle list", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "live-mcp:none (Cobra+Skill; composite/unpinned)", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json" ], "agent_summary": "查看回收站文件列表", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "要从回收站还原改用 dws drive recycle restore", "要删除进回收站改用 dws drive delete" ], "canonical_path": "drive.recycle_list", "cli_name": "list", "cli_path": "drive recycle list", "confirmation": "not_required", "description": "查看回收站文件列表", "display": "钉盘文件管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws drive recycle list --format json", "dws drive recycle list --space-id 12345 --limit 10 --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "查看回收站文件列表" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "查看回收站文件列表" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要从回收站还原改用 dws drive recycle restore", "要删除进回收站改用 dws drive delete" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要从回收站还原改用 dws drive recycle restore", "要删除进回收站改用 dws drive delete" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive recycle list", "value": "drive.recycle_list" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive recycle list", "value": "drive.recycle_list" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, { "precedence": "inference_or_default", "selected": false, "source": "risk-default", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查看回收站文件列表" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查看回收站文件列表" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" }, { "precedence": "inference_or_default", "selected": false, "source": "command-verb", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive recycle list --format json", "dws drive recycle list --space-id 12345 --limit 10 --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive recycle list --format json", "dws drive recycle list --space-id 12345 --limit 10 --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查看回收站文件列表" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查看回收站文件列表" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要查看钉盘回收站里有哪些已删文件时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要查看钉盘回收站里有哪些已删文件时" ] } }, "group": "recycle", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "recycle_list", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.recycle_list has no singular pinned interface_ref; --cursor is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.recycle_list has no singular pinned interface_ref; --cursor is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "limit": { "description": "返回条数上限 (默认20,最大50)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "返回条数上限 (默认20,最大50)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "返回条数上限 (默认20,最大50)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.recycle_list has no singular pinned interface_ref; --limit is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.recycle_list has no singular pinned interface_ref; --limit is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "required": false, "type": "integer" }, "space-id": { "description": "钉盘空间 ID (选填,不传则返回所有空间)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "钉盘空间 ID (选填,不传则返回所有空间)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "钉盘空间 ID (选填,不传则返回所有空间)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.recycle_list has no singular pinned interface_ref; --space-id is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "spaceId" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.recycle_list has no singular pinned interface_ref; --space-id is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" } }, "path": "drive.recycle_list", "primary_cli_path": "drive recycle list", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "查看回收站文件列表", "use_when": [ "用户要查看钉盘回收站里有哪些已删文件时" ] }, "drive.recycle_restore": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.recycle_restore", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive recycle restore", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "live-mcp:none (Cobra+Skill; composite/unpinned)", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json" ], "agent_summary": "还原回收站中的文件", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "尚未确认还原哪一项时先 dws drive recycle list", "要删除文件改用 dws drive delete,不要用 restore" ], "canonical_path": "drive.recycle_restore", "cli_name": "restore", "cli_path": "drive recycle restore", "confirmation": "not_required", "description": "还原回收站中的文件", "display": "钉盘文件管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws drive recycle restore --id \u003crecycleItemId\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "还原回收站中的文件" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "还原回收站中的文件" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "尚未确认还原哪一项时先 dws drive recycle list", "要删除文件改用 dws drive delete,不要用 restore" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "尚未确认还原哪一项时先 dws drive recycle list", "要删除文件改用 dws drive delete,不要用 restore" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive recycle restore", "value": "drive.recycle_restore" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive recycle restore", "value": "drive.recycle_restore" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "还原回收站中的文件" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "还原回收站中的文件" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive recycle restore --id \u003crecycleItemId\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive recycle restore --id \u003crecycleItemId\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "unknown" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "还原回收站中的文件" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "还原回收站中的文件" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要从回收站还原指定回收项(已从 recycle list 拿到 id)时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要从回收站还原指定回收项(已从 recycle list 拿到 id)时" ] } }, "group": "recycle", "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "recycle_restore", "parameter_count": 1, "parameters": { "id": { "description": "回收项 ID (必填,从 recycle list 获取)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "回收项 ID (必填,从 recycle list 获取)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "回收项 ID (必填,从 recycle list 获取)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.recycle_restore has no singular pinned interface_ref; --id is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "id" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.recycle_restore has no singular pinned interface_ref; --id is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" } }, "path": "drive.recycle_restore", "primary_cli_path": "drive recycle restore", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "还原回收站中的文件", "use_when": [ "用户要从回收站还原指定回收项(已从 recycle list 拿到 id)时" ] }, "drive.rename_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.rename_document", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive rename", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "internal/cli/schema_mcp_metadata.json#tools.drive.rename_document", "live-mcp:dws schema doc.rename_document", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json", "structured-hint:internal/cli/schema_hints/selection-review.json#drive.rename_document" ], "agent_summary": "安全重命名文档空间中的文档、文件或文件夹,并按节点真实扩展名避免双后缀", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "要改正文里的标题/章节 H1 改用 dws doc block update,不要用 rename", "只要复制或移动改用 copy/move", "dry-run 不读取节点元数据,输出名称尚未做基于当前扩展名的规范化" ], "canonical_path": "drive.rename_document", "cli_name": "rename", "cli_path": "drive rename", "confirmation": "not_required", "description": "修改文档空间中文档、文件或文件夹的名称。\n实际执行前会读取节点类型和当前扩展名:文件的新名称仅在末尾扩展名与当前扩展名一致时去掉一层,\n避免 report.txt.txt;文件夹和扩展名不匹配的名称保持不变。dry-run 不读取远端元数据,因此保留输入名称。\n\n权限要求: 对文档有\"编辑\"权限。", "display": "钉盘文件管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws drive rename --node \u003cID\u003e --name \"新名称\" --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "安全重命名文档空间中的文档、文件或文件夹,并按节点真实扩展名避免双后缀" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "安全重命名文档空间中的文档、文件或文件夹,并按节点真实扩展名避免双后缀" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed CLI reads node metadata before mutation and strips only the exact current extension for non-folder nodes, avoiding both duplicate extensions and dotted-folder corruption without a suffix whitelist.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.rename_document.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed CLI reads node metadata before mutation and strips only the exact current extension for non-folder nodes, avoiding both duplicate extensions and dotted-folder corruption without a suffix whitelist.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要改正文里的标题/章节 H1 改用 dws doc block update,不要用 rename", "只要复制或移动改用 copy/move", "dry-run 不读取节点元数据,输出名称尚未做基于当前扩展名的规范化" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "要改正文里的标题/章节 H1 改用 dws doc block update,不要用 rename", "只要复制或移动改用 copy/move", "dry-run 不读取节点元数据,输出名称尚未做基于当前扩展名的规范化" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive rename", "value": "drive.rename_document" }, { "precedence": "reviewed_manual", "review_reason": "The reviewed CLI reads node metadata before mutation and strips only the exact current extension for non-folder nodes, avoiding both duplicate extensions and dotted-folder corruption without a suffix whitelist.", "selected": false, "source": "reviewed_manual_hint", "source_ref": "drive rename", "value": "drive.rename_document" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive rename", "value": "drive.rename_document" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "修改文档空间中文档、文件或文件夹的名称。\n实际执行前会读取节点类型和当前扩展名:文件的新名称仅在末尾扩展名与当前扩展名一致时去掉一层,\n避免 report.txt.txt;文件夹和扩展名不匹配的名称保持不变。dry-run 不读取远端元数据,因此保留输入名称。\n\n权限要求: 对文档有\"编辑\"权限。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "对指定节点进行重命名。\r\n\r\n支持范围:\r\n- 知识库(workspace)下的文档节点、文件夹节点\r\n\r\n权限要求:\r\n- 对目标节点有编辑权限" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "修改文档空间中文档、文件或文件夹的名称。\n实际执行前会读取节点类型和当前扩展名:文件的新名称仅在末尾扩展名与当前扩展名一致时去掉一层,\n避免 report.txt.txt;文件夹和扩展名不匹配的名称保持不变。dry-run 不读取远端元数据,因此保留输入名称。\n\n权限要求: 对文档有\"编辑\"权限。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive rename --node \u003cID\u003e --name \"新名称\" --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive rename --node \u003cID\u003e --name \"新名称\" --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed CLI reads node metadata before mutation and strips only the exact current extension for non-folder nodes, avoiding both duplicate extensions and dotted-folder corruption without a suffix whitelist.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.rename_document.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed CLI reads node metadata before mutation and strips only the exact current extension for non-folder nodes, avoiding both duplicate extensions and dotted-folder corruption without a suffix whitelist.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed CLI reads node metadata before mutation and strips only the exact current extension for non-folder nodes, avoiding both duplicate extensions and dotted-folder corruption without a suffix whitelist.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": { "product_id": "doc", "rpc_name": "rename_document" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.rename_document.interface_ref", "value": "doc.rename_document" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed CLI reads node metadata before mutation and strips only the exact current extension for non-folder nodes, avoiding both duplicate extensions and dotted-folder corruption without a suffix whitelist.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": { "product_id": "doc", "rpc_name": "rename_document" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed CLI reads node metadata before mutation and strips only the exact current extension for non-folder nodes, avoiding both duplicate extensions and dotted-folder corruption without a suffix whitelist.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed CLI reads node metadata before mutation and strips only the exact current extension for non-folder nodes, avoiding both duplicate extensions and dotted-folder corruption without a suffix whitelist.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "重命名文件/文档" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "对指定节点进行重命名" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "重命名文件/文档" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要重命名钉盘/文档空间中的文件、文档或文件夹时;实际执行会读取节点类型和当前扩展名,仅去掉完全匹配的一层后缀" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要重命名钉盘/文档空间中的文件、文档或文件夹时;实际执行会读取节点类型和当前扩展名,仅去掉完全匹配的一层后缀" ] } }, "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "rename_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "rename_document", "parameter_count": 2, "parameters": { "name": { "description": "新显示名称;实际执行前读取节点类型与当前扩展名,仅对非文件夹且末尾后缀与当前扩展名一致的名称去掉一层,避免双扩展名", "field_provenance": { "description": { "candidates": [ { "precedence": "reviewed_manual", "review_reason": "The reviewed CLI reads node metadata before mutation and strips only the exact current extension for non-folder nodes, avoiding both duplicate extensions and dotted-folder corruption without a suffix whitelist.", "selected": true, "source": "reviewed_manual_hint", "value": "新显示名称;实际执行前读取节点类型与当前扩展名,仅对非文件夹且末尾后缀与当前扩展名一致的名称去掉一层,避免双扩展名" }, { "precedence": "cobra_contract", "selected": false, "source": "cobra_usage", "value": "新名称 (必填;实际执行时仅去掉与节点当前扩展名完全匹配的一层后缀)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "重命名后的新名称,不能为空,长度不超过 255 个字符。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "reviewed_manual", "resolution": "highest_precedence", "review_reason": "The reviewed CLI reads node metadata before mutation and strips only the exact current extension for non-folder nodes, avoiding both duplicate extensions and dotted-folder corruption without a suffix whitelist.", "source": "reviewed_manual_hint", "value": "新显示名称;实际执行前读取节点类型与当前扩展名,仅对非文件夹且末尾后缀与当前扩展名一致的名称去掉一层,避免双扩展名" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "newName" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "name" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "newName" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "重命名后的新名称,不能为空,长度不超过 255 个字符。", "property": "newName", "required": true, "type": "string" }, "node": { "description": "文档/文件 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档/文件 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要重命名的节点标识,支持以下格式:1) 文档/文件夹 URL,如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid};2) dentryUuid(32 位字母数字字符串)。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档/文件 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要重命名的节点标识,支持以下格式:1) 文档/文件夹 URL,如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid};2) dentryUuid(32 位字母数字字符串)。", "property": "nodeId", "required": true, "type": "string" } }, "path": "drive.rename_document", "primary_cli_path": "drive rename", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "重命名文件/文档", "use_when": [ "用户要重命名钉盘/文档空间中的文件、文档或文件夹时;实际执行会读取节点类型和当前扩展名,仅去掉完全匹配的一层后缀" ] }, "drive.revert_file_version": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.revert_file_version", "cobra-help:dws drive revert", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "wukong-develop:wukong/products" ], "agent_summary": "回滚普通文件到指定历史版本(生成新最新版本,历史不丢失)", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "在线文档回滚用 doc version revert;在线表格用 sheet version revert" ], "canonical_path": "drive.revert_file_version", "cli_name": "revert", "cli_path": "drive revert", "confirmation": "user_required", "description": "将指定文件回滚到某个历史版本。仅支持普通文件(Word、Excel、PDF、图片等)。\n在线文档请用 dws doc version revert,在线表格请用 dws sheet version revert。", "display": "钉盘文件管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws drive revert --node \u003cdentryUuid\u003e --version 3 --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "回滚普通文件到指定历史版本(生成新最新版本,历史不丢失)" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "回滚普通文件到指定历史版本(生成新最新版本,历史不丢失)" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "在线文档回滚用 doc version revert;在线表格用 sheet version revert" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "在线文档回滚用 doc version revert;在线表格用 sheet version revert" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive revert", "value": "drive.revert_file_version" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive revert", "value": "drive.revert_file_version" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "user_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "user_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "将指定文件回滚到某个历史版本。仅支持普通文件(Word、Excel、PDF、图片等)。\n在线文档请用 dws doc version revert,在线表格请用 dws sheet version revert。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "将指定文件回滚到某个历史版本。仅支持普通文件(Word、Excel、PDF、图片等)。\n在线文档请用 dws doc version revert,在线表格请用 dws sheet version revert。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive revert --node \u003cdentryUuid\u003e --version 3 --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive revert --node \u003cdentryUuid\u003e --version 3 --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "non_idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "non_idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "[危险] 回滚文件到指定历史版本" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "[危险] 回滚文件到指定历史版本" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户说 回滚版本/恢复到某个版本/版本回退,且目标是普通文件" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户说 回滚版本/恢复到某个版本/版本回退,且目标是普通文件" ] } }, "has_parameters": true, "idempotency": "non_idempotent", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "revert_file_version", "parameter_count": 2, "parameters": { "node": { "description": "文件 ID (dentryUuid) 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件 ID (dentryUuid) 或 URL (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件 ID (dentryUuid) 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.revert_file_version has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.revert_file_version has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" }, "version": { "description": "要回滚到的历史版本号 (必填,正整数)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "要回滚到的历史版本号 (必填,正整数)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "要回滚到的历史版本号 (必填,正整数)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.revert_file_version has no singular pinned interface_ref; --version is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "version" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.revert_file_version has no singular pinned interface_ref; --version is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "required": true, "type": "integer" } }, "path": "drive.revert_file_version", "primary_cli_path": "drive revert", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "[危险] 回滚文件到指定历史版本", "use_when": [ "用户说 回滚版本/恢复到某个版本/版本回退,且目标是普通文件" ] }, "drive.search_files": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.search_files", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive search", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "internal/cli/schema_mcp_metadata.json#tools.drive.search_files", "live-mcp:dws schema drive.search_files", "skills/mono/references/intent-guide.md", "skills/mono/references/products/doc.md", "skills/mono/references/products/drive.md", "skills/mono/references/products/wiki.md", "structured-hint:internal/cli/schema_hints/products/drive.json", "structured-hint:internal/cli/schema_hints/selection-review.json#drive.search_files" ], "agent_summary": "全局搜索文件,默认同时搜索钉盘和文档空间,合并返回结果", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "已明确知识库 workspaceId、只在该库内搜时改用 dws wiki node search --workspace \u003cid\u003e", "已知目录、只需浏览子项时改用 dws drive list,不要用搜索代替目录遍历", "首页未命中时优先改关键词/过滤条件,而不是反复翻页" ], "canonical_path": "drive.search_files", "cli_name": "search", "cli_path": "drive search", "confirmation": "not_required", "description": "全局搜索文件,默认同时搜索钉盘和文档空间,合并返回结果。\n\n搜索范围 (--target):\n all (默认)同时搜钉盘文件与文档空间,聚合返回\n file 只搜钉盘文件/文件夹,支持 --file-types / --extensions\n space 只搜钉盘团队空间\n\n如果需要在某个知识库内搜索,请使用 dws wiki node search --workspace \u003cworkspaceId\u003e。\n\n结果中 source 字段区分来源:drive / doc。\n提示:结果按相关性排序,首页未命中时优先调整关键词 / 过滤条件,而非反复翻页。", "display": "钉盘文件管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws drive search --query \"季度汇报\" --format json", "dws drive search --query \"合同\" --target file --extensions pdf,docx --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "全局搜索文件,默认同时搜索钉盘和文档空间,合并返回结果" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "全局搜索文件,默认同时搜索钉盘和文档空间,合并返回结果" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.search_files.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "已明确知识库 workspaceId、只在该库内搜时改用 dws wiki node search --workspace \u003cid\u003e", "已知目录、只需浏览子项时改用 dws drive list,不要用搜索代替目录遍历", "首页未命中时优先改关键词/过滤条件,而不是反复翻页" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "已明确知识库 workspaceId、只在该库内搜时改用 dws wiki node search --workspace \u003cid\u003e", "已知目录、只需浏览子项时改用 dws drive list,不要用搜索代替目录遍历", "首页未命中时优先改关键词/过滤条件,而不是反复翻页" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive search", "value": "drive.search_files" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive search", "value": "drive.search_files" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "全局搜索文件,默认同时搜索钉盘和文档空间,合并返回结果。\n\n搜索范围 (--target):\n all (默认)同时搜钉盘文件与文档空间,聚合返回\n file 只搜钉盘文件/文件夹,支持 --file-types / --extensions\n space 只搜钉盘团队空间\n\n如果需要在某个知识库内搜索,请使用 dws wiki node search --workspace \u003cworkspaceId\u003e。\n\n结果中 source 字段区分来源:drive / doc。\n提示:结果按相关性排序,首页未命中时优先调整关键词 / 过滤条件,而非反复翻页。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "在钉盘空间中搜索文件、文件夹或空间,支持通过 searchTarget 参数切换搜索目标。\r\n\r\n支持三种搜索目标:\r\n1. searchTarget=all(默认):同时搜索文件和空间,返回混合结果\r\n2. searchTarget=file:搜索钉盘中的文件和文件夹,支持按文件类型、扩展名过滤\r\n3. searchTarget=space:搜索钉盘团队空间,返回匹配的空间列表,可快速定位目标空间\r\n\r\n推荐搜索流程:\r\n- 不确定目标 → searchTarget=all 获取所有匹配结果\r\n- 明确知道空间名 → searchTarget=space 定位空间 → list_files(parentId=rootFolderId) 遍历\r\n- 知道文件名/内容关键词 → searchTarget=file 直接搜索文件\r\n- 需要浏览指定空间的全部内容 → 使用 list_files(spaceId=xxx) 遍历,而非搜索\r\n\r\n搜索结果通过 type 字段区分:SPACE(空间)、FILE(普通文件)、FOLDER(文件夹)、ALIDOC(钉钉在线文档)。\r\n搜索范围为用户在当前组织内有权限访问的所有钉盘文件(我的文件+团队文件)。\r\n\r\n重要提示:搜索结果按相关性排序,第一页结果最相关。如果第一页未找到目标,建议优先调整搜索条件(更精确的关键词、添加 fileTypes/extensions 过滤、缩小时间范围等),而不是反复翻页。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "全局搜索文件,默认同时搜索钉盘和文档空间,合并返回结果。\n\n搜索范围 (--target):\n all (默认)同时搜钉盘文件与文档空间,聚合返回\n file 只搜钉盘文件/文件夹,支持 --file-types / --extensions\n space 只搜钉盘团队空间\n\n如果需要在某个知识库内搜索,请使用 dws wiki node search --workspace \u003cworkspaceId\u003e。\n\n结果中 source 字段区分来源:drive / doc。\n提示:结果按相关性排序,首页未命中时优先调整关键词 / 过滤条件,而非反复翻页。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive search --query \"季度汇报\" --format json", "dws drive search --query \"合同\" --target file --extensions pdf,docx --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive search --query \"季度汇报\" --format json", "dws drive search --query \"合同\" --target file --extensions pdf,docx --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.search_files.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.drive.search_files.interface_ref", "value": { "product_id": "drive", "rpc_name": "search_files" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.drive.search_files.interface_ref", "value": { "product_id": "drive", "rpc_name": "search_files" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "搜索文件(聚合钉盘+文档空间)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "钉盘文件搜索" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "搜索文件(聚合钉盘+文档空间)" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要在钉盘/我的文件里按关键词找文件、文件夹或团队空间,且不知道具体路径时", "需要按扩展名/文件类型/创建者/时间缩小范围的全局搜索(默认 target=all 聚合钉盘+文档空间)", "明确搜团队空间名以拿 spaceId/rootFolderId 时用 --target space" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要在钉盘/我的文件里按关键词找文件、文件夹或团队空间,且不知道具体路径时", "需要按扩展名/文件类型/创建者/时间缩小范围的全局搜索(默认 target=all 聚合钉盘+文档空间)", "明确搜团队空间名以拿 spaceId/rootFolderId 时用 --target space" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "drive", "rpc_name": "search_files" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_files", "parameter_count": 11, "parameters": { "created-from": { "description": "创建时间起始 (毫秒时间戳,含)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "创建时间起始 (毫秒时间戳,含)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建时间范围的起始时间(毫秒时间戳,含)。仅返回在此时间之后创建的结果。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "创建时间起始 (毫秒时间戳,含)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "createdTimeFrom" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "createdFrom" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "createdTimeFrom" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "创建时间范围的起始时间(毫秒时间戳,含)。仅返回在此时间之后创建的结果。", "interface_type": "number", "property": "createdTimeFrom", "required": false, "type": "integer" }, "created-to": { "description": "创建时间截止 (毫秒时间戳,含)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "创建时间截止 (毫秒时间戳,含)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建时间范围的截止时间(毫秒时间戳,含)。仅返回在此时间之前创建的结果。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "创建时间截止 (毫秒时间戳,含)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "createdTimeTo" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "createdTo" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "createdTimeTo" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "创建时间范围的截止时间(毫秒时间戳,含)。仅返回在此时间之前创建的结果。", "interface_type": "number", "property": "createdTimeTo", "required": false, "type": "integer" }, "creator-uids": { "description": "按创建者用户 ID 过滤,逗号分隔", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按创建者用户 ID 过滤,逗号分隔" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "按创建者过滤,传入用户 uid 列表(纯数字字符串)。仅返回由指定用户创建的结果。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按创建者用户 ID 过滤,逗号分隔" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "creatorUserIds" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "creatorUids" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "creatorUserIds" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "interface_description": "按创建者过滤,传入用户 uid 列表(纯数字字符串)。仅返回由指定用户创建的结果。", "property": "creatorUserIds", "required": false, "type": "array" }, "cursor": { "description": "分页游标,从上次返回的 nextCursor 获取 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标,从上次返回的 nextCursor 获取 (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "分页游标,从上一次返回结果中获取 nextCursor。首次不传。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标,从上次返回的 nextCursor 获取 (可选)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "pageToken" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "pageToken" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "分页游标,从上一次返回结果中获取 nextCursor。首次不传。", "property": "pageToken", "required": false, "type": "string" }, "extensions": { "description": "按文件扩展名过滤,不含点号,逗号分隔 (如 pdf,docx,adoc)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按文件扩展名过滤,不含点号,逗号分隔 (如 pdf,docx,adoc)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "按文件扩展名精确过滤,不含点号。仅 searchTarget=file 或 all 时生效。如 [\"pdf\", \"docx\", \"adoc\"]。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按文件扩展名过滤,不含点号,逗号分隔 (如 pdf,docx,adoc)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "extensions" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "extensions" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "interface_description": "按文件扩展名精确过滤,不含点号。仅 searchTarget=file 或 all 时生效。如 [\"pdf\", \"docx\", \"adoc\"]。", "property": "extensions", "required": false, "type": "array" }, "file-types": { "description": "按文件内容类型过滤,逗号分隔: alidoc,document,image,video,audio,archive (仅 target=file/all 生效)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按文件内容类型过滤,逗号分隔: alidoc,document,image,video,audio,archive (仅 target=file/all 生效)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "按文件内容类型过滤,仅 searchTarget=file 或 all 时生效。可选值:alidoc(钉钉在线文档)、document(本地文档,如 Word/Excel/PDF)、image(图片)、video(视频)、audio(音频)、archive(压缩包)。不传返回所有类型。如需精确匹配具体格式(如只搜 pdf),请使用 extensions 参数。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按文件内容类型过滤,逗号分隔: alidoc,document,image,video,audio,archive (仅 target=file/all 生效)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "fileTypes" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "fileTypes" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "interface_description": "按文件内容类型过滤,仅 searchTarget=file 或 all 时生效。可选值:alidoc(钉钉在线文档)、document(本地文档,如 Word/Excel/PDF)、image(图片)、video(视频)、audio(音频)、archive(压缩包)。不传返回所有类型。如需精确匹配具体格式(如只搜 pdf),请使用 extensions 参数。", "property": "fileTypes", "required": false, "type": "array" }, "limit": { "description": "每页返回数量(默认 10,最大 30)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页返回数量(默认 10,最大 30)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "每页返回的结果数量,默认 10,最大 30。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页返回数量(默认 10,最大 30)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "pageSize" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "pageSize" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "每页返回的结果数量,默认 10,最大 30。", "interface_type": "number", "property": "pageSize", "required": false, "type": "integer" }, "modified-from": { "description": "修改时间起始 (毫秒时间戳,含)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "修改时间起始 (毫秒时间戳,含)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "修改时间范围的起始时间(毫秒时间戳,含)。仅返回在此时间之后修改过的结果。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "修改时间起始 (毫秒时间戳,含)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "modifiedTimeFrom" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "modifiedFrom" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "modifiedTimeFrom" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "修改时间范围的起始时间(毫秒时间戳,含)。仅返回在此时间之后修改过的结果。", "interface_type": "number", "property": "modifiedTimeFrom", "required": false, "type": "integer" }, "modified-to": { "description": "修改时间截止 (毫秒时间戳,含)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "修改时间截止 (毫秒时间戳,含)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "修改时间范围的截止时间(毫秒时间戳,含)。仅返回在此时间之前修改过的结果。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "修改时间截止 (毫秒时间戳,含)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "modifiedTimeTo" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "modifiedTo" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "modifiedTimeTo" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "修改时间范围的截止时间(毫秒时间戳,含)。仅返回在此时间之前修改过的结果。", "interface_type": "number", "property": "modifiedTimeTo", "required": false, "type": "integer" }, "query": { "description": "搜索关键词 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "搜索关键词 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "搜索关键词,必填。searchTarget=file 或 all 时匹配文件名和内容;searchTarget=space 时匹配空间名称。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "搜索关键词 (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "keyword" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "query" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "keyword" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "搜索关键词,必填。searchTarget=file 或 all 时匹配文件名和内容;searchTarget=space 时匹配空间名称。", "property": "keyword", "required": true, "type": "string" }, "target": { "description": "搜索范围: all(默认,聚合钉盘+文档空间) | file(仅钉盘文件) | space(仅钉盘空间) (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "搜索范围: all(默认,聚合钉盘+文档空间) | file(仅钉盘文件) | space(仅钉盘空间) (可选)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "搜索目标类型,默认 all。可选值:file(文件和文件夹)、space(钉盘空间)、all(全部)。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "搜索范围: all(默认,聚合钉盘+文档空间) | file(仅钉盘文件) | space(仅钉盘空间) (可选)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "searchTarget" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "target" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "searchTarget" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "搜索目标类型,默认 all。可选值:file(文件和文件夹)、space(钉盘空间)、all(全部)。", "property": "searchTarget", "required": false, "type": "string" } }, "path": "drive.search_files", "primary_cli_path": "drive search", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "搜索文件(聚合钉盘+文档空间)", "use_when": [ "用户要在钉盘/我的文件里按关键词找文件、文件夹或团队空间,且不知道具体路径时", "需要按扩展名/文件类型/创建者/时间缩小范围的全局搜索(默认 target=all 聚合钉盘+文档空间)", "明确搜团队空间名以拿 spaceId/rootFolderId 时用 --target space" ] }, "drive.shortcut_copy": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "ShortcutRegistry:drive +copy", "cobra-help:dws drive +copy", "internal/cli/schema_command_registry.json#drive.shortcut_copy", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json" ], "agent_summary": "复制文件/文档到指定位置", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ], "canonical_path": "drive.shortcut_copy", "cli_name": "+copy", "cli_path": "drive +copy", "confirmation": "user_required", "description": "当你想保留原件、把某个文件/文档拷贝一份到指定文件夹或知识库时使用;输入源节点 node 及目标 folder/workspace,会实际生成一个副本,原文件位置不变。", "display": "钉盘文件管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws drive +copy --node \u003cnodeId\u003e --folder \u003ctargetFolderId\u003e" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "复制文件/文档到指定位置" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": "复制文件/文档到指定位置" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive +copy", "value": "drive.shortcut_copy" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive +copy", "value": "drive.shortcut_copy" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "user_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "user_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "当你想保留原件、把某个文件/文档拷贝一份到指定文件夹或知识库时使用;输入源节点 node 及目标 folder/workspace,会实际生成一个副本,原文件位置不变。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "当你想保留原件、把某个文件/文档拷贝一份到指定文件夹或知识库时使用;输入源节点 node 及目标 folder/workspace,会实际生成一个副本,原文件位置不变。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive +copy --node \u003cnodeId\u003e --folder \u003ctargetFolderId\u003e" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive +copy --node \u003cnodeId\u003e --folder \u003ctargetFolderId\u003e" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "unknown" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "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.", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "复制文件/文档到指定位置" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "复制文件/文档到指定位置" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "当你想保留原件、把某个文件/文档拷贝一份到指定文件夹或知识库时使用;输入源节点 node 及目标 folder/workspace,会实际生成一个副本,原文件位置不变。" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "当你想保留原件、把某个文件/文档拷贝一份到指定文件夹或知识库时使用;输入源节点 node 及目标 folder/workspace,会实际生成一个副本,原文件位置不变。" ] } }, "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.", "is_alias": false, "name": "shortcut_copy", "parameter_count": 3, "parameters": { "folder": { "description": "目标文件夹 nodeId", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文件夹 nodeId" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文件夹 nodeId" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "folder" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "folder" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "folder", "required": false, "type": "string" }, "node": { "description": "文档/文件 ID(必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档/文件 ID(必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档/文件 ID(必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "node" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "node" }, "required": { "candidates": [ { "precedence": "native_annotation", "selected": true, "source": "native_annotation", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "native_annotation", "resolution": "highest_precedence", "source": "native_annotation", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "node", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标知识库 ID" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标知识库 ID" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "workspace" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "workspace", "required": false, "type": "string" } }, "path": "drive.shortcut_copy", "primary_cli_path": "drive +copy", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "复制文件/文档到指定位置", "use_when": [ "当你想保留原件、把某个文件/文档拷贝一份到指定文件夹或知识库时使用;输入源节点 node 及目标 folder/workspace,会实际生成一个副本,原文件位置不变。" ] }, "drive.shortcut_find_file": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "ShortcutRegistry:drive +find-file", "cobra-help:dws drive +find-file", "internal/cli/schema_command_registry.json#drive.shortcut_find_file", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json" ], "agent_summary": "按名称关键词搜索钉盘文件并投影关键字段(只读)", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ], "canonical_path": "drive.shortcut_find_file", "cli_name": "+find-file", "cli_path": "drive +find-file", "confirmation": "not_required", "description": "当你只记得钉盘文件的名字(或其中一部分),想快速按文件名关键词找到它、拿到它的 dentryId 以便后续下载/查看,却不想手动翻目录或写复杂过滤条件时使用;内部调用钉盘的 search_files 工具,把 --query 作为文件名关键词(keyword) 并限定搜索范围为钉盘文件(searchTarget=file),再在本地把每条命中结果精简为「文件名、类型、dentryId、大小」四个字段后打印。这是纯只读操作,只做搜索与本地投影,不会创建、移动或删除任何文件;未命中时返回空列表。", "display": "钉盘文件管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws drive +find-file --query 季度汇报", "dws drive +find-file --query 合同" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "按名称关键词搜索钉盘文件并投影关键字段(只读)" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": "按名称关键词搜索钉盘文件并投影关键字段(只读)" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive +find-file", "value": "drive.shortcut_find_file" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive +find-file", "value": "drive.shortcut_find_file" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "当你只记得钉盘文件的名字(或其中一部分),想快速按文件名关键词找到它、拿到它的 dentryId 以便后续下载/查看,却不想手动翻目录或写复杂过滤条件时使用;内部调用钉盘的 search_files 工具,把 --query 作为文件名关键词(keyword) 并限定搜索范围为钉盘文件(searchTarget=file),再在本地把每条命中结果精简为「文件名、类型、dentryId、大小」四个字段后打印。这是纯只读操作,只做搜索与本地投影,不会创建、移动或删除任何文件;未命中时返回空列表。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "当你只记得钉盘文件的名字(或其中一部分),想快速按文件名关键词找到它、拿到它的 dentryId 以便后续下载/查看,却不想手动翻目录或写复杂过滤条件时使用;内部调用钉盘的 search_files 工具,把 --query 作为文件名关键词(keyword) 并限定搜索范围为钉盘文件(searchTarget=file),再在本地把每条命中结果精简为「文件名、类型、dentryId、大小」四个字段后打印。这是纯只读操作,只做搜索与本地投影,不会创建、移动或删除任何文件;未命中时返回空列表。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive +find-file --query 季度汇报", "dws drive +find-file --query 合同" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive +find-file --query 季度汇报", "dws drive +find-file --query 合同" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "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.", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "按名称关键词搜索钉盘文件并投影关键字段(只读)" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "按名称关键词搜索钉盘文件并投影关键字段(只读)" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "当你只记得钉盘文件的名字(或其中一部分),想快速按文件名关键词找到它、拿到它的 dentryId 以便后续下载/查看,却不想手动翻目录或写复杂过滤条件时使用;内部调用钉盘的 search_files 工具,把 --query 作为文件名关键词(keyword) 并限定搜索范围为钉盘文件(searchTarget=file),再在本地把每条命中结果精简为「文件名、类型、dentryId、大小」四个字段后打印。这是纯只读操作,只做搜索与本地投影,不会创建、移动或删除任何文件;未命中时返回空列表。" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "当你只记得钉盘文件的名字(或其中一部分),想快速按文件名关键词找到它、拿到它的 dentryId 以便后续下载/查看,却不想手动翻目录或写复杂过滤条件时使用;内部调用钉盘的 search_files 工具,把 --query 作为文件名关键词(keyword) 并限定搜索范围为钉盘文件(searchTarget=file),再在本地把每条命中结果精简为「文件名、类型、dentryId、大小」四个字段后打印。这是纯只读操作,只做搜索与本地投影,不会创建、移动或删除任何文件;未命中时返回空列表。" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.", "is_alias": false, "name": "shortcut_find_file", "parameter_count": 1, "parameters": { "query": { "description": "文件名关键词(必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件名关键词(必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件名关键词(必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "query" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "query" }, "required": { "candidates": [ { "precedence": "native_annotation", "selected": true, "source": "native_annotation", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "native_annotation", "resolution": "highest_precedence", "source": "native_annotation", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "query", "required": true, "type": "string" } }, "path": "drive.shortcut_find_file", "primary_cli_path": "drive +find-file", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "按名称关键词搜索钉盘文件并投影关键字段(只读)", "use_when": [ "当你只记得钉盘文件的名字(或其中一部分),想快速按文件名关键词找到它、拿到它的 dentryId 以便后续下载/查看,却不想手动翻目录或写复杂过滤条件时使用;内部调用钉盘的 search_files 工具,把 --query 作为文件名关键词(keyword) 并限定搜索范围为钉盘文件(searchTarget=file),再在本地把每条命中结果精简为「文件名、类型、dentryId、大小」四个字段后打印。这是纯只读操作,只做搜索与本地投影,不会创建、移动或删除任何文件;未命中时返回空列表。" ] }, "drive.shortcut_info": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "ShortcutRegistry:drive +info", "cobra-help:dws drive +info", "internal/cli/schema_command_registry.json#drive.shortcut_info", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json" ], "agent_summary": "获取钉盘文件/文件夹元数据", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ], "canonical_path": "drive.shortcut_info", "cli_name": "+info", "cli_path": "drive +info", "confirmation": "not_required", "description": "当你已经知道某个节点的 dentryUuid、想查看它的详细信息(名称、大小、类型、创建/修改时间、所属空间等)而不是仅列表概览时使用;输入 node(节点 ID),返回该单个文件或文件夹的完整元数据。", "display": "钉盘文件管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws drive +info --node \u003cdentryUuid\u003e" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "获取钉盘文件/文件夹元数据" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": "获取钉盘文件/文件夹元数据" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive +info", "value": "drive.shortcut_info" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive +info", "value": "drive.shortcut_info" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "当你已经知道某个节点的 dentryUuid、想查看它的详细信息(名称、大小、类型、创建/修改时间、所属空间等)而不是仅列表概览时使用;输入 node(节点 ID),返回该单个文件或文件夹的完整元数据。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "当你已经知道某个节点的 dentryUuid、想查看它的详细信息(名称、大小、类型、创建/修改时间、所属空间等)而不是仅列表概览时使用;输入 node(节点 ID),返回该单个文件或文件夹的完整元数据。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive +info --node \u003cdentryUuid\u003e" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive +info --node \u003cdentryUuid\u003e" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "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.", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取钉盘文件/文件夹元数据" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取钉盘文件/文件夹元数据" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "当你已经知道某个节点的 dentryUuid、想查看它的详细信息(名称、大小、类型、创建/修改时间、所属空间等)而不是仅列表概览时使用;输入 node(节点 ID),返回该单个文件或文件夹的完整元数据。" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "当你已经知道某个节点的 dentryUuid、想查看它的详细信息(名称、大小、类型、创建/修改时间、所属空间等)而不是仅列表概览时使用;输入 node(节点 ID),返回该单个文件或文件夹的完整元数据。" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.", "is_alias": false, "name": "shortcut_info", "parameter_count": 2, "parameters": { "node": { "description": "节点 ID (dentryUuid)(必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "节点 ID (dentryUuid)(必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "节点 ID (dentryUuid)(必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "node" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "node" }, "required": { "candidates": [ { "precedence": "native_annotation", "selected": true, "source": "native_annotation", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "native_annotation", "resolution": "highest_precedence", "source": "native_annotation", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "node", "required": true, "type": "string" }, "space-id": { "description": "节点所属空间 ID", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "节点所属空间 ID" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "节点所属空间 ID" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "spaceId" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "spaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "spaceId", "required": false, "type": "string" } }, "path": "drive.shortcut_info", "primary_cli_path": "drive +info", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "获取钉盘文件/文件夹元数据", "use_when": [ "当你已经知道某个节点的 dentryUuid、想查看它的详细信息(名称、大小、类型、创建/修改时间、所属空间等)而不是仅列表概览时使用;输入 node(节点 ID),返回该单个文件或文件夹的完整元数据。" ] }, "drive.shortcut_move": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "ShortcutRegistry:drive +move", "cobra-help:dws drive +move", "internal/cli/schema_command_registry.json#drive.shortcut_move", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json" ], "agent_summary": "移动文件/文档到指定位置", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ], "canonical_path": "drive.shortcut_move", "cli_name": "+move", "cli_path": "drive +move", "confirmation": "user_required", "description": "当你要把某个文件/文档从当前位置转移到另一个文件夹或知识库(整理归档、调整目录结构)时使用;输入源节点 node 及目标 folder/workspace,会实际改变文件所在位置,原位置不再保留该文件。", "display": "钉盘文件管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws drive +move --node \u003cnodeId\u003e --folder \u003ctargetFolderId\u003e" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "移动文件/文档到指定位置" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": "移动文件/文档到指定位置" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive +move", "value": "drive.shortcut_move" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive +move", "value": "drive.shortcut_move" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "user_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "user_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "当你要把某个文件/文档从当前位置转移到另一个文件夹或知识库(整理归档、调整目录结构)时使用;输入源节点 node 及目标 folder/workspace,会实际改变文件所在位置,原位置不再保留该文件。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "当你要把某个文件/文档从当前位置转移到另一个文件夹或知识库(整理归档、调整目录结构)时使用;输入源节点 node 及目标 folder/workspace,会实际改变文件所在位置,原位置不再保留该文件。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive +move --node \u003cnodeId\u003e --folder \u003ctargetFolderId\u003e" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive +move --node \u003cnodeId\u003e --folder \u003ctargetFolderId\u003e" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "unknown" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "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.", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "移动文件/文档到指定位置" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "移动文件/文档到指定位置" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "当你要把某个文件/文档从当前位置转移到另一个文件夹或知识库(整理归档、调整目录结构)时使用;输入源节点 node 及目标 folder/workspace,会实际改变文件所在位置,原位置不再保留该文件。" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "当你要把某个文件/文档从当前位置转移到另一个文件夹或知识库(整理归档、调整目录结构)时使用;输入源节点 node 及目标 folder/workspace,会实际改变文件所在位置,原位置不再保留该文件。" ] } }, "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.", "is_alias": false, "name": "shortcut_move", "parameter_count": 3, "parameters": { "folder": { "description": "目标文件夹 nodeId", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文件夹 nodeId" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文件夹 nodeId" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "folder" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "folder" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "folder", "required": false, "type": "string" }, "node": { "description": "文档/文件 ID(必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档/文件 ID(必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档/文件 ID(必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "node" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "node" }, "required": { "candidates": [ { "precedence": "native_annotation", "selected": true, "source": "native_annotation", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "native_annotation", "resolution": "highest_precedence", "source": "native_annotation", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "node", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标知识库 ID" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标知识库 ID" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "workspace" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "workspace", "required": false, "type": "string" } }, "path": "drive.shortcut_move", "primary_cli_path": "drive +move", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "移动文件/文档到指定位置", "use_when": [ "当你要把某个文件/文档从当前位置转移到另一个文件夹或知识库(整理归档、调整目录结构)时使用;输入源节点 node 及目标 folder/workspace,会实际改变文件所在位置,原位置不再保留该文件。" ] }, "drive.shortcut_recent": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "ShortcutRegistry:drive +recent", "cobra-help:dws drive +recent", "internal/cli/schema_command_registry.json#drive.shortcut_recent", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json" ], "agent_summary": "获取最近访问/编辑的文档列表", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ], "canonical_path": "drive.shortcut_recent", "cli_name": "+recent", "cli_path": "drive +recent", "confirmation": "not_required", "description": "当你想快速找回「我最近看过/改过的那个文档」而不记得它放在哪时使用;可按操作类型(最近访问/最近编辑)和创建人(全部/我创建/他人创建)过滤,返回近期文档列表及其节点信息。", "display": "钉盘文件管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws drive +recent", "dws drive +recent --operate-type 1 --creator-type 1" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "获取最近访问/编辑的文档列表" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": "获取最近访问/编辑的文档列表" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive +recent", "value": "drive.shortcut_recent" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive +recent", "value": "drive.shortcut_recent" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "当你想快速找回「我最近看过/改过的那个文档」而不记得它放在哪时使用;可按操作类型(最近访问/最近编辑)和创建人(全部/我创建/他人创建)过滤,返回近期文档列表及其节点信息。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "当你想快速找回「我最近看过/改过的那个文档」而不记得它放在哪时使用;可按操作类型(最近访问/最近编辑)和创建人(全部/我创建/他人创建)过滤,返回近期文档列表及其节点信息。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive +recent", "dws drive +recent --operate-type 1 --creator-type 1" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive +recent", "dws drive +recent --operate-type 1 --creator-type 1" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "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.", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取最近访问/编辑的文档列表" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取最近访问/编辑的文档列表" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "当你想快速找回「我最近看过/改过的那个文档」而不记得它放在哪时使用;可按操作类型(最近访问/最近编辑)和创建人(全部/我创建/他人创建)过滤,返回近期文档列表及其节点信息。" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "当你想快速找回「我最近看过/改过的那个文档」而不记得它放在哪时使用;可按操作类型(最近访问/最近编辑)和创建人(全部/我创建/他人创建)过滤,返回近期文档列表及其节点信息。" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.", "is_alias": false, "name": "shortcut_recent", "parameter_count": 4, "parameters": { "creator-type": { "description": "创建人过滤: 0=全部, 1=我创建, 2=他人创建", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "创建人过滤: 0=全部, 1=我创建, 2=他人创建" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "创建人过滤: 0=全部, 1=我创建, 2=他人创建" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "creatorType" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "creatorType" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "property": "creatorType", "required": false, "type": "integer" }, "cursor": { "description": "分页游标 (从上次结果的 nextCursor 获取)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标 (从上次结果的 nextCursor 获取)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标 (从上次结果的 nextCursor 获取)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "cursor" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "cursor", "required": false, "type": "string" }, "limit": { "description": "每页数量 (默认 20,最大 20)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页数量 (默认 20,最大 20)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页数量 (默认 20,最大 20)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "limit" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "limit" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "property": "limit", "required": false, "type": "integer" }, "operate-type": { "description": "操作类型: 0=最近访问(默认), 1=最近编辑", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "操作类型: 0=最近访问(默认), 1=最近编辑" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "操作类型: 0=最近访问(默认), 1=最近编辑" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "operateType" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "operateType" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "property": "operateType", "required": false, "type": "integer" } }, "path": "drive.shortcut_recent", "primary_cli_path": "drive +recent", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "获取最近访问/编辑的文档列表", "use_when": [ "当你想快速找回「我最近看过/改过的那个文档」而不记得它放在哪时使用;可按操作类型(最近访问/最近编辑)和创建人(全部/我创建/他人创建)过滤,返回近期文档列表及其节点信息。" ] }, "drive.shortcut_search": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "ShortcutRegistry:drive +search", "cobra-help:dws drive +search", "internal/cli/schema_command_registry.json#drive.shortcut_search", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json" ], "agent_summary": "搜索钉盘文件", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ], "canonical_path": "drive.shortcut_search", "cli_name": "+search", "cli_path": "drive +search", "confirmation": "not_required", "description": "当你只记得文件名或内容关键词、不知道它在哪个目录时用它全局检索钉盘文件;输入 query,可按文件类型、扩展名、创建者、创建/修改时间范围过滤,返回匹配文件及其 ID,便于再做下载或整理。", "display": "钉盘文件管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws drive +search --query \"季度汇报\"", "dws drive +search --query \"合同\" --target file --extensions pdf,docx" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "搜索钉盘文件" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": "搜索钉盘文件" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive +search", "value": "drive.shortcut_search" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive +search", "value": "drive.shortcut_search" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "当你只记得文件名或内容关键词、不知道它在哪个目录时用它全局检索钉盘文件;输入 query,可按文件类型、扩展名、创建者、创建/修改时间范围过滤,返回匹配文件及其 ID,便于再做下载或整理。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "当你只记得文件名或内容关键词、不知道它在哪个目录时用它全局检索钉盘文件;输入 query,可按文件类型、扩展名、创建者、创建/修改时间范围过滤,返回匹配文件及其 ID,便于再做下载或整理。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive +search --query \"季度汇报\"", "dws drive +search --query \"合同\" --target file --extensions pdf,docx" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive +search --query \"季度汇报\"", "dws drive +search --query \"合同\" --target file --extensions pdf,docx" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "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.", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "搜索钉盘文件" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "搜索钉盘文件" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "当你只记得文件名或内容关键词、不知道它在哪个目录时用它全局检索钉盘文件;输入 query,可按文件类型、扩展名、创建者、创建/修改时间范围过滤,返回匹配文件及其 ID,便于再做下载或整理。" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "当你只记得文件名或内容关键词、不知道它在哪个目录时用它全局检索钉盘文件;输入 query,可按文件类型、扩展名、创建者、创建/修改时间范围过滤,返回匹配文件及其 ID,便于再做下载或整理。" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.", "is_alias": false, "name": "shortcut_search", "parameter_count": 11, "parameters": { "created-from": { "description": "创建时间起始 (毫秒时间戳,含)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "创建时间起始 (毫秒时间戳,含)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "创建时间起始 (毫秒时间戳,含)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "createdFrom" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "createdFrom" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "property": "createdFrom", "required": false, "type": "integer" }, "created-to": { "description": "创建时间截止 (毫秒时间戳,含)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "创建时间截止 (毫秒时间戳,含)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "创建时间截止 (毫秒时间戳,含)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "createdTo" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "createdTo" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "property": "createdTo", "required": false, "type": "integer" }, "creator-uids": { "description": "按创建者用户 ID 过滤", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按创建者用户 ID 过滤" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按创建者用户 ID 过滤" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "creatorUids" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "creatorUids" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "property": "creatorUids", "required": false, "type": "array" }, "cursor": { "description": "分页游标,从上次返回的 nextCursor 获取", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标,从上次返回的 nextCursor 获取" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标,从上次返回的 nextCursor 获取" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "cursor" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "cursor", "required": false, "type": "string" }, "extensions": { "description": "按文件扩展名过滤,不含点号 (如 pdf,docx)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按文件扩展名过滤,不含点号 (如 pdf,docx)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按文件扩展名过滤,不含点号 (如 pdf,docx)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "extensions" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "extensions" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "property": "extensions", "required": false, "type": "array" }, "file-types": { "description": "按文件内容类型过滤: alidoc,document,image,video,audio,archive", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按文件内容类型过滤: alidoc,document,image,video,audio,archive" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按文件内容类型过滤: alidoc,document,image,video,audio,archive" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "fileTypes" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "fileTypes" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "property": "fileTypes", "required": false, "type": "array" }, "limit": { "description": "每页返回数量 (默认 10,最大 30)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页返回数量 (默认 10,最大 30)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页返回数量 (默认 10,最大 30)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "limit" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "limit" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "property": "limit", "required": false, "type": "integer" }, "modified-from": { "description": "修改时间起始 (毫秒时间戳,含)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "修改时间起始 (毫秒时间戳,含)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "修改时间起始 (毫秒时间戳,含)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "modifiedFrom" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "modifiedFrom" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "property": "modifiedFrom", "required": false, "type": "integer" }, "modified-to": { "description": "修改时间截止 (毫秒时间戳,含)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "修改时间截止 (毫秒时间戳,含)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "修改时间截止 (毫秒时间戳,含)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "modifiedTo" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "modifiedTo" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "property": "modifiedTo", "required": false, "type": "integer" }, "query": { "description": "搜索关键词(必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "搜索关键词(必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "搜索关键词(必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "query" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "query" }, "required": { "candidates": [ { "precedence": "native_annotation", "selected": true, "source": "native_annotation", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "native_annotation", "resolution": "highest_precedence", "source": "native_annotation", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "query", "required": true, "type": "string" }, "target": { "description": "搜索范围: file(钉盘文件) / space(钉盘团队空间)(可选值: file, space)", "enum": [ "file", "space" ], "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "搜索范围: file(钉盘文件) / space(钉盘团队空间)(可选值: file, space)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "搜索范围: file(钉盘文件) / space(钉盘团队空间)(可选值: file, space)" }, "enum": { "candidates": [ { "precedence": "native_annotation", "selected": true, "source": "native_annotation", "value": [ "file", "space" ] }, { "precedence": "default", "selected": false, "source": "default", "value": [] } ], "precedence": "native_annotation", "resolution": "highest_precedence", "source": "native_annotation", "value": [ "file", "space" ] }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "target" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "target" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "target", "required": false, "type": "string" } }, "path": "drive.shortcut_search", "primary_cli_path": "drive +search", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "搜索钉盘文件", "use_when": [ "当你只记得文件名或内容关键词、不知道它在哪个目录时用它全局检索钉盘文件;输入 query,可按文件类型、扩展名、创建者、创建/修改时间范围过滤,返回匹配文件及其 ID,便于再做下载或整理。" ] }, "drive.shortcut_search_docs": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "ShortcutRegistry:drive +search-docs", "cobra-help:dws drive +search-docs", "internal/cli/schema_command_registry.json#drive.shortcut_search_docs", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json" ], "agent_summary": "搜索文档空间文档", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ], "canonical_path": "drive.shortcut_search_docs", "cli_name": "+search-docs", "cli_path": "drive +search-docs", "confirmation": "not_required", "description": "当你只记得文档标题或关键词、想在文档空间/知识库中检索在线文档(区别于 +search 检索钉盘文件)时使用;输入 query 关键词,返回匹配的文档及其节点信息。", "display": "钉盘文件管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws drive +search-docs --query \"季度汇报\"" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "搜索文档空间文档" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": "搜索文档空间文档" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive +search-docs", "value": "drive.shortcut_search_docs" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive +search-docs", "value": "drive.shortcut_search_docs" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "当你只记得文档标题或关键词、想在文档空间/知识库中检索在线文档(区别于 +search 检索钉盘文件)时使用;输入 query 关键词,返回匹配的文档及其节点信息。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "当你只记得文档标题或关键词、想在文档空间/知识库中检索在线文档(区别于 +search 检索钉盘文件)时使用;输入 query 关键词,返回匹配的文档及其节点信息。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive +search-docs --query \"季度汇报\"" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive +search-docs --query \"季度汇报\"" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "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.", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Reviewed against the built-in Shortcut registry and mounted Cobra command: publishes the executable risk gate and composite interface without inventing a direct MCP identity.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "搜索文档空间文档" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "搜索文档空间文档" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "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.", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "当你只记得文档标题或关键词、想在文档空间/知识库中检索在线文档(区别于 +search 检索钉盘文件)时使用;输入 query 关键词,返回匹配的文档及其节点信息。" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "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": "internal/cli/schema_hints/selection/drive.json", "value": [ "当你只记得文档标题或关键词、想在文档空间/知识库中检索在线文档(区别于 +search 检索钉盘文件)时使用;输入 query 关键词,返回匹配的文档及其节点信息。" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed built-in shortcut adapter: the executable CLI owns validation, optional multi-step orchestration, output projection, and confirmation; the complete command contract is not represented by one pinned MCP interface_ref.", "is_alias": false, "name": "shortcut_search_docs", "parameter_count": 2, "parameters": { "limit": { "description": "每页数量", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页数量" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页数量" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "limit" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "limit" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "property": "limit", "required": false, "type": "integer" }, "query": { "description": "搜索关键词(必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "搜索关键词(必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "搜索关键词(必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "query" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "query" }, "required": { "candidates": [ { "precedence": "native_annotation", "selected": true, "source": "native_annotation", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "native_annotation", "resolution": "highest_precedence", "source": "native_annotation", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "query", "required": true, "type": "string" } }, "path": "drive.shortcut_search_docs", "primary_cli_path": "drive +search-docs", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "搜索文档空间文档", "use_when": [ "当你只记得文档标题或关键词、想在文档空间/知识库中检索在线文档(区别于 +search 检索钉盘文件)时使用;输入 query 关键词,返回匹配的文档及其节点信息。" ] }, "drive.transfer_owner": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.transfer_owner", "cobra-help:dws drive permission transfer-owner", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "wukong-develop:wukong/products" ], "agent_summary": "转交文档或知识库所有者给指定用户(不可逆)", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "普通协作权限变更用 permission add/update/remove" ], "canonical_path": "drive.transfer_owner", "cli_name": "transfer-owner", "cli_path": "drive permission transfer-owner", "confirmation": "user_required", "description": "转交文档或知识库的所有者给指定用户。此操作不可逆,执行前需要确认。\n\n--node 和 --workspace 二选一。转交后原所有者保留角色由 --reserve-role 指定。\n使用 --yes 跳过确认时,--reserve-role 和 --recursive 必须显式指定。", "display": "钉盘文件管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws drive permission transfer-owner --node \u003cDOC_ID\u003e --new-owner \u003cuserId\u003e --reserve-role EDITOR --recursive=false --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "转交文档或知识库所有者给指定用户(不可逆)" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "转交文档或知识库所有者给指定用户(不可逆)" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "普通协作权限变更用 permission add/update/remove" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "普通协作权限变更用 permission add/update/remove" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive permission transfer-owner", "value": "drive.transfer_owner" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive permission transfer-owner", "value": "drive.transfer_owner" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "user_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "user_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "转交文档或知识库的所有者给指定用户。此操作不可逆,执行前需要确认。\n\n--node 和 --workspace 二选一。转交后原所有者保留角色由 --reserve-role 指定。\n使用 --yes 跳过确认时,--reserve-role 和 --recursive 必须显式指定。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "转交文档或知识库的所有者给指定用户。此操作不可逆,执行前需要确认。\n\n--node 和 --workspace 二选一。转交后原所有者保留角色由 --reserve-role 指定。\n使用 --yes 跳过确认时,--reserve-role 和 --recursive 必须显式指定。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive permission transfer-owner --node \u003cDOC_ID\u003e --new-owner \u003cuserId\u003e --reserve-role EDITOR --recursive=false --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive permission transfer-owner --node \u003cDOC_ID\u003e --new-owner \u003cuserId\u003e --reserve-role EDITOR --recursive=false --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "non_idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "non_idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "high" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "high" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "[危险] 转交所有者" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "[危险] 转交所有者" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户明确要求转交文档/知识库所有权" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户明确要求转交文档/知识库所有权" ] } }, "group": "permission", "has_parameters": true, "idempotency": "non_idempotent", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "transfer_owner", "parameter_count": 5, "parameters": { "new-owner": { "description": "新所有者的用户 userId (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "新所有者的用户 userId (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "新所有者的用户 userId (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.transfer_owner has no singular pinned interface_ref; --new-owner is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "newOwner" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.transfer_owner has no singular pinned interface_ref; --new-owner is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" }, "node": { "description": "目标节点 ID 或 URL(与 --workspace 二选一)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标节点 ID 或 URL(与 --workspace 二选一)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标节点 ID 或 URL(与 --workspace 二选一)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.transfer_owner has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.transfer_owner has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "recursive": { "description": "是否递归变更所有子节点的所有者", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "是否递归变更所有子节点的所有者" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "是否递归变更所有子节点的所有者" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.transfer_owner has no singular pinned interface_ref; --recursive is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "recursive" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.transfer_owner has no singular pinned interface_ref; --recursive is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "boolean" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "boolean" } }, "required": false, "type": "boolean" }, "reserve-role": { "description": "转交后原所有者保留角色: MANAGER / EDITOR / DOWNLOADER / READER / NONE", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "转交后原所有者保留角色: MANAGER / EDITOR / DOWNLOADER / READER / NONE" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "转交后原所有者保留角色: MANAGER / EDITOR / DOWNLOADER / READER / NONE" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.transfer_owner has no singular pinned interface_ref; --reserve-role is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "reserveRole" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.transfer_owner has no singular pinned interface_ref; --reserve-role is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "workspace": { "description": "目标知识库 ID 或 URL(与 --node 二选一)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标知识库 ID 或 URL(与 --node 二选一)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标知识库 ID 或 URL(与 --node 二选一)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.transfer_owner has no singular pinned interface_ref; --workspace is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.transfer_owner has no singular pinned interface_ref; --workspace is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" } }, "path": "drive.transfer_owner", "primary_cli_path": "drive permission transfer-owner", "product_id": "drive", "reviewed": true, "risk": "high", "source": "reviewed_command_registry", "title": "[危险] 转交所有者", "use_when": [ "用户明确要求转交文档/知识库所有权" ] }, "drive.unmark_star": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.unmark_star", "cobra-help:dws drive star remove", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "wukong-develop:wukong/products" ], "agent_summary": "将文档/文件从当前用户收藏列表移除", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "添加收藏用 mark_star" ], "canonical_path": "drive.unmark_star", "cli_name": "remove", "cli_path": "drive star remove", "confirmation": "not_required", "description": "取消收藏文档", "display": "钉盘文件管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws drive star remove --node \u003cnodeId\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "将文档/文件从当前用户收藏列表移除" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "将文档/文件从当前用户收藏列表移除" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "添加收藏用 mark_star" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "添加收藏用 mark_star" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive star remove", "value": "drive.unmark_star" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive star remove", "value": "drive.unmark_star" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "取消收藏文档" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "取消收藏文档" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive star remove --node \u003cnodeId\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive star remove --node \u003cnodeId\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/drive marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "取消收藏文档" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "取消收藏文档" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户说 取消收藏/去掉收藏/不收藏了" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:对照悟空 develop 同名命令实现、Cobra Long/Example 与 Runtime 确认门禁移植;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户说 取消收藏/去掉收藏/不收藏了" ] } }, "group": "star", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "unmark_star", "parameter_count": 1, "parameters": { "node": { "description": "文档 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: drive.unmark_star has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: drive.unmark_star has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" } }, "path": "drive.unmark_star", "primary_cli_path": "drive star remove", "product_id": "drive", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "取消收藏文档", "use_when": [ "用户说 取消收藏/去掉收藏/不收藏了" ] }, "drive.upload": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=drive.upload", "Skill:skills/mono/references/products/drive.md", "cobra-help:dws drive upload", "internal/cli/schema_hints/metadata/drive.json", "internal/cli/schema_hints/selection/drive.json", "live-mcp:none (Cobra+Skill; composite/unpinned)", "skills/mono/references/intent-guide.md", "skills/mono/references/products/drive.md", "structured-hint:internal/cli/schema_hints/products/drive.json", "structured-hint:internal/cli/schema_hints/selection-review.json#drive.upload" ], "agent_summary": "上传本地文件到钉盘或文档空间,或按节点 ID 确认覆盖已有文件", "agent_summary_source": "dws-agent-selection/drive", "availability": "available", "avoid_when": [ "常规场景不要拆成 upload-info + 手动 PUT + commit;仅自定义流式上传才用三步", "要把文件作为文档正文附件插入改用 dws doc media insert", "用户明确说文档空间且走 doc 兼容入口时可用 dws doc upload,默认仍推荐本命令", "用户没有明确同意替换目标文件时不要使用 --node;新建上传应使用 --folder 或目标根目录" ], "canonical_path": "drive.upload", "cli_name": "upload", "cli_path": "drive upload", "confirmation": "not_required", "description": "将本地文件上传(三步自动完成)。\n\n路由规则:\n 默认(无 --workspace) → 上传到钉盘(我的文件或指定空间)\n --workspace \u003cid\u003e → 上传到文档空间/知识库\n\n流程:\n 1. 获取 OSS 上传凭证\n 2. HTTP PUT 上传文件二进制到 OSS\n 3. 提交文件入库\n\n上传位置: --folder 指定父目录,不传则上传到空间根目录。", "display": "钉盘文件管理", "dry_run": { "preview_kind": "plan" }, "effect": "write", "effect_source": "agent-hint", "examples": [ "dws drive upload --file ./report.pdf --format json", "dws drive upload --file ./README.md --node \u003cdentryUuid\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": "上传本地文件到钉盘或文档空间,或按节点 ID 确认覆盖已有文件" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": "上传本地文件到钉盘或文档空间,或按节点 ID 确认覆盖已有文件" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "常规场景不要拆成 upload-info + 手动 PUT + commit;仅自定义流式上传才用三步", "要把文件作为文档正文附件插入改用 dws doc media insert", "用户明确说文档空间且走 doc 兼容入口时可用 dws doc upload,默认仍推荐本命令", "用户没有明确同意替换目标文件时不要使用 --node;新建上传应使用 --folder 或目标根目录" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "常规场景不要拆成 upload-info + 手动 PUT + commit;仅自定义流式上传才用三步", "要把文件作为文档正文附件插入改用 dws doc media insert", "用户明确说文档空间且走 doc 兼容入口时可用 dws doc upload,默认仍推荐本命令", "用户没有明确同意替换目标文件时不要使用 --node;新建上传应使用 --folder 或目标根目录" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "drive upload", "value": "drive.upload" }, { "precedence": "reviewed_manual", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "selected": false, "source": "reviewed_manual_hint", "source_ref": "drive upload", "value": "drive.upload" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "drive upload", "value": "drive.upload" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, { "precedence": "inference_or_default", "selected": false, "source": "risk-default", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "将本地文件上传(三步自动完成)。\n\n路由规则:\n 默认(无 --workspace) → 上传到钉盘(我的文件或指定空间)\n --workspace \u003cid\u003e → 上传到文档空间/知识库\n\n流程:\n 1. 获取 OSS 上传凭证\n 2. HTTP PUT 上传文件二进制到 OSS\n 3. 提交文件入库\n\n上传位置: --folder 指定父目录,不传则上传到空间根目录。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "将本地文件上传(三步自动完成)。\n\n路由规则:\n 默认(无 --workspace) → 上传到钉盘(我的文件或指定空间)\n --workspace \u003cid\u003e → 上传到文档空间/知识库\n\n流程:\n 1. 获取 OSS 上传凭证\n 2. HTTP PUT 上传文件二进制到 OSS\n 3. 提交文件入库\n\n上传位置: --folder 指定父目录,不传则上传到空间根目录。" }, "dry_run": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "reviewed positive dry-run capability", "selected": true, "source": "reviewed_dry_run_registry", "source_ref": "internal/cli/schema_dry_run_capabilities.go", "value": { "preview_kind": "plan" } } ], "precedence": "reviewed_explicit", "resolution": "exact_canonical_lookup", "review_reason": "reviewed positive dry-run capability", "source": "reviewed_dry_run_registry", "source_ref": "internal/cli/schema_dry_run_capabilities.go", "value": { "preview_kind": "plan" } }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, { "precedence": "inference_or_default", "selected": false, "source": "command-verb", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive upload --file ./report.pdf --format json", "dws drive upload --file ./README.md --node \u003cdentryUuid\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "dws drive upload --file ./report.pdf --format json", "dws drive upload --file ./README.md --node \u003cdentryUuid\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "unknown" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "unknown" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤,不能绑定为单一 interface_ref" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤,不能绑定为单一 interface_ref" }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/drive.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/drive.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "selected": true, "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "source": "internal/cli/schema_hints/metadata/drive.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "上传本地文件到钉盘或文档空间" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "上传本地文件到钉盘或文档空间" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要把本地文件上传到钉盘/我的文件(首选一条命令自动完成凭证+PUT+提交)时", "上传到知识库/文档空间时加 --workspace;需要转在线文档时加 --convert", "用户明确要求用本地文件替换已有钉盘/文档空间文件时传 --node;该模式会覆盖远端内容并要求确认" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅:结合本机 dws schema 实时 MCP description/parameters(经 interface_ref)、产品 Skill、Cobra Long 与 Runtime 确认门禁,按飞书风格重写选型文案;不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/drive.json", "value": [ "用户要把本地文件上传到钉盘/我的文件(首选一条命令自动完成凭证+PUT+提交)时", "上传到知识库/文档空间时加 --workspace;需要转在线文档时加 --convert", "用户明确要求用本地文件替换已有钉盘/文档空间文件时传 --node;该模式会覆盖远端内容并要求确认" ] } }, "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤,不能绑定为单一 interface_ref", "is_alias": false, "name": "upload", "parameter_count": 8, "parameters": { "convert": { "description": "是否转换为钉钉在线文档 (仅文档空间上传时生效)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "是否转换为钉钉在线文档 (仅文档空间上传时生效)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "是否转换为钉钉在线文档 (仅文档空间上传时生效)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "convert" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "convert" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "boolean" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "boolean" } }, "property": "convert", "required": false, "type": "boolean" }, "file": { "description": "本地文件路径 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "本地文件路径 (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "本地文件路径 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "file" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "file" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "file", "required": true, "type": "string" }, "file-name": { "description": "文件显示名称 (默认使用文件名)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件显示名称 (默认使用文件名)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件显示名称 (默认使用文件名)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "fileName" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "fileName" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "fileName", "required": false, "type": "string" }, "folder": { "description": "父节点 ID,不传则上传到空间根目录 (可选,与 --node 互斥)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "父节点 ID,不传则上传到空间根目录 (可选,与 --node 互斥)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "父节点 ID,不传则上传到空间根目录 (可选,与 --node 互斥)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "folder" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "folder" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "folder", "required": false, "type": "string" }, "mime-type": { "description": "文件 MIME 类型,不传则自动推断 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件 MIME 类型,不传则自动推断 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件 MIME 类型,不传则自动推断 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "mimeType" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "mimeType" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "mimeType", "required": false, "type": "string" }, "node": { "description": "覆盖目标文件 ID,传入即覆盖已有文件(与 --folder 互斥)(可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "覆盖目标文件 ID,传入即覆盖已有文件(与 --folder 互斥)(可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "覆盖目标文件 ID,传入即覆盖已有文件(与 --folder 互斥)(可选)" }, "property": { "candidates": [ { "precedence": "reviewed_manual", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "selected": true, "source": "reviewed_manual_hint", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "reviewed_manual", "resolution": "highest_precedence", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "source": "reviewed_manual_hint", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "reviewed_manual", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "selected": true, "source": "reviewed_manual_hint", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "reviewed_manual", "resolution": "highest_precedence", "review_reason": "The reviewed helper preserves the stable command-level Schema contract for ordinary uploads; --node switches to overwrite mode and the runtime still requires explicit confirmation unless --yes is supplied.", "source": "reviewed_manual_hint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "nodeId", "required": false, "type": "string" }, "space-id": { "description": "目标钉盘空间 ID,不传则使用「我的文件」 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标钉盘空间 ID,不传则使用「我的文件」 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标钉盘空间 ID,不传则使用「我的文件」 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "spaceId" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "spaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "spaceId", "required": false, "type": "string" }, "workspace": { "description": "目标知识库 ID,传入时路由到文档空间上传 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标知识库 ID,传入时路由到文档空间上传 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标知识库 ID,传入时路由到文档空间上传 (可选)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "workspace" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "workspace", "required": false, "type": "string" } }, "path": "drive.upload", "primary_cli_path": "drive upload", "product_id": "drive", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "上传本地文件到钉盘或文档空间", "use_when": [ "用户要把本地文件上传到钉盘/我的文件(首选一条命令自动完成凭证+PUT+提交)时", "上传到知识库/文档空间时加 --workspace;需要转在线文档时加 --convert", "用户明确要求用本地文件替换已有钉盘/文档空间文件时传 --node;该模式会覆盖远端内容并要求确认" ] } } }