核心功能与用法
dingtalk-document 是钉钉生态系统的官方文档管理技能，提供企业级知识库与文档的全生命周期管理能力。核心功能覆盖四大维度：
1. 知识库管理：支持创建知识库（Workspace）、查询知识库列表及基础信息，每个知识库具备独立的 workspaceId 和 rootNodeId 标识体系。
2. 文档操作：完整支持新建文档/文件夹、读取文档正文内容、覆盖写入、追加文本到段落、删除文档等操作。文档标识采用双轨制：docKey/dentryUuid 用于内容读写，nodeId 用于删除和权限管理。
3. 权限管控：提供成员添加、权限更新（读写/只读等）、成员移除等细粒度权限管理能力，适配企业协作的安全需求。
4. 身份体系：自动处理 userId（企业员工ID）与 unionId（跨企业唯一标识）的转换，通过 dt_helper.sh 脚本屏蔽底层 token 获取与缓存细节。
显著优点
- 官方原生能力：直接调用钉钉开放平台 API，非第三方封装，功能完整性与接口稳定性有官方保障
- 企业级权限模型：支持知识库级和文档级的双层权限控制，满足复杂组织架构需求
- 自动化凭证管理：内置 token 自动获取、缓存与失效重刷机制，降低运维成本
- 脚本化工作流：通过
dt_helper.sh将多步操作（身份转换→token获取→API调用）封装为原子能力，便于编排复杂任务
潜在局限与风险
- 配置门槛较高：需预先申请钉钉企业应用，配置
DINGTALK_APP_KEY/SECRET及员工ID，个人用户难以直接使用 - 依赖企业网络环境：部分企业可能限制外部 API 调用或需要 IP 白名单
- Token 吊销盲区： helper 仅按时间缓存，无法感知钉钉侧的 token 主动吊销，需依赖
--nocache手动兜底 - heredoc 与多行命令限制：技能明确禁止直接使用
<<'EOF'语法，复杂逻辑需写入临时脚本执行
适用人群
- 企业IT管理员：需要批量管理企业知识资产、迁移历史文档
- 研发团队：构建基于钉钉文档的自动化工作流（如日报生成、会议纪要归档）
- 数字化转型顾问：为客户实施钉钉生态集成方案
常规风险提示
凭证（APP_SECRET、token）严禁在输出中完整打印，确认时仅显示前4位。所有操作以 operatorId（unionId）为执行主体，需确保该身份在目标知识库/文档中具有对应权限，否则 API 将返回权限错误。