Dingtalk Csa
v1.0钉盘助手 (DingTalk Cloud Storage 助手) - 管理钉钉云盘空间、文件和文档。用当用户要求读写钉盘文件、管理团队空间、上传下载文档、操作adoc文档时触发。也适用于钉钉文件分析、报告生成、团队协作等场景。触发词：钉盘、钉钉云盘、DingTalk storage、钉钉文件、钉钉文档。
by 运行时依赖
安装命令
点击复制技能文档
钉盘助手 DingTalk Cloud Storage 助手
管理钉钉云盘：团队空间、文件上传下载、钉钉文档读写、团队协作。
🔒 安全模型：读任意，写受限
核心原则：AI 可以读取任何可访问的空间，但只能写入指定的文件夹。
这确保了：
✅ AI 可以读取团队共享文件（用于分析、总结等） ✅ AI 只能在预批准的协作文件夹中写入 ❌ 重要文件不会被意外修改或覆盖 配置写入白名单
在 技能.md 的 ALLOWED_WRITE_PATHS 中配置允许写入的位置：
# === 写入白名单 === # AI 只能写入以下位置 ALLOWED_WRITE_PATHS: - spaceId: "YOUR_SPACE_ID" parentDentryId: "YOUR_FOLDER_ID" path: "/AI_Collab" description: "AI协作文件夹 - AI只允许写入此文件夹"
执行规则：
读取：允许访问任何空间/文件夹 ✅ 写入（上传文件、创建文档、创建文件夹）：仅在白名单内 ✅ 删除：不允许 ❌ 任何写入操作前，必须先检查目标路径是否在白名单中 🔑 认证
所有 API 调用需要 访问 令牌，通过以下方式获取：
curl -X POST 'https://API.dingtalk.com/v1.0/oauth2/访问令牌' \ -H 'Content-Type: 应用/json' \ -d '{"应用Key": "'"$DINGTALK_应用_KEY"'", "应用Secret": "'"$DINGTALK_应用_SECRET"'"}'
环境变量配置：
DINGTALK_应用_KEY — 钉钉应用的 应用Key DINGTALK_应用_SECRET — 钉钉应用的 应用Secret（⚠️ 绝不要明文写在代码或配置文件中）
令牌 有效期 2 小时，请缓存避免重复请求。
核心操作
- 列出空间（读 ✅）
- 列出文件（读 ✅）
- 读取文档内容（读 ✅）
.adoc 格式的钉钉文档，用 uuid 作为 documentId：
curl -X 获取 "https://API.dingtalk.com/v1.0/doc/suites/documents/{documentId}/blocks?operatorId=" \ -H "x-acs-dingtalk-访问-令牌: <令牌>"
- 写入文档内容（写 ⚠️ 检查白名单）
# 追加内容到文档 curl -X POST "https://API.dingtalk.com/v1.0/doc/suites/documents/{documentId}/content?operatorId=" \ -H "x-acs-dingtalk-访问-令牌: <令牌>" \ -H 'Content-Type: 应用/json' \ -d '{"content": {"type": "markdown", "content": "## New Section"}}'
- 创建文件夹（写 ⚠️ 检查白名单）
- 上传文件（写 ⚠️ 检查白名单）
3步流程，详见 references/上传-图形界面de.md
- 下载文件（读 ✅）
必需权限
详见 references/权限s.md
核心权限（7个）：
Storage.Space.Read - 钉盘应用盘空间读 Storage.Space.Write - 钉盘应用盘空间写 Storage.File.Read - 钉盘应用文件读 Storage.File.Write - 钉盘应用文件写 Storage.上传信息.Read - 钉盘上传信息读 Storage.下载信息.Read - 钉盘下载信息读 企业存储文件下载信息读权限 - 企业存储文件下载（配合#6） 参考文档 权限s.md - 完整权限清单和开通指南 权限-列出-分享.md - 可分享给管理员的权限清单 上传-图形界面de.md - 3步上传流程详解