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

package/skills/dws-cli/references/intent-guide.md

@@ -1,114 +0,0 @@
-# 意图路由指南
-
-当用户请求难以判断归属哪个产品时，参考本指南。
-
-## 易混淆场景快速对照表
-
-| 用户说... | 真实意图 | 应该用 | 不要用 | 理由 |
-|-----------|----------|--------|--------|------|
-| "搜一下 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 --keyword "张三" --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 --keyword "张三" --format json
-
-# 2. 创建待办
-dws todo task create --title "任务内容" --executors <USER_ID> --format json
-```

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

@@ -1,452 +0,0 @@
-# AI表格 (aitable) 命令参考
-
-## 文档地址 (URI)
-
-所有 AI 表格操作完成后，可通过以下 URI 直接访问对应文档：
-
-| 资源 | URI 格式 |
-|------|----------|
-| Base 文档 | `https://alidocs.dingtalk.com/i/nodes/{baseId}` |
-| 模板预览 | `https://docs.dingtalk.com/table/template/{templateId}` |
-
-> 💡 **操作后请返回文档 URI**：每次执行 base list/search/create/get 操作后，从返回数据中提取 `baseId`，拼接为 `https://alidocs.dingtalk.com/i/nodes/{baseId}` 返回给用户，方便直接点击打开。
-
-## 命令总览
-
-### base (Base 管理)
-
-#### 获取 AI 表格列表
-```
-Usage:
-  dws aitable base list [flags]
-Example:
-  dws aitable base list
-  dws aitable base list --limit 5 --cursor NEXT_CURSOR
-Flags:
-      --cursor string   分页游标，首次不传
-      --limit int       每页数量，默认 10，最大 10
-```
-
-返回 baseId 与 baseName。
-
-> 📎 **操作后返回文档链接**：遍历返回的每个 base，拼接 `https://alidocs.dingtalk.com/i/nodes/{baseId}` 返回给用户。
-
-> ⚠️ **注意**：`base list` 仅返回**最近访问过**的 Base，不是全部 Base。
-> 新创建的 Base 如果尚未在钉钉前端打开过，可能不会出现在此列表中。
-> 如需查找特定 Base，请使用 `base search`；如果刚创建完，直接使用 `create` 返回的 `baseId` 即可。
-
-#### 搜索 AI 表格
-```
-Usage:
-  dws aitable base search [flags]
-Example:
-  dws aitable base search --query "项目管理"
-Flags:
-      --cursor string   分页游标，首次不传
-      --query string    Base 名称关键词，建议至少 2 个字符 (必填)
-```
-
-#### 获取 AI 表格信息
-```
-Usage:
-  dws aitable base get [flags]
-Example:
-  dws aitable base get --base-id <BASE_ID>
-Flags:
-      --base-id string   Base 唯一标识 (必填)
-```
-
-返回 baseName、tables、dashboards 的 summary 信息（不含字段与记录详情）。
-后续如需 tableId，优先从这里读取。
-
-> 📎 **文档地址**：`https://alidocs.dingtalk.com/i/nodes/{baseId}`
-
-#### 创建 AI 表格
-```
-Usage:
-  dws aitable base create [flags]
-Example:
-  dws aitable base create --name "项目跟踪"
-Flags:
-      --name string          Base 名称，1-50 字符 (必填)
-      --template-id string   模板 ID (可选，可通过 template search 获取)
-```
-
-> 💡 **创建后直接使用返回的 `baseId`**，无需再调用 `base list` 或 `base search` 查找。
-> 后续可直接 `base get --base-id <返回的baseId>` 获取 tableId，或 `table create --base-id <返回的baseId>` 创建数据表。
->
-> 📎 **文档地址**：`https://alidocs.dingtalk.com/i/nodes/{返回的baseId}`
-
-#### 更新 AI 表格
-```
-Usage:
-  dws aitable base update [flags]
-Example:
-  dws aitable base update --base-id <BASE_ID> --name "新名称"
-Flags:
-      --base-id string   目标 Base ID (必填)
-      --desc string      备注文本
-      --name string      新名称，1-50 字符 (必填)
-```
-
-#### 删除 AI 表格
-```
-Usage:
-  dws aitable base delete [flags]
-Example:
-  dws aitable base delete --base-id <BASE_ID> --yes
-Flags:
-      --base-id string   待删除 Base ID (必填)
-      --reason string    删除原因
-```
-
-高风险操作，不可逆。
-
-### table (数据表管理)
-
-#### 获取数据表
-```
-Usage:
-  dws aitable table get [flags]
-Example:
-  dws aitable table get --base-id <BASE_ID>
-  dws aitable table get --base-id <BASE_ID> --table-ids tbl1,tbl2
-Flags:
-      --base-id string     所属 Base ID (必填)
-      --table-ids string   Table ID 列表，逗号分隔，单次最多 10 个
-```
-
-返回 tableId、tableName、description、fields 目录、views 目录。不传 table-ids 返回全部表。
-
-> 📎 **文档地址**：`https://alidocs.dingtalk.com/i/nodes/{baseId}`
-
-#### 创建数据表
-```
-Usage:
-  dws aitable table create [flags]
-Example:
-  dws aitable table create --base-id <BASE_ID> --name "任务表" \
-    --fields '[{"fieldName":"任务名称","type":"text"},{"fieldName":"优先级","type":"singleSelect","config":{"options":[{"name":"高"},{"name":"中"},{"name":"低"}]}}]'
-Flags:
-      --base-id string   目标 Base ID (必填)
-      --fields string    初始字段 JSON 数组，至少 1 个，单次最多 15 个 (必填)
-      --name string      表格名称，1-100 字符 (必填)
-```
-
-> 💡 **创建后直接使用返回的 `tableId`**，无需再调 `table get` 查找。
-> 后续可直接 `field create --table-id <返回的tableId>` 补充字段，或 `record create` 写入数据。
->
-> 📎 **文档地址**：`https://alidocs.dingtalk.com/i/nodes/{baseId}`
-
-#### 更新数据表
-```
-Usage:
-  dws aitable table update [flags]
-Example:
-  dws aitable table update --base-id <BASE_ID> --table-id <TABLE_ID> --name "新表名"
-Flags:
-      --base-id string    所属 Base ID (必填)
-      --name string       新表名 (必填)
-      --table-id string   目标 Table ID (必填)
-```
-
-#### 删除数据表
-```
-Usage:
-  dws aitable table delete [flags]
-Example:
-  dws aitable table delete --base-id <BASE_ID> --table-id <TABLE_ID> --yes
-Flags:
-      --base-id string    目标 Base ID (必填)
-      --reason string     删除原因
-      --table-id string   将被删除的 Table ID (必填)
-```
-
-不可逆。若为 Base 中最后一张表，删除会失败。
-
-### field (字段管理)
-
-#### 获取字段详情
-```
-Usage:
-  dws aitable field get [flags]
-Example:
-  dws aitable field get --base-id <BASE_ID> --table-id <TABLE_ID>
-  dws aitable field get --base-id <BASE_ID> --table-id <TABLE_ID> --field-ids fld1,fld2
-Flags:
-      --base-id string     Base ID (必填)
-      --field-ids string   字段 ID 列表，逗号分隔，单次最多 10 个
-      --table-id string    Table ID (必填)
-```
-
-返回字段的完整配置（含 options 等）。在 table get 拿到字段目录后，按需展开少量字段的完整配置。
-
-#### 创建字段
-```
-Usage:
-  dws aitable field create [flags]
-Example:
-  dws aitable field create --base-id <BASE_ID> --table-id <TABLE_ID> \
-    --fields '[{"fieldName":"状态","type":"singleSelect","config":{"options":[{"name":"待办"},{"name":"进行中"},{"name":"已完成"}]}}]'
-Flags:
-      --base-id string    Base ID (必填)
-      --fields string     待新增字段 JSON 数组，至少 1 个，单次最多 15 个 (必填)
-      --table-id string   Table ID (必填)
-```
-
-允许部分成功，返回结果逐项标明成功/失败状态。
-
-#### 更新字段
-```
-Usage:
-  dws aitable field update [flags]
-Example:
-  dws aitable field update --base-id <BASE_ID> --table-id <TABLE_ID> --field-id <FIELD_ID> --name "新字段名"
-  dws aitable field update --base-id <BASE_ID> --table-id <TABLE_ID> --field-id <FIELD_ID> --config '{"options":[{"name":"A"},{"name":"B"}]}'
-Flags:
-      --base-id string    Base ID (必填)
-      --config string     字段配置 JSON (不修改时省略)
-      --field-id string   Field ID (必填)
-      --name string       新字段名称 (不修改时省略)
-      --table-id string   Table ID (必填)
-```
-
-不可变更字段类型。更新 singleSelect/multipleSelect 的 options 时需传入完整列表，已有选项应回传原 id。
-
-#### 删除字段
-```
-Usage:
-  dws aitable field delete [flags]
-Example:
-  dws aitable field delete --base-id <BASE_ID> --table-id <TABLE_ID> --field-id <FIELD_ID> --yes
-Flags:
-      --base-id string    Base ID (必填)
-      --field-id string   待删除字段 ID (必填)
-      --table-id string   Table ID (必填)
-```
-
-不可逆。禁止删除主字段和最后一个字段。
-
-### record (记录管理)
-
-#### 查询记录
-```
-Usage:
-  dws aitable record query [flags]
-Example:
-  dws aitable record query --base-id <BASE_ID> --table-id <TABLE_ID>
-  dws aitable record query --base-id <BASE_ID> --table-id <TABLE_ID> --record-ids rec1,rec2
-  dws aitable record query --base-id <BASE_ID> --table-id <TABLE_ID> --keyword "关键词" --limit 50
-Flags:
-      --base-id string      Base ID (必填)
-      --cursor string       分页游标，首次不传
-      --field-ids string    返回字段 ID 列表，逗号分隔，单次最多 100 个
-      --filters string      结构化过滤条件 JSON
-      --keyword string     全文关键词搜索
-      --limit int           单次最大记录数，默认 100，最大 100
-      --record-ids string   指定记录 ID 列表，逗号分隔，单次最多 100 个
-      --sort string         排序条件 JSON 数组
-      --table-id string     Table ID (必填)
-```
-
-两种模式: 按 ID 取（传 record-ids，忽略 filters/sort）或条件查（filters+sort+cursor 分页）。
-
-filters 结构：`{"operator":"and|or","operands":[{"operator":"<op>","operands":["<fieldId>","<value>"]}]}`
-
-> 💡 **singleSelect/multipleSelect 过滤**：filters 中可传 option id 或 option name，但建议优先用 **option id**（通过 `field get` 获取），更可靠。
-> 写入时（record create/update）可直接传 option name。
-
-> 💡 **减少响应体积**：字段较多时，用 `--field-ids` 仅返回需要的字段，可显著减少返回数据量。
-
-#### 新增记录
-```
-Usage:
-  dws aitable record create [flags]
-Example:
-  dws aitable record create --base-id <BASE_ID> --table-id <TABLE_ID> \
-    --records '[{"cells":{"fldTextId":"文本内容","fldNumId":123}}]'
-Flags:
-      --base-id string    Base ID (必填)
-      --records string    记录列表 JSON 数组，单次最多 100 条 (必填)
-      --table-id string   Table ID (必填)
-```
-
-> ⚠️ **常见错误（严格避免）**：
-> - **参数名是 `--records`**，不是 `--data`
-> - **cells 的 key 必须是 fieldId**（如 `fldXXX`），**不是字段名称**（如 `"课程名称"`）
-> - 必须先 `table get` 获取 fieldId，再写入记录
-
-```bash
-# 正确流程：先获取 fieldId
-dws aitable table get --base-id <BASE_ID> --table-id <TABLE_ID> --format json
-# 从返回中提取 fieldId（如 fldABC123）
-
-# 再用 fieldId 写入记录
-dws aitable record create --base-id <BASE_ID> --table-id <TABLE_ID> \
-  --records '[{"cells":{"fldABC123":"Python入门"}}]' --format json
-```
-
-#### 更新记录
-```
-Usage:
-  dws aitable record update [flags]
-Example:
-  dws aitable record update --base-id <BASE_ID> --table-id <TABLE_ID> \
-    --records '[{"recordId":"recXXX","cells":{"fldStatusId":"已完成"}}]'
-Flags:
-      --base-id string    Base ID (必填)
-      --records string    待更新记录 JSON 数组，单次最多 100 条 (必填)
-      --table-id string   Table ID (必填)
-```
-
-只需传入需修改的字段，未传入的保持原值。每条记录必须含 recordId 和 cells。
-
-#### 删除记录
-```
-Usage:
-  dws aitable record delete [flags]
-Example:
-  dws aitable record delete --base-id <BASE_ID> --table-id <TABLE_ID> --record-ids rec1,rec2 --yes
-Flags:
-      --base-id string      Base ID (必填)
-      --record-ids string   待删除记录 ID 列表，逗号分隔，最多 100 条 (必填)
-      --table-id string     Table ID (必填)
-```
-
-不可逆。调用前建议先 record query 确认目标记录。
-
-### attachment (附件管理)
-
-> 🛑 **STOP — 不要使用钉盘 (drive) 上传！** 钉盘 fileId 无法写入 attachment 字段。必须使用以下流程。
-
-#### 准备附件上传
-```
-Usage:
-  dws aitable attachment upload [flags]
-Example:
-  dws aitable attachment upload --base-id <BASE_ID> --file-name report.xlsx --size 204800
-  dws aitable attachment upload --base-id <BASE_ID> --file-name photo.png --size 1024 --mime-type image/png
-Flags:
-      --base-id string     Base ID (必填)
-      --file-name string   文件名，必须含扩展名 (必填)
-      --size int           文件大小（字节），>0 (必填)
-      --mime-type string   MIME type（不传时根据扩展名推断）
-```
-
-#### 附件上传完整流程（推荐：使用脚本，2 步完成）
-
-```bash
-# 步骤 1: 使用脚本一键上传（内部自动完成 prepare + PUT）
-python3 scripts/upload_attachment.py <BASE_ID> /path/to/report.pdf
-# 输出: { "fileToken": "ft_xxx", "fileName": "report.pdf", "size": 204800 }
-
-# 步骤 2: 在 record create/update 中使用 fileToken 写入
-dws aitable record create --base-id <BASE_ID> --table-id <TABLE_ID> \
-  --records '[{"cells":{"fldAttachId":[{"fileToken":"ft_xxx"}]}}]' --format json
-```
-
-> ⚠️ `uploadUrl` 有时效性（`expiresAt`），脚本会自动在获取后立即上传。
-
-### template (模板搜索)
-
-#### 搜索模板
-```
-Usage:
-  dws aitable template search [flags]
-Example:
-  dws aitable template search --query "项目管理"
-Flags:
-      --cursor string   分页游标，首次不传
-      --limit int       每页返回数量，默认 10，最大 30
-      --query string    模板名称关键词 (必填)
-```
-
-返回 templateId 可用于 `base create --template-id`。
-
-> 📎 **模板预览地址**：`https://docs.dingtalk.com/table/template/{templateId}`
-
-## 意图判断
-
-用户说"表格/多维表/AI表格":
-- 查看/列表 → `base list`
-- 搜索 → `base search`
-- 详情 → `base get`
-- 创建 → `base create`
-- 修改 → `base update`
-- 删除 → `base delete` [危险]
-
-用户说"数据表/子表/table":
-- 查看 → `table get`
-- 创建 → `table create`
-- 重命名 → `table update`
-- 删除 → `table delete` [危险]
-
-用户说"字段/列/column":
-- 查看 → `field get`
-- 添加 → `field create`
-- 修改 → `field update`
-- 删除 → `field delete` [危险]
-
-用户说"记录/行/数据/row":
-- 查看/搜索 → `record query`（先 `table get` 获取 fieldId）
-- 添加/写入 → `record create`（先 `table get` 必须!）
-- 修改/更新 → `record update`（需 recordId，先 `record query`）
-- 删除 → `record delete` [危险]（需 recordId）
-
-用户说"模板" → `template search`
-
-关键区分: base=表格文件, table=数据表, field=列, record=行
-
-## 核心工作流
-
-```bash
-# 1. 搜索/列出 Base — 提取 baseId
-dws aitable base search --query "项目" --format json
-
-# 2. 获取 Base 信息 — 提取 tableId
-dws aitable base get --base-id <BASE_ID> --format json
-
-# 3. 获取表结构 — 提取 fieldId
-dws aitable table get --base-id <BASE_ID> --table-id <TABLE_ID> --format json
-
-# 4. 查询记录
-dws aitable record query --base-id <BASE_ID> --table-id <TABLE_ID> --format json
-
-# 5. 新增记录 (cells 用 fieldId 作 key)
-dws aitable record create --base-id <BASE_ID> --table-id <TABLE_ID> \
-  --records '[{"cells":{"fldXXX":"值"}}]' --format json
-```
-
-## 上下文传递表
-
-| 操作 | 从返回中提取 | 用于 |
-|------|-------------|------|
-| `base list/search` | `baseId` | 所有后续命令的 --base-id，拼接文档 URI |
-| `base create` | `baseId` | 后续命令 + 文档 URI |
-| `base get` | `tables[].tableId` | --table-id |
-| `table get` | `fields[].fieldId` | record 操作的 cells key, field get/update/delete |
-| `record query` | `recordId` | record update/delete |
-| `template search` | `templateId` | base create --template-id，拼接模板预览 URI |
-
-## 注意事项
-
-- 所有操作使用 ID（baseId/tableId/fieldId/recordId），不使用名称
-- records 的 cells key 是 fieldId，不是字段名称
-
-### cells 写入/读取格式速查
-
-| 字段类型 | 写入格式 | 读取返回格式 |
-|---------|---------|------------|
-| text | `"字符串"` | `"字符串"` |
-| number | `123` | `"123"` |
-| singleSelect | `"选项名"` 或 `{"id":"xxx"}` | `{"id":"xxx","name":"选项名"}` |
-| multipleSelect | `["选项A","选项B"]` | `[{"id":"x","name":"选项A"},...]` |
-| date | `"2026-03-13"` 或时间戳 | ISO 日期字符串 |
-| checkbox | `true`/`false` | `true`/`false` |
-| user | `[{"userId":"xxx"}]` | `[{"corpId":"xxx","userId":"xxx"}]` |
-| attachment | `[{"fileToken":"ft_xxx"}]` ⚠️需先走 attachment upload 3步流程 | `[{"url":"...","filename":"...","size":N}]` |
-| url | `{"text":"显示文本","link":"https://..."}` | 同写入 |
-| richText | `{"markdown":"**加粗**"}` | `{"markdown":"..."}` |
-| group | `[{"cid":"xxx"}]` (注意: key 是 cid，不是 openConversationId) | 同写入 |
-
-- 详见 [field-rules.md](../field-rules.md) 和 [error-codes.md](../error-codes.md)

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

