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

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

@@ -1,162 +0,0 @@
-# 日志 (report) 命令参考
-
-## 命令总览
-
-### 获取日志模版列表
-```
-Usage:
-  dws report template list [flags]
-Example:
-  dws report template list
-```
-
-### 获取日志模版详情
-```
-Usage:
-  dws report template detail [flags]
-Example:
-  dws report template detail --name <templateName>
-Flags:
-      --name string   模版名称 (必填)
-```
-
-### 创建日志
-```
-Usage:
-  dws report create [flags]
-Example:
-  dws report create --template-id <templateId> \
-    --contents '[{"key":"今日完成","sort":"0","content":"完成了需求评审","contentType":"markdown","type":"1"}]' \
-    --format json
-  dws report create --template-id <templateId> \
-    --contents '[{"key":"今日完成","sort":"0","content":"内容","contentType":"markdown","type":"1"}]' \
-    --dd-from "script" --to-chat --to-user-ids "userId1,userId2" --format json
-Flags:
-      --template-id string   日志模版 ID (必填)，从 template list 返回中取
-      --contents string      日志内容 JSON 数组 (必填)，每项须含 key/sort/content/contentType/type
-      --dd-from string       创建来源标识 (默认 dws)
-      --to-chat string       是否发送到日志接收人单聊 (传 "true" 发送)
-      --to-user-ids string   接收人 userId，逗号分隔 (可选)
-```
-
-**`contents` 数组元素**（与 MCP `create_report` 一致）：
-
-| 字段 | 说明 |
-|------|------|
-| `key` | 控件标题，与 template detail 一致 |
-| `sort` | 控件排序，与 template detail 一致 |
-| `content` | 填写值；文本类可写 Markdown |
-| `contentType` | `type` 为文本 (`1`) 时用 `markdown`，其余类型用 `origin` |
-| `type` | `1` 文本、`2` 数字、`3` 单选、`5` 日期、`7` 多选 |
-
-shell 中传 `--contents` 时外层建议用**单引号**包住整段 JSON。
-
-### 获取日志详情
-```
-Usage:
-  dws report detail [flags]
-Example:
-  dws report detail --report-id <reportId>
-Flags:
-      --report-id string   日志 ID (必填)
-```
-
-### 日志收件箱列表
-```
-Usage:
-  dws report list [flags]
-Example:
-  dws report list --start "2026-03-10T00:00:00+08:00" --end "2026-03-10T23:59:59+08:00" --cursor 0 --size 20
-Flags:
-      --cursor string   分页游标 (必填)
-      --end string      结束时间 ISO-8601 (如 2026-03-10T23:59:59+08:00) (必填)
-      --size string     每页大小 (必填)
-      --start string    开始时间 ISO-8601 (如 2026-03-10T00:00:00+08:00) (必填)
-```
-
-### 获取日志统计数据
-```
-Usage:
-  dws report stats [flags]
-Example:
-  dws report stats --report-id <reportId>
-Flags:
-      --report-id string   日志 ID (必填)
-```
-
-### 查询当前人创建的日志列表
-```
-Usage:
-  dws report sent [flags]
-Example:
-  dws report sent --cursor 0 --size 20
-  dws report sent --cursor 0 --size 20 --start "2026-03-10T00:00:00+08:00" --end "2026-03-10T23:59:59+08:00"
-  dws report sent --cursor 0 --size 20 --template-name "日报"
-Flags:
-      --cursor string         分页游标，首次传 0 (默认 0)
-      --size string           每页条数，最大 20 (默认 20)
-      --start string          创建开始时间 ISO-8601 (默认最近 30 天)
-      --end string            创建结束时间 ISO-8601 (默认最近 30 天)
-      --modified-start string 修改开始时间 ISO-8601 (可选)
-      --modified-end string   修改结束时间 ISO-8601 (可选)
-      --template-name string  日志模版名称 (可选，不传查全部)
-```
-
-## 意图判断
-
-用户说"查日志/看日报" → `list` 获取列表，再 `detail`
-用户说"写日报/提交周报/发日志/填日志" → 先 `template list` / `template detail` 取 `templateId` 与各控件 `key`/`sort`/类型，拼 `--contents` JSON，再 `create`
-用户说"日志统计/已读统计" → `stats`
-用户说"有什么日志模版" → `template list` 或 `template detail`
-用户说"我发过的日志/我创建的日志" → `sent`
-
-关键区分: report(钉钉日志模版汇报，含创建) vs doc(文档编辑) vs todo(待办任务)
-
-## 核心工作流
-
-```bash
-# 1. 获取当前用户可用的日志模版
-dws report template list --format json
-
-# 2. 按名称查看模版详情（含字段定义）
-dws report template detail --name "日报" --format json
-
-# 2b. 创建日志（从步骤 1/2 取 templateId 与 contents 字段）
-dws report create --template-id <templateId> \
-  --contents '[{"key":"今日完成","sort":"0","content":"完成了需求评审","contentType":"markdown","type":"1"}]' \
-  --format json
-
-# 3. 查看收件箱日志列表 — 提取 reportId
-dws report list --start "2026-03-10T00:00:00+08:00" --end "2026-03-10T23:59:59+08:00" \
-  --cursor 0 --size 20 --format json
-
-# 4. 查看日志详情
-dws report detail --report-id <reportId> --format json
-
-# 5. 查看日志统计（已读/未读）
-dws report stats --report-id <reportId> --format json
-
-# 6. 查看当前人创建的日志列表
-dws report sent --cursor 0 --size 20 --format json
-```
-
-## 上下文传递表
-
-| 操作 | 从返回中提取 | 用于 |
-|------|-------------|------|
-| `template list` | template 名称 | template detail 的 --name |
-| `template list` | `templateId`（或等价字段） | `create` 的 --template-id |
-| `template detail` | 各控件 `key`、`sort`、类型 | 拼 `create` 的 --contents JSON（含 contentType/type） |
-| `list` | `reportId` | detail / stats 的 --report-id |
-
-## 注意事项
-
-- `--start` / `--end` 使用 ISO-8601 格式（如 `2026-03-10T00:00:00+08:00`）
-- `template list` 不需要参数，直接返回当前用户可用的所有日志模版
-- `create` 前必须先查模版，勿猜测 `templateId` 或 `contents` 中的 `key`/`sort`；多控件时数组须覆盖模版必填项
-
-## 自动化脚本
-
-| 脚本 | 场景 | 用法 |
-|------|------|------|
-| [report_inbox_today.py](../../scripts/report_inbox_today.py) | 查看今天收到的日志列表及详情 | `python report_inbox_today.py` |

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

