auto backup 2026-07-02 11:00

2026-07-02 11:00:05 +08:00
parent 022b6edbe4
commit c7ff34d012
199 changed files with 43050 additions and 0 deletions
@@ -0,0 +1,114 @@
+# 意图路由指南
+
+当用户请求难以判断归属哪个产品时，参考本指南。
+
+## 易混淆场景快速对照表
+
+| 用户说... | 真实意图 | 应该用 | 不要用 | 理由 |
+|-----------|----------|--------|--------|------|
+| "搜一下 OAuth2 接入文档" | 搜索开发文档 | `devdoc` | — | 搜索开放平台技术文档，不是钉钉内部内容 |
+| "帮我建一个项目跟踪表" | 创建数据表格 | `aitable` | `todo` | 涉及结构化数据/行列操作，不是个人待办 |
+| "帮我记一下明天要做的事" | 创建个人待办 | `todo` | `aitable` | 个人待办提醒，非数据表 |
+| "帮我建一个明天下午的日程" | 日历日程 | `calendar` | — | 日历日程管理（可含参与者/会议室）|
+| "帮我看看收到的日报" | 日志收件箱 | `report` | `todo` | 钉钉日志系统（日报/周报），不是待办 |
+| "帮我创建一个待办提醒" | 个人待办 | `todo` | `report` | 个人任务提醒，不是日志汇报 |
+| "帮我提交请假审批" | 发起审批 | `oa` | — | 审批流程，不是待办或日志 |
+| "帮我建一个项目群" | 创建群聊 | `chat group create` | — | 群聊管理，不是日历日程 |
+| "把张三拉进群" | 添加群成员 | `chat group members add` | — | 先查 userId，再添加 |
+| "让机器人在群里发个通知" | 机器人群发 | `chat message send-by-bot` | `chat message send-by-webhook` | 企业内部机器人发消息，需 robotCode |
+| "通过 Webhook 发告警到群里" | Webhook 告警 | `chat message send-by-webhook` | `chat message send-by-bot` | 自定义机器人 Webhook，需 token |
+| "给张三发一条机器人单聊消息" | 机器人单聊 | `chat message send-by-bot --users` | — | 机器人批量单聊，先查 userId |
+
+---
+
+## 典型场景详解
+
+### 1. aitable vs todo — 表格数据 vs 待办任务
+
+**用 `aitable` 的场景**：
+- "创建一个表格记录团队成员信息" — 结构化数据，有行列
+- "在表格里加一列'状态'字段" — 字段/列操作
+- "查一下表格里所有优先级为高的记录" — 数据筛选和查询
+- "用项目管理模板建一个表" — 模板创建
+- 用户提到"多维表"、"Base"、"数据表"、"记录"
+
+**用 `todo` 的场景**：
+- "帮我记一下这周要做的事" — 个人任务管理
+- "创建一个待办提醒" — 任务提醒
+
+**判断关键**：有没有行列/字段/记录概念？有→ `aitable`；个人任务清单 → `todo`
+
+---
+
+### 2. devdoc — 开发文档搜索
+
+**用 `devdoc` 的场景**：
+- "API 调用报错 403 怎么解决" — 开发调试问题
+- "搜一下 OAuth2 接入文档" — 开放平台技术文档
+- "CLI 命令出错了怎么办" — CLI 使用错误
+- 用户提到"开发"、"API"、"调用错误"
+
+---
+
+### 3. report vs todo — 日志 vs 待办
+
+**用 `report` 的场景**：
+- "帮我看看收到的日报" — 日志收件箱
+- "帮我写/提交今天的日报（钉钉日志模版）" — 先 `report template list` / `template detail`，再 `report create`
+- "有什么日志模版" — 查看模版
+- "看看这个日志的已读统计" — 阅读状态
+- "我发过的日志有哪些" — 已发送列表 (`report sent`)
+- 用户提到"日报"、"周报"、"日志"
+
+**用 `todo` 的场景**：
+- "记一下这周要做的事" — 个人任务管理
+
+**判断关键**：钉钉日志系统(日报/周报模版，含按模版创建汇报)→ `report`；任务清单→ `todo`
+
+---
+
+### 4. chat 内部 — 两种消息发送方式
+
+**用 `chat message send-by-bot` 的场景**：
+- "让机器人在群里发一条通知" — **机器人身份**发群消息
+- "给张三发一条机器人单聊消息" — 机器人批量单聊
+
+**用 `chat message send-by-webhook` 的场景**：
+- "通过 Webhook 发告警到群里" — 自定义机器人 Webhook
+- 用户有 Webhook Token
+
+**判断关键**：企业内部机器人→ `send-by-bot`（需 robotCode）；有 Webhook Token→ `send-by-webhook`
+
+---
+
+## 跨产品工作流路由
+
+以下场景需要多个产品配合完成，注意上下文传递顺序。
+
+### 创建日程并邀请同事（contact → calendar）
+
+用户说"约张三明天下午开会"：
+
+```bash
+# 1. 搜索同事 userId
+dws contact user search --query "张三" --format json
+
+# 2. 创建日程
+dws calendar event create --title "会议" \
+  --start "2026-03-15T14:00:00+08:00" --end "2026-03-15T15:00:00+08:00" --format json
+
+# 3. 添加参与者
+dws calendar participant add --event <EVENT_ID> --users <USER_ID> --format json
+```
+
+### 创建待办并指派（contact → todo）
+
+用户说"给张三建个待办"：
+
+```bash
+# 1. 搜索同事 userId
+dws contact user search --query "张三" --format json
+
+# 2. 创建待办
+dws todo task create --title "任务内容" --executors <USER_ID> --format json
+```