# 夸克网盘 — 维护

## 信息来源

| 当前模块内容 | 来源（ref/ 路径） | 说明 |
|-------------|------------------|------|
| MCP 安装配置 | `ref/netdisk-mcp-server/SKILL.md` | netdisk-mcp-server 官方文档 |
| 转存/浏览/查看 | `ref/netdisk-mcp-server/SKILL.md`、`ref/netdisk-mcp-server/src/client.ts` | MCP 工具用法 + API 端点参考 |
| 创建文件夹/移动/删除 | `ref/quark-netdisk-helper/SKILL.md` | API 补全方案 |
| 整理工作流 | `ref/resource-pipeline/SKILL.md` | 整体编排思路参考 |

## 常见故障

### 1. Cookie 过期

**现象**：
```
mcporter call netdisk.health
# ❌ Quark: Quark cookie expired or invalid (401/403)
```

**解决**：重新登录 pan.quark.cn → F12 → Network 复制新 Cookie

```bash
mcporter config add netdisk \
  --stdio "npx -y @ptbsare/netdisk-mcp-server" \
  --env "NETDISK_QUARK_COOKIE=新Cookie" \
  --overwrite
```

### 2. 函数式语法报错

**现象**：
```
Error: Folder not found in Quark: "D:" (path: D:/work/environment/Git/)
```

**原因**：使用了 `key=value` 语法

**解决**：改用 `'netdisk.list(cloud: "quark", path: "/")'`

### 3. 转存报错"Folder not found"

**现象**：`Folder not found in Quark: "新目录"`

**原因**：`target_path` 目录不存在

**解决**：先用 API 创建目录，再转存（见 usage.md）

### 4. 转存混入杂文件

**原因**：`source_pattern` 的 glob 跨所有文件夹匹配

**解决**：转存后用 `netdisk.list` 验证，用 API 删除杂文件

### 5. Quark API 调用失败

**可能原因**：Cookie 过期 / API 端点变更 / 请求频率过高

**解决**：参考 `ref/netdisk-mcp-server/src/client.ts` 查看最新的 API 端点

## 更新检查

```bash
# 查看 MCP 版本
npm ls -g @ptbsare/netdisk-mcp-server
npm i -g @ptbsare/netdisk-mcp-server@latest
```

GitHub 仓库：[github.com/ptbsare/netdisk-mcp-server](https://github.com/ptbsare/netdisk-mcp-server)

当 `ref/` 中对应的参考项目有更新时，同步到本模块的 `v2/` 版本。