@dingtalk-real-ai/dingtalk-connector 0.8.21 → 0.8.22

package/skills/dws-cli/references/products/calendar.md

@@ -1,217 +0,0 @@
-# 日历 (calendar) 命令参考
-
-## 命令总览
-
-### 查询日程列表
-```
-Usage:
-  dws calendar event list [flags]
-Example:
-  dws calendar event list --start "2026-03-10T14:00:00+08:00" --end "2026-03-10T18:00:00+08:00"
-Flags:
-      --end string     结束时间 ISO-8601 (例如 2026-03-10T18:00:00+08:00)
-      --start string   开始时间 ISO-8601 (例如 2026-03-10T14:00:00+08:00)
-```
-
-### 获取日程详情
-```
-Usage:
-  dws calendar event get [flags]
-Example:
-  dws calendar event get --id <EVENT_ID>
-Flags:
-      --id string   日程 ID (必填)
-```
-
-### 创建日程
-```
-Usage:
-  dws calendar event create [flags]
-Example:
-  dws calendar event create --title "Q1 复盘会" \
-    --start "2026-03-10T14:00:00+08:00" --end "2026-03-10T15:00:00+08:00"
-Flags:
-      --desc string    日程描述
-      --end string     结束时间 ISO-8601 (必填)
-      --start string   开始时间 ISO-8601 (必填)
-      --title string   日程标题 (必填)
-```
-
-### 修改日程
-```
-Usage:
-  dws calendar event update [flags]
-Example:
-  dws calendar event update --id <EVENT_ID> --title "新标题"
-Flags:
-      --end string     新结束时间
-      --id string      日程 ID (必填)
-      --start string   新开始时间
-      --title string   新标题
-```
-
-### 删除日程
-```
-Usage:
-  dws calendar event delete [flags]
-Example:
-  dws calendar event delete --id <EVENT_ID> --yes
-Flags:
-      --id string   日程 ID (必填)
-```
-
-### 查看参与者
-```
-Usage:
-  dws calendar participant list [flags]
-Example:
-  dws calendar participant list --event <EVENT_ID>
-Flags:
-      --event string   日程 ID (必填)
-```
-
-### 添加参与者
-```
-Usage:
-  dws calendar participant add [flags]
-Example:
-  dws calendar participant add --event <EVENT_ID> --users <USER_ID_1>,<USER_ID_2>
-Flags:
-      --event string   日程 ID (必填)
-      --users string   用户 ID 列表 (必填)
-```
-
-### 移除参与者
-```
-Usage:
-  dws calendar participant delete [flags]
-Example:
-  dws calendar participant delete --event <EVENT_ID> --users <USER_ID> --yes
-Flags:
-      --event string   日程 ID (必填)
-      --users string   用户 ID 列表 (必填)
-```
-
-### 搜索会议室
-```
-Usage:
-  dws calendar room search [flags]
-Example:
-  dws calendar room search --start "2026-03-10T14:00:00+08:00" --end "2026-03-10T15:00:00+08:00" --available
-  dws calendar room search --start "2026-03-10T14:00:00+08:00" --end "2026-03-10T15:00:00+08:00" --group-id <GROUP_ID>
-Flags:
-      --available        仅查空闲会议室
-      --end string       结束时间 ISO-8601 (必填)
-      --group-id string  会议室分组ID（可选，留空查根目录；超100条时需按分组查询）
-      --start string     开始时间 ISO-8601 (必填)
-```
-
-### 预定会议室
-```
-Usage:
-  dws calendar room add [flags]
-Example:
-  dws calendar room add --event <EVENT_ID> --rooms <ROOM_ID>
-Flags:
-      --event string   日程 ID (必填)
-      --rooms string   会议室 ID 列表 (必填)
-```
-
-### 移除会议室
-```
-Usage:
-  dws calendar room delete [flags]
-Example:
-  dws calendar room delete --event <EVENT_ID> --rooms <ROOM_ID> --yes
-Flags:
-      --event string   日程 ID (必填)
-      --rooms string   会议室 ID 列表 (必填)
-```
-
-### 会议室分组列表
-```
-Usage:
-  dws calendar room list-groups [flags]
-Example:
-  dws calendar room list-groups
-```
-
-### 查询用户闲忙状态
-```
-Usage:
-  dws calendar busy search [flags]
-Example:
-  dws calendar busy search --users <USER_ID_1>,<USER_ID_2> \
-    --start "2026-03-10T14:00:00+08:00" --end "2026-03-10T18:00:00+08:00"
-Flags:
-      --end string     结束时间 ISO-8601 (必填)
-      --start string   开始时间 ISO-8601 (必填)
-      --users string   用户 ID 列表 (必填)
-```
-
-## 意图判断
-
-用户说"日程/会议/约会/日历":
-- 查看 → `event list`
-- 详情 → `event get`
-- 创建/约 → `event create`
-- 修改/改时间 → `event update`
-- 取消/删除 → `event delete`
-
-用户说"参会人/与会者":
-- 查看 → `participant list`
-- 邀请/添加 → `participant add`
-- 移除 → `participant delete`
-
-用户说"会议室/订会议室":
-- 哪个空闲 → `room search`
-- 预定 → `room add`
-- 取消预定 → `room delete`
-- 分组 → `room list-groups`，取 groupId 后 `room search --group-id`
-
-用户说"有空吗/忙不忙/闲忙":
-- 查询 → `busy search`
-
-## 核心工作流
-
-```bash
-# 1. 创建日程 — 提取 eventId
-dws calendar event create --title "Q1 复盘会" \
-  --start "2026-03-10T14:00:00+08:00" --end "2026-03-10T15:00:00+08:00" --format json
-
-# 2. 添加参与者
-dws calendar participant add --event <EVENT_ID> --users userId1,userId2 --format json
-
-# 3. 预定会议室 (先搜空闲)
-dws calendar room search --start "2026-03-10T14:00:00+08:00" --end "2026-03-10T15:00:00+08:00" --format json
-# 若返回错误(会议室超100条)，先查分组再按分组搜索:
-#   dws calendar room list-groups --format json
-#   dws calendar room search --start ... --end ... --group-id <GROUP_ID> --format json
-dws calendar room add --event <EVENT_ID> --rooms <ROOM_ID> --format json
-
-# 4. 查看日程列表
-dws calendar event list --start "2026-03-10T14:00:00+08:00" --end "2026-03-10T15:00:00+08:00" --format json
-```
-
-## 上下文传递表
-
-| 操作 | 从返回中提取 | 用于 |
-|------|-------------|------|
-| `event create` | `eventId` | participant/room 操作的 --event |
-| `event list` | `events[].eventId` | event get/update/delete 的 --id |
-| `room search` | `rooms[].roomId` | room add 的 --rooms |
-| `room list-groups` | `groups[].groupId` | room search 的 --group-id |
-
-## 注意事项
-
-- 时间格式: `event create/update`、`event list` 和 `busy search` 用 ISO-8601
-- 创建日程不会自动预定会议室，需额外 `room add`
-- `room search` 不带 `--group-id` 时查根目录；企业会议室超过 100 条会报错，此时需先 `room list-groups` 获取分组，再按分组逐一查询
-
-## 自动化脚本
-
-| 脚本 | 场景 | 用法 |
-|------|------|------|
-| [calendar_today_agenda.py](../../scripts/calendar_today_agenda.py) | 查看今天/明天/本周日程安排 | `python calendar_today_agenda.py today` |
-| [calendar_schedule_meeting.py](../../scripts/calendar_schedule_meeting.py) | 一键创建日程+添加参与者+预定会议室 | `python calendar_schedule_meeting.py --title "复盘会" --start "2026-03-15T14:00" --end "2026-03-15T15:00" --users userId1 --book-room` |
-| [calendar_free_slot_finder.py](../../scripts/calendar_free_slot_finder.py) | 查询多人共同空闲时段 | `python calendar_free_slot_finder.py --users userId1,userId2 --date 2026-03-15` |

