dingtalk-document

负责钉钉知识库和文档的所有操作。本文件为 策略指南 ，仅包含决策逻辑和工作流程。完整 API 请求格式见文末「references/api.md 查阅索引」。 dt_helper.sh 位于本 SKILL.md 同级目录的 scripts/dt_helper.sh 。 规则：未通过“本次任务配置校验”前，不得进入 API 调用步骤。 凭证禁止在输出中完整打印，确认时仅显示前 4 位 + **** Token 失效处理 ：dt_helper 仅按时间缓存，无法感知 token 被提前吊销。若 API 返回 401（token 无效/过期），用 --nocache 跳过缓存强制重新获取： 确定好要做什么之后，用以下命令从 references/api.md 中提取对应章节的完整 API 细节（请求格式、参数说明、返回值示例）： - 知识库（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 自动转换 - 先识别本次任务类型 → 例如：列知识库、读文档、写文档、创建文档、成员管理 - 按本次任务校验所需配置 → 通过 bash scripts/dt_helper.sh --get KEY 读取；仅校验本任务必须项 - 仅收集缺失配置 → 若缺少某项， 一次性询问用户 所有缺失值，用 bash scripts/dt_helper.sh --set KEY=VALUE 写入 - 获取 Token / operatorId → 直接调用 bash scripts/dt_helper.sh ，token 获取与缓存细节无需关心 - 执行操作 → 凡是包含变量替换、管道或多行逻辑的命令，写入 /tmp/ .sh 再 bash /tmp/ .sh 执行。不要把多行命令直接粘到终端里（终端工具会截断），也不要用 <<'EOF' 语法（heredoc 在工具中同样会被截断导致变量丢失） - 所有任务通用必需 ： DINGTALK_APP_KEY 、 DINGTALK_APP_SECRET 、 DINGTALK_MY_USER_ID - 涉及任何文档/知识库 API 调用 ：必须有 DINGTALK_MY_OPERATOR_ID （若缺失，先用 bash scripts/dt_helper.sh --to-unionid 自动转换并写回） - 创建/读取/写入/删除/成员管理 ：除上述通用项外，无额外固定配置键； workspaceId / nodeId / docKey...