dws

name dws description 管理钉钉产品能力(Agoal目标管理/AI表格/AI搜问/日历/通讯录/群聊与机器人/待办/审批/法务智能合同/考勤/日志/DING消息/开放平台文档/钉钉文档/钉钉云盘/原生Markdown文件/AI听记/邮箱/在线电子表格/知识库等)。当用户需要查询战略解码、经营合约字段、目标规则周期、个人目标、目标模板或周月报规则的按时/迟交/未提交统计与跟催，操作表格数据、管理日程会议、模糊找人/查谁负责某事项、查询通讯录、管理群聊、机器人发消息、创建待办、提交审批、查询或创建合同台账、批量导入合同、按听记起草合同、发起合同审查、归档合同、管理合同项目/相对方/账款、查看考勤、提交日报周报（钉钉日志模版）、读写钉钉文档、上传下载云盘文件、读取或修改原生.md文件、查询听记纪要、收发邮件、读写在线电子表格(axls)、管理钉钉知识库，或订阅个人 IM、OA 审批、VoIP 通话邀请、待办或互动卡片回调事件、实时监听群成员加入、群成员退出、群改名和群解散、审批实例发起/抄送/终止/完成、审批任务创建/完成/转交、VoIP 通话邀请、待办创建/更新/删除，以及互动卡片回调时使用。周报/月报正文填报属于日志 Report；规则级提交统计、迟交、未提交和跟催属于 Agoal。 cli_version >=1.0.61 metadata {"internal":true} 钉钉全产品 Skill 通过 dws 命令管理钉钉产品能力。 命令可用性以当前 dws 二进制为准 。本文档随内置 skill 发布，可能滞后于二进制；如果 dws <cmd> --help 不存在，说明当前版本未暴露该命令。 --help 决定 Cobra 实际接受的 flags；公开基础命令和内建 + shortcut 的 leaf Schema（常规用 --compact ）决定 Agent 选择、参数/约束和安全确认语义。实际调用前可用 dws <cmd> --help 或 --dry-run 验证。 严格禁止 (NEVER DO) 不要使用 dws 命令以外的方式操作钉钉业务数据（禁止 curl 或自行拼 HTTP）；唯一例外是按 openapi-explorer.md 读取官方 open.dingtalk.com/llms.txt 文档并生成受限的 dws api 调用 不要编造 UUID、ID 等标识符，必须从命令返回中提取 不要猜测字段名/参数值，操作前必须先查询确认 严格要求 (MUST DO) 所有命令必须加 --format json 以获取可解析输出 用户明确要登录钉钉国际版、海外版或 .io 区域时，必须执行 dws auth login --intl （无头环境再加 --device ），不得回退到国内 .com ； --intl 只用于登录，后续业务命令按所选 profile 自动路由 危险操作必须先向用户确认，用户同意后才加 --yes 执行 单次批量操作不超过 30 条记录 所有命令必须 严格遵循 对应产品参考文档里面规定的参数格式（如：如果有参数值，则参数和参数值之间至少用一个空格隔开） 脚本只用于明确覆盖的复合任务 ： scripts/ 下的脚本可封装 AI 表格批量导入导出、AI 应用创建轮询、文档创建后写内容、钉盘目录树等流程；当公开 + Shortcut 已提供目标唯一解析、分页/部分失败 ledger 和确认语义时，优先 Shortcut。Chat 历史导出与机器人广播已完全下沉 Runtime，不再发布兼容脚本 实时个人事件例外 ：普通 IM 消息、reaction、已读和撤回默认走 dws event +listen-im ... ；OA 审批、VoIP 通话邀请、Todo、互动卡片回调、群生命周期、明确的原始 EventKey、Filter DSL、subscribe_id 或原始 envelope 使用 dws event consume ... --flatten 。不要写脚本轮询消息历史、审批列表、通话记录或待办列表 Shortcut 与原子命令的使用原则 shortcut 是对常用操作的高层封装，适合优先承担用户意图；产品参考文档和本 skill 负责判断意图、风险、跨产品流程和复杂参数，CLI 帮助负责声明当前版本真正可调用的命令。 先按产品参考、意图表和 recipe 路由。用户意图可由可见 Shortcut 满足时，优先使用 dws <service> +<verb> ... --format json ，不要手写等价的多步原子命令。只有脚本明确补足 Shortcut 未覆盖的复合交付物且其安全/完整性契约仍适用时才选择脚本。 公开内建 shortcut 同时进入 Runtime Schema。用 dws schema --cli-path "<service> +<verb>" --compact --format json 读取 Agent 选择、参数、跨参数约束和 risk/confirmation；只有参数映射、接口绑定或 provenance 审计才通过 --jq 精确读取 full leaf； dws shortcut list --service <service> --format json 只作为轻量批量发现入口。 真正组装参数前用叶子帮助 dws <service> +<verb> --help 核对当前 Cobra 接受的 flags。父级 dws <service> --help 只能发现子命令，不能替代叶子参数帮助。 shortcut catalog 中 confirmation=user_required 时，必须先获得用户确认，确认后才加 --yes ； not_required 不额外确认。 如果 shortcut 不在 help / list 中，改用产品参考里的原子命令、脚本或标准流程；不要猜测未展示的 + 命令。 shortcut 失败时按“错误处理”流程先加 --verbose 复查；若仍失败，应记录具体输入、输出、trace / endpoint / tool 信息。 Shortcut 总览 下面只统计当前公开 catalog 中的 shortcut，不展开完整明细。已知意图先按产品 Skill、意图表或任务 reference 选唯一命令；参数/约束/安全不明时读一次 leaf 窄 Schema。Schema 不可用时才读一次已知 leaf Help； unknown flag 用同 leaf Help 修正一次； unknown command 不查 Help，先用错误的明确 suggestion，否则用已加载 Skill/reference 的明确兼容入口，仍无则报告漂移，不枚举全 Catalog。仅当现有路由和 reference 都无法定位低频能力时，才用 dws shortcut list --service <service> --format json 做最后回退；不要为已知意图加载完整产品 Catalog 或 root/parent Help。 服务 shortcut 数 multi skill agoal 5 — aisearch 1 — aitable 101 dingtalk-aitable attendance 8 dingtalk-misc calendar 27 dingtalk-calendar chat 99 dingtalk-chat contact 13 dingtalk-contact devapp 25 dingtalk-misc ding 1 dingtalk-misc doc 45 dingtalk-doc drive 28 dingtalk-drive mail 8 dingtalk-mail minutes 29 dingtalk-minutes oa 1 dingtalk-misc pat 1 dingtalk-misc report 4 dingtalk-misc sheet 2 dingtalk-misc todo 21 dingtalk-todo whiteboard 2 dingtalk-misc wiki 20 dingtalk-wiki 多组织 / 多账号 dws profile list --format json 默认返回全部账号。自动化只使用每项稳定的 profile=corpId:userId ； status/expiresAt/refreshExpAt 来自真实身份 Token，列表不触发刷新。 输入支持 corpId:userId 、 corpId:userName 、 corpName:userId 、 corpName:userName ，也兼容单独的 corpId、唯一 corpName 和本地 profile 名。名称只用于输入；重名时必须按报错候选改用 corpId:userId 。 只传组织时使用该组织明确记录的 isOrgCurrent=true 账号。多账号组织没有默认账号时必须让用户指定账号；禁止选择第一项、最近登录或最近使用账号。 不传 --profile 使用全局 isCurrent=true 账号。 primaryProfile/isPrimary 仅兼容输出，不参与选择； previousProfile 只用于 profile switch - 。 跨组织读 / 搜：按 corpId 去重；每个组织使用唯一 isOrgCurrent=true 的 profile 。组织存在多个账号且没有默认账号时先询问用户。写 / 发 / 删 / 撤回及持久切换前先确认目标组织和账号。 产品总览 产品 用途 参考文件 agoal 目标管理：战略解码、经营合约、计分卡、目标规则周期、个人目标、目标模板、周月报规则提交统计与跟催 agoal.md aisearch AI搜问（通用找人首选）：按姓名/部门/职位/职责/上级/下级/手机号/工号维度找人，"谁负责 XX/XX 的负责人/某事项/某项目的人"统一走本产品；不含人才池/绩效/职业历程等专项 HR 场景（那些去 hrbrain ） aisearch.md aitable AI表格：Base/数据表/字段/记录/视图/附件/图表/仪表盘/导入导出/模板搜索/PostgreSQL 只读查询与 JOIN aitable.md api OpenAPI 逃生舱：官方 llms.txt 分层发现，仅执行企业内部应用 App Token 服务端 API openapi-explorer.md attendance 考勤：打卡结果/打卡流水/考勤组查询/考勤规则/汇总统计/假期类型/假期余额（P0 已落地，部分管理类命令仍属 P1） attendance.md calendar 日历：日历列表/日程/参与者/附件/响应/会议室/闲忙查询/时间建议 calendar.md chat 群聊与机器人：搜索群/建群/群成员管理/改群名/消息发送(文本/Markdown/图片/文件)/拉取消息/消息收藏/@我/特别关注/机器人群发/单聊/撤回/转发/引用回复/Webhook/机器人搜索 chat.md contact 通讯录：用户查询/部门/角色/花名册（学历/家庭/银行卡/紧急联系人/合同等基础字段）/离职员工/特别关注，以及创建企业、企业账号和邀请员工；不含职业历程/绩效/人才池（那些去 hrbrain ） contact.md contract 法务智能合同：台账、批量导入、听记起草、合同审查、归档、项目、相对方与账款管理 contract.md devdoc 开放平台文档：搜索开发文档 devdoc.md ding DING消息：发送/撤回（应用内/短信/电话） ding.md doc 钉钉文档：搜索/浏览/读写/块级编辑/评论/文件创建/复制/移动/重命名/ 删除/导出 docx/权限管理/媒体上传下载 doc.md drive 钉钉云盘：文件列表/元数据/文件夹/上传(两步)/下载/本地与钉盘文件夹差异比较(status)/拉取到本地(pull)/推送到钉盘(push)/双向同步(sync)/互联网公开发布(publish)/分享链接密码与有效期 drive.md hrbrain 组织大脑：人才池管理/员工档案专项模块查询（元数据/批量数据/标签/职业历程/绩效）/结构化高级人才搜索（原始条件表达式）；区别于 contact 的基础通讯录档案与 aisearch 的通用语义找人 hrbrain.md html 原生 HTML 文件：读取/创建/全量覆盖/局部替换（.html/.htm，钉盘或文档空间） html.md markdown 原生 Markdown 文件：读取/创建/对比/全量覆盖/局部替换/评论列表 markdown.md minutes AI听记：听记列表/摘要/关键词/转写/待办/思维导图/发言人/发言人段落总结/热词/录音控制/成员权限/上传 minutes.md oa OA审批：待处理/详情/同意/拒绝/撤销/记录/已发起/任务/转交/评论/抄送 oa.md pat PAT 行为授权：浏览器策略/scope 预览/一次性、会话或永久授权 pat.md report 日志：按模版创建/收件箱/已发送/模版查看/详情/已读统计 report.md mail 邮箱：邮箱地址查询/邮件搜索(KQL)/邮件详情/发送邮件 mail.md sheet 在线电子表格(axls)：工作表 CRUD/区域读写/CSV 批量写入/行列增删/合并/查找替换/筛选视图/全局筛选/排序/下拉列表/条件格式/浮动图片/浮动图表/模板/导出 xlsx(单命令一站式) sheet.md todo 待办：创建(含优先级/截止时间/循环)/查询/修改/标记完成/删除 todo.md wiki 知识库：空间创建/详情/列表/搜索 + 成员管理 + 知识库动态查询 wiki.md whiteboard 独立与文档内嵌白板：带内容创建、读取 OpenNodes、追加节点、整页重建 whiteboard.md recruit 钉钉招聘：查询职位列表、获取职位详情、创建职位 recruit.md event 个人 IM/OA/VoIP/Todo/互动卡片事件：监听消息、群生命周期、审批任务/实例、通话邀请、待办变化与卡片回调，NDJSON 输出（实时驱动 Agent） event.md 意图判断决策树 用户提到"AI应用/创建应用/生成系统/做工具/管理后台/低代码/宜搭" → 当前无稳定产品参考 （勿猜 aiapp 命令）；向用户说明能力未以产品文档发布，multi 布局见 dingtalk-misc 的 unsupported-scripts.md 用户提到"目标管理/Agoal/战略解码/经营合约或字段配置/计分卡/目标规则周期/个人目标/目标模板/周月报规则提交统计/按时/迟交/未提交/跟催" → agoal ；只填写、提交或查询日报周报月报正文时才走 report 用户提到"法务/智能合同/合同台账/合同审查/合同归档/合同项目/相对方/合同账款/按听记起草合同" → contract （合同审批实例的查询或处理走 oa ；合同文件存储操作走 drive ） 用户提到"找人/搜人/谁负责 XX/某事项的负责人/某项目的人/团队成员/上级/下级/按工号找人/按手机号找人" → aisearch （通用语义找人；若明确涉及人才池/绩效/职业历程/结构化高级条件，去 hrbrain ） 用户提到"表格/多维表/AI表格/记录/数据/视图/图表/仪表盘/SQL/PostgreSQL/SELECT/JOIN/跨表关联查询" → aitable 用户提到"考勤/打卡/排班" → attendance 用户提到"日程/日历/会议室/约会/时间建议" → calendar 用户提到"群聊/建群/群成员/群管理/发消息/发图片消息/发文件消息/发 Markdown 消息/截图发钉钉/转发消息/引用回复/@我/特别关注消息/机器人发消息/Webhook/机器人群发/机器人单聊/通知" → chat 用户提到"通讯录/同事/部门/组织架构/子部门/部门多少人/离职员工/离职名单/离职花名册/花名册/基础员工档案(学历/家庭/银行卡/紧急联系人/合同)/角色/主管角色/管理员角色/财务/HR/特别关注/星标联系人/创建企业/企业账号/邀请员工/新员工入职" → contact （不含职业历程/绩效/人才池；那些去 hrbrain ） 用户提到"开发/API/调用错误 文档" → devdoc 用户提到"未封装 OpenAPI/llms.txt/dws api/Raw API/API 逃生舱" → dws api （先查现有产品命令，再读官方 llms.txt） 用户提到"DING/紧急消息/电话提醒" → ding 用户提到"钉钉文档/云文档/知识库/读写文档/块级编辑/文档评论/文档复制移动" → doc 用户提到"云盘/文件存储/文件上传下载/文件夹/互联网公开/分享链接密码/公开有效期" → drive 用户提到"人才池/储备干部池/员工档案元数据或批量模块数据/职业历程/绩效记录/员工标签/组织大脑/结构化人才搜索(高级条件表达式)" → hrbrain （区别于 aisearch 的通用语义找人与 contact 的基础通讯录档案） 用户提到"原生 HTML 文件/.html 文件/新建 HTML 页面/创建 HTML 文件/读取 HTML 原文/覆盖 HTML/局部替换 HTML" → html 用户提到"原生 Markdown 文件/.md 文件/读取 Markdown 原文/覆盖 Markdown/局部替换 Markdown/Markdown 评论" → markdown 用户提到"听记/AI听记/会议纪要/转写/摘要/思维导图/发言人/热词" → minutes 用户提到"邮箱/邮件/发邮件/收邮件/搜邮件/查邮件/邮件草稿/转发邮件/回复邮件/邮件附件/抄送" → mail 用户提到"审批/请假/报销/出差/加班/同意/拒绝/撤销审批" → oa 用户提到"PAT 授权/行为权限/scope 授权/批量授权/一次性授权/会话授权/永久授权/授权浏览器策略" → pat 用户提到"日志/日报/周报/日志统计/写日报/提交周报/发日志/填日志" → report 用户提到"在线电子表格/钉钉表格/axls/工作表/单元格读写/合并单元格/筛选视图/导出 xlsx" → sheet 用户提到"待办/TODO/任务提醒/循环待办" → todo 用户提到"创建知识库/知识库列表/搜索知识库空间/wiki/团队空间/知识库成员管理/我的文档个人空间" → wiki 用户提到"白板/独立白板/文档内嵌白板/画布/OpenNodes/白板节点/连接线/整页重建白板" → whiteboard ；没有文档内 partId 的目标默认按独立白板处理，创建文档内空白板卡片先走 doc whiteboard insert 用户提到"招聘/职位/JD/在招职位/创建职位/职位详情" → recruit 用户提到"监听有人@我/监听单聊或群消息/监听所有单聊或群消息/监听某人发送的消息/监听消息已读/监听消息撤回/监听消息贴表情或表情回应/订阅个人 IM 事件/实时接收钉钉事件/监听并自动回复消息/驱动 Agent 处理消息" → event +listen-im ；群成员加入/退出、群改名/解散或明确原始 EventKey/Filter DSL → event consume 用户提到"监听待我审批的任务/监听审批任务创建、完成或转交/监听审批单发起或终止/监听我发起的审批完成/监听审批实例完成/订阅 OA 事件/event consume user_oa_approval_ " → event consume 用户提到"收到语音通话邀请时通知我/监听 VoIP 来电/订阅 user_voip_call_receive_invite" → event consume 用户提到"监听待办创建/更新/删除/监听指派给我的待办/订阅 Todo 事件/event consume user_todo_task_ " → event consume ，按角色使用 --role-types 用户提到"互动卡片回调/监听卡片操作/订阅 user_card_action_triggered" → event consume user_card_action_triggered --flatten -f ndjson 普通消息、reaction、已读、撤回监听优先由一个 dws event +listen-im 进程表达目标；不同用户、不同群或不同过滤条件拆成独立进程。只有高级事件控制才生成 dws event consume <event_key> [event_key...] --flatten 。 关键区分: aitable(数据表格) vs todo(待办任务) 关键区分: report(钉钉日志/日报周报) vs todo(待办任务) 关键区分: chat send-by-bot(机器人身份发消息) vs send-by-webhook(自定义机器人Webhook告警) 关键区分: doc(在线富文本文档/adoc) vs markdown(原生 .md 纯文本文件) vs html(原生 .html 文件读写) vs drive(通用文件存储与传输) 关键区分: contact(基础通讯录档案：学历/家庭/银行卡/紧急联系人/合同/部门角色) vs aisearch person(通用语义找人：谁负责/上级/下级/多维度模糊搜索) vs hrbrain(人才池/员工档案专项模块数据/职业历程/绩效/结构化高级人才搜索) 关键区分: oa tasks(审批 taskId，审批/拒绝用) vs oa list-pending(收件箱 processInstanceId，查看用) 关键区分: oa(查询或操作审批) vs event user_oa_approval_ (当前用户审批事件长连接监听) 关键区分: todo(查询或操作待办) vs event user_todo_task_ (当前用户待办事件长连接监听) 更多易混淆场景见 intent-guide.md