@@ -1,128 +0,0 @@
-# 单命令产品合集
-
-以下产品命令较少，合并参考。
-
----
-
-## devdoc — 开放平台文档
-
-### 搜索开放平台文档
-```
-Usage:
-  dws devdoc article search [flags]
-Example:
-  dws devdoc article search --keyword "OAuth2 接入" --page 1 --size 10
-Flags:
-      --keyword string   搜索关键词 (必填)
-      --page string      页码 (默认 1)
-      --size string      每页数量 (默认 10)
-```
-
-### 搜索错误码
-```
-Usage:
-  dws devdoc article search-error [flags]
-Example:
-  dws devdoc article search-error --keyword "403" --format json
-Flags:
-      --keyword string   错误码或关键词 (必填)
-```
-
----
-
-## oa — 审批
-
-### 查询可见审批流程
-```
-Usage:
-  dws oa approval list-forms [flags]
-Example:
-  dws oa approval list-forms --format json
-```
-
-### 查询审批实例详情
-```
-Usage:
-  dws oa approval detail --instance-id <ID> [flags]
-Example:
-  dws oa approval detail --instance-id <ID> --format json
-```
-
-### 查询审批记录
-```
-Usage:
-  dws oa approval records --instance-id <ID> [flags]
-Example:
-  dws oa approval records --instance-id <ID> --format json
-```
-
-### 查询待我审批的任务
-```
-Usage:
-  dws oa approval tasks [flags]
-Example:
-  dws oa approval tasks --format json
-```
-
-### 查询待我处理的审批
-```
-Usage:
-  dws oa approval pending [flags]
-Example:
-  dws oa approval pending --format json
-```
-
-### 查询我发起的审批
-```
-Usage:
-  dws oa approval initiated [flags]
-Example:
-  dws oa approval initiated --format json
-```
-
-### 同意审批
-```
-Usage:
-  dws oa approval approve --instance-id <ID> --task-id <TASK_ID> [flags]
-Example:
-  dws oa approval approve --instance-id <ID> --task-id <TASK_ID> --format json
-```
-
-### 拒绝审批
-```
-Usage:
-  dws oa approval reject --instance-id <ID> --task-id <TASK_ID> [flags]
-Example:
-  dws oa approval reject --instance-id <ID> --task-id <TASK_ID> --remark "不符合要求" --format json
-```
-
-### 撤销审批
-```
-Usage:
-  dws oa approval revoke --instance-id <ID> [flags]
-Example:
-  dws oa approval revoke --instance-id <ID> --format json
-```
-
----
-
-## 意图判断
-
-- 用户说"开发文档/API 文档/接口文档" → `devdoc article search`
-- 用户说"API 报错/错误码" → `devdoc article search-error`
-- 用户说"审批/请假/报销/出差" → `oa approval`
-- 用户说"同意审批/批准" → `oa approval approve`
-- 用户说"拒绝审批/驳回" → `oa approval reject`
-- 用户说"撤销审批/撤回" → `oa approval revoke`
-- 用户说"待我审批/我要审批的" → `oa approval pending` 或 `oa approval tasks`
-- 用户说"我发起的审批" → `oa approval initiated`
-
-## 上下文传递表
-
-| 操作 | 从返回中提取 | 用于 |
-|------|-------------|------|
-| `devdoc article search` | 文档链接 | 直接展示给用户 |
-| `oa approval list-forms` | processCode | detail / records 等 |
-| `oa approval tasks` | taskId, instanceId | approve / reject |
-| `oa approval pending` | instanceId | detail / approve / reject |
-| `oa approval initiated` | instanceId | detail / revoke |

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

