Pinvou/pinvou-agent / pinvou3-app/src-tauri/resources/common/bundle/dingtalk-skills/dws
dws
Unverified【何时用:仅当用户明确指向钉钉/DingTalk(钉钉文档、钉钉日程等)时使用;泛指做文档/表格/待办/审批默认走本地工具,不要误用钉钉】用 dws CLI 管理钉钉:AI表格/AI搜问(找人首选)/目标管理(Agoal)/组织大脑/日历/通讯录/群聊与机器人消息/待办/审批/智能合同/考勤/日志(日报周报)/DING消息/钉钉文档/云盘/Markdown文件/HTML文件/AI听记/邮箱/在线电子表格(axls)/知识库/白板/开放平台文档/个人IM与OA事件订阅。用户要求操作上述钉钉产品时使用。
references/products/drive/drive-task.md
View on GitHub# drive 异步任务查询(task get)
> **前置条件(MUST READ):** 执行本命令前,必须先用 `read` 读取以下文件:
> 1. [`../drive.md`](../drive.md) — 命令路由 + 场景索引 + 意图判断 + 工作流
---
## task get(统一任务查询入口)
```
Usage:
dws drive task get --type <TYPE> --id <TASK_ID>
Example:
dws drive task get --type export --id <taskId>
dws drive task get --type import --id <taskId>
dws drive task get --type copy --id <taskId>
dws drive task get --type move --id <taskId>
Flags:
--type string 任务类型: export|import|copy|move (必填)
--id string 任务 ID (必填)
```
drive 域异步任务的统一查询入口,返回归一化 TaskResult。服务端原始状态值(QUEUED/RUNNING/DONE 等)统一归一化为以下六种枚举:
| 状态 | 含义 |
|------|------|
| `PENDING` | 排队中 |
| `PROCESSING` | 处理中(含空/未知状态的保守归一) |
| `SUCCESS` | 任务成功;导出任务返回 `resultUrl` 下载链接 |
| `PARTIAL_FAILED` | 部分失败(终态,常见于批量复制/移动),返回部分失败说明 |
| `FAILED` | 任务失败,返回错误信息 |
| `TIMEOUT` | 任务超时 |
注意:
- `resultUrl` 是临时下载链接,**有时效性,成功后应尽快下载**。
- `PENDING` / `PROCESSING` 是非终态,可间隔后再次查询;四种终态(`SUCCESS` / `PARTIAL_FAILED` / `FAILED` / `TIMEOUT`)出现后任务不再变化。
## copy/move 轮询中断后的兜底查询
copy/move 提交后会自动轮询直至终态;轮询超时或 Ctrl-C 中断时 CLI 会输出 `taskId`,服务端任务不会中止,之后用本命令手动查询:
```bash
# 复制任务超时/中断后查询状态
dws drive task get --type copy --id <taskId> --format json
# 移动任务返回 PARTIAL_FAILED 时查明细
dws drive task get --type move --id <taskId> --format json
```
`PARTIAL_FAILED` 时同样可用该命令查明部分失败明细。
## 三种查询入口的区分
| 入口 | 适用场景 |
|------|---------|
| `dws drive task get` | 全部四种任务类型(export/import/copy/move),返回归一化 TaskResult,一般场景统一用它 |
| `dws drive export get` | 仅查导出任务(`drive export --async` 提交后的配套查询) |
| `dws doc export get` | doc 产品级导出入口,透传原始响应 |
## 参考
- [`../drive.md` §意图判断](../drive.md#意图判断)(如何路由到本命令)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |