玉澜
ec59f7b042
Restore dynamic dws schema on top of upstream static-endpoint runtime (v1.0.52) without re-introducing service discovery: - port schema runtime (runtime_schema/schema_catalog/schema_agent_metadata/ schema_hints) + embedded agent & interface metadata + ir data structures - ir/catalog.go: drop discovery-dependent BuildCatalog, keep runtime types - canonical.go NewSchemaCommand: build schema from the live Cobra tree via runtimeSchemaPayload instead of the stub - add schema_support.go and design doc docs/schema-dynamic-endpoint-design.md go build ./... passes; go test ./... 44 packages pass (only unrelated post-goreleaser packaging tests fail with a known tar format issue).
676 lines
30 KiB
JSON
676 lines
30 KiB
JSON
{
|
||
"product_id": "doc",
|
||
"tools": {
|
||
"doc block delete": {
|
||
"agent_summary": "删除块元素（不可逆）",
|
||
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
|
||
"use_when": [
|
||
"删除（无需 format 区分）",
|
||
"删除（用户确认后）",
|
||
"编辑块/改段落/插入标题/删除块；删除"
|
||
],
|
||
"effect": "destructive",
|
||
"effect_source": "skill-explicit",
|
||
"risk": "high",
|
||
"confirmation": "user_required",
|
||
"examples": [
|
||
"dws doc block delete --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --yes",
|
||
"dws doc block delete --node DOC_ID --block-id UUID"
|
||
],
|
||
"source_refs": [
|
||
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.delete_document_block",
|
||
"skills/mono/SKILL.md",
|
||
"skills/mono/references/products/doc.md",
|
||
"skills/mono/references/products/doc/doc-block.md",
|
||
"skills/mono/schema-hints/imported/wukong.json"
|
||
]
|
||
},
|
||
"doc block insert": {
|
||
"agent_summary": "将一个新的块元素插入指定文档，需要提供文档ID(dentryUuid)与块元素内容(必须包含 blockType 及对应类型的属性对象)。",
|
||
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
|
||
"use_when": [
|
||
"Callout（element JSON 次选；首选 JSONML container[subType=colorBlocks]）",
|
||
"分栏（2 栏）",
|
||
"单元格内含多段落 + 代码块",
|
||
"在指定 block 之前插入",
|
||
"在某个 block 后插入",
|
||
"容器内定位插入（指定 parent + index）",
|
||
"嵌入文件预览",
|
||
"带格式文本（多个 leaf）",
|
||
"带链接（link 是与 text 并列的子节点）",
|
||
"引用块",
|
||
"待办列表（checkbox）",
|
||
"插入 JSONML 节点（同级定位）",
|
||
"插入 JSONML 节点（容器内定位）",
|
||
"插入分栏块(columns)：2 栏，children 为每栏的内容",
|
||
"插入复杂块（callout / 分栏）—— element 默认按 JSON 解析",
|
||
"插入引用块(blockquote)",
|
||
"插入段落（同级定位）",
|
||
"插入行内图片(inline image)：构造一个空 paragraph，在 children 中用 image elementType 指定图片 src",
|
||
"插入表格(table)：2 行 3 列",
|
||
"插入附件块(attachment)：resourceId 为资源ID，type 为 MIME 类型，viewType 可选 preview/summary",
|
||
"文本段落",
|
||
"无序列表项",
|
||
"有序列表项（仅第一项设 start，后续项不设，系统自动递增）",
|
||
"查看具体命令的完整参数说明",
|
||
"标题（level 1-6）",
|
||
"纯文本段落",
|
||
"编辑块/改段落/插入标题/删除块；插入",
|
||
"缩进子项（level: 1）",
|
||
"群名片",
|
||
"蓝色高亮块",
|
||
"表格（2x3）"
|
||
],
|
||
"effect": "write",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc block insert --help",
|
||
"dws doc block insert --node \u003cDOC_ID\u003e --text \"这是一段文字\""
|
||
],
|
||
"reviewed": false,
|
||
"source_refs": [
|
||
"internal/cli/schema_mcp_metadata.json#tools.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"
|
||
]
|
||
},
|
||
"doc block list": {
|
||
"agent_summary": "查询文档一级块元素列表",
|
||
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
|
||
"use_when": [
|
||
"1. 列出所有 block 拿到 uuid",
|
||
"1. 获取当前结构",
|
||
"2. 读单个 block 完整子树",
|
||
"── 工作流 3: 局部改写（保真，首选 JSONML）──",
|
||
"── 工作流 7: 评论 + 划词（@人 需 userId）──",
|
||
"划词评论（先 block list 取 blockId + paragraph.text，计算 start/end）",
|
||
"列出 + 取 uuid",
|
||
"列出所有 block，定位 BLOCK_ID",
|
||
"列出顶层 JSONML 节点",
|
||
"给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；如 URL 明显是文件夹",
|
||
"编辑块/改段落/插入标题/删除块；查看结构",
|
||
"读单个 block 完整子树",
|
||
"读取指定 uuid 的完整子树"
|
||
],
|
||
"effect": "read",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc block list --node \u003cDOC_ID\u003e --content-format jsonml # 1. 取 uuid",
|
||
"dws doc block list --node \u003cDOC_ID\u003e --content-format jsonml --block-id \u003cUUID\u003e # 2. 读子树"
|
||
],
|
||
"source_refs": [
|
||
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#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",
|
||
"skills/mono/schema-hints/imported/wukong.json"
|
||
]
|
||
},
|
||
"doc block update": {
|
||
"agent_summary": "更新指定文档的指定块元素内容或样式，需要提供文档ID(dentryUuid)、块元素ID(blockId)与块元素内容(必须包含 blockType 及对应类型的属性对象)。",
|
||
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
|
||
"use_when": [
|
||
"2. 修改后写回（uuid 不变）",
|
||
"3. 改完后写回（uuid 必须 == --block-id）",
|
||
"── 工作流 3: 局部改写（保真，首选 JSONML）──",
|
||
"修改某块文本",
|
||
"修改标题",
|
||
"改一个 block 的文本",
|
||
"整体替换（update 时 uuid 必须等于 --block-id）",
|
||
"整体替换（update 的 uuid 必须等于 --block-id）",
|
||
"更新已有标题",
|
||
"给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；\"把正文里的一级标题/章节标题改成 X",
|
||
"编辑块/改段落/插入标题/删除块；修改"
|
||
],
|
||
"effect": "write",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc block update --node \u003cDOC_ID\u003e --block-id \u003cUUID\u003e --content-format jsonml --element '[...]' # 3. 写回（uuid 必须 == --block-id）",
|
||
"dws doc block update --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --text \"新内容\""
|
||
],
|
||
"reviewed": false,
|
||
"source_refs": [
|
||
"internal/cli/schema_mcp_metadata.json#tools.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"
|
||
]
|
||
},
|
||
"doc comment create": {
|
||
"agent_summary": "创建文档评论",
|
||
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
|
||
"use_when": [
|
||
"── 工作流 7: 评论 + 划词（@人 需 userId）──",
|
||
"创建全文评论",
|
||
"提取 userId 后:"
|
||
],
|
||
"effect": "write",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc comment create --node \u003cDOC_ID\u003e --content \"请确认\" --mention \u003cuid\u003e --format json",
|
||
"dws doc comment create --node \u003cDOC_ID\u003e --content \"这里需要修改\""
|
||
],
|
||
"source_refs": [
|
||
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_comment",
|
||
"skills/mono/references/products/doc.md",
|
||
"skills/mono/references/products/doc/doc-comment.md",
|
||
"skills/mono/schema-hints/imported/wukong.json"
|
||
]
|
||
},
|
||
"doc comment create-inline": {
|
||
"agent_summary": "在钉钉文档中创建划词评论，评论关联文档内指定块的文本范围，支持 @提及用户。",
|
||
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
|
||
"use_when": [
|
||
"── 工作流 7: 评论 + 划词（@人 需 userId）──",
|
||
"划词评论 + 引用原文 + @人",
|
||
"计算偏移后："
|
||
],
|
||
"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 \"建议调整\" --selected-text \"原文\" --format json",
|
||
"dws doc comment create-inline --node \u003cDOC_ID\u003e --block-id \u003cBLOCK_ID\u003e --start 0 --end 10 --content \"这里需要修改\""
|
||
],
|
||
"reviewed": false,
|
||
"source_refs": [
|
||
"internal/cli/schema_mcp_metadata.json#tools.doc.create_inline_comment",
|
||
"skills/mono/references/products/doc.md",
|
||
"skills/mono/references/products/doc/doc-comment.md"
|
||
]
|
||
},
|
||
"doc comment list": {
|
||
"agent_summary": "查询文档评论列表",
|
||
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
|
||
"use_when": [
|
||
"仅看未解决的划词评论",
|
||
"查看文档全部评论"
|
||
],
|
||
"effect": "read",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc comment list --node \u003cDOC_ID\u003e",
|
||
"dws doc comment list --node \u003cDOC_ID\u003e --type inline --resolve-status unresolved"
|
||
],
|
||
"source_refs": [
|
||
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.list_comments",
|
||
"skills/mono/references/products/doc/doc-comment.md",
|
||
"skills/mono/schema-hints/imported/wukong.json"
|
||
]
|
||
},
|
||
"doc comment reply": {
|
||
"agent_summary": "回复文档评论",
|
||
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
|
||
"use_when": [
|
||
"文字回复",
|
||
"表情回复（--content 填表情名称）"
|
||
],
|
||
"effect": "write",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc comment reply --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"同意\"",
|
||
"dws doc comment reply --node \u003cDOC_ID\u003e --comment-key \u003cCOMMENT_KEY\u003e --content \"比心\" --emoji"
|
||
],
|
||
"source_refs": [
|
||
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.reply_comment",
|
||
"skills/mono/references/products/doc/doc-comment.md",
|
||
"skills/mono/schema-hints/imported/wukong.json"
|
||
]
|
||
},
|
||
"doc copy": {
|
||
"agent_summary": "将指定节点复制到目标文件夹。",
|
||
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
|
||
"use_when": [
|
||
"复制到指定文件夹（异步）",
|
||
"复制到目标知识库根目录"
|
||
],
|
||
"examples": [
|
||
"dws doc copy --node \u003cDOC_ID\u003e --folder \u003cTARGET_DOC_FOLDER_NODE_ID\u003e",
|
||
"dws doc copy --node \u003cDOC_ID\u003e --workspace \u003cTARGET_WS_ID\u003e"
|
||
],
|
||
"reviewed": false,
|
||
"source_refs": [
|
||
"internal/cli/schema_mcp_metadata.json#tools.doc.copy_document",
|
||
"skills/mono/references/products/doc/doc-file-ops.md"
|
||
]
|
||
},
|
||
"doc create": {
|
||
"agent_summary": "创建一篇新的在线文档",
|
||
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
|
||
"use_when": [
|
||
"JSONML 创建到指定文件夹",
|
||
"── 工作流 2: 创建文档（含分片自动写入）──",
|
||
"写文档/创建文档；新建文字文档（adoc）",
|
||
"创建到指定文件夹",
|
||
"创建到知识库",
|
||
"创建空文档（仅取 nodeId 后再分步写入，适合 \u003e200KB 兜底）",
|
||
"完整流程：创建文档 → 写入内容 → 插入附件",
|
||
"查看具体命令的完整参数说明",
|
||
"短纯文本字面量（\u003c 2KB 且无换行/表格才允许）",
|
||
"详见 doc-create-workflow.md §JSONML 起稿判定",
|
||
"默认创建到「我的文档」根目录（推荐文件路径）"
|
||
],
|
||
"effect": "write",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc create --help",
|
||
"dws doc create --name \"项目周报\" --content-file /tmp/x.md --folder \u003cDOC_FOLDER_NODE_ID\u003e --format json # 2. 创建 + 写入"
|
||
],
|
||
"source_refs": [
|
||
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_document",
|
||
"skills/mono/references/products/doc.md",
|
||
"skills/mono/references/products/doc/doc-create.md",
|
||
"skills/mono/references/products/doc/doc-media.md",
|
||
"skills/mono/schema-hints/imported/wukong.json"
|
||
]
|
||
},
|
||
"doc delete": {
|
||
"agent_summary": "将指定节点移入回收站，30 天内可从回收站恢复，超过 30 天将被永久删除。",
|
||
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
|
||
"use_when": [
|
||
"── delete（用户确认后才加 --yes）──"
|
||
],
|
||
"effect": "destructive",
|
||
"effect_source": "skill-explicit",
|
||
"risk": "high",
|
||
"confirmation": "user_required",
|
||
"examples": [
|
||
"dws doc delete --node \u003cDOC_ID\u003e --format json # 查询 nodeId: dws doc search --query \"...\" 或 dws doc list",
|
||
"dws doc delete --node \u003cDOC_ID_OR_URL\u003e --yes --format json"
|
||
],
|
||
"reviewed": false,
|
||
"source_refs": [
|
||
"internal/cli/schema_mcp_metadata.json#tools.doc.delete_document",
|
||
"skills/mono/SKILL.md",
|
||
"skills/mono/references/products/doc/doc-file-ops.md"
|
||
]
|
||
},
|
||
"doc download": {
|
||
"agent_summary": "获取文件下载凭证，供 AI Agent 自行发起 HTTP GET 请求下载文件内容。",
|
||
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
|
||
"use_when": [
|
||
"指定文件路径",
|
||
"自动推断文件名，下到目录"
|
||
],
|
||
"effect": "read",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc download --node \u003cNODE_ID\u003e",
|
||
"dws doc download --node \u003cNODE_ID\u003e --output ./report.pdf"
|
||
],
|
||
"reviewed": false,
|
||
"source_refs": [
|
||
"internal/cli/schema_mcp_metadata.json#tools.doc.download_file",
|
||
"skills/mono/references/products/doc/doc-file-ops.md"
|
||
]
|
||
},
|
||
"doc export get": {
|
||
"agent_summary": "用于查询通过 submit_export_job 提交的文字文档导出任务的执行状态，任务完成时返回文件下载链接。",
|
||
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
|
||
"use_when": [
|
||
"兜底：超时或中断后手动查任务"
|
||
],
|
||
"effect": "read",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc export get --job-id \u003cJOB_ID\u003e",
|
||
"dws doc export get --job-id \u003cJOB_ID\u003e --format json"
|
||
],
|
||
"reviewed": false,
|
||
"source_refs": [
|
||
"internal/cli/schema_mcp_metadata.json#tools.doc.query_export_job",
|
||
"skills/mono/references/products/doc/doc-export.md"
|
||
]
|
||
},
|
||
"doc file create": {
|
||
"agent_summary": "创建文件（文档/表格/脑图/白板/多维表/文件夹等）",
|
||
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
|
||
"effect": "write",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc file create --name \"项目周报\" --type adoc",
|
||
"dws doc file create --name \"数据统计\" --type axls --folder FOLDER_ID"
|
||
],
|
||
"source_refs": [
|
||
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_file",
|
||
"skills/mono/schema-hints/imported/wukong.json"
|
||
]
|
||
},
|
||
"doc folder create": {
|
||
"agent_summary": "创建文件夹",
|
||
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
|
||
"use_when": [
|
||
"在「我的文档」根目录创建",
|
||
"在指定父文件夹下创建",
|
||
"在知识库下创建"
|
||
],
|
||
"effect": "write",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc folder create --name \"项目资料\"",
|
||
"dws doc folder create --name \"子文件夹\" --folder \u003cPARENT_DOC_FOLDER_NODE_ID\u003e"
|
||
],
|
||
"source_refs": [
|
||
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.create_folder",
|
||
"skills/mono/references/products/doc/doc-file-ops.md",
|
||
"skills/mono/schema-hints/imported/wukong.json"
|
||
]
|
||
},
|
||
"doc info": {
|
||
"agent_summary": "获取文档元信息（标题/类型/创建者/权限等）",
|
||
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
|
||
"use_when": [
|
||
"alidocs URL 直传（CLI 自动解析）",
|
||
"document/edit URL 直传（必须完整 URL，禁止单独提取 dentryKey）",
|
||
"document/preview URL 直传",
|
||
"── 工作流 1: 定位并阅读文档 ──",
|
||
"── 工作流 6: 下载 vs 导出（先 info 判 contentType）──",
|
||
"❌ workspaceId（应作为 --workspace 用）",
|
||
"❌ 单独的 dentryKey（必须带完整 URL）",
|
||
"❌ 纯数字 dentryId（drive 链路）",
|
||
"标准用法（nodeId 直传）",
|
||
"看文档/读内容/文档内容；元信息",
|
||
"给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；\"这个文档的信息"
|
||
],
|
||
"effect": "read",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc info --node \u003cDOC_ID\u003e --format json # 2. 元信息（含 contentType）",
|
||
"dws doc info --node \u003cNODE_ID\u003e --format json # 必须先查 contentType"
|
||
],
|
||
"source_refs": [
|
||
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.get_document_info",
|
||
"skills/mono/references/products/doc.md",
|
||
"skills/mono/references/products/doc/doc-info.md",
|
||
"skills/mono/schema-hints/imported/wukong.json"
|
||
]
|
||
},
|
||
"doc list": {
|
||
"agent_summary": "遍历文件夹或知识库下的直接子节点",
|
||
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
|
||
"use_when": [
|
||
"浏览\"我的文档\"根目录",
|
||
"浏览指定文档文件夹（folder nodeId 或 alidocs 文件夹 URL）",
|
||
"浏览指定知识库根目录（取出 workspaceId 后）",
|
||
"翻页"
|
||
],
|
||
"effect": "read",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc list",
|
||
"dws doc list --folder \u003cDOC_FOLDER_NODE_ID\u003e"
|
||
],
|
||
"source_refs": [
|
||
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.list_nodes",
|
||
"skills/mono/references/products/doc/doc-list.md",
|
||
"skills/mono/schema-hints/imported/wukong.json"
|
||
]
|
||
},
|
||
"doc media download": {
|
||
"agent_summary": "获取钉钉文档中指定附件的临时下载 URL。",
|
||
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
|
||
"use_when": [
|
||
"下载文档中的附件（resourceId 从 block list 获取）",
|
||
"下载附件/获取附件/取出文档里的附件；下载附件"
|
||
],
|
||
"effect": "read",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc media download --node \u003cDOC_ID\u003e --resource-id \u003cRESOURCE_ID\u003e",
|
||
"dws doc media download --node \"https://alidocs.dingtalk.com/i/nodes/xxx\" --resource-id \u003cRESOURCE_ID\u003e"
|
||
],
|
||
"reviewed": false,
|
||
"source_refs": [
|
||
"internal/cli/schema_mcp_metadata.json#tools.doc.download_doc_attachment",
|
||
"skills/mono/references/products/doc.md",
|
||
"skills/mono/references/products/doc/doc-media.md"
|
||
]
|
||
},
|
||
"doc media insert": {
|
||
"use_when": [
|
||
"── 工作流 5: 上传独立文件 vs 插入附件到文档正文 ──",
|
||
"在指定块之前插入附件",
|
||
"基本用法：插入本地文件到文档",
|
||
"指定 MIME 类型（扩展名无法推断时）",
|
||
"指定附件显示名称",
|
||
"提取 nodeId 后:",
|
||
"插入图片/加图片/放张图/嵌入图片/往文档里插图；插入图片",
|
||
"插入附件/上传附件到文档/往文档里加文件/加附件；插入附件"
|
||
],
|
||
"effect": "write",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc media insert --node \u003cDOC_ID\u003e --file ./report.pdf # 上传并作为附件块插入正文（内容层）",
|
||
"dws doc media insert --node \u003cDOC_ID\u003e --file ./report.pdf"
|
||
],
|
||
"source_refs": [
|
||
"skills/mono/references/products/doc.md",
|
||
"skills/mono/references/products/doc/doc-media.md"
|
||
]
|
||
},
|
||
"doc move": {
|
||
"agent_summary": "将指定节点移动到目标文件夹。",
|
||
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
|
||
"use_when": [
|
||
"移动到指定文件夹",
|
||
"移动到知识库根目录"
|
||
],
|
||
"effect": "write",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc move --node \u003cDOC_ID\u003e --folder \u003cTARGET_DOC_FOLDER_NODE_ID\u003e",
|
||
"dws doc move --node \u003cDOC_ID\u003e --workspace \u003cTARGET_WS_ID\u003e"
|
||
],
|
||
"reviewed": false,
|
||
"source_refs": [
|
||
"internal/cli/schema_mcp_metadata.json#tools.doc.move_document",
|
||
"skills/mono/references/products/doc/doc-file-ops.md"
|
||
]
|
||
},
|
||
"doc permission add": {
|
||
"agent_summary": "为知识库下的节点（文档、文件夹、文件）添加指定角色的企业用户成员（仅支持 USER 类型）。",
|
||
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
|
||
"use_when": [
|
||
"给单人开 READER 权限",
|
||
"给多人开 EDITOR 权限（最多 30 个 uid）",
|
||
"设为管理者",
|
||
"通过 alidocs URL 直接授权"
|
||
],
|
||
"effect": "write",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc permission add --node \u003cDOC_ID\u003e --user uid1 --role READER",
|
||
"dws doc permission add --node \u003cDOC_ID\u003e --user uid1,uid2 --role EDITOR"
|
||
],
|
||
"reviewed": false,
|
||
"source_refs": [
|
||
"internal/cli/schema_mcp_metadata.json#tools.doc.add_permission",
|
||
"skills/mono/references/products/doc/doc-permission.md"
|
||
]
|
||
},
|
||
"doc permission list": {
|
||
"agent_summary": "查询知识库节点当前的成员权限列表。",
|
||
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
|
||
"use_when": [
|
||
"拉取更多结果（默认 50，最大 200）",
|
||
"按角色过滤查看",
|
||
"查看谁有权限"
|
||
],
|
||
"effect": "read",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc permission list --node \u003cDOC_ID\u003e",
|
||
"dws doc permission list --node \u003cDOC_ID\u003e --max-results 50"
|
||
],
|
||
"reviewed": false,
|
||
"source_refs": [
|
||
"internal/cli/schema_mcp_metadata.json#tools.doc.list_permission",
|
||
"skills/mono/references/products/doc/doc-permission.md"
|
||
]
|
||
},
|
||
"doc permission remove": {
|
||
"agent_summary": "从知识库节点移除指定企业用户的权限（仅支持 USER 类型）。",
|
||
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
|
||
"effect": "destructive",
|
||
"effect_source": "agent-hint",
|
||
"risk": "high",
|
||
"confirmation": "user_required",
|
||
"reviewed": false,
|
||
"source_refs": [
|
||
"internal/cli/schema_mcp_metadata.json#tools.doc.remove_permission",
|
||
"skills/mono/schema-hints/destructive-safety.json"
|
||
]
|
||
},
|
||
"doc permission update": {
|
||
"agent_summary": "修改企业用户在知识库节点上的角色（仅支持 USER 类型）。",
|
||
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
|
||
"use_when": [
|
||
"修改某人角色（READER → EDITOR）"
|
||
],
|
||
"effect": "write",
|
||
"effect_source": "skill-explicit",
|
||
"risk": "high",
|
||
"confirmation": "user_required",
|
||
"examples": [
|
||
"dws doc permission update --node \u003cDOC_ID\u003e --user uid1 --role EDITOR",
|
||
"dws doc permission update --node \u003cDOC_ID\u003e --user uid1,uid2 --role READER"
|
||
],
|
||
"reviewed": false,
|
||
"source_refs": [
|
||
"internal/cli/schema_mcp_metadata.json#tools.doc.update_permission",
|
||
"skills/mono/SKILL.md",
|
||
"skills/mono/references/products/doc/doc-permission.md"
|
||
]
|
||
},
|
||
"doc read": {
|
||
"agent_summary": "读取文档内容（Markdown）",
|
||
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
|
||
"use_when": [
|
||
"1. 读出完整 JSONML 结构（输出含 revision，普通改写场景下不需要）",
|
||
"JSONML 完整结构 → 文件（无损改写前置）",
|
||
"alidocs URL 直传",
|
||
"── 工作流 1: 定位并阅读文档 ──",
|
||
"── 工作流 2: 创建文档（含分片自动写入）──",
|
||
"── 工作流 3: 局部改写（保真，首选 JSONML）──",
|
||
"── 工作流 4: 整篇 overwrite（仅在新骨架重写时）──",
|
||
"修改 /tmp/doc.json 中的 jsonml 数组",
|
||
"查看具体命令的完整参数说明",
|
||
"看文档/读内容/文档内容；读取",
|
||
"给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；\"帮我看看这个文档",
|
||
"给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；默认",
|
||
"默认 Markdown 输出（最常用）"
|
||
],
|
||
"effect": "read",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc read --help",
|
||
"dws doc read --node \u003cDOC_ID\u003e --format json # 3. 读 markdown 正文"
|
||
],
|
||
"source_refs": [
|
||
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#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",
|
||
"skills/mono/schema-hints/imported/wukong.json"
|
||
]
|
||
},
|
||
"doc rename": {
|
||
"agent_summary": "对指定节点进行重命名。",
|
||
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
|
||
"use_when": [
|
||
"── rename ──"
|
||
],
|
||
"effect": "write",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc rename --node \u003cDOC_ID\u003e --name \"新名称\"",
|
||
"dws doc rename --node \"https://alidocs.dingtalk.com/i/nodes/\u003cDOC_UUID\u003e\" --name \"项目周报 v2\""
|
||
],
|
||
"reviewed": false,
|
||
"source_refs": [
|
||
"internal/cli/schema_mcp_metadata.json#tools.doc.rename_document",
|
||
"skills/mono/references/products/doc/doc-file-ops.md"
|
||
]
|
||
},
|
||
"doc search": {
|
||
"agent_summary": "搜索文档（不传关键词返回最近访问）",
|
||
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
|
||
"use_when": [
|
||
"仅最近访问（不传 --query）",
|
||
"关键字搜索（最常用）",
|
||
"按创建时间窗口（毫秒时间戳）",
|
||
"按创建者过滤（多个 uid 逗号分隔）",
|
||
"按扩展名过滤（在线文档族 + 常见办公附件）",
|
||
"按知识库范围过滤（支持知识库 URL）",
|
||
"翻页"
|
||
],
|
||
"effect": "read",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc search --query \"会议纪要\"",
|
||
"dws doc search"
|
||
],
|
||
"source_refs": [
|
||
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#doc.search_documents",
|
||
"skills/mono/references/products/doc/doc-search.md",
|
||
"skills/mono/schema-hints/imported/wukong.json"
|
||
]
|
||
},
|
||
"doc update": {
|
||
"agent_summary": "更新文档内容（追加 / 覆盖）",
|
||
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
|
||
"use_when": [
|
||
"2. 一步写入：",
|
||
"2. 逐个追加：",
|
||
"4. 提交修改（默认直接覆盖，不做并发检查）",
|
||
"JSONML 整篇无损 overwrite（默认不做并发检查；并发敏感时加 --revision \u003cN\u003e）",
|
||
"append 到指定 block 前（index 通过 doc block list 获取）",
|
||
"append 末尾追加",
|
||
"heredoc（真实换行，含表格）",
|
||
"overwrite 整段（用户已确认）",
|
||
"stdin（heredoc，含表格）",
|
||
"修改 /tmp/doc.json 中的 jsonml 数组",
|
||
"写文档/创建文档；覆盖替换",
|
||
"写文档/创建文档；追加内容",
|
||
"插入分割线：使用 doc update --mode append 以 Markdown 格式追加",
|
||
"短文本字面量（\u003c2KB 无换行）",
|
||
"给某人开权限/分享给某人/授权某文档/把这篇文档给 xxx 看；\"往这个文档追加内容"
|
||
],
|
||
"effect": "write",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc update --node \u003cDOC_ID\u003e --content-file /tmp/doc.json --content-format jsonml --mode overwrite # 2. 写回（默认不做并发检查）",
|
||
"dws doc update --node \u003cDOC_ID\u003e --content \"---\" --mode append"
|
||
],
|
||
"source_refs": [
|
||
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.doc.prod.json#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",
|
||
"skills/mono/schema-hints/imported/wukong.json"
|
||
]
|
||
},
|
||
"doc upload": {
|
||
"use_when": [
|
||
"上传到「我的文档」根目录",
|
||
"上传到指定文件夹",
|
||
"上传到知识库并转换为在线文档"
|
||
],
|
||
"effect": "write",
|
||
"effect_source": "command-verb",
|
||
"examples": [
|
||
"dws doc upload --file ./report.pdf",
|
||
"dws doc upload --file ./slides.pptx --name \"Q1汇报.pptx\" --folder \u003cDOC_FOLDER_NODE_ID\u003e"
|
||
],
|
||
"source_refs": [
|
||
"skills/mono/references/products/doc/doc-file-ops.md"
|
||
]
|
||
}
|
||
}
|
||
}
|