用途:通过 dws 命令行处理钉钉群聊与消息,包括收发、搜索、群创建与治理、Bot/Webhook、文件及仅限 IM 的消息谓词筛选。跨源主题与行为轨迹查询走 dingtalk-aisearch,DING/班级群走 dingtalk-misc,邮件走 dingtalk-mail。
主要能力:读取指定群聊/单聊(dws chat +chat-messages --no-reactions,全部时加 --page-all);按关键词、发送者、@、类型、reaction 过滤(dws chat +search-msg,reaction 加 --has-reactions,默认 7 天,范围用 --start/--end);跨会话读取、总结与统计(dws chat message list-all --start <开始> --end <结束> --page-all --no-reactions);查看 @我、未读、已知消息 ID 批量详情;按姓名或群发送文本/Markdown;文件、Bot、Webhook 与复杂 @ 用 +messages-send;群搜索、成员列表、群资料、Bot、邀请链接;创建/清理临时群、改群资料与设置、禁言、管理员管理;引用回复、撤回、转发、Pin/Top/Favorite、reaction、会话置顶/免打扰/隐藏、已读/未读/清红点、下载消息资源。
使用方式:只用 dws;结构化读取加 --format json。已知命令直调,参数与约束不明时查 leaf 窄 Schema(dws schema --cli-path "chat <leaf>" --compact --jq '{cli_path,parameters,constraints,confirmation}' -f json);写操作按最终 Runtime gate/Schema 确认后再加 --yes,写后验证结果。ID 来自真实返回,不跨组织使用;多账号仅用唯一 isOrgCurrent=true。
限制:不输出或记录 token、refresh token、appSecret、webhook token;不猜命令、flag、字段、ID、账号或业务事实;目标零命中或多候选须先消歧;不完整结果不得称成功;仅 retryable=true 按原命令重试一次;confirmation_required 等待用户确认,不补 --yes。