\r \r

DingTalk dws Skill (WorkBuddy Version)\r

钉钉 dws 技能（WorkBuddy 版）\r

\r Use dws CLI to manage all DingTalk product capabilities.\r 使用 dws CLI 管理钉钉全部产品功能。\r \r ---\r \r

dws CLI Path / dws CLI 路径\r

\r dws is installed at $HOME\.local\bin\dws.exe. Always use the full path or ensure $HOME\.local\bin is in your PATH.\r dws 安装在 $HOME\.local\bin\dws.exe。调用时使用完整路径，或确保 $HOME\.local\bin 已加入 PATH 环境变量。\r \r ---\r \r

Authentication / 认证\r

\r First-time users must authenticate: / 首次使用需认证：\r \r

& "$HOME\.local\bin\dws.exe" auth login\r
```\r
\r
This opens a browser for QR code login. Credentials persist for 30 days.\r
此命令会打开浏览器，引导扫码登录钉钉。凭证有效期 30 天。\r
\r
**Re-authenticate when expired:** / **凭证过期后重新认证：**\r
\r
```\r
& "$HOME\.local\bin\dws.exe" auth login\r
```\r
\r
---\r
\r
## Common Commands / 常用命令\r
\r
| Scenario 场景 | Command 命令 |\r
:|----------|---------|\r
| List todos / 查看待办 | `dws todo task list` |\r
| Create todo / 创建待办 | `dws todo task create --title "Report" --deadline 2026-04-15` |\r
| List calendar / 查看日历 | `dws calendar event list` |\r
| Send group message / 发群消息 | `dws chat bot send-by-group --group-id \x3CID> --content "Message"` |\r
| List reports / 查看日报周报 | `dws report inbox list` |\r
| Search contact / 搜索联系人 | `dws contact user search --keyword "Name"` |\r
| List AI tables / 查看 AI 表格 | `dws aitable base list` |\r
\r
See the `references/` directory for full documentation on all 12 DingTalk products.\r
查看 `references/` 目录获取全部 12 个钉钉产品的详细文档。\r