---
name: resource-pipeline
description: 资源自动化工作流——从腾讯文档/搜索找到资源链接，转存到夸克网盘，并整理归档。串联 tencent-docs、netdisk-mcp-server、tx-doc-large-reader、quark-netdisk-helper 四个技能的完整管线。
---

# 资源自动化工作流

## 场景路由表

| 场景 | 入口工作流 | 典型输入 |
|------|-----------|---------|
| 腾讯文档里找链接→存夸克 | `workflows/from-tencent-doc.md` | 文档 URL + 搜索关键词（如"遮天"） |
| 直接搜索资源→存夸克 | `workflows/from-search.md` | 搜索关键词（如"流浪地球 4K"） |
| 整理夸克网盘已有文件 | `workflows/organize-quark.md` | 要整理的目录路径 |

## 核心规则

### 操作规范

1. **转存前必须先确认目录存在**：`netdisk.transfer` 不会自动创建目录，目标不存在则报错
2. **转存后必须验证**：列出目标目录确认文件正确，清理杂文件
3. **函数式语法**：所有 `netdisk.*` 调用必须用 `'netdisk.xxx(y: "v")'` 格式
4. **每次操作输出摘要**：让用户清楚每个步骤的结果

### 调用语法速查

```bash
# ✅ 正确（函数式语法）
mcporter call 'netdisk.list(cloud: "quark", path: "/")'
mcporter call 'netdisk.view(share_link: "https://pan.quark.cn/s/xxx")'
mcporter call 'netdisk.transfer(share_link: "https://pan.quark.cn/s/xxx", source_pattern: "/*", target_path: "/目标")'
mcporter call 'netdisk.search(query: "关键词", cloud_types: ["quark"])'

# ❌ 错误（key=value 语法会报路径错误）
mcporter call netdisk.list cloud=quark path=/
```

### Quark API 补全

MCP 缺失的创建文件夹/移动/删除，通过直调 API 实现，详见 `references/quark-api.md`。

## 前置条件

- `tencent-docs` MCP 已配置（腾讯文档 OAuth 授权）
- `netdisk` MCP 已配置（夸克 Cookie）
- `mcporter` 可用

## 依赖关联

```
资源来源                  中转/处理                   目的地
─────────              ──────────                 ──────
腾讯文档 ──→ tx-doc-large-reader ──→ 解析出链接 ─┐
                                                ├──→ netdisk.transfer ──→ 夸克网盘
直接搜索 ──→ netdisk.search    ──→ 获取链接 ────┘          │
                                                          ↓
                                                    整理归档 ← quark-api (创建/移动/删除)
```