钉钉文档技能

负责钉钉知识库和文档的所有操作。本文件为策略指南，仅包含决策逻辑和工作流程。完整 API 请求格式见文末「references/api.md 查阅索引」。

dt_helper.sh 位于本 SKILL.md 同级目录的 scripts/dt_helper.sh。

核心概念

• 知识库（Workspace）：文档容器，有 workspaceId 和 rootNodeId
• 节点（Node）：文件或文件夹，type 为 FILE 或 FOLDER
• 文档标识（用于 /v1.0/doc/suites/documents/{id}）：可用 docKey 或 dentryUuid
  • 创建文档响应会返回：docKey、dentryUuid、nodeId
  • 其中 docKey / dentryUuid 可用于读写正文；nodeId 用于删除和文档管理类接口
  • wiki/nodes 返回的 nodeId 实际上是 dentryUuid，可直接用于正文读写
• operatorId：所有接口必须的 unionId 参数，通过 bash scripts/dt_helper.sh --to-unionid 自动转换