@@ -1,138 +0,0 @@
-# 待办 (todo) 命令参考
-
-## 命令总览
-
-### 创建待办
-```
-Usage:
-  dws todo task create [flags]
-Example:
-  dws todo task create --title "修复线上Bug" --executors <USER_ID_1>,<USER_ID_2> --priority 40
-  dws todo task create --title "提交报告" --executors <USER_ID> --due "2026-03-20T10:00:00+08:00"
-Flags:
-      --due string         截止时间 ISO-8601 (如 2026-03-10T18:00:00+08:00)
-      --executors string   执行者 userId 列表 (必填)
-      --priority string    优先级: 10低/20普通/30较高/40紧急
-      --title string       待办标题 (必填)
-```
-
-### 查询待办列表
-```
-Usage:
-  dws todo task list [flags]
-Example:
-  dws todo task list --page 1 --size 20 --status false
-Flags:
-      --page string     页码 (默认 1)
-      --size string     每页数量 (默认 20)
-      --status string   true=已完成, false=未完成
-```
-
-### 修改待办任务
-```
-Usage:
-  dws todo task update [flags]
-Example:
-  dws todo task update --task-id <taskId> --title "新标题"
-  dws todo task update --task-id <taskId> --priority 40 --due "2026-03-10T18:00:00+08:00"
-  dws todo task update --task-id <taskId> --done true
-Flags:
-      --done string       完成状态: true/false
-      --due string        截止时间 ISO-8601 (如 2026-03-10T18:00:00+08:00)
-      --priority string   优先级: 10低/20普通/30较高/40紧急
-      --task-id string    待办任务 ID (必填)
-      --title string      新标题
-```
-
-### 修改执行者的待办完成状态
-```
-Usage:
-  dws todo task done [flags]
-Example:
-  dws todo task done --task-id <taskId> --status true
-  dws todo task done --task-id <taskId> --status false
-Flags:
-      --status string    完成状态: true=已完成, false=未完成 (必填)
-      --task-id string   待办任务 ID (必填)
-```
-
-### 待办详情
-```
-Usage:
-  dws todo task get [flags]
-Example:
-  dws todo task get --task-id <taskId>
-Flags:
-      --task-id string   待办任务 ID (必填)
-```
-
-### 删除待办
-```
-Usage:
-  dws todo task delete [flags]
-Example:
-  dws todo task delete --task-id <taskId>
-  dws todo task delete --task-id <taskId> --yes
-Flags:
-      --task-id string   待办任务 ID (必填)
-```
-
-## 意图判断
-
-用户说"加个待办/记一下/TODO" → `task create`
-用户说"看看待办/我有啥要做" → `task list`
-用户说"改个待办/修改待办标题/改优先级" → `task update`
-用户说"做完了/完成待办/标记完成" → `task done`
-用户说"看看待办详情" → `task get`
-用户说"删除待办/取消待办" → `task delete`
-
-关键区分: todo(个人待办)
-
-## 核心工作流
-
-```bash
-# 1. 创建待办 — 提取 todoTaskId
-dws todo task create --title "修复线上Bug" --executors userId1,userId2 \
-  --priority 40 --due "2026-03-10T18:00:00+08:00" --format json
-
-# 2. 查看未完成待办
-dws todo task list --page 1 --size 20 --status false --format json
-
-# 3. 查看待办详情
-dws todo task get --task-id <taskId> --format json
-
-# 4. 修改待办信息
-dws todo task update --task-id <taskId> --title "新标题" --priority 40 --format json
-
-# 5. 标记待办完成
-dws todo task done --task-id <taskId> --status true --format json
-
-# 6. 删除待办
-dws todo task delete --task-id <taskId> --yes --format json
-```
-
-## 上下文传递表
-
-| 操作 | 从返回中提取 | 用于 |
-|------|-------------|------|
-| `task create` | `todoTaskId` | update/done/get/delete 的 --task-id |
-| `task list` | `result[].id` | update/done/get/delete 的 --task-id |
-
-## 注意事项
-
-- 优先级值: 10=低, 20=普通, 30=较高, 40=紧急
-- `--due` 截止时间使用 ISO-8601 格式（如 2026-03-10T18:00:00+08:00）
-- `task list` 的 `--status` 对应 MCP `get_user_todos_in_current_org` 的 `todoStatus` 参数
-- todo 是个人待办管理产品
-- `task update` 可同时修改标题/优先级/截止时间/完成状态
-- `task done` 专用于修改执行者的完成状态，与 `task update --done` 作用不同
-- `task delete` 为不可逆操作，建议加 `--yes` 并与用户确认
-
-## 自动化脚本
-
-| 脚本 | 场景 | 用法 |
-|------|------|------|
-| [todo_daily_summary.py](../../scripts/todo_daily_summary.py) | 查看今天/明天/本周未完成待办汇总 | `python todo_daily_summary.py today` |
-| [todo_batch_create.py](../../scripts/todo_batch_create.py) | 从 JSON 文件批量创建待办 | `python todo_batch_create.py todos.json` |
-| [todo_overdue_check.py](../../scripts/todo_overdue_check.py) | 扫描逾期待办输出逾期清单 | `python todo_overdue_check.py` |
-

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

