koishi-plugin-quark-search

一个用于在群聊中搜索并转存夸克网盘资源的 Koishi 插件。

功能特性

🎬 双模式搜索

• API搜索（电影电视剧）：使用 搜 或 搜夸克 触发，快速响应，结果稳定
• 爬虫搜索（广播剧）：使用 找夸克 触发，从网站爬取资源，适合广播剧等小众资源

✨ 核心功能

• 🔍 自定义搜索API：已配置两个API，主API失败时自动切换备用API
• ✅ 链接有效性验证：自动过滤失效的分享链接
• 📄 分页浏览：支持上一页/下一页浏览搜索结果
• 🔁 自动转存分享：一键转存到你的网盘并生成新分享链接
• 🛡️ 广告过滤：自动删除或重命名包含广告关键词的文件
• 📊 使用统计：支持日报/周报/月报推送

安装

方法一：本地插件（推荐）

1. 将 quark-search 文件夹放到 Koishi 的 external 目录
2. 在 Koishi 根目录执行 yarn install
3. 在控制台启用插件

方法二：npm 安装

yarn add koishi-plugin-quark-search
# 或
npm install koishi-plugin-quark-search

使用方法

API搜索（电影电视剧）

在群聊中发送：

搜 流浪地球
搜夸克 流浪地球

爬虫搜索（广播剧）

在群聊中发送：

找夸克 魔道祖师
找夸克 全职高手

选择资源

插件会返回搜索结果列表：

🔍「魔道祖师」搜索结果（第1/1页，共5条有效资源）：

1. 魔道祖师（广播剧）
2. 魔道祖师第二季
3. 魔道祖师完整版
...

📝 回复数字编号获取对应资源
⏰ 120秒内有效

回复数字编号即可转存：

1

翻页浏览

下一页
上一页

配置说明

都已在代码里配置好，安装即用

| 配置项 | 默认值 | 说明 | |--------|--------|------| | watchGroups | [] | 监控的群号列表，留空监控所有群 | | limit | 10 | 每次搜索返回的最大结果数 | | sessionTimeout | 120 | 搜索会话超时时间（秒） | | saveTimeout | 180 | 转存超时时间（秒） | | enableDailyReport | false | 是否开启每日使用统计报表 | | reportTime | 23:55 | 报表推送时间（24小时制） | | adminIds | [] | 接收报表的管理员用户ID列表 |

两种搜索方式对比

| 特性 | API搜索（搜） | 爬虫搜索（找夸克） | |------|--------------|------------------| | 适用场景 | 电影、电视剧 | 广播剧、小众资源 | | 响应速度 | 快（1-2秒） | 较慢（3-5秒） | | 结果稳定性 | 高 | 依赖网站可用性 | | 资源覆盖 | 主流资源 | 更广泛 | | 触发词 | 搜 搜夸克 | 找夸克 |

工作流程

1. 用户发送搜索指令（搜 或 找夸克）
2. 调用对应的搜索方式（API或爬虫）
3. 验证链接有效性，过滤失效链接
4. 返回有效结果列表
5. 用户选择编号
6. 自动转存并创建新分享链接
7. 发送链接给用户
8. 后台执行广告过滤

统计报表功能

插件支持搜索日志记录和统计报表推送：

• 搜索日志包含：关键词、用户ID、群号、结果数
• 日志文件保存在 data/logs/ 目录
• 支持日报/周报/月报自动推送到管理员私聊

启用报表

1. 确保已安装 koishi-plugin-cron 插件
2. 在插件配置中设置：
   • enableDailyReport: 开启每日报表
   • reportTime: 推送时间（如 23:55）
   • adminIds: 管理员用户ID列表

开发

编译

yarn build

打包

npm pack

许可证

MIT

更新日志

v1.3.0 (2026-01-31)

• 🎉 新增：爬虫搜索功能，使用 找夸克 触发
• 🎭 新增：支持广播剧等小众资源搜索
• 📖 优化：完善文档说明，区分两种搜索模式
• 🔧 技术：集成 cheerio 库用于 HTML 解析

v1.2.5

• 新增：搜索日志与统计报表功能
• 优化：链接验证逻辑

v1.1.1

• 将所有配置写在代码里，无需填写，开箱即用

发布到 npm

1. 构建：yarn build
2. 登录：npm login
3. 发布：npm publish
4. 等待 Koishi 插件市场自动收录