package/skills/dws-cli/references/products/chat.md

@@ -1,292 +0,0 @@
-# 群聊与机器人 (chat) 命令参考
-
-## 命令总览
-
-| 子命令 | 用途 |
-|-------|------|
-| `search` | 搜索群聊 |
-| `group create` | 创建群 |
-| `group members list` | 查看群成员列表 |
-| `group members add` | 添加群成员 |
-| `group members remove` | 移除群成员（⚠️ 危险操作） |
-| `group members add-bot` | 添加机器人到群 |
-| `group rename` | 修改群名称 |
-| `bot search` | 搜索我的机器人 |
-| `message send-by-bot` | 机器人发消息（群聊或批量单聊） |
-| `message recall-by-bot` | 机器人撤回消息（群聊或批量单聊） |
-| `message send-by-webhook` | 自定义机器人 Webhook 发消息 |
-
----
-
-## search — 搜索群聊
-
-```
-Usage:
-  dws chat search [flags]
-Example:
-  dws chat search --query "项目冲刺" --format json
-Flags:
-      --query string    搜索关键词 (必填)
-      --cursor string   分页游标（首页留空）
-```
-
----
-
-## group create — 创建群
-
-```
-Usage:
-  dws chat group create [flags]
-Example:
-  dws chat group create --name "Q1 项目冲刺群" --users userId1,userId2,userId3 --format json
-Flags:
-      --name string    群名称 (必填)
-      --users string   群成员 userId 列表，逗号分隔 (必填)
-```
-
-> 当前用户自动作为群主加入，无需在 --users 中重复传入。
-
----
-
-## group members list — 查看群成员列表
-
-```
-Usage:
-  dws chat group members list [flags]
-Example:
-  dws chat group members list --id <openConversationId> --format json
-Flags:
-      --id string       群会话 ID (必填)
-      --cursor string   分页游标
-```
-
----
-
-## group members add — 添加群成员
-
-```
-Usage:
-  dws chat group members add [flags]
-Example:
-  dws chat group members add --id <openConversationId> --users userId1,userId2 --format json
-Flags:
-      --id string      群会话 ID (必填)
-      --users string   要添加的 userId 列表，逗号分隔 (必填)
-```
-
----
-
-## group members remove — 移除群成员
-
-> ⚠️ 危险操作：执行前必须向用户确认，同意后才加 `--yes`。
-
-```
-Usage:
-  dws chat group members remove [flags]
-Example:
-  dws chat group members remove --id <openConversationId> --users userId1,userId2 --format json
-Flags:
-      --id string      群会话 ID (必填)
-      --users string   要移除的 userId 列表，逗号分隔 (必填)
-```
-
----
-
-## group members add-bot — 添加机器人到群
-
-```
-Usage:
-  dws chat group members add-bot [flags]
-Example:
-  dws chat group members add-bot --id <openConversationId> --robot-code <robotCode> --format json
-Flags:
-      --id string           群会话 ID (必填)
-      --robot-code string   机器人 code (必填)
-```
-
----
-
-## group rename — 修改群名称
-
-```
-Usage:
-  dws chat group rename [flags]
-Example:
-  dws chat group rename --id <openConversationId> --name "新群名" --format json
-Flags:
-      --id string     群会话 ID (必填)
-      --name string   新群名称 (必填)
-```
-
----
-
-## bot search — 搜索我的机器人
-
-```
-Usage:
-  dws chat bot search [flags]
-Example:
-  dws chat bot search --name "考勤" --format json
-Flags:
-      --name string   机器人名称（模糊搜索）
-      --page int      页码（默认 1）
-      --size int      每页数量（默认 50）
-```
-
----
-
-## message send-by-bot — 机器人发消息
-
-支持两种模式：群聊发送 和 批量单聊发送，通过 `--group` 和 `--users` 互斥区分。
-
-> ⚠️ **多机器人场景必须传 `--client-id`**：当配置了多个机器人账号时，必须通过 `--client-id` 显式指定使用哪个机器人的凭据发送消息。`--client-id` 的值就是当前对话机器人的 clientId（即 DingTalk AppKey），可从会话上下文的 `AccountId` 对应的配置中获取。**如果不传 `--client-id`，dws 会使用默认登录的机器人凭据，可能导致"串台"——用错误的机器人身份发送消息。**
-
-### 群聊发送
-```
-Usage:
-  dws chat message send-by-bot [flags]
-Example:
-  dws chat message send-by-bot --client-id <clientId> --robot-code <code> --group <openConversationId> \
-    --title "日报提醒" --text "请提交今日日报" --format json
-Flags:
-      --client-id string    机器人的 clientId / AppKey（多机器人场景必填，确保用正确的机器人身份发送）
-      --robot-code string   机器人 code (必填)
-      --group string        群会话 ID (必填，与 --users 互斥)
-      --title string        消息标题 (必填)
-      --text string         消息内容，支持 Markdown (必填)
-```
-
-### 批量单聊发送
-```
-Usage:
-  dws chat message send-by-bot [flags]
-Example:
-  dws chat message send-by-bot --client-id <clientId> --robot-code <code> --users "user1,user2" \
-    --title "通知" --text "会议已取消" --format json
-Flags:
-      --client-id string    机器人的 clientId / AppKey（多机器人场景必填，确保用正确的机器人身份发送）
-      --robot-code string   机器人 code (必填)
-      --users string        用户 ID 列表，逗号分隔，最多 20 个 (必填，与 --group 互斥)
-      --title string        消息标题 (必填)
-      --text string         消息内容，支持 Markdown (必填)
-```
-
-> ⚠️ `--group` 和 `--users` 互斥：群聊用 `--group`，单聊用 `--users`，不能同时传。
-
----
-
-## message recall-by-bot — 机器人撤回消息
-
-支持两种模式：群聊撤回 和 批量单聊撤回。
-
-### 群聊撤回
-```
-Usage:
-  dws chat message recall-by-bot [flags]
-Example:
-  dws chat message recall-by-bot --client-id <clientId> --robot-code <code> --group <openConversationId> \
-    --keys "key1,key2" --format json
-Flags:
-      --client-id string    机器人的 clientId / AppKey（多机器人场景必填）
-      --robot-code string   机器人 code (必填)
-      --group string        群会话 ID (必填，与批量单聊互斥)
-      --keys string         消息 key 列表，逗号分隔 (必填)
-```
-
-### 批量单聊撤回
-```
-Usage:
-  dws chat message recall-by-bot [flags]
-Example:
-  dws chat message recall-by-bot --client-id <clientId> --robot-code <code> --keys "key1,key2" --format json
-Flags:
-      --client-id string    机器人的 clientId / AppKey（多机器人场景必填）
-      --robot-code string   机器人 code (必填)
-      --keys string         消息 key 列表，逗号分隔 (必填)
-```
-
-> ⚠️ 消息 key 从 `send-by-bot` 返回结果中提取。
-
----
-
-## message send-by-webhook — 自定义机器人 Webhook 发消息
-
-```
-Usage:
-  dws chat message send-by-webhook [flags]
-Example:
-  dws chat message send-by-webhook --token <robotToken> \
-    --title "告警" --text "CPU 使用率超过 90%" --format json
-Flags:
-      --token string        自定义机器人 Webhook Token (必填)
-      --title string        消息标题 (必填)
-      --text string         消息内容 (必填)
-      --at-all              @所有人
-      --at-mobiles string   @指定手机号列表，逗号分隔
-      --at-users string     @指定用户 ID 列表，逗号分隔
-```
-
----
-
-## 意图判断
-
-- 用户说"搜索一个群" → `search`
-- 用户说"帮我建个群" → `group create`
-- 用户说"看看群里有谁" → `group members list`
-- 用户说"把张三拉进群" → 先 `contact user search` 获取 userId，再 `group members add`
-- 用户说"把张三移出群" → 先 `contact user search` 获取 userId，再 `group members remove`（⚠️ 需确认）
-- 用户说"改一下群名" → `group rename`
-- 用户说"让机器人在群里发通知" → `message send-by-bot --group`
-- 用户说"机器人给张三发消息" → 先 `contact user search` 获取 userId，再 `message send-by-bot --users`
-- 用户说"通过 Webhook 发告警" / 用户有 Webhook Token → `message send-by-webhook`
-- 用户说"撤回机器人消息" → `message recall-by-bot`
-- 用户说"查一下我的机器人" → `bot search`
-- 用户说"把机器人加到群里" → `group members add-bot`
-
-**关键区分**: `send-by-bot`(企业内部机器人，需 robotCode) vs `send-by-webhook`(自定义机器人 Webhook，需 token)
-
-## 核心工作流
-
-```bash
-# ── 工作流: 建群并添加机器人 ──
-
-# 1. 搜索同事 userId
-dws contact user search --keyword "张三" --format json
-
-# 2. 创建群
-dws chat group create --name "项目群" --users <userId1>,<userId2> --format json
-
-# 3. 搜索机器人
-dws chat bot search --format json
-
-# 4. 添加机器人到群
-dws chat group members add-bot --id <openConversationId> --robot-code <code> --format json
-```
-
-```bash
-# ── 工作流: 机器人群发消息 ──
-
-# 1. 搜索可用机器人
-dws chat bot search --format json
-
-# 2. 发送群消息（多机器人场景必须加 --client-id，使用当前对话机器人的 clientId）
-dws chat message send-by-bot --client-id <clientId> --robot-code <code> --group <groupId> \
-  --title "通知" --text "内容" --format json
-```
-
-```bash
-# ── 工作流: Webhook 告警 ──
-
-# 直接通过 Webhook Token 发送
-dws chat message send-by-webhook --token <token> \
-  --title "告警" --text "服务异常" --at-all --format json
-```
-
-## 上下文传递表
-
-| 操作 | 从返回中提取 | 用于 |
-|------|-------------|------|
-| `search` | openConversationId | `group members` / `group rename` / `group members add` / `send-by-bot --group` |
-| `group create` | openConversationId | 同上 |
-| `bot search` | robotCode | `send-by-bot` / `recall-by-bot` / `add-bot` |
-| `message send-by-bot` | processQueryKey | `recall-by-bot --keys` |

