# dws-chat 使用指引（用户版）

面向在钉钉里和智能体对话的用户。你**只需用自然语言说明需求**，不必提供群 ID、机器人 Code 等技术参数。

---

## 能做什么

| 能力 | 你可以这样说 |
|------|-------------|
| 查群消息 | 帮我获取群：AI审核规则沟通 今天的消息 |
| 查最近消息 | 看看「dws测试群」最近 20 条消息 |
| 往群里发消息 | 在「合规部训前案例沟通」群发一条：会议改到下午 3 点 |
| 机器人发群消息 | 用「龙虾助手」在某某群发通知：…… |
| 把机器人加进群 | 把龙虾助手加到「dws测试群」 |
| 给同事发单聊 | 给张三发消息：请查收附件 |

**不负责**：AI 表格、日历、审批、待办等非群聊能力（请用其它能力或说明具体需求）。

---

## 第一次使用：钉钉授权

若智能体提示「还未登录」，会发给你**设备授权链接**和**授权码**，例如：

```
还未登录，无法访问群聊数据。同时生成了新的授权链接，请完成钉钉授权：

授权地址：https://login.dingtalk.com/oauth2/device/verify.htm?user_code=XXXX-XXXX
授权码：XXXX-XXXX

请在 15 分钟内打开链接完成授权，完成后回复「已授权」。
```

**你需要做的：**

1. 用浏览器打开「授权地址」（或复制授权码到页面输入）
2. 按页面提示用钉钉账号完成授权
3. 回到对话里回复：**已授权**

授权完成后，智能体会继续你刚才的请求（例如拉取某群今天的消息）。每个智能体单独授权，不会影响其它助手。

---

## 怎么说更省事

### 查群消息（推荐说法）

- `帮我获取群：{群名} 今天的消息`
- `查一下 {群名} 群里今天说了什么`
- `群：{群名} 昨日消息`

**只需给群名**，不必提供 groupId。群名尽量与钉钉里显示的一致；若搜不到，可换更短的关键词或发群名片截图。

### 发群消息

- `在「{群名}」群发：{正文}`
- 可补充标题，例如：`标题写「日报提醒」，内容是……`

群消息需要**标题 + 正文**，智能体会帮你补全。

### 机器人相关

- **先入群**：`把 {机器人名} 加到 {群名}`
- **再发消息**：`用 {机器人名} 在 {群名} 发：……`

入群、撤回等会改动群设置的操作，智能体**会先向你确认**再执行。

---

## 常见问题

**Q：说「今天没消息」，但我明明在群里看到了？**  
智能体读的是**你钉钉账号能看到的群消息**（不是你的截图里的「另一个视角」）。若仍不对，可再说一次「重新拉取 {群名} 今天从 0 点起的消息」，或发一张群聊截图辅助核对群名。

**Q：为什么要授权？和「机器人是否在群里」有关系吗？**  
查历史消息用的是**你的钉钉身份**，和机器人是否在群里**无关**。机器人只在「以机器人身份发消息」或「把机器人拉进群」时才需要。

**Q：搜不到群？**  
检查群名是否准确、你是否在该群内。可尝试只说关键词，例如「审核规则」而不是全称。

**Q：提示权限不足？**  
按智能体给出的链接在浏览器里补一次钉钉授权即可（例如机器人入群需要额外权限）。

**Q：多个同名群？**  
智能体会列出候选群让你选，回复群名或序号即可。

---

## Windows 用户

1. 需在本机 **PowerShell** 安装钉钉 CLI（一次性）：  
   `irm https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.ps1 | iex`
2. 安装后**新开**对话窗口，再让智能体查群消息。
3. **不需要** WSL 或 Docker；直接在 Windows 上对智能体说需求即可。

---

## 使用注意

1. **一个智能体一套登录**：医药情报助手、其它助手各自授权，互不影响。
2. **危险操作需你确认**：机器人入群、踢人、撤回消息等，会先说明再请你回复「确认」。
3. **不要自行在终端跑 `dws login`**：在对话里按智能体发的链接授权即可。
4. **表格 / 日历 / 审批**：请直接说明具体业务，不要只说「查钉钉」——群聊用这个能力，其它走对应功能。

---

## 示例对话

```
你：帮我获取群：AI审核规则沟通 今天的消息

助手：（若未登录）发授权链接 → 你完成授权并回复「已授权」
助手：汇总今日群消息（发送人、时间、内容摘要）
```

```
你：把龙虾助手加到 dws测试群

助手：确认是否将「龙虾助手」加入「dws测试群」？
你：确认

助手：已加入，之后可用该机器人在该群发消息。
```

---

技术细节与命令说明见同目录 [`dws-chat-commands.md`](./dws-chat-commands.md)；部署与安装见 [`install.md`](./install.md)。