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 搜索流程
|
│ └── usage.md # Playwright 搜索流程
|
||||||
│
|
│
|
||||||
├── sources/ # 获取技术(怎么读)
|
├── sources/ # 获取技术(怎么读)
|
||||||
│ ├── tencent-doc/ # 腾讯文档读取
|
│ └── tencent-doc/ # 腾讯文档读取
|
||||||
│ │ └── v1/{install,usage,maintain}.md
|
|
||||||
│ └── search/ # 网盘搜索
|
|
||||||
│ └── v1/{install,usage,maintain}.md
|
│ └── v1/{install,usage,maintain}.md
|
||||||
│
|
│
|
||||||
├── storage/ # 存储后端(存到哪)
|
├── storage/ # 存储后端(存到哪)
|
||||||
@@ -61,9 +59,8 @@ media-center/
|
|||||||
|------|------|
|
|------|------|
|
||||||
| 读取腾讯文档(含大文档) | `sources/tencent-doc/v1/usage.md` |
|
| 读取腾讯文档(含大文档) | `sources/tencent-doc/v1/usage.md` |
|
||||||
| 安装腾讯文档 MCP | `sources/tencent-doc/v1/install.md` |
|
| 安装腾讯文档 MCP | `sources/tencent-doc/v1/install.md` |
|
||||||
| 夸克网盘-转存/建目录/移动/删除 | `storage/quark/v1/usage.md` |
|
| 夸克网盘-转存/建目录/移动/删除/搜索 | `storage/quark/v1/usage.md` |
|
||||||
| 安装夸克网盘 MCP | `storage/quark/v1/install.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` |
|
| 今天/每日更新的资源 | "今天"、"每日"、"最新"、"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 搜索+查看 |
|
| yunpan1 论坛搜索 | "论坛"、"yunpan1" | `sites/yunpan1/v1/` | → Playwright 搜索+查看 |
|
||||||
| 通用搜索(无特定源) | 任意关键词 | `sources/search/v1/` | → `netdisk.search()` |
|
|
||||||
| 整理夸克网盘已有文件 | "整理"、"归类"、"分段" | — | → `storage/quark/v1/usage.md`(整理章节) |
|
| 整理夸克网盘已有文件 | "整理"、"归类"、"分段" | — | → `storage/quark/v1/usage.md`(整理章节) |
|
||||||
|
|
||||||
### 第二步:转存到夸克
|
### 第二步:转存到夸克
|
||||||
@@ -89,9 +85,8 @@ media-center/
|
|||||||
|
|
||||||
```
|
```
|
||||||
1. 找"每日更新" → 优先走 Tencent Doc 路线(Tacit0924 文档)
|
1. 找"每日更新" → 优先走 Tencent Doc 路线(Tacit0924 文档)
|
||||||
2. 找"特定资源" → 先在 Tacit0924 文档搜,找不到再走 PanSou search
|
2. 找"特定资源" → 先在 Tacit0924 文档搜,找不到再走 yunpan1 搜
|
||||||
3. 通用搜索 → 走 PanSou search(需配置 PANSOU_URL)
|
3. 某个渠道不可用 → 告知用户,**禁止降级到 web search**
|
||||||
4. 某个渠道不可用(MCP 超时 / PanSou 未配)→ 告知用户,**禁止降级到 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