package/skills/dws-cli/references/products/contact.md

@@ -1,108 +0,0 @@
-# 通讯录 (contact) 命令参考
-
-## 命令总览
-
-### user (人员查询)
-
-#### 获取当前用户信息
-```
-Usage:
-  dws contact user get-self [flags]
-Example:
-  dws contact user get-self
-```
-
-#### 按关键词搜索用户
-```
-Usage:
-  dws contact user search [flags]
-Example:
-  dws contact user search --keyword "张三"
-Flags:
-      --keyword string   搜索关键词 (必填)
-```
-
-#### 按手机号搜索用户
-```
-Usage:
-  dws contact user search-mobile [flags]
-Example:
-  dws contact user search-mobile --mobile 13800138000
-Flags:
-      --mobile string   手机号 (必填)
-```
-
-#### 批量获取用户详情
-```
-Usage:
-  dws contact user get [flags]
-Example:
-  dws contact user get --ids userId1,userId2
-Flags:
-      --ids string   用户 ID 列表，逗号分隔 (必填)
-```
-
-### dept (部门查询)
-
-#### 搜索部门
-```
-Usage:
-  dws contact dept search [flags]
-Example:
-  dws contact dept search --keyword "技术部"
-Flags:
-      --keyword string   搜索关键词 (必填)
-```
-
-#### 查看部门成员
-```
-Usage:
-  dws contact dept list-members [flags]
-Example:
-  dws contact dept list-members --ids 12345,67890
-Flags:
-      --ids string   部门 ID 列表，逗号分隔 (必填)
-```
-
-## 意图判断
-
-用户说"我是谁/我的信息" → `user get-self`
-用户说"找人/搜人" → `user search`（按名字）或 `user search-mobile`（按手机号）
-用户说"查用户详情" → `user get`（需 userId）
-用户说"找部门/哪个部门" → `dept search`
-用户说"部门有谁/部门成员" → `dept list-members`（需 deptId）
-
-## 核心工作流
-
-```bash
-# 1. 查看自己的信息 — 提取 userId
-dws contact user get-self --format json
-
-# 2. 按名字搜索同事 — 提取 userId
-dws contact user search --keyword "张三" --format json
-
-# 3. 查看部门结构 — 提取 deptId
-dws contact dept search --keyword "技术部" --format json
-
-# 4. 查看部门成员
-dws contact dept list-members --ids <deptId> --format json
-```
-
-## 上下文传递表
-
-| 操作 | 提取 | 用于 |
-|------|------|------|
-| `user get-self/search` | `userId` | 其他产品中的 --users/--executor 参数 |
-| `user get-self/search` | `orgAuthEmail` | mail message send 的 --to/--cc (跨产品) |
-| `dept search` | `deptId` | dept list-members 的 --ids |
-
-## 注意事项
-
-- `user get-self` 是获取 userId 的最快方式，其他产品的 --users/--executor 都需要 userId
-- `user get --ids` 和 `dept list-members --ids` 都支持批量查询，逗号分隔
-
-## 自动化脚本
-
-| 脚本 | 场景 | 用法 |
-|------|------|------|
-| [contact_dept_members.py](../../scripts/contact_dept_members.py) | 按部门名称搜索并列出所有成员 | `python contact_dept_members.py --keyword "技术部"` |

