github/dingtalk-workspace-cli
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
066094a68cd849e56f274f1ec2a3702eb8287c5e
dingtalk-workspace-cli/internal/cli/schema_agent_metadata/drive.json
T
玉澜andCursor 7773eb27f1 refactor(corecmd): rename package and finish ContractFinal leaf migration 
Move cmdcore to corecmd, declare attendance ContractFinal in helpers, keep
Sheet destructive commands --yes-only, and align catalog/policy provenance.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-07-31 14:13:46 +08:00

10163 lines
355 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"product_id": "drive",
"tools": {
"drive +copy": {
"agent_summary": "复制文件/文档到指定位置",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"confirmation": "user_required",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws drive +copy --node \u003cnodeId\u003e --folder \u003ctargetFolderId\u003e"
],
"field_provenance": {
"agent_summary": {
"value": "复制文件/文档到指定位置",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "复制文件/文档到指定位置",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "user_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "user_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive +copy --node \u003cnodeId\u003e --folder \u003ctargetFolderId\u003e"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive +copy --node \u003cnodeId\u003e --folder \u003ctargetFolderId\u003e"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"当你想保留原件、把某个文件/文档拷贝一份到指定文件夹或知识库时使用；输入源节点 node 及目标 folder/workspace，会实际生成一个副本，原文件位置不变。"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"当你想保留原件、把某个文件/文档拷贝一份到指定文件夹或知识库时使用；输入源节点 node 及目标 folder/workspace，会实际生成一个副本，原文件位置不变。"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl"
],
"use_when": [
"当你想保留原件、把某个文件/文档拷贝一份到指定文件夹或知识库时使用；输入源节点 node 及目标 folder/workspace，会实际生成一个副本，原文件位置不变。"
]
},
"drive +find-file": {
"agent_summary": "按名称关键词搜索钉盘文件并投影关键字段（只读）",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws drive +find-file --query 季度汇报",
"dws drive +find-file --query 合同"
],
"field_provenance": {
"agent_summary": {
"value": "按名称关键词搜索钉盘文件并投影关键字段（只读）",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "按名称关键词搜索钉盘文件并投影关键字段（只读）",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive +find-file --query 季度汇报",
"dws drive +find-file --query 合同"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive +find-file --query 季度汇报",
"dws drive +find-file --query 合同"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"当你只记得钉盘文件的名字（或其中一部分），想快速按文件名关键词找到它、拿到它的 dentryId 以便后续下载/查看，却不想手动翻目录或写复杂过滤条件时使用；内部调用钉盘的 search_files 工具，把 --query 作为文件名关键词(keyword) 并限定搜索范围为钉盘文件(searchTarget=file)，再在本地把每条命中结果精简为「文件名、类型、dentryId、大小」四个字段后打印。这是纯只读操作，只做搜索与本地投影，不会创建、移动或删除任何文件；未命中时返回空列表。"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"当你只记得钉盘文件的名字（或其中一部分），想快速按文件名关键词找到它、拿到它的 dentryId 以便后续下载/查看，却不想手动翻目录或写复杂过滤条件时使用；内部调用钉盘的 search_files 工具，把 --query 作为文件名关键词(keyword) 并限定搜索范围为钉盘文件(searchTarget=file)，再在本地把每条命中结果精简为「文件名、类型、dentryId、大小」四个字段后打印。这是纯只读操作，只做搜索与本地投影，不会创建、移动或删除任何文件；未命中时返回空列表。"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl"
],
"use_when": [
"当你只记得钉盘文件的名字（或其中一部分），想快速按文件名关键词找到它、拿到它的 dentryId 以便后续下载/查看，却不想手动翻目录或写复杂过滤条件时使用；内部调用钉盘的 search_files 工具，把 --query 作为文件名关键词(keyword) 并限定搜索范围为钉盘文件(searchTarget=file)，再在本地把每条命中结果精简为「文件名、类型、dentryId、大小」四个字段后打印。这是纯只读操作，只做搜索与本地投影，不会创建、移动或删除任何文件；未命中时返回空列表。"
]
},
"drive +info": {
"agent_summary": "获取钉盘文件/文件夹元数据",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws drive +info --node \u003cdentryUuid\u003e"
],
"field_provenance": {
"agent_summary": {
"value": "获取钉盘文件/文件夹元数据",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "获取钉盘文件/文件夹元数据",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive +info --node \u003cdentryUuid\u003e"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive +info --node \u003cdentryUuid\u003e"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"当你已经知道某个节点的 dentryUuid、想查看它的详细信息（名称、大小、类型、创建/修改时间、所属空间等）而不是仅列表概览时使用；输入 node（节点 ID），返回该单个文件或文件夹的完整元数据。"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"当你已经知道某个节点的 dentryUuid、想查看它的详细信息（名称、大小、类型、创建/修改时间、所属空间等）而不是仅列表概览时使用；输入 node（节点 ID），返回该单个文件或文件夹的完整元数据。"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl"
],
"use_when": [
"当你已经知道某个节点的 dentryUuid、想查看它的详细信息（名称、大小、类型、创建/修改时间、所属空间等）而不是仅列表概览时使用；输入 node（节点 ID），返回该单个文件或文件夹的完整元数据。"
]
},
"drive +move": {
"agent_summary": "移动文件/文档到指定位置",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"confirmation": "user_required",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws drive +move --node \u003cnodeId\u003e --folder \u003ctargetFolderId\u003e"
],
"field_provenance": {
"agent_summary": {
"value": "移动文件/文档到指定位置",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "移动文件/文档到指定位置",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "user_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "user_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive +move --node \u003cnodeId\u003e --folder \u003ctargetFolderId\u003e"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive +move --node \u003cnodeId\u003e --folder \u003ctargetFolderId\u003e"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"当你要把某个文件/文档从当前位置转移到另一个文件夹或知识库（整理归档、调整目录结构）时使用；输入源节点 node 及目标 folder/workspace，会实际改变文件所在位置，原位置不再保留该文件。"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"当你要把某个文件/文档从当前位置转移到另一个文件夹或知识库（整理归档、调整目录结构）时使用；输入源节点 node 及目标 folder/workspace，会实际改变文件所在位置，原位置不再保留该文件。"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl"
],
"use_when": [
"当你要把某个文件/文档从当前位置转移到另一个文件夹或知识库（整理归档、调整目录结构）时使用；输入源节点 node 及目标 folder/workspace，会实际改变文件所在位置，原位置不再保留该文件。"
]
},
"drive +recent": {
"agent_summary": "获取最近访问/编辑的文档列表",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws drive +recent",
"dws drive +recent --operate-type 1 --creator-type 1"
],
"field_provenance": {
"agent_summary": {
"value": "获取最近访问/编辑的文档列表",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "获取最近访问/编辑的文档列表",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive +recent",
"dws drive +recent --operate-type 1 --creator-type 1"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive +recent",
"dws drive +recent --operate-type 1 --creator-type 1"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"当你想快速找回「我最近看过/改过的那个文档」而不记得它放在哪时使用；可按操作类型（最近访问/最近编辑）和创建人（全部/我创建/他人创建）过滤，返回近期文档列表及其节点信息。"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"当你想快速找回「我最近看过/改过的那个文档」而不记得它放在哪时使用；可按操作类型（最近访问/最近编辑）和创建人（全部/我创建/他人创建）过滤，返回近期文档列表及其节点信息。"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl"
],
"use_when": [
"当你想快速找回「我最近看过/改过的那个文档」而不记得它放在哪时使用；可按操作类型（最近访问/最近编辑）和创建人（全部/我创建/他人创建）过滤，返回近期文档列表及其节点信息。"
]
},
"drive +search": {
"agent_summary": "搜索钉盘文件",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws drive +search --query \"季度汇报\"",
"dws drive +search --query \"合同\" --target file --extensions pdf,docx"
],
"field_provenance": {
"agent_summary": {
"value": "搜索钉盘文件",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "搜索钉盘文件",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive +search --query \"季度汇报\"",
"dws drive +search --query \"合同\" --target file --extensions pdf,docx"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive +search --query \"季度汇报\"",
"dws drive +search --query \"合同\" --target file --extensions pdf,docx"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"当你只记得文件名或内容关键词、不知道它在哪个目录时用它全局检索钉盘文件；输入 query，可按文件类型、扩展名、创建者、创建/修改时间范围过滤，返回匹配文件及其 ID，便于再做下载或整理。"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"当你只记得文件名或内容关键词、不知道它在哪个目录时用它全局检索钉盘文件；输入 query，可按文件类型、扩展名、创建者、创建/修改时间范围过滤，返回匹配文件及其 ID，便于再做下载或整理。"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl"
],
"use_when": [
"当你只记得文件名或内容关键词、不知道它在哪个目录时用它全局检索钉盘文件；输入 query，可按文件类型、扩展名、创建者、创建/修改时间范围过滤，返回匹配文件及其 ID，便于再做下载或整理。"
]
},
"drive +search-docs": {
"agent_summary": "搜索文档空间文档",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws drive +search-docs --query \"季度汇报\""
],
"field_provenance": {
"agent_summary": {
"value": "搜索文档空间文档",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "搜索文档空间文档",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive +search-docs --query \"季度汇报\""
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive +search-docs --query \"季度汇报\""
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"当你只记得文档标题或关键词、想在文档空间/知识库中检索在线文档（区别于 +search 检索钉盘文件）时使用；输入 query 关键词，返回匹配的文档及其节点信息。"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"当你只记得文档标题或关键词、想在文档空间/知识库中检索在线文档（区别于 +search 检索钉盘文件）时使用；输入 query 关键词，返回匹配的文档及其节点信息。"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl"
],
"use_when": [
"当你只记得文档标题或关键词、想在文档空间/知识库中检索在线文档（区别于 +search 检索钉盘文件）时使用；输入 query 关键词，返回匹配的文档及其节点信息。"
]
},
"drive commit": {
"agent_summary": "提交文件上传",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"普通上传请用 dws drive upload",
"尚未 PUT 成功或 uploadId 过期时不要 commit；需重新 upload-info"
],
"confirmation": "not_required",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws drive commit --file-name \"report.pdf\" --file-size 102400 --upload-id \u003cUPLOAD_ID\u003e --format json"
],
"field_provenance": {
"agent_summary": {
"value": "提交文件上传",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "提交文件上传",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "available",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.commit_upload.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"avoid_when": {
"value": [
"普通上传请用 dws drive upload",
"尚未 PUT 成功或 uploadId 过期时不要 commit；需重新 upload-info"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"普通上传请用 dws drive upload",
"尚未 PUT 成功或 uploadId 过期时不要 commit；需重新 upload-info"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "write",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive commit --file-name \"report.pdf\" --file-size 102400 --upload-id \u003cUPLOAD_ID\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive commit --file-name \"report.pdf\" --file-size 102400 --upload-id \u003cUPLOAD_ID\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "unknown",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "mcp",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.commit_upload.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"interface_ref": {
"value": "drive.commit_upload",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "drive.commit_upload",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "drive.commit_upload",
"source": "internal/cli/schema_hints/imported/wukong.json",
"precedence": "imported",
"selected": false
},
{
"value": "drive.commit_upload",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.commit_upload.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "medium",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"手动三步上传的最后一步：已 PUT 到 OSS，用 upload-info 返回的 uploadId 提交入库时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"手动三步上传的最后一步：已 PUT 到 OSS，用 upload-info 返回的 uploadId 提交入库时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
}
},
"idempotency": "unknown",
"interface_mode": "mcp",
"interface_ref": {
"product_id": "drive",
"rpc_name": "commit_upload"
},
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl",
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.commit_upload",
"internal/cli/schema_hints/imported/wukong.json",
"internal/cli/schema_mcp_metadata.json#tools.drive.commit_upload",
"skills/mono/references/products/drive.md"
],
"use_when": [
"手动三步上传的最后一步：已 PUT 到 OSS，用 upload-info 返回的 uploadId 提交入库时"
]
},
"drive copy": {
"agent_summary": "将文件或文档复制到目标文件夹或知识库（保留原位置；默认「我的文档」）",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"用户意图是搬走/迁移且原位置不再保留时改用 dws drive move（move 需更高源权限）",
"只要快捷方式入口、不要独立副本时改用 dws drive shortcut",
"已在明确知识库上下文内复制节点且需带 --workspace/--node 的 wiki 入口时可用 dws wiki node copy；跨产品默认用本命令",
"目标文件夹或知识库尚未确认时不要复制"
],
"confirmation": "not_required",
"effect": "write",
"effect_source": "corecmd.contract",
"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": {
"value": "将文件或文档复制到目标文件夹或知识库（保留原位置；默认「我的文档」）",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "将文件或文档复制到目标文件夹或知识库（保留原位置；默认「我的文档」）",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "available",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.copy_document.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"avoid_when": {
"value": [
"用户意图是搬走/迁移且原位置不再保留时改用 dws drive move（move 需更高源权限）",
"只要快捷方式入口、不要独立副本时改用 dws drive shortcut",
"已在明确知识库上下文内复制节点且需带 --workspace/--node 的 wiki 入口时可用 dws wiki node copy；跨产品默认用本命令",
"目标文件夹或知识库尚未确认时不要复制"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户意图是搬走/迁移且原位置不再保留时改用 dws drive move（move 需更高源权限）",
"只要快捷方式入口、不要独立副本时改用 dws drive shortcut",
"已在明确知识库上下文内复制节点且需带 --workspace/--node 的 wiki 入口时可用 dws wiki node copy；跨产品默认用本命令",
"目标文件夹或知识库尚未确认时不要复制"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "write",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"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"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "unknown",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "mcp",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.copy_document.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"interface_ref": {
"value": "doc.copy_document",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "doc.copy_document",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "doc.copy_document",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.copy_document.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": false,
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.copy_document",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "medium",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"用户要复制/拷贝一份文件或文档到新位置，且原位置仍需保留副本时（copy≠move）",
"目标是指定文件夹：传 --folder \u003c目标文件夹 dentryUuid/fileId\u003e",
"目标是知识库根目录：只传 --workspace \u003cworkspaceId 或知识库 URL\u003e，不传 --folder",
"用户未指定目标时：默认落到当前组织「我的文档」；若需钉盘「我的文件」根目录，先 wiki space list --type mySpace 取 rootFolderId 再 --folder",
"跨钉盘 space 复制到子文件夹：先 list 取目标文件夹 fileId，再 --folder 传入"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户要复制/拷贝一份文件或文档到新位置，且原位置仍需保留副本时（copy≠move）",
"目标是指定文件夹：传 --folder \u003c目标文件夹 dentryUuid/fileId\u003e",
"目标是知识库根目录：只传 --workspace \u003cworkspaceId 或知识库 URL\u003e，不传 --folder",
"用户未指定目标时：默认落到当前组织「我的文档」；若需钉盘「我的文件」根目录，先 wiki space list --type mySpace 取 rootFolderId 再 --folder",
"跨钉盘 space 复制到子文件夹：先 list 取目标文件夹 fileId，再 --folder 传入"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
}
},
"idempotency": "unknown",
"interface_mode": "mcp",
"interface_ref": {
"product_id": "doc",
"rpc_name": "copy_document"
},
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl",
"internal/cli/schema_mcp_metadata.json#tools.drive.copy_document",
"skills/mono/references/products/drive.md"
],
"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 cover": {
"agent_summary": "获取节点封面图片地址（文档首图/图片缩略图/类型图标）",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"设置文档封面用 doc style cover set"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws drive cover --node \u003cdentryUuid\u003e --format json"
],
"field_provenance": {
"agent_summary": {
"value": "获取节点封面图片地址（文档首图/图片缩略图/类型图标）",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "获取节点封面图片地址（文档首图/图片缩略图/类型图标）",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"设置文档封面用 doc style cover set"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"设置文档封面用 doc style cover set"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive cover --node \u003cdentryUuid\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive cover --node \u003cdentryUuid\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"用户说 封面/封面图/缩略图/预览图"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户说 封面/封面图/缩略图/预览图"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl"
],
"use_when": [
"用户说 封面/封面图/缩略图/预览图"
]
},
"drive delete": {
"agent_summary": "将钉盘中的文件或文件夹移入回收站",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"用户未确认删除目标或只是想移走位置时不要删；搬迁用 dws drive move",
"要删整个知识库改用 dws wiki space delete",
"要永久删评论改用 dws doc comment delete"
],
"confirmation": "user_required",
"effect": "destructive",
"effect_source": "corecmd.contract",
"examples": [
"dws drive delete --node \u003cdentryUuid\u003e --format json"
],
"field_provenance": {
"agent_summary": {
"value": "将钉盘中的文件或文件夹移入回收站",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "将钉盘中的文件或文件夹移入回收站",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "available",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.delete_document.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"avoid_when": {
"value": [
"用户未确认删除目标或只是想移走位置时不要删；搬迁用 dws drive move",
"要删整个知识库改用 dws wiki space delete",
"要永久删评论改用 dws doc comment delete"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户未确认删除目标或只是想移走位置时不要删；搬迁用 dws drive move",
"要删整个知识库改用 dws wiki space delete",
"要永久删评论改用 dws doc comment delete"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "user_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "user_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "destructive",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "destructive",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "write",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive delete --node \u003cdentryUuid\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive delete --node \u003cdentryUuid\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "unknown",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "mcp",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.delete_document.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"interface_ref": {
"value": "doc.delete_document",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "doc.delete_document",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "doc.delete_document",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.delete_document.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": false,
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.delete_document",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"risk": {
"value": "high",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "high",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "medium",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"用户明确要求把钉盘/文档空间中的文件或文件夹移入回收站，且已确认目标节点时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户明确要求把钉盘/文档空间中的文件或文件夹移入回收站，且已确认目标节点时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
}
},
"idempotency": "unknown",
"interface_mode": "mcp",
"interface_ref": {
"product_id": "doc",
"rpc_name": "delete_document"
},
"reviewed": true,
"risk": "high",
"source_refs": [
"corecmd.SchemaDecl",
"internal/cli/schema_mcp_metadata.json#tools.drive.delete_document",
"skills/mono/references/products/drive.md"
],
"use_when": [
"用户明确要求把钉盘/文档空间中的文件或文件夹移入回收站，且已确认目标节点时"
]
},
"drive download": {
"agent_summary": "下载钉盘或文档空间文件到本地",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"在线文档(adoc)要导出为 Word/docx 改用 dws doc export，不要用 download 代替导出",
"只要临时下载链接语义且走文档附件块时用 dws doc media download",
"未指定 --output 不要调用（CLI 必填）"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"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": {
"value": "下载钉盘或文档空间文件到本地",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "下载钉盘或文档空间文件到本地",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "available",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.download_file.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"avoid_when": {
"value": [
"在线文档(adoc)要导出为 Word/docx 改用 dws doc export，不要用 download 代替导出",
"只要临时下载链接语义且走文档附件块时用 dws doc media download",
"未指定 --output 不要调用（CLI 必填）"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"在线文档(adoc)要导出为 Word/docx 改用 dws doc export，不要用 download 代替导出",
"只要临时下载链接语义且走文档附件块时用 dws doc media download",
"未指定 --output 不要调用（CLI 必填）"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "read",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive download --node \u003cdentryUuid\u003e --output ./report.pdf --format json",
"dws drive download --node \u003cdentryUuid\u003e --output ~/downloads/ --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive download --node \u003cdentryUuid\u003e --output ./report.pdf --format json",
"dws drive download --node \u003cdentryUuid\u003e --output ~/downloads/ --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "idempotent",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "mcp",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.download_file.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"interface_ref": {
"value": "drive.download_file",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "drive.download_file",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "drive.download_file",
"source": "internal/cli/schema_hints/imported/wukong.json",
"precedence": "imported",
"selected": false
},
{
"value": "drive.download_file",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.download_file.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "low",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"用户要把钉盘普通文件（PDF/图片/Office 等非在线文档）下载到本地路径时",
"已确认 contentType 非 ALIDOC，需要落盘本地查看时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户要把钉盘普通文件（PDF/图片/Office 等非在线文档）下载到本地路径时",
"已确认 contentType 非 ALIDOC，需要落盘本地查看时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
}
},
"idempotency": "idempotent",
"interface_mode": "mcp",
"interface_ref": {
"product_id": "drive",
"rpc_name": "download_file"
},
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl",
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.download_file",
"internal/cli/schema_hints/imported/wukong.json",
"internal/cli/schema_mcp_metadata.json#tools.drive.download_file",
"skills/mono/references/intent-guide.md",
"skills/mono/references/products/doc.md",
"skills/mono/references/products/drive.md"
],
"use_when": [
"用户要把钉盘普通文件（PDF/图片/Office 等非在线文档）下载到本地路径时",
"已确认 contentType 非 ALIDOC，需要落盘本地查看时"
]
},
"drive download-version": {
"agent_summary": "下载钉盘普通文件的指定历史版本到本地（两步下载：取签名 URL 后 HTTP GET）",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"下载最新版本用 drive download",
"在线文档（adoc）历史版本用 doc version 系列命令",
"在线表格（axls）历史版本用 sheet version 系列命令"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws drive download-version --node \u003cdentryUuid\u003e --version 3 --output ./report_v3.pdf"
],
"field_provenance": {
"agent_summary": {
"value": "下载钉盘普通文件的指定历史版本到本地（两步下载：取签名 URL 后 HTTP GET）",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "下载钉盘普通文件的指定历史版本到本地（两步下载：取签名 URL 后 HTTP GET）",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"下载最新版本用 drive download",
"在线文档（adoc）历史版本用 doc version 系列命令",
"在线表格（axls）历史版本用 sheet version 系列命令"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"下载最新版本用 drive download",
"在线文档（adoc）历史版本用 doc version 系列命令",
"在线表格（axls）历史版本用 sheet version 系列命令"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive download-version --node \u003cdentryUuid\u003e --version 3 --output ./report_v3.pdf"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive download-version --node \u003cdentryUuid\u003e --version 3 --output ./report_v3.pdf"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"用户要下载文件的历史版本/旧版本",
"版本号已通过 drive list --versions 获取"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户要下载文件的历史版本/旧版本",
"版本号已通过 drive list --versions 获取"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl"
],
"use_when": [
"用户要下载文件的历史版本/旧版本",
"版本号已通过 drive list --versions 获取"
]
},
"drive info": {
"agent_summary": "获取文件元数据信息",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"要读在线文档正文改用 dws doc read（先本命令或 doc info 确认类型）",
"要下载普通文件改用 dws drive download",
"只要目录列表改用 dws drive list"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws drive info --node \u003cdentryUuid\u003e --format json"
],
"field_provenance": {
"agent_summary": {
"value": "获取文件元数据信息",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "获取文件元数据信息",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "available",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.get_file_info.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"avoid_when": {
"value": [
"要读在线文档正文改用 dws doc read（先本命令或 doc info 确认类型）",
"要下载普通文件改用 dws drive download",
"只要目录列表改用 dws drive list"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"要读在线文档正文改用 dws doc read（先本命令或 doc info 确认类型）",
"要下载普通文件改用 dws drive download",
"只要目录列表改用 dws drive list"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "read",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive info --node \u003cdentryUuid\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive info --node \u003cdentryUuid\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "idempotent",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "mcp",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.get_file_info.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"interface_ref": {
"value": "drive.get_file_info",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "drive.get_file_info",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "drive.get_file_info",
"source": "internal/cli/schema_hints/imported/wukong.json",
"precedence": "imported",
"selected": false
},
{
"value": "drive.get_file_info",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.get_file_info.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "low",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"用户要查看钉盘文件/文件夹元信息（名称、类型、大小、路径、时间）时",
"准备读内容前需先判断 extension/是否在线文档，再路由到 doc read / sheet / download 时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户要查看钉盘文件/文件夹元信息（名称、类型、大小、路径、时间）时",
"准备读内容前需先判断 extension/是否在线文档，再路由到 doc read / sheet / download 时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
}
},
"idempotency": "idempotent",
"interface_mode": "mcp",
"interface_ref": {
"product_id": "drive",
"rpc_name": "get_file_info"
},
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl",
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.get_file_info",
"internal/cli/schema_hints/imported/wukong.json",
"internal/cli/schema_mcp_metadata.json#tools.drive.get_file_info",
"skills/mono/references/products/drive.md"
],
"use_when": [
"用户要查看钉盘文件/文件夹元信息（名称、类型、大小、路径、时间）时",
"准备读内容前需先判断 extension/是否在线文档，再路由到 doc read / sheet / download 时"
]
},
"drive list": {
"agent_summary": "获取文件/文件夹列表",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"只记得关键词、不知道所在目录时改用 dws drive search",
"明确要在某个知识库内按目录浏览且已有 workspaceId 时可用 dws wiki node list",
"要找最近打开/编辑过的文档改用 dws drive recent"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws drive list --limit 20 --format json",
"dws drive list --folder \u003cdentryUuid\u003e --limit 20 --format json"
],
"field_provenance": {
"agent_summary": {
"value": "获取文件/文件夹列表",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "获取文件/文件夹列表",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "available",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_files.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"avoid_when": {
"value": [
"只记得关键词、不知道所在目录时改用 dws drive search",
"明确要在某个知识库内按目录浏览且已有 workspaceId 时可用 dws wiki node list",
"要找最近打开/编辑过的文档改用 dws drive recent"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"只记得关键词、不知道所在目录时改用 dws drive search",
"明确要在某个知识库内按目录浏览且已有 workspaceId 时可用 dws wiki node list",
"要找最近打开/编辑过的文档改用 dws drive recent"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "read",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive list --limit 20 --format json",
"dws drive list --folder \u003cdentryUuid\u003e --limit 20 --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive list --limit 20 --format json",
"dws drive list --folder \u003cdentryUuid\u003e --limit 20 --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "idempotent",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "mcp",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_files.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
],
"overridden_candidates": [
{
"value": "drive.list_files",
"source": "internal/cli/schema_hints/imported/wukong.json",
"precedence": "imported",
"selected": false
},
{
"value": "drive.list_files",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_files.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "low",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"用户要浏览「我的文件」/钉盘/网盘某目录下有哪些文件或文件夹时",
"已知父文件夹 dentryUuid，要列出其子项以便继续 download/copy/move 时",
"传 --workspace 时要列出文档空间/知识库根或子目录（与 wiki node list 场景重叠时，用户说钉盘/我的文件优先本命令）"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户要浏览「我的文件」/钉盘/网盘某目录下有哪些文件或文件夹时",
"已知父文件夹 dentryUuid，要列出其子项以便继续 download/copy/move 时",
"传 --workspace 时要列出文档空间/知识库根或子目录（与 wiki node list 场景重叠时，用户说钉盘/我的文件优先本命令）"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl",
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.list_files",
"internal/cli/schema_hints/imported/wukong.json",
"internal/cli/schema_mcp_metadata.json#tools.drive.list_files",
"skills/mono/references/intent-guide.md",
"skills/mono/references/products/doc.md",
"skills/mono/references/products/drive.md"
],
"use_when": [
"用户要浏览「我的文件」/钉盘/网盘某目录下有哪些文件或文件夹时",
"已知父文件夹 dentryUuid，要列出其子项以便继续 download/copy/move 时",
"传 --workspace 时要列出文档空间/知识库根或子目录（与 wiki node list 场景重叠时，用户说钉盘/我的文件优先本命令）"
]
},
"drive list-spaces": {
"agent_summary": "兼容查询钉盘空间列表",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"推荐改用 dws wiki space list --type orgSpace 或 --type mySpace（本命令已 deprecated）",
"要列知识库列表改用 dws wiki space list（默认 orgWikiSpace）"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"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": {
"value": "兼容查询钉盘空间列表",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "兼容查询钉盘空间列表",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "available",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_spaces.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"avoid_when": {
"value": [
"推荐改用 dws wiki space list --type orgSpace 或 --type mySpace（本命令已 deprecated）",
"要列知识库列表改用 dws wiki space list（默认 orgWikiSpace）"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"推荐改用 dws wiki space list --type orgSpace 或 --type mySpace（本命令已 deprecated）",
"要列知识库列表改用 dws wiki space list（默认 orgWikiSpace）"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "read",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive list-spaces --space-type orgSpace --limit 20 --format json",
"dws drive list-spaces --space-type mySpace --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive list-spaces --space-type orgSpace --limit 20 --format json",
"dws drive list-spaces --space-type mySpace --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "idempotent",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "mcp",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_spaces.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"interface_ref": {
"value": "drive.list_spaces",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "drive.list_spaces",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "drive.list_spaces",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_spaces.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": false,
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_spaces",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "low",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"兼容入口：枚举钉盘企业空间或「我的文件」空间以拿 spaceId/rootFolderId 时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"兼容入口：枚举钉盘企业空间或「我的文件」空间以拿 spaceId/rootFolderId 时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
}
},
"idempotency": "idempotent",
"interface_mode": "mcp",
"interface_ref": {
"product_id": "drive",
"rpc_name": "list_spaces"
},
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl",
"internal/cli/schema_mcp_metadata.json#tools.drive.list_spaces",
"skills/mono/references/intent-guide.md",
"skills/mono/references/products/drive.md"
],
"use_when": [
"兼容入口：枚举钉盘企业空间或「我的文件」空间以拿 spaceId/rootFolderId 时"
]
},
"drive mkdir": {
"agent_summary": "创建文件夹",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"要在知识库内建文件夹改用 dws wiki node create --type folder --workspace \u003cid\u003e",
"要创建在线文档(adoc)改用 dws doc create 或 wiki node create --type adoc"
],
"confirmation": "not_required",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws drive mkdir --name \"项目资料\" --format json",
"dws drive mkdir --name \"子目录\" --folder \u003cdentryUuid\u003e --format json"
],
"field_provenance": {
"agent_summary": {
"value": "创建文件夹",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "创建文件夹",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "available",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.create_folder.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"avoid_when": {
"value": [
"要在知识库内建文件夹改用 dws wiki node create --type folder --workspace \u003cid\u003e",
"要创建在线文档(adoc)改用 dws doc create 或 wiki node create --type adoc"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"要在知识库内建文件夹改用 dws wiki node create --type folder --workspace \u003cid\u003e",
"要创建在线文档(adoc)改用 dws doc create 或 wiki node create --type adoc"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "write",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive mkdir --name \"项目资料\" --format json",
"dws drive mkdir --name \"子目录\" --folder \u003cdentryUuid\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive mkdir --name \"项目资料\" --format json",
"dws drive mkdir --name \"子目录\" --folder \u003cdentryUuid\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "unknown",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "mcp",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.create_folder.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"interface_ref": {
"value": "drive.create_folder",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "drive.create_folder",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "drive.create_folder",
"source": "internal/cli/schema_hints/imported/wukong.json",
"precedence": "imported",
"selected": false
},
{
"value": "drive.create_folder",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.create_folder.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "medium",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"用户要在钉盘/「我的文件」下新建普通文件夹时",
"已知父目录 dentryUuid，要在其下建子目录时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户要在钉盘/「我的文件」下新建普通文件夹时",
"已知父目录 dentryUuid，要在其下建子目录时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
}
},
"idempotency": "unknown",
"interface_mode": "mcp",
"interface_ref": {
"product_id": "drive",
"rpc_name": "create_folder"
},
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl",
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.create_folder",
"internal/cli/schema_hints/imported/wukong.json",
"internal/cli/schema_mcp_metadata.json#tools.drive.create_folder",
"skills/mono/references/products/doc.md",
"skills/mono/references/products/drive.md"
],
"use_when": [
"用户要在钉盘/「我的文件」下新建普通文件夹时",
"已知父目录 dentryUuid，要在其下建子目录时"
]
},
"drive move": {
"agent_summary": "将文件或文档移动到目标文件夹或知识库（原位置不再保留）",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"需要保留原位置副本时改用 dws drive copy",
"目标未确认或用户只是想复制时不要 move",
"知识库内节点移动且走 wiki 入口时可用 dws wiki node move"
],
"confirmation": "not_required",
"effect": "write",
"effect_source": "corecmd.contract",
"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": {
"value": "将文件或文档移动到目标文件夹或知识库（原位置不再保留）",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "将文件或文档移动到目标文件夹或知识库（原位置不再保留）",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "available",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.move_document.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"avoid_when": {
"value": [
"需要保留原位置副本时改用 dws drive copy",
"目标未确认或用户只是想复制时不要 move",
"知识库内节点移动且走 wiki 入口时可用 dws wiki node move"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"需要保留原位置副本时改用 dws drive copy",
"目标未确认或用户只是想复制时不要 move",
"知识库内节点移动且走 wiki 入口时可用 dws wiki node move"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "write",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"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"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "unknown",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "mcp",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.move_document.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"interface_ref": {
"value": "doc.move_document",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "doc.move_document",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "doc.move_document",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.move_document.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": false,
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.move_document",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "medium",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"用户要移动/搬走文件或文档到新位置，且原位置不再保留时（move≠copy）",
"目标文件夹用 --folder；目标知识库根用 --workspace；都不传则默认「我的文档」",
"移动到其他钉盘 space 根目录时传目标 space 的 rootFolderId 到 --folder（通常不传 --workspace）"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户要移动/搬走文件或文档到新位置，且原位置不再保留时（move≠copy）",
"目标文件夹用 --folder；目标知识库根用 --workspace；都不传则默认「我的文档」",
"移动到其他钉盘 space 根目录时传目标 space 的 rootFolderId 到 --folder（通常不传 --workspace）"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
}
},
"idempotency": "unknown",
"interface_mode": "mcp",
"interface_ref": {
"product_id": "doc",
"rpc_name": "move_document"
},
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl",
"internal/cli/schema_mcp_metadata.json#tools.drive.move_document",
"skills/mono/references/products/drive.md"
],
"use_when": [
"用户要移动/搬走文件或文档到新位置，且原位置不再保留时（move≠copy）",
"目标文件夹用 --folder；目标知识库根用 --workspace；都不传则默认「我的文档」",
"移动到其他钉盘 space 根目录时传目标 space 的 rootFolderId 到 --folder（通常不传 --workspace）"
]
},
"drive permission add": {
"agent_summary": "为文档空间节点添加协作成员并授予指定角色",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"给整个知识库加成员改用 dws wiki member add（「我的文档」不支持容器成员）",
"只查已有权限改用 dws drive permission list",
"改角色/移除分别用 permission update / remove"
],
"confirmation": "not_required",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws drive permission add --node \u003cID\u003e --users uid1,uid2 --role READER --format json"
],
"field_provenance": {
"agent_summary": {
"value": "为文档空间节点添加协作成员并授予指定角色",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "为文档空间节点添加协作成员并授予指定角色",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "available",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.add_permission.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"avoid_when": {
"value": [
"给整个知识库加成员改用 dws wiki member add（「我的文档」不支持容器成员）",
"只查已有权限改用 dws drive permission list",
"改角色/移除分别用 permission update / remove"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"给整个知识库加成员改用 dws wiki member add（「我的文档」不支持容器成员）",
"只查已有权限改用 dws drive permission list",
"改角色/移除分别用 permission update / remove"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "write",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive permission add --node \u003cID\u003e --users uid1,uid2 --role READER --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive permission add --node \u003cID\u003e --users uid1,uid2 --role READER --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "unknown",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "mcp",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.add_permission.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"interface_ref": {
"value": "doc.add_permission",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "doc.add_permission",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "doc.add_permission",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.add_permission.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": false,
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.add_permission",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "medium",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"给单篇文档/文件夹/文件做节点级授权（USER + 角色 MANAGER/EDITOR/DOWNLOADER/READER）时",
"用户说把某篇文档分享给某人看/可编辑时（含「我的文档」下的节点）"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"给单篇文档/文件夹/文件做节点级授权（USER + 角色 MANAGER/EDITOR/DOWNLOADER/READER）时",
"用户说把某篇文档分享给某人看/可编辑时（含「我的文档」下的节点）"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
}
},
"idempotency": "unknown",
"interface_mode": "mcp",
"interface_ref": {
"product_id": "doc",
"rpc_name": "add_permission"
},
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl",
"internal/cli/schema_mcp_metadata.json#tools.drive.add_permission",
"skills/mono/references/products/drive.md"
],
"use_when": [
"给单篇文档/文件夹/文件做节点级授权（USER + 角色 MANAGER/EDITOR/DOWNLOADER/READER）时",
"用户说把某篇文档分享给某人看/可编辑时（含「我的文档」下的节点）"
]
},
"drive permission apply": {
"agent_summary": "向审批人发起文档权限申请（会真实通知审批人）",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"先用 apply-info 查可申请角色与审批人；未经用户确认不得自行提交"
],
"confirmation": "user_required",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws drive permission apply --node \u003cDOC_ID\u003e --role READER --users \u003c审批人userId\u003e --format json"
],
"field_provenance": {
"agent_summary": {
"value": "向审批人发起文档权限申请（会真实通知审批人）",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "向审批人发起文档权限申请（会真实通知审批人）",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"先用 apply-info 查可申请角色与审批人；未经用户确认不得自行提交"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"先用 apply-info 查可申请角色与审批人；未经用户确认不得自行提交"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "user_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "user_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive permission apply --node \u003cDOC_ID\u003e --role READER --users \u003c审批人userId\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive permission apply --node \u003cDOC_ID\u003e --role READER --users \u003c审批人userId\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "non_idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "non_idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"用户确认要为无权限文档发起权限申请"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户确认要为无权限文档发起权限申请"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl"
],
"use_when": [
"用户确认要为无权限文档发起权限申请"
]
},
"drive permission apply-info": {
"agent_summary": "查询节点可申请的权限角色列表与审批人列表",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"实际发起申请用 apply_permission"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws drive permission apply-info --node \u003cDOC_ID\u003e --format json"
],
"field_provenance": {
"agent_summary": {
"value": "查询节点可申请的权限角色列表与审批人列表",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "查询节点可申请的权限角色列表与审批人列表",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"实际发起申请用 apply_permission"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"实际发起申请用 apply_permission"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive permission apply-info --node \u003cDOC_ID\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive permission apply-info --node \u003cDOC_ID\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"无权限访问文档时，先查可申请角色与审批人"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"无权限访问文档时，先查可申请角色与审批人"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl"
],
"use_when": [
"无权限访问文档时，先查可申请角色与审批人"
]
},
"drive permission list": {
"agent_summary": "查询文档空间节点的协作者列表",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"要新增/修改/移除权限分别用 permission add/update/remove",
"查知识库容器成员改用 dws wiki member list"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws drive permission list --node \u003cID\u003e --format json"
],
"field_provenance": {
"agent_summary": {
"value": "查询文档空间节点的协作者列表",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "查询文档空间节点的协作者列表",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "available",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_permission.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"avoid_when": {
"value": [
"要新增/修改/移除权限分别用 permission add/update/remove",
"查知识库容器成员改用 dws wiki member list"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"要新增/修改/移除权限分别用 permission add/update/remove",
"查知识库容器成员改用 dws wiki member list"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "read",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive permission list --node \u003cID\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive permission list --node \u003cID\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "idempotent",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "mcp",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_permission.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"interface_ref": {
"value": "doc.list_permission",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "doc.list_permission",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "doc.list_permission",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_permission.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": false,
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.list_permission",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "low",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"查看某文档/文件夹节点当前有哪些成员及角色时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"查看某文档/文件夹节点当前有哪些成员及角色时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
}
},
"idempotency": "idempotent",
"interface_mode": "mcp",
"interface_ref": {
"product_id": "doc",
"rpc_name": "list_permission"
},
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl",
"internal/cli/schema_mcp_metadata.json#tools.drive.list_permission",
"skills/mono/references/products/drive.md"
],
"use_when": [
"查看某文档/文件夹节点当前有哪些成员及角色时"
]
},
"drive permission remove": {
"agent_summary": "从文档空间节点移除协作成员的权限",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"要改角色用 permission update；要加权限用 add",
"移除知识库容器成员用 dws wiki member remove"
],
"confirmation": "not_required",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws drive permission remove --node \u003cID\u003e --users uid1 --format json"
],
"field_provenance": {
"agent_summary": {
"value": "从文档空间节点移除协作成员的权限",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "从文档空间节点移除协作成员的权限",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "available",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.permission_remove.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"avoid_when": {
"value": [
"要改角色用 permission update；要加权限用 add",
"移除知识库容器成员用 dws wiki member remove"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"要改角色用 permission update；要加权限用 add",
"移除知识库容器成员用 dws wiki member remove"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "write",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive permission remove --node \u003cID\u003e --users uid1 --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive permission remove --node \u003cID\u003e --users uid1 --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "unknown",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "mcp",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.permission_remove.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"interface_ref": {
"value": "doc.remove_permission",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "doc.remove_permission",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "doc.remove_permission",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.permission_remove.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": false,
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.permission_remove",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "medium",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"从节点移除指定用户的直接授权时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"从节点移除指定用户的直接授权时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
}
},
"idempotency": "unknown",
"interface_mode": "mcp",
"interface_ref": {
"product_id": "doc",
"rpc_name": "remove_permission"
},
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl",
"internal/cli/schema_mcp_metadata.json#tools.drive.permission_remove",
"skills/mono/references/products/drive.md"
],
"use_when": [
"从节点移除指定用户的直接授权时"
]
},
"drive permission transfer-owner": {
"agent_summary": "转交文档或知识库所有者给指定用户（不可逆）",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"普通协作权限变更用 permission add/update/remove"
],
"confirmation": "user_required",
"effect": "write",
"effect_source": "corecmd.contract",
"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": {
"value": "转交文档或知识库所有者给指定用户（不可逆）",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "转交文档或知识库所有者给指定用户（不可逆）",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"普通协作权限变更用 permission add/update/remove"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"普通协作权限变更用 permission add/update/remove"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "user_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "user_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive permission transfer-owner --node \u003cDOC_ID\u003e --new-owner \u003cuserId\u003e --reserve-role EDITOR --recursive=false --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive permission transfer-owner --node \u003cDOC_ID\u003e --new-owner \u003cuserId\u003e --reserve-role EDITOR --recursive=false --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "non_idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "non_idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "high",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "high",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"用户明确要求转交文档/知识库所有权"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户明确要求转交文档/知识库所有权"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "high",
"source_refs": [
"corecmd.SchemaDecl"
],
"use_when": [
"用户明确要求转交文档/知识库所有权"
]
},
"drive permission update": {
"agent_summary": "更新文档空间节点已有协作者的权限角色",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"成员尚无权限时改用 permission add",
"要移除访问改用 permission remove"
],
"confirmation": "not_required",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws drive permission update --node \u003cID\u003e --users uid1 --role EDITOR --format json"
],
"field_provenance": {
"agent_summary": {
"value": "更新文档空间节点已有协作者的权限角色",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "更新文档空间节点已有协作者的权限角色",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "available",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.permission_update.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"avoid_when": {
"value": [
"成员尚无权限时改用 permission add",
"要移除访问改用 permission remove"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"成员尚无权限时改用 permission add",
"要移除访问改用 permission remove"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "write",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive permission update --node \u003cID\u003e --users uid1 --role EDITOR --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive permission update --node \u003cID\u003e --users uid1 --role EDITOR --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "unknown",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "mcp",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.permission_update.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"interface_ref": {
"value": "doc.update_permission",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "doc.update_permission",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "doc.update_permission",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.permission_update.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": false,
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.permission_update",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "medium",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"调整已有节点成员角色（如 READER→EDITOR）时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"调整已有节点成员角色（如 READER→EDITOR）时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
}
},
"idempotency": "unknown",
"interface_mode": "mcp",
"interface_ref": {
"product_id": "doc",
"rpc_name": "update_permission"
},
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl",
"internal/cli/schema_mcp_metadata.json#tools.drive.permission_update",
"skills/mono/references/products/drive.md"
],
"use_when": [
"调整已有节点成员角色（如 READER→EDITOR）时"
]
},
"drive publish get": {
"agent_summary": "查询文件当前是否处于互联网公开发布状态",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"要开启公开改用 dws drive publish set（需确认）",
"要关闭公开改用 dws drive publish unset（需确认）"
],
"confirmation": "not_required",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws drive publish get --node \u003cfileId\u003e --format json"
],
"field_provenance": {
"agent_summary": {
"value": "查询文件当前是否处于互联网公开发布状态",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "查询文件当前是否处于互联网公开发布状态",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"要开启公开改用 dws drive publish set（需确认）",
"要关闭公开改用 dws drive publish unset（需确认）"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"要开启公开改用 dws drive publish set（需确认）",
"要关闭公开改用 dws drive publish unset（需确认）"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "write",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive publish get --node \u003cfileId\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive publish get --node \u003cfileId\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "unknown",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "medium",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"查询文件是否已互联网公开发布及公开权限（READER/DOWNLOADER/EDITOR）时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"查询文件是否已互联网公开发布及公开权限（READER/DOWNLOADER/EDITOR）时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl",
"skills/mono/references/products/drive.md"
],
"use_when": [
"查询文件是否已互联网公开发布及公开权限（READER/DOWNLOADER/EDITOR）时"
]
},
"drive publish set": {
"agent_summary": "开启文件的互联网公开发布",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"只查公开状态用 publish get；要关闭公开用 publish unset",
"目标文件或公开权限范围未确认时不要开启",
"只要企业内部同事权限用 permission add，不要用互联网公开"
],
"confirmation": "user_required",
"effect": "write",
"effect_source": "corecmd.contract",
"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": {
"value": "开启文件的互联网公开发布",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "开启文件的互联网公开发布",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"只查公开状态用 publish get；要关闭公开用 publish unset",
"目标文件或公开权限范围未确认时不要开启",
"只要企业内部同事权限用 permission add，不要用互联网公开"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"只查公开状态用 publish get；要关闭公开用 publish unset",
"目标文件或公开权限范围未确认时不要开启",
"只要企业内部同事权限用 permission add，不要用互联网公开"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "user_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "user_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "write",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive publish set --node \u003cfileId\u003e --format json",
"dws drive publish set --node \u003cfileId\u003e --permission READER --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive publish set --node \u003cfileId\u003e --format json",
"dws drive publish set --node \u003cfileId\u003e --permission READER --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "unknown",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "medium",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"用户明确要求将文件设为互联网公开（任何人凭链接可访问，无需登录）时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户明确要求将文件设为互联网公开（任何人凭链接可访问，无需登录）时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl",
"skills/mono/references/products/drive.md"
],
"use_when": [
"用户明确要求将文件设为互联网公开（任何人凭链接可访问，无需登录）时"
]
},
"drive publish unset": {
"agent_summary": "关闭文件的互联网公开发布",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"只查状态用 publish get；要开启用 publish set",
"目标文件未确认时不要关闭"
],
"confirmation": "user_required",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws drive publish unset --node \u003cfileId\u003e --format json"
],
"field_provenance": {
"agent_summary": {
"value": "关闭文件的互联网公开发布",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "关闭文件的互联网公开发布",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"只查状态用 publish get；要开启用 publish set",
"目标文件未确认时不要关闭"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"只查状态用 publish get；要开启用 publish set",
"目标文件未确认时不要关闭"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "user_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "user_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "write",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive publish unset --node \u003cfileId\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive publish unset --node \u003cfileId\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "unknown",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "medium",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"用户明确要求关闭文件的互联网公开发布，使外部链接失效时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户明确要求关闭文件的互联网公开发布，使外部链接失效时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl",
"skills/mono/references/products/drive.md"
],
"use_when": [
"用户明确要求关闭文件的互联网公开发布，使外部链接失效时"
]
},
"drive recent": {
"agent_summary": "获取当前用户最近访问或编辑过的文档列表",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"按关键词全局搜文件改用 dws drive search",
"浏览某目录内容改用 dws drive list"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws drive recent --format json",
"dws drive recent --operate-type 1 --format json"
],
"field_provenance": {
"agent_summary": {
"value": "获取当前用户最近访问或编辑过的文档列表",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "获取当前用户最近访问或编辑过的文档列表",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"按关键词全局搜文件改用 dws drive search",
"浏览某目录内容改用 dws drive list"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"按关键词全局搜文件改用 dws drive search",
"浏览某目录内容改用 dws drive list"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive recent --format json",
"dws drive recent --operate-type 1 --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive recent --format json",
"dws drive recent --operate-type 1 --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"用户要看最近访问或最近编辑的文档列表时（默认最近访问 operate-type=0）",
"需要按我创建/他人创建或文档类型过滤最近项时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户要看最近访问或最近编辑的文档列表时（默认最近访问 operate-type=0）",
"需要按我创建/他人创建或文档类型过滤最近项时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl",
"skills/mono/references/products/drive.md"
],
"use_when": [
"用户要看最近访问或最近编辑的文档列表时（默认最近访问 operate-type=0）",
"需要按我创建/他人创建或文档类型过滤最近项时"
]
},
"drive recycle list": {
"agent_summary": "查看回收站文件列表",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"要从回收站还原改用 dws drive recycle restore",
"要删除进回收站改用 dws drive delete"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws drive recycle list --format json",
"dws drive recycle list --space-id 12345 --limit 10 --format json"
],
"field_provenance": {
"agent_summary": {
"value": "查看回收站文件列表",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "查看回收站文件列表",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"要从回收站还原改用 dws drive recycle restore",
"要删除进回收站改用 dws drive delete"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"要从回收站还原改用 dws drive recycle restore",
"要删除进回收站改用 dws drive delete"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "read",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive recycle list --format json",
"dws drive recycle list --space-id 12345 --limit 10 --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive recycle list --format json",
"dws drive recycle list --space-id 12345 --limit 10 --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "idempotent",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "low",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"用户要查看钉盘回收站里有哪些已删文件时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户要查看钉盘回收站里有哪些已删文件时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl",
"skills/mono/references/products/drive.md"
],
"use_when": [
"用户要查看钉盘回收站里有哪些已删文件时"
]
},
"drive recycle restore": {
"agent_summary": "还原回收站中的文件",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"尚未确认还原哪一项时先 dws drive recycle list",
"要删除文件改用 dws drive delete，不要用 restore"
],
"confirmation": "not_required",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws drive recycle restore --id \u003crecycleItemId\u003e --format json"
],
"field_provenance": {
"agent_summary": {
"value": "还原回收站中的文件",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "还原回收站中的文件",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"尚未确认还原哪一项时先 dws drive recycle list",
"要删除文件改用 dws drive delete，不要用 restore"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"尚未确认还原哪一项时先 dws drive recycle list",
"要删除文件改用 dws drive delete，不要用 restore"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive recycle restore --id \u003crecycleItemId\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive recycle restore --id \u003crecycleItemId\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"用户要从回收站还原指定回收项（已从 recycle list 拿到 id）时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户要从回收站还原指定回收项（已从 recycle list 拿到 id）时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl",
"skills/mono/references/products/drive.md"
],
"use_when": [
"用户要从回收站还原指定回收项（已从 recycle list 拿到 id）时"
]
},
"drive rename": {
"agent_summary": "安全重命名文档空间中的文档、文件或文件夹，并按节点真实扩展名避免双后缀",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"要改正文里的标题/章节 H1 改用 dws doc block update，不要用 rename",
"只要复制或移动改用 copy/move",
"dry-run 不读取节点元数据，输出名称尚未做基于当前扩展名的规范化"
],
"confirmation": "not_required",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws drive rename --node \u003cID\u003e --name \"新名称\" --format json"
],
"field_provenance": {
"agent_summary": {
"value": "安全重命名文档空间中的文档、文件或文件夹，并按节点真实扩展名避免双后缀",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "安全重命名文档空间中的文档、文件或文件夹，并按节点真实扩展名避免双后缀",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "available",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.rename_document.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"avoid_when": {
"value": [
"要改正文里的标题/章节 H1 改用 dws doc block update，不要用 rename",
"只要复制或移动改用 copy/move",
"dry-run 不读取节点元数据，输出名称尚未做基于当前扩展名的规范化"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"要改正文里的标题/章节 H1 改用 dws doc block update，不要用 rename",
"只要复制或移动改用 copy/move",
"dry-run 不读取节点元数据，输出名称尚未做基于当前扩展名的规范化"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "write",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive rename --node \u003cID\u003e --name \"新名称\" --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive rename --node \u003cID\u003e --name \"新名称\" --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "unknown",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "mcp",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.rename_document.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"interface_ref": {
"value": "doc.rename_document",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "doc.rename_document",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "doc.rename_document",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.rename_document.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/drive.json",
"precedence": "reviewed_explicit",
"selected": false,
"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."
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "medium",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"用户要重命名钉盘/文档空间中的文件、文档或文件夹时；实际执行会读取节点类型和当前扩展名，仅去掉完全匹配的一层后缀"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户要重命名钉盘/文档空间中的文件、文档或文件夹时；实际执行会读取节点类型和当前扩展名，仅去掉完全匹配的一层后缀"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
}
},
"idempotency": "unknown",
"interface_mode": "mcp",
"interface_ref": {
"product_id": "doc",
"rpc_name": "rename_document"
},
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/drive.json",
"internal/cli/schema_mcp_metadata.json#tools.drive.rename_document",
"skills/mono/references/products/drive.md"
],
"use_when": [
"用户要重命名钉盘/文档空间中的文件、文档或文件夹时；实际执行会读取节点类型和当前扩展名，仅去掉完全匹配的一层后缀"
]
},
"drive revert": {
"agent_summary": "回滚普通文件到指定历史版本（生成新最新版本，历史不丢失）",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"在线文档回滚用 doc version revert；在线表格用 sheet version revert"
],
"confirmation": "user_required",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws drive revert --node \u003cdentryUuid\u003e --version 3 --format json"
],
"field_provenance": {
"agent_summary": {
"value": "回滚普通文件到指定历史版本（生成新最新版本，历史不丢失）",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "回滚普通文件到指定历史版本（生成新最新版本，历史不丢失）",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"在线文档回滚用 doc version revert；在线表格用 sheet version revert"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"在线文档回滚用 doc version revert；在线表格用 sheet version revert"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "user_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "user_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive revert --node \u003cdentryUuid\u003e --version 3 --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive revert --node \u003cdentryUuid\u003e --version 3 --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "non_idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "non_idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"用户说 回滚版本/恢复到某个版本/版本回退，且目标是普通文件"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户说 回滚版本/恢复到某个版本/版本回退，且目标是普通文件"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl"
],
"use_when": [
"用户说 回滚版本/恢复到某个版本/版本回退，且目标是普通文件"
]
},
"drive search": {
"agent_summary": "全局搜索文件，默认同时搜索钉盘和文档空间，合并返回结果",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"已明确知识库 workspaceId、只在该库内搜时改用 dws wiki node search --workspace \u003cid\u003e",
"已知目录、只需浏览子项时改用 dws drive list，不要用搜索代替目录遍历",
"首页未命中时优先改关键词/过滤条件，而不是反复翻页"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws drive search --query \"季度汇报\" --format json",
"dws drive search --query \"合同\" --target file --extensions pdf,docx --format json"
],
"field_provenance": {
"agent_summary": {
"value": "全局搜索文件，默认同时搜索钉盘和文档空间，合并返回结果",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "全局搜索文件，默认同时搜索钉盘和文档空间，合并返回结果",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "available",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.search_files.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"avoid_when": {
"value": [
"已明确知识库 workspaceId、只在该库内搜时改用 dws wiki node search --workspace \u003cid\u003e",
"已知目录、只需浏览子项时改用 dws drive list，不要用搜索代替目录遍历",
"首页未命中时优先改关键词/过滤条件，而不是反复翻页"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"已明确知识库 workspaceId、只在该库内搜时改用 dws wiki node search --workspace \u003cid\u003e",
"已知目录、只需浏览子项时改用 dws drive list，不要用搜索代替目录遍历",
"首页未命中时优先改关键词/过滤条件，而不是反复翻页"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "read",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive search --query \"季度汇报\" --format json",
"dws drive search --query \"合同\" --target file --extensions pdf,docx --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive search --query \"季度汇报\" --format json",
"dws drive search --query \"合同\" --target file --extensions pdf,docx --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "idempotent",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "mcp",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.search_files.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"interface_ref": {
"value": "drive.search_files",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "drive.search_files",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "drive.search_files",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.search_files.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": false,
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.search_files",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "low",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"用户要在钉盘/我的文件里按关键词找文件、文件夹或团队空间，且不知道具体路径时",
"需要按扩展名/文件类型/创建者/时间缩小范围的全局搜索（默认 target=all 聚合钉盘+文档空间）",
"明确搜团队空间名以拿 spaceId/rootFolderId 时用 --target space"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户要在钉盘/我的文件里按关键词找文件、文件夹或团队空间，且不知道具体路径时",
"需要按扩展名/文件类型/创建者/时间缩小范围的全局搜索（默认 target=all 聚合钉盘+文档空间）",
"明确搜团队空间名以拿 spaceId/rootFolderId 时用 --target space"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
}
},
"idempotency": "idempotent",
"interface_mode": "mcp",
"interface_ref": {
"product_id": "drive",
"rpc_name": "search_files"
},
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl",
"internal/cli/schema_mcp_metadata.json#tools.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"
],
"use_when": [
"用户要在钉盘/我的文件里按关键词找文件、文件夹或团队空间，且不知道具体路径时",
"需要按扩展名/文件类型/创建者/时间缩小范围的全局搜索（默认 target=all 聚合钉盘+文档空间）",
"明确搜团队空间名以拿 spaceId/rootFolderId 时用 --target space"
]
},
"drive shortcut": {
"agent_summary": "为钉盘或文档空间中的现有节点创建快捷方式。",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"要复制一份独立副本改用 dws drive copy（copy≠shortcut）",
"要移动原文件改用 dws drive move"
],
"confirmation": "not_required",
"effect": "write",
"effect_source": "corecmd.contract",
"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": {
"value": "为钉盘或文档空间中的现有节点创建快捷方式。",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "为钉盘或文档空间中的现有节点创建快捷方式。",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"要复制一份独立副本改用 dws drive copy（copy≠shortcut）",
"要移动原文件改用 dws drive move"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"要复制一份独立副本改用 dws drive copy（copy≠shortcut）",
"要移动原文件改用 dws drive move"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive shortcut --node \u003cSOURCE_NODE\u003e --format json",
"dws drive shortcut --node \u003cSOURCE_NODE\u003e --folder \u003cTARGET_FOLDER\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive shortcut --node \u003cSOURCE_NODE\u003e --format json",
"dws drive shortcut --node \u003cSOURCE_NODE\u003e --folder \u003cTARGET_FOLDER\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "non_idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "non_idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"用户要给已有节点建快捷方式/软链接到目标文件夹或知识库时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户要给已有节点建快捷方式/软链接到目标文件夹或知识库时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl",
"skills/mono/references/products/drive.md"
],
"use_when": [
"用户要给已有节点建快捷方式/软链接到目标文件夹或知识库时"
]
},
"drive star add": {
"agent_summary": "收藏文档/文件到当前用户收藏列表",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"取消收藏用 unmark_star；查看收藏列表用 get_star_list"
],
"confirmation": "not_required",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws drive star add --node \u003cnodeId\u003e --format json"
],
"field_provenance": {
"agent_summary": {
"value": "收藏文档/文件到当前用户收藏列表",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "收藏文档/文件到当前用户收藏列表",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"取消收藏用 unmark_star；查看收藏列表用 get_star_list"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"取消收藏用 unmark_star；查看收藏列表用 get_star_list"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive star add --node \u003cnodeId\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive star add --node \u003cnodeId\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"用户说 收藏这个文档/加个收藏/标星"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户说 收藏这个文档/加个收藏/标星"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl"
],
"use_when": [
"用户说 收藏这个文档/加个收藏/标星"
]
},
"drive star list": {
"agent_summary": "获取当前用户的收藏列表，支持分页与按内容类型筛选",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"操作单个收藏用 mark_star/unmark_star"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws drive star list --format json",
"dws drive star list --content-types doc,sheet --limit 10 --format json"
],
"field_provenance": {
"agent_summary": {
"value": "获取当前用户的收藏列表，支持分页与按内容类型筛选",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "获取当前用户的收藏列表，支持分页与按内容类型筛选",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"操作单个收藏用 mark_star/unmark_star"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"操作单个收藏用 mark_star/unmark_star"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive star list --format json",
"dws drive star list --content-types doc,sheet --limit 10 --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive star list --format json",
"dws drive star list --content-types doc,sheet --limit 10 --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"用户说 我的收藏/收藏列表/收藏了哪些文档"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户说 我的收藏/收藏列表/收藏了哪些文档"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl"
],
"use_when": [
"用户说 我的收藏/收藏列表/收藏了哪些文档"
]
},
"drive star remove": {
"agent_summary": "将文档/文件从当前用户收藏列表移除",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"添加收藏用 mark_star"
],
"confirmation": "not_required",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws drive star remove --node \u003cnodeId\u003e --format json"
],
"field_provenance": {
"agent_summary": {
"value": "将文档/文件从当前用户收藏列表移除",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "将文档/文件从当前用户收藏列表移除",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"添加收藏用 mark_star"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"添加收藏用 mark_star"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"examples": {
"value": [
"dws drive star remove --node \u003cnodeId\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive star remove --node \u003cnodeId\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"use_when": {
"value": [
"用户说 取消收藏/去掉收藏/不收藏了"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户说 取消收藏/去掉收藏/不收藏了"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl"
],
"use_when": [
"用户说 取消收藏/去掉收藏/不收藏了"
]
},
"drive stats": {
"agent_summary": "读取指定钉盘或文档空间节点的阅读、编辑、评论、点赞、预览与下载等统计。",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"要改文件内容或权限不要用本命令；本命令只读",
"只要元信息（名称/类型）改用 dws drive info 或 dws doc info"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws drive stats --node \u003cNODE_ID_OR_URL\u003e --format json"
],
"field_provenance": {
"agent_summary": {
"value": "读取指定钉盘或文档空间节点的阅读、编辑、评论、点赞、预览与下载等统计。",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "读取指定钉盘或文档空间节点的阅读、编辑、评论、点赞、预览与下载等统计。",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"要改文件内容或权限不要用本命令；本命令只读",
"只要元信息（名称/类型）改用 dws drive info 或 dws doc info"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"要改文件内容或权限不要用本命令；本命令只读",
"只要元信息（名称/类型）改用 dws drive info 或 dws doc info"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "read",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive stats --node \u003cNODE_ID_OR_URL\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive stats --node \u003cNODE_ID_OR_URL\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "idempotent",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"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.",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "low",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"用户要查看节点阅读/编辑/评论/点赞/预览/下载等统计维度时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户要查看节点阅读/编辑/评论/点赞/预览/下载等统计维度时"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": 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.",
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl",
"skills/mono/references/products/drive.md"
],
"use_when": [
"用户要查看节点阅读/编辑/评论/点赞/预览/下载等统计维度时"
]
},
"drive upload": {
"agent_summary": "上传本地文件到钉盘或文档空间，或按节点 ID 确认覆盖已有文件",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"常规场景不要拆成 upload-info + 手动 PUT + commit；仅自定义流式上传才用三步",
"要把文件作为文档正文附件插入改用 dws doc media insert",
"用户明确说文档空间且走 doc 兼容入口时可用 dws doc upload，默认仍推荐本命令",
"用户没有明确同意替换目标文件时不要使用 --node；新建上传应使用 --folder 或目标根目录"
],
"confirmation": "not_required",
"effect": "write",
"effect_source": "corecmd.contract",
"examples": [
"dws drive upload --file ./report.pdf --format json",
"dws drive upload --file ./README.md --node \u003cdentryUuid\u003e --format json"
],
"field_provenance": {
"agent_summary": {
"value": "上传本地文件到钉盘或文档空间，或按节点 ID 确认覆盖已有文件",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "上传本地文件到钉盘或文档空间，或按节点 ID 确认覆盖已有文件",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"avoid_when": {
"value": [
"常规场景不要拆成 upload-info + 手动 PUT + commit；仅自定义流式上传才用三步",
"要把文件作为文档正文附件插入改用 dws doc media insert",
"用户明确说文档空间且走 doc 兼容入口时可用 dws doc upload，默认仍推荐本命令",
"用户没有明确同意替换目标文件时不要使用 --node；新建上传应使用 --folder 或目标根目录"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"常规场景不要拆成 upload-info + 手动 PUT + commit；仅自定义流式上传才用三步",
"要把文件作为文档正文附件插入改用 dws doc media insert",
"用户明确说文档空间且走 doc 兼容入口时可用 dws doc upload，默认仍推荐本命令",
"用户没有明确同意替换目标文件时不要使用 --node；新建上传应使用 --folder 或目标根目录"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "write",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "write",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive upload --file ./report.pdf --format json",
"dws drive upload --file ./README.md --node \u003cdentryUuid\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive upload --file ./report.pdf --format json",
"dws drive upload --file ./README.md --node \u003cdentryUuid\u003e --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "unknown",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "unknown",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "composite",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_reason": {
"value": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"interface_ref": {
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "interface_disposition_matrix",
"review_reason": "final interface mode composite forbids a direct MCP interface_ref",
"candidates": [
{
"value": null,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true,
"review_reason": "final interface mode composite forbids a direct MCP interface_ref"
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": true,
"source": "internal/cli/schema_hints/metadata/drive.json",
"precedence": "reviewed_explicit",
"selected": false,
"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."
}
]
},
"risk": {
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "medium",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "medium",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"用户要把本地文件上传到钉盘/我的文件（首选一条命令自动完成凭证+PUT+提交）时",
"上传到知识库/文档空间时加 --workspace；需要转在线文档时加 --convert",
"用户明确要求用本地文件替换已有钉盘/文档空间文件时传 --node；该模式会覆盖远端内容并要求确认"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"用户要把本地文件上传到钉盘/我的文件（首选一条命令自动完成凭证+PUT+提交）时",
"上传到知识库/文档空间时加 --workspace；需要转在线文档时加 --convert",
"用户明确要求用本地文件替换已有钉盘/文档空间文件时传 --node；该模式会覆盖远端内容并要求确认"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
}
},
"idempotency": "unknown",
"interface_mode": "composite",
"interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref",
"reviewed": true,
"risk": "medium",
"source_refs": [
"corecmd.SchemaDecl",
"internal/cli/schema_hints/metadata/drive.json",
"skills/mono/references/intent-guide.md",
"skills/mono/references/products/drive.md"
],
"use_when": [
"用户要把本地文件上传到钉盘/我的文件（首选一条命令自动完成凭证+PUT+提交）时",
"上传到知识库/文档空间时加 --workspace；需要转在线文档时加 --convert",
"用户明确要求用本地文件替换已有钉盘/文档空间文件时传 --node；该模式会覆盖远端内容并要求确认"
]
},
"drive upload-info": {
"agent_summary": "获取文件上传信息",
"agent_summary_source": "corecmd.SchemaDecl",
"availability": "available",
"avoid_when": [
"普通上传请直接用 dws drive upload，不要手动走三步",
"拿到凭证后须 HTTP PUT 再 dws drive commit；本命令本身不完成入库"
],
"confirmation": "not_required",
"effect": "read",
"effect_source": "corecmd.contract",
"examples": [
"dws drive upload-info --file-name \"report.pdf\" --file-size 102400 --format json"
],
"field_provenance": {
"agent_summary": {
"value": "获取文件上传信息",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "获取文件上传信息",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"availability": {
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "available",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "available",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.get_upload_info.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"avoid_when": {
"value": [
"普通上传请直接用 dws drive upload，不要手动走三步",
"拿到凭证后须 HTTP PUT 再 dws drive commit；本命令本身不完成入库"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"普通上传请直接用 dws drive upload，不要手动走三步",
"拿到凭证后须 HTTP PUT 再 dws drive commit；本命令本身不完成入库"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"confirmation": {
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "not_required",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "not_required",
"source": "risk-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"effect": {
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "read",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "read",
"source": "command-verb",
"precedence": "inference_or_default",
"selected": false
}
]
},
"examples": {
"value": [
"dws drive upload-info --file-name \"report.pdf\" --file-size 102400 --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"dws drive upload-info --file-name \"report.pdf\" --file-size 102400 --format json"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"idempotency": {
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "idempotent",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "idempotent",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"interface_mode": {
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "mcp",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "mcp",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.get_upload_info.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"interface_ref": {
"value": "drive.get_upload_info",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "drive.get_upload_info",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "drive.get_upload_info",
"source": "internal/cli/schema_hints/imported/wukong.json",
"precedence": "imported",
"selected": false
},
{
"value": "drive.get_upload_info",
"source": "internal/cli/schema_mcp_metadata.json#tools.drive.get_upload_info.interface_ref",
"precedence": "mcp_fallback",
"selected": false
}
]
},
"reviewed": {
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": true,
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
},
"risk": {
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": "low",
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
},
{
"value": "low",
"source": "effect-default",
"precedence": "inference_or_default",
"selected": false
}
]
},
"use_when": {
"value": [
"仅当无法使用 drive upload 一条命令、需要自定义流式上传时，获取 OSS 预签名上传凭证"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"resolution": "highest_precedence",
"candidates": [
{
"value": [
"仅当无法使用 drive upload 一条命令、需要自定义流式上传时，获取 OSS 预签名上传凭证"
],
"source": "corecmd.contract",
"precedence": "contract_final",
"selected": true
}
]
}
},
"idempotency": "idempotent",
"interface_mode": "mcp",
"interface_ref": {
"product_id": "drive",
"rpc_name": "get_upload_info"
},
"reviewed": true,
"risk": "low",
"source_refs": [
"corecmd.SchemaDecl",
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.drive.prod.json#drive.get_upload_info",
"internal/cli/schema_hints/imported/wukong.json",
"internal/cli/schema_mcp_metadata.json#tools.drive.get_upload_info",
"skills/mono/references/products/drive.md"
],
"use_when": [
"仅当无法使用 drive upload 一条命令、需要自定义流式上传时，获取 OSS 预签名上传凭证"
]
}
}
}
Reference in New Issue View Git Blame Copy Permalink