@@ -1,93 +0,0 @@
-# 考勤 (attendance) 命令参考
-
-## 命令总览
-
-### 查询个人考勤详情
-```
-Usage:
-  dws attendance record get [flags]
-Example:
-  dws attendance record get --user <USER_ID> --date 2026-03-08
-Flags:
-      --date string   查询日期, 格式 YYYY-MM-DD (必填)
-      --user string   钉钉用户 ID (必填)
-```
-
-### 批量查询员工班次信息
-```
-Usage:
-  dws attendance shift list [flags]
-Example:
-  dws attendance shift list --users userId1,userId2 --start 2026-03-03 --end 2026-03-07
-Flags:
-      --end string     结束日期, 格式 YYYY-MM-DD (必填)
-      --start string   开始日期, 格式 YYYY-MM-DD (必填)
-      --users string   用户 ID 列表, 逗号分隔, 最多 50 个 (必填)
-```
-
-返回每条记录含：用户 ID、工作日期、打卡类型（OnDuty/OffDuty）、计划打卡时间、是否休息日。间隔不超过 7 天，最多 50 人。
-
-### 查询某个人的考勤统计摘要
-```
-Usage:
-  dws attendance summary [flags]
-Example:
-  dws attendance summary --user USER_ID --date "2026-03-12 15:00:00"
-Flags:
-      --date string   工作日期, 格式 yyyy-MM-dd HH:mm:ss (必填)
-      --user string   钉钉用户 ID (必填)
-```
-
-### 查询考勤组与考勤规则
-```
-Usage:
-  dws attendance rules [flags]
-Example:
-  dws attendance rules --date 2026-03-14
-  dws attendance rules --date "2026-03-14 09:00:00"
-Flags:
-      --date string   考勤日期, 格式 YYYY-MM-DD 或 yyyy-MM-dd HH:mm:ss (必填)
-```
-
-查询考勤组/考勤规则。例如：我属于哪个考勤组、打卡范围是什么、弹性工时怎么算。
-
-## 意图判断
-
-用户说"打卡记录/出勤/考勤" → `record get`
-用户说"排班/班次/当班" → `shift list`
-用户说"考勤汇总/统计" → `summary`
-用户说"考勤组/考勤规则/打卡规则" → `rules`
-
-## 核心工作流
-
-```bash
-# 查看某人考勤
-dws attendance record get --user <USER_ID> --date 2026-03-08 --format json
-
-# 批量查排班
-dws attendance shift list --users userId1,userId2 \
-  --start 2026-03-03 --end 2026-03-07 --format json
-
-# 查看考勤统计摘要
-dws attendance summary --user <USER_ID> --date "2026-03-12 15:00:00" --format json
-
-# 查看考勤组和规则
-dws attendance rules --date 2026-03-14 --format json
-```
-## 上下文传递表
-| 操作 | 提取 | 用于 |
-|------|------|------|
-| `contact user get-self` | `userId` | record get 的 --user, shift list 的 --users, summary 的 --user |
-## 注意事项
-- `record get` 的 `--date` 格式: YYYY-MM-DD（如 `2026-03-08`），CLI 自动转换为毫秒时间戳
-- `shift list` 的 `--start/--end` 同样使用 YYYY-MM-DD 格式，间隔不超过 7 天
-- `summary` 的 `--date` 格式: yyyy-MM-dd HH:mm:ss（如 `2026-03-12 15:00:00`）
-- `rules` 的 `--date` 支持 YYYY-MM-DD 或 yyyy-MM-dd HH:mm:ss 两种格式
-- 用户 ID 需从 `contact user get-self` 或 `contact user search` 获取
-
-## 自动化脚本
-
-| 脚本 | 场景 | 用法 |
-|------|------|------|
-| [attendance_my_record.py](../../scripts/attendance_my_record.py) | 查看我今天/指定日期的考勤记录 | `python attendance_my_record.py today` |
-| [attendance_team_shift.py](../../scripts/attendance_team_shift.py) | 查询团队成员本周排班 | `python attendance_team_shift.py --users userId1,userId2` |