package/skills/dws-cli/references/products/ding.md

@@ -1,57 +0,0 @@
-# DING 消息 (ding) 命令参考
-
-## 命令总览
-
-### 发送 DING 消息
-```
-Usage:
-  dws ding message send [flags]
-Example:
-  dws ding message send --robot-code <ROBOT_CODE> --users <USER_ID_1>,<USER_ID_2> --content "请查看"
-Flags:
-      --content string      消息内容 (必填)
-      --robot-code string   机器人 ID (必填, 可从 应用管理→机器人 获取, 或设 DINGTALK_DING_ROBOT_CODE)
-      --users string         接收人 userId 列表 (必填)
-      --type string         提醒类型: app/sms/call (默认 app)
-```
-
-### 撤回 DING 消息
-```
-Usage:
-  dws ding message recall [flags]
-Example:
-  dws ding message recall --robot-code <ROBOT_CODE> --id <OPEN_DING_ID>
-Flags:
-      --id string           DING 消息 ID (必填)
-      --robot-code string   机器人 ID (必填, 或设 DINGTALK_DING_ROBOT_CODE)
-```
-
-## 意图判断
-
-用户说"DING 一下/紧急通知/电话提醒" → `message send`
-用户说"撤回 DING" → `message recall`
-
-关键区分:
-- ding(紧急提醒, 支持电话/短信) vs bot(常规群/单聊消息)
-- sms/call 类型有通信费用
-
-## 核心工作流
-
-```bash
-# 应用内 DING (免费)
-dws ding message send --robot-code <ROBOT_CODE> --type app --users userId1,userId2 --content "请查看" --format json
-
-# 电话 DING (紧急, 有成本!)
-dws ding message send --robot-code <ROBOT_CODE> --type call --users userId1 --content "紧急告警" --format json
-
-# 撤回
-dws ding message recall --robot-code <ROBOT_CODE> --id <OPEN_DING_ID> --format json
-```
-## 上下文传递表
-| 操作 | 提取 | 用于 |
-|------|------|------|
-| `message send` | `openDingId` | message recall 的 --id |
-## 注意事项
-- `--robot-code` 从钉钉开放平台 **应用管理 → 机器人** 中获取，也可设环境变量 `DINGTALK_DING_ROBOT_CODE`
-- sms/call 类型有通信费用，使用前需和用户确认
-- 默认 `--type app`（应用内 DING，免费）