sutong
750f981c7e
资源中心——从多渠道获取资源链接，转存到夸克网盘并整理归档。 - sources/tencent-doc: 腾讯文档读取 - sources/search: 网盘搜索 - storage/quark: 夸克网盘操作 - ref/: 来源 skill 参考归档 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
73 lines
2.0 KiB
Markdown
73 lines
2.0 KiB
Markdown
# 夸克网盘 — 维护
|
||
|
||
## 信息来源
|
||
|
||
| 当前模块内容 | 来源（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/` 版本。
|