SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场dws

dws

办公与效率

查看项目

更新于 10-17 00:38

技能介绍

用途

dws 是一个用于管理钉钉产品能力的命令行工具。用户通过 dws <cmd> 形式调用钉钉各产品能力，以命令行方式读写钉钉业务数据，并可由 Agent 驱动执行。命令可用性以当前 dws 二进制为准，dws <cmd> --help 决定 Cobra 实际接受的 flags。

主要能力（按产品）

工具按产品划分能力，资料中列出的产品包括：

  • agoal：目标管理，含战略解码、经营合约、计分卡、目标规则周期、个人目标、目标模板、周月报规则提交统计与跟催。
  • aisearch：AI搜问，通用找人首选，支持按姓名/部门/职位/职责/上级/下级/手机号/工号维度找人。
  • aitable：AI表格，含 Base/数据表/字段/记录/视图/附件/图表/仪表盘/导入导出/模板搜索/PostgreSQL 只读查询与 JOIN。
  • api：OpenAPI 逃生舱，按官方 llms.txt 分层发现，仅执行企业内部应用 App Token 服务端 API。
  • attendance：考勤，含打卡结果/打卡流水/考勤组查询/考勤规则/汇总统计/假期类型/假期余额。
  • calendar：日历，含日历列表/日程/参与者/附件/响应/会议室/闲忙查询/时间建议。
  • chat：群聊与机器人，含搜索群/建群/群成员管理/改群名/消息发送（文本/Markdown/图片/文件）/拉取消息/消息收藏/@我/特别关注/机器人群发/单聊/撤回/转发/引用回复/Webhook/机器人搜索。
  • contact：通讯录，含用户查询/部门/角色/花名册基础字段/离职员工/特别关注，以及创建企业、企业账号和邀请员工。
  • contract：法务智能合同，含台账、批量导入、听记起草、归档、项目、相对方与账款管理。
  • devdoc：开放平台文档，搜索开发文档。
  • ding：DING消息，发送/撤回（应用内/短信/电话）。
  • dingtalk-tag：DingTalk Tag 数字员工，管理生命周期、Skill/MCP、执行状态与 trace 等。
  • doc：钉钉文档，含搜索/浏览/读写/块级编辑/评论/文件创建/复制/移动/重命名/删除/导出 docx/权限管理/媒体上传下载。
  • drive：钉钉云盘，含文件列表/元数据/文件夹/上传（两步）/下载/差异比较/拉取/推送/双向同步/公开发布/分享链接密码与有效期/节点分享范围。
  • hrbrain：组织大脑，含人才池管理/员工档案专项模块查询/结构化高级人才搜索。
  • html：原生 HTML 文件读取/创建/全量覆盖/局部替换。
  • markdown：原生 Markdown 文件读取/创建/对比/全量覆盖/局部替换/评论列表。
  • minutes：AI听记，含列表/摘要/关键词/转写/待办/思维导图/发言人/热词/录音控制/成员权限/上传。
  • oa：OA审批，含待处理/详情/同意/拒绝/撤销/记录/已发起/任务/转交/评论/抄送。
  • pat：PAT 行为授权，含浏览器策略/scope 预览/一次性、会话或永久授权。
  • report：日志，按模版创建/收件箱/已发送/模版查看/详情/已读统计。
  • mail：邮箱，含邮箱地址查询/邮件搜索(KQL)/邮件详情/发送邮件。
  • sheet：在线电子表格(axls)，含工作表 CRUD/区域读写/CSV 批量写入/行列增删/合并/查找替换/筛选视图/全局筛选/排序/下拉列表/条件格式/浮动图片/浮动图表/模板/导出 xlsx。
  • todo：待办，含创建（优先级/截止时间/循环）/查询/修改/标记完成/删除。
  • wiki：知识库，含空间创建/详情/列表/搜索 + 成员管理 + 动态查询 + 分享范围。
  • whiteboard：白板文件内容操作，或文档内嵌白板 part 图形内容读写。
  • event：个人 IM/OA/VoIP/Todo/互动卡片事件监听，NDJSON 输出。

资料同时给出了 Shortcut 数量统计（如 aitable 127、chat 102、doc 49 等）和各产品对应的 multi skill 名称。

使用方式

  • 命令形式为 dws <service> <verb>，公开内建 Shortcut 为 dws <service> +<verb>。
  • 所有命令必须加 --format json 以获取可解析输出。
  • 危险操作需先向用户确认，用户同意后才加 --yes 执行；非交互环境下不带 --yes 会返回 confirmation_required 错误，需展示风险后由用户确认再追加 --yes 重试；--dry-run 可输出完整调用预览且不触发确认门禁。
  • 单次批量操作不超过 30 条记录。
  • 命令发现通过 dws schema（分产品级、分组级、leaf 级）进行渐进查询，参数组装前用 dws <service> +<verb> --help 核对 Cobra 接受的 flags。
  • 多组织/多账号通过 dws profile list 管理，profile 标识为 corpId:userId，不传 --profile 使用全局 isCurrent=true 账号；写/发/删/撤回及持久切换前需确认目标组织和账号。
  • 国际版登录需执行 dws auth login --intl（无头环境再加 --device）。
  • 实时事件监听使用 dws event +listen-im ...，或对 OA 审批、VoIP、Todo、卡片回调、群生命周期等使用 dws event consume ... --flatten。

适用场景

  • 需要以命令行或 Agent 方式批量读写钉钉表格、文档、云盘、日程、待办、审批等业务数据。
  • 需要跨产品复合流程，如按听记起草合同、按意图路由到对应产品。
  • 需要实时监听个人 IM、审批、待办、VoIP、卡片回调等事件以驱动 Agent 处理。
  • 需要多组织多账号场景下的数据读写与切换。

限制

  • 禁止使用 dws 命令以外的方式操作钉钉业务数据（禁止 curl 或自行拼 HTTP），唯一例外是按 openapi-explorer 读取官方 llms.txt 并生成受限的 dws api 调用。
  • 不要编造 UUID、ID 等标识符，必须从命令返回中提取；不要猜测字段名/参数值。
  • 命令可用性以当前 dws 二进制为准，本文档可能滞后；dws <cmd> --help 不存在说明当前版本未暴露该命令。
  • 禁止看到 confirmation_required 就未经用户同意自动追加 --yes，也不得用管道方式喂答案绕过确认。
  • 用户提到的「AI应用/创建应用/生成系统/做工具/管理后台/低代码/宜搭」当前无稳定产品参考。
  • 具体收费、价格、平台支持情况资料中暂未提供。