koishi-plugin-quark-search 1.0.0

package/README.md

@@ -0,0 +1,220 @@
+# koishi-plugin-quark-search
+
+夸克网盘资源搜索转存插件，支持自定义搜索API、备用API切换、广告过滤等功能。
+
+## 功能特性
+
+- 🔍 **自定义搜索API**：支持配置任意搜索接口
+- 🔄 **备用API自动切换**：主API失败时自动使用备用API
+- ✅ **链接有效性验证**：自动过滤失效的分享链接
+- 📄 **分页浏览**：支持上一页/下一页浏览搜索结果
+- 🚀 **自动转存分享**：一键转存到自己网盘并生成新分享链接
+- 🛡️ **广告过滤**：自动删除或重命名包含广告关键词的文件
+- 🔁 **自动重试**：网络异常时自动重试，提高成功率
+- 📊 **详细日志**：记录所有操作，方便调试
+
+## 安装
+
+### 方法一：本地插件（推荐）
+
+1. 将 `quark-search` 文件夹放到 Koishi 的 `external` 目录
+2. 在 Koishi 根目录执行 `yarn install`
+3. 在控制台启用插件
+
+### 方法二：npm 安装
+
+```bash
+yarn add koishi-plugin-quark-search
+# 或
+npm install koishi-plugin-quark-search
+```
+
+## 配置说明
+
+### 必填配置
+
+| 配置项 | 说明 | 示例 |
+|--------|------|------|
+| searchApiUrl | 搜索API地址 | `https://wzapi.com/api/jhsj` |
+| quarkCookie | 夸克网盘Cookie | 从浏览器开发者工具获取 |
+
+### 搜索API配置
+
+| 配置项 | 默认值 | 说明 |
+|--------|--------|------|
+| searchApiMethod | `GET` | 请求方式 |
+| searchApiParams | `{"kw": "{keyword}"}` | 请求参数，`{keyword}`会被替换 |
+| searchApiHeaders | `{"User-Agent": "..."}` | 请求头 |
+| searchResultPath | `data` | 结果在响应中的路径 |
+| searchTitleField | `title` | 标题字段名 |
+| searchUrlField | `url` | 链接字段名 |
+
+### 备用API配置
+
+| 配置项 | 默认值 | 说明 |
+|--------|--------|------|
+| enableBackupApi | `false` | 启用备用API |
+| backupApiUrl | - | 备用API地址 |
+| backupApiMethod | `GET` | 备用API请求方式 |
+| backupApiParams | `{"kw": "{keyword}"}` | 备用API请求参数 |
+| backupApiHeaders | `{"User-Agent": "..."}` | 备用API请求头 |
+| backupResultPath | `data` | 备用API结果路径 |
+| backupTitleField | `title` | 备用API标题字段 |
+| backupUrlField | `url` | 备用API链接字段 |
+
+### 广告过滤配置
+
+| 配置项 | 默认值 | 说明 |
+|--------|--------|------|
+| enableAdFilter | `false` | 启用广告过滤 |
+| deleteKeywords | `[]` | 删除关键词列表 |
+| replaceRules | `{}` | 替换规则对象 |
+| scanDepth | `3` | 扫描深度（层数） |
+| scanDelay | `5` | 扫描延迟（秒） |
+
+### 其他配置
+
+| 配置项 | 默认值 | 说明 |
+|--------|--------|------|
+| watchGroups | `[]` | 监控的群号列表，留空监控所有群 |
+| saveFolderId | `0` | 转存目标文件夹ID，0为根目录 |
+| expiredType | `1` | 分享有效期：1=永久，2=7天，3=1天 |
+| limit | `10` | 每次搜索返回的最大结果数 |
+| sessionTimeout | `120` | 搜索会话超时时间（秒） |
+| saveTimeout | `180` | 转存超时时间（秒） |
+
+## 使用方法
+
+### 基本搜索
+
+在群聊中发送：
+```
+搜 流浪地球
+```
+
+插件会返回搜索结果列表，回复数字编号即可转存。
+
+### 翻页浏览
+
+```
+下一页
+上一页
+```
+
+### 获取 Cookie
+
+1. 打开浏览器，访问 https://pan.quark.cn/
+2. 登录你的夸克账号
+3. 按 F12 打开开发者工具
+4. 切换到 Network（网络）标签
+5. 刷新页面，找到任意请求
+6. 在请求头中找到 `Cookie` 字段
+7. 复制完整的 Cookie 值到插件配置
+
+## 广告过滤示例
+
+### 删除包含关键词的文件
+
+配置 `deleteKeywords`：
+```json
+["必看", "资源", "点击查看", "有惊喜", "广告"]
+```
+
+转存后，插件会自动删除文件名包含这些关键词的文件或文件夹。
+
+### 替换文件名中的关键词
+
+配置 `replaceRules`：
+```json
+{
+  "【广告】": "",
+  "点击关注": "",
+  "VIP资源": "资源"
+}
+```
+
+转存后，插件会自动重命名文件，将关键词替换为指定内容。
+
+## 工作流程
+
+1. 用户发送搜索指令
+2. 调用主搜索API（失败则尝试备用API）
+3. 验证链接有效性，过滤失效链接
+4. 返回有效结果列表
+5. 用户选择编号
+6. 转存到自己网盘
+7. 创建新分享链接
+8. 发送链接给用户
+9. 后台执行广告过滤（如果启用）
+
+## 日志说明
+
+插件会记录详细的操作日志：
+
+- `[INFO]` 正常操作信息
+- `[WARN]` 警告信息（如重试）
+- `[ERROR]` 错误信息
+- `[DEBUG]` 调试信息（需开启调试模式）
+
+查看日志可以了解：
+- 搜索到的资源及链接
+- 链接验证结果
+- 转存过程
+- 广告过滤操作
+
+## 常见问题
+
+### Q: 搜索无结果？
+A: 
+1. 检查搜索API是否可用
+2. 尝试启用备用API
+3. 更换其他搜索API
+
+### Q: 转存失败？
+A: 
+1. 检查Cookie是否过期
+2. 检查网盘容量是否充足
+3. 查看日志了解具体错误
+
+### Q: 链接都显示失效？
+A: 可能是搜索API返回的链接质量问题，建议更换API源
+
+### Q: 广告过滤不生效？
+A: 
+1. 确认已启用 `enableAdFilter`
+2. 检查关键词配置是否正确
+3. 查看日志确认是否执行了过滤
+
+## 开发
+
+### 编译
+
+```bash
+yarn tsc
+# 或
+npm run tsc
+```
+
+### 打包
+
+```bash
+npm pack
+```
+
+### 调试
+
+在 Koishi 配置中启用调试模式，可以看到更详细的日志。
+
+## 许可证
+
+MIT
+
+## 更新日志
+
+### v1.0.0
+- 初始版本
+- 支持自定义搜索API
+- 支持备用API自动切换
+- 支持链接有效性验证
+- 支持广告过滤
+- 支持自动重试

