# 网盘搜索 — 维护

## 信息来源

| 当前模块内容 | 来源（ref/ 路径） | 说明 |
|-------------|------------------|------|
| MCP 安装配置 | `ref/netdisk-mcp-server/SKILL.md` | netdisk-mcp-server 官方文档 |
| 搜索使用 | `ref/netdisk-mcp-server/SKILL.md` | 搜索功能由同一包提供 |

## 常见故障

### 1. 搜索无结果

**可能原因**：
- PanSou 公共实例限流或不可用
- 搜索关键词太具体
- `source: "tg"` 下 Telegram 频道可能已失效

**解决**：更换搜索词 / 自建 PanSou 实例配置 `PANSOU_URL`

### 2. `netdisk.search` 报错

**解决**：
- 确认 `mcporter list netdisk` 工具是否正常
- 可能是 PanSou 服务端问题，稍后重试

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

**现象**：
```
Error: Folder not found in Quark: "D:" ...
```

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

**解决**：必须用 `'netdisk.search(query: "...")'` 格式

## 更新检查

```bash
# 查看版本
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/netdisk-mcp-server/` 有更新时，同步到本模块的 `v2/` 版本。