用途:该技能通过模拟浏览器访问 alidocs.dingtalk.com 的内部接口,读取钉钉原生文档(adoc)及知识库内容。因官方开放平台 SDK 不覆盖此类原生文档读取,它采用基于 Cookie 的会话认证,适合个人开发者或临时自动化场景,也适用于定制版钉钉部署,且为只读访问,镜像用户在浏览器中可打开的内容。若无企业应用可用时优先考虑本技能;若已具备获批企业应用与稳定公开 API(消息、通讯录、日历等),应使用官方 SDK。
主要能力:列出目录子项、获取节点信息、获取原生 adoc 文档内容、下载文件(pdf、doc、docx、xlsx、pptx、txt、md、png、jpg、jpeg 等)、为原生文档执行多步 PDF 导出,以及从 alidocs checkpoint 格式递归提取文本。支持识别外部链接(dlink/hlink)并解析指向 alidocs 的目标节点。不支持表格文档。
使用方式:需提供完整的浏览器 Cookie 字符串,并从中提取 XSRF-TOKEN 作为 X-XSRF-TOKEN 请求头。登录可通过 Playwright 自动扫码流程,或在浏览器已登录状态下从 DevTools 手动复制 Cookie。客户端使用共享 httpx.AsyncClient,应通过 async with 上下文管理器使用,或显式调用 aclose()。
必要命令与代码示例保持原样,例如:
async with DingTalkClient(cookie) as client: ...
限制:认证依赖浏览器会话 Cookie,Cookie 过期或无效需重新登录;请求可能遇到 HTTP 429,客户端会对 429 和瞬态网络错误自动重试(3 次指数退避),而其他 4xx/5xx 和认证错误立即传播。PDF 导出流程复杂且存在特定服务端错误,客户端会在部分错误时用备用 Referer 重试一次。高层重试、熔断等策略需调用方自行实现。官方文档未提供价格、收费或平台支持范围等更多信息。