package/lib/index.d.ts

@@ -0,0 +1,32 @@
+import { Context, Schema } from 'koishi';
+export declare const name = "quark-search";
+export interface Config {
+    searchApiUrl: string;
+    searchApiMethod: 'GET' | 'POST';
+    searchApiParams: string;
+    searchApiHeaders: string;
+    searchResultPath: string;
+    searchTitleField: string;
+    searchUrlField: string;
+    enableBackupApi: boolean;
+    backupApiUrl: string;
+    backupApiMethod: 'GET' | 'POST';
+    backupApiParams: string;
+    backupApiHeaders: string;
+    backupResultPath: string;
+    backupTitleField: string;
+    backupUrlField: string;
+    quarkCookie: string;
+    saveFolderId: string;
+    expiredType: number;
+    enableAdFilter: boolean;
+    deleteKeywords: string[];
+    replaceRules: Record<string, string>;
+    scanDepth: number;
+    watchGroups: string[];
+    limit: number;
+    sessionTimeout: number;
+    saveTimeout: number;
+}
+export declare const Config: Schema<Config>;
+export declare function apply(ctx: Context, config: Config): void;

package/lib/index.js

@@ -0,0 +1,730 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name2 in all)
+    __defProp(target, name2, { get: all[name2], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  Config: () => Config,
+  apply: () => apply,
+  name: () => name
+});
+module.exports = __toCommonJS(src_exports);
+var import_koishi = require("koishi");
+var name = "quark-search";
+var Config = import_koishi.Schema.object({
+  searchApiUrl: import_koishi.Schema.string().required().description("搜索 API 地址，例如：https://wzapi.com/api/jhsj"),
+  searchApiMethod: import_koishi.Schema.union(["GET", "POST"]).default("GET").description("请求方式"),
+  searchApiParams: import_koishi.Schema.string().default('{"kw": "{keyword}"}').description("请求参数，JSON格式，{keyword}会被替换为搜索关键词"),
+  searchApiHeaders: import_koishi.Schema.string().default('{"User-Agent": "Mozilla/5.0"}').description("请求头，JSON格式"),
+  searchResultPath: import_koishi.Schema.string().default("data").description("搜索结果在响应中的路径，用点分隔，如 data.list"),
+  searchTitleField: import_koishi.Schema.string().default("title").description("标题字段名"),
+  searchUrlField: import_koishi.Schema.string().default("url").description("链接字段名"),
+  enableBackupApi: import_koishi.Schema.boolean().default(false).description("启用备用搜索API（当主API失败或无结果时自动切换）"),
+  backupApiUrl: import_koishi.Schema.string().description("备用搜索 API 地址"),
+  backupApiMethod: import_koishi.Schema.union(["GET", "POST"]).default("GET").description("备用API请求方式"),
+  backupApiParams: import_koishi.Schema.string().default('{"kw": "{keyword}"}').description("备用API请求参数，JSON格式，{keyword}会被替换为搜索关键词"),
+  backupApiHeaders: import_koishi.Schema.string().default('{"User-Agent": "Mozilla/5.0"}').description("备用API请求头，JSON格式"),
+  backupResultPath: import_koishi.Schema.string().default("data").description("备用API搜索结果在响应中的路径，用点分隔"),
+  backupTitleField: import_koishi.Schema.string().default("title").description("备用API标题字段名"),
+  backupUrlField: import_koishi.Schema.string().default("url").description("备用API链接字段名"),
+  quarkCookie: import_koishi.Schema.string().required().role("textarea").description("夸克网盘 Cookie（必填，从浏览器获取）"),
+  saveFolderId: import_koishi.Schema.string().default("0").description("转存目标文件夹ID，0表示根目录"),
+  expiredType: import_koishi.Schema.number().default(1).description("分享有效期：1=永久，2=7天，3=1天"),
+  watchGroups: import_koishi.Schema.array(String).default([]).description("监控的群号列表，留空则监控所有群"),
+  limit: import_koishi.Schema.number().default(10).description("每次搜索返回的最大结果数"),
+  sessionTimeout: import_koishi.Schema.number().default(120).description("搜索会话超时时间（秒）"),
+  saveTimeout: import_koishi.Schema.number().default(180).description("转存超时时间（秒）")
+});
+var PAGE_SIZE = 10;
+var searchSessions = /* @__PURE__ */ new Map();
+function getQuarkHeaders(cookie) {
+  return {
+    "Accept": "application/json, text/plain, */*",
+    "Accept-Language": "zh-CN,zh;q=0.9",
+    "Content-Type": "application/json;charset=UTF-8",
+    "sec-ch-ua": '"Chromium";v="122", "Not(A:Brand";v="24", "Google Chrome";v="122"',
+    "sec-ch-ua-mobile": "?0",
+    "sec-ch-ua-platform": '"Windows"',
+    "sec-fetch-dest": "empty",
+    "sec-fetch-mode": "cors",
+    "sec-fetch-site": "same-site",
+    "Referer": "https://pan.quark.cn/",
+    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+    "Cookie": cookie
+  };
+}
+__name(getQuarkHeaders, "getQuarkHeaders");
+async function checkQuarkLinkValid(ctx, url, logger) {
+  const match = url.match(/\/s\/([a-zA-Z0-9]+)/);
+  if (!match) {
+    return { valid: false, message: "无法解析链接格式" };
+  }
+  const pwdId = match[1];
+  try {
+    const headers = {
+      "Accept": "application/json, text/plain, */*",
+      "Accept-Language": "zh-CN,zh;q=0.9",
+      "Content-Type": "application/json;charset=UTF-8",
+      "Referer": "https://pan.quark.cn/",
+      "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36",
+      "Origin": "https://pan.quark.cn"
+    };
+    const response = await ctx.http.post(
+      "https://drive-pc.quark.cn/1/clouddrive/share/sharepage/token",
+      { passcode: "", pwd_id: pwdId },
+      {
+        headers,
+        params: { pr: "ucpro", fr: "pc", uc_param_str: "" },
+        timeout: 1e4
+      }
+    );
+    if (response.status === 200 && response.data) {
+      return { valid: true, message: "链接有效" };
+    }
+    const message = response.message || "未知错误";
+    return { valid: false, message };
+  } catch (error) {
+    if (error?.response?.data) {
+      const data = error.response.data;
+      const message = data.message || "链接失效";
+      return { valid: false, message };
+    }
+    return { valid: false, message: "检测失败" };
+  }
+}
+__name(checkQuarkLinkValid, "checkQuarkLinkValid");
+async function filterValidLinks(ctx, items, logger) {
+  const validItems = [];
+  const checkPromises = items.map(async (item) => {
+    const result = await checkQuarkLinkValid(ctx, item.url, logger);
+    return { item, valid: result.valid, message: result.message };
+  });
+  const results = await Promise.all(checkPromises);
+  for (const { item, valid, message } of results) {
+    if (valid) {
+      item.valid = true;
+      validItems.push(item);
+    } else {
+      logger.debug(`链接失效: ${item.title} - ${message}`);
+    }
+  }
+  return validItems;
+}
+__name(filterValidLinks, "filterValidLinks");
+function apply(ctx, config) {
+  const logger = ctx.logger("quark-search");
+  const cleanupInterval = setInterval(() => {
+    const now = Date.now();
+    for (const [key, session] of searchSessions) {
+      if (now - session.timestamp > config.sessionTimeout * 1e3) {
+        searchSessions.delete(key);
+      }
+    }
+  }, 3e4);
+  ctx.on("dispose", () => {
+    clearInterval(cleanupInterval);
+    searchSessions.clear();
+  });
+  ctx.guild().on("message", async (session) => {
+    const groupId = session.guildId || session.channelId;
+    if (config.watchGroups.length > 0 && !config.watchGroups.includes(groupId)) {
+      return;
+    }
+    const content = session.content?.trim() || "";
+    const sessionKey = `${groupId}:${session.userId}`;
+    const bot = session.bot;
+    const internal = bot.internal;
+    if (/^\d+$/.test(content)) {
+      const userSession = searchSessions.get(sessionKey);
+      if (userSession && Date.now() - userSession.timestamp < config.sessionTimeout * 1e3) {
+        const index = parseInt(content, 10);
+        if (index >= 1 && index <= userSession.validResults.length) {
+          await handleResourceSelection(ctx, config, internal, groupId, session.userId, userSession, index, logger);
+          return;
+        }
+      }
+    }
+    if (content === "下一页" || content === "上一页") {
+      const userSession = searchSessions.get(sessionKey);
+      if (userSession && Date.now() - userSession.timestamp < config.sessionTimeout * 1e3) {
+        const totalPages = Math.ceil(userSession.validResults.length / PAGE_SIZE);
+        if (content === "下一页") {
+          if (userSession.currentPage < totalPages) {
+            userSession.currentPage++;
+            userSession.timestamp = Date.now();
+            await sendPageResults(ctx, internal, groupId, session.userId, userSession, config.sessionTimeout, logger);
+          } else {
+            await internal.sendGroupMsg(groupId, [
+              { type: "at", data: { qq: session.userId } },
+              { type: "text", data: { text: " 已经是最后一页了" } }
+            ]);
+          }
+        } else {
+          if (userSession.currentPage > 1) {
+            userSession.currentPage--;
+            userSession.timestamp = Date.now();
+            await sendPageResults(ctx, internal, groupId, session.userId, userSession, config.sessionTimeout, logger);
+          } else {
+            await internal.sendGroupMsg(groupId, [
+              { type: "at", data: { qq: session.userId } },
+              { type: "text", data: { text: " 已经是第一页了" } }
+            ]);
+          }
+        }
+        return;
+      }
+    }
+    if (!content.startsWith("搜")) return;
+    const keyword = content.slice(1).trim();
+    if (!keyword) {
+      await internal.sendGroupMsg(groupId, [
+        { type: "at", data: { qq: session.userId } },
+        { type: "text", data: { text: " 请输入要搜索的内容，例如：搜 流浪地球" } }
+      ]);
+      return;
+    }
+    logger.info(`收到搜索请求: ${keyword}, 群: ${groupId}, 用户: ${session.userId}`);
+    try {
+      let results = await searchResources(ctx, config, keyword, logger, false);
+      let usedBackupApi = false;
+      if (!results.length && config.enableBackupApi && config.backupApiUrl) {
+        logger.info(`主API无结果，尝试备用API...`);
+        try {
+          results = await searchResources(ctx, config, keyword, logger, true);
+          usedBackupApi = true;
+          if (results.length > 0) {
+            logger.info(`备用API搜索成功，找到 ${results.length} 个资源`);
+          }
+        } catch (backupError) {
+          logger.error("备用API搜索失败:", backupError);
+        }
+      }
+      if (!results.length) {
+        await internal.sendGroupMsg(groupId, [
+          { type: "at", data: { qq: session.userId } },
+          { type: "text", data: { text: ` 未找到「${keyword}」相关资源，换个关键词试试吧~` } }
+        ]);
+        return;
+      }
+      const apiSource = usedBackupApi ? "（备用API）" : "";
+      logger.info(`搜索到 ${results.length} 个${apiSource}，验证中...`);
+      const firstBatch = results.slice(0, PAGE_SIZE);
+      const validFirstBatch = await filterValidLinks(ctx, firstBatch, logger);
+      if (validFirstBatch.length === 0) {
+        const moreBatch = results.slice(PAGE_SIZE, PAGE_SIZE * 3);
+        const validMoreBatch = await filterValidLinks(ctx, moreBatch, logger);
+        if (validMoreBatch.length === 0) {
+          await internal.sendGroupMsg(groupId, [
+            { type: "at", data: { qq: session.userId } },
+            { type: "text", data: { text: ` 「${keyword}」的资源链接均已失效，换个关键词试试吧~` } }
+          ]);
+          return;
+        }
+        validFirstBatch.push(...validMoreBatch);
+      }
+      logger.info(`验证完成，有效: ${validFirstBatch.length} 个`);
+      const userSession = {
+        results,
+        // 保存所有原始结果
+        validResults: validFirstBatch,
+        // 已验证有效的结果
+        timestamp: Date.now(),
+        keyword,
+        currentPage: 1,
+        validating: false
+      };
+      searchSessions.set(sessionKey, userSession);
+      await sendPageResults(ctx, internal, groupId, session.userId, userSession, config.sessionTimeout, logger);
+    } catch (error) {
+      logger.error("搜索失败:", error);
+      await internal.sendGroupMsg(groupId, [
+        { type: "at", data: { qq: session.userId } },
+        { type: "text", data: { text: " 搜索服务暂时不可用，请稍后再试" } }
+      ]);
+    }
+  });
+}
+__name(apply, "apply");
+async function sendPageResults(ctx, internal, groupId, userId, userSession, sessionTimeout, logger) {
+  const validResults = userSession.validResults;
+  const totalPages = Math.ceil(validResults.length / PAGE_SIZE);
+  const startIndex = (userSession.currentPage - 1) * PAGE_SIZE;
+  const endIndex = Math.min(startIndex + PAGE_SIZE, validResults.length);
+  const pageResults = validResults.slice(startIndex, endIndex);
+  const lines = [];
+  lines.push(`🔍「${userSession.keyword}」搜索结果（第${userSession.currentPage}/${totalPages}页，共${validResults.length}条有效资源）：`);
+  lines.push("");
+  pageResults.forEach((item, index) => {
+    const globalIndex = startIndex + index + 1;
+    lines.push(`${globalIndex}. ${item.title}`);
+  });
+  lines.push("");
+  lines.push(`📝 回复数字编号获取对应资源`);
+  if (userSession.currentPage < totalPages) {
+    lines.push(`📄 回复"下一页"查看更多`);
+  }
+  if (userSession.currentPage > 1) {
+    lines.push(`📄 回复"上一页"返回`);
+  }
+  lines.push(`⏰ ${sessionTimeout}秒内有效`);
+  try {
+    await internal.sendGroupMsg(groupId, [
+      { type: "at", data: { qq: userId } },
+      { type: "text", data: { text: "\n" + lines.join("\n") } }
+    ]);
+  } catch (error) {
+    logger.error(`发送结果失败:`, error);
+  }
+  const validatedCount = validResults.length;
+  const totalCount = userSession.results.length;
+  if (validatedCount < totalCount && !userSession.validating) {
+    userSession.validating = true;
+    const nextBatchStart = validatedCount;
+    const nextBatchEnd = Math.min(nextBatchStart + PAGE_SIZE, totalCount);
+    const nextBatch = userSession.results.slice(nextBatchStart, nextBatchEnd);
+    const unvalidated = nextBatch.filter((item) => item.valid === void 0);
+    if (unvalidated.length > 0) {
+      filterValidLinks(ctx, unvalidated, logger).then((validItems) => {
+        userSession.validResults.push(...validItems);
+        userSession.validating = false;
+      }).catch(() => {
+        userSession.validating = false;
+      });
+    } else {
+      userSession.validating = false;
+    }
+  }
+}
+__name(sendPageResults, "sendPageResults");
+async function searchResources(ctx, config, keyword, logger, useBackup = false) {
+  try {
+    const apiUrl = useBackup ? config.backupApiUrl : config.searchApiUrl;
+    const apiMethod = useBackup ? config.backupApiMethod : config.searchApiMethod;
+    const apiParamsStr = useBackup ? config.backupApiParams : config.searchApiParams;
+    const apiHeadersStr = useBackup ? config.backupApiHeaders : config.searchApiHeaders;
+    const resultPath = useBackup ? config.backupResultPath : config.searchResultPath;
+    const titleField = useBackup ? config.backupTitleField : config.searchTitleField;
+    const urlField = useBackup ? config.backupUrlField : config.searchUrlField;
+    const maxTitleLength = keyword.length + 10;
+    let params = {};
+    try {
+      params = JSON.parse(apiParamsStr);
+      for (const key in params) {
+        if (typeof params[key] === "string") {
+          params[key] = params[key].replace("{keyword}", keyword);
+        }
+      }
+    } catch (e) {
+      logger.error("解析搜索参数失败:", e);
+    }
+    let headers = {};
+    try {
+      headers = JSON.parse(apiHeadersStr);
+    } catch (e) {
+      logger.error("解析请求头失败:", e);
+    }
+    let responseText;
+    const queryString = new URLSearchParams(params).toString();
+    const url = apiUrl + (queryString ? "?" + queryString : "");
+    if (apiMethod === "GET") {
+      responseText = await ctx.http.get(url, {
+        headers,
+        timeout: 3e4,
+        responseType: "text"
+      });
+    } else {
+      responseText = await ctx.http.post(apiUrl, params, {
+        headers: { ...headers, "Content-Type": "application/json" },
+        timeout: 3e4,
+        responseType: "text"
+      });
+    }
+    const responseStr = String(responseText);
+    const results = [];
+    const quarkPattern = /https:\/\/pan\.quark\.cn\/s\/[a-zA-Z0-9]+/g;
+    const isValidTitle = /* @__PURE__ */ __name((title) => {
+      if (!title) return false;
+      if (title.length > maxTitleLength) {
+        logger.debug(`标题过长被过滤: "${title}" (${title.length} > ${maxTitleLength})`);
+        return false;
+      }
+      return true;
+    }, "isValidTitle");
+    if (responseStr.includes("data:") && responseStr.includes("\n")) {
+      const lines = responseStr.split("\n");
+      let sseDataFound = false;
+      for (const line of lines) {
+        const trimmedLine = line.trim();
+        if (trimmedLine.startsWith("data:") && !trimmedLine.includes("[DONE]")) {
+          sseDataFound = true;
+          try {
+            const jsonStr = trimmedLine.substring(5).trim();
+            if (jsonStr) {
+              const item = JSON.parse(jsonStr);
+              const title = item.title || item.note || "";
+              let itemUrl = item.url || "";
+              const stoken = item.stoken || "";
+              const match = itemUrl.match(/https:\/\/pan\.quark\.cn\/s\/[a-zA-Z0-9]+/);
+              if (match) {
+                itemUrl = match[0];
+              }
+              if (isValidTitle(title) && itemUrl && itemUrl.includes("pan.quark.cn")) {
+                results.push({ title, url: itemUrl, stoken });
+              }
+            }
+          } catch (e) {
+          }
+        }
+      }
+      if (sseDataFound && results.length > 0) {
+        return results;
+      }
+    }
+    let jsonData;
+    try {
+      jsonData = JSON.parse(responseStr);
+    } catch (e) {
+      const allMatches = responseStr.matchAll(quarkPattern);
+      let index = 0;
+      for (const m of allMatches) {
+        if (!results.find((r) => r.url === m[0])) {
+          results.push({ title: `资源 ${++index}`, url: m[0] });
+        }
+      }
+      return results;
+    }
+    let data = jsonData;
+    if (resultPath) {
+      const paths = resultPath.split(".");
+      for (const p of paths) {
+        if (data && typeof data === "object" && p in data) {
+          data = data[p];
+        } else {
+          data = null;
+          break;
+        }
+      }
+    }
+    if (Array.isArray(data)) {
+      for (const item of data) {
+        const title = item[titleField] || item.note || item.title || "";
+        let itemUrl = item[urlField] || item.url || "";
+        const stoken = item.stoken || "";
+        const match = itemUrl.match(/https:\/\/pan\.quark\.cn\/s\/[a-zA-Z0-9]+/);
+        if (match) {
+          itemUrl = match[0];
+        }
+        if (isValidTitle(title) && itemUrl && itemUrl.includes("pan.quark.cn")) {
+          results.push({ title, url: itemUrl, stoken });
+        }
+      }
+    }
+    if (results.length === 0) {
+      const itemPattern = /"(?:note|title)"\s*:\s*"([^"]+)"[^}]*"url"\s*:\s*"([^"]+pan\.quark\.cn[^"]+)"/g;
+      const itemPattern2 = /"url"\s*:\s*"([^"]+pan\.quark\.cn[^"]+)"[^}]*"(?:note|title)"\s*:\s*"([^"]+)"/g;
+      let match;
+      while ((match = itemPattern.exec(responseStr)) !== null) {
+        const title = match[1];
+        let itemUrl = match[2].replace(/\\\//g, "/");
+        const urlMatch = itemUrl.match(/https:\/\/pan\.quark\.cn\/s\/[a-zA-Z0-9]+/);
+        if (isValidTitle(title) && urlMatch && !results.find((r) => r.url === urlMatch[0])) {
+          results.push({ title, url: urlMatch[0] });
+        }
+      }
+      while ((match = itemPattern2.exec(responseStr)) !== null) {
+        let itemUrl = match[1].replace(/\\\//g, "/");
+        const title = match[2];
+        const urlMatch = itemUrl.match(/https:\/\/pan\.quark\.cn\/s\/[a-zA-Z0-9]+/);
+        if (isValidTitle(title) && urlMatch && !results.find((r) => r.url === urlMatch[0])) {
+          results.push({ title, url: urlMatch[0] });
+        }
+      }
+      if (results.length === 0) {
+        const allMatches = responseStr.matchAll(quarkPattern);
+        let index = 0;
+        for (const m of allMatches) {
+          if (!results.find((r) => r.url === m[0])) {
+            results.push({ title: `资源 ${++index}`, url: m[0] });
+          }
+        }
+      }
+    }
+    logger.info(`搜索到 ${results.length} 个资源`);
+    return results;
+  } catch (error) {
+    logger.error("搜索请求失败:", error);
+    throw error;
+  }
+}
+__name(searchResources, "searchResources");
+async function handleResourceSelection(ctx, config, internal, groupId, userId, userSession, index, logger) {
+  const sessionKey = `${groupId}:${userId}`;
+  const selectedItem = userSession.validResults[index - 1];
+  logger.info(`用户选择: ${selectedItem.title}`);
+  try {
+    await internal.sendGroupMsg(groupId, [
+      { type: "at", data: { qq: userId } },
+      { type: "text", data: { text: ` 正在转存「${selectedItem.title}」，请稍候...` } }
+    ]);
+    const result = await transferAndShare(ctx, config, selectedItem.url, selectedItem.title, logger);
+    if (result.success) {
+      const lines = [];
+      lines.push(`✅ 转存成功！`);
+      lines.push("");
+      lines.push(`📺 ${selectedItem.title}`);
+      lines.push(`🔗 ${result.shareUrl}`);
+      await internal.sendGroupMsg(groupId, [
+        { type: "at", data: { qq: userId } },
+        { type: "text", data: { text: "\n" + lines.join("\n") } }
+      ]);
+      searchSessions.delete(sessionKey);
+    } else {
+      const lines = [];
+      lines.push(`⚠️ ${result.message}，请重新选择资源。`);
+      await internal.sendGroupMsg(groupId, [
+        { type: "at", data: { qq: userId } },
+        { type: "text", data: { text: "\n" + lines.join("\n") } }
+      ]);
+    }
+  } catch (error) {
+    logger.error("转存失败:", error);
+    let errorMessage = "转存服务异常";
+    if (error?.response?.data?.message) {
+      errorMessage = error.response.data.message;
+    } else if (error?.code === "ETIMEDOUT" || error?.message?.includes("timeout")) {
+      errorMessage = "转存请求超时，请稍后重试";
+    } else if (error?.message) {
+      errorMessage = error.message;
+    }
+    const lines = [];
+    lines.push(`⚠️ ${errorMessage}，请重新选择资源。`);
+    await internal.sendGroupMsg(groupId, [
+      { type: "at", data: { qq: userId } },
+      { type: "text", data: { text: "\n" + lines.join("\n") } }
+    ]);
+  }
+}
+__name(handleResourceSelection, "handleResourceSelection");
+async function transferAndShare(ctx, config, shareUrl, title, logger) {
+  const headers = getQuarkHeaders(config.quarkCookie);
+  const match = shareUrl.match(/\/s\/([a-zA-Z0-9]+)/);
+  if (!match) {
+    return { success: false, message: "无效的分享链接" };
+  }
+  const pwdId = match[1];
+  try {
+    let stokenRes;
+    try {
+      stokenRes = await ctx.http.post(
+        "https://drive-pc.quark.cn/1/clouddrive/share/sharepage/token",
+        { passcode: "", pwd_id: pwdId },
+        {
+          headers,
+          params: { pr: "ucpro", fr: "pc", uc_param_str: "" },
+          timeout: 3e4
+        }
+      );
+    } catch (error) {
+      if (error?.response?.data?.message) {
+        return { success: false, message: error.response.data.message };
+      }
+      throw error;
+    }
+    if (stokenRes.status !== 200) {
+      const msg = stokenRes.message === "require login [guest]" ? "夸克Cookie已过期，请更新" : stokenRes.message;
+      return { success: false, message: msg };
+    }
+    const stoken = stokenRes.data.stoken.replace(/ /g, "+");
+    let detailRes;
+    try {
+      detailRes = await ctx.http.get(
+        "https://drive-pc.quark.cn/1/clouddrive/share/sharepage/detail",
+        {
+          headers,
+          params: {
+            pr: "ucpro",
+            fr: "pc",
+            uc_param_str: "",
+            pwd_id: pwdId,
+            stoken,
+            pdir_fid: "0",
+            force: "0",
+            _page: "1",
+            _size: "100",
+            _fetch_banner: "1",
+            _fetch_share: "1",
+            _fetch_total: "1",
+            _sort: "file_type:asc,updated_at:desc"
+          },
+          timeout: 3e4
+        }
+      );
+    } catch (error) {
+      if (error?.response?.data?.message) {
+        return { success: false, message: error.response.data.message };
+      }
+      throw error;
+    }
+    if (detailRes.status !== 200) {
+      return { success: false, message: detailRes.message || "获取分享详情失败" };
+    }
+    const fileList = detailRes.data.list || [];
+    if (fileList.length === 0) {
+      return { success: false, message: "分享内容为空" };
+    }
+    const fidList = fileList.map((f) => f.fid);
+    const fidTokenList = fileList.map((f) => f.share_fid_token);
+    const shareTitle = detailRes.data.share?.title || title;
+    let saveRes;
+    try {
+      saveRes = await ctx.http.post(
+        "https://drive-pc.quark.cn/1/clouddrive/share/sharepage/save",
+        {
+          fid_list: fidList,
+          fid_token_list: fidTokenList,
+          to_pdir_fid: config.saveFolderId || "0",
+          pwd_id: pwdId,
+          stoken,
+          pdir_fid: "0",
+          scene: "link"
+        },
+        {
+          headers,
+          params: { entry: "update_share", pr: "ucpro", fr: "pc", uc_param_str: "" },
+          timeout: 6e4
+        }
+      );
+    } catch (error) {
+      if (error?.response?.data?.message) {
+        return { success: false, message: error.response.data.message };
+      }
+      throw error;
+    }
+    if (saveRes.status !== 200) {
+      if (saveRes.message?.includes("capacity limit")) {
+        return { success: false, message: "网盘容量不足" };
+      }
+      return { success: false, message: saveRes.message || "转存失败" };
+    }
+    const saveTaskId = saveRes.data.task_id;
+    let saveTaskData = null;
+    for (let i = 0; i < 50; i++) {
+      const taskRes = await ctx.http.get(
+        "https://drive-pc.quark.cn/1/clouddrive/task",
+        {
+          headers,
+          params: {
+            pr: "ucpro",
+            fr: "pc",
+            uc_param_str: "",
+            task_id: saveTaskId,
+            retry_index: i
+          },
+          timeout: 3e4
+        }
+      );
+      if (taskRes.status === 200 && taskRes.data?.status === 2) {
+        saveTaskData = taskRes.data;
+        break;
+      }
+      if (taskRes.message?.includes("capacity limit")) {
+        return { success: false, message: "网盘容量不足" };
+      }
+      await sleep(500);
+    }
+    if (!saveTaskData) {
+      return { success: false, message: "转存超时" };
+    }
+    const savedFids = saveTaskData.save_as?.save_as_top_fids || [];
+    if (savedFids.length === 0) {
+      return { success: false, message: "转存结果为空" };
+    }
+    const shareCreateRes = await ctx.http.post(
+      "https://drive-pc.quark.cn/1/clouddrive/share",
+      {
+        fid_list: savedFids,
+        expired_type: config.expiredType || 1,
+        title: shareTitle,
+        url_type: 1
+      },
+      {
+        headers,
+        params: { pr: "ucpro", fr: "pc", uc_param_str: "" },
+        timeout: 3e4
+      }
+    );
+    if (shareCreateRes.status !== 200) {
+      return { success: false, message: shareCreateRes.message || "创建分享失败" };
+    }
+    const shareTaskId = shareCreateRes.data.task_id;
+    let shareTaskData = null;
+    for (let i = 0; i < 50; i++) {
+      const taskRes = await ctx.http.get(
+        "https://drive-pc.quark.cn/1/clouddrive/task",
+        {
+          headers,
+          params: {
+            pr: "ucpro",
+            fr: "pc",
+            uc_param_str: "",
+            task_id: shareTaskId,
+            retry_index: i
+          },
+          timeout: 3e4
+        }
+      );
+      if (taskRes.status === 200 && taskRes.data?.status === 2) {
+        shareTaskData = taskRes.data;
+        break;
+      }
+      await sleep(500);
+    }
+    if (!shareTaskData || !shareTaskData.share_id) {
+      return { success: false, message: "获取分享ID超时" };
+    }
+    const passwordRes = await ctx.http.post(
+      "https://drive-pc.quark.cn/1/clouddrive/share/password",
+      { share_id: shareTaskData.share_id },
+      {
+        headers,
+        params: { pr: "ucpro", fr: "pc", uc_param_str: "" },
+        timeout: 3e4
+      }
+    );
+    if (passwordRes.status !== 200) {
+      return { success: false, message: passwordRes.message || "获取分享链接失败" };
+    }
+    const finalShareUrl = passwordRes.data.share_url;
+    return { success: true, shareUrl: finalShareUrl };
+  } catch (error) {
+    logger.error("转存出错:", error);
+    return { success: false, message: error?.message || "转存过程出错" };
+  }
+}
+__name(transferAndShare, "transferAndShare");
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+__name(sleep, "sleep");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Config,
+  apply,
+  name
+});

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "koishi-plugin-quark-search",
+  "description": "夸克网盘资源搜索转存插件",
+  "version": "1.0.0",
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "files": [
+    "lib",
+    "dist"
+  ],
+  "license": "MIT",
+  "keywords": [
+    "chatbot",
+    "koishi",
+    "plugin",
+    "quark",
+    "网盘"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "koishi": {
+    "description": {
+      "zh": "夸克网盘资源搜索转存插件，支持自定义API和Cookie"
+    },
+    "service": {
+      "required": [
+        "http"
+      ]
+    }
+  },
+  "peerDependencies": {
+    "koishi": "^4.18.9"
+  }
+}