用途:负责钉钉知识库和文档的相关操作,包括列知识库、查看节点目录、读取文档内容、创建文档、覆盖写入或追加内容、删除文档以及文档成员管理。资料为策略指南,完整 API 请求格式需查阅 references/api.md。
核心概念:知识库(Workspace)为文档容器,含 workspaceId 和 rootNodeId;节点(Node)为文件或文件夹,type 为 FILE 或 FOLDER;文档读写可用 docKey 或 dentryUuid,nodeId 用于删除和文档管理类接口;operatorId 为所有接口必需的 unionId 参数,可通过 bash scripts/dt_helper.sh --to-unionid 自动转换。
使用方式:每次执行前先识别任务类型,再用 bash scripts/dt_helper.sh --get KEY 校验本任务必需配置,缺失项一次性询问并写入。通用必需配置为 DINGTALK_APP_KEY、DINGTALK_APP_SECRET、DINGTALK_MY_USER_ID;涉及文档或知识库 API 调用还需 DINGTALK_MY_OPERATOR_ID。随后调用 dt_helper.sh 获取 Token 与 operatorId 并执行操作。含变量替换、管道或多行逻辑的命令应写入 /tmp/<task>.sh 再执行,避免终端截断。
限制:未通过配置校验前不得调用 API;凭证禁止在输出中完整打印,确认时仅显示前 4 位加 ****;Token 按时间缓存,若 API 返回 401 可用 --token --nocache 强制重新获取。各项接口的具体参数、返回值与所需应用权限在资料中未展开,需按索引从 references/api.md 提取。