From 38754d0687d62f023e3c1c0dd23eb5d6d1f4a8bd Mon Sep 17 00:00:00 2001 From: Kaxi <1042864399@qq.com> Date: Sat, 16 May 2026 22:33:29 +0800 Subject: [PATCH] refactor: remove sources/search module (merged into storage/quark) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - 删除 sources/search/（netdisk.search 只是一个附属功能） - SKILL.md: 移除 search 相关引用，夸克行改为 转存/建目录/移动/删除/搜索 Co-Authored-By: Claude Opus 4.6 --- SKILL.md | 15 +++------ sources/search/v1/install.md | 45 -------------------------- sources/search/v1/maintain.md | 50 ----------------------------- sources/search/v1/usage.md | 59 ----------------------------------- 4 files changed, 5 insertions(+), 164 deletions(-) delete mode 100644 sources/search/v1/install.md delete mode 100644 sources/search/v1/maintain.md delete mode 100644 sources/search/v1/usage.md diff --git a/SKILL.md b/SKILL.md index 453a317..d250fe9 100644 --- a/SKILL.md +++ b/SKILL.md @@ -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** ``` ## 端到端示例 diff --git a/sources/search/v1/install.md b/sources/search/v1/install.md deleted file mode 100644 index 208515d..0000000 --- a/sources/search/v1/install.md +++ /dev/null @@ -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"])' -``` diff --git a/sources/search/v1/maintain.md b/sources/search/v1/maintain.md deleted file mode 100644 index 8956a1e..0000000 --- a/sources/search/v1/maintain.md +++ /dev/null @@ -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/` 版本。 diff --git a/sources/search/v1/usage.md b/sources/search/v1/usage.md deleted file mode 100644 index a7a265a..0000000 --- a/sources/search/v1/usage.md +++ /dev/null @@ -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`）