refactor: remove sources/search module (merged into storage/quark)
- 删除 sources/search/（netdisk.search 只是一个附属功能） - SKILL.md: 移除 search 相关引用，夸克行改为 转存/建目录/移动/删除/搜索 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
This commit is contained in:
@@ -24,9 +24,7 @@ media-center/
|
||||
│ └── usage.md # Playwright 搜索流程
|
||||
│
|
||||
├── sources/ # 获取技术（怎么读）
|
||||
│ ├── tencent-doc/ # 腾讯文档读取
|
||||
│ │ └── v1/{install,usage,maintain}.md
|
||||
│ └── search/ # 网盘搜索
|
||||
│ └── tencent-doc/ # 腾讯文档读取
|
||||
│ └── v1/{install,usage,maintain}.md
|
||||
│
|
||||
├── storage/ # 存储后端（存到哪）
|
||||
@@ -61,9 +59,8 @@ media-center/
|
||||
|------|------|
|
||||
| 读取腾讯文档（含大文档） | `sources/tencent-doc/v1/usage.md` |
|
||||
| 安装腾讯文档 MCP | `sources/tencent-doc/v1/install.md` |
|
||||
| 夸克网盘-转存/建目录/移动/删除 | `storage/quark/v1/usage.md` |
|
||||
| 夸克网盘-转存/建目录/移动/删除/搜索 | `storage/quark/v1/usage.md` |
|
||||
| 安装夸克网盘 MCP | `storage/quark/v1/install.md` |
|
||||
| 跨平台搜索资源 | `sources/search/v1/usage.md` |
|
||||
|
||||
## 场景路由
|
||||
|
||||
@@ -74,9 +71,8 @@ media-center/
|
||||
| 用户需求 | 触发词 | 数据源 | 技术操作 |
|
||||
|---------|--------|--------|---------|
|
||||
| 今天/每日更新的资源 | "今天"、"每日"、"最新"、"YYYY.MM.DD" | `sites/tacit0924/v1/` | → `sources/tencent-doc/v1/usage.md` |
|
||||
| 某个剧/电影的资源 | "遮天"、"流浪地球"等具体名称 | 先 `sites/tacit0924/` 查 → 找不到再 search | → `sources/tencent-doc/` 或 `sources/search/` |
|
||||
| 某个剧/电影的资源 | "遮天"、"流浪地球"等具体名称 | 先 `sites/tacit0924/` 查 → 找不`到再 yunpan1 搜 | → `sources/tencent-doc/` 或 `sites/yunpan1/` |
|
||||
| yunpan1 论坛搜索 | "论坛"、"yunpan1" | `sites/yunpan1/v1/` | → Playwright 搜索+查看 |
|
||||
| 通用搜索（无特定源） | 任意关键词 | `sources/search/v1/` | → `netdisk.search()` |
|
||||
| 整理夸克网盘已有文件 | "整理"、"归类"、"分段" | — | → `storage/quark/v1/usage.md`（整理章节） |
|
||||
|
||||
### 第二步：转存到夸克
|
||||
@@ -89,9 +85,8 @@ media-center/
|
||||
|
||||
```
|
||||
1. 找"每日更新" → 优先走 Tencent Doc 路线（Tacit0924 文档）
|
||||
2. 找"特定资源" → 先在 Tacit0924 文档搜，找不到再走 PanSou search
|
||||
3. 通用搜索 → 走 PanSou search（需配置 PANSOU_URL）
|
||||
4. 某个渠道不可用（MCP 超时 / PanSou 未配）→ 告知用户，**禁止降级到 web search**
|
||||
2. 找"特定资源" → 先在 Tacit0924 文档搜，找不到再走 yunpan1 搜
|
||||
3. 某个渠道不可用 → 告知用户，**禁止降级到 web search**
|
||||
```
|
||||
|
||||
## 端到端示例
|
||||
|
||||
@@ -1,45 +0,0 @@
|
||||
# 网盘搜索 — 安装配置
|
||||
|
||||
## 前置依赖
|
||||
|
||||
- Node.js >= 18
|
||||
- mcporter
|
||||
|
||||
```bash
|
||||
# 检查 mcporter
|
||||
mcporter --version || npm i -g mcporter
|
||||
```
|
||||
|
||||
## 安装 MCP Server
|
||||
|
||||
搜索功能由 `@ptbsare/netdisk-mcp-server` 提供，无需单独搜索模块，该包同时提供搜索和夸克网盘操作能力。
|
||||
|
||||
```bash
|
||||
npm i -g @ptbsare/netdisk-mcp-server
|
||||
```
|
||||
|
||||
## 配置到 mcporter
|
||||
|
||||
```bash
|
||||
mcporter config add netdisk \
|
||||
--stdio "npx -y @ptbsare/netdisk-mcp-server" \
|
||||
--env "NETDISK_QUARK_COOKIE=你的夸克Cookie" \
|
||||
--env "PANSOU_URL=你的PanSou地址（可选）"
|
||||
```
|
||||
|
||||
> 夸克 Cookie 获取：登录 pan.quark.cn → F12 → Network → 复制任意请求的 Cookie
|
||||
|
||||
如果使用内置 PanSou 搜索（免费版），`PANSOU_URL` 可留空，将使用默认公共实例。
|
||||
|
||||
## 验证
|
||||
|
||||
```bash
|
||||
mcporter list netdisk
|
||||
```
|
||||
|
||||
列出 6 个工具即配置成功。
|
||||
|
||||
```bash
|
||||
# 搜索测试
|
||||
mcporter call 'netdisk.search(query: "测试", cloud_types: ["quark"])'
|
||||
```
|
||||
@@ -1,50 +0,0 @@
|
||||
# 网盘搜索 — 维护
|
||||
|
||||
## 信息来源
|
||||
|
||||
| 当前模块内容 | 来源（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/` 版本。
|
||||
@@ -1,59 +0,0 @@
|
||||
# 网盘搜索 — 使用
|
||||
|
||||
## 搜索资源
|
||||
|
||||
```bash
|
||||
# 夸克网盘搜索
|
||||
mcporter call 'netdisk.search(query: "流浪地球", cloud_types: ["quark"])'
|
||||
|
||||
# 多平台搜索
|
||||
mcporter call 'netdisk.search(query: "权力的游戏", cloud_types: ["quark", "baidu", "aliyun"])'
|
||||
|
||||
# 搜索磁力链接
|
||||
mcporter call 'netdisk.search(query: "奥本海默", cloud_types: ["magnet"])'
|
||||
```
|
||||
|
||||
## 支持的平台
|
||||
|
||||
| cloud_types | 平台 |
|
||||
|-------------|------|
|
||||
| `quark` | 夸克网盘 |
|
||||
| `baidu` | 百度网盘 |
|
||||
| `aliyun` | 阿里云盘 |
|
||||
| `115` | 115 网盘 |
|
||||
| `xunlei` | 迅雷网盘 |
|
||||
| `pikpak` | PikPak |
|
||||
| `tianyi` | 天翼云盘 |
|
||||
| `uc` | UC 网盘 |
|
||||
| `123` | 123 网盘 |
|
||||
| `magnet` | 磁力链接 |
|
||||
| `ed2k` | eD2K 链接 |
|
||||
|
||||
## 高级搜索
|
||||
|
||||
```bash
|
||||
# 包含+排除关键词
|
||||
mcporter call 'netdisk.search(query: "电视剧", include: ["合集"], exclude: ["预告", "花絮"])'
|
||||
|
||||
# 指定来源
|
||||
mcporter call 'netdisk.search(query: "电影", source: "tg")'
|
||||
# source: "all"（默认全部）, "tg"（Telegram频道）, "plugin"（搜索插件）
|
||||
|
||||
# 强制刷新（跳过缓存）
|
||||
mcporter call 'netdisk.search(query: "最新电影", refresh: true)'
|
||||
```
|
||||
|
||||
## 搜索结果处理
|
||||
|
||||
搜索结果包含：标题、分享 URL、提取码、日期、来源。
|
||||
|
||||
```bash
|
||||
# 找到目标链接后，查看分享内容
|
||||
mcporter call 'netdisk.view(share_link: "https://pan.quark.cn/s/xxx")'
|
||||
```
|
||||
|
||||
## 注意事项
|
||||
|
||||
- **调用必须用函数式语法**：`'netdisk.search(query: "...")'`，不能用 `key=value`
|
||||
- **搜索质量依赖 PanSou 服务**：免费版结果可能不全
|
||||
- **磁力链接**需要通过 115 网盘的离线下载功能处理（`netdisk.offline_download`）
|
||||
Reference in New Issue
Block a user