核心功能
钉钉文档技能（dingtalk-document）是一款面向企业场景的知识管理工具，基于钉钉开放平台官方API实现，提供知识库与文档的完整操作能力：
核心能力覆盖
- 知识库管理：创建知识库、查询列表、查看目录结构
- 文档操作：新建/读取/更新/删除文档，支持富文本（ALIDOC）与Markdown格式
- 内容读写：基于Block结构的文档正文解析与覆盖写入
- 权限管理：文档成员添加与角色分配（viewer/editor）
技术实现特点
- 采用OAuth2认证，accessToken有效期2小时自动管理
- 配置持久化存储于
~/.dingtalk-skills/config，跨会话复用 - 自动处理userId到unionId的身份转换，降低配置复杂度
- 完整的错误码映射与限流处理机制
显著优势
1. 官方API支撑：直接对接钉钉开放平台，数据安全与稳定性有保障
2. 全功能覆盖：从文档创建到成员权限，企业文档管理场景全覆盖
3. 配置自动化：一次配置后自动持久化，后续无需重复输入凭证
4. 身份透明化：所有写操作均以真实用户身份执行，变更可追溯
潜在局限与风险
- 覆盖写入不可逆：
overwriteContent操作会直接清空原有内容，需用户显式确认 - Block解析不完整：代码块、图片等富文本内容暂标记为
unknown类型，纯文本提取可能丢失格式 - 权限依赖前置：需企业管理员在开放平台预先开通
Wiki.Node.Read、Storage.File.Read/Write、Contact.User.Read等scope - unionId混淆风险：operatorId必须使用unionId而非userId，配置错误将导致400/paramError
适合人群
- 企业内部知识管理负责人
- 需要自动化文档操作的开发者/运维人员
- 使用钉钉作为协同平台的中小型至大型企业团队
常规风险提示
- 应用凭证（appKey/appSecret）需妥善保管，避免泄露
- 删除操作即时生效且无回收站机制，执行前建议备份
- 高频调用可能触发429限流，重要操作建议添加重试逻辑