用途:钉钉日志(日报/周报/月报)相关操作,涵盖写日报、写周报、写月报、提交日志、查收件箱日志、查已发送日志、查看已读统计、按主题汇总报告。与 dingtalk-doc(普通文档)、dingtalk-todo(待办)、dingtalk-minutes(听记)区分。命令前缀为 dws。
主要能力与用法:查收到的日志须用 dws report inbox list --start "<ISO>" --end "<ISO>" --cursor 0 --size 20 --format json,并把“今天/最近 30 天”等时间词先展开为完整 ISO 起止时间;查发出的日志用 dws report outbox list --cursor 0 --size 20 --format json。列表返回后,entry get / entry stats 须复用同一个 reportId(在返回的 _internalDetailCommands[].command 里),不要重新挑选或猜测。查正文用 dws report entry get --report-id <reportId>;查已读/统计用 dws report entry stats --report-id <reportId>。查看模版用 dws report template list 与 dws report template get --name "<模版名>";提交日报/周报用 dws report entry submit --template-id <id> --contents-file <CWD 下的 .json>。Shortcut 包括 dws report +inbox-list、dws report +outbox-list,可用 dws shortcut list --service report --format json 读取参数,用 dws report <shortcut> --help 核对 flags。跨产品协作:日报内容来源(待办/听记/OA/邮件/群消息)多源采集;把汇总写文档切到 dingtalk-doc(dws doc create + dws doc update --mode append);submit-report 走 report 模版提交,不走 doc。
限制:属试验版 / Preview,multi 模式当前未达 stable 标准,接口、命名、跨 skill 引用后续可能调整,生产或共享环境优先使用 mono 模式(dws skill setup --mode mono)。使用前须先读 dws-shared skill 了解认证、全局 flags、产品路由、URL 预检、错误码和安全规则,且 dws 二进制须在 PATH 上。命令可用性以当前 dws 二进制为准,服务发现已下线;若 dws <cmd> --help 不存在,说明当前版本未暴露该命令;命令存在但调用失败时按错误中的 endpoint 或 tool 提示确认。调用前可用 dws <cmd> --help 或 --dry-run 验证。旧命令 report list / report detail / report sent / report stats / report create / report template detail 均标记 [deprecated],须改用 inbox list / outbox list / entry get / entry stats / entry submit / template get。