@@ -1,39 +0,0 @@
-# 工作台 (workbench) 命令参考
-
-## 命令总览
-
-### 查看所有工作台应用
-```
-Usage:
-  dws workbench app list [flags]
-Example:
-  dws workbench app list
-```
-### 批量获取应用详情
-```
-Usage:
-  dws workbench app get [flags]
-Example:
-  dws workbench app get --ids <APP_ID_1>,<APP_ID_2>
-Flags:
-      --ids string   应用 ID 列表 (必填)
-```
-
-## 意图判断
-
-用户说"工作台有什么应用/看看应用" → `app list`
-用户说"应用详情" → `app get` (需 appId)
-
-## 核心工作流
-
-```bash
-# 查看所有应用 — 提取 appId
-dws workbench app list --format json
-
-# 获取应用详情
-dws workbench app get --ids app1,app2 --format json
-```
-## 上下文传递表
-| 操作 | 提取 | 用于 |
-|------|------|------|
-| `app list` | `appId` | app get 的 --ids |

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

@@ -1,94 +0,0 @@
-# Recovery Guide
-
-`dws` 的 recovery 闭环以 `dws recovery execute` 为正式入口。主入口仍是 [SKILL.md](../SKILL.md)，错误分类与排查细节可结合 [error-codes.md](./error-codes.md) 和 [global-reference.md](./global-reference.md) 一起使用。
-
-## 标准流程
-
-1. 原始 `dws` 命令失败后，从 stderr 提取 `RECOVERY_EVENT_ID=<event_id>`
-2. 执行 `dws recovery execute --event-id <event_id> --format json`
-3. 读取返回的 `RecoveryBundle`
-4. 先查看 `plan.decision_owner`
-5. 当 `decision_owner == "agent"` 时，把完整 `RecoveryBundle` 视为事实包，由 Agent 基于事实包、对应产品文档和 `dws` skill 做整体判断，再决定是否组织下一次 grounded 的 `dws` 恢复尝试
-6. 恢复尝试结束后，执行 `dws recovery finalize --event-id <event_id> --outcome recovered|failed|handoff --execution-file <file.json> --format json`
-
-CLI 会把 recovery 过程文件保存在 `DWS_CONFIG_DIR/recovery/` 下，并自动清理 30 天前的旧文件与旧事件记录。
-
-## 如何阅读 `RecoveryBundle`
-
-`RecoveryBundle` 重点字段：
-
-- `status`：`needs_agent_action` 或 `analysis_failed`
-- `context`：原始失败上下文
-- `replay`：可重放的脱敏命令信息和工具参数
-- `plan`：规则分类、`decision_owner`、`agent_route`、`doc_search`、`kb_hits`、`doc_actions`、`human_actions`
-- `doc_search.request`：CLI 实际发起的开放平台文档检索请求参数
-- `doc_search.response`：CLI 收到的原始文档检索返回内容块
-- `probe_results`：CLI 已完成的只读探测和上下文审计结果
-- `agent_task`：给 Agent 的明确工作单
-- `finalize_hint`：最终必须回写的 `finalize` 命令模板和 `execution-file` 要求
-
-当 `status == "analysis_failed"` 时，不要假设 CLI 已经修复问题；应先读取 `analysis_error`、`doc_search`、`probe_results`，再判断是否还能继续 grounded 尝试。
-
-当 `plan.decision_owner == "agent"` 时：
-
-- 必须把 CLI 返回内容视为事实包，而不是已定案的恢复结论
-- 优先基于完整 `RecoveryBundle` 做判断；若只能读取 `agent_route.payload`，也必须使用其中的 `context`、`replay`、`doc_search`、`kb_hits`、`doc_actions`、`probe_results`
-- unknown 场景里，不要把 `should_retry`、`should_stop`、`human_actions` 当作 CLI 已经替 Agent 作出的最终决定
-
-## Agent 允许做什么
-
-- 读取 [global-reference.md](./global-reference.md)、[error-codes.md](./error-codes.md) 和对应产品文档
-- 基于完整 `RecoveryBundle`，尤其是 `doc_actions`、`kb_hits`、`probe_results`、`context`、`replay` 做整体判断
-- 仅在依据明确时重新发起新的 `dws` 命令
-- 将真实尝试过程记录进 `execution-file`，再调用 `finalize`
-
-## Agent 禁止做什么
-
-- 编造 taskId、recordId、threadId、UUID、token、URL 或其他业务参数
-- 绕过 `dws` 改用 curl、HTTP API、浏览器或其他未授权手段
-- 未确认前把失败命令替换成另一套业务流程
-- 因为 `human_actions` 里提到用户步骤，就跳过 bundle 里的其余分析信息
-
-## `execution-file` 最小要求
-
-`execution-file` 必须至少包含：
-
-- `actions`
-- `attempts`
-- `result`
-- `error_summary`
-
-`attempts` 是数组，每次尝试至少记录：
-
-- `command_summary`
-- `result`
-- `error_summary`
-- `source`
-
-兼容旧格式：
-
-- `action` 会被归一化成单元素 `actions`
-- 数值型 `attempts` 会被展开为 `legacy_execution_file` 来源的 attempts 记录
-- `error` 会被归一化到 `error_summary`
-
-## unknown 参数错误处理
-
-如果 `execute` 进入 unknown 场景，且 `probe_results` 已给出 CLI 检查过的上下文来源，Agent 应：
-
-- 先检查上一步输出、已有上下文、产品文档或 `probe_results` 里是否存在真实参数来源
-- 若没有可靠来源，就回写 `handoff`
-- 不要盲猜新的 ID、UUID、URL、token 或其他业务参数
-
-对应标准闭环：
-
-```bash
-dws recovery execute --event-id <event_id> --format json
-dws recovery finalize --event-id <event_id> --outcome handoff --execution-file execution.json --format json
-```
-
-## 必读参考
-
-- [error-codes.md](./error-codes.md)
-- [global-reference.md](./global-reference.md)
-- [intent-guide.md](./intent-guide.md)
-- [products/](./products/)