用途:管理钉钉知识库(wiki)容器、库内节点、成员、分享范围与动态。仅当用户明确提到知识库/wiki、命名的团队知识空间、个人知识库、知识库成员或库内节点操作时触发;仅说“文档空间/我的文档”不触发,普通存储管理与全局文件搜索走 dingtalk-drive,节点正文读写走 Doc。
主要能力:按名称解析唯一知识库;搜索或列出知识库(+space-search、+space-list);查看空间详情(+space-get);创建或删除知识库(+space-create、+delete-space);浏览或搜索库内节点(+node-list、+node-search);查看节点元数据(+node-get);创建节点(+node-create,支持 adoc/axls/able/appt/adraw/amind/folder);复制、移动、移出到“我的文档”(+node-copy、+move、+move-to-drive);删除节点(+node-delete);成员列表与增改删(member list、+member-add、+member-update、+member-remove);设置空间分享范围(permission set-share-scope);查看知识库动态(+feed-list)。
使用方式:只用 dws 命令,结构化读取加 --format json。已知命令直调;参数或约束不明时查 leaf 窄 Schema,Schema 不可用才读一次已知 leaf Help。写操作须符合明确意图,确认后才加 --yes,写后验证结果,不凭退出码宣称成功。ID 来自真实返回,不猜命令、flag、字段或 ID;workspaceId、nodeId、folderId、userId 不互相替代,名称不能当 ID。多账号只用唯一 isOrgCurrent=true。
适用场景:按名称查找并解析知识库、在指定知识库下新建文档节点、库内节点复制移动删除、成员与分享范围管理、查看知识库动态,以及“本地文件→新知识库→我的文档”等有序跨产品流程。
限制:+space-list/+node-list/+node-search/+feed-list 默认单页,全量需显式加 --page-all 并检查分页元数据;+space-search、+resolve-space 的单页结果不能证明全局唯一,不得直接用于写入。成员列表服务端无续页游标且最多 50,不能宣称为全量;成员写 users 为 1-30 个,角色仅 MANAGER|EDITOR|DOWNLOADER|READER。删除整个空间为高风险操作。不输出或记录 token、refresh token、appSecret、webhook token。部分失败、分页未完成或写入效果未知都不算成功。具体收费、价格与平台信息暂未提供。