{ "product": "doc", "tools": { "doc.add_permission": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.add_permission", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc permission add", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.add_permission", "live-mcp:dws schema doc.add_permission", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-permission.md", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.add_permission" ], "agent_summary": "兼容入口：为文档空间节点添加协作成员权限；文件管理权限命令已迁移到 drive。", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "知识库容器授权用 wiki member add", "查/改/移除用 permission list/update/remove" ], "canonical_path": "doc.add_permission", "cli_name": "add", "cli_path": "doc permission add", "confirmation": "not_required", "description": "为指定文档（或文件夹/文件）添加一个或多个协作成员，并授予指定角色。\n\n通过 --user 传入逗号分隔的 userId 列表，多个用户将被授予同一角色。\n\n支持的角色 (--role)（必须大写）：\n MANAGER 管理员，可读写、管理成员\n EDITOR 编辑者，可查看、编辑、上传内容\n DOWNLOADER 查看下载者，可查看并下载内容\n READER 仅可查看者，仅可查看，不可下载\n\n注意：\n- OWNER 角色不可通过此接口添加。\n- 单次请求最多 30 个成员，超出请分批调用。\n\n用户 uid 可通过「钉钉通讯录」相关命令检索，如:\n dws contact user search --keyword \"姓名\"", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc permission add --node \u003cDOC_ID\u003e --users uid1 --role READER --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：为文档空间节点添加协作成员权限；文件管理权限命令已迁移到 drive。" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：为文档空间节点添加协作成员权限；文件管理权限命令已迁移到 drive。" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.add_permission.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "知识库容器授权用 wiki member add", "查/改/移除用 permission list/update/remove" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "知识库容器授权用 wiki member add", "查/改/移除用 permission list/update/remove" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc permission add", "value": "doc.add_permission" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc permission add", "value": "doc.add_permission" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "为指定文档（或文件夹/文件）添加一个或多个协作成员，并授予指定角色。\n\n通过 --user 传入逗号分隔的 userId 列表，多个用户将被授予同一角色。\n\n支持的角色 (--role)（必须大写）：\n MANAGER 管理员，可读写、管理成员\n EDITOR 编辑者，可查看、编辑、上传内容\n DOWNLOADER 查看下载者，可查看并下载内容\n READER 仅可查看者，仅可查看，不可下载\n\n注意：\n- OWNER 角色不可通过此接口添加。\n- 单次请求最多 30 个成员，超出请分批调用。\n\n用户 uid 可通过「钉钉通讯录」相关命令检索，如:\n dws contact user search --keyword \"姓名\"" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员（仅支持 USER 类型）。\r\n\r\n通过传入 userIds 列表批量授予企业用户对节点的访问权限，添加成功后即可按指定角色访问该节点及其子节点（若子节点继承权限）。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口添加。\r\n- **权限要求（业务规则）**：操作者必须在该节点上具备「可编辑（EDITOR）」及以上角色（OWNER / MANAGER / EDITOR）。\r\n- 单次请求 `userIds` 列表最多传 30 个，超出需分批调用。\r\n- 入参直接采用扁平的 `userIds: List\u003cString\u003e`，每个元素为钉钉 staffId（外部 userId 格式，由钉钉开放平台体系下颁发）。如果你只有 unionId，请先调用钉钉开放平台「根据 unionId 获取 userId」接口换取。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "为指定文档（或文件夹/文件）添加一个或多个协作成员，并授予指定角色。\n\n通过 --user 传入逗号分隔的 userId 列表，多个用户将被授予同一角色。\n\n支持的角色 (--role)（必须大写）：\n MANAGER 管理员，可读写、管理成员\n EDITOR 编辑者，可查看、编辑、上传内容\n DOWNLOADER 查看下载者，可查看并下载内容\n READER 仅可查看者，仅可查看，不可下载\n\n注意：\n- OWNER 角色不可通过此接口添加。\n- 单次请求最多 30 个成员，超出请分批调用。\n\n用户 uid 可通过「钉钉通讯录」相关命令检索，如:\n dws contact user search --keyword \"姓名\"" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc permission add --node \u003cDOC_ID\u003e --users uid1 --role READER --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc permission add --node \u003cDOC_ID\u003e --users uid1 --role READER --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.add_permission.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.add_permission.interface_ref", "value": { "product_id": "doc", "rpc_name": "add_permission" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.doc.add_permission.interface_ref", "value": { "product_id": "doc", "rpc_name": "add_permission" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "添加文档协作者" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "添加节点成员" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "添加文档协作者" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "给单篇文档做节点级授权（与 drive permission add 同能力的 doc 入口）时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "给单篇文档做节点级授权（与 drive permission add 同能力的 doc 入口）时" ] } }, "group": "permission", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "add_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "add_permission", "parameter_count": 4, "parameters": { "node": { "description": "目标节点的标识（文档/文件夹/文件），支持传入 URL 或 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标节点的标识（文档/文件夹/文件），支持传入 URL 或 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标节点的 nodeId（文档、文件夹或文件），可通过 list_nodes 工具获取。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标节点的标识（文档/文件夹/文件），支持传入 URL 或 ID (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标节点的 nodeId（文档、文件夹或文件），可通过 list_nodes 工具获取。", "property": "nodeId", "required": true, "type": "string" }, "role": { "description": "权限角色: MANAGER / EDITOR / DOWNLOADER / READER (必填，大小写不敏感)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "权限角色: MANAGER / EDITOR / DOWNLOADER / READER (必填，大小写不敏感)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "授予成员的角色，取值：MANAGER、EDITOR、DOWNLOADER、READER。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "权限角色: MANAGER / EDITOR / DOWNLOADER / READER (必填，大小写不敏感)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "roleId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "role" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "roleId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "授予成员的角色，取值：MANAGER、EDITOR、DOWNLOADER、READER。", "property": "roleId", "required": true, "type": "string" }, "users": { "description": "被授权的用户 userId 列表，逗号分隔 (必填，单次最多 30 个)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "被授权的用户 userId 列表，逗号分隔 (必填，单次最多 30 个)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "被授权的用户 userId 列表（钉钉 staffId / 外部 userId 格式，由钉钉开放平台体系下颁发；通常为数字字符串），至少包含一个 userId，单次最多 30 个。如果你只有 unionId，请先调用钉钉开放平台「根据 unionId 获取 userId」接口换取 userId。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "被授权的用户 userId 列表，逗号分隔 (必填，单次最多 30 个)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "userIds" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "users" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "userIds" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "被授权的用户 userId 列表（钉钉 staffId / 外部 userId 格式，由钉钉开放平台体系下颁发；通常为数字字符串），至少包含一个 userId，单次最多 30 个。如果你只有 unionId，请先调用钉钉开放平台「根据 unionId 获取 userId」接口换取 userId。", "interface_type": "array", "property": "userIds", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID 或 URL（选填，仅用于辅助构造返回的 docUrl）", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标知识库 ID 或 URL（选填，仅用于辅助构造返回的 docUrl）" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标知识库的标识，选填。仅用于辅助构造返回的 docUrl，业务实际依赖 nodeId 定位节点；支持两种格式：1) 知识库 ID（纯字符串）；2) 知识库 URL，如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview，系统自动提取其中的 workspaceId。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标知识库 ID 或 URL（选填，仅用于辅助构造返回的 docUrl）" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "workspaceId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "workspaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标知识库的标识，选填。仅用于辅助构造返回的 docUrl，业务实际依赖 nodeId 定位节点；支持两种格式：1) 知识库 ID（纯字符串）；2) 知识库 URL，如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview，系统自动提取其中的 workspaceId。", "property": "workspaceId", "required": false, "type": "string" } }, "path": "doc.add_permission", "primary_cli_path": "doc permission add", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "添加文档协作者", "use_when": [ "给单篇文档做节点级授权（与 drive permission add 同能力的 doc 入口）时" ] }, "doc.copy_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.copy_document", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc copy", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.copy_document", "live-mcp:dws schema doc.copy_document", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-file-ops.md", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.copy_document" ], "agent_summary": "兼容入口：复制文档或文件；文件复制能力已迁移到 drive。", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "要搬走不留副本改用 dws doc move 或 dws drive move", "跨钉盘整理文件优先 dws drive copy" ], "canonical_path": "doc.copy_document", "cli_name": "copy", "cli_path": "doc copy", "confirmation": "not_required", "description": "将文档或文件复制到指定文件夹或知识库。\n--folder 指定目标文档文件夹 nodeId 或 alidocs 文件夹 URL，--workspace 指定目标知识库 ID。\n不要把 drive/chat 链路返回的纯数字 dentryId/parent-id 传给 --folder。\n不传 --folder 时复制到 --workspace 知识库根目录；都不传则默认到\"我的文档\"。\n\n权限要求: 对源文档有\"阅读\"权限，且对目标文件夹有\"编辑\"权限。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc copy --node \u003cDOC_ID\u003e --folder \u003cTARGET_FOLDER_ID\u003e --format json", "dws doc copy --node \u003cDOC_ID\u003e --workspace \u003cTARGET_WS_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：复制文档或文件；文件复制能力已迁移到 drive。" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：复制文档或文件；文件复制能力已迁移到 drive。" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.copy_document.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "要搬走不留副本改用 dws doc move 或 dws drive move", "跨钉盘整理文件优先 dws drive copy" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "要搬走不留副本改用 dws doc move 或 dws drive move", "跨钉盘整理文件优先 dws drive copy" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc copy", "value": "doc.copy_document" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc copy", "value": "doc.copy_document" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "将文档或文件复制到指定文件夹或知识库。\n--folder 指定目标文档文件夹 nodeId 或 alidocs 文件夹 URL，--workspace 指定目标知识库 ID。\n不要把 drive/chat 链路返回的纯数字 dentryId/parent-id 传给 --folder。\n不传 --folder 时复制到 --workspace 知识库根目录；都不传则默认到\"我的文档\"。\n\n权限要求: 对源文档有\"阅读\"权限，且对目标文件夹有\"编辑\"权限。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "将指定节点复制到目标文件夹。\r\n\r\n支持的节点类型：知识库节点（文档、文件夹）、钉盘文件/文件夹。\r\nnodeId 支持文档 URL 或 dentryUuid（32 位字母数字字符串）。\r\ntargetFolderId 为目标文件夹的 dentryUuid；workspaceId 为目标知识库标识，不传 targetFolderId 时复制到该知识库根目录，如果不传 targetFolderId 和 workspaceId，默认到当前用户所在组织的「我的文档」下\r\n\r\n权限要求：\r\n- 对源节点有可查看下载权限\r\n- 对目标文件夹有写入权限\r\n\r\n注意：复制操作底层可能异步执行，异步时操作已提交但新节点 ID 无法立即返回，请稍后查看目标文件夹确认结果。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "将文档或文件复制到指定文件夹或知识库。\n--folder 指定目标文档文件夹 nodeId 或 alidocs 文件夹 URL，--workspace 指定目标知识库 ID。\n不要把 drive/chat 链路返回的纯数字 dentryId/parent-id 传给 --folder。\n不传 --folder 时复制到 --workspace 知识库根目录；都不传则默认到\"我的文档\"。\n\n权限要求: 对源文档有\"阅读\"权限，且对目标文件夹有\"编辑\"权限。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc copy --node \u003cDOC_ID\u003e --folder \u003cTARGET_FOLDER_ID\u003e --format json", "dws doc copy --node \u003cDOC_ID\u003e --workspace \u003cTARGET_WS_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc copy --node \u003cDOC_ID\u003e --folder \u003cTARGET_FOLDER_ID\u003e --format json", "dws doc copy --node \u003cDOC_ID\u003e --workspace \u003cTARGET_WS_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.copy_document.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.copy_document.interface_ref", "value": { "product_id": "doc", "rpc_name": "copy_document" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.doc.copy_document.interface_ref", "value": { "product_id": "doc", "rpc_name": "copy_document" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "复制文档/文件到指定位置" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "将指定节点复制到目标文件夹" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "复制文档/文件到指定位置" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户要复制文档/文件并保留原位置时（尤其保形复制模板：copy + rename + block update）", "目标文件夹 --folder 或知识库根 --workspace；都不传则默认「我的文档」" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户要复制文档/文件并保留原位置时（尤其保形复制模板：copy + rename + block update）", "目标文件夹 --folder 或知识库根 --workspace；都不传则默认「我的文档」" ] } }, "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "copy_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "copy_document", "parameter_count": 3, "parameters": { "folder": { "description": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文件夹的 dentryUuid（32 位字母数字字符串），复制后的节点将放置在此文件夹下。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "targetFolderId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "folder" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "targetFolderId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文件夹的 dentryUuid（32 位字母数字字符串），复制后的节点将放置在此文件夹下。", "property": "targetFolderId", "required": false, "type": "string" }, "node": { "description": "文档/文件 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档/文件 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要复制的节点标识，支持以下格式：\\n1. 文档/文件夹 URL，如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}\\n2. dentryUuid（32 位字母数字字符串）" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档/文件 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要复制的节点标识，支持以下格式：\\n1. 文档/文件夹 URL，如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}\\n2. dentryUuid（32 位字母数字字符串）", "property": "nodeId", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID 或 URL (不传 --folder 时复制到该知识库根目录)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标知识库 ID 或 URL (不传 --folder 时复制到该知识库根目录)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标知识库的标识，支持两种格式：1) 知识库 ID（纯字符串）；2) 知识库 URL，如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview，系统自动提取其中的 workspaceId。当 targetFolderId 不传时，复制到该知识库的根目录下。与 targetFolderId 至少传一个。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标知识库 ID 或 URL (不传 --folder 时复制到该知识库根目录)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "workspaceId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "workspaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标知识库的标识，支持两种格式：1) 知识库 ID（纯字符串）；2) 知识库 URL，如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview，系统自动提取其中的 workspaceId。当 targetFolderId 不传时，复制到该知识库的根目录下。与 targetFolderId 至少传一个。", "property": "workspaceId", "required": false, "type": "string" } }, "path": "doc.copy_document", "primary_cli_path": "doc copy", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "复制文档/文件到指定位置", "use_when": [ "用户要复制文档/文件并保留原位置时（尤其保形复制模板：copy + rename + block update）", "目标文件夹 --folder 或知识库根 --workspace；都不传则默认「我的文档」" ] }, "doc.create_comment": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.create_comment", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc comment create", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_comment", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.create_comment", "live-mcp:dws schema doc-comment.create_comment", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-comment.md", "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.create_comment", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.create_comment" ], "agent_summary": "创建文档评论", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "针对某段选中文本的划词评论改用 create-inline（需 blockId+start/end）", "回复已有评论用 reply；删评论用 delete" ], "canonical_path": "doc.create_comment", "cli_name": "create", "cli_path": "doc comment create", "confirmation": "not_required", "description": "在指定文档上创建一条评论。\n\n可通过 --mention 指定被 @ 的用户 uid 列表（逗号分隔），\n评论内容中会插入 @mention 节点并发送通知。\n用户 uid 可通过「钉钉通讯录」相关命令检索，如:\n dws contact user search --keyword \"姓名\"", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc comment create --node \u003cDOC_ID\u003e --content \"这里需要修改\" --format json", "dws doc comment create --node \u003cDOC_ID\u003e --content \"请review\" --mention uid1,uid2 --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "创建文档评论" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "创建文档评论" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_comment.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "针对某段选中文本的划词评论改用 create-inline（需 blockId+start/end）", "回复已有评论用 reply；删评论用 delete" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "针对某段选中文本的划词评论改用 create-inline（需 blockId+start/end）", "回复已有评论用 reply；删评论用 delete" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc comment create", "value": "doc.create_comment" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc comment create", "value": "doc.create_comment" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "在指定文档上创建一条评论。\n\n可通过 --mention 指定被 @ 的用户 uid 列表（逗号分隔），\n评论内容中会插入 @mention 节点并发送通知。\n用户 uid 可通过「钉钉通讯录」相关命令检索，如:\n dws contact user search --keyword \"姓名\"" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "在钉钉文档中创建全文评论，评论不关联文档内具体位置，支持 @提及用户。\r\n\r\n通过 nodeId 定位文档，支持传入文档链接 URL 或文档 ID（dentryUuid）。\r\n- @提及用户：填写 mentionedUserIds，被提及用户会收到通知。\r\n如需创建划词评论（关联文档内指定文本范围），请使用 create_inline_comment 工具。\r\n如需回复已有评论，请使用 reply_comment 工具。\r\n操作受权限控制，仅当调用者对文档有评论权限时可创建评论。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "在指定文档上创建一条评论。\n\n可通过 --mention 指定被 @ 的用户 uid 列表（逗号分隔），\n评论内容中会插入 @mention 节点并发送通知。\n用户 uid 可通过「钉钉通讯录」相关命令检索，如:\n dws contact user search --keyword \"姓名\"" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc comment create --node \u003cDOC_ID\u003e --content \"这里需要修改\" --format json", "dws doc comment create --node \u003cDOC_ID\u003e --content \"请review\" --mention uid1,uid2 --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc comment create --node \u003cDOC_ID\u003e --content \"这里需要修改\" --format json", "dws doc comment create --node \u003cDOC_ID\u003e --content \"请review\" --mention uid1,uid2 --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_comment.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": { "product_id": "doc-comment", "rpc_name": "create_comment" } }, { "precedence": "imported", "selected": false, "source": "internal/cli/schema_hints/imported/wukong.json", "value": "doc.create_comment" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_comment.interface_ref", "value": "doc-comment.create_comment" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": { "product_id": "doc-comment", "rpc_name": "create_comment" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "创建文档评论" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建全文评论" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "创建文档评论" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "在文档上创建不绑定具体划词位置的全文评论，可 --mention 时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "在文档上创建不绑定具体划词位置的全文评论，可 --mention 时" ] } }, "group": "comment", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc-comment", "rpc_name": "create_comment" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_comment", "parameter_count": 3, "parameters": { "content": { "description": "评论的文字内容，纯文本 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "评论的文字内容，纯文本 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "评论的文字内容，纯文本格式。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "评论的文字内容，纯文本 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "content" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "content" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "评论的文字内容，纯文本格式。必填。", "property": "content", "required": true, "type": "string" }, "mention": { "description": "被 @ 的用户 uid 列表，逗号分隔", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "被 @ 的用户 uid 列表，逗号分隔" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "被 @ 的用户 uid 列表，填写后评论内容中会插入 @mention 节点并发送通知。可通过「钉钉通讯录」相关 MCP tool（如 `search_user_by_key_word`、`search_user_by_mobile`）检索用户 uid，或使用 `dingtalk-workspace-cli` 提供的相关 skill 来检索。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "被 @ 的用户 uid 列表，逗号分隔" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "mentionedUserIds" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "mention" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "mentionedUserIds" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "被 @ 的用户 uid 列表，填写后评论内容中会插入 @mention 节点并发送通知。可通过「钉钉通讯录」相关 MCP tool（如 `search_user_by_key_word`、`search_user_by_mobile`）检索用户 uid，或使用 `dingtalk-workspace-cli` 提供的相关 skill 来检索。", "interface_type": "array", "property": "mentionedUserIds", "required": false, "type": "string" }, "node": { "description": "目标文档的标识，支持传入 URL 或 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文档的标识，支持传入 URL 或 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文档的标识，支持传入 URL 或 ID（dentryUuid）。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文档的标识，支持传入 URL 或 ID (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文档的标识，支持传入 URL 或 ID（dentryUuid）。必填。", "property": "nodeId", "required": true, "type": "string" } }, "path": "doc.create_comment", "primary_cli_path": "doc comment create", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "创建文档评论", "use_when": [ "在文档上创建不绑定具体划词位置的全文评论，可 --mention 时" ] }, "doc.create_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.create_document", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc create", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_document", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.create_document", "live-mcp:dws schema doc.create_document", "skills/mono/references/intent-guide.md", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-create.md", "skills/mono/references/products/doc/doc-media.md", "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.create_document", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.create_document" ], "agent_summary": "创建一篇新的在线文档", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "创建表格/脑图/白板/多维表/演示改用 dws wiki node create --type \u003ctype\u003e（勿用 doc create）", "在知识库建空节点实体也可用 wiki node create；本命令侧重可写初始内容的 adoc", "导入本地 Word/Markdown 为在线文档改用 dws doc import（若可用）或 upload --convert" ], "canonical_path": "doc.create_document", "cli_name": "create", "cli_path": "doc create", "confirmation": "not_required", "description": "创建一篇新的钉钉在线文档。\n创建位置优先级: --folder \u003e --workspace \u003e 默认 (我的文档根目录)\n\n初始内容来源（--content-file 优先于 --content）:\n --content \"...\" 短文本字面量（仅推荐 \u003c2KB 且无换行/表格）\n --content - 从 stdin 读取（可配合 heredoc/pipe）\n --content-file path 从 UTF-8 文件读取（推荐长/多行/表格内容，避免 shell escape）", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc create --name \"项目周报\" --format json", "dws doc create --name \"Q1 总结\" --content \"# Q1 总结\" --folder \u003cFOLDER_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "创建一篇新的在线文档" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "创建一篇新的在线文档" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_document.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "创建表格/脑图/白板/多维表/演示改用 dws wiki node create --type \u003ctype\u003e（勿用 doc create）", "在知识库建空节点实体也可用 wiki node create；本命令侧重可写初始内容的 adoc", "导入本地 Word/Markdown 为在线文档改用 dws doc import（若可用）或 upload --convert" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "创建表格/脑图/白板/多维表/演示改用 dws wiki node create --type \u003ctype\u003e（勿用 doc create）", "在知识库建空节点实体也可用 wiki node create；本命令侧重可写初始内容的 adoc", "导入本地 Word/Markdown 为在线文档改用 dws doc import（若可用）或 upload --convert" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc create", "value": "doc.create_document" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc create", "value": "doc.create_document" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "创建一篇新的钉钉在线文档。\n创建位置优先级: --folder \u003e --workspace \u003e 默认 (我的文档根目录)\n\n初始内容来源（--content-file 优先于 --content）:\n --content \"...\" 短文本字面量（仅推荐 \u003c2KB 且无换行/表格）\n --content - 从 stdin 读取（可配合 heredoc/pipe）\n --content-file path 从 UTF-8 文件读取（推荐长/多行/表格内容，避免 shell escape）" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建一篇文字类型的钉钉在线文档（扩展名=adoc）。\r\n支持创建空文档或带有初始 Markdown 内容的文档。（如需创建钉钉AI表格、钉钉表格、钉钉脑图等其他类型的文件，使用 create_file 工具）\r\n支持三种创建位置：\r\n1. 指定 folderId：在该文件夹下创建\r\n2. 指定 workspaceId（知识库 ID）但不传 folderId：在该知识库的根目录下创建\r\n3. 都不传：在用户\"我的文档\"根目录下创建\r\n操作受权限控制，仅当调用者对目标位置有写入权限时可成功创建。\r\n内容长度上限 10000 字符，超出请使用 update_document 工具分批追加写入。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "创建一篇新的钉钉在线文档。\n创建位置优先级: --folder \u003e --workspace \u003e 默认 (我的文档根目录)\n\n初始内容来源（--content-file 优先于 --content）:\n --content \"...\" 短文本字面量（仅推荐 \u003c2KB 且无换行/表格）\n --content - 从 stdin 读取（可配合 heredoc/pipe）\n --content-file path 从 UTF-8 文件读取（推荐长/多行/表格内容，避免 shell escape）" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc create --name \"项目周报\" --format json", "dws doc create --name \"Q1 总结\" --content \"# Q1 总结\" --folder \u003cFOLDER_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc create --name \"项目周报\" --format json", "dws doc create --name \"Q1 总结\" --content \"# Q1 总结\" --folder \u003cFOLDER_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_document.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "create_document" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_document.interface_ref", "value": "doc.create_document" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "create_document" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "创建文档" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建钉钉文档" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "创建文档" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户要新建一篇文字在线文档(adoc)，可空文档或带初始 Markdown 时", "创建到指定文件夹 --folder、知识库根 --workspace，或默认「我的文档」根目录时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户要新建一篇文字在线文档(adoc)，可空文档或带初始 Markdown 时", "创建到指定文件夹 --folder、知识库根 --workspace，或默认「我的文档」根目录时" ] } }, "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "create_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_document", "parameter_count": 7, "parameters": { "content": { "description": "文档初始内容（短文本字面量）；传 - 表示从 stdin 读取", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档初始内容（短文本字面量）；传 - 表示从 stdin 读取" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档初始内容（短文本字面量）；传 - 表示从 stdin 读取" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "pipeline input; maps to markdown or a follow-up update_document jsonml call", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "content" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "pipeline input; maps to markdown or a follow-up update_document jsonml call", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "content-file": { "description": "从文件读取文档内容（UTF-8）。推荐长/多行/表格内容使用", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "从文件读取文档内容（UTF-8）。推荐长/多行/表格内容使用" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "从文件读取文档内容（UTF-8）。推荐长/多行/表格内容使用" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "local file input for the content pipeline", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "contentFile" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "local file input for the content pipeline", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "content-format": { "description": "内容格式: 默认为 markdown，可选 jsonml", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "内容格式: 默认为 markdown，可选 jsonml" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "内容格式: 默认为 markdown，可选 jsonml" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "local branch selector across create_document/update_document", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "contentFormat" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "local branch selector across create_document/update_document", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "fix-jsonml": { "description": "启用 JSON 语法修复（括号/逗号补全），推荐 agent 调用时使用", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "启用 JSON 语法修复（括号/逗号补全），推荐 agent 调用时使用" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "启用 JSON 语法修复（括号/逗号补全），推荐 agent 调用时使用" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "local JSONML normalization control", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "fixJsonml" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "local JSONML normalization control", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "boolean" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "boolean" } }, "required": false, "type": "boolean" }, "folder": { "description": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文件夹的节点 ID（dentryUuid），支持传入文件夹链接 URL 或 ID。不传时：如果提供了 workspaceId 则创建在该知识库根目录下，否则创建在用户'我的文档'根目录下。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "folderId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "folder" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "folderId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文件夹的节点 ID（dentryUuid），支持传入文件夹链接 URL 或 ID。不传时：如果提供了 workspaceId 则创建在该知识库根目录下，否则创建在用户'我的文档'根目录下。", "property": "folderId", "required": false, "type": "string" }, "name": { "description": "文档名称 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档名称 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "新文档的标题，必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档名称 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "name" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "name" }, "required": { "candidates": [ { "precedence": "tool_schema_hint", "selected": true, "source": "tool_schema_hint", "value": true }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "tool_schema_hint", "resolution": "highest_precedence", "source": "tool_schema_hint", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "新文档的标题，必填。", "property": "name", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标知识库 ID" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标知识库的 ID。如果同时传了 folderId，则以 folderId 为准。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标知识库 ID" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "workspaceId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "workspaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标知识库的 ID。如果同时传了 folderId，则以 folderId 为准。", "property": "workspaceId", "required": false, "type": "string" } }, "path": "doc.create_document", "primary_cli_path": "doc create", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "创建文档", "use_when": [ "用户要新建一篇文字在线文档(adoc)，可空文档或带初始 Markdown 时", "创建到指定文件夹 --folder、知识库根 --workspace，或默认「我的文档」根目录时" ] }, "doc.create_file": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.create_file", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc file create", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_file", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.create_file", "live-mcp:dws schema doc.create_file", "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.create_file", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.create_file" ], "agent_summary": "创建文件（文档/表格/脑图/白板/多维表/文件夹等）", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "请改用 dws wiki node create --workspace \u003cid\u003e --type \u003ctype\u003e", "纯文字带内容创建用 doc create" ], "canonical_path": "doc.create_file", "cli_name": "create", "cli_path": "doc file create", "confirmation": "not_required", "description": "在指定目录下新增文件。支持的文件类型 (--type):\n adoc 钉钉在线文档\n axls 钉钉表格\n appt 钉钉演示\n adraw 钉钉白板\n amind 钉钉脑图\n able 钉钉多维表\n folder 文件夹\n\n兼容旧版 accessType: \"0\"=adoc \"1\"=axls \"2\"=appt \"3\"=adraw \"6\"=amind \"7\"=able \"13\"=folder\n创建位置优先级: --folder \u003e --workspace \u003e 默认 (我的文档根目录)", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc file create --name \"项目周报\" --type adoc --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "创建文件（文档/表格/脑图/白板/多维表/文件夹等）" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "创建文件（文档/表格/脑图/白板/多维表/文件夹等）" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_file.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "请改用 dws wiki node create --workspace \u003cid\u003e --type \u003ctype\u003e", "纯文字带内容创建用 doc create" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "请改用 dws wiki node create --workspace \u003cid\u003e --type \u003ctype\u003e", "纯文字带内容创建用 doc create" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc file create", "value": "doc.create_file" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc file create", "value": "doc.create_file" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "在指定目录下新增文件。支持的文件类型 (--type):\n adoc 钉钉在线文档\n axls 钉钉表格\n appt 钉钉演示\n adraw 钉钉白板\n amind 钉钉脑图\n able 钉钉多维表\n folder 文件夹\n\n兼容旧版 accessType: \"0\"=adoc \"1\"=axls \"2\"=appt \"3\"=adraw \"6\"=amind \"7\"=able \"13\"=folder\n创建位置优先级: --folder \u003e --workspace \u003e 默认 (我的文档根目录)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "在指定位置创建一个新的文件（文档、表格、演示、白板、脑图、多维表或文件夹）。\r\n\r\n支持三种创建位置（按优先级）：\r\n1. 指定 folderId：在该文件夹下创建\r\n2. 仅指定 workspaceId（不传 folderId）：在该知识库的根目录下创建\r\n3. 都不传：在用户\"我的文档\"根目录下创建\r\n4. type 要创建的文件类型，必填。支持以下值：adoc（钉钉在线文档）、axls（钉钉表格）、appt（钉钉演示）、adraw（钉钉白板）、amind（钉钉脑图）、able（钉钉多维表）、folder（文件夹）\r\n操作受权限控制，仅当调用者对目标位置有写入权限时可成功创建。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "在指定目录下新增文件。支持的文件类型 (--type):\n adoc 钉钉在线文档\n axls 钉钉表格\n appt 钉钉演示\n adraw 钉钉白板\n amind 钉钉脑图\n able 钉钉多维表\n folder 文件夹\n\n兼容旧版 accessType: \"0\"=adoc \"1\"=axls \"2\"=appt \"3\"=adraw \"6\"=amind \"7\"=able \"13\"=folder\n创建位置优先级: --folder \u003e --workspace \u003e 默认 (我的文档根目录)" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc file create --name \"项目周报\" --type adoc --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc file create --name \"项目周报\" --type adoc --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_file.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "create_file" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_file.interface_ref", "value": "doc.create_file" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "create_file" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "创建文件" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建节点" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "创建文件" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "兼容入口：按类型创建文件节点时（已弃用，改用 wiki node create）" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "兼容入口：按类型创建文件节点时（已弃用，改用 wiki node create）" ] } }, "group": "file", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "create_file" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_file", "parameter_count": 4, "parameters": { "folder": { "description": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文件夹的节点 ID（dentryUuid），支持传入文件夹链接 URL 或 ID。不传时：如果提供了 workspaceId 则创建在该知识库根目录下，否则创建在用户'我的文档'根目录下。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "folderId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "folder" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "folderId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文件夹的节点 ID（dentryUuid），支持传入文件夹链接 URL 或 ID。不传时：如果提供了 workspaceId 则创建在该知识库根目录下，否则创建在用户'我的文档'根目录下。", "property": "folderId", "required": false, "type": "string" }, "name": { "description": "文件名称 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件名称 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "新文件的名称，必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件名称 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "name" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "name" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "新文件的名称，必填。", "property": "name", "required": true, "type": "string" }, "type": { "description": "文件类型: adoc/axls/appt/adraw/amind/able/folder (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件类型: adoc/axls/appt/adraw/amind/able/folder (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要创建的文件类型，必填。支持：adoc（钉钉在线文档）、axls（钉钉表格）、appt（钉钉演示）、adraw（钉钉白板）、amind（钉钉脑图）、able（钉钉多维表）、folder（文件夹）。同时兼容旧版 accessType 数字字符串：\"0\"=adoc、\"1\"=axls、\"2\"=appt、\"3\"=adraw、\"6\"=amind、\"7\"=able、\"13\"=folder。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件类型: adoc/axls/appt/adraw/amind/able/folder (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "type" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "type" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要创建的文件类型，必填。支持：adoc（钉钉在线文档）、axls（钉钉表格）、appt（钉钉演示）、adraw（钉钉白板）、amind（钉钉脑图）、able（钉钉多维表）、folder（文件夹）。同时兼容旧版 accessType 数字字符串：\"0\"=adoc、\"1\"=axls、\"2\"=appt、\"3\"=adraw、\"6\"=amind、\"7\"=able、\"13\"=folder。", "property": "type", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID 或 URL", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标知识库 ID 或 URL" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标知识库的标识，支持知识库 ID 或知识库 URL。如果同时传了 folderId，则以 folderId 为准。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标知识库 ID 或 URL" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "workspaceId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "workspaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标知识库的标识，支持知识库 ID 或知识库 URL。如果同时传了 folderId，则以 folderId 为准。", "property": "workspaceId", "required": false, "type": "string" } }, "path": "doc.create_file", "primary_cli_path": "doc file create", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "创建文件", "use_when": [ "兼容入口：按类型创建文件节点时（已弃用，改用 wiki node create）" ] }, "doc.create_folder": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.create_folder", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc folder create", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_folder", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.create_folder", "live-mcp:dws schema doc.create_folder", "skills/mono/references/products/doc/doc-file-ops.md", "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.create_folder", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.create_folder" ], "agent_summary": "创建文件夹", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "个人空间/钉盘改用 dws drive mkdir；知识库改用 wiki node create --type folder" ], "canonical_path": "doc.create_folder", "cli_name": "create", "cli_path": "doc folder create", "confirmation": "not_required", "description": "在指定位置创建文件夹。\n创建位置优先级: --folder (父文件夹) \u003e --workspace \u003e 默认 (我的文档根目录)", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc folder create --name \"项目资料\" --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "创建文件夹" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "创建文件夹" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_folder.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "个人空间/钉盘改用 dws drive mkdir；知识库改用 wiki node create --type folder" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "个人空间/钉盘改用 dws drive mkdir；知识库改用 wiki node create --type folder" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc folder create", "value": "doc.create_folder" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc folder create", "value": "doc.create_folder" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "在指定位置创建文件夹。\n创建位置优先级: --folder (父文件夹) \u003e --workspace \u003e 默认 (我的文档根目录)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "在指定位置创建一个新的文件夹。\r\n\r\n支持在文件夹下或知识库下创建子文件夹。\r\n创建后返回新文件夹的节点 ID，可用于后续在该文件夹下创建文档或子文件夹。\r\n操作受权限控制，仅当调用者对父节点有写入权限时可成功创建。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "在指定位置创建文件夹。\n创建位置优先级: --folder (父文件夹) \u003e --workspace \u003e 默认 (我的文档根目录)" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc folder create --name \"项目资料\" --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc folder create --name \"项目资料\" --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_folder.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "create_folder" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_folder.interface_ref", "value": "doc.create_folder" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "create_folder" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "创建文件夹" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建文件夹" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "创建文件夹" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "兼容入口：创建文件夹（已弃用）时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "兼容入口：创建文件夹（已弃用）时" ] } }, "group": "folder", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "create_folder" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_folder", "parameter_count": 3, "parameters": { "folder": { "description": "父文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "父文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "父文件夹的节点 ID，支持传入 URL 或 ID。不传时：如果提供了 workspaceId 则创建在该知识库根目录下，否则创建在用户'我的文档'根目录下。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "父文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "folderId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "folder" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "folderId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "父文件夹的节点 ID，支持传入 URL 或 ID。不传时：如果提供了 workspaceId 则创建在该知识库根目录下，否则创建在用户'我的文档'根目录下。", "property": "folderId", "required": false, "type": "string" }, "name": { "description": "文件夹名称 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件夹名称 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "新文件夹的名称，必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件夹名称 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "name" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "name" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "新文件夹的名称，必填。", "property": "name", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标知识库 ID" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标知识库的 ID。如果同时传了 folderId，则以 folderId 为准。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标知识库 ID" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "workspaceId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "workspaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标知识库的 ID。如果同时传了 folderId，则以 folderId 为准。", "property": "workspaceId", "required": false, "type": "string" } }, "path": "doc.create_folder", "primary_cli_path": "doc folder create", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "创建文件夹", "use_when": [ "兼容入口：创建文件夹（已弃用）时" ] }, "doc.create_inline_comment": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.create_inline_comment", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc comment create-inline", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.create_inline_comment", "live-mcp:dws schema doc-comment.create_inline_comment", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-comment.md", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.create_inline_comment" ], "agent_summary": "在文档选中文本范围创建划词评论", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "不绑定位置的全文评论用 create", "先 block list 取 blockId 与纯文本偏移再调用" ], "canonical_path": "doc.create_inline_comment", "cli_name": "create-inline", "cli_path": "doc comment create-inline", "confirmation": "not_required", "description": "在指定文档的选中文本区域上创建一条划词评论。\n\n需要指定评论标记所在的块 ID (--block-id)、起始偏移量 (--start) 和结束偏移量 (--end)。\n块 ID 可通过 dws doc block list --node \u003cnodeId\u003e 获取。\n\n可通过 --selected-text 传入选中文本内容，评论列表中会展示「引用原文：xxx」。\n可通过 --mention 指定被 @ 的用户 uid 列表（逗号分隔），\n评论内容中会插入 @mention 节点并发送通知。\n用户 uid 可通过「钉钉通讯录」相关命令检索，如:\n dws contact user search --keyword \"姓名\"", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc comment create-inline --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --start 0 --end 10 --content \"这里需要修改\" --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "在文档选中文本范围创建划词评论" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "在文档选中文本范围创建划词评论" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_inline_comment.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "不绑定位置的全文评论用 create", "先 block list 取 blockId 与纯文本偏移再调用" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "不绑定位置的全文评论用 create", "先 block list 取 blockId 与纯文本偏移再调用" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc comment create-inline", "value": "doc.create_inline_comment" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc comment create-inline", "value": "doc.create_inline_comment" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "在指定文档的选中文本区域上创建一条划词评论。\n\n需要指定评论标记所在的块 ID (--block-id)、起始偏移量 (--start) 和结束偏移量 (--end)。\n块 ID 可通过 dws doc block list --node \u003cnodeId\u003e 获取。\n\n可通过 --selected-text 传入选中文本内容，评论列表中会展示「引用原文：xxx」。\n可通过 --mention 指定被 @ 的用户 uid 列表（逗号分隔），\n评论内容中会插入 @mention 节点并发送通知。\n用户 uid 可通过「钉钉通讯录」相关命令检索，如:\n dws contact user search --keyword \"姓名\"" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "在钉钉文档中创建划词评论，评论关联文档内指定块的文本范围，支持 @提及用户。\r\n\r\n通过 nodeId 定位文档，支持传入文档链接 URL 或文档 ID（dentryUuid）。\r\n- blockId、start、end 均为必填，用于定位评论标记的文本范围。\r\n- selectedText 可选填，填写后评论列表中会展示「引用原文：xxx」。\r\n- @提及用户：填写 mentionedUserIds，被提及用户会收到通知。\r\n如需创建全文评论（不关联文档内具体位置），请使用 create_comment 工具。\r\n如需回复已有评论，请使用 reply_comment 工具。\r\n操作受权限控制，仅当调用者对文档有评论权限时可创建评论。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "在指定文档的选中文本区域上创建一条划词评论。\n\n需要指定评论标记所在的块 ID (--block-id)、起始偏移量 (--start) 和结束偏移量 (--end)。\n块 ID 可通过 dws doc block list --node \u003cnodeId\u003e 获取。\n\n可通过 --selected-text 传入选中文本内容，评论列表中会展示「引用原文：xxx」。\n可通过 --mention 指定被 @ 的用户 uid 列表（逗号分隔），\n评论内容中会插入 @mention 节点并发送通知。\n用户 uid 可通过「钉钉通讯录」相关命令检索，如:\n dws contact user search --keyword \"姓名\"" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc comment create-inline --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --start 0 --end 10 --content \"这里需要修改\" --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc comment create-inline --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --start 0 --end 10 --content \"这里需要修改\" --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_inline_comment.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": { "product_id": "doc-comment", "rpc_name": "create_inline_comment" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.create_inline_comment.interface_ref", "value": "doc-comment.create_inline_comment" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": { "product_id": "doc-comment", "rpc_name": "create_inline_comment" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "创建划词评论" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建划词评论" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "创建划词评论" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "针对块内某段文本创建划词评论（必填 blockId、start、end）时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "针对块内某段文本创建划词评论（必填 blockId、start、end）时" ] } }, "group": "comment", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc-comment", "rpc_name": "create_inline_comment" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "create_inline_comment", "parameter_count": 7, "parameters": { "block-id": { "description": "评论标记所在的块 ID，可通过 dws doc block list 获取 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "评论标记所在的块 ID，可通过 dws doc block list 获取 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "评论标记所在的块 ID。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "评论标记所在的块 ID，可通过 dws doc block list 获取 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "blockId" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "blockId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "评论标记所在的块 ID。必填。", "property": "blockId", "required": true, "type": "string" }, "content": { "description": "评论的文字内容，纯文本 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "评论的文字内容，纯文本 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "评论的文字内容，纯文本格式。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "评论的文字内容，纯文本 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "content" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "content" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "评论的文字内容，纯文本格式。必填。", "property": "content", "required": true, "type": "string" }, "end": { "description": "评论标记在块内文本中的结束字符偏移量，必须大于 start (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "评论标记在块内文本中的结束字符偏移量，必须大于 start (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "评论标记在块内文本中的结束字符偏移量，必须大于 start。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "评论标记在块内文本中的结束字符偏移量，必须大于 start (必填)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "end" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "end" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "评论标记在块内文本中的结束字符偏移量，必须大于 start。必填。", "interface_type": "number", "property": "end", "required": true, "type": "integer" }, "mention": { "description": "被 @ 的用户 uid 列表，逗号分隔", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "被 @ 的用户 uid 列表，逗号分隔" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "填写后，评论内容中会插入 @mention 节点，并向对应用户发送通知。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "被 @ 的用户 uid 列表，逗号分隔" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "mentionedUserIds" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "mention" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "mentionedUserIds" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "填写后，评论内容中会插入 @mention 节点，并向对应用户发送通知。", "interface_type": "array", "property": "mentionedUserIds", "required": false, "type": "string" }, "node": { "description": "目标文档的标识，支持传入 URL 或 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文档的标识，支持传入 URL 或 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文档的标识，支持传入 URL 或 ID（dentryUuid）。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文档的标识，支持传入 URL 或 ID (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文档的标识，支持传入 URL 或 ID（dentryUuid）。必填。", "property": "nodeId", "required": true, "type": "string" }, "selected-text": { "description": "选中文本的内容，填写后评论列表中会展示「引用原文：xxx」", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "选中文本的内容，填写后评论列表中会展示「引用原文：xxx」" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "可选填。填写后，评论列表中会展示「引用原文：xxx」。建议传入选中文本的完整内容或前100个字符。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "选中文本的内容，填写后评论列表中会展示「引用原文：xxx」" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "selectedText" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "selectedText" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "可选填。填写后，评论列表中会展示「引用原文：xxx」。建议传入选中文本的完整内容或前100个字符。", "property": "selectedText", "required": false, "type": "string" }, "start": { "description": "评论标记在块内文本中的起始字符偏移量，从 0 开始 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "评论标记在块内文本中的起始字符偏移量，从 0 开始 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "评论标记在块内文本中的起始字符偏移量（从 0 开始）。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "评论标记在块内文本中的起始字符偏移量，从 0 开始 (必填)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "start" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "start" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "评论标记在块内文本中的起始字符偏移量（从 0 开始）。必填。", "interface_type": "number", "property": "start", "required": true, "type": "integer" } }, "path": "doc.create_inline_comment", "primary_cli_path": "doc comment create-inline", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "创建划词评论", "use_when": [ "针对块内某段文本创建划词评论（必填 blockId、start、end）时" ] }, "doc.delete_comment": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws doc comment delete --help", "internal/cli/schema_command_registry.json#doc.delete_comment", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "live-mcp:dws schema doc-comment.delete_comment", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-comment.md", "structured-hint:internal/cli/schema_hints/products/doc.json" ], "agent_summary": "永久删除指定文档中的一条评论", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "只需改文案用 update；回复用 reply；目标评论不明或未确认时不要删" ], "canonical_path": "doc.delete_comment", "cli_name": "delete", "cli_path": "doc comment delete", "confirmation": "user_required", "description": "删除指定文档中的一条评论。\n\n这是不可恢复的危险操作。执行前需要交互确认，或在用户已明确同意后传入全局 --yes 跳过确认。", "display": "钉钉文档管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws doc comment delete --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "永久删除指定文档中的一条评论" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "永久删除指定文档中的一条评论" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "只需改文案用 update；回复用 reply；目标评论不明或未确认时不要删" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "只需改文案用 update；回复用 reply；目标评论不明或未确认时不要删" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc comment delete", "value": "doc.delete_comment" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc comment delete", "value": "doc.delete_comment" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "user_required" }, { "precedence": "skill", "review_reason": "Skill command comment explicitly marks the operation as risky", "selected": false, "source": "skills/mono/references/products/doc.md", "value": "user_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "user_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "删除指定文档中的一条评论。\n\n这是不可恢复的危险操作。执行前需要交互确认，或在用户已明确同意后传入全局 --yes 跳过确认。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "删除指定文档中的一条评论。\n\n这是不可恢复的危险操作。执行前需要交互确认，或在用户已明确同意后传入全局 --yes 跳过确认。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" }, { "precedence": "skill", "review_reason": "Skill command comment explicitly marks the operation as risky", "selected": false, "source": "skills/mono/references/products/doc.md", "value": "destructive" }, { "precedence": "inference_or_default", "selected": false, "source": "command-verb", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc comment delete --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc comment delete --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "unknown" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "unknown" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/doc.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" }, { "precedence": "skill", "review_reason": "Skill command comment explicitly marks the operation as risky", "selected": false, "source": "skills/mono/references/products/doc.md", "value": "high" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "删除文档评论" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "删除文档评论" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户明确要求永久删除指定文档中的某条评论（已有 commentKey）时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户明确要求永久删除指定文档中的某条评论（已有 commentKey）时" ] } }, "group": "comment", "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "delete_comment", "parameter_count": 2, "parameters": { "comment-key": { "description": "待删除评论的 commentKey，可从 list/create/create-inline 结果获取 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "待删除评论的 commentKey，可从 list/create/create-inline 结果获取 (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "待删除评论的 commentKey，可从 list/create/create-inline 结果获取 (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.delete_comment has no singular pinned interface_ref; --comment-key is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "commentKey" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.delete_comment has no singular pinned interface_ref; --comment-key is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" }, "node": { "description": "目标文档的标识，支持传入 URL 或 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文档的标识，支持传入 URL 或 ID (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文档的标识，支持传入 URL 或 ID (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "nodeId", "required": true, "type": "string" } }, "path": "doc.delete_comment", "primary_cli_path": "doc comment delete", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "删除文档评论", "use_when": [ "用户明确要求永久删除指定文档中的某条评论（已有 commentKey）时" ] }, "doc.delete_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.delete_document", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc delete", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document", "live-mcp:dws schema doc.delete_document", "skills/mono/SKILL.md", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-file-ops.md", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.delete_document" ], "agent_summary": "兼容入口：将文档或文件移入回收站；文件删除能力已迁移到 drive。", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "常规文件删除优先 dws drive delete；本入口仅为兼容", "用户未确认或目标不清时不要删", "删块用 doc block delete；删评论用 doc comment delete" ], "canonical_path": "doc.delete_document", "cli_name": "delete", "cli_path": "doc delete", "confirmation": "user_required", "description": "将文档或文件移入回收站。\n\n注意: 这是一个危险操作，文档将被移入回收站。执行前需要确认，或传入 --yes 跳过确认。\n\n权限要求: 对文档有\"管理\"权限。", "display": "钉钉文档管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws doc delete --node \u003cDOC_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：将文档或文件移入回收站；文件删除能力已迁移到 drive。" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：将文档或文件移入回收站；文件删除能力已迁移到 drive。" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "常规文件删除优先 dws drive delete；本入口仅为兼容", "用户未确认或目标不清时不要删", "删块用 doc block delete；删评论用 doc comment delete" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "常规文件删除优先 dws drive delete；本入口仅为兼容", "用户未确认或目标不清时不要删", "删块用 doc block delete；删评论用 doc comment delete" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc delete", "value": "doc.delete_document" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc delete", "value": "doc.delete_document" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "user_required" }, { "precedence": "skill", "review_reason": "Skill danger table explicitly reviews this operation", "selected": false, "source": "skills/mono/SKILL.md", "value": "user_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "user_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "将文档或文件移入回收站。\n\n注意: 这是一个危险操作，文档将被移入回收站。执行前需要确认，或传入 --yes 跳过确认。\n\n权限要求: 对文档有\"管理\"权限。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。\r\n\r\n支持范围：\r\n- 知识库（workspace）下的文档节点、文件夹节点\r\n- 钉盘「我的文件」或「团队空间（space）」下的文件、文件夹节点（但钉盘操作仍建议走钉盘MCP服务）\r\n\r\n不支持的操作：\r\n- 不支持直接删除知识库本身（workspace）\r\n- 不支持直接删除团队空间（space）\r\n\r\n权限要求：\r\n- 对目标节点有管理权限（owner 或被授予管理权限的成员）\r\n\r\n注意事项：\r\n- 删除操作不可立即撤销，请在调用前向用户确认\r\n- 删除文件夹时，文件夹内的所有子节点也会一并移入回收站" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "将文档或文件移入回收站。\n\n注意: 这是一个危险操作，文档将被移入回收站。执行前需要确认，或传入 --yes 跳过确认。\n\n权限要求: 对文档有\"管理\"权限。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "destructive" }, { "precedence": "skill", "review_reason": "Skill danger table explicitly reviews this operation", "selected": false, "source": "skills/mono/SKILL.md", "value": "destructive" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "destructive" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc delete --node \u003cDOC_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc delete --node \u003cDOC_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document.interface_ref", "value": { "product_id": "doc", "rpc_name": "delete_document" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document.interface_ref", "value": { "product_id": "doc", "rpc_name": "delete_document" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "high" }, { "precedence": "skill", "review_reason": "Skill danger table explicitly reviews this operation", "selected": false, "source": "skills/mono/SKILL.md", "value": "high" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "high" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "删除文档/文件到回收站" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "删除节点" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "删除文档/文件到回收站" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户明确要求用 doc delete 兼容入口将文档/文件移入回收站，且已确认目标时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户明确要求用 doc delete 兼容入口将文档/文件移入回收站，且已确认目标时" ] } }, "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "delete_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_document", "parameter_count": 1, "parameters": { "node": { "description": "文档/文件 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档/文件 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要删除的节点标识，支持以下格式：1) 文档/文件夹 URL，如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}；2) dentryUuid（32 位字母数字字符串）。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档/文件 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "tool_schema_hint", "selected": true, "source": "tool_schema_hint", "value": true }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "tool_schema_hint", "resolution": "highest_precedence", "source": "tool_schema_hint", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要删除的节点标识，支持以下格式：1) 文档/文件夹 URL，如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}；2) dentryUuid（32 位字母数字字符串）。", "property": "nodeId", "required": true, "type": "string" } }, "path": "doc.delete_document", "primary_cli_path": "doc delete", "product_id": "doc", "reviewed": true, "risk": "high", "source": "reviewed_command_registry", "title": "删除文档/文件到回收站", "use_when": [ "用户明确要求用 doc delete 兼容入口将文档/文件移入回收站，且已确认目标时" ] }, "doc.delete_document_block": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.delete_document_block", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc block delete", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.delete_document_block", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document_block", "live-mcp:dws schema doc.delete_document_block", "skills/mono/SKILL.md", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-block.md", "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.delete_document_block", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.delete_document_block" ], "agent_summary": "删除块元素（不可逆）", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "未确认或 blockId 不明时不要删；先 block list", "删整篇文档用 doc/drive delete" ], "canonical_path": "doc.delete_document_block", "cli_name": "delete", "cli_path": "doc block delete", "confirmation": "user_required", "description": "删除块元素", "display": "钉钉文档管理", "effect": "destructive", "effect_source": "agent-hint", "examples": [ "dws doc block delete --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "删除块元素（不可逆）" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "删除块元素（不可逆）" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document_block.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "未确认或 blockId 不明时不要删；先 block list", "删整篇文档用 doc/drive delete" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "未确认或 blockId 不明时不要删；先 block list", "删整篇文档用 doc/drive delete" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc block delete", "value": "doc.delete_document_block" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc block delete", "value": "doc.delete_document_block" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "user_required" }, { "precedence": "imported", "selected": false, "source": "internal/cli/schema_hints/imported/wukong.json", "value": "user_required" }, { "precedence": "skill", "review_reason": "Skill danger table explicitly reviews this operation", "selected": false, "source": "skills/mono/SKILL.md", "value": "user_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "user_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "删除块元素" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "在指定文档中删除指定块元素，需要提供文档ID(dentryUuid)与块元素ID(blockId)。操作受文档权限控制，仅当调用者拥有编辑权限时生效。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "删除块元素" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "destructive" }, { "precedence": "skill", "review_reason": "Skill danger table explicitly reviews this operation", "selected": false, "source": "skills/mono/SKILL.md", "value": "destructive" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "destructive" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc block delete --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc block delete --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document_block.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "delete_document_block" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.delete_document_block.interface_ref", "value": "doc.delete_document_block" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "delete_document_block" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "high" }, { "precedence": "imported", "selected": false, "source": "internal/cli/schema_hints/imported/wukong.json", "value": "high" }, { "precedence": "skill", "review_reason": "Skill danger table explicitly reviews this operation", "selected": false, "source": "skills/mono/SKILL.md", "value": "high" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "high" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "删除块元素" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "删除块元素" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "删除块元素" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户确认后删除文档中指定块元素时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户确认后删除文档中指定块元素时" ] } }, "group": "block", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "delete_document_block" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "delete_document_block", "parameter_count": 2, "parameters": { "block-id": { "description": "目标块 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标块 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "待删除块元素的唯一标识。可通过 list_document_blocks 工具查询获取（返回结果中的 blockId 字段）。目前仅支持根目录下的第一级块元素的 blockId。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标块 ID (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "blockId" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "blockId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "待删除块元素的唯一标识。可通过 list_document_blocks 工具查询获取（返回结果中的 blockId 字段）。目前仅支持根目录下的第一级块元素的 blockId。必填。", "property": "blockId", "required": true, "type": "string" }, "node": { "description": "文档 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文档的标识，支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文档的标识，支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。必填。", "property": "nodeId", "required": true, "type": "string" } }, "path": "doc.delete_document_block", "primary_cli_path": "doc block delete", "product_id": "doc", "reviewed": true, "risk": "high", "source": "reviewed_command_registry", "title": "删除块元素", "use_when": [ "用户确认后删除文档中指定块元素时" ] }, "doc.download_doc_attachment": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.download_doc_attachment", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc media download", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.download_doc_attachment", "live-mcp:dws schema doc.download_doc_attachment", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-media.md", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.download_doc_attachment" ], "agent_summary": "获取文档附件的临时下载链接", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "下载钉盘普通文件用 drive download；导出在线文档用 doc export" ], "canonical_path": "doc.download_doc_attachment", "cli_name": "download", "cli_path": "doc media download", "confirmation": "not_required", "description": "获取钉钉文档中指定附件的 OSS 临时下载链接。\n\n传入 nodeId（文档标识）和 resourceId（附件资源 ID），返回 downloadUrl。\nresourceId 需通过 dws doc block list 获取：查询目标文档的块列表，\n找到 blockType 为 attachment 的元素，取其 resourceId。", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc media download --node \u003cDOC_ID\u003e --resource-id \u003cRESOURCE_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "获取文档附件的临时下载链接" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "获取文档附件的临时下载链接" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_doc_attachment.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "下载钉盘普通文件用 drive download；导出在线文档用 doc export" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "下载钉盘普通文件用 drive download；导出在线文档用 doc export" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc media download", "value": "doc.download_doc_attachment" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc media download", "value": "doc.download_doc_attachment" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取钉钉文档中指定附件的 OSS 临时下载链接。\n\n传入 nodeId（文档标识）和 resourceId（附件资源 ID），返回 downloadUrl。\nresourceId 需通过 dws doc block list 获取：查询目标文档的块列表，\n找到 blockType 为 attachment 的元素，取其 resourceId。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "获取钉钉文档中指定附件的临时下载 URL。\r\n传入文档标识 nodeId 和附件资源标识 resourceId，返回附件的 OSS 临时下载链接 downloadUrl。\r\n前置依赖：需先调用 list_document_blocks 获取文档块列表，从中找到 blockType 为 attachment 的块元素，提取其 resourceId 作为本工具的入参。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取钉钉文档中指定附件的 OSS 临时下载链接。\n\n传入 nodeId（文档标识）和 resourceId（附件资源 ID），返回 downloadUrl。\nresourceId 需通过 dws doc block list 获取：查询目标文档的块列表，\n找到 blockType 为 attachment 的元素，取其 resourceId。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc media download --node \u003cDOC_ID\u003e --resource-id \u003cRESOURCE_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc media download --node \u003cDOC_ID\u003e --resource-id \u003cRESOURCE_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_doc_attachment.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_doc_attachment.interface_ref", "value": { "product_id": "doc", "rpc_name": "download_doc_attachment" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_doc_attachment.interface_ref", "value": { "product_id": "doc", "rpc_name": "download_doc_attachment" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "下载文档附件" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "下载指定钉钉文档中的指定附件" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "下载文档附件" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "获取文档正文中附件的临时下载 URL（resourceId 来自 block list attachment）时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "获取文档正文中附件的临时下载 URL（resourceId 来自 block list attachment）时" ] } }, "group": "media", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "download_doc_attachment" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "download_doc_attachment", "parameter_count": 2, "parameters": { "node": { "description": "目标文档的标识，支持传入 URL 或 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文档的标识，支持传入 URL 或 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "文档nodeId，支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文档的标识，支持传入 URL 或 ID (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "文档nodeId，支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。必填。", "property": "nodeId", "required": true, "type": "string" }, "resource-id": { "description": "附件资源 ID，可通过 dws doc block list 获取 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "附件资源 ID，可通过 dws doc block list 获取 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "附件的资源ID" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "附件资源 ID，可通过 dws doc block list 获取 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "resourceId" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "resourceId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "附件的资源ID", "property": "resourceId", "required": true, "type": "string" } }, "path": "doc.download_doc_attachment", "primary_cli_path": "doc media download", "product_id": "doc", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "下载文档附件", "use_when": [ "获取文档正文中附件的临时下载 URL（resourceId 来自 block list attachment）时" ] }, "doc.download_file": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.download_file", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc download", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.download_file", "live-mcp:dws schema doc.download_file", "skills/mono/references/products/doc/doc-file-ops.md", "skills/mono/references/products/sheet.md", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.download_file" ], "agent_summary": "兼容入口：下载钉盘或文档空间已有文件；文件下载能力已迁移到 drive。", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "常规下载普通文件改用 dws drive download --output ...", "在线文档导出 docx 用 doc export" ], "canonical_path": "doc.download_file", "cli_name": "download", "cli_path": "doc download", "confirmation": "not_required", "description": "下载钉钉文档空间中的文件到本地（两步下载流程）。\n\n流程:\n 1. 获取下载 URL 和签名请求头 (download_file)\n 2. HTTP GET 下载文件二进制内容到本地", "display": "钉钉文档管理", "dry_run": { "preview_kind": "plan" }, "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc download --node \u003cNODE_ID\u003e --output ./report.pdf --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：下载钉盘或文档空间已有文件；文件下载能力已迁移到 drive。" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：下载钉盘或文档空间已有文件；文件下载能力已迁移到 drive。" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_file.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "常规下载普通文件改用 dws drive download --output ...", "在线文档导出 docx 用 doc export" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "常规下载普通文件改用 dws drive download --output ...", "在线文档导出 docx 用 doc export" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc download", "value": "doc.download_file" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc download", "value": "doc.download_file" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "下载钉钉文档空间中的文件到本地（两步下载流程）。\n\n流程:\n 1. 获取下载 URL 和签名请求头 (download_file)\n 2. HTTP GET 下载文件二进制内容到本地" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "获取文件下载凭证，供 AI Agent 自行发起 HTTP GET 请求下载文件内容。本工具是两步下载流程的第一步（也是唯一需要调用的 MCP Tool）。\r\n\r\n完整下载流程：\r\n Step 1：调用本工具，传入文件节点 ID（nodeId），获取下载 URL（resourceUrl）和签名请求头（headers）。\r\n Step 2：AI Agent 自行发起 HTTP GET 请求：\r\n - URL：使用 resourceUrl 中的第一个 URL（优先级最高）。\r\n - Headers：将 headers 中所有键值对作为请求头携带。\r\n - 期望响应：HTTP 200，Body 为文件二进制内容。\r\n - 注意：下载凭证有过期时间（expirationSeconds），请在过期前完成下载；若已过期，需重新调用本工具获取新凭证。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "下载钉钉文档空间中的文件到本地（两步下载流程）。\n\n流程:\n 1. 获取下载 URL 和签名请求头 (download_file)\n 2. HTTP GET 下载文件二进制内容到本地" }, "dry_run": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "reviewed positive dry-run capability", "selected": true, "source": "reviewed_dry_run_registry", "source_ref": "internal/cli/schema_dry_run_capabilities.go", "value": { "preview_kind": "plan" } } ], "precedence": "reviewed_explicit", "resolution": "exact_canonical_lookup", "review_reason": "reviewed positive dry-run capability", "source": "reviewed_dry_run_registry", "source_ref": "internal/cli/schema_dry_run_capabilities.go", "value": { "preview_kind": "plan" } }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc download --node \u003cNODE_ID\u003e --output ./report.pdf --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc download --node \u003cNODE_ID\u003e --output ./report.pdf --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_file.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_file.interface_ref", "value": { "product_id": "doc", "rpc_name": "download_file" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.doc.download_file.interface_ref", "value": { "product_id": "doc", "rpc_name": "download_file" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "下载文件" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "获取文件下载凭证" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "下载文件" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "兼容入口：获取文件下载凭证（已迁移场景优先 drive download）时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "兼容入口：获取文件下载凭证（已迁移场景优先 drive download）时" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "download_file" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "download_file", "parameter_count": 2, "parameters": { "node": { "cli_required": true, "description": "文件节点 ID 或 URL (必填)", "field_provenance": { "cli_required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_hard_required", "value": true } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_hard_required", "value": true }, "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件节点 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "支持两种格式：1) 文档链接 URL，如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}；2) dentryUuid（32 位字母数字字符串）。必须指向文件节点（非文件夹）。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件节点 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_hard_required", "value": true }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_hard_required", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "支持两种格式：1) 文档链接 URL，如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}；2) dentryUuid（32 位字母数字字符串）。必须指向文件节点（非文件夹）。", "property": "nodeId", "required": true, "type": "string" }, "output": { "cli_required": true, "description": "本地保存路径 (文件路径或目录)", "field_provenance": { "cli_required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_hard_required", "value": true } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_hard_required", "value": true }, "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "本地保存路径 (文件路径或目录)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "本地保存路径 (文件路径或目录)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "local output path", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "output" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "local output path", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_hard_required", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_hard_required", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" } }, "path": "doc.download_file", "primary_cli_path": "doc download", "product_id": "doc", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "下载文件", "use_when": [ "兼容入口：获取文件下载凭证（已迁移场景优先 drive download）时" ] }, "doc.get_document_content": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.get_document_content", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc read", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.get_document_content", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_content", "live-mcp:dws schema doc.get_document_content", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-read.md", "skills/mono/references/products/doc/style/doc-update-workflow.md", "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.get_document_content", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.get_document_content" ], "agent_summary": "读取文档内容（Markdown）", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "非 adoc（表格/多维表/普通文件）不要用本命令；先 doc info 再路由", "要元信息用 doc info；要块结构用 doc block list", "Markdown 为有损投影：保形复制模板请用 doc copy，不要 read→create" ], "canonical_path": "doc.get_document_content", "cli_name": "read", "cli_path": "doc read", "confirmation": "not_required", "description": "获取文档内容，以 Markdown 格式返回。支持传入文档 URL 或 ID。", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc read --node \u003cDOC_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "读取文档内容（Markdown）" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "读取文档内容（Markdown）" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_content.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "非 adoc（表格/多维表/普通文件）不要用本命令；先 doc info 再路由", "要元信息用 doc info；要块结构用 doc block list", "Markdown 为有损投影：保形复制模板请用 doc copy，不要 read→create" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "非 adoc（表格/多维表/普通文件）不要用本命令；先 doc info 再路由", "要元信息用 doc info；要块结构用 doc block list", "Markdown 为有损投影：保形复制模板请用 doc copy，不要 read→create" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc read", "value": "doc.get_document_content" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc read", "value": "doc.get_document_content" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取文档内容，以 Markdown 格式返回。支持传入文档 URL 或 ID。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "获取钉钉文档的内容，以 Markdown 格式返回。\r\n\r\n通过 nodeId 定位文档，支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。\r\n\r\n仅限用户对文档具备\"可阅读\"权限时可获取。不支持跨组织查询。\r\n\r\n支持的文档类型：钉钉在线文档。\r\n文档链接格式：https://alidocs.dingtalk.com/i/nodes/{dentryUuid}\r\ndentryUuid 为 32 位字母数字字符串。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取文档内容，以 Markdown 格式返回。支持传入文档 URL 或 ID。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc read --node \u003cDOC_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc read --node \u003cDOC_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_content.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "get_document_content" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_content.interface_ref", "value": "doc.get_document_content" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "get_document_content" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "读取文档内容 (Markdown)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "获取钉钉文档内容" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "读取文档内容 (Markdown)" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户要读取钉钉在线文字文档(adoc)正文（Markdown）时", "用户直接粘贴文档 URL 且无其他指令时（默认读内容）" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户要读取钉钉在线文字文档(adoc)正文（Markdown）时", "用户直接粘贴文档 URL 且无其他指令时（默认读内容）" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "get_document_content" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_document_content", "parameter_count": 3, "parameters": { "content-format": { "description": "输出格式: 默认为 markdown，可选 jsonml", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "输出格式: 默认为 markdown，可选 jsonml" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "拉取数据的格式，支持 markdown | jsonml，默认为 markdown" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "输出格式: 默认为 markdown，可选 jsonml" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "format" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "contentFormat" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "format" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "拉取数据的格式，支持 markdown | jsonml，默认为 markdown", "property": "format", "required": false, "type": "string" }, "node": { "description": "文档 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文档的标识，支持两种格式：1) 文档链接 URL，如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}；2) 文档 ID（dentryUuid），32 位字母数字字符串。系统自动识别格式。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "tool_schema_hint", "selected": true, "source": "tool_schema_hint", "value": true }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "tool_schema_hint", "resolution": "highest_precedence", "source": "tool_schema_hint", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文档的标识，支持两种格式：1) 文档链接 URL，如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}；2) 文档 ID（dentryUuid），32 位字母数字字符串。系统自动识别格式。", "property": "nodeId", "required": true, "type": "string" }, "output": { "description": "输出到本地文件路径（仅 --content-format jsonml 时生效）", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "输出到本地文件路径（仅 --content-format jsonml 时生效）" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "输出到本地文件路径（仅 --content-format jsonml 时生效）" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "local output path", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "output" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "local output path", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" } }, "path": "doc.get_document_content", "primary_cli_path": "doc read", "product_id": "doc", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "读取文档内容 (Markdown)", "use_when": [ "用户要读取钉钉在线文字文档(adoc)正文（Markdown）时", "用户直接粘贴文档 URL 且无其他指令时（默认读内容）" ] }, "doc.get_document_info": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.get_document_info", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc info", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.get_document_info", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_info", "live-mcp:dws schema doc.get_document_info", "skills/mono/references/intent-guide.md", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-info.md", "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.get_document_info", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.get_document_info" ], "agent_summary": "获取文档元信息（标题/类型/创建者/权限等）", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "已确认是 adoc 且只要正文改用 dws doc read", "只要目录列表改用 dws drive list / wiki node list" ], "canonical_path": "doc.get_document_info", "cli_name": "info", "cli_path": "doc info", "confirmation": "not_required", "description": "获取文档标题、类型、创建者、创建时间、权限等元信息 (不含内容)。", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc info --node \u003cDOC_ID\u003e --format json", "dws doc info --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "获取文档元信息（标题/类型/创建者/权限等）" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "获取文档元信息（标题/类型/创建者/权限等）" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_info.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "已确认是 adoc 且只要正文改用 dws doc read", "只要目录列表改用 dws drive list / wiki node list" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "已确认是 adoc 且只要正文改用 dws doc read", "只要目录列表改用 dws drive list / wiki node list" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc info", "value": "doc.get_document_info" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc info", "value": "doc.get_document_info" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取文档标题、类型、创建者、创建时间、权限等元信息 (不含内容)。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "获取存储在钉钉文档（含知识库）、钉盘相关文件的元信息，包括文档标题、类型、创建者、创建时间等。\r\n返回字段中的 contentType 和 extension 是后续工具路由的关键依据。\r\n\r\n⚠️ 重要：当用户需要获取任何钉钉文件的内容时，必须先调用本工具，\r\n再根据返回的 contentType 和 extension 字段按以下规则选择对应工具：\r\n\r\n- contentType=ALIDOC, extension=adoc → 调用 get_document_content(nodeId)，返回 Markdown 内容\r\n- contentType=ALIDOC, extension=axls → 调用钉钉表格 MCP: get_all_sheets(nodeId) 获取工作表列表，再调用 get_range(nodeId, sheetId, range) 读取数据\r\n- contentType=ALIDOC, extension=able → 调用钉钉AI表格 MCP: get_tables(nodeId) 获取数据表列表（nodeId 即 baseId），再调用 query_records(nodeId, tableId) 查询记录\r\n- contentType≠ALIDOC 且 nodeType=file → 调用 download_file(nodeId)，返回文件下载链接" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取文档标题、类型、创建者、创建时间、权限等元信息 (不含内容)。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc info --node \u003cDOC_ID\u003e --format json", "dws doc info --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc info --node \u003cDOC_ID\u003e --format json", "dws doc info --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_info.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "get_document_info" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.get_document_info.interface_ref", "value": "doc.get_document_info" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "get_document_info" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取文档元信息" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "获取节点基本信息" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取文档元信息" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户要查看文档/节点元信息（标题、类型、创建者、权限）时", "准备读内容前必须先看 contentType/extension 以路由到 read/sheet/aitable/download 时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户要查看文档/节点元信息（标题、类型、创建者、权限）时", "准备读内容前必须先看 contentType/extension 以路由到 read/sheet/aitable/download 时" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "get_document_info" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "get_document_info", "parameter_count": 1, "parameters": { "node": { "description": "文档 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文档的标识，支持传入 URL 或 ID。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文档的标识，支持传入 URL 或 ID。必填。", "property": "nodeId", "required": true, "type": "string" } }, "path": "doc.get_document_info", "primary_cli_path": "doc info", "product_id": "doc", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "获取文档元信息", "use_when": [ "用户要查看文档/节点元信息（标题、类型、创建者、权限）时", "准备读内容前必须先看 contentType/extension 以路由到 read/sheet/aitable/download 时" ] }, "doc.import_get": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.import_get", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc import get", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "live-mcp:none (Cobra+Skill; composite/unpinned)", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-import.md", "structured-hint:internal/cli/schema_hints/products/doc.json" ], "agent_summary": "根据 taskId 查询文档导入任务的执行结果", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "发起导入用 doc import（若入口可用）；不要用本命令代替导入" ], "canonical_path": "doc.import_get", "cli_name": "get", "cli_path": "doc import get", "confirmation": "not_required", "description": "根据 taskId 查询文档导入任务的执行结果。\n通常不需要手动调用，dws doc import 会自动完成轮询。\n仅在导入命令超时或中断后，用于手动查询任务状态。\n\n任务状态:\n processing 转换中\n completed 导入成功，返回 documentUrl\n failed 导入失败", "display": "钉钉文档管理", "dry_run": { "preview_kind": "plan" }, "effect": "write", "effect_source": "agent-hint", "examples": [ "dws doc import get --task-id \u003cTASK_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "根据 taskId 查询文档导入任务的执行结果" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "根据 taskId 查询文档导入任务的执行结果" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "发起导入用 doc import（若入口可用）；不要用本命令代替导入" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "发起导入用 doc import（若入口可用）；不要用本命令代替导入" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc import get", "value": "doc.import_get" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc import get", "value": "doc.import_get" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" }, { "precedence": "inference_or_default", "selected": false, "source": "risk-default", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "根据 taskId 查询文档导入任务的执行结果。\n通常不需要手动调用，dws doc import 会自动完成轮询。\n仅在导入命令超时或中断后，用于手动查询任务状态。\n\n任务状态:\n processing 转换中\n completed 导入成功，返回 documentUrl\n failed 导入失败" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "根据 taskId 查询文档导入任务的执行结果。\n通常不需要手动调用，dws doc import 会自动完成轮询。\n仅在导入命令超时或中断后，用于手动查询任务状态。\n\n任务状态:\n processing 转换中\n completed 导入成功，返回 documentUrl\n failed 导入失败" }, "dry_run": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "reviewed positive dry-run capability", "selected": true, "source": "reviewed_dry_run_registry", "source_ref": "internal/cli/schema_dry_run_capabilities.go", "value": { "preview_kind": "plan" } } ], "precedence": "reviewed_explicit", "resolution": "exact_canonical_lookup", "review_reason": "reviewed positive dry-run capability", "source": "reviewed_dry_run_registry", "source_ref": "internal/cli/schema_dry_run_capabilities.go", "value": { "preview_kind": "plan" } }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" }, { "precedence": "inference_or_default", "selected": false, "source": "command-verb", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc import get --task-id \u003cTASK_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc import get --task-id \u003cTASK_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "unknown" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "unknown" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/doc.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查询导入任务结果（手动兜底）" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查询导入任务结果（手动兜底）" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "查询文档导入任务结果（已有 taskId，导入超时/中断后兜底）时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "查询文档导入任务结果（已有 taskId，导入超时/中断后兜底）时" ] } }, "group": "import", "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "import_get", "parameter_count": 1, "parameters": { "task-id": { "description": "导入任务 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "导入任务 ID (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "导入任务 ID (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.import_get has no singular pinned interface_ref; --task-id is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "taskId" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.import_get has no singular pinned interface_ref; --task-id is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" } }, "path": "doc.import_get", "primary_cli_path": "doc import get", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "查询导入任务结果（手动兜底）", "use_when": [ "查询文档导入任务结果（已有 taskId，导入超时/中断后兜底）时" ] }, "doc.insert_document_block": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.insert_document_block", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc block insert", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.insert_document_block", "live-mcp:dws schema doc.insert_document_block", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-block.md", "skills/mono/references/products/doc/format/doc-jsonml-cookbook.md", "skills/mono/references/products/doc/style/doc-update-workflow.md", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.insert_document_block" ], "agent_summary": "向文档插入块元素", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "整篇追加 Markdown 优先 doc update --mode append", "插入本地文件附件优先 doc media insert", "删块用 block delete；改已有块用 block update" ], "canonical_path": "doc.insert_document_block", "cli_name": "insert", "cli_path": "doc block insert", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "text", "heading", "element" ] ] }, "description": "向文档插入块元素。通过 --element 传入 JSON 格式的块元素。\n可用 --text 快速插入段落，--heading + --level 快速插入标题。\n\n块类型: paragraph, heading, blockquote, callout, columns,\n orderedList, unorderedList, table, sheet, attachment, slot", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc block insert --node \u003cDOC_ID\u003e --text \"这是一段文字\" --format json", "dws doc block insert --node \u003cDOC_ID\u003e --heading \"二级标题\" --level 2 --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "向文档插入块元素" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "向文档插入块元素" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.insert_document_block.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "整篇追加 Markdown 优先 doc update --mode append", "插入本地文件附件优先 doc media insert", "删块用 block delete；改已有块用 block update" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "整篇追加 Markdown 优先 doc update --mode append", "插入本地文件附件优先 doc media insert", "删块用 block delete；改已有块用 block update" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc block insert", "value": "doc.insert_document_block" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc block insert", "value": "doc.insert_document_block" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "向文档插入块元素。通过 --element 传入 JSON 格式的块元素。\n可用 --text 快速插入段落，--heading + --level 快速插入标题。\n\n块类型: paragraph, heading, blockquote, callout, columns,\n orderedList, unorderedList, table, sheet, attachment, slot" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "将一个新的块元素插入指定文档，需要提供文档ID(dentryUuid)与块元素内容(必须包含 blockType 及对应类型的属性对象)。可以支持在指定块元素(传入blockId或index)的头部或尾部插入块元素。操作受文档权限控制，仅当调用者拥有编辑权限时生效。\r\n\r\n【附件插入说明】\r\n若 blockType 为 \"attachment\"：\r\n1. 必须先调用 get_doc_attachment_upload_info 工具获取该附件的属性（resourceId）。\r\n2. 将获取到的信息整合进 element 的 attachment 对象中，然后再调用此工具。\r\n\r\n【get_doc_attachment_upload_info 接口使用说明】\r\n获取向指定钉钉文档上传附件所需的 OSS 上传凭证信息。\r\n使用流程：\r\n1. 调用 get_doc_attachment_upload_info 接口，传入文档标识（nodeId）、文件名、文件大小和 MIME 类型，获取上传凭证。\r\n2. 使用返回的 uploadUrl 通过 HTTP PUT 请求将文件内容上传至 OSS，需设置以下请求头：\r\n Content-Type：与入参 mimeType 保持一致，例如 `application/pdf`\r\n Content-Length：与入参 fileSize 保持一致，单位为字节\r\n3. 上传成功后，使用返回的 resourceId 在文档中插入类型为附件的块元素。\r\n\r\n注意事项：\r\n1. uploadUrl 具有时效性，请在获取后尽快完成上传，避免凭证过期。\r\n2. fileSize 必须与实际文件大小一致，否则上传可能失败。\r\n3. mimeType 应与实际文件类型匹配，例如 PDF 文件传 application/pdf。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "向文档插入块元素。通过 --element 传入 JSON 格式的块元素。\n可用 --text 快速插入段落，--heading + --level 快速插入标题。\n\n块类型: paragraph, heading, blockquote, callout, columns,\n orderedList, unorderedList, table, sheet, attachment, slot" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc block insert --node \u003cDOC_ID\u003e --text \"这是一段文字\" --format json", "dws doc block insert --node \u003cDOC_ID\u003e --heading \"二级标题\" --level 2 --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc block insert --node \u003cDOC_ID\u003e --text \"这是一段文字\" --format json", "dws doc block insert --node \u003cDOC_ID\u003e --heading \"二级标题\" --level 2 --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.insert_document_block.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.insert_document_block.interface_ref", "value": { "product_id": "doc", "rpc_name": "insert_document_block" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.doc.insert_document_block.interface_ref", "value": { "product_id": "doc", "rpc_name": "insert_document_block" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "插入块元素" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "插入块元素" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "插入块元素" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "在文档中插入新块（段落/标题等）；简单场景用 --text/--heading，复杂块用 --element JSON" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "在文档中插入新块（段落/标题等）；简单场景用 --text/--heading，复杂块用 --element JSON" ] } }, "group": "block", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "insert_document_block" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "insert_document_block", "parameter_count": 11, "parameters": { "content-format": { "description": "输入格式: 默认为 element，可选 jsonml", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "输入格式: 默认为 element，可选 jsonml" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "数据的格式，可选为 element 或 jsonml，默认为 element" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "输入格式: 默认为 element，可选 jsonml" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "format" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "contentFormat" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "format" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "数据的格式，可选为 element 或 jsonml，默认为 element", "property": "format", "required": false, "type": "string" }, "element": { "description": "块元素 JSON (高级)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "块元素 JSON (高级)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "element 格式数据，待插入的块元素，必须包含 blockType 及对应类型的属性对象，详见块元素数据结构附录。最精简示例：{\"blockType\": \"paragraph\", \"paragraph\": {}}。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "块元素 JSON (高级)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "object" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "object" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "element" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "element" }, "required": { "candidates": [ { "precedence": "command_constraint", "selected": true, "source": "require_one_of_constraint", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "command_constraint", "resolution": "highest_precedence", "source": "require_one_of_constraint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "element 格式数据，待插入的块元素，必须包含 blockType 及对应类型的属性对象，详见块元素数据结构附录。最精简示例：{\"blockType\": \"paragraph\", \"paragraph\": {}}。", "interface_type": "object", "property": "element", "required": false, "type": "string" }, "fix-jsonml": { "description": "启用 JSON 语法修复（括号/逗号补全），推荐 agent 调用时使用", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "启用 JSON 语法修复（括号/逗号补全），推荐 agent 调用时使用" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "启用 JSON 语法修复（括号/逗号补全），推荐 agent 调用时使用" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "local JSONML normalization control", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "fixJsonml" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "local JSONML normalization control", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "boolean" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "boolean" } }, "required": false, "type": "boolean" }, "heading": { "description": "快捷: 标题文本", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "快捷: 标题文本" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "快捷: 标题文本" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "aggregate convenience input used to build element", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "heading" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "aggregate convenience input used to build element", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "command_constraint", "selected": true, "source": "require_one_of_constraint", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "command_constraint", "resolution": "highest_precedence", "source": "require_one_of_constraint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "index": { "description": "参照位置索引 (从 0 开始)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "参照位置索引 (从 0 开始)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "当 referenceBlockId 未指定时，使用 index 查找文档第 index 个一级块元素作为参照位置（从 0 开始）。两者均未指定时，默认插入到文档末尾。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "参照位置索引 (从 0 开始)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "index" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "index" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "当 referenceBlockId 未指定时，使用 index 查找文档第 index 个一级块元素作为参照位置（从 0 开始）。两者均未指定时，默认插入到文档末尾。", "interface_type": "number", "property": "index", "required": false, "type": "integer" }, "level": { "default": "1", "description": "标题级别 1-6 (配合 --heading)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "标题级别 1-6 (配合 --heading)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "标题级别 1-6 (配合 --heading)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "aggregate convenience input used to build element", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "level" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "aggregate convenience input used to build element", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "required": false, "type": "integer" }, "node": { "description": "文档 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文档的标识，支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文档的标识，支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。必填。", "property": "nodeId", "required": true, "type": "string" }, "parent-block": { "description": "父容器 UUID（容器内插入时使用，与 --index 配合）", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "父容器 UUID（容器内插入时使用，与 --index 配合）" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "参照块的唯一标识（由 list_document_blocks 返回的 blockId）。指定后以该块为插入参照位置，优先级高于 index。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "父容器 UUID（容器内插入时使用，与 --index 配合）" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "referenceBlockId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "parentBlock" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "referenceBlockId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "参照块的唯一标识（由 list_document_blocks 返回的 blockId）。指定后以该块为插入参照位置，优先级高于 index。", "property": "referenceBlockId", "required": false, "type": "string" }, "ref-block": { "description": "参照块 ID (优先级高于 --index)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "参照块 ID (优先级高于 --index)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "参照块的唯一标识（由 list_document_blocks 返回的 blockId）。指定后以该块为插入参照位置，优先级高于 index。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "参照块 ID (优先级高于 --index)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "referenceBlockId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "refBlock" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "referenceBlockId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "参照块的唯一标识（由 list_document_blocks 返回的 blockId）。指定后以该块为插入参照位置，优先级高于 index。", "property": "referenceBlockId", "required": false, "type": "string" }, "text": { "description": "快捷: 段落文本内容", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "快捷: 段落文本内容" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "快捷: 段落文本内容" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "aggregate convenience input used to build element", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "text" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "aggregate convenience input used to build element", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "command_constraint", "selected": true, "source": "require_one_of_constraint", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "command_constraint", "resolution": "highest_precedence", "source": "require_one_of_constraint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "where": { "description": "插入方向: before / after (默认 after)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "插入方向: before / after (默认 after)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "插入方向：before（参照位置之前）或 after（参照位置之后）。默认为 after。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "插入方向: before / after (默认 after)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "where" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "where" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "插入方向：before（参照位置之前）或 after（参照位置之后）。默认为 after。", "property": "where", "required": false, "type": "string" } }, "path": "doc.insert_document_block", "primary_cli_path": "doc block insert", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "插入块元素", "use_when": [ "在文档中插入新块（段落/标题等）；简单场景用 --text/--heading，复杂块用 --element JSON" ] }, "doc.list_comments": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.list_comments", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc comment list", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.list_comments", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.list_comments", "live-mcp:dws schema doc-comment.list_comments", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-comment.md", "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.list_comments", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.list_comments" ], "agent_summary": "查询文档评论列表", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "创建全文评论用 comment create；划词用 create-inline；回复用 reply；删除用 delete" ], "canonical_path": "doc.list_comments", "cli_name": "list", "cli_path": "doc comment list", "confirmation": "not_required", "description": "查询指定文档的评论列表，支持分页、按评论类型和解决状态过滤。\n\n评论类型 (--type):\n global 全文评论\n inline 划词评论\n 不传返回所有评论\n\n解决状态 (--resolve-status):\n resolved 已解决\n unresolved 未解决\n 不传返回所有评论", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc comment list --node \u003cDOC_ID\u003e --format json", "dws doc comment list --node \u003cDOC_ID\u003e --type inline --resolve-status unresolved --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "查询文档评论列表" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "查询文档评论列表" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_comments.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "创建全文评论用 comment create；划词用 create-inline；回复用 reply；删除用 delete" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "创建全文评论用 comment create；划词用 create-inline；回复用 reply；删除用 delete" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc comment list", "value": "doc.list_comments" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc comment list", "value": "doc.list_comments" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查询指定文档的评论列表，支持分页、按评论类型和解决状态过滤。\n\n评论类型 (--type):\n global 全文评论\n inline 划词评论\n 不传返回所有评论\n\n解决状态 (--resolve-status):\n resolved 已解决\n unresolved 未解决\n 不传返回所有评论" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "获取钉钉文档的评论列表，支持分页查询、按评论类型和解决状态过滤。\r\n通过 nodeId 定位文档，支持传入文档链接 URL 或文档 ID（dentryUuid）。\r\n操作受权限控制，仅当调用者对文档有读取及以上权限时可获取评论。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查询指定文档的评论列表，支持分页、按评论类型和解决状态过滤。\n\n评论类型 (--type):\n global 全文评论\n inline 划词评论\n 不传返回所有评论\n\n解决状态 (--resolve-status):\n resolved 已解决\n unresolved 未解决\n 不传返回所有评论" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc comment list --node \u003cDOC_ID\u003e --format json", "dws doc comment list --node \u003cDOC_ID\u003e --type inline --resolve-status unresolved --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc comment list --node \u003cDOC_ID\u003e --format json", "dws doc comment list --node \u003cDOC_ID\u003e --type inline --resolve-status unresolved --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_comments.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": { "product_id": "doc-comment", "rpc_name": "list_comments" } }, { "precedence": "imported", "selected": false, "source": "internal/cli/schema_hints/imported/wukong.json", "value": "doc.list_comments" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_comments.interface_ref", "value": "doc-comment.list_comments" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": { "product_id": "doc-comment", "rpc_name": "list_comments" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查询文档评论列表" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "获取文档评论列表" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查询文档评论列表" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "查看文档评论列表，可按全文/划词、已解决/未解决过滤时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "查看文档评论列表，可按全文/划词、已解决/未解决过滤时" ] } }, "group": "comment", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc-comment", "rpc_name": "list_comments" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_comments", "parameter_count": 5, "parameters": { "cursor": { "description": "分页游标，从上一次请求的返回结果中获取 (首次请求不传)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标，从上一次请求的返回结果中获取 (首次请求不传)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "分页游标，从上一次请求的返回结果中获取 nextToken。首次请求不传。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标，从上一次请求的返回结果中获取 (首次请求不传)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nextToken" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nextToken" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "分页游标，从上一次请求的返回结果中获取 nextToken。首次请求不传。", "property": "nextToken", "required": false, "type": "string" }, "limit": { "default": "50", "description": "每页返回的评论数量，默认 50，最大 50", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页返回的评论数量，默认 50，最大 50" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "每页返回的评论数量，默认 50，最大 50。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页返回的评论数量，默认 50，最大 50" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "pageSize" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "pageSize" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "每页返回的评论数量，默认 50，最大 50。", "interface_type": "number", "property": "pageSize", "required": false, "type": "integer" }, "node": { "description": "目标文档的标识，支持传入 URL 或 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文档的标识，支持传入 URL 或 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文档的标识，支持传入 URL 或 ID。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文档的标识，支持传入 URL 或 ID (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文档的标识，支持传入 URL 或 ID。必填。", "property": "nodeId", "required": true, "type": "string" }, "resolve-status": { "description": "按解决状态过滤: resolved (已解决) / unresolved (未解决)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按解决状态过滤: resolved (已解决) / unresolved (未解决)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "按解决状态过滤。可选值：resolved（已解决）、unresolved（未解决）。不传返回所有评论。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按解决状态过滤: resolved (已解决) / unresolved (未解决)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "resolveStatus" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "resolveStatus" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "按解决状态过滤。可选值：resolved（已解决）、unresolved（未解决）。不传返回所有评论。", "property": "resolveStatus", "required": false, "type": "string" }, "type": { "description": "按评论类型过滤: global (全文评论) / inline (划词评论)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按评论类型过滤: global (全文评论) / inline (划词评论)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "按评论类型过滤。可选值：global（全文评论）、inline（划词评论）。不传返回所有评论。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按评论类型过滤: global (全文评论) / inline (划词评论)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "commentType" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "type" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "commentType" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "按评论类型过滤。可选值：global（全文评论）、inline（划词评论）。不传返回所有评论。", "property": "commentType", "required": false, "type": "string" } }, "path": "doc.list_comments", "primary_cli_path": "doc comment list", "product_id": "doc", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "查询文档评论列表", "use_when": [ "查看文档评论列表，可按全文/划词、已解决/未解决过滤时" ] }, "doc.list_document_blocks": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.list_document_blocks", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc block list", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.list_document_blocks", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.list_document_blocks", "live-mcp:dws schema doc.list_document_blocks", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-block.md", "skills/mono/references/products/doc/doc-comment.md", "skills/mono/references/products/doc/format/doc-jsonml-cookbook.md", "skills/mono/references/products/doc/style/doc-update-workflow.md", "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.list_document_blocks", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.list_document_blocks" ], "agent_summary": "查询文档一级块元素列表", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "只要全文 Markdown 用 doc read", "要改内容分别用 block insert/update/delete" ], "canonical_path": "doc.list_document_blocks", "cli_name": "list", "cli_path": "doc block list", "confirmation": "not_required", "description": "查询文档的一级块元素列表，支持按位置范围和块类型过滤。", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc block list --node \u003cDOC_ID\u003e --format json", "dws doc block list --node \u003cDOC_ID\u003e --start-index 0 --end-index 5 --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "查询文档一级块元素列表" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "查询文档一级块元素列表" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_document_blocks.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "只要全文 Markdown 用 doc read", "要改内容分别用 block insert/update/delete" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "只要全文 Markdown 用 doc read", "要改内容分别用 block insert/update/delete" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc block list", "value": "doc.list_document_blocks" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc block list", "value": "doc.list_document_blocks" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查询文档的一级块元素列表，支持按位置范围和块类型过滤。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "查询指定钉钉文档下的一级块元素列表，需要提供dentryUuid。支持按按起始位置、终止位置范围及块类型过滤。操作受文档权限控制，当调用者拥有编辑或查看或下载权限时生效。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查询文档的一级块元素列表，支持按位置范围和块类型过滤。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc block list --node \u003cDOC_ID\u003e --format json", "dws doc block list --node \u003cDOC_ID\u003e --start-index 0 --end-index 5 --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc block list --node \u003cDOC_ID\u003e --format json", "dws doc block list --node \u003cDOC_ID\u003e --start-index 0 --end-index 5 --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_document_blocks.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "list_document_blocks" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_document_blocks.interface_ref", "value": "doc.list_document_blocks" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "list_document_blocks" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查询块元素" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "查询指定钉钉文档下的一级块元素列表" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查询块元素" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "查看文档一级块结构、拿 blockId，供 insert/update/delete 或划词评论定位时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "查看文档一级块结构、拿 blockId，供 insert/update/delete 或划词评论定位时" ] } }, "group": "block", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "list_document_blocks" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_document_blocks", "parameter_count": 6, "parameters": { "block-id": { "description": "指定块 UUID（content-format=jsonml 时读取完整子树）", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "指定块 UUID（content-format=jsonml 时读取完整子树）" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "指定块 UUID（content-format=jsonml 时读取完整子树）" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "runtime extension sends blockId, which is absent from the pinned list_document_blocks metadata", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "blockId" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "runtime extension sends blockId, which is absent from the pinned list_document_blocks metadata", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "block-type": { "description": "按块类型过滤", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按块类型过滤" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "按块类型过滤。不传时返回所有类型。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按块类型过滤" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "blockType" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "blockType" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "按块类型过滤。不传时返回所有类型。", "property": "blockType", "required": false, "type": "string" }, "content-format": { "description": "输出格式: 默认为 element，可选 jsonml（返回 JSONML 节点数组）", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "输出格式: 默认为 element，可选 jsonml（返回 JSONML 节点数组）" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "数据的格式，可选为 element 或 jsonml，默认为 element" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "输出格式: 默认为 element，可选 jsonml（返回 JSONML 节点数组）" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "format" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "contentFormat" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "format" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "数据的格式，可选为 element 或 jsonml，默认为 element", "property": "format", "required": false, "type": "string" }, "end-index": { "description": "终止位置 (含)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "终止位置 (含)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "终止位置（≥ 0 的整数）。表示查询到根节点 children 的第 endIndex 个块为止（含）。不传时默认查询到末尾。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "终止位置 (含)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "endIndex" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "endIndex" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "终止位置（≥ 0 的整数）。表示查询到根节点 children 的第 endIndex 个块为止（含）。不传时默认查询到末尾。", "interface_type": "number", "property": "endIndex", "required": false, "type": "integer" }, "node": { "description": "文档 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文档的标识，支持两种格式：1) 文档链接 URL，如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}；2) 文档 ID（dentryUuid），32 位字母数字字符串。系统自动识别格式。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文档的标识，支持两种格式：1) 文档链接 URL，如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}；2) 文档 ID（dentryUuid），32 位字母数字字符串。系统自动识别格式。", "property": "nodeId", "required": true, "type": "string" }, "start-index": { "description": "起始位置 (从 0 开始)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "起始位置 (从 0 开始)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "起始位置（≥ 0 的整数）。表示从根节点 children 的第 startIndex 个块开始查询。不传时默认从头开始。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "起始位置 (从 0 开始)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "startIndex" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "startIndex" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "起始位置（≥ 0 的整数）。表示从根节点 children 的第 startIndex 个块开始查询。不传时默认从头开始。", "interface_type": "number", "property": "startIndex", "required": false, "type": "integer" } }, "path": "doc.list_document_blocks", "primary_cli_path": "doc block list", "product_id": "doc", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "查询块元素", "use_when": [ "查看文档一级块结构、拿 blockId，供 insert/update/delete 或划词评论定位时" ] }, "doc.list_nodes": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.list_nodes", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc list", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.list_nodes", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.list_nodes", "live-mcp:dws schema doc.list_nodes", "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.list_nodes", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.list_nodes" ], "agent_summary": "兼容入口：遍历文件夹或知识库的直接子节点；目录浏览能力已迁移到 drive/wiki。", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "日常浏览「我的文档」/钉盘用 dws drive list；知识库用 dws wiki node list" ], "canonical_path": "doc.list_nodes", "cli_name": "list", "cli_path": "doc list", "confirmation": "not_required", "description": "列出文件夹或知识库下的直接子节点 (文件夹/文档/文件等)。\n定位优先级: --folder \u003e --workspace \u003e 默认 (我的文档根目录)\n\n跨语义组别名: --node / --file-id 在 list 场景等价于 --folder\n (当 nodeId 实际指向文件夹节点时, 直觉式调用 --node \u003cFOLDER_NODE_ID\u003e 也可正常工作; 推荐用 --folder 表意更清晰)。", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc list --format json", "dws doc list --folder \u003cFOLDER_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：遍历文件夹或知识库的直接子节点；目录浏览能力已迁移到 drive/wiki。" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：遍历文件夹或知识库的直接子节点；目录浏览能力已迁移到 drive/wiki。" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_nodes.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "日常浏览「我的文档」/钉盘用 dws drive list；知识库用 dws wiki node list" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "日常浏览「我的文档」/钉盘用 dws drive list；知识库用 dws wiki node list" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc list", "value": "doc.list_nodes" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc list", "value": "doc.list_nodes" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "列出文件夹或知识库下的直接子节点 (文件夹/文档/文件等)。\n定位优先级: --folder \u003e --workspace \u003e 默认 (我的文档根目录)\n\n跨语义组别名: --node / --file-id 在 list 场景等价于 --folder\n (当 nodeId 实际指向文件夹节点时, 直觉式调用 --node \u003cFOLDER_NODE_ID\u003e 也可正常工作; 推荐用 --folder 表意更清晰)。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "列出指定文件夹或知识库下的直接子节点列表（文件夹/文档/文件等），支持分页。\r\n\r\n返回结果基于当前 MCP 会话用户的可访问权限进行过滤。\r\n返回的节点列表包含多种类型：在线文档、文件夹、PDF、docx、表格、脑图、白板等。\r\n\r\n定位方式（按优先级）：\r\n1. 传 folderId：列出该文件夹下的直接子节点\r\n2. 仅传 workspaceId（不传 folderId）：列出该知识库根目录下的直接子节点\r\n3. 都不传：列出用户\"我的文档\"根目录下的直接子节点\r\n\r\n返回的 nodeId 可直接用于其他工具（如 get_document_content、update_document、create_document 等）。\r\n若 nodeType=folder 且 hasChildren=true，可将该 nodeId 作为 folderId 再次调用本工具进行递归遍历。\r\n若 contentType=alidoc，可调用 get_document_content(nodeId=nodeId) 获取文档内容。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "列出文件夹或知识库下的直接子节点 (文件夹/文档/文件等)。\n定位优先级: --folder \u003e --workspace \u003e 默认 (我的文档根目录)\n\n跨语义组别名: --node / --file-id 在 list 场景等价于 --folder\n (当 nodeId 实际指向文件夹节点时, 直觉式调用 --node \u003cFOLDER_NODE_ID\u003e 也可正常工作; 推荐用 --folder 表意更清晰)。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc list --format json", "dws doc list --folder \u003cFOLDER_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc list --format json", "dws doc list --folder \u003cFOLDER_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_nodes.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "list_nodes" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_nodes.interface_ref", "value": "doc.list_nodes" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "list_nodes" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "遍历文件列表" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "列出指定文件夹或知识库下的直接子节点列表" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "遍历文件列表" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "兼容入口：遍历文件夹或知识库直接子节点时（已弃用，日常改用 drive list / wiki node list）" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "兼容入口：遍历文件夹或知识库直接子节点时（已弃用，日常改用 drive list / wiki node list）" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "list_nodes" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_nodes", "parameter_count": 4, "parameters": { "cursor": { "description": "分页游标 (从上次结果的 nextPageToken 获取)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标 (从上次结果的 nextPageToken 获取)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "分页游标，从上一次请求的返回结果中获取 nextPageToken。首次请求不传。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标 (从上次结果的 nextPageToken 获取)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "pageToken" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "pageToken" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "分页游标，从上一次请求的返回结果中获取 nextPageToken。首次请求不传。", "property": "pageToken", "required": false, "type": "string" }, "folder": { "description": "文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要遍历的文件夹的节点 ID（dentryUuid），支持传入文件夹链接 URL 或 ID。不传时：如果提供了 workspaceId 则列出该知识库根目录，否则列出用户'我的文档'根目录。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "folderId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "folder" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "folderId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要遍历的文件夹的节点 ID（dentryUuid），支持传入文件夹链接 URL 或 ID。不传时：如果提供了 workspaceId 则列出该知识库根目录，否则列出用户'我的文档'根目录。", "property": "folderId", "required": false, "type": "string" }, "limit": { "description": "每页数量 (默认 50，最大 50)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页数量 (默认 50，最大 50)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "每页返回的节点数量，默认 50，最大 50。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页数量 (默认 50，最大 50)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "pageSize" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "pageSize" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "每页返回的节点数量，默认 50，最大 50。", "interface_type": "number", "property": "pageSize", "required": false, "type": "integer" }, "workspace": { "description": "知识库 ID", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "知识库 ID" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "知识库 ID。当需要遍历某个知识库时使用。如果同时传了 folderId，则以 folderId 为准。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "知识库 ID" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "workspaceId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "workspaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "知识库 ID。当需要遍历某个知识库时使用。如果同时传了 folderId，则以 folderId 为准。", "property": "workspaceId", "required": false, "type": "string" } }, "path": "doc.list_nodes", "primary_cli_path": "doc list", "product_id": "doc", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "遍历文件列表", "use_when": [ "兼容入口：遍历文件夹或知识库直接子节点时（已弃用，日常改用 drive list / wiki node list）" ] }, "doc.list_permission": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.list_permission", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc permission list", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.list_permission", "live-mcp:dws schema doc.list_permission", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-permission.md", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.list_permission" ], "agent_summary": "兼容入口：查询文档空间节点的协作者权限；文件权限命令已迁移到 drive。", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "增删改权限用 add/update/remove；知识库成员用 wiki member list" ], "canonical_path": "doc.list_permission", "cli_name": "list", "cli_path": "doc permission list", "confirmation": "not_required", "description": "查询指定节点的协作者列表，返回每位成员的 userId、姓名、角色等信息。\n\n注意：底层不支持游标分页，--limit 仅控制单次返回的最大条数（最大 200）。\n若结果被截断（出参 truncated=true），可通过 --filter-role 收窄查询范围。", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc permission list --node \u003cDOC_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：查询文档空间节点的协作者权限；文件权限命令已迁移到 drive。" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：查询文档空间节点的协作者权限；文件权限命令已迁移到 drive。" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_permission.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "增删改权限用 add/update/remove；知识库成员用 wiki member list" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "增删改权限用 add/update/remove；知识库成员用 wiki member list" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc permission list", "value": "doc.list_permission" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc permission list", "value": "doc.list_permission" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查询指定节点的协作者列表，返回每位成员的 userId、姓名、角色等信息。\n\n注意：底层不支持游标分页，--limit 仅控制单次返回的最大条数（最大 200）。\n若结果被截断（出参 truncated=true），可通过 --filter-role 收窄查询范围。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "查询知识库节点当前的成员权限列表。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查询指定节点的协作者列表，返回每位成员的 userId、姓名、角色等信息。\n\n注意：底层不支持游标分页，--limit 仅控制单次返回的最大条数（最大 200）。\n若结果被截断（出参 truncated=true），可通过 --filter-role 收窄查询范围。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc permission list --node \u003cDOC_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc permission list --node \u003cDOC_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_permission.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_permission.interface_ref", "value": { "product_id": "doc", "rpc_name": "list_permission" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.doc.list_permission.interface_ref", "value": { "product_id": "doc", "rpc_name": "list_permission" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查询文档协作者列表" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "查询节点成员列表" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查询文档协作者列表" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "列出文档节点成员权限时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "列出文档节点成员权限时" ] } }, "group": "permission", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "list_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "list_permission", "parameter_count": 4, "parameters": { "filter-role": { "description": "按角色过滤（逗号分隔）：OWNER / MANAGER / EDITOR / DOWNLOADER / READER", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按角色过滤（逗号分隔）：OWNER / MANAGER / EDITOR / DOWNLOADER / READER" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "按角色过滤成员列表，选填。取值：OWNER、MANAGER、EDITOR、DOWNLOADER、READER。不传时返回所有角色的成员。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按角色过滤（逗号分隔）：OWNER / MANAGER / EDITOR / DOWNLOADER / READER" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "filterRoleIds" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "filterRole" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "filterRoleIds" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "按角色过滤成员列表，选填。取值：OWNER、MANAGER、EDITOR、DOWNLOADER、READER。不传时返回所有角色的成员。", "interface_type": "array", "property": "filterRoleIds", "required": false, "type": "string" }, "limit": { "default": "30", "description": "返回成员数上限，默认 30，最大 200", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "返回成员数上限，默认 30，最大 200" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "期望返回的最大成员条数，默认 30，最大 200。底层一次性返回全量成员后在内存中按本字段截断；本接口不支持游标翻页，不存在 nextToken。若发生截断（出参 truncated=true），可通过出参 totalCount 感知全量成员数，并通过 filterRoleIds 收窄查询范围。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "返回成员数上限，默认 30，最大 200" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "maxResults" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "maxResults" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "期望返回的最大成员条数，默认 30，最大 200。底层一次性返回全量成员后在内存中按本字段截断；本接口不支持游标翻页，不存在 nextToken。若发生截断（出参 truncated=true），可通过出参 totalCount 感知全量成员数，并通过 filterRoleIds 收窄查询范围。", "interface_type": "number", "property": "maxResults", "required": false, "type": "integer" }, "node": { "description": "目标节点的标识（文档/文件夹/文件），支持传入 URL 或 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标节点的标识（文档/文件夹/文件），支持传入 URL 或 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标节点的 nodeId。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标节点的标识（文档/文件夹/文件），支持传入 URL 或 ID (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标节点的 nodeId。", "property": "nodeId", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID 或 URL（选填，仅用于辅助构造返回的 docUrl）", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标知识库 ID 或 URL（选填，仅用于辅助构造返回的 docUrl）" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标知识库的标识，选填。仅用于辅助构造返回的 docUrl，业务实际依赖 nodeId 定位节点；支持两种格式：1) 知识库 ID（纯字符串）；2) 知识库 URL，如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview，系统自动提取其中的 workspaceId。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标知识库 ID 或 URL（选填，仅用于辅助构造返回的 docUrl）" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "workspaceId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "workspaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标知识库的标识，选填。仅用于辅助构造返回的 docUrl，业务实际依赖 nodeId 定位节点；支持两种格式：1) 知识库 ID（纯字符串）；2) 知识库 URL，如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview，系统自动提取其中的 workspaceId。", "property": "workspaceId", "required": false, "type": "string" } }, "path": "doc.list_permission", "primary_cli_path": "doc permission list", "product_id": "doc", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "查询文档协作者列表", "use_when": [ "列出文档节点成员权限时" ] }, "doc.media_insert": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.media_insert", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc media insert", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "live-mcp:none (Cobra+Skill; composite/unpinned)", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-media.md", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.media_insert" ], "agent_summary": "上传本地文件并作为附件插入文档", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "上传为独立文件用 drive/doc upload，不要与正文附件混淆", "下载正文附件用 media download" ], "canonical_path": "doc.media_insert", "cli_name": "insert", "cli_path": "doc media insert", "confirmation": "not_required", "description": "将本地文件作为附件上传并插入到钉钉文档中（三步自动完成）。\n\n流程:\n 1. 获取附件上传凭证 (get_doc_attachment_upload_info)\n 2. HTTP PUT 上传文件到 OSS\n 3. 插入附件块到文档 (insert_document_block)\n\n--mime-type 可选，不指定时根据文件扩展名自动推断。", "display": "钉钉文档管理", "dry_run": { "preview_kind": "plan" }, "effect": "write", "effect_source": "agent-hint", "examples": [ "dws doc media insert --node \u003cDOC_ID\u003e --file ./report.pdf --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "上传本地文件并作为附件插入文档" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "上传本地文件并作为附件插入文档" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "上传为独立文件用 drive/doc upload，不要与正文附件混淆", "下载正文附件用 media download" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "上传为独立文件用 drive/doc upload，不要与正文附件混淆", "下载正文附件用 media download" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc media insert", "value": "doc.media_insert" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc media insert", "value": "doc.media_insert" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "将本地文件作为附件上传并插入到钉钉文档中（三步自动完成）。\n\n流程:\n 1. 获取附件上传凭证 (get_doc_attachment_upload_info)\n 2. HTTP PUT 上传文件到 OSS\n 3. 插入附件块到文档 (insert_document_block)\n\n--mime-type 可选，不指定时根据文件扩展名自动推断。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "将本地文件作为附件上传并插入到钉钉文档中（三步自动完成）。\n\n流程:\n 1. 获取附件上传凭证 (get_doc_attachment_upload_info)\n 2. HTTP PUT 上传文件到 OSS\n 3. 插入附件块到文档 (insert_document_block)\n\n--mime-type 可选，不指定时根据文件扩展名自动推断。" }, "dry_run": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "reviewed positive dry-run capability", "selected": true, "source": "reviewed_dry_run_registry", "source_ref": "internal/cli/schema_dry_run_capabilities.go", "value": { "preview_kind": "plan" } } ], "precedence": "reviewed_explicit", "resolution": "exact_canonical_lookup", "review_reason": "reviewed positive dry-run capability", "source": "reviewed_dry_run_registry", "source_ref": "internal/cli/schema_dry_run_capabilities.go", "value": { "preview_kind": "plan" } }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" }, { "precedence": "inference_or_default", "selected": false, "source": "command-verb", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc media insert --node \u003cDOC_ID\u003e --file ./report.pdf --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc media insert --node \u003cDOC_ID\u003e --file ./report.pdf --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref" }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/doc.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "上传附件并插入文档" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "上传附件并插入文档" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "把本地文件/图片作为附件块插入文档正文（自动 prepare+PUT+insert）时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "把本地文件/图片作为附件块插入文档正文（自动 prepare+PUT+insert）时" ] } }, "group": "media", "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref", "is_alias": false, "name": "media_insert", "parameter_count": 7, "parameters": { "file": { "description": "本地文件路径 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "本地文件路径 (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "本地文件路径 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "file" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "file" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "file", "required": true, "type": "string" }, "index": { "description": "插入位置索引", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "插入位置索引" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "插入位置索引" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "index" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "index" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "property": "index", "required": false, "type": "integer" }, "mime-type": { "description": "文件 MIME 类型 (默认根据扩展名推断)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件 MIME 类型 (默认根据扩展名推断)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件 MIME 类型 (默认根据扩展名推断)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "mimeType" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "mimeType" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "mimeType", "required": false, "type": "string" }, "name": { "description": "附件显示名称 (默认使用文件名)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "附件显示名称 (默认使用文件名)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "附件显示名称 (默认使用文件名)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "name" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "name" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "name", "required": false, "type": "string" }, "node": { "description": "目标文档的标识，支持传入 URL 或 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文档的标识，支持传入 URL 或 ID (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文档的标识，支持传入 URL 或 ID (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "node" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "node" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "node", "required": true, "type": "string" }, "ref-block": { "description": "参考块 ID (配合 --where)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "参考块 ID (配合 --where)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "参考块 ID (配合 --where)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "refBlock" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "refBlock" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "refBlock", "required": false, "type": "string" }, "where": { "description": "相对位置: before / after (配合 --ref-block)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "相对位置: before / after (配合 --ref-block)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "相对位置: before / after (配合 --ref-block)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "where" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "where" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "where", "required": false, "type": "string" } }, "path": "doc.media_insert", "primary_cli_path": "doc media insert", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "上传附件并插入文档", "use_when": [ "把本地文件/图片作为附件块插入文档正文（自动 prepare+PUT+insert）时" ] }, "doc.move_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.move_document", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc move", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.move_document", "live-mcp:dws schema doc.move_document", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-file-ops.md", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.move_document" ], "agent_summary": "兼容入口：移动文档或文件；文件移动能力已迁移到 drive。", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "要保留副本改用 doc/drive copy", "目标未确认时不要 move" ], "canonical_path": "doc.move_document", "cli_name": "move", "cli_path": "doc move", "confirmation": "not_required", "description": "将文档或文件移动到指定文件夹或知识库。移动后原位置的文档将不再存在。\n--folder 指定目标文档文件夹 nodeId 或 alidocs 文件夹 URL，--workspace 指定目标知识库 ID。\n不要把 drive/chat 链路返回的纯数字 dentryId/parent-id 传给 --folder。\n不传 --folder 时移动到 --workspace 知识库根目录；都不传则默认到\"我的文档\"。\n\n权限要求: 对源文档有\"管理\"权限，且对目标文件夹有\"编辑\"权限。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc move --node \u003cDOC_ID\u003e --folder \u003cTARGET_FOLDER_ID\u003e --format json", "dws doc move --node \u003cDOC_ID\u003e --workspace \u003cTARGET_WS_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：移动文档或文件；文件移动能力已迁移到 drive。" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：移动文档或文件；文件移动能力已迁移到 drive。" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.move_document.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "要保留副本改用 doc/drive copy", "目标未确认时不要 move" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "要保留副本改用 doc/drive copy", "目标未确认时不要 move" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc move", "value": "doc.move_document" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc move", "value": "doc.move_document" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "将文档或文件移动到指定文件夹或知识库。移动后原位置的文档将不再存在。\n--folder 指定目标文档文件夹 nodeId 或 alidocs 文件夹 URL，--workspace 指定目标知识库 ID。\n不要把 drive/chat 链路返回的纯数字 dentryId/parent-id 传给 --folder。\n不传 --folder 时移动到 --workspace 知识库根目录；都不传则默认到\"我的文档\"。\n\n权限要求: 对源文档有\"管理\"权限，且对目标文件夹有\"编辑\"权限。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "将指定节点移动到目标文件夹。\r\n\r\n支持的节点类型：知识库节点（文档、文件夹）、钉盘文件/文件夹。\r\nnodeId 支持文档 URL 或 dentryUuid（32 位字母数字字符串）。\r\ntargetFolderId 为目标文件夹的 dentryUuid；workspaceId 为目标知识库标识，不传 targetFolderId 时移动到该知识库根目录，如果不传 targetFolderId 和 workspaceId，默认到当前用户所在组织的「我的文档」下\r\n\r\n权限要求：\r\n- 对源节点有编辑权限\r\n- 对目标文件夹有写入权限\r\n\r\n注意：移动操作底层可能异步执行，异步时操作已提交但无法立即确认完成，请稍后查看目标文件夹确认结果。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "将文档或文件移动到指定文件夹或知识库。移动后原位置的文档将不再存在。\n--folder 指定目标文档文件夹 nodeId 或 alidocs 文件夹 URL，--workspace 指定目标知识库 ID。\n不要把 drive/chat 链路返回的纯数字 dentryId/parent-id 传给 --folder。\n不传 --folder 时移动到 --workspace 知识库根目录；都不传则默认到\"我的文档\"。\n\n权限要求: 对源文档有\"管理\"权限，且对目标文件夹有\"编辑\"权限。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc move --node \u003cDOC_ID\u003e --folder \u003cTARGET_FOLDER_ID\u003e --format json", "dws doc move --node \u003cDOC_ID\u003e --workspace \u003cTARGET_WS_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc move --node \u003cDOC_ID\u003e --folder \u003cTARGET_FOLDER_ID\u003e --format json", "dws doc move --node \u003cDOC_ID\u003e --workspace \u003cTARGET_WS_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.move_document.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.move_document.interface_ref", "value": { "product_id": "doc", "rpc_name": "move_document" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.doc.move_document.interface_ref", "value": { "product_id": "doc", "rpc_name": "move_document" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "移动文档/文件到指定位置" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "移动节点" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "移动文档/文件到指定位置" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户要移动文档/文件且原位置不再保留时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户要移动文档/文件且原位置不再保留时" ] } }, "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "move_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "move_document", "parameter_count": 3, "parameters": { "folder": { "description": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文件夹的 dentryUuid（32 位字母数字字符串），节点将被移动到此文件夹下。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "targetFolderId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "folder" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "targetFolderId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文件夹的 dentryUuid（32 位字母数字字符串），节点将被移动到此文件夹下。", "property": "targetFolderId", "required": false, "type": "string" }, "node": { "description": "文档/文件 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档/文件 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要移动的节点标识，支持以下格式：\\n1. 文档/文件夹 URL，如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}\\n2. dentryUuid（32 位字母数字字符串）" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档/文件 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要移动的节点标识，支持以下格式：\\n1. 文档/文件夹 URL，如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}\\n2. dentryUuid（32 位字母数字字符串）", "property": "nodeId", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID 或 URL (不传 --folder 时移动到该知识库根目录)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标知识库 ID 或 URL (不传 --folder 时移动到该知识库根目录)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标知识库的标识，支持两种格式：1) 知识库 ID（纯字符串）；2) 知识库 URL，如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview，系统自动提取其中的 workspaceId。当 targetFolderId 不传时，移动到该知识库的根目录下。如果同时传了 targetFolderId，则以 targetFolderId 为准。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标知识库 ID 或 URL (不传 --folder 时移动到该知识库根目录)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "workspaceId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "workspaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标知识库的标识，支持两种格式：1) 知识库 ID（纯字符串）；2) 知识库 URL，如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview，系统自动提取其中的 workspaceId。当 targetFolderId 不传时，移动到该知识库的根目录下。如果同时传了 targetFolderId，则以 targetFolderId 为准。", "property": "workspaceId", "required": false, "type": "string" } }, "path": "doc.move_document", "primary_cli_path": "doc move", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "移动文档/文件到指定位置", "use_when": [ "用户要移动文档/文件且原位置不再保留时" ] }, "doc.query_export_job": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.query_export_job", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc export get", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.query_export_job", "live-mcp:dws schema doc.query_export_job", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-export.md", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.query_export_job" ], "agent_summary": "查询文档导出任务结果", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "常规导出请直接 dws doc export（一体化提交+轮询+下载），不要先查 job" ], "canonical_path": "doc.query_export_job", "cli_name": "get", "cli_path": "doc export get", "confirmation": "not_required", "description": "根据 jobId 查询文档导出任务的执行结果。\n通常不需要手动调用，dws doc export 会自动完成轮询。\n仅在导出命令超时或中断后，用于手动查询任务状态。\n\n任务状态：\n PROCESSING 处理中\n SUCCESS 导出成功，返回 downloadUrl\n FAILED 导出失败", "display": "钉钉文档管理", "dry_run": { "preview_kind": "plan" }, "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc export get --job-id \u003cJOB_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "查询文档导出任务结果" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "查询文档导出任务结果" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.query_export_job.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "常规导出请直接 dws doc export（一体化提交+轮询+下载），不要先查 job" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "常规导出请直接 dws doc export（一体化提交+轮询+下载），不要先查 job" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc export get", "value": "doc.query_export_job" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc export get", "value": "doc.query_export_job" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "根据 jobId 查询文档导出任务的执行结果。\n通常不需要手动调用，dws doc export 会自动完成轮询。\n仅在导出命令超时或中断后，用于手动查询任务状态。\n\n任务状态：\n PROCESSING 处理中\n SUCCESS 导出成功，返回 downloadUrl\n FAILED 导出失败" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "用于查询通过 submit_export_job 提交的文字文档导出任务的执行状态，任务完成时返回文件下载链接。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "根据 jobId 查询文档导出任务的执行结果。\n通常不需要手动调用，dws doc export 会自动完成轮询。\n仅在导出命令超时或中断后，用于手动查询任务状态。\n\n任务状态：\n PROCESSING 处理中\n SUCCESS 导出成功，返回 downloadUrl\n FAILED 导出失败" }, "dry_run": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "reviewed positive dry-run capability", "selected": true, "source": "reviewed_dry_run_registry", "source_ref": "internal/cli/schema_dry_run_capabilities.go", "value": { "preview_kind": "plan" } } ], "precedence": "reviewed_explicit", "resolution": "exact_canonical_lookup", "review_reason": "reviewed positive dry-run capability", "source": "reviewed_dry_run_registry", "source_ref": "internal/cli/schema_dry_run_capabilities.go", "value": { "preview_kind": "plan" } }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc export get --job-id \u003cJOB_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc export get --job-id \u003cJOB_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.query_export_job.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.query_export_job.interface_ref", "value": { "product_id": "doc", "rpc_name": "query_export_job" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.doc.query_export_job.interface_ref", "value": { "product_id": "doc", "rpc_name": "query_export_job" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查询导出任务结果（手动兜底）" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "查询文档导出任务状态" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查询导出任务结果（手动兜底）" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "doc export 超时/中断后，用 jobId 查询导出任务状态与下载链接时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "doc export 超时/中断后，用 jobId 查询导出任务状态与下载链接时" ] } }, "group": "export", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "query_export_job" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "query_export_job", "parameter_count": 1, "parameters": { "job-id": { "description": "导出任务 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "导出任务 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "由 submit_export_job 返回的导出任务 ID。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "导出任务 ID (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "jobId" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "jobId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "由 submit_export_job 返回的导出任务 ID。必填。", "property": "jobId", "required": true, "type": "string" } }, "path": "doc.query_export_job", "primary_cli_path": "doc export get", "product_id": "doc", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "查询导出任务结果（手动兜底）", "use_when": [ "doc export 超时/中断后，用 jobId 查询导出任务状态与下载链接时" ] }, "doc.remove_permission": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.remove_permission", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc permission remove", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.remove_permission", "live-mcp:dws schema doc.remove_permission", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.remove_permission" ], "agent_summary": "兼容入口：移除文档空间节点的协作成员权限；文件权限命令已迁移到 drive。", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "改角色用 update；知识库撤成员用 wiki member remove" ], "canonical_path": "doc.remove_permission", "cli_name": "remove", "cli_path": "doc permission remove", "confirmation": "not_required", "description": "从指定节点移除一个或多个协作成员的权限（仅支持 USER 类型）。\n\n移除后相关用户将无法通过该节点的直接授权访问内容（若有父节点继承权限则仍可通过继承权限访问）。\n\n注意：\n- OWNER 角色不可通过此接口移除。\n- 操作者需在该节点具备 EDITOR 及以上角色（OWNER / MANAGER / EDITOR）。\n- 单次请求最多 30 个成员，超出请分批调用。\n\n用户 uid 可通过「钉钉通讯录」相关命令检索，如:\n dws contact user search --keyword \"姓名\"", "display": "钉钉文档管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws doc permission remove --node \u003cDOC_ID\u003e --users uid1 --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：移除文档空间节点的协作成员权限；文件权限命令已迁移到 drive。" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：移除文档空间节点的协作成员权限；文件权限命令已迁移到 drive。" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.remove_permission.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "改角色用 update；知识库撤成员用 wiki member remove" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "改角色用 update；知识库撤成员用 wiki member remove" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc permission remove", "value": "doc.remove_permission" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc permission remove", "value": "doc.remove_permission" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "从指定节点移除一个或多个协作成员的权限（仅支持 USER 类型）。\n\n移除后相关用户将无法通过该节点的直接授权访问内容（若有父节点继承权限则仍可通过继承权限访问）。\n\n注意：\n- OWNER 角色不可通过此接口移除。\n- 操作者需在该节点具备 EDITOR 及以上角色（OWNER / MANAGER / EDITOR）。\n- 单次请求最多 30 个成员，超出请分批调用。\n\n用户 uid 可通过「钉钉通讯录」相关命令检索，如:\n dws contact user search --keyword \"姓名\"" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "从知识库节点移除指定企业用户的权限（仅支持 USER 类型）。\r\n\r\n通过传入 userIds 列表批量移除成员在节点上的权限，移除后相关用户将无法通过该节点的直接授权访问内容（若有父节点继承权限则仍可通过继承权限访问）。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口移除。\r\n- **权限要求（业务规则）**：操作者必须在该节点上具备「可编辑（EDITOR）」及以上角色（OWNER / MANAGER / EDITOR）。DOWNLOADER / READER / 非成员调用会返回 `forbidden.accessDenied`，错误信息会明确提示所需的最低角色。\r\n- 单次请求 `userIds` 列表最多传 30 个，超出需分批调用。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "从指定节点移除一个或多个协作成员的权限（仅支持 USER 类型）。\n\n移除后相关用户将无法通过该节点的直接授权访问内容（若有父节点继承权限则仍可通过继承权限访问）。\n\n注意：\n- OWNER 角色不可通过此接口移除。\n- 操作者需在该节点具备 EDITOR 及以上角色（OWNER / MANAGER / EDITOR）。\n- 单次请求最多 30 个成员，超出请分批调用。\n\n用户 uid 可通过「钉钉通讯录」相关命令检索，如:\n dws contact user search --keyword \"姓名\"" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc permission remove --node \u003cDOC_ID\u003e --users uid1 --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc permission remove --node \u003cDOC_ID\u003e --users uid1 --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.remove_permission.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.remove_permission.interface_ref", "value": { "product_id": "doc", "rpc_name": "remove_permission" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.doc.remove_permission.interface_ref", "value": { "product_id": "doc", "rpc_name": "remove_permission" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "移除文档协作者权限" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "移除节点成员权限" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "移除文档协作者权限" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "移除文档节点上指定用户权限时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "移除文档节点上指定用户权限时" ] } }, "group": "permission", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "remove_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "remove_permission", "parameter_count": 3, "parameters": { "node": { "description": "目标节点的标识（文档/文件夹/文件），支持传入 URL 或 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标节点的标识（文档/文件夹/文件），支持传入 URL 或 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标节点的 nodeId（文档、文件夹或文件），可通过 list_nodes 工具获取。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标节点的标识（文档/文件夹/文件），支持传入 URL 或 ID (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标节点的 nodeId（文档、文件夹或文件），可通过 list_nodes 工具获取。", "property": "nodeId", "required": true, "type": "string" }, "users": { "description": "被移除权限的用户 userId 列表，逗号分隔 (必填，单次最多 30 个)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "被移除权限的用户 userId 列表，逗号分隔 (必填，单次最多 30 个)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要移除权限的用户 userId 列表（钉钉 staffId / 外部 userId 格式），至少包含一个 userId，单次最多 30 个。当前 Agent 写操作仅支持移除企业用户权限，故入参直接以扁平的 userId 列表呈现。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "被移除权限的用户 userId 列表，逗号分隔 (必填，单次最多 30 个)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "userIds" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "users" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "userIds" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要移除权限的用户 userId 列表（钉钉 staffId / 外部 userId 格式），至少包含一个 userId，单次最多 30 个。当前 Agent 写操作仅支持移除企业用户权限，故入参直接以扁平的 userId 列表呈现。", "interface_type": "array", "property": "userIds", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID 或 URL（选填，仅用于辅助构造返回的 docUrl）", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标知识库 ID 或 URL（选填，仅用于辅助构造返回的 docUrl）" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标知识库的标识，选填。仅用于辅助构造返回的 docUrl，业务实际依赖 nodeId 定位节点；支持两种格式：1) 知识库 ID（纯字符串）；2) 知识库 URL，如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview，系统自动提取其中的 workspaceId。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标知识库 ID 或 URL（选填，仅用于辅助构造返回的 docUrl）" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "workspaceId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "workspaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标知识库的标识，选填。仅用于辅助构造返回的 docUrl，业务实际依赖 nodeId 定位节点；支持两种格式：1) 知识库 ID（纯字符串）；2) 知识库 URL，如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview，系统自动提取其中的 workspaceId。", "property": "workspaceId", "required": false, "type": "string" } }, "path": "doc.remove_permission", "primary_cli_path": "doc permission remove", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "移除文档协作者权限", "use_when": [ "移除文档节点上指定用户权限时" ] }, "doc.rename_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.rename_document", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc rename", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.rename_document", "live-mcp:dws schema doc.rename_document", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-file-ops.md", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.rename_document" ], "agent_summary": "兼容入口：重命名文档或文件；文件重命名能力已迁移到 drive。", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "改正文标题/章节标题改用 doc block update", "不要用 update 或重新 create 来改名" ], "canonical_path": "doc.rename_document", "cli_name": "rename", "cli_path": "doc rename", "confirmation": "not_required", "description": "修改文档或文件的名称。用户说重命名、rename、改名、修改文档名称/标题时走 doc rename。\n不要用 doc update 修改列表/链接展示名称，也不要重新 create。\n\n权限要求: 对文档有\"编辑\"权限。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc rename --node \u003cDOC_ID\u003e --name \"新名称\" --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：重命名文档或文件；文件重命名能力已迁移到 drive。" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：重命名文档或文件；文件重命名能力已迁移到 drive。" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.rename_document.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "改正文标题/章节标题改用 doc block update", "不要用 update 或重新 create 来改名" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "改正文标题/章节标题改用 doc block update", "不要用 update 或重新 create 来改名" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc rename", "value": "doc.rename_document" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc rename", "value": "doc.rename_document" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "修改文档或文件的名称。用户说重命名、rename、改名、修改文档名称/标题时走 doc rename。\n不要用 doc update 修改列表/链接展示名称，也不要重新 create。\n\n权限要求: 对文档有\"编辑\"权限。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "对指定节点进行重命名。\r\n\r\n支持范围：\r\n- 知识库（workspace）下的文档节点、文件夹节点\r\n\r\n权限要求：\r\n- 对目标节点有编辑权限" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "修改文档或文件的名称。用户说重命名、rename、改名、修改文档名称/标题时走 doc rename。\n不要用 doc update 修改列表/链接展示名称，也不要重新 create。\n\n权限要求: 对文档有\"编辑\"权限。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc rename --node \u003cDOC_ID\u003e --name \"新名称\" --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc rename --node \u003cDOC_ID\u003e --name \"新名称\" --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.rename_document.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.rename_document.interface_ref", "value": { "product_id": "doc", "rpc_name": "rename_document" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.doc.rename_document.interface_ref", "value": { "product_id": "doc", "rpc_name": "rename_document" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "重命名文档/文件" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "对指定节点进行重命名" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "重命名文档/文件" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户要改文档/文件在列表与链接中展示的名称时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户要改文档/文件在列表与链接中展示的名称时" ] } }, "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "rename_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "rename_document", "parameter_count": 2, "parameters": { "name": { "description": "新名称 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "新名称 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "重命名后的新名称，不能为空，长度不超过 255 个字符。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "新名称 (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "newName" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "name" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "newName" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "重命名后的新名称，不能为空，长度不超过 255 个字符。", "property": "newName", "required": true, "type": "string" }, "node": { "description": "文档/文件 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档/文件 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要重命名的节点标识，支持以下格式：1) 文档/文件夹 URL，如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}；2) dentryUuid（32 位字母数字字符串）。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档/文件 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要重命名的节点标识，支持以下格式：1) 文档/文件夹 URL，如 https://alidocs.dingtalk.com/i/nodes/{dentryUuid}；2) dentryUuid（32 位字母数字字符串）。", "property": "nodeId", "required": true, "type": "string" } }, "path": "doc.rename_document", "primary_cli_path": "doc rename", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "重命名文档/文件", "use_when": [ "用户要改文档/文件在列表与链接中展示的名称时" ] }, "doc.reply_comment": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.reply_comment", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc comment reply", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.reply_comment", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.reply_comment", "live-mcp:dws schema doc-comment.reply_comment", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-comment.md", "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.reply_comment", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.reply_comment" ], "agent_summary": "回复文档评论", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "新建评论用 create/create-inline；删评论用 delete" ], "canonical_path": "doc.reply_comment", "cli_name": "reply", "cli_path": "doc comment reply", "confirmation": "not_required", "description": "回复指定文档中的一条评论。\n\n--comment-key 为被回复评论的唯一标识（即 list 返回的 commentKey），格式：{13位毫秒时间戳}{32位UUID}，共45位。\ncommentKey可从 dws doc comment create 或 dws doc comment list 返回结果中获取。\n\n可通过 --mention 指定被 @ 的用户 uid 列表（逗号分隔），\n评论内容中会插入 @mention 节点并发送通知。\n用户 uid 可通过「钉钉通讯录」相关命令检索，如:\n dws contact user search --keyword \"姓名\"\n\n设置 --emoji 时，本次回复将作为表情贴图回复，--content 填写表情名称。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc comment reply --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"同意\" --format json", "dws doc comment reply --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"比心\" --emoji --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "回复文档评论" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "回复文档评论" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.reply_comment.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "新建评论用 create/create-inline；删评论用 delete" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "新建评论用 create/create-inline；删评论用 delete" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc comment reply", "value": "doc.reply_comment" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc comment reply", "value": "doc.reply_comment" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "回复指定文档中的一条评论。\n\n--comment-key 为被回复评论的唯一标识（即 list 返回的 commentKey），格式：{13位毫秒时间戳}{32位UUID}，共45位。\ncommentKey可从 dws doc comment create 或 dws doc comment list 返回结果中获取。\n\n可通过 --mention 指定被 @ 的用户 uid 列表（逗号分隔），\n评论内容中会插入 @mention 节点并发送通知。\n用户 uid 可通过「钉钉通讯录」相关命令检索，如:\n dws contact user search --keyword \"姓名\"\n\n设置 --emoji 时，本次回复将作为表情贴图回复，--content 填写表情名称。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "回复钉钉文档中的已有评论，支持普通文字回复和表情贴图回复，支持 @提及用户。\r\n\r\n通过 nodeId 定位文档，通过 replyCommentKey 指定被回复的评论（可从 create_comment 或 list_comments 的返回结果中获取）。\r\n- 普通回复：填写 content，不填 emoji。\r\n- 表情贴图回复：填写 content（表情名称），同时将 emoji 设为 true。表情回复的 categoryFeature 会自动从被回复评论继承。\r\n- @提及用户：填写 mentionedUserIds，被提及用户会收到通知。\r\n操作受权限控制，仅当调用者对文档有评论权限时可回复评论。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "回复指定文档中的一条评论。\n\n--comment-key 为被回复评论的唯一标识（即 list 返回的 commentKey），格式：{13位毫秒时间戳}{32位UUID}，共45位。\ncommentKey可从 dws doc comment create 或 dws doc comment list 返回结果中获取。\n\n可通过 --mention 指定被 @ 的用户 uid 列表（逗号分隔），\n评论内容中会插入 @mention 节点并发送通知。\n用户 uid 可通过「钉钉通讯录」相关命令检索，如:\n dws contact user search --keyword \"姓名\"\n\n设置 --emoji 时，本次回复将作为表情贴图回复，--content 填写表情名称。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc comment reply --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"同意\" --format json", "dws doc comment reply --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"比心\" --emoji --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc comment reply --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"同意\" --format json", "dws doc comment reply --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"比心\" --emoji --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.reply_comment.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": { "product_id": "doc-comment", "rpc_name": "reply_comment" } }, { "precedence": "imported", "selected": false, "source": "internal/cli/schema_hints/imported/wukong.json", "value": "doc.reply_comment" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.reply_comment.interface_ref", "value": "doc-comment.reply_comment" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": { "product_id": "doc-comment", "rpc_name": "reply_comment" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "回复评论" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "回复评论" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "回复评论" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "回复已有评论（文字或 --emoji 表情）；commentKey 来自 list/create" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "回复已有评论（文字或 --emoji 表情）；commentKey 来自 list/create" ] } }, "group": "comment", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc-comment", "rpc_name": "reply_comment" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "reply_comment", "parameter_count": 5, "parameters": { "comment-key": { "description": "被回复评论的 commentKey，格式: {13位毫秒时间戳}{32位UUID}，可从 list/create 结果获取 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "被回复评论的 commentKey，格式: {13位毫秒时间戳}{32位UUID}，可从 list/create 结果获取 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "被回复评论的唯一标识，格式：{13位毫秒时间戳}{32位UUID}，共45位。可从 create_comment 或 list_comments 返回结果中获取。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "被回复评论的 commentKey，格式: {13位毫秒时间戳}{32位UUID}，可从 list/create 结果获取 (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "replyCommentKey" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "commentKey" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "replyCommentKey" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "被回复评论的唯一标识，格式：{13位毫秒时间戳}{32位UUID}，共45位。可从 create_comment 或 list_comments 返回结果中获取。必填。", "property": "replyCommentKey", "required": true, "type": "string" }, "content": { "description": "回复的文字内容，表情回复时填写表情名称 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "回复的文字内容，表情回复时填写表情名称 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "回复的文字内容，纯文本格式。表情回复时填写表情名称。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "回复的文字内容，表情回复时填写表情名称 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "content" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "content" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "回复的文字内容，纯文本格式。表情回复时填写表情名称。必填。", "property": "content", "required": true, "type": "string" }, "emoji": { "description": "设为 true 时作为表情贴图回复 (默认 false)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "设为 true 时作为表情贴图回复 (默认 false)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "设为 true 时，本次回复将作为表情贴图回复，categoryFeature 会自动从被回复评论继承。默认 false。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "设为 true 时作为表情贴图回复 (默认 false)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "emoji" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "emoji" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "boolean" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "boolean" } }, "interface_description": "设为 true 时，本次回复将作为表情贴图回复，categoryFeature 会自动从被回复评论继承。默认 false。", "property": "emoji", "required": false, "type": "boolean" }, "mention": { "description": "被 @ 的用户 uid 列表，逗号分隔", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "被 @ 的用户 uid 列表，逗号分隔" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "填写后，评论内容中会插入 @mention 节点，并向对应用户发送通知。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "被 @ 的用户 uid 列表，逗号分隔" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "mentionedUserIds" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "mention" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "mentionedUserIds" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "填写后，评论内容中会插入 @mention 节点，并向对应用户发送通知。", "interface_type": "array", "property": "mentionedUserIds", "required": false, "type": "string" }, "node": { "description": "目标文档的标识，支持传入 URL 或 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文档的标识，支持传入 URL 或 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文档的标识，支持传入 URL 或 ID（dentryUuid）。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文档的标识，支持传入 URL 或 ID (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文档的标识，支持传入 URL 或 ID（dentryUuid）。必填。", "property": "nodeId", "required": true, "type": "string" } }, "path": "doc.reply_comment", "primary_cli_path": "doc comment reply", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "回复评论", "use_when": [ "回复已有评论（文字或 --emoji 表情）；commentKey 来自 list/create" ] }, "doc.search_documents": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.search_documents", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc search", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.search_documents", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.search_documents", "live-mcp:dws schema doc.search_documents", "skills/mono/references/intent-guide.md", "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.search_documents", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.search_documents" ], "agent_summary": "搜索文档（不传关键词返回最近访问）", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "全局搜文件用 dws drive search；指定知识库内搜用 dws wiki node search" ], "canonical_path": "doc.search_documents", "cli_name": "search", "cli_path": "doc search", "confirmation": "not_required", "description": "根据关键词搜索当前用户有权限访问的文档列表。不传关键词则返回最近访问的文档。\n\n支持按扩展名、创建/访问时间范围、创建者、编辑者、@提及用户、知识库等维度过滤。", "display": "钉钉文档管理", "effect": "read", "effect_source": "command-verb", "examples": [ "dws doc search --query \"会议纪要\" --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "搜索文档（不传关键词返回最近访问）" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "搜索文档（不传关键词返回最近访问）" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.search_documents.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "全局搜文件用 dws drive search；指定知识库内搜用 dws wiki node search" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "全局搜文件用 dws drive search；指定知识库内搜用 dws wiki node search" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc search", "value": "doc.search_documents" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc search", "value": "doc.search_documents" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "根据关键词搜索当前用户有权限访问的文档列表。不传关键词则返回最近访问的文档。\n\n支持按扩展名、创建/访问时间范围、创建者、编辑者、@提及用户、知识库等维度过滤。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "根据关键词和多种过滤条件搜索当前用户有权限访问的文档列表。\r\n\r\n支持的过滤条件：\r\n- keyword：关键词匹配文档标题和内容\r\n- extensions：按文件扩展名精确过滤（pdf/docx/png 等）\r\n- createdTimeFrom / createdTimeTo：按创建时间范围过滤\r\n- visitedTimeFrom / visitedTimeTo：按访问时间范围过滤\r\n- creatorUserIds：按创建者用户 ID 过滤\r\n - editorUserIds：按编辑者用户 ID 过滤\r\n- mentionedUserIds：按文档中 @提及的用户 ID 过滤\r\n- workspaceIds：按知识库范围过滤（支持知识库 URL）\r\n\r\n支持分页获取结果。搜索范围为用户在当前组织内有权限访问的所有文档数据。\r\n所有过滤条件均为可选，不传则不过滤。多个条件同时传入时取交集" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "根据关键词搜索当前用户有权限访问的文档列表。不传关键词则返回最近访问的文档。\n\n支持按扩展名、创建/访问时间范围、创建者、编辑者、@提及用户、知识库等维度过滤。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "read" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc search --query \"会议纪要\" --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc search --query \"会议纪要\" --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "idempotent" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.search_documents.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "search_documents" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.search_documents.interface_ref", "value": "doc.search_documents" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "search_documents" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "low" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "搜索文档" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "搜索文档" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "搜索文档" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "兼容入口：按关键词搜文档时（已弃用，日常改用 drive search / wiki node search）" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "兼容入口：按关键词搜文档时（已弃用，日常改用 drive search / wiki node search）" ] } }, "has_parameters": true, "idempotency": "idempotent", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "search_documents" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "search_documents", "parameter_count": 12, "parameters": { "created-from": { "description": "创建时间起始 (毫秒时间戳，含)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "创建时间起始 (毫秒时间戳，含)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建时间范围的起始时间（毫秒时间戳，含）" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "创建时间起始 (毫秒时间戳，含)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "createdTimeFrom" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "createdFrom" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "createdTimeFrom" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "创建时间范围的起始时间（毫秒时间戳，含）", "interface_type": "number", "property": "createdTimeFrom", "required": false, "type": "integer" }, "created-to": { "description": "创建时间截止 (毫秒时间戳，含)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "创建时间截止 (毫秒时间戳，含)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "创建时间范围的截止时间（毫秒时间戳，含）" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "创建时间截止 (毫秒时间戳，含)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "createdTimeTo" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "createdTo" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "createdTimeTo" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "创建时间范围的截止时间（毫秒时间戳，含）", "interface_type": "number", "property": "createdTimeTo", "required": false, "type": "integer" }, "creator-uids": { "description": "按创建者用户 ID 过滤，逗号分隔", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按创建者用户 ID 过滤，逗号分隔" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "按创建者过滤，传入用户 ID 列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按创建者用户 ID 过滤，逗号分隔" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "creatorUserIds" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "creatorUids" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "creatorUserIds" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "interface_description": "按创建者过滤，传入用户 ID 列表", "property": "creatorUserIds", "required": false, "type": "array" }, "cursor": { "description": "分页游标 (从上次结果的 nextPageToken 获取)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标 (从上次结果的 nextPageToken 获取)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "分页游标，从上一次请求的返回结果中获取 nextPageToken" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标 (从上次结果的 nextPageToken 获取)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "pageToken" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "pageToken" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "分页游标，从上一次请求的返回结果中获取 nextPageToken", "property": "pageToken", "required": false, "type": "string" }, "editor-uids": { "description": "按编辑者用户 ID 过滤，逗号分隔", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按编辑者用户 ID 过滤，逗号分隔" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "按编辑者过滤，传入用户 ID 列表" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按编辑者用户 ID 过滤，逗号分隔" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "editorUserIds" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "editorUids" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "editorUserIds" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "interface_description": "按编辑者过滤，传入用户 ID 列表", "property": "editorUserIds", "required": false, "type": "array" }, "extensions": { "description": "按文件扩展名过滤，不含点号，逗号分隔 (如 pdf,docx,png)。支持的在线文档类型后缀名: adoc=文字, axls=表格, appt=演示文稿, awbd=白板, adraw=画板, amind=脑图, able=多维表格, aform=收集表", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按文件扩展名过滤，不含点号，逗号分隔 (如 pdf,docx,png)。支持的在线文档类型后缀名: adoc=文字, axls=表格, appt=演示文稿, awbd=白板, adraw=画板, amind=脑图, able=多维表格, aform=收集表" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "按文件扩展名精确过滤，不含点号。例如 [\"pdf\", \"docx\", \"png\"]。与 fileTypes 可同时使用。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按文件扩展名过滤，不含点号，逗号分隔 (如 pdf,docx,png)。支持的在线文档类型后缀名: adoc=文字, axls=表格, appt=演示文稿, awbd=白板, adraw=画板, amind=脑图, able=多维表格, aform=收集表" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "extensions" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "extensions" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "interface_description": "按文件扩展名精确过滤，不含点号。例如 [\"pdf\", \"docx\", \"png\"]。与 fileTypes 可同时使用。", "property": "extensions", "required": false, "type": "array" }, "limit": { "description": "每页数量 (默认 10，最大 30)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "每页数量 (默认 10，最大 30)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "每页返回的文档数量，默认 10，最大 30" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "每页数量 (默认 10，最大 30)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "pageSize" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "pageSize" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "每页返回的文档数量，默认 10，最大 30", "interface_type": "number", "property": "pageSize", "required": false, "type": "integer" }, "mentioned-uids": { "description": "按 @提及的用户 ID 过滤，逗号分隔", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按 @提及的用户 ID 过滤，逗号分隔" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "按文档中 @提及的用户过滤" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按 @提及的用户 ID 过滤，逗号分隔" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "mentionedUserIds" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "mentionedUids" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "mentionedUserIds" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "interface_description": "按文档中 @提及的用户过滤", "property": "mentionedUserIds", "required": false, "type": "array" }, "query": { "description": "搜索关键词 (不传则返回最近访问)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "搜索关键词 (不传则返回最近访问)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "搜索关键词，匹配文档标题和内容。不传则返回最近访问的文档列表。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "搜索关键词 (不传则返回最近访问)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "keyword" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "query" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "keyword" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "搜索关键词，匹配文档标题和内容。不传则返回最近访问的文档列表。", "property": "keyword", "required": false, "type": "string" }, "visited-from": { "description": "访问时间起始 (毫秒时间戳，含)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "访问时间起始 (毫秒时间戳，含)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "访问时间范围的起始时间（毫秒时间戳，含）" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "访问时间起始 (毫秒时间戳，含)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "visitedTimeFrom" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "visitedFrom" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "visitedTimeFrom" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "访问时间范围的起始时间（毫秒时间戳，含）", "interface_type": "number", "property": "visitedTimeFrom", "required": false, "type": "integer" }, "visited-to": { "description": "访问时间截止 (毫秒时间戳，含)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "访问时间截止 (毫秒时间戳，含)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "访问时间范围的截止时间（毫秒时间戳，含）" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "访问时间截止 (毫秒时间戳，含)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "visitedTimeTo" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "visitedTo" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "visitedTimeTo" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "访问时间范围的截止时间（毫秒时间戳，含）", "interface_type": "number", "property": "visitedTimeTo", "required": false, "type": "integer" }, "workspace-ids": { "description": "按知识库 ID 过滤，支持知识库 URL，逗号分隔", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "按知识库 ID 过滤，支持知识库 URL，逗号分隔" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "按知识库范围过滤，支持知识库 URL" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "按知识库 ID 过滤，支持知识库 URL，逗号分隔" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "workspaceIds" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "workspaceIds" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "array" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "array" } }, "interface_description": "按知识库范围过滤，支持知识库 URL", "property": "workspaceIds", "required": false, "type": "array" } }, "path": "doc.search_documents", "primary_cli_path": "doc search", "product_id": "doc", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "搜索文档", "use_when": [ "兼容入口：按关键词搜文档时（已弃用，日常改用 drive search / wiki node search）" ] }, "doc.template_apply": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.template_apply", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc template apply", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "live-mcp:dws schema doc.apply_doc_template", "structured-hint:internal/cli/schema_hints/products/doc.json" ], "agent_summary": "使用指定模板创建新文档", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "先 list/search 拿到模板再 apply；普通空文档用 doc create" ], "canonical_path": "doc.template_apply", "cli_name": "apply", "cli_path": "doc template apply", "confirmation": "not_required", "description": "使用指定模板创建新文档。", "display": "钉钉文档管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws doc template apply --template-id \u003cTPL_ID\u003e --name \"我的周报\" --format json", "dws doc template apply --template-id \u003cTPL_ID\u003e --name \"项目方案\" --folder \u003cFOLDER_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "使用指定模板创建新文档" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "使用指定模板创建新文档" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "先 list/search 拿到模板再 apply；普通空文档用 doc create" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "先 list/search 拿到模板再 apply；普通空文档用 doc create" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc template apply", "value": "doc.template_apply" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc template apply", "value": "doc.template_apply" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "使用指定模板创建新文档。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "使用指定模板创建新文档。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc template apply --template-id \u003cTPL_ID\u003e --name \"我的周报\" --format json", "dws doc template apply --template-id \u003cTPL_ID\u003e --name \"项目方案\" --folder \u003cFOLDER_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc template apply --template-id \u003cTPL_ID\u003e --name \"我的周报\" --format json", "dws doc template apply --template-id \u003cTPL_ID\u003e --name \"项目方案\" --folder \u003cFOLDER_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "unknown" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/doc.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "应用文档模板" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "应用文档模板" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "使用指定模板创建新文档时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "使用指定模板创建新文档时" ] } }, "group": "template", "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "template_apply", "parameter_count": 4, "parameters": { "folder": { "description": "目标文件夹 ID (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文件夹 ID (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文件夹 ID (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.template_apply has no singular pinned interface_ref; --folder is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "folder" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.template_apply has no singular pinned interface_ref; --folder is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "name": { "description": "新文档名称 (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "新文档名称 (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "新文档名称 (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.template_apply has no singular pinned interface_ref; --name is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "name" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.template_apply has no singular pinned interface_ref; --name is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "template-id": { "description": "模板 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板 ID (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板 ID (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.template_apply has no singular pinned interface_ref; --template-id is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "templateId" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.template_apply has no singular pinned interface_ref; --template-id is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" }, "workspace": { "description": "知识库 ID (可选)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "知识库 ID (可选)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "知识库 ID (可选)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.template_apply has no singular pinned interface_ref; --workspace is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.template_apply has no singular pinned interface_ref; --workspace is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" } }, "path": "doc.template_apply", "primary_cli_path": "doc template apply", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "应用文档模板", "use_when": [ "使用指定模板创建新文档时" ] }, "doc.template_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.template_list", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc template list", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "live-mcp:dws schema doc.list_doc_templates", "structured-hint:internal/cli/schema_hints/products/doc.json" ], "agent_summary": "获取当前用户可用的文档模板列表", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "按关键词搜模板用 template search；套用模板用 template apply" ], "canonical_path": "doc.template_list", "cli_name": "list", "cli_path": "doc template list", "confirmation": "not_required", "description": "获取当前用户可用的文档模板列表，支持按来源筛选。", "display": "钉钉文档管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws doc template list --format json", "dws doc template list --source MY --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "获取当前用户可用的文档模板列表" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "获取当前用户可用的文档模板列表" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "按关键词搜模板用 template search；套用模板用 template apply" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "按关键词搜模板用 template search；套用模板用 template apply" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc template list", "value": "doc.template_list" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc template list", "value": "doc.template_list" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取当前用户可用的文档模板列表，支持按来源筛选。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取当前用户可用的文档模板列表，支持按来源筛选。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc template list --format json", "dws doc template list --source MY --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc template list --format json", "dws doc template list --source MY --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/doc.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "获取文档模板列表" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "获取文档模板列表" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "列出当前用户可用的文档模板时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "列出当前用户可用的文档模板时" ] } }, "group": "template", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "template_list", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.template_list has no singular pinned interface_ref; --cursor is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.template_list has no singular pinned interface_ref; --cursor is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "limit": { "description": "返回数量上限", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "返回数量上限" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "返回数量上限" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.template_list has no singular pinned interface_ref; --limit is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.template_list has no singular pinned interface_ref; --limit is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "required": false, "type": "integer" }, "source": { "description": "模板来源: MY(我的模版)/PUBLIC(公开模版)，不传默认 MY", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板来源: MY(我的模版)/PUBLIC(公开模版)，不传默认 MY" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板来源: MY(我的模版)/PUBLIC(公开模版)，不传默认 MY" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.template_list has no singular pinned interface_ref; --source is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "source" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.template_list has no singular pinned interface_ref; --source is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" } }, "path": "doc.template_list", "primary_cli_path": "doc template list", "product_id": "doc", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "获取文档模板列表", "use_when": [ "列出当前用户可用的文档模板时" ] }, "doc.template_search": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.template_search", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc template search", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "live-mcp:dws schema doc.search_doc_templates", "structured-hint:internal/cli/schema_hints/products/doc.json" ], "agent_summary": "根据关键词搜索文档模板", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "浏览全部模板用 template list；创建文档用 template apply" ], "canonical_path": "doc.template_search", "cli_name": "search", "cli_path": "doc template search", "confirmation": "not_required", "description": "根据关键词搜索文档模板。", "display": "钉钉文档管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws doc template search --query \"周报\" --format json", "dws doc template search --query \"会议纪要\" --source PUBLIC --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "根据关键词搜索文档模板" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "根据关键词搜索文档模板" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "浏览全部模板用 template list；创建文档用 template apply" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "浏览全部模板用 template list；创建文档用 template apply" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc template search", "value": "doc.template_search" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc template search", "value": "doc.template_search" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "根据关键词搜索文档模板。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "根据关键词搜索文档模板。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc template search --query \"周报\" --format json", "dws doc template search --query \"会议纪要\" --source PUBLIC --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc template search --query \"周报\" --format json", "dws doc template search --query \"会议纪要\" --source PUBLIC --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/doc.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "搜索文档模板" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "搜索文档模板" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "按关键词搜索文档模板时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "按关键词搜索文档模板时" ] } }, "group": "template", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "template_search", "parameter_count": 4, "parameters": { "cursor": { "description": "分页游标", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.template_search has no singular pinned interface_ref; --cursor is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.template_search has no singular pinned interface_ref; --cursor is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "limit": { "description": "返回数量上限", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "返回数量上限" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "返回数量上限" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.template_search has no singular pinned interface_ref; --limit is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.template_search has no singular pinned interface_ref; --limit is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "required": false, "type": "integer" }, "query": { "description": "搜索关键词 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "搜索关键词 (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "搜索关键词 (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.template_search has no singular pinned interface_ref; --query is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "query" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.template_search has no singular pinned interface_ref; --query is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" }, "source": { "description": "模板来源: MY(我的模版)/PUBLIC(公开模版)，不传默认 MY", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "模板来源: MY(我的模版)/PUBLIC(公开模版)，不传默认 MY" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "模板来源: MY(我的模版)/PUBLIC(公开模版)，不传默认 MY" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.template_search has no singular pinned interface_ref; --source is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "source" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.template_search has no singular pinned interface_ref; --source is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" } }, "path": "doc.template_search", "primary_cli_path": "doc template search", "product_id": "doc", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "搜索文档模板", "use_when": [ "按关键词搜索文档模板时" ] }, "doc.update_comment": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "cobra-help:dws doc comment update --help", "internal/cli/schema_command_registry.json#doc.update_comment", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "live-mcp:dws schema doc-comment.update_comment", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-comment.md", "structured-hint:internal/cli/schema_hints/products/doc.json" ], "agent_summary": "更新指定文档评论的文字内容和可选 @提及用户。", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "删除评论用 delete；回复用 reply" ], "canonical_path": "doc.update_comment", "cli_name": "update", "cli_path": "doc comment update", "confirmation": "not_required", "description": "更新指定文档中的一条评论。\n\n--comment-key 为待更新评论的唯一标识，可从 comment list、create 或 create-inline 的返回结果中获取。\n可通过 --mention 指定更新后评论中被 @ 的用户 uid 列表。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc comment update --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"已按最新数据修正\" --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "更新指定文档评论的文字内容和可选 @提及用户。" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "更新指定文档评论的文字内容和可选 @提及用户。" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Preserve the reviewed CLI-to-interface conversion: the comma-separated --mention string is normalized to the mentionedUserIds array.", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Preserve the reviewed CLI-to-interface conversion: the comma-separated --mention string is normalized to the mentionedUserIds array.", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "删除评论用 delete；回复用 reply" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "删除评论用 delete；回复用 reply" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc comment update", "value": "doc.update_comment" }, { "precedence": "reviewed_manual", "review_reason": "Preserve the reviewed CLI-to-interface conversion: the comma-separated --mention string is normalized to the mentionedUserIds array.", "selected": false, "source": "reviewed_manual_hint", "source_ref": "doc comment update", "value": "doc.update_comment" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc comment update", "value": "doc.update_comment" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Preserve the reviewed CLI-to-interface conversion: the comma-separated --mention string is normalized to the mentionedUserIds array.", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" }, { "precedence": "inference_or_default", "selected": false, "source": "risk-default", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Preserve the reviewed CLI-to-interface conversion: the comma-separated --mention string is normalized to the mentionedUserIds array.", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新指定文档中的一条评论。\n\n--comment-key 为待更新评论的唯一标识，可从 comment list、create 或 create-inline 的返回结果中获取。\n可通过 --mention 指定更新后评论中被 @ 的用户 uid 列表。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新指定文档中的一条评论。\n\n--comment-key 为待更新评论的唯一标识，可从 comment list、create 或 create-inline 的返回结果中获取。\n可通过 --mention 指定更新后评论中被 @ 的用户 uid 列表。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc comment update --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"已按最新数据修正\" --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc comment update --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"已按最新数据修正\" --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Preserve the reviewed CLI-to-interface conversion: the comma-separated --mention string is normalized to the mentionedUserIds array.", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Preserve the reviewed CLI-to-interface conversion: the comma-separated --mention string is normalized to the mentionedUserIds array.", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Preserve the reviewed CLI-to-interface conversion: the comma-separated --mention string is normalized to the mentionedUserIds array.", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Preserve the reviewed CLI-to-interface conversion: the comma-separated --mention string is normalized to the mentionedUserIds array.", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/doc.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "Preserve the reviewed CLI-to-interface conversion: the comma-separated --mention string is normalized to the mentionedUserIds array.", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "Preserve the reviewed CLI-to-interface conversion: the comma-separated --mention string is normalized to the mentionedUserIds array.", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新文档评论" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新文档评论" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "修改已有评论正文；可选更新 --mention" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "修改已有评论正文；可选更新 --mention" ] } }, "group": "comment", "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "update_comment", "parameter_count": 4, "parameters": { "comment-key": { "description": "待更新评论的 commentKey，可从 list/create/create-inline 结果获取 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "待更新评论的 commentKey，可从 list/create/create-inline 结果获取 (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "待更新评论的 commentKey，可从 list/create/create-inline 结果获取 (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.update_comment has no singular pinned interface_ref; --comment-key is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "commentKey" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.update_comment has no singular pinned interface_ref; --comment-key is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" }, "content": { "description": "更新后的评论文字内容，纯文本 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "更新后的评论文字内容，纯文本 (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "更新后的评论文字内容，纯文本 (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.update_comment has no singular pinned interface_ref; --content is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "content" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.update_comment has no singular pinned interface_ref; --content is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" }, "mention": { "description": "被 @ 的用户 uid 列表，逗号分隔", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "被 @ 的用户 uid 列表，逗号分隔" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "被 @ 的用户 uid 列表，逗号分隔" }, "interface_type": { "candidates": [ { "precedence": "reviewed_manual", "review_reason": "Preserve the reviewed CLI-to-interface conversion: the comma-separated --mention string is normalized to the mentionedUserIds array.", "selected": true, "source": "reviewed_manual_hint", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "reviewed_manual", "resolution": "highest_precedence", "review_reason": "Preserve the reviewed CLI-to-interface conversion: the comma-separated --mention string is normalized to the mentionedUserIds array.", "source": "reviewed_manual_hint", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "mentionedUserIds" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "mention" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "mentionedUserIds" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_type": "array", "property": "mentionedUserIds", "required": false, "type": "string" }, "node": { "description": "目标文档的标识，支持传入 URL 或 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文档的标识，支持传入 URL 或 ID (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文档的标识，支持传入 URL 或 ID (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "nodeId", "required": true, "type": "string" } }, "path": "doc.update_comment", "primary_cli_path": "doc comment update", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "更新文档评论", "use_when": [ "修改已有评论正文；可选更新 --mention" ] }, "doc.update_document": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.update_document", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc update", "dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.update_document", "internal/cli/schema_hints/imported/wukong.json", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.update_document", "live-mcp:dws schema doc.update_document", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-block.md", "skills/mono/references/products/doc/doc-update.md", "skills/mono/references/products/doc/style/doc-update-workflow.md", "structured-hint:internal/cli/schema_hints/imported/wukong.json#doc.update_document", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.update_document" ], "agent_summary": "更新文档内容（追加 / 覆盖；覆盖需 --yes）", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "目标不是 adoc 或只要改单个块时改用 doc block update", "覆盖模式用户未确认前不要执行；可先 --dry-run 预览", "创建新文档用 doc create，不要用 update 冒充创建" ], "canonical_path": "doc.update_document", "cli_name": "update", "cli_path": "doc update", "confirmation": "not_required", "constraints": { "mutually_exclusive": [ [ "content", "content-file" ] ], "require_one_of": [ [ "content", "content-file" ] ] }, "description": "更新文档的 Markdown 内容。\n --mode overwrite: 覆盖 (清空原内容后重写)\n --mode append: 追加 (在末尾追加，最安全)\n 注意: --mode 为必填参数，必须显式指定 overwrite 或 append。\n\nWARNING: --mode overwrite 为破坏性写入，会清空原文档全部内容。\n - 必须显式传 --yes 才会执行覆盖；不传 --yes 时命令直接返回错误。\n - 可先用 --dry-run 预览待写入内容与当前内容的差异 (不调远端 update)。\n - 调用前建议先用 dws doc read 备份现状；调用后建议再次 read 校验。\n\n内容来源（--content-file 优先于 --content）:\n --content \"...\" 短文本字面量（仅推荐 \u003c2KB 且无换行/表格）\n --content - 从 stdin 读取（可配合 heredoc/pipe）\n --content-file path 从 UTF-8 文件读取（推荐长/多行/表格内容，避免 shell escape）\n\n插入位置（仅 mode=append 生效）:\n --index N 将内容插入到文档第 N 个 block 之前（从 0 开始）。\n 不传时追加到末尾。block index 可通过 doc block list 获取。\n 插入成功后，该位置及之后所有 block 的 index 会依次 +1。", "display": "钉钉文档管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws doc update --node \u003cDOC_ID\u003e --content \"# 追加内容\" --mode append --format json", "dws doc update --node \u003cDOC_ID\u003e --content-file ./body.md --mode overwrite --dry-run" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "更新文档内容（追加 / 覆盖；覆盖需 --yes）" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "更新文档内容（追加 / 覆盖；覆盖需 --yes）" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "目标不是 adoc 或只要改单个块时改用 doc block update", "覆盖模式用户未确认前不要执行；可先 --dry-run 预览", "创建新文档用 doc create，不要用 update 冒充创建" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "目标不是 adoc 或只要改单个块时改用 doc block update", "覆盖模式用户未确认前不要执行；可先 --dry-run 预览", "创建新文档用 doc create，不要用 update 冒充创建" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc update", "value": "doc.update_document" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc update", "value": "doc.update_document" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" }, { "precedence": "inference_or_default", "selected": false, "source": "risk-default", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新文档的 Markdown 内容。\n --mode overwrite: 覆盖 (清空原内容后重写)\n --mode append: 追加 (在末尾追加，最安全)\n 注意: --mode 为必填参数，必须显式指定 overwrite 或 append。\n\nWARNING: --mode overwrite 为破坏性写入，会清空原文档全部内容。\n - 必须显式传 --yes 才会执行覆盖；不传 --yes 时命令直接返回错误。\n - 可先用 --dry-run 预览待写入内容与当前内容的差异 (不调远端 update)。\n - 调用前建议先用 dws doc read 备份现状；调用后建议再次 read 校验。\n\n内容来源（--content-file 优先于 --content）:\n --content \"...\" 短文本字面量（仅推荐 \u003c2KB 且无换行/表格）\n --content - 从 stdin 读取（可配合 heredoc/pipe）\n --content-file path 从 UTF-8 文件读取（推荐长/多行/表格内容，避免 shell escape）\n\n插入位置（仅 mode=append 生效）:\n --index N 将内容插入到文档第 N 个 block 之前（从 0 开始）。\n 不传时追加到末尾。block index 可通过 doc block list 获取。\n 插入成功后，该位置及之后所有 block 的 index 会依次 +1。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "更新钉钉文档的内容，扩展名=adoc，其他类型在线文档不能使用此mcp服务，支持两种更新模式。\r\n\r\n## 更新模式\r\n\r\n1. **overwrite**（覆盖，默认）：清空文档全部内容后重新写入。适用于需要完整替换文档内容的场景。⚠️ 会丢失原有内容，请谨慎使用。\r\n2. **append**（追加）：在文档末尾追加新内容。最安全的模式，不影响现有内容。\r\n 支持通过 index 参数指定插入位置（从 0 开始）；不传 index 时追加到末尾。\r\n block 的 index 可通过 list_document_blocks 工具获取。\r\n 插入成功后，该位置及之后的所有 block 的 index 会依次 +1。\r\n\r\n## 注意事项\r\n- 默认模式为 overwrite，不传 mode 时使用覆盖模式\r\n- overwrite 模式会清空所有内容，包括图片、评论等，请谨慎使用\r\n- 写入内容长度上限 10000 字符，超出请分批写入" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新文档的 Markdown 内容。\n --mode overwrite: 覆盖 (清空原内容后重写)\n --mode append: 追加 (在末尾追加，最安全)\n 注意: --mode 为必填参数，必须显式指定 overwrite 或 append。\n\nWARNING: --mode overwrite 为破坏性写入，会清空原文档全部内容。\n - 必须显式传 --yes 才会执行覆盖；不传 --yes 时命令直接返回错误。\n - 可先用 --dry-run 预览待写入内容与当前内容的差异 (不调远端 update)。\n - 调用前建议先用 dws doc read 备份现状；调用后建议再次 read 校验。\n\n内容来源（--content-file 优先于 --content）:\n --content \"...\" 短文本字面量（仅推荐 \u003c2KB 且无换行/表格）\n --content - 从 stdin 读取（可配合 heredoc/pipe）\n --content-file path 从 UTF-8 文件读取（推荐长/多行/表格内容，避免 shell escape）\n\n插入位置（仅 mode=append 生效）:\n --index N 将内容插入到文档第 N 个 block 之前（从 0 开始）。\n 不传时追加到末尾。block index 可通过 doc block list 获取。\n 插入成功后，该位置及之后所有 block 的 index 会依次 +1。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" }, { "precedence": "inference_or_default", "selected": false, "source": "command-verb", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc update --node \u003cDOC_ID\u003e --content \"# 追加内容\" --mode append --format json", "dws doc update --node \u003cDOC_ID\u003e --content-file ./body.md --mode overwrite --dry-run" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc update --node \u003cDOC_ID\u003e --content \"# 追加内容\" --mode append --format json", "dws doc update --node \u003cDOC_ID\u003e --content-file ./body.md --mode overwrite --dry-run" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "imported", "selected": true, "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "update_document" } }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document.interface_ref", "value": "doc.update_document" } ], "precedence": "imported", "resolution": "highest_precedence", "source": "internal/cli/schema_hints/imported/wukong.json", "value": { "product_id": "doc", "rpc_name": "update_document" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新文档内容" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "更新钉钉文档的内容" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新文档内容" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户要向已有 adoc 追加内容时用 --mode append（更安全）", "用户明确要求整篇覆盖替换时用 --mode overwrite（破坏性）", "append 且要插到第 N 个 block 前时加 --index N（先 block list）" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户要向已有 adoc 追加内容时用 --mode append（更安全）", "用户明确要求整篇覆盖替换时用 --mode overwrite（破坏性）", "append 且要插到第 N 个 block 前时加 --index N（先 block list）" ] } }, "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "update_document" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_document", "parameter_count": 10, "parameters": { "content": { "description": "文档内容（短文本字面量）；传 - 表示从 stdin 读取", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档内容（短文本字面量）；传 - 表示从 stdin 读取" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档内容（短文本字面量）；传 - 表示从 stdin 读取" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "pipeline input mapped to markdown or jsonml according to content-format", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "content" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "pipeline input mapped to markdown or jsonml according to content-format", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "command_constraint", "selected": true, "source": "require_one_of_constraint", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "command_constraint", "resolution": "highest_precedence", "source": "require_one_of_constraint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "content-file": { "description": "从文件读取文档内容（UTF-8）。推荐长/多行/表格内容使用", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "从文件读取文档内容（UTF-8）。推荐长/多行/表格内容使用" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "从文件读取文档内容（UTF-8）。推荐长/多行/表格内容使用" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "local file input for the content pipeline", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "contentFile" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "local file input for the content pipeline", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "command_constraint", "selected": true, "source": "require_one_of_constraint", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "command_constraint", "resolution": "highest_precedence", "source": "require_one_of_constraint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "content-format": { "description": "内容格式: 默认为 markdown，可选 jsonml", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "内容格式: 默认为 markdown，可选 jsonml" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "指定数据的格式，可选为 markdown 或 jsonml，默认为 markdown" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "内容格式: 默认为 markdown，可选 jsonml" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "format" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "contentFormat" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "format" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "指定数据的格式，可选为 markdown 或 jsonml，默认为 markdown", "property": "format", "required": false, "type": "string" }, "dry-run": { "description": "预览覆盖写入差异，不调用远端 update", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "预览覆盖写入差异，不调用远端 update" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "预览覆盖写入差异，不调用远端 update" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "local preview control", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "dryRun" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "local preview control", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "boolean" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "boolean" } }, "required": false, "type": "boolean" }, "fix-jsonml": { "description": "启用 JSON 语法修复（括号/逗号补全），推荐 agent 调用时使用", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "启用 JSON 语法修复（括号/逗号补全），推荐 agent 调用时使用" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "启用 JSON 语法修复（括号/逗号补全），推荐 agent 调用时使用" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "local JSONML normalization control", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "fixJsonml" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "local JSONML normalization control", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "boolean" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "boolean" } }, "required": false, "type": "boolean" }, "index": { "default": "-1", "description": "插入位置（从 0 开始），仅在 mode=append 时生效。指定将内容插入到文档第几个 block 之前。不传时追加到末尾", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "插入位置（从 0 开始），仅在 mode=append 时生效。指定将内容插入到文档第几个 block 之前。不传时追加到末尾" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "插入位置（从 0 开始），仅在 mode=append 时生效。指定将内容插入到文档第几个 block 之前。不传时追加到末尾。block 的 index 可通过 list_document_blocks 工具获取。插入成功后，该位置及之后的所有 block 的 index 会依次 +1。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "插入位置（从 0 开始），仅在 mode=append 时生效。指定将内容插入到文档第几个 block 之前。不传时追加到末尾" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "number" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "number" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "index" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "index" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "插入位置（从 0 开始），仅在 mode=append 时生效。指定将内容插入到文档第几个 block 之前。不传时追加到末尾。block 的 index 可通过 list_document_blocks 工具获取。插入成功后，该位置及之后的所有 block 的 index 会依次 +1。", "interface_type": "number", "property": "index", "required": false, "type": "integer" }, "mode": { "cli_required": true, "description": "更新模式: overwrite=覆盖, append=追加 (必填)", "field_provenance": { "cli_required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_hard_required", "value": true } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_hard_required", "value": true }, "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "更新模式: overwrite=覆盖, append=追加 (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "更新模式，默认 overwrite。可选值：overwrite（覆盖全文）、append（追加到末尾）。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "更新模式: overwrite=覆盖, append=追加 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "mode" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "mode" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_hard_required", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_hard_required", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "更新模式，默认 overwrite。可选值：overwrite（覆盖全文）、append（追加到末尾）。", "property": "mode", "required": true, "type": "string" }, "node": { "description": "文档 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文档的标识，支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "tool_schema_hint", "selected": true, "source": "tool_schema_hint", "value": true }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "tool_schema_hint", "resolution": "highest_precedence", "source": "tool_schema_hint", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文档的标识，支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。必填。", "property": "nodeId", "required": true, "type": "string" }, "revision": { "description": "可选，文档编辑版本号（仅 --content-format jsonml 生效）；传则触发并发检查（与服务端不一致时拒绝写入），不传则直接覆盖", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "可选，文档编辑版本号（仅 --content-format jsonml 生效）；传则触发并发检查（与服务端不一致时拒绝写入），不传则直接覆盖" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "文档版本号" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "可选，文档编辑版本号（仅 --content-format jsonml 生效）；传则触发并发检查（与服务端不一致时拒绝写入），不传则直接覆盖" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "string" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "string" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "revision" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "revision" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "interface_description": "文档版本号", "interface_type": "string", "property": "revision", "required": false, "type": "integer" }, "yes": { "description": "确认执行破坏性写入 (仅 --mode overwrite 需要)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "确认执行破坏性写入 (仅 --mode overwrite 需要)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "确认执行破坏性写入 (仅 --mode overwrite 需要)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "local confirmation control", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "yes" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "local confirmation control", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "boolean" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "boolean" } }, "required": false, "type": "boolean" } }, "path": "doc.update_document", "primary_cli_path": "doc update", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "更新文档内容", "use_when": [ "用户要向已有 adoc 追加内容时用 --mode append（更安全）", "用户明确要求整篇覆盖替换时用 --mode overwrite（破坏性）", "append 且要插到第 N 个 block 前时加 --index N（先 block list）" ] }, "doc.update_document_block": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.update_document_block", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc block update", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.update_document_block", "live-mcp:dws schema doc.update_document_block", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-block.md", "skills/mono/references/products/doc/format/doc-jsonml-cookbook.md", "skills/mono/references/products/doc/style/doc-update-workflow.md", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.update_document_block" ], "agent_summary": "更新文档中的指定块", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "插入新块用 block insert；删除用 block delete", "改文档显示名用 rename；整篇覆盖用 update overwrite" ], "canonical_path": "doc.update_document_block", "cli_name": "update", "cli_path": "doc block update", "confirmation": "not_required", "constraints": { "require_one_of": [ [ "text", "heading", "element" ] ] }, "description": "更新文档中指定块的内容或样式。需提供 --block-id 和块元素内容。\n可用 --text 快速更新为段落，--heading + --level 快速更新为标题。", "display": "钉钉文档管理", "effect": "write", "effect_source": "command-verb", "examples": [ "dws doc block update --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --text \"新内容\" --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "更新文档中的指定块" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "更新文档中的指定块" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document_block.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "插入新块用 block insert；删除用 block delete", "改文档显示名用 rename；整篇覆盖用 update overwrite" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "插入新块用 block insert；删除用 block delete", "改文档显示名用 rename；整篇覆盖用 update overwrite" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc block update", "value": "doc.update_document_block" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc block update", "value": "doc.update_document_block" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新文档中指定块的内容或样式。需提供 --block-id 和块元素内容。\n可用 --text 快速更新为段落，--heading + --level 快速更新为标题。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "更新指定文档的指定块元素内容或样式，需要提供文档ID(dentryUuid)、块元素ID(blockId)与块元素内容(必须包含 blockType 及对应类型的属性对象)。操作受文档权限控制，仅当调用者拥有编辑权限时生效。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新文档中指定块的内容或样式。需提供 --block-id 和块元素内容。\n可用 --text 快速更新为段落，--heading + --level 快速更新为标题。" }, "effect": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "command-verb", "value": "write" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "command-verb", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc block update --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --text \"新内容\" --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc block update --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --text \"新内容\" --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document_block.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document_block.interface_ref", "value": { "product_id": "doc", "rpc_name": "update_document_block" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_document_block.interface_ref", "value": { "product_id": "doc", "rpc_name": "update_document_block" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "medium" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新块元素" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "更新块元素" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新块元素" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "修改已有块的文本/标题/样式（已知 blockId）时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "修改已有块的文本/标题/样式（已知 blockId）时" ] } }, "group": "block", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "update_document_block" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_document_block", "parameter_count": 8, "parameters": { "block-id": { "description": "目标块 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标块 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "待删除块元素的唯一标识。可通过 list_document_blocks 工具查询获取（返回结果中的 blockId 字段）。目前仅支持根目录下的第一级块元素的 blockId。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标块 ID (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "blockId" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "blockId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "待删除块元素的唯一标识。可通过 list_document_blocks 工具查询获取（返回结果中的 blockId 字段）。目前仅支持根目录下的第一级块元素的 blockId。必填。", "property": "blockId", "required": true, "type": "string" }, "content-format": { "description": "输入格式: 默认为 element，可选 jsonml", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "输入格式: 默认为 element，可选 jsonml" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "数据的格式，可选为 element 或 jsonml，默认为 element" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "输入格式: 默认为 element，可选 jsonml" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "format" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "contentFormat" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "format" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "数据的格式，可选为 element 或 jsonml，默认为 element", "property": "format", "required": false, "type": "string" }, "element": { "description": "块元素 JSON (高级)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "块元素 JSON (高级)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "待插入的块元素，必须包含 blockType 及对应类型的属性对象，详见块元素数据结构附录。最精简示例：{\"blockType\": \"paragraph\", \"paragraph\": {}}。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "块元素 JSON (高级)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "object" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "object" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "element" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "element" }, "required": { "candidates": [ { "precedence": "command_constraint", "selected": true, "source": "require_one_of_constraint", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "command_constraint", "resolution": "highest_precedence", "source": "require_one_of_constraint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "待插入的块元素，必须包含 blockType 及对应类型的属性对象，详见块元素数据结构附录。最精简示例：{\"blockType\": \"paragraph\", \"paragraph\": {}}。", "interface_type": "object", "property": "element", "required": false, "type": "string" }, "fix-jsonml": { "description": "启用 JSON 语法修复（括号/逗号补全），推荐 agent 调用时使用", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "启用 JSON 语法修复（括号/逗号补全），推荐 agent 调用时使用" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "启用 JSON 语法修复（括号/逗号补全），推荐 agent 调用时使用" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "local JSONML normalization control", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "fixJsonml" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "local JSONML normalization control", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "boolean" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "boolean" } }, "required": false, "type": "boolean" }, "heading": { "description": "快捷: 标题文本", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "快捷: 标题文本" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "快捷: 标题文本" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "aggregate convenience input used to build element", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "heading" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "aggregate convenience input used to build element", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "command_constraint", "selected": true, "source": "require_one_of_constraint", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "command_constraint", "resolution": "highest_precedence", "source": "require_one_of_constraint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "level": { "default": "1", "description": "标题级别 1-6 (配合 --heading)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "标题级别 1-6 (配合 --heading)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "标题级别 1-6 (配合 --heading)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "aggregate convenience input used to build element", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "level" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "aggregate convenience input used to build element", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "required": false, "type": "integer" }, "node": { "description": "文档 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标文档的标识，支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。必填。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标文档的标识，支持传入文档链接 URL 或文档 ID（dentryUuid），系统自动识别。必填。", "property": "nodeId", "required": true, "type": "string" }, "text": { "description": "快捷: 段落文本内容", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "快捷: 段落文本内容" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "快捷: 段落文本内容" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "aggregate convenience input used to build element", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "text" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "aggregate convenience input used to build element", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "command_constraint", "selected": true, "source": "require_one_of_constraint", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "command_constraint", "resolution": "highest_precedence", "source": "require_one_of_constraint", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" } }, "path": "doc.update_document_block", "primary_cli_path": "doc block update", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "更新块元素", "use_when": [ "修改已有块的文本/标题/样式（已知 blockId）时" ] }, "doc.update_permission": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.update_permission", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc permission update", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "internal/cli/schema_mcp_metadata.json#tools.doc.update_permission", "live-mcp:dws schema doc.update_permission", "skills/mono/SKILL.md", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-permission.md", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.update_permission" ], "agent_summary": "兼容入口：更新文档空间节点的协作成员角色；文件权限命令已迁移到 drive。", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "新授权用 add；移除用 remove" ], "canonical_path": "doc.update_permission", "cli_name": "update", "cli_path": "doc permission update", "confirmation": "not_required", "description": "更新指定节点已有协作者的权限角色（仅支持 USER 类型成员）。\n\n支持的角色 (--role)（必须大写）：\n MANAGER 管理员\n EDITOR 编辑者\n DOWNLOADER 查看下载者\n READER 仅可查看者\n\n注意：\n- OWNER 角色不可通过此接口变更。\n- 同一成员在同一节点只能拥有一个角色，变更后旧角色自动替换。\n- 若成员的角色来自父节点的权限继承（PASS_ON），且继承角色高于目标角色，接口会拒绝操作。\n\n仅可更新已存在协作关系的用户，新增协作者请使用 dws doc permission add。", "display": "钉钉文档管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws doc permission update --node \u003cDOC_ID\u003e --users uid1 --role EDITOR --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：更新文档空间节点的协作成员角色；文件权限命令已迁移到 drive。" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：更新文档空间节点的协作成员角色；文件权限命令已迁移到 drive。" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_permission.interface_ref", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "新授权用 add；移除用 remove" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "新授权用 add；移除用 remove" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc permission update", "value": "doc.update_permission" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc permission update", "value": "doc.update_permission" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" }, { "precedence": "skill", "review_reason": "Skill danger table explicitly reviews this operation", "selected": false, "source": "skills/mono/SKILL.md", "value": "user_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新指定节点已有协作者的权限角色（仅支持 USER 类型成员）。\n\n支持的角色 (--role)（必须大写）：\n MANAGER 管理员\n EDITOR 编辑者\n DOWNLOADER 查看下载者\n READER 仅可查看者\n\n注意：\n- OWNER 角色不可通过此接口变更。\n- 同一成员在同一节点只能拥有一个角色，变更后旧角色自动替换。\n- 若成员的角色来自父节点的权限继承（PASS_ON），且继承角色高于目标角色，接口会拒绝操作。\n\n仅可更新已存在协作关系的用户，新增协作者请使用 dws doc permission add。" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "修改企业用户在知识库节点上的角色（仅支持 USER 类型）。\r\n\r\n通过传入 userIds 列表批量调整成员角色，同一成员在同一节点只能拥有一个角色，变更后旧角色自动替换。\r\n\r\n注意事项：\r\n- OWNER 角色不可通过此接口变更。\r\n- 若成员的角色来自父节点的权限继承（PASS_ON 模式），且继承的角色高于目标角色，接口会拒绝操作。\r\n- **权限要求（业务规则）**：操作者必须在该节点上具备「可编辑（EDITOR）」及以上角色（OWNER / MANAGER / EDITOR）。\r\n- 单次请求 `userIds` 列表最多传 30 个，超出需分批调用。\r\n- 入参直接采用扁平的 `userIds: List\u003cString\u003e`，每个元素为钉钉 staffId（外部 userId 格式，由钉钉开放平台体系下颁发）。" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新指定节点已有协作者的权限角色（仅支持 USER 类型成员）。\n\n支持的角色 (--role)（必须大写）：\n MANAGER 管理员\n EDITOR 编辑者\n DOWNLOADER 查看下载者\n READER 仅可查看者\n\n注意：\n- OWNER 角色不可通过此接口变更。\n- 同一成员在同一节点只能拥有一个角色，变更后旧角色自动替换。\n- 若成员的角色来自父节点的权限继承（PASS_ON），且继承角色高于目标角色，接口会拒绝操作。\n\n仅可更新已存在协作关系的用户，新增协作者请使用 dws doc permission add。" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" }, { "precedence": "skill", "review_reason": "Skill danger table explicitly reviews this operation", "selected": false, "source": "skills/mono/SKILL.md", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc permission update --node \u003cDOC_ID\u003e --users uid1 --role EDITOR --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc permission update --node \u003cDOC_ID\u003e --users uid1 --role EDITOR --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, { "precedence": "mcp_fallback", "selected": false, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_permission.interface_ref", "value": "mcp" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "mcp" }, "interface_ref": { "candidates": [ { "precedence": "mcp_fallback", "selected": true, "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_permission.interface_ref", "value": { "product_id": "doc", "rpc_name": "update_permission" } } ], "precedence": "mcp_fallback", "resolution": "highest_precedence", "source": "internal/cli/schema_mcp_metadata.json#tools.doc.update_permission.interface_ref", "value": { "product_id": "doc", "rpc_name": "update_permission" } }, "metadata_source": { "candidates": [ { "precedence": "derived_resolution", "selected": true, "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" } ], "precedence": "derived_resolution", "resolution": "highest_precedence", "source": "metadata_source_resolution", "value": "embedded-mcp-metadata" }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" }, { "precedence": "skill", "review_reason": "Skill danger table explicitly reviews this operation", "selected": false, "source": "skills/mono/SKILL.md", "value": "high" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "更新文档协作者权限" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "变更节点成员角色" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "更新文档协作者权限" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "变更文档节点上已有用户角色时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "变更文档节点上已有用户角色时" ] } }, "group": "permission", "has_parameters": true, "idempotency": "unknown", "interface_mode": "mcp", "interface_ref": { "product_id": "doc", "rpc_name": "update_permission" }, "is_alias": false, "metadata_source": "embedded-mcp-metadata", "name": "update_permission", "parameter_count": 4, "parameters": { "node": { "description": "目标节点的标识（文档/文件夹/文件），支持传入 URL 或 ID (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标节点的标识（文档/文件夹/文件），支持传入 URL 或 ID (必填)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标节点的 nodeId。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标节点的标识（文档/文件夹/文件），支持传入 URL 或 ID (必填)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "nodeId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "nodeId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标节点的 nodeId。", "property": "nodeId", "required": true, "type": "string" }, "role": { "description": "新权限角色: MANAGER / EDITOR / DOWNLOADER / READER (必填，大小写不敏感)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "新权限角色: MANAGER / EDITOR / DOWNLOADER / READER (必填，大小写不敏感)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "变更后的角色，取值：MANAGER、EDITOR、DOWNLOADER、READER。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "新权限角色: MANAGER / EDITOR / DOWNLOADER / READER (必填，大小写不敏感)" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "roleId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "role" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "roleId" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "变更后的角色，取值：MANAGER、EDITOR、DOWNLOADER、READER。", "property": "roleId", "required": true, "type": "string" }, "users": { "description": "被更新的用户 userId 列表，逗号分隔 (必填，单次最多 30 个)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "被更新的用户 userId 列表，逗号分隔 (必填，单次最多 30 个)" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "要变更角色的用户 userId 列表（钉钉 staffId / 外部 userId 格式，由钉钉开放平台体系下颁发；通常为数字字符串），至少包含一个 userId，单次最多 30 个。如果你只有 unionId，请先调用钉钉开放平台「根据 unionId 获取 userId」接口换取 userId。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "被更新的用户 userId 列表，逗号分隔 (必填，单次最多 30 个)" }, "interface_type": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": "array" }, { "precedence": "fallback", "selected": false, "source": "cobra_flag_type", "value": "string" } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": "array" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "userIds" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "users" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "userIds" }, "required": { "candidates": [ { "precedence": "mcp_metadata", "selected": true, "source": "mcp_metadata", "value": true }, { "precedence": "inference", "selected": false, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "mcp_metadata", "resolution": "highest_precedence", "source": "mcp_metadata", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "要变更角色的用户 userId 列表（钉钉 staffId / 外部 userId 格式，由钉钉开放平台体系下颁发；通常为数字字符串），至少包含一个 userId，单次最多 30 个。如果你只有 unionId，请先调用钉钉开放平台「根据 unionId 获取 userId」接口换取 userId。", "interface_type": "array", "property": "userIds", "required": true, "type": "string" }, "workspace": { "description": "目标知识库 ID 或 URL（选填，仅用于辅助构造返回的 docUrl）", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标知识库 ID 或 URL（选填，仅用于辅助构造返回的 docUrl）" }, { "precedence": "mcp_metadata", "selected": false, "source": "mcp_metadata", "value": "目标知识库的标识，选填。仅用于辅助构造返回的 docUrl，业务实际依赖 nodeId 定位节点；支持两种格式：1) 知识库 ID（纯字符串）；2) 知识库 URL，如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview，系统自动提取其中的 workspaceId。" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标知识库 ID 或 URL（选填，仅用于辅助构造返回的 docUrl）" }, "property": { "candidates": [ { "precedence": "versioned_binding", "selected": true, "source": "versioned_parameter_binding", "value": "workspaceId" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "versioned_binding", "resolution": "highest_precedence", "source": "versioned_parameter_binding", "value": "workspaceId" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "interface_description": "目标知识库的标识，选填。仅用于辅助构造返回的 docUrl，业务实际依赖 nodeId 定位节点；支持两种格式：1) 知识库 ID（纯字符串）；2) 知识库 URL，如 https://alidocs.dingtalk.com/i/spaces/{workspaceId}/overview，系统自动提取其中的 workspaceId。", "property": "workspaceId", "required": false, "type": "string" } }, "path": "doc.update_permission", "primary_cli_path": "doc permission update", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "更新文档协作者权限", "use_when": [ "变更文档节点上已有用户角色时" ] }, "doc.upload": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.upload", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc upload", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "live-mcp:none (Cobra+Skill; composite/unpinned)", "skills/mono/references/products/doc.md", "skills/mono/references/products/doc/doc-file-ops.md", "structured-hint:internal/cli/schema_hints/products/doc.json", "structured-hint:internal/cli/schema_hints/selection-review.json#doc.upload" ], "agent_summary": "兼容入口：上传本地文件到钉盘或文档空间；文件上传能力已迁移到 drive。", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "钉盘/我的文件上传优先 dws drive upload", "插入文档正文附件用 media insert" ], "canonical_path": "doc.upload", "cli_name": "upload", "cli_path": "doc upload", "confirmation": "not_required", "description": "将本地文件上传到钉钉文档或钉钉知识库（三步上传流程）。\n\n流程:\n 1. 获取 OSS 上传凭证 (get_file_upload_info)\n 2. HTTP PUT 上传文件二进制到 OSS\n 3. 提交文件入库 (commit_uploaded_file)\n\n上传位置优先级: --folder \u003e --workspace \u003e 默认 (我的文档根目录)", "display": "钉钉文档管理", "dry_run": { "preview_kind": "plan" }, "effect": "write", "effect_source": "agent-hint", "examples": [ "dws doc upload --file ./report.pdf --format json", "dws doc upload --file ./data.xlsx --workspace \u003cWS_ID\u003e --convert --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：上传本地文件到钉盘或文档空间；文件上传能力已迁移到 drive。" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "兼容入口：上传本地文件到钉盘或文档空间；文件上传能力已迁移到 drive。" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "钉盘/我的文件上传优先 dws drive upload", "插入文档正文附件用 media insert" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "钉盘/我的文件上传优先 dws drive upload", "插入文档正文附件用 media insert" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc upload", "value": "doc.upload" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc upload", "value": "doc.upload" }, "confirmation": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "risk-default", "value": "not_required" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "risk-default", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "将本地文件上传到钉钉文档或钉钉知识库（三步上传流程）。\n\n流程:\n 1. 获取 OSS 上传凭证 (get_file_upload_info)\n 2. HTTP PUT 上传文件二进制到 OSS\n 3. 提交文件入库 (commit_uploaded_file)\n\n上传位置优先级: --folder \u003e --workspace \u003e 默认 (我的文档根目录)" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "将本地文件上传到钉钉文档或钉钉知识库（三步上传流程）。\n\n流程:\n 1. 获取 OSS 上传凭证 (get_file_upload_info)\n 2. HTTP PUT 上传文件二进制到 OSS\n 3. 提交文件入库 (commit_uploaded_file)\n\n上传位置优先级: --folder \u003e --workspace \u003e 默认 (我的文档根目录)" }, "dry_run": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "reviewed positive dry-run capability", "selected": true, "source": "reviewed_dry_run_registry", "source_ref": "internal/cli/schema_dry_run_capabilities.go", "value": { "preview_kind": "plan" } } ], "precedence": "reviewed_explicit", "resolution": "exact_canonical_lookup", "review_reason": "reviewed positive dry-run capability", "source": "reviewed_dry_run_registry", "source_ref": "internal/cli/schema_dry_run_capabilities.go", "value": { "preview_kind": "plan" } }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" }, { "precedence": "inference_or_default", "selected": false, "source": "command-verb", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc upload --file ./report.pdf --format json", "dws doc upload --file ./data.xlsx --workspace \u003cWS_ID\u003e --convert --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc upload --file ./report.pdf --format json", "dws doc upload --file ./data.xlsx --workspace \u003cWS_ID\u003e --convert --format json" ] }, "idempotency": { "candidates": [ { "precedence": "inference_or_default", "selected": true, "source": "effect-default", "value": "unknown" } ], "precedence": "inference_or_default", "resolution": "highest_precedence", "source": "effect-default", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref" }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/doc.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" }, { "precedence": "inference_or_default", "selected": false, "source": "effect-default", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "上传文件到钉钉文档或钉钉知识库" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "上传文件到钉钉文档或钉钉知识库" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "把本地文件上传到文档空间/知识库（可 --convert 转在线文档）时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "把本地文件上传到文档空间/知识库（可 --convert 转在线文档）时" ] } }, "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "命令包含多个 RPC、条件分派或本地 HTTP/文件步骤，不能绑定为单一 interface_ref", "is_alias": false, "name": "upload", "parameter_count": 5, "parameters": { "convert": { "description": "是否转换为钉钉在线文档", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "是否转换为钉钉在线文档" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "是否转换为钉钉在线文档" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "convert" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "convert" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "boolean" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "boolean" } }, "property": "convert", "required": false, "type": "boolean" }, "file": { "description": "本地文件路径 (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "本地文件路径 (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "本地文件路径 (必填)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "file" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "file" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "file", "required": true, "type": "string" }, "folder": { "description": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标文档文件夹 nodeId 或 alidocs 文件夹 URL；不要传 drive dentryId/parent-id" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "folder" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "folder" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "folder", "required": false, "type": "string" }, "name": { "description": "文件显示名称 (默认使用文件名)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文件显示名称 (默认使用文件名)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文件显示名称 (默认使用文件名)" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "name" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "name" }, "required": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_nonzero_default", "value": false }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_nonzero_default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "name", "required": false, "type": "string" }, "workspace": { "description": "目标知识库 ID", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标知识库 ID" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标知识库 ID" }, "property": { "candidates": [ { "precedence": "inference", "selected": true, "source": "flag_name_inference", "value": "workspace" } ], "precedence": "inference", "resolution": "highest_precedence", "source": "flag_name_inference", "value": "workspace" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "property": "workspace", "required": false, "type": "string" } }, "path": "doc.upload", "primary_cli_path": "doc upload", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "上传文件到钉钉文档或钉钉知识库", "use_when": [ "把本地文件上传到文档空间/知识库（可 --convert 转在线文档）时" ] }, "doc.version_list": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.version_list", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc version list", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "live-mcp:dws schema doc.list_doc_versions", "structured-hint:internal/cli/schema_hints/products/doc.json" ], "agent_summary": "查看文档历史版本列表", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "回滚用 version revert（需确认）；保存快照用 version save" ], "canonical_path": "doc.version_list", "cli_name": "list", "cli_path": "doc version list", "confirmation": "not_required", "description": "查看文档历史版本列表", "display": "钉钉文档管理", "effect": "read", "effect_source": "agent-hint", "examples": [ "dws doc version list --node \u003cDOC_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "查看文档历史版本列表" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "查看文档历史版本列表" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "回滚用 version revert（需确认）；保存快照用 version save" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "回滚用 version revert（需确认）；保存快照用 version save" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc version list", "value": "doc.version_list" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc version list", "value": "doc.version_list" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查看文档历史版本列表" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查看文档历史版本列表" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "read" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "read" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc version list --node \u003cDOC_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc version list --node \u003cDOC_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "idempotent" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "idempotent" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/doc.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "low" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "low" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "查看文档历史版本列表" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "查看文档历史版本列表" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "查看文档历史版本列表以确认版本号时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "查看文档历史版本列表以确认版本号时" ] } }, "group": "version", "has_parameters": true, "idempotency": "idempotent", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "version_list", "parameter_count": 3, "parameters": { "cursor": { "description": "分页游标", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "分页游标" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "分页游标" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.version_list has no singular pinned interface_ref; --cursor is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "cursor" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.version_list has no singular pinned interface_ref; --cursor is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": false, "type": "string" }, "limit": { "description": "返回版本数量上限", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "返回版本数量上限" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "返回版本数量上限" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.version_list has no singular pinned interface_ref; --limit is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "limit" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.version_list has no singular pinned interface_ref; --limit is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": false } ], "precedence": "default", "resolution": "fallback", "source": "default", "value": false }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "required": false, "type": "integer" }, "node": { "description": "文档 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.version_list has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.version_list has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" } }, "path": "doc.version_list", "primary_cli_path": "doc version list", "product_id": "doc", "reviewed": true, "risk": "low", "source": "reviewed_command_registry", "title": "查看文档历史版本列表", "use_when": [ "查看文档历史版本列表以确认版本号时" ] }, "doc.version_revert": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.version_revert", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc version revert", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "live-mcp:dws schema doc.revert_doc_version", "structured-hint:internal/cli/schema_hints/products/doc.json" ], "agent_summary": "将文档回滚到指定历史版本", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "只看版本列表用 version list；保存快照用 save", "版本号未确认或用户未同意回滚时不要执行" ], "canonical_path": "doc.version_revert", "cli_name": "revert", "cli_path": "doc version revert", "confirmation": "user_required", "description": "回滚文档到指定版本", "display": "钉钉文档管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws doc version revert --node \u003cDOC_ID\u003e --version 3 --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "将文档回滚到指定历史版本" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "将文档回滚到指定历史版本" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "只看版本列表用 version list；保存快照用 save", "版本号未确认或用户未同意回滚时不要执行" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "只看版本列表用 version list；保存快照用 save", "版本号未确认或用户未同意回滚时不要执行" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc version revert", "value": "doc.version_revert" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc version revert", "value": "doc.version_revert" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "user_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "user_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "回滚文档到指定版本" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "回滚文档到指定版本" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc version revert --node \u003cDOC_ID\u003e --version 3 --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc version revert --node \u003cDOC_ID\u003e --version 3 --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "unknown" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/doc.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "dws-tool-metadata/doc marks this tool as reviewed", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "回滚文档到指定版本" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "回滚文档到指定版本" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户明确要求将 adoc 回滚到指定历史版本（已从 version list 确认版本号）时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "用户明确要求将 adoc 回滚到指定历史版本（已从 version list 确认版本号）时" ] } }, "group": "version", "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "version_revert", "parameter_count": 2, "parameters": { "node": { "description": "文档 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.version_revert has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.version_revert has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" }, "version": { "description": "目标版本号 (必填，从 list 获取)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "目标版本号 (必填，从 list 获取)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "目标版本号 (必填，从 list 获取)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.version_revert has no singular pinned interface_ref; --version is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "version" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.version_revert has no singular pinned interface_ref; --version is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "integer" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "integer" } }, "required": true, "type": "integer" } }, "path": "doc.version_revert", "primary_cli_path": "doc version revert", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "回滚文档到指定版本", "use_when": [ "用户明确要求将 adoc 回滚到指定历史版本（已从 version list 确认版本号）时" ] }, "doc.version_save": { "agent_metadata_source": "embedded-skill-metadata", "agent_source_refs": [ "CommandRegistry:canonical_path=doc.version_save", "Skill:skills/mono/references/products/doc.md", "cobra-help:dws doc version save", "internal/cli/schema_hints/metadata/doc.json", "internal/cli/schema_hints/selection/doc.json", "live-mcp:dws schema doc.save_doc_version", "structured-hint:internal/cli/schema_hints/products/doc.json" ], "agent_summary": "手动保存文档版本快照", "agent_summary_source": "dws-agent-selection/doc", "availability": "available", "avoid_when": [ "回滚用 revert；只看历史用 list" ], "canonical_path": "doc.version_save", "cli_name": "save", "cli_path": "doc version save", "confirmation": "not_required", "description": "手动保存文档版本快照", "display": "钉钉文档管理", "effect": "write", "effect_source": "agent-hint", "examples": [ "dws doc version save --node \u003cDOC_ID\u003e --format json" ], "field_provenance": { "agent_summary": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": "手动保存文档版本快照" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": "手动保存文档版本快照" }, "availability": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "available" }, "avoid_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "回滚用 revert；只看历史用 list" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "回滚用 revert；只看历史用 list" ] }, "canonical_path": { "candidates": [ { "precedence": "command_registry", "selected": true, "source": "reviewed_command_registry", "source_ref": "doc version save", "value": "doc.version_save" } ], "precedence": "command_registry", "resolution": "registry_identity", "source": "reviewed_command_registry", "source_ref": "doc version save", "value": "doc.version_save" }, "confirmation": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "not_required" }, "description": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "手动保存文档版本快照" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "手动保存文档版本快照" }, "effect": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "write" }, "examples": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc version save --node \u003cDOC_ID\u003e --format json" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "dws doc version save --node \u003cDOC_ID\u003e --format json" ] }, "idempotency": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "unknown" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "unknown" }, "interface_mode": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "composite" }, "interface_reason": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command." }, "interface_ref": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": null } ], "precedence": "reviewed_explicit", "resolution": "interface_disposition_matrix", "review_reason": "final interface mode composite forbids a direct MCP interface_ref", "source": "internal/cli/schema_hints/metadata/doc.json", "value": null }, "reviewed": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": false, "source": "internal/cli/schema_hints/selection/doc.json", "value": true } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": true }, "risk": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "migrated to reviewed metadata block", "selected": true, "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "migrated to reviewed metadata block", "source": "internal/cli/schema_hints/metadata/doc.json", "value": "medium" }, "title": { "candidates": [ { "precedence": "cobra_help", "selected": true, "source": "cobra_help", "value": "手动保存文档版本快照" } ], "precedence": "cobra_help", "resolution": "highest_precedence", "source": "cobra_help", "value": "手动保存文档版本快照" }, "use_when": { "candidates": [ { "precedence": "reviewed_explicit", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "selected": true, "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "手动保存当前文档版本快照时" ] } ], "precedence": "reviewed_explicit", "resolution": "highest_precedence", "review_reason": "人工审阅：结合本机 dws schema 实时 MCP description/parameters（经 interface_ref）、产品 Skill、Cobra Long 与 Runtime 确认门禁，按飞书风格重写选型文案；不改变命令身份、参数契约或接口绑定。", "source": "internal/cli/schema_hints/selection/doc.json", "value": [ "手动保存当前文档版本快照时" ] } }, "group": "version", "has_parameters": true, "idempotency": "unknown", "interface_mode": "composite", "interface_reason": "Reviewed unpinned remote adapter: this executable CLI wrapper calls a remote helper that is absent from the pinned MCP metadata snapshot; no single pinned semantically equivalent interface_ref can represent the command.", "is_alias": false, "name": "version_save", "parameter_count": 1, "parameters": { "node": { "description": "文档 ID 或 URL (必填)", "field_provenance": { "description": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, { "precedence": "default", "selected": false, "source": "default", "value": "" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_usage", "value": "文档 ID 或 URL (必填)" }, "property": { "candidates": [ { "precedence": "reviewed_mapping_exclusion", "review_reason": "Reviewed unpinned adapter: doc.version_save has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "selected": true, "source": "reviewed_mapping_exclusion", "value": "" }, { "precedence": "inference", "selected": false, "source": "flag_name_inference", "value": "node" } ], "precedence": "reviewed_mapping_exclusion", "resolution": "highest_precedence", "review_reason": "Reviewed unpinned adapter: doc.version_save has no singular pinned interface_ref; --node is a CLI wrapper input and does not publish a direct interface property.", "source": "reviewed_mapping_exclusion", "value": "" }, "required": { "candidates": [ { "precedence": "inference", "selected": true, "source": "usage_required_inference", "value": true }, { "precedence": "default", "selected": false, "source": "default", "value": false } ], "precedence": "inference", "resolution": "highest_precedence", "source": "usage_required_inference", "value": true }, "required_when": { "candidates": [ { "precedence": "default", "selected": true, "source": "default", "value": "" } ], "precedence": "default", "resolution": "highest_precedence", "source": "default", "value": "" }, "type": { "candidates": [ { "precedence": "cobra_contract", "selected": true, "source": "cobra_flag_type", "value": "string" } ], "precedence": "cobra_contract", "resolution": "highest_precedence", "source": "cobra_flag_type", "value": "string" } }, "required": true, "type": "string" } }, "path": "doc.version_save", "primary_cli_path": "doc version save", "product_id": "doc", "reviewed": true, "risk": "medium", "source": "reviewed_command_registry", "title": "手动保存文档版本快照", "use_when": [ "手动保存当前文档版本快照时" ] } } }